Enforce token budget across agent convoy

token-budgetskillsetup L264
Tibsfox/gsd-skill-creator
What it does

Pre-execute token budget gate for multi-agent convoy runs

Best for

Stop API calls BEFORE they happen when budget is exceeded, with structured stop reasons and per-agent tracking.

Inputs
  • · convoyId
  • · agentId
  • · projectedTokens
  • · maxPerConvoy (default 500K)
  • · maxPerAgent (default 100K)
Outputs
  • · BudgetCheckResult
  • · allowed boolean
  • · reason (ok/warning/exceeded)
  • · remainingTokens
Requires
  • · beads-state
  • · .chipset/state/budgets/
Preconditions
  • · Budget JSON file persisted
  • · Projected tokens estimated before API call
Failure modes
  • · Warning threshold at 80% but does not block
  • · Agent budget exceeded stops immediately
Trust signals
  • · Check-before-execute pattern prevents overspend
  • · Atomic writes with fsync->rename
  • · v1.49.621: actual spend ~26% of projected (75-300K Opus, 30-150K Sonnet)