108 lines
5.8 KiB
Markdown
108 lines
5.8 KiB
Markdown
|
|
|
|
[](https://www.npmjs.com/package/bmad-method)
|
|
[](LICENSE)
|
|
[](https://nodejs.org)
|
|
[](https://discord.gg/gk8jAdXWmj)
|
|
|
|
**Build More, Architect Dreams** — An AI-driven agile development framework with 21 specialized agents, 50+ guided workflows, and scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.
|
|
|
|
**100% free and open source.** No paywalls. No gated content. No gated Discord. We believe in empowering everyone, not just those who can pay.
|
|
|
|
## Why BMad?
|
|
|
|
Traditional AI tools do the thinking for you, producing average results. BMad agents act as expert collaborators who guide you through structured workflows to bring out your best thinking.
|
|
|
|
- **Scale-Adaptive**: Automatically adjusts planning depth based on project complexity (Level 0-4)
|
|
- **Structured Workflows**: Grounded in agile best practices across analysis, planning, architecture, and implementation
|
|
- **Specialized Agents**: 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
|
|
- **Complete Lifecycle**: From brainstorming to deployment, with just-in-time documentation
|
|
|
|
## Quick Start
|
|
|
|
**Prerequisites**: [Node.js](https://nodejs.org) v20+
|
|
|
|
```bash
|
|
npx bmad-method@alpha install
|
|
```
|
|
|
|
Follow the installer prompts, then open your AI IDE (Claude Code, Cursor, Windsurf, etc.) in the project folder.
|
|
|
|
> **Not sure what to do?** Run `/bmad-help` — it tells you exactly what's next and what's optional. You can also ask it questions like `/bmad-help How should I build a web app for XYZ?`
|
|
|
|
### Simple Path (Quick Flow)
|
|
|
|
Bug fixes, small features, clear scope — 3 commands:
|
|
|
|
1. `/quick-spec` — analyzes your codebase and produces a tech-spec with stories
|
|
2. `/dev-story` — implements each story
|
|
3. `/code-review` — validates quality
|
|
|
|
### Full Planning Path (BMad Method)
|
|
|
|
Products, platforms, complex features — structured planning then build:
|
|
|
|
1. `/product-brief` — define problem, users, and MVP scope
|
|
2. `/create-prd` — full requirements with personas, metrics, and risks
|
|
3. `/create-architecture` — technical decisions and system design
|
|
4. `/create-epics-and-stories` — break work into prioritized stories
|
|
5. `/sprint-planning` — initialize sprint tracking
|
|
6. **Repeat per story:** `/create-story` → `/dev-story` → `/code-review`
|
|
|
|
Every step tells you what's next. Optional phases (brainstorming, research, UX design) are available when you need them — ask `/bmad-help` anytime.
|
|
|
|
## Modules
|
|
|
|
BMad Method extends with official modules for specialized domains. Modules are available during installation and can be added to your project at any time.
|
|
|
|
| Module | GitHub | NPM | Purpose |
|
|
|--------|--------|-----|---------|
|
|
| **BMad Method (BMM)** | [bmad-code-org/BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | [bmad-method](https://www.npmjs.com/package/bmad-method) | Core framework with 34+ workflows across 4 development phases |
|
|
| **BMad Builder (BMB)** | [bmad-code-org/bmad-builder](https://github.com/bmad-code-org/bmad-builder) | [bmad-builder](https://www.npmjs.com/package/bmad-builder) | Create custom BMad agents, workflows, and domain-specific modules |
|
|
| **Game Dev Studio (BMGD)** | [bmad-code-org/bmad-module-game-dev-studio](https://github.com/bmad-code-org/bmad-module-game-dev-studio) | [bmad-game-dev-studio](https://www.npmjs.com/package/bmad-game-dev-studio) | Game development workflows for Unity, Unreal, and Godot |
|
|
| **Creative Intelligence Suite (CIS)** | [bmad-code-org/bmad-module-creative-intelligence-suite](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite) | [bmad-creative-intelligence-suite](https://www.npmjs.com/package/bmad-creative-intelligence-suite) | Innovation, brainstorming, design thinking, and problem-solving |
|
|
|
|
## Documentation
|
|
|
|
**[Full Documentation](http://docs.bmad-method.org)** — Tutorials, how-to guides, concepts, and reference
|
|
|
|
- [Getting Started Tutorial](http://docs.bmad-method.org/tutorials/getting-started/getting-started-bmadv6/)
|
|
- [Upgrading from Previous Versions](http://docs.bmad-method.org/how-to/installation/upgrade-to-v6/)
|
|
|
|
### For v4 Users
|
|
|
|
- **[v4 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4/docs)**
|
|
|
|
## Community
|
|
|
|
- [Discord](https://discord.gg/gk8jAdXWmj) — Get help, share ideas, collaborate
|
|
- [YouTube](https://www.youtube.com/@BMadCode) — Tutorials, master class, and podcast (launching Feb 2025)
|
|
- [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) — Bug reports and feature requests
|
|
- [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) — Community conversations
|
|
|
|
## Support BMad
|
|
|
|
BMad is free for everyone — and always will be. If you'd like to support development:
|
|
|
|
- ⭐ [Star us on GitHub](https://github.com/bmad-code-org/BMAD-METHOD/) — Helps others discover BMad
|
|
- 📺 [Subscribe on YouTube](https://www.youtube.com/@BMadCode) — Master class launching Feb 2026
|
|
- ☕ [Buy Me a Coffee](https://buymeacoffee.com/bmad) — Fuel the development
|
|
- 🏢 Corporate sponsorship — DM on Discord
|
|
- 🎤 Speaking & Media — Available for conferences, podcasts, interviews (Discord)
|
|
|
|
## Contributing
|
|
|
|
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
|
|
## License
|
|
|
|
MIT License — see [LICENSE](LICENSE) for details.
|
|
|
|
---
|
|
|
|
**BMad** and **BMAD-METHOD** are trademarks of BMad Code, LLC. See [TRADEMARK.md](TRADEMARK.md) for details.
|
|
|
|
[](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
|
|
|
|
See [CONTRIBUTORS.md](CONTRIBUTORS.md) for contributor information.
|