108 lines
4.2 KiB
Markdown
108 lines
4.2 KiB
Markdown
---
|
|
slug: /
|
|
sidebar_position: 1
|
|
title: Welcome to BMad
|
|
---
|
|
|
|
# Welcome to BMad
|
|
|
|
BMad (**B**uild **M**ore, **A**rchitect **D**reams) 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.
|
|
|
|
<a className="button button--primary button--lg margin-right--md" href="/docs/tutorials/getting-started/getting-started-bmadv4">Get Started with v4 (Stable)</a>
|
|
<a className="button button--secondary button--lg" href="/docs/tutorials/getting-started/getting-started-bmadv6">Try v6 (Alpha)</a>
|
|
|
|
<br/>
|
|
|
|
:::tip 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?](./explanation/core-concepts/what-are-agents.md) 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:
|
|
|
|
<div className="row">
|
|
<div className="col col--6 margin-bottom--lg">
|
|
<div className="card">
|
|
<div className="card__header">
|
|
<h3>Tutorials</h3>
|
|
</div>
|
|
<div className="card__body">
|
|
<p><strong>Learning-oriented.</strong> Step-by-step guides that walk you through building something. Start here if you're new to BMad.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div className="col col--6 margin-bottom--lg">
|
|
<div className="card">
|
|
<div className="card__header">
|
|
<h3>How-To Guides</h3>
|
|
</div>
|
|
<div className="card__body">
|
|
<p><strong>Task-oriented.</strong> Practical guides for solving specific problems. "How do I customize an agent?" lives here.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div className="col col--6 margin-bottom--lg">
|
|
<div className="card">
|
|
<div className="card__header">
|
|
<h3>Explanation</h3>
|
|
</div>
|
|
<div className="card__body">
|
|
<p><strong>Understanding-oriented.</strong> Deep dives into concepts and architecture. Read these when you want to know <em>why</em> something works.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div className="col col--6 margin-bottom--lg">
|
|
<div className="card">
|
|
<div className="card__header">
|
|
<h3>Reference</h3>
|
|
</div>
|
|
<div className="card__body">
|
|
<p><strong>Information-oriented.</strong> Technical specifications for agents, workflows, and configuration. Look things up here.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
---
|
|
|
|
## What You'll Need
|
|
|
|
BMad works with any AI coding assistant that supports custom system prompts or project context. Popular options include:
|
|
|
|
- **[Claude Code](https://claude.ai/claude-code)** — Anthropic's CLI tool (recommended)
|
|
- **[Cursor](https://cursor.sh)** — AI-first code editor
|
|
- **[Windsurf](https://codeium.com/windsurf)** — Codeium's AI IDE
|
|
- **[Roo Code](https://roocode.com)** — 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](https://discord.gg/gk8jAdXWmj)** — Chat with other BMad users, ask questions, share ideas
|
|
- **[GitHub](https://github.com/bmad-code-org/BMAD-METHOD)** — Source code, issues, and contributions
|
|
- **[YouTube](https://www.youtube.com/@BMadCode)** — Video tutorials and walkthroughs
|
|
|
|
---
|
|
|
|
## Next Step
|
|
|
|
Ready to dive in? Pick a tutorial and start building.
|
|
|
|
<a className="button button--primary button--lg margin-right--md" href="/docs/tutorials/getting-started/getting-started-bmadv4">Get Started with v4 (Stable)</a>
|
|
<a className="button button--secondary button--lg" href="/docs/tutorials/getting-started/getting-started-bmadv6">Try v6 (Alpha)</a>
|