BMAD-METHOD/src/modules/bmm
Scott Jennings 7509b0cbc2 feat: add external agent support for code reviews
Adds support for delegating adversarial code reviews to external CLI agents
(Codex, Gemini, or Claude) when available. This provides independent, unbiased
code reviews from a different AI model.

Changes:
- Add invoke-bash and set-var tags to workflow.xml execution engine
- Add external_review_agents configuration to install-config.yaml
- Rewrite code-review workflow to detect and invoke external agents
- Cache agent detection in config.yaml to avoid repeated CLI checks
- Add fallback to built-in review if external agents unavailable/fail
- Update checklist to reflect new external agent workflow

External agent invocation:
- Codex: codex exec --full-auto "prompt"
- Gemini: gemini -p "prompt" --yolo
- Claude: claude -p "prompt" --dangerously-skip-permissions
2025-12-08 10:36:39 -06: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 installer updates working with basic flow 2025-12-06 12:53:43 -06:00
data brainstorming, research and partymode updated to use sharded step flow workflows 2025-11-29 01:49:15 -06:00
docs conflict marker removed from docs 2025-12-08 08:01:00 -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
tasks installer updates working with basic flow 2025-12-06 12:53: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(quality): add markdownlint-cli2 to quality checks (#1039) 2025-12-06 12:40:07 -06:00
workflows feat: add external agent support for code reviews 2025-12-08 10:36:39 -06:00
README.md docs: comprehensive documentation accuracy overhaul and PM/UX evolution analysis 2025-11-03 19:38:50 -06:00
module.yaml feat: add external agent support for code reviews 2025-12-08 10:36:39 -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