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

🎯 Human Amplification, Not Replacement • 🎨 Works in Any Domain • ⚡ Powered by Specialized Agents

🚀 Quick Start

Prerequisites: Node.js v20+ required

One-line install (thanks Lum!):

git clone --branch v6-alpha --single-branch https://github.com/bmad-code-org/BMAD-METHOD
cd BMAD-METHOD && npm install

Install to your project:

npm run install:bmad

Follow the interactive prompts. Important: When asked for a destination, provide the full path to your project folder (don't accept the default).

Essential Reading: Before using BMad Method, read the BMM v6 Workflows Guide to understand the four-phase workflow system.

Stay Connected:

⭐ Star this repo to get notified of updates
🎥 Subscribe on YouTube for tutorials
💬 Join Discord Community for support and collaboration

⚠️ Alpha Status

This is an active alpha release. Please help us improve by testing and reporting issues!

Status	Details
🔄 Frequent Updates	Pull often. Delete `node_modules` and run `npm install` after updates
🧪 Potentially Unstable	Features and file structure may change frequently. File issues or discuss in Discord
🚧 Work in Progress	Many features, polish, docs, agents, and workflows still coming before and after beta
💻 IDE/Local LLM Required	Web bundles not fully working yet. Use quality LLM Models and tools for testing (especially BMM module)
🔀 PR Target	Submit PRs against `v6-alpha` branch, not `main`

📋 View v6 Alpha Open Items & Roadmap - Track progress and what's coming next

What is BMad-CORE?

The Problem with Traditional AI

Traditional AI tools provide average, bland solutions and do the thinking for you, making you dependent rather than capable.

The BMad-CORE Difference

BMad-CORE brings out the best thinking in you and the AI through:

Guided Collaboration: AI agents act as expert coaches, mentors, and collaborators
Reflective Workflows: Structured frameworks that help you discover insights
Strategic Questioning: Agents ask the right questions to stimulate your thinking
Domain Mastery: Build expertise rather than just getting answers
Amplified Abilities: Your natural talents enhanced, not replaced

The C.O.R.E. System

Collaboration: Human-AI partnership where both contribute unique strengths
Optimized: Refined processes for maximum effectiveness
Reflection: Guided thinking that unlocks better solutions
Engine: Powerful framework orchestrating specialized agents and workflows

Universal Domain Coverage Through Modules

BMad-CORE works in any domain through specialized modules!

📦 Available Alpha Modules

BMad Core (core) - Always Installed

The foundation that powers every module. Includes orchestration agents for local environments and web bundles (ChatGPT, Gemini Gems, etc.).

BMad Method (bmm) - Software Development Excellence

Agile AI-driven software development rebuilt from the ground up on BMad-CORE. Features the revolutionary Scale Adaptive Workflow Engine™ that adjusts from simple tasks to enterprise-scale projects.

Four-Phase Methodology: Analysis → Planning → Solutioning → Implementation

📚 Full BMM Documentation | 📖 v6 Workflows Guide

BMad Builder (bmb) - Create Custom Agents & Workflows

Your authoring tool for custom agents, workflows, and modules. Easier than ever to customize existing modules or create standalone solutions.

Three Agent Types: Full module agents, hybrid agents, and lightweight standalone agents

📚 Full BMB Documentation | 🎯 Agent Creation Guide

Creative Intelligence Suite (cis) - Innovation & Problem-Solving

Unlock creative thinking and innovation! Includes brainstorming workflows that power other modules (like BMM) while standing alone as a complete creative toolkit.

📚 CIS Documentation

🎉 What's New in v6 Alpha

Complete Ground-Up Rewrite

Everything rebuilt with best practices, advanced prompt engineering, and standardized XML/markdown conventions for maximum agent adherence.

🎨 Unprecedented Customizability

Agent Customization: Modify any agent via sidecar files in bmad/_cfg/agents/
Update-Safe: Your customizations persist through updates
Full Control: Change names, personas, communication styles, language
Multi-Language: Agents can communicate in your preferred language

🚀 Intelligent Installer

Brand new interactive installer that configures:

Your name (how agents address you)
Communication language preference
Communication (chat) technical level of explanation (beginner - advanced level technical user knowledge)
Documentation output language
Module-specific customization options
IDE-specific enhancements globally or per module (e.g., Claude Code sub-agents for BMM)

📁 Unified Installation

Everything installs to a single bmad/ folder - no more scattered root folders. Clean, organized, and efficient.

🤝 Consolidated Agent Party

When you install modules, a unified agent party is created for party-mode in your IDE. Super efficient agent simulation with more exciting features coming in beta!

🎮 Expanded Game Development

Game development now fully integrated into BMM module:

Game Type Adaptive: Adjusts to the type of game you're making
Multi-Engine Support: More platforms being added

⚡ BMM Scale Adaptive Workflows

The BMad Method now adapts to your project scale (Levels 0-4) based on:

Project scope and complexity
New vs. existing codebase
Current codebase state
Team size and structure

Guides workflows intelligently from simple tech specs to enterprise-scale planning.

🆕 Three Agent Types (BMB)

Full Module Agents: Complete agents embedded in modules
Hybrid Agents: Shared across modules
Standalone Agents: Tiny, specialized agents free from any module - perfect for specific needs

BMad Method (BMM) Four-Phase Workflow

The BMM module follows a comprehensive four-phase methodology. Each phase adapts to your project's scale and complexity.

Complete workflow documentation →

Phase 1: Analysis (Optional)

Analyst Agent:

brainstorm-project - Generate and refine project concepts
research - Market research, deep research, prompt generation
product-brief - Document initial product vision

Game Designer Agent (for game projects):

brainstorm-game - Game-specific ideation
game-brief - Game concept documentation
research - Game market and technical research

Phase 2: Planning (Required)

PM Agent:

plan-project - Creates scale-adaptive PRD or GDD

The planning workflow adapts to:

Project complexity (Levels 0-4)
Project type (web, mobile, embedded, game, etc.)
New vs. existing codebase
Team structure

Game Designer Agent (for game projects):

plan-game - Uses same workflow but optimized for Game Design Documents

Phase 3: Solutioning (Levels 3-4)

Architect / Game Architect Agent:

architecture - Creates adaptive architecture based on project type
- No more document sharding
- Adapts sections to your project (web, mobile, embedded, game, etc.)
- Beyond basic concerns (complex testing, DevOps, security), specialized agents assist (coming soon)
tech-spec - Generates Epic Tech Specs
- Pulls all technical information from planning
- Includes web research as needed
- One tech spec per epic
- Enhances SM's ability to prepare stories

Note: The PO can validate epics/stories with checklists, though the Architect maintains them during solutioning.

Phase 4: Implementation (Iterative)

Scrum Master (SM) Agent:

Before development starts, the SM prepares each story:

create-story - Generates story from tech spec and context
story-context - 🎉 NEW! Game-changing contextual preparation
- Real-time context gathering for the specific story
- No more generic file lists
- Supercharged, specialized development context

Dev Agent:

Enhanced developer workflow:

Development task execution
Senior dev agent review (replaces separate QA agent)
Pulls rich context from story-context workflow

🎊 Many more exciting changes throughout BMM for you to discover during alpha!

Detailed Installation Guide

Prerequisites

Node.js v20+ (Download)
Git (for cloning)

Step-by-Step Installation

Step 1: Clone the Repository

Option A - One-line install:

git clone --branch v6-alpha --single-branch https://github.com/bmad-code-org/BMAD-METHOD

Option B - Standard clone then checkout:

# Clone via your preferred method:
gh repo clone bmad-code-org/BMAD-METHOD
# OR
git clone https://github.com/bmad-code-org/BMAD-METHOD.git
# OR
git clone git@github.com:bmad-code-org/BMAD-METHOD.git

# Change to the directory
cd BMAD-METHOD

# Checkout alpha branch
git checkout v6-alpha

# Verify branch
git status
# Should show: "On branch v6-alpha. Your branch is up to date with 'origin/v6-alpha'."

Step 2: Install Dependencies

npm install

Verify node_modules folder exists at project root.

Step 3: Install to Your Project

npm run install:bmad

Follow the interactive prompts:

Destination Path: Enter the full path to your project folder
- Don't accept the default
- For new projects, confirm when prompted to create the directory
Module Selection:
- Core (always installed)
- BMM - BMad Method for software development (default)
- BMB - BMad Builder for creating agents/workflows
- CIS - Creative Intelligence Suite
Configuration:
- Your name
- Preferred communication language
- Module-specific options

Step 4: Understanding the Installation

All modules install to a single bmad/ folder in your project:

your-project/
└── bmad/
    ├── core/         # Core framework (always present)
    ├── bmm/          # BMad Method (if selected)
    ├── bmb/          # BMad Builder (if selected)
    ├── cis/          # Creative Intelligence Suite (shared resources)
    └── _cfg/         # Your customizations
        └── agents/   # Agent sidecar customization files

Note: You may see folders for modules you didn't explicitly select. This is intentional - modules share minimal required resources. For example, BMM uses CIS brainstorming workflows, so bmad/cis/ appears with shared files even if you only selected BMM.