BMAD Method for Claude Code

A complete agile development methodology converted to Claude Code native features

Attribution & Credits

What is BMAD Method for Claude Code?

BMAD (Business Methodology for AI Development) transforms Claude Code into a full-featured agile development environment. Instead of using external tools or complex setups, everything works through Claude Code’s native features:

• 9 Specialized Skills - AI agents for different roles (Analyst, PM, Architect, Developer, etc.)
• 15 Workflow Commands - Slash commands for every development phase
• 4 Development Phases - Analysis → Planning → Solutioning → Implementation
• Token-Optimized - 70-85% reduction through helper patterns

Key Benefits

Quick Start

For LLMs (Claude Code)

1. Run /workflow-init to initialize BMAD in your project
2. Run /workflow-status to see recommended next steps
3. Follow the phase-appropriate commands

For Humans

1. Install BMAD:

   # Linux/macOS/WSL
   git clone https://github.com/aj-geddes/claude-code-bmad-skills.git
   cd claude-code-bmad-skills
   ./install-v6.sh
   
   # Windows PowerShell
   git clone https://github.com/aj-geddes/claude-code-bmad-skills.git
   cd claude-code-bmad-skills
   .\install-v6.ps1
   

2. Restart Claude Code (skills load on startup)

3. Initialize in your project:

   /workflow-init
   

The Four Phases

Phase 1: Analysis

Skill: Business Analyst Commands: /product-brief, /brainstorm-project, /research

Discover requirements, research markets, and define the problem space.

Phase 2: Planning

Skills: Product Manager, UX Designer Commands: /prd, /tech-spec, /create-ux-design

Create comprehensive requirements and design documents.

Phase 3: Solutioning

Skill: System Architect Commands: /architecture, /solutioning-gate-check

Design system architecture and validate against requirements.

Phase 4: Implementation

Skills: Scrum Master, Developer Commands: /sprint-planning, /create-story, /dev-story

Plan sprints, create stories, and implement features.

Documentation

Example Session

Here’s what a typical BMAD session looks like:

User: I want to build a task management app

Claude: I'll help you build that! Let me initialize BMAD in your project.

> /workflow-init

Created bmad/config.yaml with:
- Project: Task Management App
- Level: 2 (Medium feature set)
- Type: web-app

> /workflow-status

Phase 1 - Analysis: Not started
  Recommended: /product-brief

Let's start with a product brief to define your app's scope and goals.

> /product-brief

[Interactive session to create comprehensive product brief]

Output saved to: docs/product-brief.md

> /workflow-status

Phase 1 - Analysis: Complete ✓
Phase 2 - Planning: Not started
  Recommended: /prd (for Level 2+ projects)

Ready to create your Product Requirements Document?

> /prd

[Interactive session to define features, user stories, acceptance criteria]

Output saved to: docs/prd.md
...

Project Levels

BMAD right-sizes your planning based on project complexity:

Skills Overview

Why Claude Code Native?

Traditional development methodologies require:

• Separate project management tools
• Multiple documentation systems
• Context switching between tools
• Manual status tracking

BMAD for Claude Code provides:

• Single Interface - Everything in your terminal
• Persistent Context - YAML status files maintain state
• Intelligent Routing - Automatic workflow recommendations
• Token Efficiency - Optimized for Claude’s context window

Community & Support

• GitHub Issues: Report bugs or request features
• Contributing: See CONTRIBUTING.md
• License: MIT

Version History