Cost Tracking

# Cost Snapshot — YYYY-MM-DD

## Provider Spend

| Provider | Period | Spend | Tokens (input) | Tokens (output) |
| --- | --- | --- | --- | --- |
| Anthropic | YYYY-MM to YYYY-MM | $X,XXX | XXM | XXM |
| OpenAI | YYYY-MM to YYYY-MM | $X,XXX | XXM | XXM |

## Model Breakdown (if available)

| Model | Tokens (input) | Tokens (output) | Estimated cost |
| --- | --- | --- | --- |
| claude-sonnet-4 | XXM | XXM | $XXX |
| claude-opus-4 | XXM | XXM | $XXX |
| claude-haiku-4 | XXM | XXM | $XXX |

## Per-Project Estimate

| Project/Repo | Estimated share | Rationale |
| --- | --- | --- |
| ai-literacy-superpowers | XX% | Primary development repo |
| ai-literacy-exemplar | XX% | Secondary, used for testing |

## Observations

- [Any patterns noticed — cost spikes, model tier shifts, etc.]

## Budget Status

- Monthly budget: $X,XXX (or "not set")
- Current monthly average: $X,XXX
- Trend: increasing / stable / decreasing
- Action needed: yes / no

Process

Step 1: Check Provider Dashboards

Guide the user to their billing pages:

Anthropic:

Check your usage at: https://console.anthropic.com/settings/billing
Look for: monthly spend, token usage by model, usage over time

OpenAI:

Check your usage at: https://platform.openai.com/usage
Look for: monthly spend, model breakdown, daily usage chart

Other providers: Ask the user where to find their billing data.

Step 2: Record the Data

Create observability/costs/YYYY-MM-DD-costs.md using the format above. Ask the user for each field:

1. Which providers are in use?
2. What was the spend for the period?
3. Can they break it down by model? (Not always available)
4. Which projects consumed the most? (Estimate if not precise)

Step 3: Compare to Previous Snapshot

If a previous cost snapshot exists in observability/costs/, read it and compute:

• Spend delta ($ and %)
• Token volume delta
• Model mix changes
• Cost per token trend

Step 4: Update MODEL_ROUTING.md

If the cost data reveals patterns that should change routing:

• High spend on frontier models for tasks that could use standard → suggest updating the Agent Routing table
• Consistent use below the self-hosting break-even → note that cloud is still optimal
• Spend above budget → flag which model tier is the driver

Update the Sovereignty Considerations section with observed data.

Step 5: Update Health Snapshot

The next /harness-health run will read the latest cost snapshot and populate the Cost Indicators section. The skill does not update the snapshot directly — it produces the cost data file that the snapshot reads.

Step 6: Commit

mkdir -p observability/costs
git add observability/costs/YYYY-MM-DD-costs.md MODEL_ROUTING.md
git commit -m "Cost snapshot: YYYY-MM-DD ($X,XXX monthly average)"

Cadence

Quarterly, aligned with the assessment cadence. The recommended