BMad CORE + BMad Method

🚨 ALPHA VERSION DOCUMENTATION

• Install v6 Alpha: npx bmad-method@alpha install
• Install stable v4: npx bmad-method install
• View v4 documentation

BMad-CORE (Collaboration Optimized Reflection Engine) amplifies human potential through specialized AI agents. Unlike tools that replace thinking, BMad-CORE guides reflective workflows that bring out your best ideas and AI's full capabilities.

🎯 Human Amplification • 🎨 Domain Agnostic • ⚡ Agent-Powered

• BMad CORE + BMad Method
  • Universal Human-AI Collaboration Platform
  • Table of Contents
  • Quick Start
    • ⚡ NEW: Quick Spec Flow for Rapid Development
  • What is BMad-CORE?
    • v6 Core Enhancements
    • C.O.R.E. Philosophy
  • Modules
    • BMad Method (BMM) - Agile AI Development
      • v6 Highlights
    • BMad Builder (BMB) - Create Custom Solutions
    • Creative Intelligence Suite (CIS) - Innovation & Creativity
  • Installation
    • Project Structure
    • Getting Started
  • Key Features
    • 🎨 Update-Safe Customization
    • 🚀 Intelligent Installation
    • 📁 Unified Architecture
    • 📄 Document Sharding
  • Documentation
  • Community & Support
  • Contributing
  • License

• New to v6? → BMad Method V6 Quick Start Guide
• Need a quick bug fix or small feature? ⚡ → BMad Quick Spec Flow - Go from idea to implementation in minutes!
• Upgrading? → v4 to v6 Upgrade Guide

Perfect for: Bug fixes, small features, rapid prototyping

Skip the full planning docs and go straight to implementation with auto-detected stack, brownfield analysis, and context-rich technical specs. Ideal for Level 0-1 projects that don't need Product Briefs or PRDs.

📚 Learn about project levels: BMad Method Scale Adaptive System - Automatically adapts from Level 0 (bug fixes) to Level 4 (enterprise systems)

When to use Quick Spec Flow:

• 🐛 Bug fixes - Single file changes, isolated improvements
• ✨ Small features - 2-3 related changes, coherent functionality
• 🚀 Rapid prototyping - Quick experiments and validation
• 🔧 Brownfield enhancements - Adding to existing codebases

Not sure which flow to use? Run workflow-init - it will analyze your project goal and recommend either Quick Spec Flow (Level 0-1) or Full BMM Flow (Level 2-4).

→ Read the complete Quick Spec Flow guide

Foundation framework powering all BMad modules:

• Agent Orchestration - Specialized AI personas with unique capabilities
• Workflow Engine - Guided multi-step processes
• Modular Architecture - Domain-specific extensions
• IDE Integration - Works across development environments
• Update-Safe Customization - Persistent configuration through updates

• 🎨 Agent Customization - Modify names, roles, personalities via bmad/_cfg/agents/
• 🌐 Multi-Language - Independent language settings for communication and output
• 👤 Personalization - Agents adapt to your name, technical level, preferences
• 🔄 Persistent Config - Customizations survive all updates
• ⚙️ Flexible Settings - Module or global configuration options

• Collaboration: Human-AI partnership leveraging unique strengths
• Optimized: Refined processes for maximum effectiveness
• Reflection: Guided thinking unlocking better solutions
• Engine: Framework orchestrating specialized agents and workflows

BMad-CORE helps you discover better solutions through strategic questioning and structured thinking.

AI-driven agile framework revolutionizing software and game development. Adapts from bug fixes to enterprise systems.

🎯 Scale-Adaptive Workflows (Levels 0-4)

• Automatically adjusts complexity from quick fixes to enterprise projects
• Greenfield & brownfield support with smart context engine

🏗️ Project-Adaptive Architecture

• Documents adapt to project type (web, mobile, embedded, game)
• Engine-specific game development (Unity, Phaser, Godot, Unreal)

📋 Four-Phase Methodology

1. Analysis - Brainstorming, research, briefs
2. Planning - Scale-adaptive PRD/GDD
3. Solutioning - Architecture and tech specs
4. Implementation - Stories, development, review

Specialized Agents: PM, Analyst, Architect, Scrum Master, Developer, Game Designer/Developer/Architect, UX, Test Architect

Documentation: 📚 BMM Module | 📖 Workflows Guide

Build custom agents, workflows, and modules using BMad-CORE framework.

• Agent Creation - Custom roles and behaviors
• Workflow Design - Structured multi-step processes
• Module Development - Complete domain solutions
• Three Agent Types - Full module, hybrid, standalone

Documentation:

• 📚 BMB Module - Complete module reference
• 🎯 Create Agent - Agent builder workflow
• 📋 Create Workflow - Workflow designer
• 📦 Create Module - Module scaffolding

AI-powered creative facilitation across five domains.

• 5 Interactive Workflows - Brainstorming, Design Thinking, Problem Solving, Innovation Strategy, Storytelling
• 150+ Creative Techniques - Proven frameworks and methodologies
• 5 Specialized Agents - Unique personas and facilitation styles
• Shared Resource - Powers creative workflows in other modules

Documentation: 📚 CIS Module | 📖 CIS Workflows

Prerequisites: Node.js v20+ (Download)

# Install v6 Alpha
npx bmad-method@alpha install

# Install stable v4
npx bmad-method install

Interactive installer guides you through:

1. Project location - Installation directory
2. Module selection - BMM, BMB, CIS
3. Configuration - Name, language, game dev options
4. IDE integration - Environment setup

your-project/
└── bmad/
    ├── core/         # Core framework
    ├── bmm/          # BMad Method
    ├── bmb/          # BMad Builder
    ├── cis/          # Creative Intelligence
    └── _cfg/         # Your customizations
        └── agents/   # Agent configs

After installation, activate Analyst agent and run:

/workflow-init

This initializes the workflow system and helps choose your starting point.

• Agent modification via bmad/_cfg/agents/
• Persistent settings through updates
• Multi-language support
• Flexible configuration

• Auto-detects v4 installations
• Configures IDE integrations
• Resolves dependencies
• Creates unified manifests

Single bmad/ folder - clean, organized, maintainable.

Optional efficiency optimization for large projects:

• Automatic Support - All workflows handle whole or sharded documents
• Selective Loading - Phase 4 workflows load only needed sections (90%+ token savings)
• Easy Sharding - Built-in tool splits documents by headings
• Smart Discovery - Workflows auto-detect format

→ Document Sharding Guide

• 📚 Documentation Index - Complete documentation map
• v4 to v6 Upgrade Guide - Migration instructions
• CLI Tool Guide - Installer reference
• Contributing Guide - Contribution guidelines

• 💬 Discord - Community help
• 🐛 Issues - Bug reports
• 🎥 YouTube - Tutorials
• ⭐ Star this repo - Updates

See CONTRIBUTING.md for guidelines.

MIT License - See LICENSE

Trademark: BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.

_{Built with ❤️ for the human-AI collaboration community}