Skip to content
๐Ÿค– Consolidated, AI-optimized BMAD docs: llms-full.txt. Fetch this plain text file for complete context.

BMM Documentation

Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your projectโ€™s complexity.


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

Complete Workflow Diagram - Visual flowchart showing all phases, agents (color-coded), and decision points for the BMad Method standard greenfield track.

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.

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

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

Essential reference materials:

  • Glossary - Key terminology and concepts
  • FAQ - Frequently asked questions across all topics

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

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

Ready to begin? โ†’ Start with the Quick Start Guide