BMAD-METHOD/docs/explanation/bmm/index.md

title

title
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

The BMad Method is meant to be adapted and customized to your specific needs. In this realm there is no one size fits all - your needs are unique, and BMad Method is meant to support this (and if it does not, can be further customized or extended with new modules).

First know there is the full BMad Method Process and then there is a Quick Flow for those quicker smaller efforts.

• Full Adaptive BMad Method - Full planning and scope support through extensive development and testing.

  • Broken down into 4 phases, all of which are comprised of both required and optional phases
    • Phases 1-3 are all about progressive idea development through planning and preparations to build your project.
    • Phase 4 is the implementation cycle where you will Just In Time (JIT) produce the contextual stories needed for the dev agent based on the extensive planning completed
    • All 4 phases have optional steps in them, depending on how rigorous you want to go with planning, research ideation, validation, testing and traceability.
  • While there is a lot here, know that even this can be distilled down to a simple PRD, Epic and Story list and then jump into the dev cycle. But if that is all you want, you might be better off with the BMad Quick Flow described next

• 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
  • Implementation in minutes, not days
  • Has a specialized single agent that does all of this: Quick Flow Solo Dev Agent

• TEA engagement (optional) - Choose TEA engagement: none, TEA-only (standalone), or integrated by track. See Test Architect Guide.

🤖 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

🎯 Choose Your Path

I need to...

Build something new (greenfield) → Start with Quick Start Guide

Fix a bug or add small feature → Use the Quick Flow Solo Dev directly with its dedicated stand alone Quick Bmad Spec Flow process

Work with existing codebase (brownfield) → Read Brownfield Development Guide → Pay special attention to documentation requirements for brownfield projects

📋 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

🌐 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