BMad Method

Install

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

This is third-party code. Review the repository files before installing.

What it does

BMad Method splits product work into separate skills with analyst, product manager, architect, UX designer and developer roles. There are skills for brainstorming, product briefs, PRDs, architecture, epics and stories, sprint planning, implementation, code review and retrospectives. The process scales with the task: small changes go straight to build, large ones go through planning. The bmad skill acts as help, suggests the next step and runs setup, update and doctor flows for the project.

Who it is for. For developers and small teams who want to run a project with an agent through a clear process rather than ad hoc chat requests.

Example request

bmad, where do I start? I want to add subscription billing to the app

Limitations

Requires an agent that supports skills, plus uv for setup and scripts; the npx skills route also needs Node.js and Git. The process creates many documents in the project, and its value depends on team discipline. Add-on modules such as Builder and Test Architect live in separate repositories.

How to disable. Uninstall the bmad-method and bmad-toolbox plugins via /plugin or remove the bmad-* folders from the project's skills directory.

Security check

• Implementation skills change project code
• Setup runs Python scripts through uv

README in short

The README frames BMad as an agile approach to agent-driven development where decisions are explicit and context carries between stages. It offers three install routes: npx skills, the Claude Code plugin marketplace and the Codex marketplace. After that you run bmad setup and call bmad-build with the change you want. It lists the official ecosystem modules and stresses that all workflows are free. MIT licensed.

SKILL.md

---
name: bmad
description: 'Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad. Also when the user asks to set up, update, or doctor this BMad installation.'
---

# BMad Help

If the user explicitly asks to set up, update, or doctor this BMad
installation — by command name or in words — load `references/setup.md` and
follow the matching flow. These are distinct
commands: never route update or doctor through setup. Otherwise use the
ordinary, read-only help process below.
Missing BMad project files or scripts never turn an ordinary help request
into setup or doctor.

## Purpose

Orient the user in the BMad skills that are active in their host, answer
questions about how those skills fit together, and recommend a useful next
step without assuming that every module or skill is installed.

## Fresh Discovery for Every Request

1. Use the host-provided active project and user skill roots and current skill
   listing already exposed in context; never ask the user to supply this host
   metadata. The listing must provide canonical ids and descriptions. If the
   active roots, canonical ids, or descriptions are unavailable, explain which
   capability is missing and stop rather than substituting another discovery
   source.

Related