bmad-code-org /BMAD-METHOD
Breakthrough Method for Agile Ai Driven Development
★ 55,398⑂ 6,174👁 417⑃ 1,625● 1,209▤ 44
+15
Daily
+244
Weekly
55,398
stars
6,174
forks
417
watchers
1,625
prs
1,209
issues
44
releases
README
!BMad Method Agile Ai Driven Development — turn an idea or change request into working software without giving up the thinking. Ai Driven Development (AiDD) covers the whole effort, not only the code: what to build, how it holds together, and how it changes as you learn. BMad Method is the agile way to do it — decisions stay explicit, context carries forward, and the process sizes itself to the work. Small changes go straight to build. Complex work gets the depth it needs. The same method covers a weekend prototype and a system with years of history behind it. !The BMad delivery loop: a vague notion starts at Clarify, a big clear idea at Plan, and a small change at Build and verify; Learn and adjust loops back to Plan _Start anywhere. Use BMad end to end, or carry its briefs, specifications, and architecture into your existing delivery workflow._ Start Building BMad ships on two lines. The stable release is v6.12, installed by the npm installer and frozen aside from bug fixes. V7 is in preview alpha on this branch: its skills, install path, and docs change often. The v7 release ETA is mid-November 2026, and it might be sooner. Both routes need uv for BMad setup and Python scripts. Stable: v6.12 (recommended if stability is needed until v7 is finalized for release) With Node.js 20.12+ and Python 3.10+, run in your project: bash npx bmad-method install Open your project in your AI coding tool, invoke bmad-build with what you want to change, and run bmad-help whenever you want guidance on what comes next. The v6.12 source and documentation live on the V6.12 branch. V7 Preview Alpha (recommended for solo or small teams that can pivot as things will change before beta) Expect breaking changes between updates. You need an AI coding tool that supports skills. With Node.js and npm and Git, run in your project to install core tools and BMad Method: bash npx skills add bmad-code-org/BMAD-METHOD/skills/core-tools --skill '' npx skills add bmad-code-org/BMAD-METHOD/skills/method --skill '' Each command installs one module whole and asks which coding tools to install to. Core tools hold the bmad skill for setup and help, so every install needs them. Optional modules install the same way: | Module | What it adds | Install | | --- | --- | --- | | Toolsmith | Smithy builds, converts, reviews and packages skills, agents and modules; bmad-eval measures them | npx skills add bmad-code-org/BMAD-METHOD/skills/toolsmith --skill '' | | Founder | Nadia the Founder Advisor coaches the business side of a startup, from idea and pricing to fundraising | npx skills add bmad-code-org/BMAD-METHOD/skills/founder | To pick single skills instead, run npx skills add bmad-code-org/BMAD-METHOD and include bmad plus the record of each module you take skills from, such as bmod-core-tools and bmod-method. Open your coding tool in the project and ask the bmad skill to run bmad setup. Then invoke bmad-build with what you want to change. Ask bmad whenever you
Top issues
#2987[BUG] Recursive Agent Delegation and Token Waste4 comments · 2026-09-29#3008[BUG] Installed bmad skill ships test_render_skill.py without the helpers module it imports3 comments · 2026-10-01#2760bmad-build and bmad-code-review duplicate 3 identical review layers — wasted time/tokens if both are run, and bmad-build alone never reaches done3 comments · 2026-08-19#2718[6.11.0] render_skill.py: short config tokens HALT as ambiguous in multi-module installs — bmad-build/bmad-build-auto cannot render at all3 comments · 2026-08-12#2649Feature: human-gated intent reconciliation after implementation discoveries3 comments · 2026-07-29#3149`_bmad/render/` isn't git-ignored, and it makes bmad-build stop on a dirty tree2 comments · 2026-10-29#3042Add a fifth dedicated review lens for static analysis and vulnerability detection (security-focused) to bmad-code-review / thorough review mode2 comments · 2026-10-05#3002bmad-build: move the parent epic to in-progress when a story starts, and mark the story done when its build ends2 comments · 2026-09-30
Discussions
#3199CLike — an open-source delivery pipeline compatible with BMad Method0 comments · 2026-11-15#3147Is the ticket tree only for code work?0 comments · 2026-10-27#3107BMad Method CLI included in AgentManager's tool catalog0 comments · 2026-10-18#2977How do I get someone to send me an email?1 comments · 2026-09-27#2881bmad and bmad-loop integration in Cline0 comments · 2026-09-16#2870Idea: BMAD Studio — A Visual Multi-Agent Control Center for BMAD2 comments · 2026-09-14#2778I Tried BMAD — This Is My Feedback1 comments · 2026-08-26#2681Proposal: Prototype Parity Kit — prototype-to-implementation quality gate for BMad0 comments · 2026-08-03
Latest release
v6.12.4 v6.12.4 2026-10-14🐛 Fixes A module pinned in the registry (TEA, at v1.27.2) no longer shows the channel picker, since stable or next would pick a version this installer cannot install. The installer prints the pin and the v7 install command instead. --pin CODE=TAG still overrides it.