stefanoginella/auto-bmad
22 stars · Last commit 2026-07-12
BMAD module that runs the full BMAD story workflow end-to-end — one story at a time, hands-off between human-in-the-loop checkpoints — on Claude Code or Codex, delegating each step to model/effort-tuned subagents.
README preview
# auto-bmad — hands-off BMAD stories, human-in-the-loop where it counts [](./LICENSE) [](https://github.com/stefanoginella/auto-bmad) [](https://github.com/bmad-code-org/BMAD-METHOD) [](https://github.com/bmad-code-org/BMAD-METHOD) [](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise) [](#install) [](./CONTRIBUTING.md) A **BMAD module** that runs the **full [BMAD](https://github.com/bmad-code-org/BMAD-METHOD) story implementation workflow end-to-end — one story at a time, or an [entire epic in one run](#run-a-whole-epic)**, on **Claude Code, Codex, or opencode**, with **[human-in-the-loop checkpoints](#human-in-the-loop-stops)** at the decisions that matter. `auto-bmad` chains the core BMM skills (`create-story` → `dev-story` → `code-review`) and the optional TEA (Test Architect) skills into a single resumable pipeline. It detects the next story from `sprint-status.yaml` (or takes one as an argument), runs every step in an isolated git branch with conventional-commit checkpoints, opens a PR, and finishes with a report of the PR link, open questions, deferred work, and anything that needs your attention — then stops so **you** decide when to start the next story. Or run a **whole epic at once** with [`/auto-bmad epic`](#run-a-whole-epic) — the same pipeline looped over the epic's stories, trimmed for wall-clock and capped with one integration review + one PR. The orchestrator **only delegates and reports** — every BMAD step runs inside a sub-agent, with model and thinking effort matched to the stakes (Opus/max for high-stakes implementation, a faster model for low-stakes mechanics). On **Claude Code, Codex, and opencode** those are real, isolated subagents (`.claude/agents` / `.codex/agents` / `.opencode/agent`, generated from a configurable profiles block); elsewhere it falls back to generic subagents (untuned) or runs inline — same pipeline either way. **opencode** is multi-provider — point any phase (or the second-opinion reviewer) at any provider/model you've configured (Anthropic, DeepSeek, Qwen, local, …); it's model-tuned per phase but, since its reasoning knob is provider-specific, not effort-tuned in the agent files. > Requires the BMAD skills it orchestrates (`bmm`, plus `tea` for the test phases) and a `_bmad/` config in your project — the installer below can add these in the same run. auto-bmad drives those skills; it does not replace them. > **Compatibility:** tested against the **[BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6 skill line** up to **6.10.0** (and prerelease **6.10.1-next.12**), and the separately versioned **[TEA test-architecture module](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise) v1 line** (the `testarch` skills) up to **1.19.0** — auto-bmad couples to those skills' contracts rather than pinned versions. > ⚠️ **It can't save you from bad inputs.** auto-bmad automates the *workflow*, not judgment — vague epics, thin acceptance criteria, or a shaky architecture produce vague, untrustworthy code, just faster. The code-review loop and human-in-the-loop stops below are guardrails, not guarantees; the real leverage is clear stories and sound design *before* you press go. ## Install auto-bmad is a BMAD module, so the official way to install it — for **any** supported tool, Claude Code included — is the **BMAD installer**. Requires **Node.js 20.12+** and Git.