BMAD-METHOD/src/modules/bmm
Alex Verkhovsky 5ee1551b5b
fix(bmm): remove stale validate-prd references (fixes #1030) (#1038)
- Remove validate-prd workflow references from all workflow path YAML files
- Update Excalidraw diagram: remove Validate PRD box and zombie JSON elements
- Re-export SVG at 1x scale
- Standardize implementation-readiness descriptions across all docs
- Add validation script (validate-svg-changes.sh) and README for SVG export process
- Correct Excalidraw timestamps

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-05 21:35:46 -06:00
..
_module-installer workflow-status can call workflow init 2025-11-26 19:48:47 -06:00
agents fix pm and architect agents menu items to load new step sharded workflows 2025-12-02 22:40:57 -06:00
data brainstorming, research and partymode updated to use sharded step flow workflows 2025-11-29 01:49:15 -06:00
docs fix(bmm): remove stale validate-prd references (fixes #1030) (#1038) 2025-12-05 21:35:46 -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 fix(bmm): remove stale validate-prd references (fixes #1030) (#1038) 2025-12-05 21:35:46 -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