BMM Documentation
Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your projectโs complexity.
๐ Getting Started
Section titled โ๐ 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
Section titled โ๐ 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
Section titled โ๐ 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
- Broken down into 4 phases, all of which are comprised of both required and optional phases
-
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
Section titled โ๐ค 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
Section titled โ๐ง 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
Section titled โ๐ Quick ReferencesโEssential reference materials:
๐ฏ Choose Your Path
Section titled โ๐ฏ Choose Your PathโI need toโฆ
Section titled โ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
Section titled โ๐ 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
Section titled โ๐ External ResourcesโCommunity and Support
Section titled โCommunity and Supportโ- Discord Community - Get help from the community (#bmad-method-help, #report-bugs-and-issues)
- GitHub Issues - Report bugs or request features
- YouTube Channel - Video tutorials and walkthroughs
Ready to begin? โ Start with the Quick Start Guide