BMAD Method - Breakthrough Method for Agile AI-Driven Development
Plugin version: v6.0.0-Beta.4.3 | Upstream version: v6.0.0-Beta.4 | Last synced: 2026-01-30
A Claude Code plugin that transforms Claude into a complete agile development environment with specialized agents, structured workflows, and intelligent context management.
Plugin management is done inside a Claude Code session using slash commands. There is no CLI command for installing plugins outside a session.
# Add marketplace
/plugin marketplace add PabloLION/bmad-plugin
# Install plugin
/plugin install bmad@bmad-method
# Pin to a specific version
/plugin marketplace add PabloLION/bmad-plugin#v6.0.0-Beta.4.2Coming soon — pending submission to the official Anthropic plugin registry.
- 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
# Initialize BMAD in your project
/bmad:init
# Check workflow status
/bmad:status
# Start a workflow
/bmad:product-brief| Agent | Role | Key Workflows |
|---|---|---|
| Analyst (Mary) | Business analysis, research | product-brief, research, brainstorm |
| PM (John) | Product requirements | create-prd, validate-prd, epics |
| 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 |
| Quinn | QA engineer | automate |
| Tech Writer (Paige) | Documentation | document-project |
| Barry | Solo dev quick flow | quick-spec, quick-dev |
- Brainstorming and ideation
- Market and competitive research
- Product brief creation
- Product Requirements Document (PRD)
- UX design specifications
- System architecture
- Epic and story breakdown
- Implementation readiness
- Sprint planning
- Story development
- Code review
This plugin implements the BMAD Method created by BMad Code, LLC.
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 validationThe 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.
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-version |
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
MIT License - See LICENSE for details.
BMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC.