AI-Powered Development Guide

Master BMAD-METHOD
10x Faster

Learn the Universal AI Agent Framework for orchestrating specialized AI agents. From concept to production in minutes with Agentic Planning and Context-Engineered Development.

0+
Specialized Agents
0+
Smart Workflows
2min
Avg. Setup Time
🎯 Core Concept

What is BMAD-METHOD?

Think of it as your personal AI dream team - 19 specialized experts working together to help you succeed

Built on Four Core Principles

AI agents work as a team

Each with specialized roles and expertise

Human-in-the-loop collaboration

Ensures quality and alignment with your goals

Natural language workflows

Makes it accessible to everyone, not just developers

Context-engineered development

Eliminates the biggest problems in AI-assisted work

Core v6-Alpha Innovations

Scale-Adaptive Intelligence

Automatically adjusts planning depth based on project complexity - from single bug fixes to enterprise systems.

Agent-as-Code Principles

Agents are versioned code artifacts (Markdown/YAML) with declared roles, tools, and success criteria - portable, reusable, and diffable in PRs.

BMad Core Engine

Lean, powerful Collaboration Optimized Reflection Engine that enables custom agents, workflows, and modules beyond just software development.

BMad Builder Module

Create custom workflows, specialized agents, and domain-specific modules. Share them in the community marketplace.

Think of it like this...

🏢 Traditional AI: Like hiring a single consultant who tries to do everything

👥 BMAD-METHOD: Like having a full team of specialists - each expert in their field, working together seamlessly

⚡ The result? Better outcomes, less confusion, more success!
🚀 v6 Alpha

Installation Made Simple

Get started with v6-alpha in minutes - the future of BMAD-METHOD

Prerequisites Check

Node.js
20+
Required
npm
9+
Required
Git
any
Required
AI IDE (Cursor/Windsurf)
latest
Required
VS Code
latest
Optional

Quick Install

Recommended for most users

Get started in under 5 minutes

2-5 minutes
🔧

Full Setup

For contributors and advanced users

Complete repository with all tools

5-10 minutes
🌐

Web UI Only

No installation required

Use with ChatGPT, Claude, or Gemini

1-2 minutes

⚡ Quick Install (v6-alpha)
Recommended

Clone v6-alpha branch

Clone the alpha branch directly to get started with v6

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

Install dependencies

Navigate to the directory and install all required node modules

cd BMAD-METHOD
npm install

Install to your project

Run the installer and provide the full path to your project folder when prompted

npm run install:bmad
What happens next?
  • ✅ BMAD v6 Core framework is installed in a single 'bmad' folder
  • ✅ BMM (BMad Method Module) for full BMad Method functionality
  • ✅ CORE (Collaboration Optimized Reflection Engine) framework is ready
  • ✅ Access to specialized agents for enhanced collaborative workflows
  • ✅ You're ready to experience the future of AI-driven development!
🧠 Core Concepts

Understanding BMAD-METHOD

Master these key concepts to unlock the full power of AI agent collaboration

Meet Your AI Team

Each agent has a unique personality, expertise, and role in your project

🎯

BMad-Master

Universal Agent

Can perform any task except story implementation - perfect for general use

Planning
Analysis
+2 more
🔬

Analyst (Alex)

Research Specialist

Market research, brainstorming, and project brief creation

Market Research
Brainstorming
+2 more
📋

Product Manager (John)

Requirements Expert

Creates detailed PRDs with user stories and acceptance criteria

PRD Creation
User Stories
+2 more
🏗️

Architect (Sarah)

Technical Designer

System architecture, technical design, and technology selection

System Design
Tech Stack Selection
+2 more
💻

Developer (James)

Implementation Expert

Code implementation, debugging, and testing

Code Implementation
Testing
+2 more
🔍

QA Architect (Quinn)

Quality Guardian

Quality assurance, test strategy, and code review

Test Strategy
Quality Gates
+2 more

Putting It All Together

👥

Specialized Agents

Work together as a team

🔄

Smart Workflows

Guide every step of the process

Quality Results

Consistent, high-quality outcomes

🚀 v6-Alpha Release

