History

Murat Ozcan f805de9034 reafactor: address review comments		2025-11-05 13:26:50 -06:00
..
agents	fix quick udpate status bug in installer	2025-11-04 21:16:52 -06:00
tasks	Doc cleanup and mermaid diagram drafts added	2025-11-04 15:02:19 -06:00
teams	docs: massive documentation overhaul + introduce Paige (Documentation Guide agent)	2025-11-02 21:18:33 -06:00
testarch	update local install	2025-11-03 21:05:18 -06:00
workflows	reafactor: address review comments	2025-11-05 13:26:50 -06:00
README.md	update local install	2025-11-03 21:05:18 -06:00
config.yaml	installer doc install option for bmad method module - user can opt to not install all the docs to the destination installation path	2025-11-04 22:17:12 -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:

Quick Start Guide - New to BMM? Start here (15 min)
Agents Guide - Meet your 12 specialized AI agents (45 min)
Scale Adaptive System - How BMM adapts to project size (42 min)
FAQ - Quick answers to common questions
Glossary - Key terminology reference

🏗️ 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

Brownfield Guide - Working with existing codebases
Quick Spec Flow - Fast-track for Level 0-1 projects
Enterprise Agentic Development - Team collaboration patterns
Troubleshooting - Common issues and solutions
IDE Setup Guides - Configure Claude Code, Cursor, Windsurf, etc.

🤝 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