bmad-method 6.0.0-alpha.22 → 6.0.0-alpha.23

package/src/modules/bmb/workflows/agent/steps-c/step-08f-sidecar-validation.md

@@ -1,462 +0,0 @@
----
-name: 'step-07f-sidecar-validation'
-description: 'Validate sidecar structure and paths'
-
-# File References
-nextStepFile: './step-09-celebrate.md'
-criticalActions: ../data/critical-actions.md
-builtYaml: '{bmb_creations_output_folder}/{agent-name}/{agent-name}.agent.yaml'
-sidecarFolder: '{bmb_creations_output_folder}/{agent-name}/{agent-name}-sidecar/'
-
-# Task References
-advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
-partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
----
-# STEP GOAL
-
-Validate the sidecar folder structure and referenced paths for Expert agents to ensure all sidecar files exist, are properly structured, and paths in the main agent YAML correctly reference them.
-
-# MANDATORY EXECUTION RULES
-
-1. **ONLY runs for Expert agents** - Simple agents should never reach this step
-2. **MUST verify sidecar folder exists** before proceeding
-3. **ALWAYS cross-reference YAML paths** with actual files
-4. **NEVER create missing sidecar files** - Report issues, don't auto-fix
-5. **MUST validate sidecar file structure** for completeness
-6. **ALWAYS check critical actions file** if referenced
-7. **PROVIDE clear remediation steps** for any missing or malformed files
-
-# EXECUTION PROTOCOLS
-
-## Context Awareness
-
-- User has an Expert agent with sidecar configuration
-- Structural validation (7E) already passed
-- Sidecar folder should have been created during build
-- This is the final validation before celebration
-- Missing sidecar components may break agent functionality
-
-## User Expectations
-
-- Comprehensive sidecar structure validation
-- Clear identification of missing files
-- Path reference verification
-- Actionable remediation guidance
-- Professional but approachable tone
-
-## Tone and Style
-
-- Thorough and systematic
-- Clear and specific about issues
-- Solution-oriented (focus on how to fix)
-- Encouraging when sidecar is complete
-- Not pedantic about minor formatting issues
-
-# CONTEXT BOUNDARIES
-
-## What to Validate
-
-- Sidecar folder existence and location
-- All referenced files exist in sidecar
-- Sidecar file structure completeness
-- Path references in main YAML accuracy
-- Critical actions file if referenced
-- File naming conventions
-- File content completeness (not empty)
-
-## What NOT to Validate
-
-- Content quality of sidecar files
-- Artistic choices in sidecar documentation
-- Optional sidecar components
-- File formatting preferences
-
-## When to Escalate
-
-- Sidecar folder completely missing
-- Critical files missing (actions, core modules)
-- Path references pointing to non-existent files
-- Empty sidecar files that should have content
-
-# EXECUTION SEQUENCE
-
-## 1. Load Sidecar Context
-
-```bash
-# Verify main agent YAML exists
-agentYaml = read(builtYaml)
-
-# Extract sidecar path from YAML or use template default
-sidecarPath = extractSidecarPath(agentYaml) or sidecarFolder
-
-# Check if sidecar folder exists
-sidecarExists = directoryExists(sidecarPath)
-
-# Load critical actions reference if needed
-criticalActionsRef = read(criticalActions)
-```
-
-**Action:** Present discovery status:
-```markdown
-🔍 SIDECAR VALIDATION INITIALIZED
-
-Agent: {agent-name}
-Type: Expert (requires sidecar)
-
-Main YAML: {builtYaml}
-Sidecar Path: {sidecarPath}
-
-Status: {✅ Folder Found | ❌ Folder Missing}
-```
-
-## 2. Validate Sidecar Structure
-
-### A. Folder Existence Check
-
-```markdown
-## 📁 FOLDER STRUCTURE VALIDATION
-
-**Sidecar Location:** {sidecarPath}
-**Status:** [EXISTS | MISSING | WRONG LOCATION]
-```
-
-If missing:
-```markdown
-❌ **CRITICAL ISSUE:** Sidecar folder not found!
-
-**Expected Location:** {sidecarPath}
-
-**Possible Causes:**
-1. Build process didn't create sidecar
-2. Sidecar path misconfigured in agent YAML
-3. Folder moved or deleted after build
-
-**Required Action:**
-[ ] Re-run build process with sidecar enabled
-[ ] Verify sidecar configuration in agent YAML
-[ ] Check folder was created in correct location
-```
-
-### B. Sidecar File Inventory
-
-If folder exists, list all files:
-```bash
-sidecarFiles = listFiles(sidecarPath)
-```
-
-```markdown
-## 📄 SIDECAR FILE INVENTORY
-
-Found {count} files in sidecar:
-
-{For each file:}
-- {filename} ({size} bytes)
-```
-
-### C. Cross-Reference Validation
-
-Extract all sidecar path references from agent YAML:
-```yaml
-# Common sidecar reference patterns
-sidecar:
-  critical-actions: './{agent-name}-sidecar/critical-actions.md'
-  modules:
-    - path: './{agent-name}-sidecar/modules/module-01.md'
-```
-
-Validate each reference:
-```markdown
-## 🔗 PATH REFERENCE VALIDATION
-
-**Checked {count} references from agent YAML:**
-
-{For each reference:}
-**Source:** {field in agent YAML}
-**Expected Path:** {referenced path}
-**Status:** [✅ Found | ❌ Missing | ⚠️  Wrong Location]
-```
-
-## 3. Validate Sidecar File Contents
-
-For each sidecar file found, check:
-
-### A. File Completeness
-```markdown
-## 📋 FILE CONTENT VALIDATION
-
-{For each file:}
-### {filename}
-**Size:** {bytes}
-**Status:** [✅ Complete | ⚠️  Empty | ❌ Too Small]
-**Last Modified:** {timestamp}
-```
-
-### B. Critical Actions File (if present)
-
-Special validation for critical-actions.md:
-```markdown
-## 🎯 CRITICAL ACTIONS VALIDATION
-
-**File:** {sidecarPath}/critical-actions.md
-**Status:** [PRESENT | MISSING | EMPTY]
-
-{If Present:}
-**Sections Found:**
-{List sections detected}
-
-**Completeness:**
-[ ] Header/metadata present
-[ ] Actions defined
-[ ] No critical sections missing
-```
-
-### C. Module Files (if present)
-
-If sidecar contains modules:
-```markdown
-## 📚 MODULE VALIDATION
-
-**Modules Found:** {count}
-
-{For each module:}
-### {module-filename}
-**Status:** [✅ Valid | ⚠️  Issues Found]
-**Checks:**
-[ ] Frontmatter complete
-[ ] Content present
-[ ] References valid
-```
-
-## 4. Generate Validation Report
-
-```markdown
-# 🎯 SIDECAR VALIDATION REPORT
-
-## Agent: {agent-name}
-Sidecar Path: {sidecarPath}
-Validation Date: {timestamp}
-
----
-
-## ✅ VALIDATION CHECKS PASSED
-
-**Folder Structure:**
-- [x] Sidecar folder exists
-- [x] Located at expected path
-- [x] Accessible and readable
-
-**File Completeness:**
-- [x] All referenced files present
-- [x] No broken path references
-- [x] Files have content (not empty)
-
-**Content Quality:**
-- [x] Critical actions complete
-- [x] Module files structured
-- [x] No obvious corruption
-
----
-
-## ⚠️  ISSUES IDENTIFIED ({count})
-
-{If issues:}
-### Issue #{number}: {issue type}
-**Severity:** [CRITICAL|MODERATE|MINOR]
-**Component:** {file or folder}
-**Problem:** {clear description}
-**Impact:** {what this breaks}
-**Remediation:**
-1. {specific step 1}
-2. {specific step 2}
-3. {specific step 3}
-
-{If no issues:}
-### 🎉 NO ISSUES FOUND
-Your agent's sidecar is complete and properly structured!
-All path references are valid and files are in place.
-
----
-
-## 📊 SUMMARY
-
-**Overall Status:** [PASSED|FAILED|CONDITIONAL]
-**Files Validated:** {count}
-**Issues Found:** {count}
-**Critical Issues:** {count}
-**Sidecar Ready:** [YES|NO]
-
----
-
-## 5. Present MENU OPTIONS
-
-Display: "**Select an Option:** [A] Advanced Elicitation [F] Fix Findings [P] Party Mode [C] Continue"
-
-### Menu Handling Logic:
-
-- IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
-- IF F: Apply auto-fixes to {builtYaml} or sidecar files for identified issues, then redisplay the menu
-- IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
-- IF C: Proceed to celebration step, update frontmatter, then only then load, read entire file, then execute {nextStepFile}
-- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#5-present-menu-options)
-
-### EXECUTION RULES:
-
-- ALWAYS halt and wait for user input after presenting menu
-- ONLY proceed to next step when user selects 'C'
-- After other menu items execution, return to this menu
-- User can chat or ask questions - always respond and then end with display again of the menu options
-
-## 6. Issue Resolution (if [F] selected)
-
-Work through each issue systematically:
-
-**For Missing Files:**
-```markdown
-### 🔧 FIXING: Missing {filename}
-
-**Required File:** {path}
-**Purpose:** {why it's needed}
-
-**Option 1:** Re-run Build
-- Sidecar may not have been created completely
-- Return to build step and re-execute
-
-**Option 2:** Manual Creation
-- Create file at: {full path}
-- Use template from: {template reference}
-- Minimum required content: {specification}
-
-**Option 3:** Update References
-- Remove reference from agent YAML if not truly needed
-- Update path if file exists in different location
-
-Which option? [1/2/3]:
-```
-
-**For Broken Path References:**
-```markdown
-### 🔧 FIXING: Invalid Path Reference
-
-**Reference Location:** {agent YAML field}
-**Current Path:** {incorrect path}
-**Expected File:** {filename}
-**Actual Location:** {where file actually is}
-
-**Fix Options:**
-1. Update path in agent YAML to: {correct path}
-2. Move file to expected location: {expected path}
-3. Remove reference if file not needed
-
-Which option? [1/2/3]:
-```
-
-**For Empty/Malformed Files:**
-```markdown
-### 🔧 FIXING: {filename} - {Issue}
-
-**Problem:** {empty/too small/malformed}
-**Location:** {full path}
-
-**Remediation:**
-- View current content
-- Compare to template/standard
-- Add missing sections
-- Correct formatting
-
-Ready to view and fix? [Y/N]:
-```
-
-After each fix:
-- Re-validate the specific component
-- Confirm resolution
-- Move to next issue
-- Final re-validation when all complete
-
-## 6. Route to Celebration
-
-When validation passes or user chooses to continue:
-
-```markdown
-# 🚀 SIDECAR VALIDATION COMPLETE
-
-## Expert Agent: {agent-name}
-
-✅ **Sidecar Structure:** Validated
-✅ **Path References:** All correct
-✅ **File Contents:** Complete
-
----
-
-## 🎯 READY FOR CELEBRATION
-
-Your Expert agent with sidecar is fully validated and ready!
-
-**Next Step:** Celebration (Step 8)
-**Final Status:** All checks passed
-
-Press [Enter] to proceed to celebration...
-```
-
-# CRITICAL STEP COMPLETION NOTE
-
-ONLY WHEN [C continue option] is selected and [validation complete with any findings addressed], will you then load and read fully `{nextStepFile}` to execute and begin [celebration].
-
-**BEFORE proceeding to Step 8:**
-
-1. ✅ Sidecar folder exists and is accessible
-2. ✅ All referenced files present
-3. ✅ Path references validated
-4. ✅ File contents checked for completeness
-5. ✅ User informed of validation status
-6. ✅ Issues resolved or explicitly accepted
-7. ⚠️  **CRITICAL:** Only Expert agents should reach this step
-8. ⚠️  **CRITICAL:** Sidecar must be complete for agent to function
-
-**DO NOT PROCEED IF:**
-- Sidecar folder completely missing
-- Critical files absent (actions, core modules)
-- User unaware of sidecar issues
-- Validation not completed
-
-# SUCCESS METRICS
-
-## Step Complete When:
-- [ ] Sidecar folder validated
-- [ ] All path references checked
-- [ ] File contents verified
-- [ ] Validation report presented
-- [ ] Issues resolved or accepted
-- [ ] User ready to proceed
-
-## Quality Indicators:
-- Thoroughness of file inventory
-- Accuracy of path reference validation
-- Clarity of issue identification
-- Actionability of remediation steps
-- User confidence in sidecar completeness
-
-## Failure Modes:
-- Missing sidecar folder completely
-- Skipping file existence checks
-- Not validating path references
-- Proceeding with critical files missing
-- Unclear validation report
-- Not providing remediation guidance
-
----
-
-## 🎓 NOTE: Expert Agent Sidecars
-
-Sidecars are what make Expert agents powerful. They enable:
-- Modular architecture
-- Separation of concerns
-- Easier updates and maintenance
-- Shared components across agents
-
-A validated sidecar ensures your Expert agent will:
-- Load correctly at runtime
-- Find all referenced resources
-- Execute critical actions as defined
-- Provide the advanced capabilities designed
-
-Take the time to validate thoroughly - it pays off in agent reliability!

package/src/modules/bmb/workflows/agent/steps-e/e-03a-validate-metadata.md

@@ -1,78 +0,0 @@
----
-name: 'e-03a-validate-metadata'
-description: 'Validate metadata (before edit) - no menu, auto-advance'
-
-nextStepFile: './e-03b-validate-persona.md'
-editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
-agentMetadata: ../data/agent-metadata.md
----
-
-# Edit Step 3a: Validate Metadata (Before Edit)
-
-## STEP GOAL:
-
-Validate the agent's metadata properties against BMAD standards. Record findings to editPlan and auto-advance to next validation step.
-
-## MANDATORY EXECUTION RULES:
-
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: Read editPlan and agentMetadata first
-- 🚫 NO MENU in this step - record findings and auto-advance
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-### Step-Specific Rules:
-
-- 🎯 Validate metadata against agentMetadata.md rules
-- 📊 Record findings to editPlan frontmatter
-- 🚫 FORBIDDEN to present menu - auto-advance when complete
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Load agentMetadata.md reference
-- 📊 Validate all metadata fields
-- 💾 Record findings to editPlan
-- ➡️ Auto-advance to next validation step when complete
-
-## Sequence of Instructions:
-
-### 1. Load References
-
-Read `{agentMetadata}` to understand validation rules.
-Read `{editPlan}` to get agent file path and metadata.
-
-### 2. Validate Metadata
-
-Perform checks on:
-- **id**: kebab-case, no spaces
-- **name**: display name, clear branding
-- **title**: concise function description
-- **icon**: appropriate emoji or symbol
-- **module**: correct format `{project}:{type}:{name}`
-- **hasSidecar**: boolean, matches actual sidecar usage
-
-### 3. Record Findings
-
-Append to editPlan frontmatter:
-
-```yaml
-validationBefore:
-  metadata:
-    status: [pass|fail|warning]
-    findings:
-      - {check}: [pass|fail]
-      - {check}: [pass|fail]
-```
-
-### 4. Auto-Advance
-
-When validation complete, load and execute `{nextStepFile}` immediately.
-
-## SUCCESS METRICS
-
-✅ All metadata checks performed and recorded
-✅ Findings saved to editPlan
-✅ Auto-advanced to next step
-
----
-
-**Auto-advancing to persona validation...**

package/src/modules/bmb/workflows/agent/steps-e/e-03b-validate-persona.md

@@ -1,76 +0,0 @@
----
-name: 'e-03b-validate-persona'
-description: 'Validate persona (before edit) - no menu, auto-advance'
-
-nextStepFile: './e-03c-validate-menu.md'
-editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
-personaProperties: ../data/persona-properties.md
-principlesCrafting: ../data/principles-crafting.md
----
-
-# Edit Step 3b: Validate Persona (Before Edit)
-
-## STEP GOAL:
-
-Validate the agent's persona fields against BMAD standards. Record findings to editPlan and auto-advance.
-
-## MANDATORY EXECUTION RULES:
-
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: Read editPlan and persona references first
-- 🚫 NO MENU in this step - record findings and auto-advance
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-### Step-Specific Rules:
-
-- 🎯 Validate persona four-field system
-- 📊 Record findings to editPlan frontmatter
-- 🚫 FORBIDDEN to present menu - auto-advance when complete
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Load personaProperties.md and principlesCrafting.md
-- 📊 Validate persona fields
-- 💾 Record findings to editPlan
-- ➡️ Auto-advance to next validation step when complete
-
-## Sequence of Instructions:
-
-### 1. Load References
-
-Read `{personaProperties}` and `{principlesCrafting}`.
-Read `{editPlan}` to get agent file path and persona.
-
-### 2. Validate Persona
-
-Perform checks on:
-- **role**: present, specific, not generic
-- **identity**: present, defines who agent is
-- **communication_style**: present, speech patterns only (no behavioral words)
-- **principles**: present, first principle activates expert knowledge, not generic duties
-
-### 3. Record Findings
-
-Append to editPlan frontmatter:
-
-```yaml
-  persona:
-    status: [pass|fail|warning]
-    findings:
-      - {check}: [pass|fail]
-      - {check}: [pass|fail]
-```
-
-### 4. Auto-Advance
-
-When validation complete, load and execute `{nextStepFile}` immediately.
-
-## SUCCESS METRICS
-
-✅ All persona checks performed and recorded
-✅ Findings saved to editPlan
-✅ Auto-advanced to next step
-
----
-
-**Auto-advancing to menu validation...**

package/src/modules/bmb/workflows/agent/steps-e/e-03c-validate-menu.md

@@ -1,75 +0,0 @@
----
-name: 'e-03c-validate-menu'
-description: 'Validate menu structure (before edit) - no menu, auto-advance'
-
-nextStepFile: './e-03d-validate-structure.md'
-editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
-agentMenuPatterns: ../data/agent-menu-patterns.md
----
-
-# Edit Step 3c: Validate Menu (Before Edit)
-
-## STEP GOAL:
-
-Validate the agent's command menu structure against BMAD standards. Record findings to editPlan and auto-advance.
-
-## MANDATORY EXECUTION RULES:
-
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: Read editPlan and agentMenuPatterns first
-- 🚫 NO MENU in this step - record findings and auto-advance
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-### Step-Specific Rules:
-
-- 🎯 Validate command/menu structure
-- 📊 Record findings to editPlan frontmatter
-- 🚫 FORBIDDEN to present menu - auto-advance when complete
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Load agentMenuPatterns.md reference
-- 📊 Validate commands and menu
-- 💾 Record findings to editPlan
-- ➡️ Auto-advance to next validation step when complete
-
-## Sequence of Instructions:
-
-### 1. Load References
-
-Read `{agentMenuPatterns}`.
-Read `{editPlan}` to get agent file path and commands.
-
-### 2. Validate Menu
-
-Perform checks on:
-- **A/P/C convention**: each menu has Advanced Elicitation, Party Mode, Continue
-- **Command names**: clear, descriptive
-- **Command descriptions**: specific, actionable
-- **Menu handling logic**: properly specified
-
-### 3. Record Findings
-
-Append to editPlan frontmatter:
-
-```yaml
-  menu:
-    status: [pass|fail|warning]
-    findings:
-      - {check}: [pass|fail]
-      - {check}: [pass|fail]
-```
-
-### 4. Auto-Advance
-
-When validation complete, load and execute `{nextStepFile}` immediately.
-
-## SUCCESS METRICS
-
-✅ All menu checks performed and recorded
-✅ Findings saved to editPlan
-✅ Auto-advanced to next step
-
----
-
-**Auto-advancing to structure validation...**