BMAD-METHOD

![BMad Method](banner-bmad-method.png)


[![Version](https://img.shields.io/github/v/tag/bmad-code-org/BMAD-METHOD?color=blue&label=version)](https://github.com/bmad-code-org/BMAD-METHOD/tags)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)

**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](docs/images/bmad-delivery-loop.svg)

_Start anywhere. Use BMad end to end, or carry its briefs, specifications, and architecture into your existing delivery workflow._

## Start Building

BMad ships on two lines. The stable release is **v6.12**, installed by the npm installer and frozen aside from bug fixes. **V7** is in preview alpha on this branch: its skills, install path, and docs change often. The v7 release ETA is mid-November 2026, and it might be sooner. Both routes need [uv](https://docs.astral.sh/uv/) for BMad setup and Python scripts.

### Stable: v6.12 (recommended if stability is needed until v7 is finalized for release)

With [Node.js](https://nodejs.org) 20.12+ and [Python](https://www.python.org) 3.10+, run in your project:

```bash
npx bmad-method install
```

Open your project in your AI coding tool, invoke `bmad-build` with what you want to change, and run `bmad-help` whenever you want guidance on what comes next. The v6.12 source and documentation live on the [V6.12 branch](https://github.com/bmad-code-org/BMAD-METHOD/tree/V6.12).

### V7 Preview Alpha (recommended for solo or small teams that can pivot as things will change before beta)

Expect breaking changes between updates. You need an AI coding tool that supports skills.

**Skills CLI** — with [Node.js and npm](https://nodejs.org) and Git, run in your project:

```bash
npx skills add bmad-code-org/BMAD-METHOD --skill '*'
```

`--skill '*'` installs the full BMad Method and asks which coding tools to install to. To pick skills instead, run the command without `--skill '*'` and include `bmad` for setup and help, plus the module record for each module you pick skills from: `bmod-method` and `bmod-core-tools`.

**Claude Code plugin** — add the marketplace inside Claude Code:

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

**Codex plugin** — add the