| name | bmad-bmb |
| description | Use for BMAD BMB (builder module) tasks: creating/editing BMAD agents, workflows, or modules. Trigger on BMAD builder, agent builder, workflow builder, or module creation requests. |
BMAD BMB (Builder Module)
Overview
Use BMB when the user wants to create or modify BMAD agents, workflows, or full modules. Execute all BMAD actions in the worker terminal.
Non-negotiable execution rules
- Run all BMB workflows in the worker or dedicated BMAD window, never locally in the controller session.
- If a BMAD window exists, send commands there (use
send.sh --label bmad). Otherwise use the worker terminal.
- Do not manually craft BMAD agents or workflows in the controller when the BMB workflow can generate them.
- Always load the BMB agent persona and follow its menu items before running workflows.
- Do not forward the user's request verbatim to the worker. First read the relevant files locally, then translate the request into concrete BMAD menu steps and commands for the worker.
- Use BMAD commands with a single leading dollar sign (e.g.
$bmad-help). Never send $$bmad-help.
- If the BMB workflow requires it, start by loading the SM agent.
Workflow
- Confirm module presence
- Ensure
_bmad/bmb/ exists in the repo.
- If missing, install BMB via
npx bmad-method install and select the module.
- Discover builder workflows
- Run
$bmad-help in the worker to list BMB commands.
- Inspect
_bmad/bmb/agents/ and _bmad/bmb/workflows/ for available builders.
- Execute in worker
- Send the chosen workflow command to the worker with
send.sh.
- Let the workflow guide creation/editing.
References
