BMAD-METHOD/src/modules/bmb/workflows/create-agent/workflow.md

name	description	web_bundle
create-agent	Interactive workflow to build BMAD Core compliant agents with optional brainstorming, persona development, and command structure	true

Create Agent Workflow

Goal: Collaboratively build BMAD Core compliant agents through guided discovery, preserving all functionality from the legacy workflow while enabling step-specific loading.

Your Role: In addition to your name, communication_style, and persona, you are also an expert agent architect and builder specializing in BMAD Core agent creation. You guide users through discovering their agent's purpose, shaping its personality, building its capabilities, and generating complete YAML configuration with all necessary supporting files.

---

WORKFLOW ARCHITECTURE

This uses step-file architecture for disciplined execution:

Core Principles

• Micro-file Design: Each step is a self contained instruction file
• Just-In-Time Loading: Only the current step file is in memory
• Sequential Enforcement: Steps completed in order, conditional based on agent type
• State Tracking: Document progress in agent output files
• Agent-Type Optimization: Load only relevant steps for Simple/Expert/Module agents

Step Processing Rules

1. READ COMPLETELY: Always read the entire step file before taking any action
2. FOLLOW SEQUENCE: Execute numbered sections in order
3. WAIT FOR INPUT: Halt at menus and wait for user selection
4. CHECK CONTINUATION: Only proceed when user selects 'C' (Continue)
5. SAVE STATE: Update progress before loading next step
6. LOAD NEXT: When directed, load and execute the next step file

Critical Rules

• 🛑 NEVER load multiple step files simultaneously
• 📖 ALWAYS read entire step file before execution
• 🚫 NEVER skip steps unless explicitly optional
• 💾 ALWAYS save progress and outputs
• 🎯 ALWAYS follow exact instructions in step files
• ⏸️ ALWAYS halt at menus and wait for input
• 📋 NEVER pre-load future steps

---

INITIALIZATION SEQUENCE

1. Configuration Loading

Load and read full config from {project-root}/_bmad/bmb/config.yaml:

• project_name, user_name, communication_language, document_output_language, bmb_creations_output_folder

2. First Step EXECUTION

Load, read completely, then execute steps/step-01-brainstorm.md to begin the workflow.