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 installand select the module.
- Discover builder workflows
- Run
$bmad-helpin 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
references/locators.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.