The Revolutionary v6 Workflow

Welcome to BMAD-METHOD v6-alpha! Experience the revolutionary 4-phase workflow system with scale-adaptive planning, just-in-time design, and dynamic expertise injection. This interactive guide will take you through the complete journey from idea to deployment.

Scale-Adaptive Planning: Choose Your Project Size

📦 Outputs

  • Focused PRD
  • tech-spec.md

📊 Stories

5-15 stories

➡️ Next Phase

Implementation
🔬

Phase 1: Analysis

(Optional)

Optional workflows for project discovery and requirements gathering

30-60 min
🔬Analyst

Workflows Available

workflow-status
Required

Universal entry point - Always start here!

brainstorm-game

Game concept ideation

brainstorm-project

Software solution exploration

game-brief

Structured game design foundation

product-brief

Strategic product planning

research

Multi-mode research (market/technical/deep)

Phase Output

Project brief, Research artifacts

Hands Off To

Product Manager (PM)

📋

Phase 2: Planning

(Required)

Scale-adaptive planning that routes projects based on complexity

45-90 min
📋PM
🏗️

Phase 3: Solutioning

(Level 3-4 Only)

Architecture and technical design for complex projects

60-120 min
🏗️Architect
💻

Phase 4: Implementation

(Iterative Cycle)

The core development cycle with 4-state story progression

Continuous
💻SM & DEV

Core v6 Innovations

🎯

Scale-Adaptive Planning

Projects automatically route through different workflows based on complexity

Just-In-Time Design

Tech specs created one epic at a time during implementation, not all upfront

🧠

Dynamic Expertise Injection

Story-context workflows provide targeted technical guidance per story

🔄

Continuous Learning Loop

Retrospectives feed improvements back into workflows

Quick Reference Commands

# Universal Entry Point (Always Start Here!)
bmad analyst workflow-status
# Phase 2: Planning
bmad pm plan-project
# Phase 3: Solutioning (Level 3-4)
bmad architect solution-architecture
bmad architect tech-spec # Per epic, JIT
# Phase 4: Implementation
bmad sm create-story # Draft story
bmad sm story-ready # Approve for dev
bmad sm story-context # Generate context
bmad dev dev-story # Implement
bmad dev story-approved # Mark done
🎯 Complete Project Example

Build a Task Manager App

Let's build a complete Task Manager Application from scratch using the BMAD-METHOD workflow. This hands-on tutorial demonstrates every phase of the development process, from initial concept to deployment.

🔬

Phase 1: Planning & Analysis

30-45 min
🔬
Agent Working
Analyst (Alex)

Alex conducts comprehensive market research, analyzes competitors, creates detailed project briefs, and develops user personas. Alex ensures the project starts with a solid understanding of the problem space and target audience.

Hands off to:
Product Manager (John)

Project Brief:

Our goal is to create a modern Task Manager Application that helps individuals and teams organize their work efficiently.

Core Objectives:

- Simple, intuitive task creation and management

- Organize tasks by categories/projects

- Track task status (todo, in-progress, completed)

- Set due dates and priorities

- Collaborative features for teams

Pro Tips
  • Keep the initial scope manageable
  • Focus on core features first
  • Think about your target users

Congratulations!

You've completed the Task Manager App tutorial! You now understand the complete BMAD-METHOD workflow from planning to deployment. Here's what you've learned:

Planning & Design

Requirements gathering, user stories, and architecture design

Development

Full-stack implementation with Next.js, Prisma, and modern tools

Testing & Deployment

Comprehensive testing and production deployment

💡 Real-World Applications

Endless Possibilities

Discover how BMAD-METHOD transforms work across industries and domains

Development Use Cases

🌐

Full-Stack Web Application

Complete web app from planning to deployment

High
4-12 weeks

Involved Agents

Analyst
PM
Architect
UX
Developer
QA

Examples

  • E-commerce platform
  • Social media app
  • Project management tool
📱

Mobile App Development

iOS/Android applications with native features

High
6-16 weeks

Involved Agents

Analyst
PM
Architect
UX
Developer
QA

Examples

  • Fitness tracker
  • Food delivery app
  • Social networking
