story-kit: create 296_story_track_per_agent_token_usage_for_cost_visibility_and_optimisation

This commit is contained in:
Dave
2026-03-19 08:59:46 +00:00
parent 959c680e10
commit 1d20cfc679

View File

@@ -0,0 +1,22 @@
---
name: "Track per-agent token usage for cost visibility and optimisation"
---
# Story 296: Track per-agent token usage for cost visibility and optimisation
## User Story
As a project owner, I want to see how many tokens each agent consumes per story, so that I can identify expensive operations and optimise token usage across the pipeline.
## Acceptance Criteria
- [ ] Research existing libraries/APIs for monitoring Claude API token usage per session (check Claude Code output, Anthropic SDK usage events, or third-party tools)
- [ ] Implement per-agent token tracking that captures input tokens, output tokens, and cache tokens for each agent run
- [ ] Token usage is recorded per story and per agent (e.g. coder-1 on story 293 used X tokens)
- [ ] Running totals are visible — either via MCP tool, web UI, or both
- [ ] Historical token usage is persisted so it survives server restarts (e.g. in story files or a separate log)
- [ ] Data is structured to support later analysis (e.g. which agent types are most expensive, which stories cost the most)
## Out of Scope
- TBD