2.6 KiB
create-agent Workflow Rule
This rule defines the create-agent workflow.
Workflow Description
Interactive workflow to build BMAD Core compliant agents (YAML source compiled to .md during install) with optional brainstorming, persona development, and command structure
Workflow Definition
Build Agent Workflow Configuration
name: create-agent description: "Interactive workflow to build BMAD Core compliant agents (YAML source compiled to .md during install) with optional brainstorming, persona development, and command structure" author: "BMad"
Critical variables load from config_source
config_source: "{project-root}/.bmad/bmb/config.yaml" custom_agent_location: "{config_source}:custom_agent_location" user_name: "{config_source}:user_name" communication_language: "{config_source}:communication_language"
Technical documentation for agent building
agent_compilation: "{project-root}/.bmad/bmb/docs/agent-compilation.md" understanding_agent_types: "{project-root}/.bmad/bmb/docs/understanding-agent-types.md" simple_agent_architecture: "{project-root}/.bmad/bmb/docs/simple-agent-architecture.md" expert_agent_architecture: "{project-root}/.bmad/bmb/docs/expert-agent-architecture.md" module_agent_architecture: "{project-root}/.bmad/bmb/docs/module-agent-architecture.md" agent_menu_patterns: "{project-root}/.bmad/bmb/docs/agent-menu-patterns.md" communication_presets: "{installed_path}/communication-presets.csv"
Reference examples
simple_agent_examples: "{project-root}/src/modules/bmb/reference/agents/simple-examples/" expert_agent_examples: "{project-root}/src/modules/bmb/reference/agents/expert-examples/" module_agent_examples: "{project-root}/src/modules/bmb/reference/agents/module-examples/"
Module path and component files
installed_path: "{project-root}/.bmad/bmb/workflows/create-agent" template: false # This is an interactive workflow - no template needed instructions: "{installed_path}/instructions.md" validation: "{installed_path}/agent-validation-checklist.md"
Output configuration - YAML agents compiled to .md at install time
Module agents: Save to .bmad/{{target_module}}/agents/
Standalone agents: Save to custom_agent_location/
module_output_file: "{project-root}/.bmad/{{target_module}}/agents/{{agent_filename}}.agent.yaml" standalone_output_file: "{custom_agent_location}/{{agent_filename}}.agent.yaml"
Optional user override file (auto-created by installer if missing)
config_output_file: "{project-root}/.bmad/_cfg/agents/{{target_module}}-{{agent_filename}}.customize.yaml"
standalone: true
Usage
Reference this workflow with @workflow-create-agent to execute the guided workflow.
Module
Part of the BMAD BMB module.