# BMad Builder

[![Version](https://img.shields.io/npm/v/bmad-builder?color=blue&label=version)](https://www.npmjs.com/package/bmad-builder)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python Version](https://img.shields.io/badge/python-%3E%3D3.10-blue?logo=python&logoColor=white)](https://www.python.org)
[![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/)
[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)

**Build More, Architect Dreams... With the BMad Builder!**

## Create, Share, and Discover Modules

BMad Builder gives you the complete pipeline to create your own AI modules and share them with the world. Build agents with persistent memory, guided workflows, or full module ecosystems, then distribute them through the [BMad Marketplace](https://github.com/bmad-code-org/bmad-plugins-marketplace) or any compliant public marketplace.

The [Agent Skills open standard](https://agentskills.io/home) means your creations work across 40+ AI tools, not just one platform - but with the BMad Ecosystem they will also gain full integration.

| Guide | What It Covers |
| ----- | -------------- |
| **[Quick Start](https://bmad-builder-docs.bmad-method.org)** | Set up BMad Builder and build your first skill |
| **[Build Your First Module](https://bmad-builder-docs.bmad-method.org/tutorials/build-your-first-module/)** | Plan, build, scaffold, and validate a complete module |
| **[Distribute Your Module](https://bmad-builder-docs.bmad-method.org/how-to/distribute-your-module/)** | Package and share your module for anyone to install |

## The Dream

Imagine AI that truly knows you. A fitness coach that remembers every PR. A writing partner that knows your characters better than you do. A research assistant that learns your preferences.

BMad Builder lets you create:

- **Personal AI Companions**: Agents with memory that evolve with you over time
- **Domain Experts**: Specialists for any field: legal, medical, creative, technical
- **Workflow Automations**: Structured processes that guide you through complex tasks
- **Custom Modules**: Bundle agents and workflows into shareable packages that can empower any type of business or domain

## What Makes It Different

| Feature               | Why It Matters                                              |
| --------------------- | ----------------------------------------------------------- |
| **Persistent Memory** | Agents remember across sessions and keep improving          |
| **Composable**        | Your creations work alongside the entire BMad ecosystem     |
| **Skill-Compliant**   | Built on the open Agent Skills standard, works with 40+ AI tools |
| **Shareable**         | Distribute through the BMad Marketplace or any compliant marketplace |

## What You Can Build

| Domain           | Example                                                     |
| ---------------- | ----------------------------------------------------------- |
| **Personal**     | Journal companion, habit coach, learning tutor              |
| **Professional** | Code reviewer, documentation specialist, workflow automator |
| **Creative**     | Story architect, character developer, campaign designer     |
| **Any Domain**   | If you can describe it, you can build it                    |

## Learn More

**[Full Documentation](https://bmad-builder-docs.bmad-method.org)**: Concepts, design patterns, and reference for the complete builder toolkit.

## Community

- [Discord](https://discord.gg/gk8jAdXWmj) — Get help and share what you've built
- [YouTube](https://youtube.com/@BMadCode) — Tutorials, master class, and more
- [X / Twitter](https://x.com/BMadCode)
- [Website](https://bmadcode.com)

## Support BMad

BMad is free for everyone and always will be. Star this repo, [buy me a coffee](https://buymeacoffee.com/bmad), or email contact@bmadcode.com for corporate sponsorship.

## License

MIT. See [LICENSE](LICENSE) for details.

**BMad Builder**: Part of the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD) ecosystem.

[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/bmad-builder)](https://github.com/bmad-code-org/bmad-builder/graphs/contributors)

See [CONTRIBUTORS.md](CONTRIBUTORS.md) for contributor information.
