BMAD Plugin for Claude Code

BMAD Method - Breakthrough Method for Agile AI-Driven Development

Plugin version: v6.2.2.0

Module	Version	Released	Last Checked
BMAD Method	v6.2.2	2026-03-26	2026-03-30
TEA	v1.7.3	2026-03-27	2026-03-30
BMB	v1.4.0	2026-03-29	2026-03-30
CIS	v0.1.9	2026-03-18	2026-03-30
GDS	v0.2.2	2026-03-16	2026-03-30

A Claude Code plugin that transforms Claude into a complete agile development
environment with specialized agents, structured workflows, and intelligent
context management.

Deprecation Notice

The upstream BMAD repositories are migrating from their custom workflow.yaml
format to Claude Code's native SKILL.md format. Once all upstream modules
complete this migration, this plugin's sync and generation pipeline will become
redundant — the upstream repos will ship Claude Code-compatible skills directly.

At that point this plugin will be deprecated in favor of installing upstream
BMAD packages directly. Until then, this plugin remains the only way to get all
5 BMAD modules aggregated into a single installable Claude Code plugin with
path rewrites, version tracking, and plugin-only additions.

Features

9 Specialized Agents: Business Analyst, Product Manager, UX Designer,
System Architect, Scrum Master, Developer, QA Engineer, Tech Writer, and
Solo Dev
26 Guided Workflows: From brainstorming to implementation
4 Development Phases: Analysis, Planning, Solutioning, Implementation
Progressive Disclosure: Step-by-step workflow execution
State Tracking: Resume workflows across sessions

Usage

Step 1: Add Marketplace

Skip this step once the plugin is listed on the official Claude Code registry.

In-session (inside Claude Code):

# Non-interactive
/plugin marketplace add PabloLION/bmad-plugin

# Interactive — use the /plugin UI → Marketplace tab
/plugin

# Pin to a specific version
/plugin marketplace add PabloLION/bmad-plugin#v6.0.0-Beta.4.2

External CLI (outside Claude Code):

claude plugin marketplace add PabloLION/bmad-plugin

Step 2: Install Plugin

In-session (inside Claude Code):

# Non-interactive — installs at default (user) scope
/plugin install bmad@bmad-method

# Interactive — use the /plugin UI → Discover tab → choose scope
/plugin

External CLI (outside Claude Code):

# User scope (default — you, all projects)
claude plugin install bmad@bmad-method

# Project scope (shared with team, committed to repo)
claude plugin install bmad@bmad-method --scope project

# Local scope (you only, this repo only)
claude plugin install bmad@bmad-method --scope local

Installation Scopes

Scope	Who sees it	Stored in
User (default)	You, all projects	`~/.claude/settings.json`
Project	All collaborators	`.claude/settings.json` (in repo)
Local	You, this repo only	`.claude/settings.local.json`

Troubleshooting: Plugin Update Shows Stale Version

claude plugin update may report the plugin is "already at the latest version"
even when a newer version exists. This is a
known Claude Code bug
where the marketplace cache is not fetched before comparing versions.

Workaround — manually pull the marketplace cache, then retry:

git -C ~/.claude/plugins/marketplaces/bmad-method pull origin main
claude plugin update bmad@bmad-method

Quick Start

# Initialize BMAD in your project
/bmad:init

# Check workflow status
/bmad:status

# Start a workflow
/bmad:product-brief

Learn BMAD Method

New to BMAD? See the official documentation for
methodology overview, workflow explanations, and best practices. The
Getting Started Tutorial
walks through a complete project from scratch.

Agents

Agent	Name	Role	Key Workflows
analyst	Mary	Business analysis	product-brief, research, brainstorm
pm	John	Product requirements	create-prd, create-epics-and-stories
ux-designer	Sally	User experience	create-ux-design
architect	Winston	System design	create-architecture
sm	Bob	Sprint management	sprint-planning, create-story
dev	Amelia	Implementation	dev-story, code-review
tea	Murat	Test architecture	atdd, ci, test-design, framework
quinn	Quinn	QA automation	automate, test-review
tech-writer	Paige	Documentation	document-project
quick-flow-solo-dev	Barry	Solo dev quick flow	quick-spec, quick-dev

Workflow Phases

Phase 1: Analysis

Brainstorming and ideation
Market and competitive research
Product brief creation

Phase 2: Planning

Product Requirements Document (PRD)
UX design specifications

Phase 3: Solutioning

System architecture
Epic and story breakdown
Implementation readiness

Phase 4: Implementation

Sprint planning
Story development
Code review

Attribution

This plugin implements the BMAD Method created by BMad Code, LLC.

Releases

Plugin updates are published every Wednesday when upstream changes are detected.
No release is made if nothing changed. See docs/versioning.md
for the full versioning strategy.

Development

This repository includes verification tooling (in scripts/ and package.json) that validates the plugin implementation fully covers the upstream BMAD-METHOD content. The tooling is not part of the plugin itself.

bun install          # install dependencies (Husky hooks set up automatically)
bun run validate     # run upstream coverage validation

The validation script checks three-way consistency: upstream BMAD-METHOD repo, plugin files, and plugin.json manifest. It runs automatically as a pre-push git hook via Husky.

Why This Plugin

There is an existing community implementation
(aj-geddes/claude-code-bmad-skills)
with 221 stars. Here is how this plugin differs:

	bmad-plugin (this repo)	aj-geddes/claude-code-bmad-skills
Upstream version tracked	v6.0.0-Beta.4 (explicit)	v6 (approximate)
Skills	26	4
Agents	10	12
Automated upstream sync	Yes (GitHub Actions)	No
Version tracking	Explicit with `.upstream-versions/<id>.json` files	None
CI & validation	Biome, markdownlint, Husky, upstream coverage checks	None
Plugin marketplace	Yes (`marketplace.json`)	No (Smithery only)
Architecture	Roles → agents, workflows → skills (correct mapping)	Roles → skills (incorrect mapping)
Last updated	Active	2026-01-01

Key advantages:

Full coverage — all 26 BMAD-METHOD workflows are available as skills,
not just 4. Every workflow from the official repo has a matching skill
Correct role mapping — BMAD roles (PM, Architect, etc.) are modeled as
agents with isolated context, not lumped into skills. The alternative treats
roles and workflows the same way, which breaks Claude Code's agent model
Stays up to date — a GitHub Actions workflow checks BMAD-METHOD weekly
for new releases and creates an issue when one is found. No manual checking
Catches drift — a pre-push hook validates that every agent, skill, and
file in this plugin matches the official BMAD-METHOD repo. If something is
missing or out of date, the push is blocked
Tracks versions — the plugin version (6.0.0-Beta.4.2) includes the
upstream version so you always know which BMAD-METHOD release you're running

License

MIT License - See LICENSE for details.

BMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC.