Welcome to BMad

BMad (Build More, Architect Dreams) is an AI-driven development framework that helps you build software faster and smarter. It provides specialized AI agents, guided workflows, and intelligent planning that adapts to your project’s complexity—whether you’re fixing a bug or building an enterprise platform.

If you’re comfortable working with AI coding assistants like Claude, Cursor, or GitHub Copilot, you’re ready to get started.

---

New Here? Start with a Tutorial

The fastest way to understand BMad is to try it. Choose a tutorial to walk through your first project in about 10 minutes.

• Get Started with v4 (Stable) — Production-ready version with battle-tested workflows
• Try v6 (Alpha) — Latest features, still in active development

Already familiar with AI-assisted development?

Feel free to skip around. Use the sidebar to jump to any topic, or check out What Are Agents? to understand how BMad organizes its AI personas.

---

How to Use These Docs

These docs are organized into four sections based on what you’re trying to do:

Section	Purpose
Tutorials	Learning-oriented. Step-by-step guides that walk you through building something. Start here if you’re new.
How-To Guides	Task-oriented. Practical guides for solving specific problems. “How do I customize an agent?” lives here.
Explanation	Understanding-oriented. Deep dives into concepts and architecture. Read when you want to know why.
Reference	Information-oriented. Technical specifications for agents, workflows, and configuration.

---

What You’ll Need

BMad works with any AI coding assistant that supports custom system prompts or project context. Popular options include:

• Claude Code — Anthropic’s CLI tool (recommended)
• Cursor — AI-first code editor
• Windsurf — Codeium’s AI IDE
• Roo Code — VS Code extension

You should be comfortable with basic software development concepts like version control, project structure, and agile workflows. No prior experience with BMad-style agent systems is required—that’s what these docs are for.

---

Join the Community

Get help, share what you’re building, or contribute to BMad:

• Discord — Chat with other BMad users, ask questions, share ideas
• GitHub — Source code, issues, and contributions
• YouTube — Video tutorials and walkthroughs

---

Next Step

Ready to dive in? Pick a tutorial and start building.

• Get Started with v4 (Stable) — Recommended for production projects
• Try v6 (Alpha) — Explore the latest features