BMad Method & BMad Core

AI-Driven Agile Development That Scales From Bug Fixes to Enterprise

Build More, Architect Dreams (BMAD) with 19 specialized AI agents and 50+ guided workflows that adapt to your project's complexity—from quick bug fixes to enterprise platforms.

🚀 v6 is a MASSIVE upgrade from v4! Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. See what's new →

📌 v6 Alpha Status: Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to BMadCode YouTube.

🎯 Why BMad Method?

Unlike generic AI coding assistants, BMad Method provides structured, battle-tested workflows powered by specialized agents who understand agile development. Each agent has deep domain expertise—from product management to architecture to testing—working together seamlessly.

✨ Key Benefits:

• Scale-Adaptive Intelligence - Automatically adjusts planning depth from bug fixes to enterprise systems
• Complete Development Lifecycle - Analysis → Planning → Architecture → Implementation
• Specialized Expertise - 19 agents with specific roles (PM, Architect, Developer, UX Designer, etc.)
• Proven Methodologies - Built on agile best practices with AI amplification
• IDE Integration - Works with Claude Code, Cursor, Windsurf, VS Code

🏗️ The Power of BMad Core

BMad Method is actually a sophisticated module built on top of BMad Core (Collaboration Optimized Reflection Engine). This revolutionary architecture means:

• BMad Core provides the universal framework for human-AI collaboration
• BMad Method leverages Core to deliver agile development workflows
• BMad Builder lets YOU create custom modules as powerful as BMad Method itself

With BMad Builder, you can architect both simple agents and vastly complex domain-specific modules (legal, medical, finance, education, creative) that will soon be sharable in an official community marketplace. Imagine building and sharing your own specialized AI team!

📊 See It In Action

Complete BMad Method workflow showing all phases, agents, and decision points

🚀 Get Started in 3 Steps

1. Install BMad Method

# Install v6 Alpha (recommended)
npx bmad-method@alpha install

# Or stable v4 for production
npx bmad-method install

2. Initialize Your Project

Load any agent in your IDE and run:

*workflow-init

This analyzes your project and recommends the right workflow track.

3. Choose Your Track

BMad Method adapts to your needs with three intelligent tracks:

Track	Use For	Planning	Time to Start
⚡ Quick Flow	Bug fixes, small features	Tech spec only	< 5 minutes
📋 BMad Method	Products, platforms	PRD + Architecture + UX	< 15 minutes
🏢 Enterprise	Compliance, scale	Full governance suite	< 30 minutes

Not sure? Run *workflow-init and let BMad analyze your project goal.

🔄 How It Works: 4-Phase Methodology

BMad Method guides you through a proven development lifecycle:

1. 📊 Analysis (Optional) - Brainstorm, research, and explore solutions
2. 📝 Planning - Create PRDs, tech specs, or game design documents
3. 🏗️ Solutioning - Design architecture, UX, and technical approach
4. ⚡ Implementation - Story-driven development with continuous validation

Each phase has specialized workflows and agents working together to deliver exceptional results.

🤖 Meet Your Team

12 Specialized Agents working in concert:

Development	Architecture	Product	Leadership
Developer	Architect	PM	Scrum Master
UX Designer	Test Architect	Analyst	BMad Master
Tech Writer	Game Architect	Game Designer	Game Developer

Test Architect integrates with @seontechnologies/playwright-utils for production-ready fixture-based utilities.

Each agent brings deep expertise and can be customized to match your team's style.

📦 What's Included

Core Modules

• BMad Method (BMM) - Complete agile development framework

  • 12 specialized agents
  • 34 workflows across 4 phases
  • Scale-adaptive planning
  • → Documentation Hub

• BMad Builder (BMB) - Create custom agents and workflows

  • Build anything from simple agents to complex modules
  • Create domain-specific solutions (legal, medical, finance, education)
  • Share your creations in the upcoming community marketplace
  • → Builder Guide

• Creative Intelligence Suite (CIS) - Innovation & problem-solving

  • Brainstorming, design thinking, storytelling
  • 5 creative facilitation workflows
  • → Creative Workflows

Key Features

• 🎨 Customizable Agents - Modify personalities, expertise, and communication styles
• 🌐 Multi-Language Support - Separate settings for communication and code output
• 📄 Document Sharding - 90% token savings for large projects
• 🔄 Update-Safe - Your customizations persist through updates
• 🚀 Web Bundles - Use in ChatGPT, Claude Projects, or Gemini Gems

📚 Documentation

Quick Links

• Quick Start Guide - 15-minute introduction
• Complete BMM Documentation - All guides and references
• Agent Customization - Personalize your agents
• All Documentation - Complete documentation index

For v4 Users

• v4 Documentation
• v4 to v6 Upgrade Guide

💬 Community & Support

• Discord Community - Get help, share projects
• GitHub Issues - Report bugs, request features
• YouTube Channel - Video tutorials and demos
• Web Bundles - Pre-built agent bundles

🛠️ Development

For contributors working on the BMad codebase:

# Run all quality checks
npm test

# Development commands
npm run lint:fix      # Fix code style
npm run format:fix    # Auto-format code
npm run bundle        # Build web bundles

See CONTRIBUTING.md for full development guidelines.

What's New in v6

v6 represents a complete architectural revolution from v4:

🚀 Major Upgrades

• BMad Core Framework - Modular architecture enabling custom domain solutions
• Scale-Adaptive Intelligence - Automatic adjustment from bug fixes to enterprise
• Visual Workflows - Beautiful SVG diagrams showing complete methodology
• BMad Builder Module - Create and share your own AI agent teams
• 50+ Workflows - Up from 20 in v4, covering every development scenario
• 19 Specialized Agents - Enhanced with customizable personalities and expertise
• Update-Safe Customization - Your configs persist through all updates
• Web Bundles - Use agents in ChatGPT, Claude, and Gemini
• Multi-Language Support - Separate settings for communication and code
• Document Sharding - 90% token savings for large projects

🔄 For v4 Users

• Comprehensive Upgrade Guide - Step-by-step migration
• v4 Documentation Archive - Legacy reference
• Backwards compatibility where possible
• Smooth migration path with installer detection

📄 License

MIT License - See LICENSE for details.

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

---

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