BMAD Method v6 for Claude Code
Token-optimized agile development methodology natively integrated with Claude Code
Transform Claude Code into a complete agile development environment with specialized agents, structured workflows, and intelligent context management.
Documentation Site, with examples.
https://aj-geddes.github.io/claude-code-bmad-skills
🎯 Attribution & Credit
BMAD Method™
The BMAD Method (Breakthrough Method for Agile AI-Driven Development) is created and maintained by the BMAD Code Organization.
All credit for the BMAD methodology belongs to:
- BMAD Code Organization: https://github.com/bmad-code-org
- Original BMAD Method: https://github.com/bmad-code-org/BMAD-METHOD
- Website: https://bmadcodes.com/bmad-method/
- YouTube: @BMadCode
- Discord Community: https://discord.gg/gk8jAdXWmj
This repository is an implementation of the BMAD Method specifically adapted for Claude Code's native features (Skills, Commands, Hooks, Memory, Files).
The methodology, workflow patterns, agent roles, and all BMAD concepts are the intellectual property of the BMAD Code Organization.
We have adapted and optimized the BMAD Method for:
- Token efficiency (70-85% optimization via helper pattern)
- Claude Code native integration (no external dependencies)
- Cross-platform support (Windows, Linux, macOS, WSL)
- Functional design (removed persona overhead for better performance)
Please support the original BMAD Method creators by visiting their resources above.
🤖 For LLMs: Quick Installation
If you are Claude Code (or another LLM) and the user has asked you to install BMAD:
Auto-Detect Platform and Install
-
Clone repository:
# Works on all platforms (git is cross-platform) cd /tmp git clone https://github.com/aj-geddes/claude-code-bmad-skills.git cd claude-code-bmad-skills -
Run appropriate installer:
Linux/macOS/WSL:
chmod +x install-v6.sh ./install-v6.shWindows PowerShell:
.\install-v6.ps1 -
Verify installation:
# Check core skill installed ls -la ~/.claude/skills/bmad/core/bmad-master/SKILL.md # Linux/macOS/WSL dir $env:USERPROFILE\.claude\skills\bmad\core\bmad-master\SKILL.md # Windows -
Inform user:
✓ BMAD Method v6 installed successfully! Installed to: ~/.claude/skills/bmad/ and ~/.claude/config/bmad/ 9 Specialized Skills: - BMad Master (orchestrator) - Business Analyst (product discovery) - Product Manager (requirements) - System Architect (design) - Scrum Master (sprint planning) - Developer (implementation) - UX Designer (user experience) - Builder (custom agents/workflows) - Creative Intelligence (brainstorming/research) 15 Workflow Commands: - /workflow-init - Initialize BMAD in project - /workflow-status - Check project status - /product-brief - Phase 1: Product discovery - /prd - Phase 2: Detailed requirements - /tech-spec - Phase 2: Lightweight requirements - /architecture - Phase 3: System design - /solutioning-gate-check - Phase 3: Validate design - /sprint-planning - Phase 4: Plan sprint - /create-story - Phase 4: Create user story - /dev-story - Phase 4: Implement story - /create-agent - Builder: Custom agent - /create-workflow - Builder: Custom workflow - /brainstorm - Creative: Structured brainstorming - /research - Creative: Market/tech research - /create-ux-design - UX: User experience design Next Steps: 1. Restart Claude Code (skills load on startup) 2. Open your project directory 3. Run: /workflow-init 4. Run: /workflow-status (get recommendations) BMAD Method v6 is now active!
📖 What is BMAD Method v6?
BMAD Method v6 is a Claude Code native implementation of the BMAD Method created by the BMAD Code Organization.
This implementation adapts the complete BMAD agile development methodology to Claude Code's native features (Skills, Commands, Hooks, Memory, Files) with optimizations for minimal token usage.
Original BMAD Method™ by BMAD Code Organization | Implementation by this repository
Key Features
✅ Token-Optimized - Helper pattern reduces token usage by 70-85%
- Reusable helper sections referenced instead of embedded
- Functional skills without persona overhead
- 750-1,000 tokens saved per conversation
✅ 9 Specialized Skills - Each agent focused on specific responsibilities
- Core orchestrator (BMad Master)
- 6 agile agents (Analyst, PM, Architect, SM, Developer, UX Designer)
- Builder for extensibility
- Creative Intelligence for innovation
✅ 15 Workflow Commands - Structured, repeatable processes
- Phase 1: Analysis (product discovery)
- Phase 2: Planning (requirements)
- Phase 3: Solutioning (architecture)
- Phase 4: Implementation (development)
- Extensibility: Custom agents, workflows, brainstorming, research, UX design
✅ Cross-Platform - Works everywhere Claude Code runs
- Windows (PowerShell 5.1 and 7+)
- Linux (all distributions)
- macOS (all versions)
- WSL 1 and WSL 2
- No external dependencies (no npx, npm, Python packages)
✅ Production Ready - All 8 phases complete and tested
- Core BMAD workflows (Phases 1-5)
- Builder module (Phase 6)
- Creative Intelligence (Phase 7)
- UX/Advanced features (Phase 8)
🎯 The BMAD Workflow
Phase 1: Analysis (Product Discovery)
Agent: Business Analyst
Commands:
/workflow-init- Initialize BMAD structure in project/workflow-status- Check current status and get recommendations/product-brief- Create product brief with market analysis
Output: Product brief document defining what to build
When: Start of new project or major feature
Phase 2: Planning (Requirements)
Agent: Product Manager
Commands:
/prd- Create comprehensive Product Requirements Document (Level 2+ projects)/tech-spec- Create lightweight tech spec (Level 0-1 projects)
Output: Requirements document with:
- Functional Requirements (FR-XXX)
- Non-Functional Requirements (NFR-XXX)
- User stories grouped by epics
- Acceptance criteria
- MoSCoW prioritization
When: After product brief, before architecture
Phase 3: Solutioning (Architecture)
Agent: System Architect
Commands:
/architecture- Create comprehensive system architecture/solutioning-gate-check- Validate architecture quality (≥90% coverage)
Output: Architecture document with:
- System components
- Data models and schemas
- API specifications
- Technology stack justifications
- NFR coverage (performance, security, scalability)
When: After requirements, before implementation
Phase 4: Implementation (Development)
Agents: Scrum Master + Developer
Commands:
/sprint-planning- Plan sprint iterations/create-story- Create atomic user stories/dev-story- Implement stories with tests
Output: Working software with:
- Implemented features
- Automated tests
- Documentation
- Sprint reports
When: After architecture approval, iterative sprints
Phase 6: Builder Module (Extensibility)
Agent: Builder
Commands:
/create-agent- Create custom BMAD agent skills (QA, DevOps, Security, etc.)/create-workflow- Create custom workflow commands/create-template- Create custom document templates
Output: Custom agents and workflows following BMAD patterns
When: Need domain-specific agents or workflows
Example Use Cases:
- QA Engineer with
/create-test-plan,/execute-tests - DevOps Engineer with
/deploy,/rollback - Security Engineer with
/security-audit,/pen-test - Data Scientist with
/data-analysis,/model-training
Phase 7: Creative Intelligence (Innovation)
Agent: Creative Intelligence
Commands:
/brainstorm- Structured brainstorming using 8 proven techniques- 5 Whys, SCAMPER, Mind Mapping, Reverse Brainstorming
- Six Thinking Hats, Starbursting, Brainwriting, SWOT
/research- Comprehensive research (market, competitive, technical, user)
Output:
- Brainstorming documents with organized ideas and insights
- Research reports with competitive analysis and recommendations
When:
- Product discovery (market research)
- Feature planning (brainstorm ideas)
- Technical decisions (research options)
- Problem solving (root cause analysis)
Phase 8: UX/Advanced (User Experience)
Agent: UX Designer
Commands:
/create-ux-design- Create comprehensive UX design
Output: UX design document with:
- User flows (happy paths, decision points, error cases)
- Wireframes (ASCII art or structured descriptions)
- WCAG 2.1 accessibility compliance
- Component library specifications
- Design tokens (colors, typography, spacing)
- Developer handoff documentation
When: After requirements, parallel with architecture
🚀 Quick Start (For Humans)
Installation
Option 1: Let Claude Code Install (Recommended)
Give Claude Code this repository URL:
https://github.com/aj-geddes/claude-code-bmad-skills
Then say:
"Please install BMAD Method v6 from this repository"
Claude Code will detect your platform and install automatically.
**Option 2: Manua