How ahamedumar15/crunchflow works
CrunchFlow is a Claude Code plugin for governed AI software development. Its main workflow turns a user’s idea into a brief, competing designs, a merged and scored spec, human approval, scoped implementation, adversarial QA, and a traceable release report. A separate governed-session workflow applies scoped write controls and auditing to existing-repository work. The graph reflects documented workflow stages and sampled module references; internal links for unsampled agent and command behavior are limited to README evidence.
Main entry points: cf_state.py Run state · cf_common.py Shared helpers · qa.md QA · cf_trace.py Traceability
Components 25
Build workflow
- Pipeline command
crunchflow/commands/crunch.md - Analyst
crunchflow/agents/analyst.md - Architects
crunchflow/agents/architect.md - Judge
crunchflow/agents/judge.md - Planner
crunchflow/agents/planner.md - Developer
crunchflow/agents/developer.md - QA
crunchflow/agents/qa.md - Release
crunchflow/agents/release.md
Governance
- Approval command
crunchflow/commands/crunch-approve.md - Govern command
crunchflow/commands/govern.md - Session close
crunchflow/commands/govern-end.md - Write gate
crunchflow/hooks/gate.py - Run state
crunchflow/scripts/cf_state.py
Context and verification
- Agent briefings
crunchflow/scripts/cf_brief.py - Structured handoffs
crunchflow/scripts/cf_handoff.py - Context index
crunchflow/scripts/cf_index.py - Spec scoring
crunchflow/scripts/cf_lint.py - Traceability
crunchflow/scripts/cf_trace.py - Mutation check
crunchflow/scripts/mutate.py - Shared helpers
crunchflow/scripts/cf_common.py
Run reporting
- Audit event model
crunchflow/scripts/cf_events.py - Live storyboard
crunchflow/scripts/cf_center.py - Run dashboard
crunchflow/scripts/dashboard.py - Shared UI system
crunchflow/scripts/cf_ui.py
Other components
- User
Connections 38
- User → Pipeline command: starts pipeline
README.md - Pipeline command → Analyst: briefs idea
README.md - Analyst → Architects: provides brief
README.md - Architects → Judge: compete for merge
README.md - Judge → Spec scoring: scores spec
README.md - User → Approval command: reviews and approves
README.md - Approval command → Run state: records spec hash
README.md - Approval command → Planner: unblocks planning
README.md - Planner → Developer: defines tasks and scope
README.md - Developer → QA: submits implementation
README.md - QA → Mutation check: spot-checks tests
README.md - QA → Developer: returns failures
README.md - QA → Traceability: provides QA evidence
README.md - Traceability → Release: provides trace results
README.md - Release → Run dashboard: writes run report
README.md - Release → Live storyboard: writes storyboard
README.md - User → Govern command: starts session
README.md - Govern command → Write gate: sets write scope
README.md - Write gate → Run state: records decisions
README.md - User → Session close: closes session
README.md - Session close → Run state: summarizes session
README.md - Run state → Write gate: supplies governance state
README.md - Pipeline command → Agent briefings: prepares agent context
- Agent briefings → Context index: uses indexed context
crunchflow/scripts/cf_brief.py - Run state → Spec scoring: checks spec stage
crunchflow/scripts/cf_state.py - Run state → Traceability: supplies task state
- Run state → Audit event model: supplies run record
crunchflow/scripts/cf_events.py - Audit event model → Live storyboard: serves event views
crunchflow/scripts/cf_center.py - Audit event model → Run dashboard: supplies audit model
crunchflow/scripts/dashboard.py - Live storyboard → Shared UI system: imports styles
crunchflow/scripts/cf_center.py - Run dashboard → Shared UI system: imports styles
crunchflow/scripts/dashboard.py - Run state → Shared helpers: uses shared helpers
crunchflow/scripts/cf_state.py - Agent briefings → Shared helpers: uses shared helpers
crunchflow/scripts/cf_brief.py - Structured handoffs → Shared helpers: uses shared helpers
crunchflow/scripts/cf_handoff.py - Context index → Shared helpers: uses shared helpers
crunchflow/scripts/cf_index.py - Spec scoring → Shared helpers: uses shared helpers
crunchflow/scripts/cf_lint.py - Traceability → Context index: uses symbol index
crunchflow/scripts/cf_trace.py - Mutation check → Shared helpers: uses shared helpers
crunchflow/scripts/mutate.py