A spec-driven development workflow for AI coding assistants that agree on proposals, specs and tasks before any code is written.
bmad-code-org/BMAD-METHOD
An agile AI-driven development method that guides AI coding tools through planning, specs, and build steps for software projects of any size.
- Stars
- 54,350
- Forks
- 6,094
- Open issues
- 77
- Last commit
- 14 hours ago
What is it?
BMad Method is a workflow framework for building software with AI coding assistants. It covers the whole effort rather than only code generation: deciding what to build, recording architecture and product decisions, and revising them as the project changes. Small changes go straight to implementation, while larger initiatives get more planning depth, so the same method fits a quick prototype or a long-lived system.
The project ships as installable skills for AI coding tools. Its core delivery loop moves work from clarification and planning into build, verification, and review, with decisions kept as durable context so they do not need to be re-explained in every chat. It supports both new projects and existing codebases, and it includes specialized perspectives such as product, architecture, UX, development, and testing.
The project is organized as a family of modules. Companion modules add a skill builder, a creative thinking suite, an enterprise test architecture add-on, an unattended epic loop, and a game development studio covering Unity, Unreal, Godot, and Phaser.
Key features
- 01Scales the planning depth to the size of each change.
- 02Keeps product and technical decisions as durable context for later work.
- 03Installs as skills for AI coding tools via the skills CLI or plugin marketplaces.
- 04Supports both new projects and existing codebases.
- 05Provides product, architecture, UX, development, and testing perspectives.
Use cases
- Turning a vague idea into a planned, reviewed implementation with an AI coding assistant.
- Adding a change to an inherited codebase while grounding the work in what the code actually does.
- Running a small feature directly from clarification to build and verification.
- Building a game in Unity, Unreal, Godot, or Phaser with structured AI workflows.
Quick start
- 1
Install Node.js 20.12+, Python 3.10+, and uv (needed for BMad setup and Python scripts)
- 2
In your project folder, install the stable v6.12 release
npx bmad-method install - 3
Open the project in your AI coding tool and invoke bmad-build with the change you want
Things to know
- The V7 preview is alpha and will have breaking changes between updates.
- You need an AI coding tool to use it, and V7 requires one that supports skills.
- Setup requires Node.js, Python, and uv.
Topics
FAQ
- What is BMAD-METHOD?
- An agile AI-driven development method that guides AI coding tools through planning, specs, and build steps for software projects of any size. BMad Method is a workflow framework for building software with AI coding assistants. It covers the whole effort rather than only code generation: deciding what to build, recording architecture and product decisions, and revising them as the project changes. Small changes go straight to implementation, while larger initiatives get more planning depth, so the same method fits a quick prototype or a long-lived system.
- Is BMAD-METHOD free to use? What license does it have?
- BMAD-METHOD is open source under the Other license. Check the license terms before using it in commercial products.
- Is BMAD-METHOD still maintained?
- Actively maintained. The last commit to BMAD-METHOD was on Oct 20, 2026.
- What can I use BMAD-METHOD for?
- Turning a vague idea into a planned, reviewed implementation with an AI coding assistant. Adding a change to an inherited codebase while grounding the work in what the code actually does. Running a small feature directly from clarification to build and verification. Building a game in Unity, Unreal, Godot, or Phaser with structured AI workflows.
- How do I install BMAD-METHOD?
- Install Node.js 20.12+, Python 3.10+, and uv (needed for BMad setup and Python scripts) In your project folder, install the stable v6.12 release: npx bmad-method install Open the project in your AI coding tool and invoke bmad-build with the change you want
- Where can I get BMAD-METHOD?
- The source code and installation instructions are on GitHub: https://github.com/bmad-code-org/BMAD-METHOD
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A Claude Code plugin with self-correcting memory, persistent FTS5 research wikis, and workflow skills, commands and hooks for AI coding agents.
TypeScript framework for building AI agents with memory, tools, MCP, RAG, voice and workflows, plus the VoltOps console for observability.
Structured, phase-based workflow rules that steer AI coding agents like Claude Code, Kiro, Codex CLI and Cursor through software delivery.
Installs a spec-driven development workflow as Agent Skills for AI coding agents like Claude Code, Codex, and Cursor, covering requirements, design, tasks, and autonomous implementation.
A spec-driven framework that coordinates Planner, Manager and Worker AI agents in separate conversations to manage larger software projects.