Build More, Build better. Create custom BMad agents, workflows, and domain-specific modules with guided assistance.
BMad Builder (BMB) is a meta-module for BMad Method that helps you create your own agents and workflows. Whether you're building domain-specific expertise or automating repetitive development tasks, BMB guides you through:
- Agent Builder — Create specialized AI agents with custom expertise, communication styles, and tool access
- Workflow Builder — Design structured workflows with steps, menus, and cross-workflow communication
- Module Builder — Package agents and workflows into shareable BMad modules
BMad Builder is installed as a module during BMad Method setup:
npx bmad-method@alpha installSelect BMad Builder from the modules list.
After installing BMad Method with BMB, run from your project root:
/bmb-agent
This launches the Agent Builder workflow that guides you through creating a custom agent.
| Type | Description | Workflow |
|---|---|---|
| Agents | Domain experts with specialized knowledge and tools | /bmb-agent |
| Workflows | Structured processes with steps and decision points | /bmb-workflow |
| Modules | Packaged agents + workflows ready to share | /bmb-module |
You: /bmb-agent
BMB: What domain should this agent specialize in?
You: Blockchain Development
BMB: Great! A blockchain expert would need to know about...
[Guides you through agent configuration]
BMad modules follow a standard structure:
your-module/
├── src/
│ ├── module.yaml # Module metadata and install config
│ ├── agents/ # Agent definitions (.agent.yaml)
│ ├── workflows/ # Workflow files
│ └── tools/ # Small reusable tools
└── package.json # NPM package info
When your module is ready to share:
# Bump version and create git tag
npm run release
# Or manually:
git tag v1.0.0
git push origin v1.0.0See bmad-module-template for a starting point.
BMad Builder Documentation — Tutorials, how-to guides, and reference
- Getting Started
- BMad Method Docs — Core framework documentation
- Discord — Get help and share your creations
- GitHub Issues — Bug reports and feature requests
- Discussions — Community conversations
MIT License — see LICENSE for details.
BMad Builder — Part of the BMad Method ecosystem.
See CONTRIBUTORS.md for contributor information.
