Skip to content
🤖 AI-optimized docs: llms-full.txt

Builder Commands Reference

Quick reference for all builder commands.

AgentNamePurpose
agent-builderBondCreate, edit, and validate agents
workflow-builderWendyCreate, edit, and validate workflows
module-builderMorganCreate, edit, and validate modules
CommandTriggerDescription
Create Agent[CA] or create-agentCreate a new BMad agent with guided assistance
Edit Agent[EA] or edit-agentEdit an existing agent while maintaining compliance
Validate Agent[VA] or validate-agentCheck an agent for BMad compliance and best practices

Creates a new agent through a guided workflow.

Workflow Steps:

  1. Brainstorm (optional) — Explore ideas
  2. Discovery — Define agent’s purpose
  3. Type & Metadata — Choose Simple/Expert/Module, name agent
  4. Persona — Craft personality and principles
  5. Commands — Define menu commands
  6. Activation — Set up autonomous behaviors (optional)
  7. Build — Generate agent file
  8. Validation — Review and verify

Outputs:

  • Agent .agent.yaml file
  • Optional _memory/ folder for Expert agents

Edits an existing agent.

Workflow Steps:

  1. Load existing agent
  2. Discover changes needed
  3. Select elements to modify
  4. Apply changes
  5. Celebrate completion

What You Can Edit:

  • Persona (role, identity, communication style, principles)
  • Menu commands
  • Critical actions
  • Metadata
  • Sidecar files

Validates an agent against BMad standards.

Checks:

  • Metadata completeness
  • Persona structure
  • Menu formatting
  • YAML validity
  • BMad Core compliance
CommandTriggerDescription
Create Workflow[CW] or create-workflowCreate a new workflow with proper structure
Edit Workflow[EW] or edit-workflowEdit an existing workflow
Validate Workflow[VW] or validate-workflowValidate workflow structure and compliance
Validate Max-Parallel[MV] or validate-max-parallel-workflowValidate for parallel sub-process execution
Rework Workflow[RW] or convert-or-rework-workflowConvert or rework to V6 compliant format

Creates a new workflow.

Options:

  • From Scratch — Start with guided discovery
  • Convert Existing — Convert existing workflow to BMad format

Workflow Steps:

  1. Discovery — Understand your idea
  2. Classification — Type, structure, output
  3. Requirements — Inputs, tools, validation
  4. Design — Step sequence
  5. Foundation — Create workflow.md
  6. Build Steps — Create step files
  7. Completion — Final review

Edits an existing workflow.

Workflow Steps:

  1. Assess workflow
  2. Discover edits needed
  3. Select mode (direct/placeholder)
  4. Apply edits
  5. Validate after changes
  6. Complete

Validates a workflow.

Checks:

  • Frontmatter completeness
  • Step structure
  • Menu handling
  • Output format
  • Cohesiveness

Hyper-optimized workflow validation for LLMs with high parallel processing capability (like Claude). Uses task agents to validate multiple workflow aspects simultaneously in sub-processes for dramatically faster results.

Additional Checks:

  • Parallel compatibility
  • Sub-process optimization
  • Task agent orchestration
  • LLM parallel capability utilization

Converts or reworks workflows to V6 format.

Use For:

  • Updating legacy workflows
  • Fixing compliance issues
  • Converting from other formats
CommandTriggerDescription
Product Brief[PB] or product-briefCreate a module brief through creative discovery
Create Module[CM] or create-moduleCreate a complete module from a brief
Edit Module[EM] or edit-moduleEdit an existing module
Validate Module[VM] or validate-moduleValidate module structure and compliance

Creates a module brief.

Workflow Steps:

  1. Welcome and spark ideas
  2. Define module type
  3. Clarify vision
  4. Identify users
  5. Define value proposition
  6. Plan agents
  7. Plan workflows
  8. Plan tools
  9. Explore scenarios
  10. Review and finalize

Output: module-brief-{code}.md file

Creates a module from a brief.

Input: Path to module brief file

Creates:

  • Module directory structure
  • module.yaml with configuration
  • Agent and workflow spec files
  • README.md and TODO.md

Edits an existing module.

Can Edit:

  • module.yaml configuration
  • Install questions
  • Module metadata
  • Configuration values

Validates a module.

Checks:

  • module.yaml validity
  • module-help.csv format (if present)
  • Folder structure
  • Agent file compliance
  • Workflow file compliance
TaskAgentCommand
Create agentBond[CA]
Create workflowWendy[CW]
Create module briefMorgan[PB]
Create moduleMorgan[CM]
Edit agentBond[EA]
Edit workflowWendy[EW]
Edit moduleMorgan[EM]
Validate agentBond[VA]
Validate workflowWendy[VW]
Validate moduleMorgan[VM]
Rework workflowWendy[RW]
ResourceDescription
Agent SchemaAgent YAML structure
Workflow SchemaWorkflow frontmatter and structure
Module YAMLModule configuration