Skip to content

Commit 03e73e8

Browse files
Brian MadisonBrian Madison
Brian Madison
authored and
Brian Madison
committed
Docs: Add comprehensive bmad-builder documentation with visionary enhancements
- Tutorials: Create Your First Workflow, Create Your First Module (with "Why Build Modules?" examples) - How-to guides: Discover Your Module Idea, Edit Agents and Workflows, Validate Agents and Workflows - Reference: Builder Commands, Agent Schema, Workflow Schema, Module YAML - Explanation: Bond-Wendy-Morgan, Module Ecosystem Vision - Enhanced with 16+ domain examples showing BMad is for ANYTHING
1 parent 4459c1c commit 03e73e8

16 files changed

Lines changed: 2532 additions & 27 deletions

‎docs/explanation/bond-wendy-morgan.md‎

Lines changed: 174 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,174 @@
1+
---
2+
title: "Bond, Wendy, and Morgan: Which Builder to Use"
3+
description: Understanding the three BMad Builder agents and when to use each
4+
---
5+
6+
BMad Builder has three specialized agents, each focused on a different type of creation. This guide explains when to use each builder.
7+
8+
## The Three Builders
9+
10+
| Builder | Creates | Expertise |
11+
|---------|---------|-----------|
12+
| **Bond** | Agents | Agent architecture and persona development |
13+
| **Wendy** | Workflows | Process design and step architecture |
14+
| **Morgan** | Modules | Full-stack systems design |
15+
16+
## Bond — Agent Builder
17+
18+
**Bond** specializes in creating AI agents with defined personalities, communication styles, and capabilities.
19+
20+
### When to Use Bond
21+
22+
Use Bond when you want to:
23+
24+
- Create a domain expert (security architect, documentation lead)
25+
- Build a focused assistant (commit generator, code reviewer)
26+
- Design an agent with persistent memory (expert agents)
27+
- Define custom menu commands for an agent
28+
29+
### Bond's Commands
30+
31+
| Command | Purpose |
32+
|---------|---------|
33+
| `[CA]` create-agent | Create a new agent |
34+
| `[EA]` edit-agent | Modify an existing agent |
35+
| `[VA]` validate-agent | Check agent compliance |
36+
37+
### Example Use Cases
38+
39+
| Domain | Agent Concept | What It Does |
40+
|--------|---------------|--------------|
41+
| Software | Code Review Agent | Reviews changes, suggests improvements, tracks technical debt |
42+
| Personal Growth | Personal Therapist Agent | Remembers your sessions, goals, dreams — provides continuity like no human therapist can |
43+
| Legal | Contract Specialist Agent | Analyzes agreements, flags risks, suggests language |
44+
| Creative | Character Development Agent | Helps build rich, believable characters for stories |
45+
| Finance | Investment Analyst Agent | Researches opportunities, tracks portfolio, explains trade-offs |
46+
47+
## Wendy — Workflow Builder
48+
49+
**Wendy** specializes in designing structured processes that guide users through tasks sequentially.
50+
51+
### When to Use Wendy
52+
53+
Use Wendy when you want to:
54+
55+
- Automate a multi-step process
56+
- Create a guided decision flow
57+
- Design a repeatable workflow
58+
- Convert existing processes to BMad format
59+
60+
### Wendy's Commands
61+
62+
| Command | Purpose |
63+
|---------|---------|
64+
| `[CW]` create-workflow | Create a new workflow |
65+
| `[EW]` edit-workflow | Modify an existing workflow |
66+
| `[VW]` validate-workflow | Check workflow compliance |
67+
| `[MV]` validate-max-parallel-workflow | Hyper-optimized parallel validation for high-capability LLMs |
68+
| `[RW]` convert-or-rework-workflow | Convert legacy workflows |
69+
70+
### Example Use Cases
71+
72+
| Domain | Workflow Concept | What It Does |
73+
|--------|-----------------|--------------|
74+
| Productivity | Daily Planning Workflow | Structured morning routine: priorities, time blocks, energy matching |
75+
| Legal | Tax Preparation Workflow | Step-by-step document gathering, deduction hunting, audit-proof filing |
76+
| Writing | Novel Drafting Workflow | From idea to outline to chapter-by-chapter completion |
77+
| Education | Study Session Workflow | Concept review, active recall, spaced repetition scheduling |
78+
| Health | Workout Planning Workflow | Goal assessment, exercise selection, progression tracking |
79+
80+
## Morgan — Module Builder
81+
82+
**Morgan** specializes in creating complete modules that package agents, workflows, and configuration into shareable units.
83+
84+
### When to Use Morgan
85+
86+
Use Morgan when you want to:
87+
88+
- Package multiple agents together
89+
- Create a shareable module for your team
90+
- Distribute your work via npm
91+
- Build a comprehensive solution
92+
93+
### Morgan's Commands
94+
95+
| Command | Purpose |
96+
|---------|---------|
97+
| `[PB]` product-brief | Create a module brief |
98+
| `[CM]` create-module | Build a module from a brief |
99+
| `[EM]` edit-module | Modify an existing module |
100+
| `[VM]` validate-module | Check module compliance |
101+
102+
### Example Use Cases
103+
104+
| Domain | Module Concept | What It Includes |
105+
|--------|---------------|------------------|
106+
| **Personal Growth** | Therapist Module | Session recorder agent, goal-tracking workflow, reflection prompts |
107+
| **Legal** | Legal Office Module | Document drafter agents, case research workflows, client intake system |
108+
| **Creative Writing** | Story Architect Module | Character developer, plot outliner, dialogue coach, scene builder |
109+
| **Finance** | Tax Pro Module | Deduction hunter workflow, document organizer, audit-proof reviewer |
110+
| **Education** | Personal Tutor Module | Learning style assessment, progress tracker, explanation generator |
111+
| **Health** | Fitness Coach Module | Workout planner, nutrition tracker, progress analyzer, habit builder |
112+
| **Business** | Marketing Suite Module | Campaign planner, content generator, analytics interpreter, A/B tester |
113+
114+
:::tip[The Marketplace Is Coming]
115+
Soon you'll be able to publish your modules to the BMad marketplace. Build something that solves a real problem — others probably need it too.
116+
:::
117+
118+
## Choosing the Right Builder
119+
120+
### Quick Decision Guide
121+
122+
**What do you want to create?**
123+
124+
| Goal | Use | Builder |
125+
|------|-----|---------|
126+
| An AI assistant with a personality | → | **Bond** |
127+
| A step-by-step process | → | **Wendy** |
128+
| A package of agents and workflows | → | **Morgan** |
129+
130+
### Combined Workflows
131+
132+
Many projects use all three builders in sequence:
133+
134+
1. **Bond** creates the agents
135+
2. **Wendy** creates the workflows
136+
3. **Morgan** packages everything into a module
137+
138+
```
139+
Your Project/
140+
├── agents/ ← Created by Bond
141+
│ └── expert.agent.yaml
142+
├── workflows/ ← Created by Wendy
143+
│ └── workflow.md
144+
└── module.yaml ← Created by Morgan
145+
```
146+
147+
## Builder Personalities
148+
149+
Each builder has a distinct personality that reflects their expertise:
150+
151+
| Builder | Personality Style |
152+
|---------|-------------------|
153+
| **Bond** | Precise and technical, like a senior software architect |
154+
| **Wendy** | Methodical and process-oriented, like a systems engineer |
155+
| **Morgan** | Strategic and holistic, like a systems architect |
156+
157+
Their communication styles are optimized for their domain:
158+
- Bond focuses on **structure, compliance, and maintainability**
159+
- Wendy focuses on **flow, efficiency, and error handling**
160+
- Morgan focuses on **modularity, reusability, and system-wide impact**
161+
162+
## Getting Started
163+
164+
Start with the builder that matches your goal:
165+
166+
- **[Create a Custom Agent](../tutorials/create-custom-agent.md)** — Work with Bond
167+
- **[Create Your First Workflow](../tutorials/create-your-first-workflow.md)** — Work with Wendy
168+
- **[Create Your First Module](../tutorials/create-your-first-module.md)** — Work with Morgan
169+
170+
## See Also
171+
172+
- **[Builder Commands Reference](../reference/builder-commands.md)** — All builder commands
173+
- **[What Are Agents](what-are-bmad-agents.md)** — Understanding agents
174+
- **[What Are Workflows](what-are-workflows.md)** — Understanding workflows

