215 lines
9.1 KiB
Markdown
215 lines
9.1 KiB
Markdown
# BMad Method & BMad Core
|
||
|
||
[](https://www.npmjs.com/package/bmad-method)
|
||
[](https://www.npmjs.com/package/bmad-method)
|
||
[](LICENSE)
|
||
[](https://nodejs.org)
|
||
[](https://discord.gg/gk8jAdXWmj)
|
||
|
||
## 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 →](#whats-new-in-v6)
|
||
|
||
> **📌 v6 Alpha Status:** Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to [BMadCode YouTube](https://www.youtube.com/@BMadCode).
|
||
|
||
## 🎯 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** (**C**ollaboration **O**ptimized **R**eflection **E**ngine). 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
|
||
|
||
<p align="center">
|
||
<img src="./src/modules/bmm/docs/images/workflow-method-greenfield.svg" alt="BMad Method Workflow" width="100%">
|
||
</p>
|
||
|
||
<p align="center">
|
||
<em>Complete BMad Method workflow showing all phases, agents, and decision points</em>
|
||
</p>
|
||
|
||
## 🚀 Get Started in 3 Steps
|
||
|
||
### 1. Install BMad Method
|
||
|
||
```bash
|
||
# 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](./src/modules/bmm/docs/README.md)
|
||
|
||
- **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](./src/modules/bmb/README.md)
|
||
|
||
- **Creative Intelligence Suite (CIS)** - Innovation & problem-solving
|
||
- Brainstorming, design thinking, storytelling
|
||
- 5 creative facilitation workflows
|
||
- [→ Creative Workflows](./src/modules/cis/README.md)
|
||
|
||
### 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](./src/modules/bmm/docs/quick-start.md)** - 15-minute introduction
|
||
- **[Complete BMM Documentation](./src/modules/bmm/docs/README.md)** - All guides and references
|
||
- **[Agent Customization](./docs/agent-customization-guide.md)** - Personalize your agents
|
||
- **[All Documentation](./docs/index.md)** - Complete documentation index
|
||
|
||
### For v4 Users
|
||
|
||
- **[v4 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)**
|
||
- **[v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)**
|
||
|
||
## 💬 Community & Support
|
||
|
||
- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help, share projects
|
||
- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs, request features
|
||
- **[YouTube Channel](https://www.youtube.com/@BMadCode)** - Video tutorials and demos
|
||
- **[Web Bundles](https://bmad-code-org.github.io/bmad-bundles/)** - Pre-built agent bundles
|
||
|
||
## 🛠️ Development
|
||
|
||
For contributors working on the BMad codebase:
|
||
|
||
```bash
|
||
# 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](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](./docs/v4-to-v6-upgrade.md)** - Step-by-step migration
|
||
- **[v4 Documentation Archive](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)** - Legacy reference
|
||
- Backwards compatibility where possible
|
||
- Smooth migration path with installer detection
|
||
|
||
## 📄 License
|
||
|
||
MIT License - See [LICENSE](LICENSE) for details.
|
||
|
||
**Trademarks:** BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
|
||
|
||
---
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD" alt="Contributors">
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<sub>Built with ❤️ for the human-AI collaboration community</sub>
|
||
</p>
|