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.

55,348 stars6,170 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 November 13, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • bmad-code-org/BMAD-METHOD55,348 ★ · +4,141
Star history
Repository2026-07-282026-11-13
bmad-code-org/BMAD-METHOD51.2k55.3k

4,141 Stars in the last 108 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial 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.

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. 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 for the stable v6.12 line is `npx bmad-method install`; the V7 preview alpha on this branch installs through `npx skills add` or a Claude Code or Codex plugin marketplace. 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. The breadth is notable, but it also means you are committing to a specific ecosystem if you adopt the core method.

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 V7 preview needs an AI coding tool that supports skills, and the README gives Claude Code and Codex plugin routes. 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.12.4 on 2026-10-14, v6.12.3 on 2026-10-14 and v6.12.2 on 2026-10-11. The README says V7 is in preview alpha, expects breaking changes between updates, and gives a release ETA of mid-November 2026. GitHub reports the license as NOASSERTION, so read the LICENSE and TRADEMARK.md files in the repository before building on the code or the name. 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 skills 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 review the LICENSE and TRADEMARK.md files to ensure they fit your distribution plans.

Frequently asked questions

How do I install BMAD-METHOD?

There are two routes. With Node.js, npm, Git and a coding tool that supports skills, run npx skills add bmad-code-org/BMAD-METHOD in your project and pick the skills, or add the marketplace bmad-code-org/bmad-plugins inside Claude Code or from the terminal with Codex, then install bmad-method and bmad-core-tools. After either route, ask the bmad skill to run bmad setup.

What are the steps involved in the BMAD method?

Open your coding tool in the project, ask the bmad skill to run bmad setup, then invoke bmad-build with what you want to change, and ask bmad for guidance on what comes next or what is optional. Ask for bmad status to check versions and see what to run next.

What does BMAD mean in Claude Code?

In Claude Code you add the marketplace from inside the tool with the command /plugin marketplace add bmad-code-org/bmad-plugins, then install bmad-method for the delivery workflows and bmad-core-tools for the standalone skills. You then open the tool in your project and ask the bmad skill to run bmad setup.

How do I use BMAD-METHOD with Codex?

From your terminal run codex plugin marketplace add bmad-code-org/bmad-plugins, then install bmad-method and bmad-core-tools from that marketplace. Updates follow the marketplace on this route, after which you ask for bmad setup to refresh the project.

Can BMAD be used for spec-driven development?

The method is described as covering the whole effort, including what to build and how it holds together, and you can start anywhere by using it end to end or by carrying its briefs, specifications and architecture into your existing delivery workflow. Context is meant to persist across the work rather than be restated in every chat.

Is BMAD-METHOD free?

The project states that BMad is free and open source for everyone, with no paywalled workflows or gated community, and that it is free for everyone and always will be. Support is voluntary through a coffee link or a corporate sponsorship email.

Official sources

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

Where developers are discussing it

Posts on Hacker News, dev.to and Lobsters that link to this repository, found by our scan of those communities. 1 in the last 30 days; newest first.

Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/bmad-code-org-bmad-method.svg)](https://hysenlabs.com/projects/bmad-code-org-bmad-method)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/bmad-code-org-bmad-method.svg)](https://hysenlabs.com/projects/bmad-code-org-bmad-method)

Was this useful?