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

Universal Human-AI Collaboration Platform

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

Table of Contents

• Quick Start
• What is BMad-CORE?
• Modules
  • BMad Method (BMM)
  • BMad Builder (BMB)
  • Creative Intelligence Suite (CIS)
• Installation
• Key Features
• Documentation
• Community & Support

Quick Start

• New to v6? → BMad Method V6 Quick Start Guide
• Upgrading? → v4 to v6 Upgrade Guide

What is BMad-CORE?

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

v6 Core Enhancements

• 🎨 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

C.O.R.E. Philosophy

• 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.

Modules

BMad Method (BMM) - Agile AI Development

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

v6 Highlights

🎯 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

BMad Builder (BMB) - Create Custom Solutions

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

Creative Intelligence Suite (CIS) - Innovation & Creativity

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

Installation

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

Project Structure

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

Getting Started

After installation, activate Analyst agent and run:

/workflow-init

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

Key Features

🎨 Update-Safe Customization

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

🚀 Intelligent Installation

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

📁 Unified Architecture

Single bmad/ folder - clean, organized, maintainable.

Documentation

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

Community & Support

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

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - See LICENSE

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

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