An opinionated, GSD-native take on AI-driven development automation
Usage: devflow <COMMAND>
Commands:
start Begin the workflow for a phase: Define → Plan → Code → Validate → Ship
resume Resume a phase from its saved stage after a rate limit or infrastructure pause
gate Inspect and answer human gates (the pause points where the workflow waits for approval)
logs Print or follow an agent's captured output for a phase
history Show a phase's chronological events and retained attempt evidence
parallel Run multiple phases concurrently, each in its own worktree + monitor
reference Create or refresh a static reference worktree at `.worktrees/reference/`
cleanup Remove phase worktrees and their feature branches
status Show current workflow state
list List all feature branches with divergence from develop
recover Recover or inspect stale/abandoned workflow state
test Run local quality checks: cargo test, clippy, and fmt --check
doctor Audit the environment and report what's installed, missing, or broken
release Read-only release-cut preflight: self-pin, develop/main divergence, crates.io publish order, and tag-signing viability
ship Manually drive a phase through Ship when the monitor that would have consumed its already-written Ship gate response is dead
stop End a running phase cleanly (23c): answers its open gate with a rejection if one is open — the target unwinds through its own abort path, no signal sent — otherwise signals the process recorded in its per-phase lock file (`.devflow/lock-{phase:02}`), never `state.monitor_pid` (the PID `devflow status` displays, and the wrong one — see `commands::stop`'s doc comment). Idempotent: safe to run against an already-stopped, never-started, or already-dead phase
evidence Report DevFlow's own structural record of whether a phase shipped (23-06) — a read-only oracle sourced from the append-only event log, not from any agent-authored attestation document. See `devflow_core::ship_evidence` for the full contract
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version