🔌

API & Microservices

RESTful or GraphQL APIs for integration

Medium
2-4 weeks

Involved Agents

PM
Architect
Developer
QA

Examples

  • Payment service
  • Notification API
  • Data analytics service
🗄️

Database Design & Migration

Schema design and data migration strategies

Medium
1-4 weeks

Involved Agents

Architect
Developer
QA

Examples

  • SQL to NoSQL migration
  • Multi-tenant architecture
  • Performance optimization

Why BMAD-METHOD Works Everywhere

🎯

Specialized Expertise

Each agent brings deep knowledge in their specific domain

🔄

Proven Workflows

Time-tested processes that work across different industries

Consistent Quality

Built-in quality assurance ensures excellent results every time

Video Tutorials

Learn by Watching

Follow along with expert tutorials covering everything from basics to advanced concepts

BMAD-METHOD v6-Alpha: Complete Walkthrough
15:42
Getting Started

BMAD-METHOD v6-Alpha: Complete Walkthrough

Complete introduction to BMAD-METHOD v6-alpha, covering installation, core concepts, and your first agent workflow.

12.5K views856
BMAD-METHOD v6-Alpha: Complete Walkthrough
15:42
Getting Started

BMAD-METHOD v6-Alpha: Complete Walkthrough

Complete introduction to BMAD-METHOD v6-alpha, covering installation, core concepts, and your first agent workflow.

12.5K856
Scale-Adaptive Intelligence Explained
18:30
Advanced

Scale-Adaptive Intelligence Explained

Deep dive into the new scale-adaptive planning system with Level 0-4 complexity management.

8.3K642
Building Custom Agents with Agent-as-Code
22:15
Development

Building Custom Agents with Agent-as-Code

Learn how to create and deploy your own custom agents using the Agent-as-Code principles.

6.7K523
50+ Smart Workflows: A Complete Guide
25:48
Workflows

50+ Smart Workflows: A Complete Guide

Overview of all 50+ smart workflows available in v6-alpha and how to use them effectively.

9.2K734
BMad Core Engine: Architecture Deep Dive
20:12
Architecture

BMad Core Engine: Architecture Deep Dive

Understand the internals of the Collaboration Optimized Reflection Engine powering v6-alpha.

5.4K412
Real-World Project: Full-Stack App in Minutes
12:30
Case Study

Real-World Project: Full-Stack App in Minutes

Watch as we build a complete full-stack application using BMAD-METHOD in record time.

15.8K1.2K
🌍 Join the Community

Connect & Collaborate

Join our growing community of developers, creators, and innovators using BMAD-METHOD

GitHub Repository

Explore the source code, contribute, and report issues

2.5k+ Stars

Discord Community

Join thousands of developers, get help, and share your projects

5k+ Members

Video Tutorials

Watch comprehensive tutorials and learn best practices

50+ Videos

Documentation

Comprehensive guides covering every aspect of BMAD-METHOD

100+ Pages

Downloadable Resources

Enhance your learning with these free, comprehensive resources

Quick Reference Guide

One-page cheat sheet with all essential commands and workflows

PDF
2.1 MB

Agent Role Cards

Printable cards describing each of the 19 specialized agents

PDF
3.8 MB

Workflow Diagrams

Visual flowcharts for all 50+ workflows

PDF
5.4 MB
5,000+
Community Members
2,500+
GitHub Stars
500+
Projects Built
19
Specialized Agents

Become Part of Something Amazing

Join our vibrant community, contribute to the project, and help shape the future of AI-driven development

🆘 Get Help

Troubleshooting & Support

Quick solutions to common problems and resources for getting help

Installation Issues

Development Issues

Quality Assurance Issues

Web UI Issues

Need More Help?

Connect with the community and access additional resources

Official Documentation

Comprehensive guides and reference materials

Visit

Discord Community

Real-time help from the community

Visit

GitHub Issues

Report bugs and feature requests

Visit

Video Tutorials

Step-by-step video guides

Visit

🚨 Found a Critical Bug?

If you've encountered a critical issue that's blocking your work, please report it immediately

BMAD BOT