00a3af3eb0
* fix(bmm): sprint-status workflow improvements - Remove dead by_epic template block and context_status variable (#1116, #1117) - Define "first" story ordering as epic number then story number (#1119) - Clarify retrospective check: "any retrospective status == optional" (#1120) - Strengthen validate mode: check required metadata fields and valid statuses (#1121) - Expand risk detection: stale file, orphaned stories, empty epics (#1122) - Fix retrospective valid status: use "done" instead of "completed" for consistency Fixes #1116, fixes #1117, fixes #1119, fixes #1120, fixes #1121, fixes #1122 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix(bmm): address CodeRabbit review feedback - Improve retrospective status descriptions for clarity - Fix empty epic detection to only warn on in-progress epics - Add 'generated' to required metadata field validation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: Brian <bmadcode@gmail.com> |
||
|---|---|---|
| .. | ||
| _module-installer | ||
| agents | ||
| data | ||
| docs | ||
| sub-modules/claude-code | ||
| teams | ||
| testarch | ||
| workflows | ||
| README.md | ||
| module.yaml | ||
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 → 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
- 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