agent-expenditure
Agent Token Waste Monitoring
When To Use
- After parallel agent dispatch completes
- When evaluating whether to increase agent count
- During retrospectives on agent-heavy workflows
- When plan-before-large-dispatch rule triggers
When NOT To Use
- Single-agent workflows (no coordination overhead)
- During active agent execution (post-hoc analysis)
- For token budgeting (use token-conservation instead)
Brooks's Law for Agents
Dispatching more agents does not always help. Coordination overhead grows with agent count:
| Agent Count | Expected Overhead | Guidance |
|---|---|---|
| 1-3 | Negligible | Dispatch freely |
| 4-5 | 10-15% | Acceptable; plan first |
| 6-8 | 20-30% | Monitor closely |
| 9+ | 30%+ | Likely counterproductive |
Coordination overhead is measured as shared-file conflicts: concurrent Read/Write operations on the same file by different agents, as a percentage of total agent runtime.
Post-Dispatch Review Checklist
After parallel agent runs, evaluate:
- Did each agent produce unique findings?
- Was total token expenditure proportional to value?
- Did any agent duplicate another's work?
- Would fewer agents have produced the same result?
If 2+ questions answer no, reduce agent count in future dispatches of the same type.
Waste Signals
See modules/waste-signals.md for the 5 waste signal categories and
detection criteria.
Cross-References
.claude/rules/plan-before-large-dispatch.mdfor the 4+ agent planning requirementconserve:token-conservationfor session-level token budgetingconjure:agent-teamsfor dispatch coordination
More from athola/claude-night-market
project-planning
Turn a specification into a phased implementation plan with dependency ordering.
114code-quality-principles
KISS, YAGNI, and SOLID code quality principles for clean code, reducing complexity and preventing over-engineering.
85project-brainstorming
Guide project ideation via Socratic questioning to generate project briefs.
83doc-generator
Generate or remediate documentation with human-quality writing and style
70rigorous-reasoning
Anti-sycophancy reasoning checklist.
69project-specification
Transform project briefs into testable specifications with user stories, acceptance criteria, and measurable outcomes.
69