auto-bmad
A BMAD module that runs the full BMAD story implementation workflow end-to-end — one story at a time, on Claude Code or Codex.
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.
The orchestrator only delegates and reports. Every BMAD step runs inside a sub-agent, with the model and thinking effort matched to the stakes of the step (e.g. Opus/max for high-stakes implementation, a faster model for low-stakes mechanics). On Claude Code and Codex those delegates are real, tuned subagents (.claude/agents / .codex/agents, generated from a configurable profiles block); on a tool with generic subagents it falls back to those (untuned), and on one with none it runs steps inline — same pipeline either way.
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.
⚠️ It can't save you from bad inputs. auto-bmad automates the workflow, not judgment — the quality of what comes out is capped by what goes in. Vague epics, thin acceptance criteria, or a shaky architecture produce vague, untrustworthy code, just faster and more confidently. The automated code-review loop and the human-in-the-loop stops below are guardrails, not guarantees; the real leverage is clear stories and a sound design before you press go. Garbage in, garbage out.
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.
From your project directory, run the installer and add this repo as a custom source:
npx bmad-method install
When the interactive flow asks "Would you like to install from a custom source (Git URL or local path)?", choose Yes and enter:
https://github.com/stefanoginella/auto-bmad
The installer reads this repo's marketplace.json, offers the auto-bmad module, and copies it into your tool's skills dir (.claude/skills/ for Claude Code, .agents/skills/ for Codex, …). In the same run, also select the official modules auto-bmad orchestrates if they aren't already installed — at least bmm, plus tea for the test-architecture phases.
Non-interactive equivalent:
npx bmad-method install \
--directory . \
--modules bmm,tea \
--custom-source https://github.com/stefanoginella/auto-bmad \
--tools claude-code \
--yes
Use --tools codex for Codex (npx bmad-method install --list-tools lists every target). Re-run npx bmad-method install anytime to update.
Then provision the delegate agents once with /auto-bmad setup — though auto-bmad also self-registers on the first normal /auto-bmad run if you skip it.
Claude Code–only alternative (plugin marketplace)
If you exclusively use Claude Code, you can instead add this repo as a Claude plugin marketplace (you'll still need the bmm/tea BMAD skills installed separately via the installer above):
/plugin marketplace add stefanoginella/auto-bmad
/plugin install auto-bmad@auto-bmad
Updating
auto-bmad is a BMAD module, so you update it the way you installed it — re-run the BMAD installer, which re-fetches this repo from its Git source. Requires Node.js 20.12+.
# Interactive: detects your existing install and prompts for any newer version
npx bmad-method install
# Non-interactive: refresh every module from its source (re-fetches Git modules)
npx bmad-method install --action quick-update
