8.2 KiB
BMM Documentation
Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your project's complexity.
🚀 Getting Started
New to BMM? Start here:
- Quick Start Guide - Step-by-step guide to building your first project (15 min read)
- Installation and setup
- Understanding the four phases
- Running your first workflows
- Agent-based development flow
Quick Path: Install → workflow-init → Follow agent guidance
📊 Visual Overview
Complete Workflow Diagram - Visual flowchart showing all phases, agents (color-coded), and decision points for the BMad Method standard greenfield track.
📖 Core Concepts
Understanding how BMM adapts to your needs:
-
Scale Adaptive System - How BMM adapts to project size and complexity (42 min read)
- Three planning tracks (Quick Flow, BMad Method, Enterprise Method)
- Automatic track recommendation
- Documentation requirements per track
- Planning workflow routing
-
BMAD Quick Flow - Fast-track development workflow (32 min read)
- 3-step process: spec → dev → optional review
- Perfect for bug fixes and small features
- Rapid prototyping with production quality
- Hours to implementation, not days
- Barry (Quick Flow Solo Dev) agent owned
-
Quick Flow Solo Dev Agent - Elite solo developer for rapid development (18 min read)
- Barry is an elite developer who thrives on autonomous execution
- Lives and breathes the BMAD Quick Flow workflow
- Takes projects from concept to deployment with ruthless efficiency
- No handoffs, no delays - just pure focused development
🤖 Agents and Collaboration
Complete guide to BMM's AI agent team:
-
Agents Guide - Comprehensive agent reference (45 min read)
- 12 specialized BMM agents + BMad Master
- Agent roles, workflows, and when to use them
- Agent customization system
- Best practices and common patterns
-
Party Mode Guide - Multi-agent collaboration (20 min read)
- How party mode works (19+ agents collaborate in real-time)
- When to use it (strategic, creative, cross-functional, complex)
- Example party compositions
- Multi-module integration (BMM + CIS + BMB + custom)
- Agent customization in party mode
- Best practices
🔧 Working with Existing Code
Comprehensive guide for brownfield development:
- Brownfield Development Guide - Complete guide for existing codebases (53 min read)
- Documentation phase strategies
- Track selection for brownfield
- Integration with existing patterns
- Phase-by-phase workflow guidance
- Common scenarios
📚 Quick References
Essential reference materials:
- Glossary - Key terminology and concepts
- FAQ - Frequently asked questions across all topics
- Enterprise Agentic Development - Team collaboration strategies
🎯 Choose Your Path
I need to...
Build something new (greenfield) → Start with Quick Start Guide → Then review Scale Adaptive System to understand tracks
Fix a bug or add small feature → Go to BMAD Quick Flow for rapid development → Or use Quick Flow Solo Dev directly
Work with existing codebase (brownfield) → Read Brownfield Development Guide → Pay special attention to documentation requirements for brownfield projects
Understand planning tracks and methodology → See Scale Adaptive System
Find specific commands or answers → Check FAQ
📋 Workflow Guides
Comprehensive documentation for all BMM workflows organized by phase:
-
Phase 1: Analysis Workflows - Optional exploration and research workflows (595 lines)
- brainstorm-project, product-brief, research, and more
- When to use analysis workflows
- Creative and strategic tools
-
Phase 2: Planning Workflows - Scale-adaptive planning (967 lines)
- prd, tech-spec, gdd, narrative, ux
- Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
- Which planning workflow to use
-
Phase 3: Solutioning Workflows - Architecture and validation (638 lines)
- architecture, create-epics-and-stories, implementation-readiness
- V6: Epics created AFTER architecture for better quality
- Required for BMad Method and Enterprise Method tracks
- Preventing agent conflicts
-
Phase 4: Implementation Workflows - Sprint-based development (1,634 lines)
- sprint-planning, create-story, dev-story, code-review
- Complete story lifecycle
- One-story-at-a-time discipline
-
Testing & QA Workflows - Comprehensive quality assurance (1,420 lines)
- Test strategy, automation, quality gates
- TEA agent and test healing
- BMad-integrated vs standalone modes
Total: 34 workflows documented across all phases
Advanced Workflow References
For detailed technical documentation on specific complex workflows:
-
Document Project Workflow Reference - Technical deep-dive (445 lines)
- v1.2.0 context-safe architecture
- Scan levels, resumability, write-as-you-go
- Multi-part project detection
- Deep-dive mode for targeted analysis
-
Architecture Workflow Reference - Decision architecture guide (320 lines)
- Starter template intelligence
- Novel pattern design
- Implementation patterns for agent consistency
- Adaptive facilitation approach
🧪 Testing and Quality
Quality assurance guidance:
- Test design workflows
- Quality gates
- Risk assessment
🏗️ Module Structure
Understanding BMM components:
- BMM Module README - Overview of module structure
- Agent roster and roles
- Workflow organization
- Teams and collaboration
- Best practices
🌐 External Resources
Community and Support
- Discord Community - Get help from the community (#general-dev, #bugs-issues)
- GitHub Issues - Report bugs or request features
- YouTube Channel - Video tutorials and walkthroughs
Additional Documentation
- IDE Setup Guides - Configure your development environment
- Claude Code
- Cursor
- Windsurf
- VS Code
- Other IDEs
📊 Documentation Map
flowchart TD
START[New to BMM?]
START --> QS[Quick Start Guide]
QS --> DECIDE{What are you building?}
DECIDE -->|Bug fix or<br/>small feature| QF[BMAD Quick Flow]
DECIDE -->|Need rapid<br/>development| PE[Principal Engineer]
DECIDE -->|New project| SAS[Scale Adaptive System]
DECIDE -->|Existing codebase| BF[Brownfield Guide]
QF --> IMPL[Implementation]
PE --> IMPL
SAS --> IMPL
BF --> IMPL
IMPL --> REF[Quick References<br/>Glossary, FAQ]
style START fill:#bfb,stroke:#333,stroke-width:2px,color:#000
style QS fill:#bbf,stroke:#333,stroke-width:2px,color:#000
style DECIDE fill:#ffb,stroke:#333,stroke-width:2px,color:#000
style QF fill:#e1f5fe,stroke:#333,stroke-width:2px,color:#000
style PE fill:#fff3e0,stroke:#333,stroke-width:2px,color:#000
style IMPL fill:#f9f,stroke:#333,stroke-width:2px,color:#000
💡 Tips for Using This Documentation
- Start with Quick Start if you're new - it provides the essential foundation
- Use the FAQ to find quick answers without reading entire guides
- Bookmark Glossary for terminology references while reading other docs
- Follow the suggested paths above based on your specific situation
- Join Discord for interactive help and community insights
Ready to begin? → Start with the Quick Start Guide