ros/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git synced 2026-01-30 04:32:02 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
efbe839a0a9752a3ac6ffa8b4785b290119be2d2
BMAD-METHOD/docs/explanation/bmm/index.md
forcetrainer e535f94325 docs: comprehensive style guide update with reference and glossary standards 
Style Guide Additions:
- Add Reference Structure section with 6 document types (Index, Catalog,
  Deep-Dive, Configuration, Glossary, Comprehensive)
- Add Glossary Structure section with table-based format leveraging
  Starlight's right-nav for navigation
- Include checklists for both new document types

Reference Docs Updated:
- agents/index.md: Catalog format, universal commands tip admonition
- configuration/core-tasks.md: Configuration format with admonitions
- configuration/global-config.md: Table-based config reference
- workflows/index.md: Minimal index format
- workflows/core-workflows.md: Catalog format
- workflows/document-project.md: Deep-dive with Quick Facts admonition
- workflows/bmgd-workflows.md: Comprehensive format, removed ~30 hr rules

Glossary Rewritten:
- Converted from 373 lines with ### headers to 123 lines with tables
- Right nav now shows 9 categories instead of 50+ terms
- Added italic context markers (*BMGD.*, *Brownfield.*, etc.)
- Alphabetized terms within categories
- Removed redundant inline TOC

All Docs:
- Remove horizontal rules (---) per style guide
- Remove "Related" sections (sidebar handles navigation)
- Standardize admonition usage
- Archive deleted workflow customization docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 00:23:05 -05:00

6.3 KiB
Raw Blame History

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

:::tip[Quick Path] Install → workflow-init → Follow agent guidance :::

New to BMM? Start here:

Resource Description
Quick Start Guide Step-by-step guide to building your first project
Complete Workflow Diagram Visual flowchart showing all phases, agents, and decision points

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

:::tip[Ready to Begin?] Start with the Quick Start Guide :::