‎docs/explanation/index.md‎

Lines changed: 27 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -9,26 +9,36 @@ Create custom agents, workflows, and modules for BMad. This ranges from simple p
99

1010
| Resource | Description |
1111
|----------|-------------|
12-
| **[Agent Creation Guide](/docs/tutorials/advanced/create-custom-agent.md)** | Step-by-step guide to building your first agent |
13-
| **[Install Custom Modules](/docs/how-to/installation/install-custom-modules.md)** | Installing standalone simple and expert agents |
12+
| **[Create a Custom Agent](../tutorials/create-custom-agent.md)** | Build your first AI agent |
13+
| **[Create Your First Workflow](../tutorials/create-your-first-workflow.md)** | Design structured workflows |
14+
| **[Create Your First Module](../tutorials/create-your-first-module.md)** | Package and publish modules |
1415

15-
## Agent Architecture
16+
## The Three Builders
1617

17-
| Type | Description |
18-
|------|-------------|
19-
| **Simple Agent** | Self-contained, personality-driven |
20-
| **Expert Agent** | Memory, sidecar files, domain restrictions |
21-
| **Module Agent** | Workflow integration, professional tools |
18+
| Builder | Creates | Description |
19+
|---------|---------|-------------|
20+
| **[Bond](bond-wendy-morgan.md)** | Agents | Agent architecture and persona development |
21+
| **[Wendy](bond-wendy-morgan.md)** | Workflows | Process design and step architecture |
22+
| **[Morgan](bond-wendy-morgan.md)** | Modules | Full-stack systems design |
2223

