Skip to content

Step 1: Charter the Energy Monitor

We run the charter command with our feature description:

/auro.charter "Home energy monitoring dashboard that displays real-time
electricity usage, historical charts, and spike alerts"

Auro creates branch 1-energy-monitor and generates charters/1-energy-monitor/charter.md.

As a homeowner, I can see my current electricity usage updating in real time.

Acceptance:

  • Given the dashboard is open
  • When a new reading arrives from the smart meter
  • Then the current usage display updates within 2 seconds

As a homeowner, I can view my electricity usage over daily, weekly, and monthly periods.

Acceptance:

  • Given I am on the dashboard
  • When I select “Weekly” from the time range picker
  • Then a chart shows usage data for the past 7 days

As a homeowner, I receive a notification when my usage exceeds a configurable threshold.

Acceptance:

  • Given I have set a threshold of 5 kW
  • When a reading exceeds 5 kW
  • Then an alert banner appears on the dashboard
FR-001: Display current electricity usage in kW, updated in real time.
FR-002: Store readings with timestamp and value in persistent storage.
FR-003: Render time-series charts for daily, weekly, and monthly views.
FR-004: Allow users to set a usage threshold for spike alerts.
FR-005: Display alert when a reading exceeds the configured threshold.
[NEEDS CLARIFICATION: Should alerts persist or auto-dismiss?]

We run /auro.clarify to resolve the ambiguity:

Question: Should spike alerts persist or auto-dismiss?

  • (Recommended) Auto-dismiss after 30 seconds — Keeps the UI clean, user has already seen it
  • Persist until manually dismissed

We accept the recommendation. The charter updates:

FR-005: Display alert banner when reading exceeds threshold.
Auto-dismisses after 30 seconds. Clarified per Article VII (Simplicity).

The charter is now clean. On to Step 2: Plan.