remove uneeded files

src/modules/bmb/workflows/create-agent/README.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The Build Agent workflow is an interactive agent builder that guides you through creating BMAD Core compliant agents with proper persona, activation rules, and command structure. It supports three agent types: Simple (self-contained), Expert (with sidecar resources), and Module (full-featured with workflows).
+The Build Agent workflow is an interactive agent builder that guides you through creating BMAD Core compliant agents as YAML source files that compile to final `.md` during install. It supports three agent types: Simple (self-contained), Expert (with sidecar resources), and Module (full-featured with workflows).
 
 ## Key Features
 
@@ -10,8 +10,8 @@ The Build Agent workflow is an interactive agent builder that guides you through
 - **Three Agent Types**: Simple, Expert, and Module agents with appropriate structures
 - **Persona Development**: Guided creation of role, identity, communication style, and principles
 - **Command Builder**: Interactive command definition with workflow/task/action patterns
-- **Validation Built-In**: Ensures XML structure and BMAD Core compliance
-- **Config File Support**: Optional agent config for persona overrides
+- **Validation Built-In**: Ensures YAML structure and BMAD Core compliance
+- **Customize Support**: Optional `customize.yaml` for persona/menu overrides and critical actions
 - **Sidecar Resources**: Setup for Expert agents with domain-specific data
 
 ## Usage
@@ -94,49 +94,47 @@ create-agent/
 
 ### Phase 4: Finalization (Steps 5-10)
 
-- Add custom activation rules (optional, rarely needed)
-- Generate complete agent.md file
-- Create agent config file (optional)
+- Confirm activation behavior (mostly automatic)
+- Generate `.agent.yaml` file
+- Optionally create a customize file for overrides
 - Setup sidecar resources (for Expert agents)
-- Validate agent structure
+- Validate YAML and compile to `.md`
 - Provide usage instructions
 
 ## Output
 
-### Generated Agent File
+### Generated Files
 
-Creates agent file at:
-`{output_folder}/agents/{{agent_filename}}.md`
+- YAML agent saved at:
+  `{output_folder}/agents/{{agent_filename}}.agent.yaml` (or `src/modules/{{target_module}}/agents/{{agent_filename}}.agent.yaml` if `src_impact=true`)
+- Compiled `.md` generated by installer at:
+  `{project-root}/bmad/{{module}}/agents/{{agent_filename}}.md`
 
-### Agent Structure
+### YAML Agent Structure (simplified)
 
-```xml
-<!-- Powered by BMAD-CORE™ -->
-
-# {{agent_title}}
-
-<agent id="bmad/{{module}}/agents/{{agent_filename}}.md"
-       name="{{agent_name}}"
-       title="{{agent_title}}"
-       icon="{{agent_icon}}">
-  <persona>
-    <role>...</role>
-    <identity>...</identity>
-    <communication_style>...</communication_style>
-    <principles>...</principles>
-  </persona>
-  <cmds>
-    <c cmd="*help">...</c>
-    <c cmd="*exit">...</c>
-    <!-- Additional commands -->
-  </cmds>
-</agent>
+```yaml
+agent:
+  metadata:
+    id: bmad/{{module}}/agents/{{agent_filename}}.md
+    name: { { agent_name } }
+    title: { { agent_title } }
+    icon: { { agent_icon } }
+    module: { { module } }
+  persona:
+    role: '...'
+    identity: '...'
+    communication_style: '...'
+    principles: ['...', '...']
+  menu:
+    - trigger: example
+      workflow: '{project-root}/path/to/workflow.yaml'
+      description: Do the thing
 ```
 
-### Optional Config File
+### Optional Customize File
 
 If created, generates at:
-`{project-root}/bmad/_cfg/agents/{{agent_config_name}}.md`
+`{project-root}/bmad/_cfg/agents/{{module}}-{{agent_filename}}.customize.yaml`
 
 ## Requirements
 
@@ -194,10 +192,10 @@ Users can go from **vague idea → brainstormed concept → built agent** in one
 
 ### After Completion
 
-1. Test the agent by loading it
-2. Verify all commands work as expected
+1. Compile agents: `npm run install:bmad` → "Compile Agents"
+2. Test the compiled `.md` agent in your IDE
 3. Implement any "todo" workflows
-4. Refine persona based on usage
+4. Refine persona based on usage or via customize file
 5. Add more commands as agent evolves
 
 ## Agent Types