feat: implement reel improvements (clean text, deletion, mobile TTS)

_bmad/bmb/workflows/agent/steps-v/v-02a-validate-metadata.md

@@ -5,18 +5,20 @@ description: 'Validate metadata and append to report'
 nextStepFile: './v-02b-validate-persona.md'
 validationReport: '{bmb_creations_output_folder}/validation-report-{agent-name}.md'
 agentMetadata: ../data/agent-metadata.md
+agentFile: '{agent-file-path}'
 ---
 
 # Validate Step 2a: Validate Metadata
 
-## STEP GOAL:
+## STEP GOAL
 
-Validate the agent's metadata properties against BMAD standards. Append findings to validation report and auto-advance.
+Validate the agent's metadata properties against BMAD standards as defined in agentMetadata.md. Append findings to validation report and auto-advance.
 
-## MANDATORY EXECUTION RULES:
+## MANDATORY EXECUTION RULES
 
 - 📖 CRITICAL: Read the complete step file before taking any action
 - 🔄 CRITICAL: Read validationReport and agentMetadata first
+- 🔄 CRITICAL: Load the actual agent file to validate metadata
 - 🚫 NO MENU - append findings and auto-advance
 - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
 
@@ -26,22 +28,55 @@ Validate the agent's metadata properties against BMAD standards. Append findings
 - 📊 Append findings to validation report
 - 🚫 FORBIDDEN to present menu
 
-## EXECUTION PROTOCOLS:
+## EXECUTION PROTOCOLS
 
 - 🎯 Load agentMetadata.md reference
+- 🎯 Load the actual agent file for validation
 - 📊 Validate all metadata fields
 - 💾 Append findings to validation report
 - ➡️ Auto-advance to next validation step
 
-## Sequence of Instructions:
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
 
 ### 1. Load References
 
-Read `{agentMetadata}` and `{validationReport}`.
+Read `{agentMetadata}`, `{validationReport}`, and `{agentFile}`.
 
 ### 2. Validate Metadata
 
-Perform checks on: id, name, title, icon, module, hasSidecar.
+Perform these checks systematically - validate EVERY rule specified in agentMetadata.md:
+
+1. **Required Fields Existence**
+   - [ ] id: Present and non-empty
+   - [ ] name: Present and non-empty (display name)
+   - [ ] title: Present and non-empty
+   - [ ] icon: Present (emoji or symbol)
+   - [ ] module: Present and valid format
+   - [ ] hasSidecar: Present (boolean, if applicable)
+
+2. **Format Validation**
+   - [ ] id: Uses kebab-case, no spaces, unique identifier
+   - [ ] name: Clear display name for UI
+   - [ ] title: Concise functional description
+   - [ ] icon: Appropriate emoji or unicode symbol
+   - [ ] module: Either a 3-4 letter module code OR 'stand-alone'
+   - [ ] hasSidecar: Boolean value, matches actual agent structure
+
+3. **Content Quality**
+   - [ ] id: Unique and descriptive
+   - [ ] name: Clear and user-friendly
+   - [ ] title: Accurately describes agent's function
+   - [ ] icon: Visually representative of agent's purpose
+   - [ ] module: Correctly identifies module membership
+   - [ ] hasSidecar: Correctly indicates if agent uses sidecar files
+
+4. **Agent Type Consistency**
+   - [ ] If hasSidecar: true, sidecar folder path must be specified
+   - [ ] If module is a module code, agent is a module agent
+   - [ ] If module is 'stand-alone', agent is not part of a module
+   - [ ] No conflicting type indicators
 
 ### 3. Append Findings to Report
 
@@ -53,15 +88,23 @@ Append to `{validationReport}`:
 **Status:** {✅ PASS / ⚠️ WARNING / ❌ FAIL}
 
 **Checks:**
-- [ ] id: kebab-case, no spaces
+- [ ] id: kebab-case, no spaces, unique
 - [ ] name: clear display name
 - [ ] title: concise function description
 - [ ] icon: appropriate emoji/symbol
-- [ ] module: correct format `{project}:{type}:{name}`
+- [ ] module: correct format (code or stand-alone)
 - [ ] hasSidecar: matches actual usage
 
-**Findings:**
-{Detailed findings}
+**Detailed Findings:**
+
+*PASSING:*
+{List of passing checks}
+
+*WARNINGS:*
+{List of non-blocking issues}
+
+*FAILURES:*
+{List of blocking issues that must be fixed}
 ```
 
 ### 4. Auto-Advance