Model or dataset
bmad-code-org/BMAD-METHOD avatar
bmad-code-org/BMAD-METHOD

BMad Method: A Process Layer for AI-Driven Development That Keeps Decisions Explicit

BMAD-METHOD is a free, open-source agile AI development framework whose agents act as expert collaborators, adapting planning depth from bug fixes to enterprise systems.

53,054 stars5,992 forksJavaScriptLicense varies

At a glance

What is it?
BMad Method is an open-source, npm-installable framework that wraps AI coding assistants in structured workflows, briefs, and specifications. It is for teams that want AI speed without losing human control over product and technical decisions.
Who is it for?
Adopt BMad Method if you are a developer or team using AI coding assistants and you want a repeatable, explicit process for turning ideas into working software, especially if you work across new and existing codebases. Skip it if you prefer ad-hoc prompting or if your organization cannot tolerate the overhead of structured briefs and workflow artifacts.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly JavaScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What BMad Method Actually Solves

AI coding assistants are good at writing code, but they tend to convert unstated assumptions into implementation. BMad Method addresses that by adding a process layer on top of your AI tool. It is not another IDE plugin or a code generator. It is a structured methodology that forces decisions to be explicit, preserves them as context, and carries them forward across chats and sessions. The target user is a developer or a product team that wants to use AI for speed but refuses to hand over judgment. The README positions it as covering the whole effort: what to build, how it holds together, and how it changes as you learn. That scope is broader than typical coding-agent wrappers, which focus only on generating files.

How the Method Works: Briefs, Workflows, and Agents

The core mechanism is a set of workflows that produce artifacts such as briefs, specifications, and architecture documents. You invoke these workflows through commands like `bmad-build` and `bmad-help` inside your AI coding tool. The method is right-sized: small changes go straight to implementation, while complex work triggers deeper planning. The README describes specialized perspectives including product, architecture, UX, development, and testing expertise. These are not separate tools; they are roles that agents can play within the workflow. The key design choice is that context is durable. Instead of re-explaining your product decisions in every chat, the method stores them as structured context that the AI tool can reference. This is a meaningful difference from a simple prompt template, because it creates a persistent memory across sessions.

Getting Started: Installation and Prerequisites

Installation is straightforward if you meet the prerequisites. You need Node.js 20.12 or newer, Python 3.10 or newer, and the `uv` package manager from Astral. The install command is `npx bmad-method install`. After that, you open your project in your AI coding tool and invoke `bmad-build` with a description of the change you want. The `bmad-help` command provides guidance on what comes next and what is optional. The README points to a documentation site with guides for building your first change and for adding BMad to an established codebase. The fact that it is an npm package rather than a standalone application means it integrates into your existing Node.js toolchain, which is convenient for JavaScript projects but might be a barrier for teams that do not already use npm.

The Ecosystem: Modules and Web Bundles

BMad Method is the core, but the project includes an ecosystem of official modules. There is BMad Builder for creating skills, workflows, and agents. There is BMad Loop, which builds, verifies, and retros an entire epic unattended. There is a Test Architect module for enterprise testing, a Creative Intelligence Suite for design thinking, and a Game Dev Studio for game development across Unity, Unreal, Godot, and Phaser. Additionally, web bundles package selected workflows as Google Gemini Gems and ChatGPT Custom GPTs. This allows planning in a web subscription and then bringing the resulting artifacts into your coding tool. The breadth is notable, but it also means you are committing to a specific ecosystem if you adopt the core method. The web bundles are a clever way to lower the entry barrier for planning without installing anything.

A Genuine Limitation: Process Overhead and Tool Coupling

The main limitation is that BMad Method adds process overhead. Even with right-sizing, you are still invoking commands and generating artifacts. For a trivial one-line fix, that overhead might feel excessive compared to just typing a prompt. The method also depends heavily on your AI coding tool's ability to execute npm commands and follow structured workflows. If your tool does not support that, the method will not work as intended. The README does not specify which AI tools are supported, which is a gap. Another limitation is that the method assumes you are willing to write and maintain briefs and specifications. Teams that prefer a lean, documentation-averse approach will find this heavyweight. The README explicitly says you can carry its artifacts into your existing delivery workflow, but that still requires producing them in the first place.

Alternative Approaches: Prompt Templates vs. Full Process Frameworks

A common alternative is using simple prompt templates or custom instructions in your AI tool. That approach has zero installation overhead and no process artifacts, but it also has no durable context or structured decision-making. Another alternative is a more formal framework like Agile or Scrum, which provides process but is not AI-specific. BMad sits in between: it gives you agile ceremonies like retros (via BMad Loop) but automates them with AI agents. The real difference is that BMad treats the AI as a participant in the process, not just a code generator. If you are already using a tool like LangChain or a custom agent orchestration framework, you could build similar workflows yourself, but that requires significant engineering effort. BMad offers a ready-made package with a community and documentation, which is a trade-off between control and convenience.

Maintenance, Upgrade, and Licensing Considerations

The project is actively maintained, with recent releases including v6.11.0 in August 2026, v6.10.0 in July 2026, and v6.9.0 in June 2026. There is a dedicated upgrade guide for migrating from earlier versions to V6, which suggests that breaking changes are possible. The license is MIT, which is permissive for commercial use, but the README notes that BMad and BMAD-METHOD are trademarks of BMad Code, LLC. That means you can use the code freely, but you cannot use the trademarked names in a way that implies endorsement. The README also states that the project is free and open source with no paywalled workflows, which is a positive sign for long-term availability. However, the maintenance cost for you is the need to keep up with version updates and potentially adjust your workflows if the method changes.

Editorial conclusion

Adopt BMad Method if you are a developer or team using AI coding assistants and you want a repeatable, explicit process for turning ideas into working software, especially if you work across new and existing codebases. Skip it if you prefer ad-hoc prompting or if your organization cannot tolerate the overhead of structured briefs and workflow artifacts. Before adopting, verify that your AI coding tool supports invoking npm-installed commands like `bmad-build` and `bmad-help`, and confirm that the Node.js 20.12+, Python 3.10+, and uv prerequisites are acceptable in your environment. Also check the V6 upgrade guide if you are on an earlier version, and review the MIT license and trademark terms to ensure they fit your distribution plans.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community notes

Community notes