BMAD-METHOD/src/modules/bmm
Alex Verkhovsky 782f08b956
Merge d5e5796ba3 into 901b39de9a
2025-12-15 15:55:19 +00:00
..
_module-installer all modules custom or core use the same installer and have consistent behavior now. 2025-12-07 17:17:50 -06:00
agents folder workflow naming alignment for consistency 2025-12-15 10:17:58 +08:00
data brainstorming, research and partymode updated to use sharded step flow workflows 2025-11-29 01:49:15 -06:00
docs standardize custom agent workflow and module output, and improve module folder selection 2025-12-13 22:59:58 +08:00
sub-modules/claude-code quick update output modified 2025-12-15 17:30:12 +08:00
teams feat: add custom agents and quick-flow workflows, remove tech-spec track 2025-11-23 08:51:26 -06:00
testarch we only need one yaml lib 2025-12-13 18:35:07 +08:00
workflows Merge d5e5796ba3 into 901b39de9a 2025-12-15 15:55:19 +00:00
README.md fix(bmm): remove stale 'drafted' story state from docs and workflows 2025-12-11 21:20:44 -07:00
module.yaml roo installer had some bugs 2025-12-15 15:08:19 +08: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 → ready-for-dev → 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