BMAD-METHOD/src/modules/bmm
Brian Madison 24e952c511 updated code review 2025-11-25 16:59:00 -06:00
..
_module-installer feat: add custom agents and quick-flow workflows, remove tech-spec track 2025-11-23 08:51:26 -06:00
agents fix: optimize agent compiler and complete handler cleanup 2025-11-23 21:28:50 -06:00
docs feat: add custom agents and quick-flow workflows, remove tech-spec track 2025-11-23 08:51:26 -06:00
sub-modules/claude-code The install directory is now configurable, with a few minute issues 2025-11-08 13:58:43 -06:00
teams feat: add custom agents and quick-flow workflows, remove tech-spec track 2025-11-23 08:51:26 -06:00
testarch feat: playwright-utils integration (#954) 2025-11-20 17:34:08 -06:00
workflows updated code review 2025-11-25 16:59:00 -06:00
README.md docs: comprehensive documentation accuracy overhaul and PM/UX evolution analysis 2025-11-03 19:38:50 -06:00

README.md

BMM - BMad Method Module

Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.


📚 Complete Documentation

👉 BMM Documentation Hub - Start here for complete guides, tutorials, and references

Quick Links:


🏗️ Module Structure

This module contains:

bmm/
├── agents/          # 12 specialized AI agents (PM, Architect, SM, DEV, TEA, etc.)
├── workflows/       # 34 workflows across 4 phases + testing
├── teams/           # Pre-configured agent groups
├── tasks/           # Atomic work units
├── testarch/        # Comprehensive testing infrastructure
└── docs/            # Complete user documentation

Agent Roster

Core Development: PM, Analyst, Architect, SM, DEV, TEA, UX Designer, Technical Writer Game Development: Game Designer, Game Developer, Game Architect Orchestration: BMad Master (from Core)

👉 Full Agents Guide - Roles, workflows, and when to use each agent

Workflow Phases

Phase 0: Documentation (brownfield only) Phase 1: Analysis (optional) - 5 workflows Phase 2: Planning (required) - 6 workflows Phase 3: Solutioning (Level 3-4) - 2 workflows Phase 4: Implementation (iterative) - 10 workflows Testing: Quality assurance (parallel) - 9 workflows

👉 Workflow Guides - Detailed documentation for each phase


🚀 Getting Started

New Project:

# Install BMM
npx bmad-method@alpha install

# Load Analyst agent in your IDE, then:
*workflow-init

Existing Project (Brownfield):

# Document your codebase first
*document-project

# Then initialize
*workflow-init

👉 Quick Start Guide - Complete setup and first project walkthrough


🎯 Key Concepts

Scale-Adaptive Design

BMM automatically adjusts to project complexity (Levels 0-4):

  • Level 0-1: Quick Spec Flow for bug fixes and small features
  • Level 2: PRD with optional architecture
  • Level 3-4: Full PRD + comprehensive architecture

👉 Scale Adaptive System - Complete level breakdown

Story-Centric Implementation

Stories move through a defined lifecycle: backlog → drafted → ready → in-progress → review → done

Just-in-time epic context and story context provide exact expertise when needed.

👉 Implementation Workflows - Complete story lifecycle guide

Multi-Agent Collaboration

Use party mode to engage all 19+ agents (from BMM, CIS, BMB, custom modules) in group discussions for strategic decisions, creative brainstorming, and complex problem-solving.

👉 Party Mode Guide - How to orchestrate multi-agent collaboration


📖 Additional Resources


🤝 Community

  • Discord - Get help, share feedback (#general-dev, #bugs-issues)
  • GitHub Issues - Report bugs or request features
  • YouTube - Video tutorials and walkthroughs

Ready to build?Start with the Quick Start Guide