What problem does it solve?
flow-alpha orchestrates the end-to-end, stage-gated alpha feature development workflow for a single ADR or multiple ADRs, preventing unreviewed or incomplete changes from progressing.
Core Features & Use Cases
- Two execution modes with a blocking human choice: single-ADR (run 5 stages then stop) or batch worktree (N ADRs, each with its own worktree + branch, designed for offline runs).
- Stage-gated quality controls across 5 hard phases: design → implementation (with Spec-First for red changes) → adversarial self-test → bilingual documentation + demo/API coverage → wrapup with changelog/roadmap/ADR acceptance.
- Dependency-aware parallelism for batch mode: analyzes ADR file-scope and explicit dependencies to decide parallel worktrees vs stacked chains, then enforces strict per-worktree isolation and review gating.
Quick Start
Ask the AI to run the alpha flow for ADR-XX in single mode after you confirm whether this run is single-ADR or batch worktrees.