BMAD-METHOD/bmad/bmm
Serhii 7795d62165
fix(workflow-init): standardize choice format to numeric
Replace inconsistent letter-based choice format [a/b/c/d] with
numeric format [1/2/3/4] throughout workflow-init for consistency
with other workflows and better user experience.

Changes:
- STATE 2: Planning artifacts choice [a/b/c/d] → [1/2/3/4]
- STATE 3: Implementation choice [a/b/c/d] → [1/2/3/4]
- Step 4: Discovery workflows [a/b/c/d] → [1/2/3/4]
- Step 6: Product Brief [a/b] → [1/2] (reported issue)
- Updated all check conditions (choice == a → choice == 1, etc.)
- Removed redundant comments from check conditions

Fixes #863

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-06 21:20:28 +02: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 fix(workflow-init): standardize choice format to numeric 2025-11-06 21:20:28 +02: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:


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