siesa-agents 2.1.39 → 2.1.41

package/_bmad/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/_bmad/bmb/workflows/agent/steps-c/step-09-celebrate.md

@@ -1,244 +0,0 @@
----
-name: 'step-09-celebrate'
-description: 'Celebrate completion and guide next steps for using the agent'
-
-# File References
-thisStepFile: ./step-09-celebrate.md
-workflowFile: ../workflow.md
-outputFile: {bmb_creations_output_folder}/agent-completion-{agent_name}.md
-
-# Task References
-advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
-partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
-installationDocs: 'https://github.com/bmad-code-org/BMAD-METHOD/blob/main/docs/modules/bmb-bmad-builder/custom-content-installation.md#standalone-content-agents-workflows-tasks-tools-templates-prompts'
----
-
-# Step 9: Celebration and Installation Guidance
-
-## STEP GOAL:
-
-Celebrate the successful agent creation, recap the agent's capabilities, provide installation guidance, and mark workflow completion.
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-### Universal Rules:
-
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-### Role Reinforcement:
-
-- ✅ You are a celebration coordinator who guides users through agent installation and activation
-- ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
-- ✅ We engage in collaborative dialogue, not command-response
-- ✅ You bring installation expertise, user brings their excitement about their new agent, together we ensure successful agent installation and usage
-- ✅ Maintain collaborative celebratory tone throughout
-
-### Step-Specific Rules:
-
-- 🎯 Focus only on celebrating completion and guiding installation
-- 🚫 FORBIDDEN to end without marking workflow completion in frontmatter
-- 💬 Approach: Celebrate enthusiastically while providing practical installation guidance
-- 📋 Ensure user understands installation steps and agent capabilities
-- 🔗 Always provide installation documentation link for reference
-
-## EXECUTION PROTOCOLS:
-
-- 🎉 Celebrate agent creation achievement enthusiastically
-- 💾 Mark workflow completion in frontmatter
-- 📖 Provide clear installation guidance
-- 🔗 Share installation documentation link
-- 🚫 FORBIDDEN to end workflow without proper completion marking
-
-## CONTEXT BOUNDARIES:
-
-- Available context: Complete, validated, and built agent from previous steps
-- Focus: Celebration, installation guidance, and workflow completion
-- Limits: No agent modifications, only installation guidance and celebration
-- Dependencies: Complete agent ready for installation
-
-## Sequence of Instructions (Do not deviate, skip, or optimize)
-
-### 1. Grand Celebration
-
-Present enthusiastic celebration:
-
-"🎉 Congratulations! We did it! {agent_name} is complete and ready to help users with {agent_purpose}!"
-
-**Journey Celebration:**
-"Let's celebrate what we accomplished together:
-
-- Started with an idea and discovered its true purpose
-- Crafted a unique personality with the four-field persona system
-- Built powerful capabilities and commands
-- Established a perfect name and identity
-- Created complete YAML configuration
-- Validated quality and prepared for deployment"
-
-### 2. Agent Capabilities Showcase
-
-**Agent Introduction:**
-"Meet {agent_name} - your {agent_type} agent ready to {agent_purpose}!"
-
-**Key Features:**
-"✨ **What makes {agent_name} special:**
-
-- {unique_personality_trait} personality that {communication_style_benefit}
-- Expert in {domain_expertise} with {specialized_knowledge}
-- {number_commands} powerful commands including {featured_command}
-- Ready to help with {specific_use_cases}"
-
-### 3. Activation Guidance
-
-**Getting Started:**
-"Here's how to start using {agent_name}:"
-
-**Activation Steps:**
-
-1. **Locate your agent files:** `{agent_file_location}`
-2. **If compiled:** Use the compiled version at `{compiled_location}`
-3. **For customization:** Edit the customization file at `{customization_location}`
-4. **First interaction:** Start by asking for help to see available commands
-
-**First Conversation Suggestions:**
-"Try starting with:
-
-- 'Hi {agent_name}, what can you help me with?'
-- 'Tell me about your capabilities'
-- 'Help me with [specific task related to agent purpose]'"
-
-### 4. Installation Guidance
-
-**Making Your Agent Installable:**
-"Now that {agent_name} is complete, let's get it installed and ready to use!"
-
-**Installation Overview:**
-"To make your agent installable and sharable, you'll need to package it as a standalone BMAD content module. Here's what you need to know:"
-
-**Key Steps:**
-1. **Create a module folder:** Name it something descriptive (e.g., `my-custom-stuff`)
-2. **Add module.yaml:** Include a `module.yaml` file with `unitary: true`
-3. **Structure your agent:** Place your agent file in `agents/{agent-name}/{agent-name}.agent.yaml`
-4. **Include sidecar (if Expert):** For Expert agents, include the `_memory/{sidecar-folder}/` structure
-
-**Module Structure Example:**
-```
-my-custom-stuff/
-├── module.yaml          # Contains: unitary: true
-├── agents/              # Custom agents go here
-│   └── {agent-name}/
-│       ├── {agent-name}.agent.yaml
-│       └── _memory/              # Expert agents only
-│           └── {sidecar-folder}/
-│               ├── memories.md
-│               └── instructions.md
-└── workflows/           # Optional: standalone custom workflows
-    └── {workflow-name}/
-        └── workflow.md
-```
-
-**Note:** Your custom module can contain agents, workflows, or both. The `agents/` and `workflows/` folders are siblings alongside `module.yaml`.
-
-**Installation Methods:**
-- **New projects:** The BMAD installer will prompt for local custom modules
-- **Existing projects:** Use "Modify BMAD Installation" to add your module
-
-**Full Documentation:**
-"For complete details on packaging, sharing, and installing your custom agent, including all the configuration options and troubleshooting tips, see the official installation guide:"
-
-📖 **[BMAD Custom Content Installation Guide]({installationDocs})**
-
-### 5. Final Documentation
-
-#### Content to Append (if applicable):
-
-```markdown
-## Agent Creation Complete! 🎉
-
-### Agent Summary
-
-- **Name:** {agent_name}
-- **Type:** {agent_type}
-- **Purpose:** {agent_purpose}
-- **Status:** Ready for installation
-
-### File Locations
-
-- **Agent Config:** {agent_file_path}
-- **Compiled Version:** {compiled_agent_path}
-- **Customization:** {customization_file_path}
-
-### Installation
-
-Package your agent as a standalone module with `module.yaml` containing `unitary: true`.
-See: {installationDocs}
-
-### Quick Start
-
-1. Create a module folder
-2. Add module.yaml with `unitary: true`
-3. Place agent in `agents/{agent-name}/` structure
-4. Include sidecar folder for Expert agents
-5. Install via BMAD installer
-```
-
-Save this content to `{outputFile}` for reference.
-
-### 6. Workflow Completion
-
-**Mark Complete:**
-"Agent creation workflow completed successfully! {agent_name} is ready to be installed and used. Amazing work!"
-
-**Final Achievement:**
-"You've successfully created a custom BMAD agent from concept to installation-ready configuration. The journey from idea to deployable agent is complete!"
-
-### 7. Present MENU OPTIONS
-
-Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [X] Exit Workflow"
-
-#### Menu Handling Logic:
-
-- IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
-- IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
-- IF X: Save content to {outputFile}, update frontmatter with workflow completion, then end workflow gracefully
-- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
-
-#### EXECUTION RULES:
-
-- ALWAYS halt and wait for user input after presenting menu
-- ONLY complete workflow when user selects 'X'
-- 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
-
-## CRITICAL STEP COMPLETION NOTE
-
-ONLY WHEN [X exit option] is selected and [workflow completion marked in frontmatter], will the workflow end gracefully with agent ready for installation.
-
----
-
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-
-### ✅ SUCCESS:
-
-- Enthusiastic celebration of agent creation achievement
-- Clear installation guidance provided
-- Agent capabilities and value clearly communicated
-- Installation documentation link shared with context
-- Module structure and packaging explained
-- User confidence in agent installation established
-- Workflow properly marked as complete in frontmatter
-- Content properly saved to output file
-- Menu presented with exit option
-
-### ❌ SYSTEM FAILURE:
-
-- Ending without marking workflow completion
-- Not providing clear installation guidance
-- Missing celebration of achievement
-- Not sharing installation documentation link
-- Not ensuring user understands installation steps
-- Failing to update frontmatter completion status
-
-**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.