BMAD-METHOD/docs/index.md

BMad Documentation Index

Complete map of all BMad Method v6 documentation with recommended reading paths.

---

🎯 Getting Started (Start Here!)

New users: Start with one of these based on your situation:

Your Situation	Start Here	Then Read
Brand new to BMad	Quick Start Guide	BMM Workflows Guide
Upgrading from v4	v4 to v6 Upgrade Guide	Quick Start Guide
Brownfield project	Brownfield Guide	Quick Start Guide

---

📋 Core Documentation

Project-Level Docs (Root)

• README.md - Main project overview, feature summary, and module introductions
• CONTRIBUTING.md - How to contribute, pull request guidelines, code style
• CHANGELOG.md - Version history and breaking changes
• CLAUDE.md - Claude Code specific guidelines for this project

Installation & Setup

• v4 to v6 Upgrade Guide - Migration path for v4 users
• Document Sharding Guide - Split large documents for 90%+ token savings
• Web Bundles - Use BMAD agents in Claude Projects, ChatGPT, or Gemini without installation
• Bundle Distribution Setup - Maintainer guide for bundle auto-publishing

---

🏗️ Module Documentation

BMad Method (BMM) - Software & Game Development

The flagship module for agile AI-driven development.

• BMM Module README - Module overview, agents, and complete documentation index
• BMM Documentation - All BMM-specific guides and references:
  • Quick Start Guide - Step-by-step guide to building your first project
  • Quick Spec Flow - Rapid Level 0-1 development
  • Scale Adaptive System - Understanding the 5-level system
  • Brownfield Guide - Working with existing codebases
• BMM Workflows Guide - ESSENTIAL READING
• Test Architect Guide - Testing strategy and quality assurance

BMad Builder (BMB) - Create Custom Solutions

Build your own agents, workflows, and modules.

• BMB Module README - Module overview and capabilities
• Agent Creation Guide - Design custom agents

Creative Intelligence Suite (CIS) - Innovation & Creativity

AI-powered creative thinking and brainstorming.

• CIS Module README - Module overview and workflows

---

🖥️ IDE-Specific Guides

Instructions for loading agents and running workflows in your development environment.

Popular IDEs:

• Claude Code
• Cursor
• VS Code

Other Supported IDEs:

• Augment
• Cline
• Codex
• Crush
• Gemini
• GitHub Copilot
• IFlow
• Kilo
• OpenCode
• Qwen
• Roo
• Rovo Dev
• Trae

Key concept: Every reference to "load an agent" or "activate an agent" in the main docs links to the ide-info directory for IDE-specific instructions.

---

🔧 Advanced Topics

Custom Agents, Workflow and Modules

• Custom Content Installation - Install and personalize agents, workflows and modules with the default bmad-method installer!
• Agent Customization Guide - Customize agent behavior and responses

Installation & Bundling

• IDE Injections Reference - How agents are installed to IDEs
• Installers & Platforms Reference - CLI tool and platform support
• Web Bundler Usage - Creating web-compatible bundles

---

🎓 Recommended Reading Paths

Path 1: Brand New to BMad (Software Project)

1. README.md - Understand the vision
2. Quick Start Guide - Get hands-on
3. BMM Module README - Understand agents
4. BMM Workflows Guide - Master the methodology
5. Your IDE guide - Optimize your workflow

Path 2: Game Development Project

1. README.md - Understand the vision
2. Quick Start Guide - Get hands-on
3. BMM Module README - Game agents are included
4. BMM Workflows Guide - Game workflows
5. Your IDE guide - Optimize your workflow

Path 3: Upgrading from v4

1. v4 to v6 Upgrade Guide - Understand what changed
2. Quick Start Guide - Reorient yourself
3. BMM Workflows Guide - Learn new v6 workflows

Path 4: Working with Existing Codebase (Brownfield)

1. Brownfield Guide - Approach for legacy code
2. Quick Start Guide - Follow the process
3. BMM Workflows Guide - Master the methodology

Path 5: Building Custom Solutions

1. BMB Module README - Understand capabilities
2. Agent Creation Guide - Create agents
3. BMM Workflows Guide - Understand workflow structure

Path 6: Contributing to BMad

1. CONTRIBUTING.md - Contribution guidelines
2. Relevant module README - Understand the area you're contributing to
3. Code Style section in CONTRIBUTING.md - Follow standards