23-
## Key Concepts
24+
## Core Concepts
2425

25-
Agents are authored in YAML with templates and standards. The compiler upon install of your agent will auto-inject:
26+
| Topic | Description |
27+
|-------|-------------|
28+
| **[What Are Agents](what-are-bmad-agents.md)** | AI personas with specialized capabilities |
29+
| **[What Are Workflows](what-are-workflows.md)** | Structured step-by-step processes |
30+
| **[What Are Modules](what-are-modules.md)** | Bundles of agents and workflows |
31+
| **[Custom Content Types](custom-content-types.md)** | Content categories in BMad |
2632

27-
1. **Frontmatter**: Name and description from metadata
28-
2. **Activation Block**: Steps, menu handlers, rules
29-
3. **Menu Enhancement**: `*help` and `*exit` commands added automatically
30-
4. **Trigger Prefixing**: Your triggers auto-prefixed with `*`
33+
## Ecosystem Vision
3134

32-
:::note[Learn More]
33-
See [Custom Content Types](./custom-content-types.md) for detailed explanations of all content categories.
34-
:::
35+
| Topic | Description |
36+
|-------|-------------|
37+
| **[The Module Ecosystem Vision](module-ecosystem-vision.md)** | How BMad modules create a shared ecosystem of capabilities across every domain |
38+
39+
## Advanced Topics
40+
41+
| Topic | Description |
42+
|-------|-------------|
43+
| **[Facilitation vs Generation](facilitation-over-generation.md)** | Workflow design philosophy |
44+
| **[Customize Workflows](customize-workflows.md)** | Adapting workflows to your needs |

0 commit comments

Comments
 (0)