| name | workflow-state-manager |
| description | Manages workflow state for multi-agent design workflows. Tracks current phase, iteration count, document status, and agent activity. Use when orchestrating multi-phase workflows that need persistent state between agent invocations, or when checking workflow progress. |
Workflow State Manager
When to use
- Starting a new multi-agent workflow (initialize state)
- Transitioning between workflow phases
- Tracking iteration count during design-review cycles
- Checking current workflow status
- Resuming an interrupted workflow
How to use
Initialize state
Run the state tracker script to create a new state file:
python3 .github/skills/workflow-state-manager/scripts/state-tracker.py init --folder generated_docs_[TIMESTAMP]
This creates generated_docs_[TIMESTAMP]/workflow_state.json with initial state.
Update phase
python3 .github/skills/workflow-state-manager/scripts/state-tracker.py set-phase --folder generated_docs_[TIMESTAMP] --phase [research|design|review|delivery]
Increment iteration
python3 .github/skills/workflow-state-manager/scripts/state-tracker.py increment-iteration --folder generated_docs_[TIMESTAMP]
Set verdict
python3 .github/skills/workflow-state-manager/scripts/state-tracker.py set-verdict --folder generated_docs_[TIMESTAMP] --verdict [APPROVED|CONDITIONAL|REJECTED]
Read current state
python3 .github/skills/workflow-state-manager/scripts/state-tracker.py status --folder generated_docs_[TIMESTAMP]
State file format
The script manages workflow_state.json:
{
"project": "...",
"started": "2026-02-10T17:28:21",
"phase": "review",
"iteration": 2,
"max_iterations": 5,
"verdict": "CONDITIONAL",
"documents": {
"solution_design": "draft"
},
"research_files": [],
"history": []
}
