BMAD-METHOD/docs/index.md

BMad Documentation Index

🎯 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

Installation & Setup

• v4 to v6 Upgrade Guide - Migration path for v4 users
• Document Sharding Guide - Split large documents for 90%+ token savings
• Bundle Distribution Setup - (temporarily non-functional) 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 Overview - 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

🔧 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

---

🎓 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

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. BMGD Workflows Guide - Game-specific workflows

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 Overview - Understand capabilities
2. Agent Creation Guide - Create agents
3. BMB 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