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.
What is BMAD-METHOD?
Think of it as your personal AI dream team - 10 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
Two Revolutionary Innovations
Agentic Planning
Dedicated agents collaborate to create detailed, consistent planning documents through advanced prompt engineering.
Context-Engineered Development
Eliminates context loss by embedding everything agents need directly in work artifacts.
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
Installation Made Simple
Get started with v6-alpha in minutes - the future of BMAD-METHOD
Prerequisites Check
Quick Install
Recommended for most users
Get started in under 5 minutes
Full Setup
For contributors and advanced users
Complete repository with all tools
Web UI Only
No installation required
Use with ChatGPT, Claude, or Gemini
⚡ 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-METHODInstall dependencies
Navigate to the directory and install all required node modules
cd BMAD-METHOD
npm installInstall to your project
Run the installer and provide the full path to your project folder when prompted
npm run install:bmad- ✅ 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!
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
Can perform any task except story implementation - perfect for general use
Analyst (Alex)
Market research, brainstorming, and project brief creation
Product Manager (John)
Creates detailed PRDs with user stories and acceptance criteria
Architect (Sarah)
System architecture, technical design, and technology selection
Developer (James)
Code implementation, debugging, and testing
QA Architect (Quinn)
Quality assurance, test strategy, and code review
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
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
Phase 1: Analysis
(Optional)
Optional workflows for project discovery and requirements gathering
Workflows Available
workflow-statusUniversal entry point - Always start here!
brainstorm-gameGame concept ideation
brainstorm-projectSoftware solution exploration
game-briefStructured game design foundation
product-briefStrategic product planning
researchMulti-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
Phase 3: Solutioning
(Level 3-4 Only)
Architecture and technical design for complex projects
Phase 4: Implementation
(Iterative Cycle)
The core development cycle with 4-state story progression
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
bmad analyst workflow-statusbmad pm plan-projectbmad architect solution-architecturebmad architect tech-spec # Per epic, JITbmad sm create-story # Draft storybmad sm story-ready # Approve for devbmad sm story-context # Generate contextbmad dev dev-story # Implementbmad dev story-approved # Mark doneBuild 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
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.
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
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
Involved Agents
Examples
- E-commerce platform
- Social media app
- Project management tool
Mobile App Development
iOS/Android applications with native features
Involved Agents
Examples
- Fitness tracker
- Food delivery app
- Social networking
API & Microservices
RESTful or GraphQL APIs for integration
Involved Agents
Examples
- Payment service
- Notification API
- Data analytics service
Database Design & Migration
Schema design and data migration strategies
Involved Agents
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
Troubleshooting & Support
Quick solutions to common problems and resources for getting help
Installation Issues
Agent not loading correctly
This usually happens when core configuration files are missing or corrupted.
Installation fails with permission errors
Permission issues often occur when npm/node installation is not properly configured.
Development Issues
Story has insufficient context
Stories need enough context for developers to implement successfully.
Tests failing during development
Test failures can indicate code quality issues or configuration problems.
Quality Assurance Issues
QA review fails repeatedly
Repeated QA failures suggest systematic issues in development approach.
Quality gates showing inconsistent results
Inconsistent quality gates may indicate configuration or process issues.
Web UI Issues
Agent not responding in ChatGPT/Claude
Web UI agents may not be properly configured or context may be lost.
File upload issues in web platforms
Some web platforms have restrictions on file uploads or processing.
🚨 Found a Critical Bug?
If you've encountered a critical issue that's blocking your work, please report it immediately