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…

这是什么?BMad Method 是一个开源的敏捷开发框架,面向 AI 驱动的开发:它把一个想法或变更需求变成能运行的软件,覆盖规划和交付的全过程,而不只是生成代码。
它是要么全用、要么不用的体系吗?还是我只用它的规划部分也行?都可以——你可以从头到尾完整使用 BMad,也可以只把它的需求简报、规格说明和架构文档融入你现有的交付流程。
怎么把 BMad 加进我的项目?通过 Skills CLI 安装(需要 Node.js、npm 和 Git),或者从 Claude Code / Codex 的插件市场安装 bmad-method 插件,然后在项目里让 bmad 技能运行 bmad setup。
在这之前我的电脑上必须装好哪些东西?需要一个支持技能(skills)的 AI 编程工具,外加用于 BMad 初始化和其 Python 脚本的 uv;如果走 Skills CLI 这条路,还需要 Node.js、npm 和 Git。
是不是每个改动都得走完整的规划流程,哪怕很小的一次修改?不用——流程会根据工作量自动调整:小改动直接进入构建,更大的项目才会做相应更深入的规划。
我的代码库已经写了好几年了——BMad 对我还适用吗?适用——同一套方法既适用于一个周末就能完成的原型,也适用于有多年历史积累的系统;对于接手过来的旧代码,它会先核实其中实际存在的代码情况,建立可靠的上下文。
我可以在编程工具之外做规划吗?比如在浏览器里?可以——web bundles 会把选定的 BMad 工作流打包成 Google Gemini Gems 和 ChatGPT Custom GPTs;你先在那里做规划,再把产出物带回来实施。
授权方面有什么特别需要留意的吗?代码采用 MIT 许可证,但 BMad 和 BMAD-METHOD 是 BMad Code, LLC 的商标——在使用这些名称之前请先查看 TRADEMARK.md。
为什么不直接给编程助手下指令,非要一套方法?编程助手擅长实现,但常常会把没有明说的假设直接写成代码;BMad 让你始终掌控方向,同时它的智能体和工作流会把关键决策明确写下来,并作为上下文保留下来供后续工作使用。
在核心方法之外,还有哪些官方模块可以加装?用于构建技能、工作流和智能体的 BMad Builder;负责设计思维和故事叙述的 Creative Intelligence Suite;面向企业级测试的 BMad Test Architect;可以无人值守跑完整个史诗(epic)的 BMad Loop;以及支持 Unity、Unreal、Godot 和 Phaser 的 BMad Game Dev Studio。
有没有内容需要付费,或者被封闭在社区里才能用?没有——BMad 免费开源,没有任何付费才能用的工作流,也没有需要审核才能进的社区;支持它完全是自愿的,可以通过点星、请喝咖啡或企业赞助。
装好之后,更新是怎么做的?让 bmad update 检查版本,用 npx skills update 或你的插件市场进行安装,然后再让 bmad doctor 修复项目里已有的运行环境。
Size
54.1 MB
Stars
54.3K
Age
1y
Commits · 90 Days