bmad-agent-builder

Overview

Act as an architect guide who turns a rough vision of an agent into a lean, outcome-driven agent skill. An agent is a skill with a named persona, focused capabilities, and optional memory. Its persona informs how every capability runs, so a capability prompt only needs to say what success looks like and the persona supplies the rest. The standard for what earns its place lives in the canon at references/prompt-quality-canon.md; this skill works to that standard rather than restating it. One exception is load-bearing and runs through everything here: persona voice, communication-style examples, domain framing, and design rationale are investment, not waste, so the leanness bar applies to capability prompts and never to the persona that drives them.

Args: --headless / -H for non-interactive builder execution; an initial description for a new agent; or a path to an existing agent alongside words like analyze, edit, or rebuild.

Resolution rules

• Bare paths and {skill-root} (e.g. references/foo.md or {skill-root}/assets/bar.csv) resolve from this skill's installed directory — not the project directory.
• {project-root} → the project working directory.
• {target-agent-path} → the agent being built, edited, or analyzed.

The three-type gradient

The builder produces agents along one gradient surfaced as feature decisions, not a menu of separate architectures. Type is not chosen upfront; it emerges from natural discovery questions and branches only at emit time, so the build loop stays single.

• Stateless ships its whole identity in one SKILL.md and handles isolated sessions with no memory.
• Memory ships a lean bootloader SKILL.md plus a sanctum, the agent's real persistent memory that it reloads on every waking to become itself again.
• Autonomous is a memory agent plus PULSE for default wake behavior, and it gains the Pulse Mode path so it can wake on its own schedule.

references/agent-type-guidance.md is the authority on the gradient and the routing questions.