From flow
Validates Flow project integrity — checks directory structure, Beads health, spec consistency, and git notes. Also supports auto-fixing issues with --fix flag.
How this command is triggered — by the user, by Claude, or both
Slash command
/flow:flow-validateThis command is limited to the following tools:
The summary Claude sees in its command listing — used to decide when to auto-load this command
# Flow Validate > **Beads mode:** Skip every `bd` invocation below when the SessionStart hook reports `Beads Backend: Missing (None)` or `Disabled via plugin config (useBeads=false)`. Treat `spec.md` markers as fallback source of truth and skip `/flow:sync`. Never halt for missing Beads. See `skills/flow/references/discipline.md`. > > Lifecycle skill: use `flow-setup` through the `flow` router. Validate Flow project integrity and optionally fix issues. ## Phase 1: Directory Structure Check required files exist: - [ ] `.agents/product.md` - [ ] `.agents/tech-stack.md` - [ ] `.agents/wor...
Beads mode: Skip every
bdinvocation below when the SessionStart hook reportsBeads Backend: Missing (None)orDisabled via plugin config (useBeads=false). Treatspec.mdmarkers as fallback source of truth and skip/flow:sync. Never halt for missing Beads. Seeskills/flow/references/discipline.md.Lifecycle skill: use
flow-setupthrough theflowrouter.
Validate Flow project integrity and optionally fix issues.
Check required files exist:
.agents/product.md.agents/tech-stack.md.agents/workflow.md.agents/beads.json.agents/flows.md.agents/patterns.md.beads/ directorybd --version
bd status
Check Beads is operational.
For each flow in .agents/flows.md:
.agents/specs/{flow_id}/For each spec.md:
[ ], [~], [x], [!], [-]Verify git notes exist for completed tasks.
Flow Validation Report
=== Structure ===
[x] .agents/ directory complete
[x] Beads initialized
=== Flows ===
[x] auth: 12 tasks, 5 complete
[!] dark-mode: Missing spec.md
=== Issues Found ===
1. dark-mode: Missing spec.md
2. auth: Task 3 marked complete but no commit SHA
=== Recommendations ===
- Run with --fix to auto-repair issues
- Manually review dark-mode
If --fix argument provided:
npx claudepluginhub cofin/flow --plugin flow/doctorRuns health check for the great_cto pipeline, reporting missing required files, PROJECT.md format issues, hook status, last run per agent, and permission-denied tails. Optional --fix flag outputs remediation commands.
/validateValidates project structure, git config, build setup, code quality, CI/CD workflows, and best practices; reports issues, score, and recommendations with --path and --verbose options.
/initScaffolds or repairs the .soloflow/ state directory with required subdirectories and state files. Idempotent — creates only missing pieces, never overwrites existing data.
/validateVerifies session completeness and quality gates by running analysis script, checking 100% tasks, deliverables, tests, files, security; auto-fixes minor issues.
/flow-initInstalls or updates Flow framework by downloading 29 slash commands, 8 agent skills, 1 agent, docs, and examples from GitHub repo. Detects mode, prompts for confirmation.
/validateValidates project implementation against scope and tasks documents using parallel subagents, producing validation_gaps.md with actionable remediation tasks.