BMAD-METHOD README

The project's README from github.com/bmad-code-org/BMAD-METHOD. As one markdown file: README.md.

BMad Method

Version License: MIT Discord

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

Choose one install route. You need an AI coding tool that supports skills and uv for BMad setup and Python scripts.

Skills CLI — with Node.js and npm and Git, run in your project:

npx skills add bmad-code-org/BMAD-METHOD

Select the skills and coding tool you want; include bmad for setup and help.

Claude Code plugin — add the marketplace inside Claude Code:

/plugin marketplace add bmad-code-org/bmad-plugins

Codex plugin — add the marketplace from your terminal:

codex plugin marketplace add bmad-code-org/bmad-plugins

For either marketplace, install bmad-method for the delivery workflows and bmad-toolbox for standalone skills, including the bmad hub.

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 want guidance on what comes next or what is optional.

Build your first project with BMad →

Add BMad to an existing codebase →

BMad is free and open source, with no paywalled workflows or gated community. Use bmad update to check versions; install updates with npx skills update or your plugin marketplace. After updating, ask for bmad doctor to repair the project's existing runtime.

Why BMad?

Coding assistants are effective at implementation, but they often turn unstated assumptions into code. BMad keeps you in control while its agents and workflows make the important decisions explicit and preserve them as context for the work that follows.

See how much planning a change needs →

BMad Ecosystem

Install the core method or add official modules for specialized work.

Module Purpose
BMad Method Plan and deliver software, from new prototypes to established codebases
BMad Builder Skill, workflow, and agent builder
BMad Creative Intelligence Suite Creative thinking partners for innovation, design thinking, and storytelling
BMad Test Architect Enterprise testing add-on for BMad Method
BMad Loop Builds, verifies, and retros a whole epic unattended
BMad Game Dev Studio Ideate, design, and build games in any framework, including Unity, Unreal, Godot, and Phaser

Plan on the Web

Web bundles package selected BMad workflows as Google Gemini Gems and ChatGPT Custom GPTs. Use them for planning in your existing web subscription, then bring the resulting artifacts into your AI coding tool for implementation.

Documentation

Community

Support and Contributing

BMad is free for everyone and always will be. Star the repository, buy me a coffee, or email [email protected] for corporate sponsorship.

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request.

License

MIT License — see LICENSE for details.

BMad and BMAD-METHOD are trademarks of BMad Code, LLC. See TRADEMARK.md for details.

If you would like to contribute, join us in the discord and read CONTRIBUTORS.md first.

BMAD-METHOD (bmad-code-org/BMAD-METHOD)

Searching Database…

What is this?BMad Method is an open-source agile framework for AI-driven development: it turns an idea or change request into working software, covering planning and delivery, not just code generation.
Is it an all-or-nothing system, or can I adopt just the planning parts?Either — use BMad end to end, or carry its briefs, specifications, and architecture into your existing delivery workflow.
How do I add BMad to my project?Install through the Skills CLI (needs Node.js, npm and Git) or the bmad-method plugin from the Claude Code / Codex marketplace, then ask the bmad skill in your project to run bmad setup.
What has to be on my machine before that works?An AI coding tool that supports skills, plus uv for BMad setup and its Python scripts; the Skills CLI route also needs Node.js, npm and Git.
Does every change have to go through the full planning flow, even tiny ones?No — the process sizes itself to the work: small changes go straight to build, while bigger initiatives get the deeper planning they need.
My codebase is already years old — is BMad still an option for me?Yes — the same method covers a weekend prototype and a system with years of history; on inherited code you establish verified context on what is actually there.
Can I do the planning outside my coding tool, like in a browser?Yes — web bundles package selected BMad workflows as Google Gemini Gems and ChatGPT Custom GPTs; you plan there, then bring the artifacts back for implementation.
Is there anything unusual in the licensing I should know about?The code is MIT-licensed, but BMad and BMAD-METHOD are trademarks of BMad Code, LLC — see TRADEMARK.md before using the name.
Why not just prompt my coding assistant directly without a method?Coding assistants are effective at implementation but often turn unstated assumptions into code; BMad keeps you in control while its agents and workflows make the important decisions explicit and preserve them as context for later work.
What official modules can I add on top of the core method?BMad Builder for building skills, workflows and agents; the Creative Intelligence Suite for design thinking and storytelling; BMad Test Architect for enterprise testing; BMad Loop, which runs a whole epic unattended; and BMad Game Dev Studio for Unity, Unreal, Godot and Phaser.
Is any of it paywalled or locked behind a community?No — BMad is free and open source with no paywalled workflows or gated community; support is optional via stars, coffee or corporate sponsorship.
How do updates work once it is installed?Ask bmad update to check versions, install with npx skills update or your plugin marketplace, then ask for bmad doctor to repair the project's existing runtime.
Size
54.1 MB
Stars
54.3K
Age
1y
Commits · 90 Days