BMAD-METHOD/src/modules/bmm/docs

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
  • 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

  • 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

  • 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

  • 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

  • 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

  • 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
  • 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

📋 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

🏗️ 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

Ready to begin? → Start with the Quick Start Guide