ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/src/modules/bmm/docs/README.md

6.4 KiB
Raw Blame History

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:

🎯 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

Ready to begin? → Start with the Quick Start Guide