team-shinchan:budget

Monitor workflow turn budgets by reading the active WORKFLOW_STATE.yaml and work-tracker.jsonl events to display current total usage, phase usage, and status indicators like On Track, WARNING, or EXCEEDED. This prevents agents from exceeding allocated turn limits.

Reset turn budget counters by updating the used_total and used_phase values in WORKFLOW_STATE.yaml. This is necessary when advancing phases or restarting workflows so that phase-specific token tracking starts fresh.

A turn budget in a YAML workflow state file defines the maximum session turns allocated for total and phase-specific execution. You need to configure it before high-cost planning sessions to avoid automatic enforcement stoppages during development.

Yes, you can create a budget section in WORKFLOW_STATE.yaml if one is missing. The system validates the file and automatically adds the required budget structure with total and phase values to ensure safe control of allocated turn limits.

Your workflow stops automatically because the used_total or used_phase counters in WORKFLOW_STATE.yaml have reached the configured turn budget limits, triggering an EXCEEDED status to prevent burning tokens unexpectedly.

The turn budget tracker applies specifically to Team-Shinchan workflows. It locates the most recently modified .shinchan-docs/*/WORKFLOW_STATE.yaml and counts current session turns from .shinchan-docs/work-tracker.jsonl events to compute effective usage.