What problem does it solve? It enforces a disciplined Issue/Plan-driven development workflow where every task is backed by a GitHub Issue or Plan, preventing untracked ad-hoc changes and unvalidated implementations. ## Core Features & Use Cases - State-machine lifecycle commands: Drive Plans through planning → reviewing → executing → verifying → done via flow.sh subcommands (submit, approve, complete, verify, archive) with human authorization gates. - Worktree and branch isolation: Automatically creates and cleans up git worktrees and feature branches, with three approve modes (standard, direct-on-main, evolving branch) and squash-merge-aware verification. - Issue and Plan management: Creates, edits, lists, and syncs GitHub Issues and Plan files through the CLI, with built-in plan check quality validation at submit time. - Use Case: A user references Issue #14; the agent creates a Plan, submits it for review, gets approval, delegates implementation to a sub-agent in an isolated worktree, runs a mandatory review gate, then guides user validation, merge, and archival. ## Quick Start Ask the agent to create a Plan for a GitHub Issue and walk it through submit, approve, implementation, verification, and archive using the dev-flow workflow.
