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

package/src/modules/bmb/workflows/agent/steps-e/e-08a-edit-simple.md

@@ -0,0 +1,134 @@
+---
+name: 'e-08a-edit-simple'
+description: 'Apply edits to Simple agent'
+
+nextStepFile: './e-09a-validate-metadata.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentFile: '{original-agent-path}'
+agentBackup: '{original-agent-path}.backup'
+
+# Template and Architecture
+simpleTemplate: ../templates/simple-agent.template.md
+simpleArch: ../data/simple-agent-architecture.md
+agentCompilation: ../data/agent-compilation.md
+agentMetadata: ../data/agent-metadata.md
+personaProperties: ../data/persona-properties.md
+principlesCrafting: ../data/principles-crafting.md
+agentMenuPatterns: ../data/agent-menu-patterns.md
+criticalActions: ../data/critical-actions.md
+---
+
+# Edit Step 8a: Edit Simple Agent
+
+## STEP GOAL:
+
+Apply all planned edits to the Simple agent YAML file using templates and architecture references for validation.
+
+## MANDATORY EXECUTION RULES:
+
+- 🛑 ALWAYS create backup before modifying agent file
+- 📖 CRITICAL: Read template and architecture files first
+- 🔄 CRITICAL: Load editPlan and agentFile
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Step-Specific Rules:
+
+- 🎯 Load all reference files before applying edits
+- 📊 Apply edits exactly as specified in editPlan
+- 💾 Validate YAML after each edit
+- ➡️ Auto-advance to post-edit validation when complete
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load template, architecture, and data files
+- 📊 Read editPlan to get all planned changes
+- 💾 Create backup
+- 📝 Apply edits: type conversion, metadata, persona, commands, critical_actions
+- ✅ Validate YAML syntax
+- ➡️ Auto-advance to next validation step
+
+## Sequence of Instructions:
+
+### 1. Load Reference Documents
+
+Read all files before editing:
+- `{simpleTemplate}` - YAML structure reference
+- `{simpleArch}` - Simple agent architecture
+- `{agentCompilation}` - Assembly guidelines
+- `{agentMetadata}`, `{personaProperties}`, `{principlesCrafting}`
+- `{agentMenuPatterns}`, `{criticalActions}`
+
+### 2. Load Edit Plan and Agent
+
+Read `{editPlan}` to get all planned edits.
+Read `{agentFile}` to get current agent YAML.
+
+### 3. Create Backup
+
+ALWAYS backup before editing:
+`cp {agentFile} {agentBackup}`
+
+Confirm: "Backup created at: `{agentBackup}`"
+
+### 4. Apply Edits in Sequence
+
+For each planned edit:
+
+**Type Conversion:**
+- Update `type:` field if converting
+- Add/remove type-specific fields
+
+**Metadata Edits:**
+- Apply each field change from metadataEdits
+
+**Persona Edits:**
+- Replace persona section with new four-field persona
+- Validate field purity (role ≠ identity ≠ communication_style)
+
+**Command Edits:**
+- Additions: append to commands array
+- Modifications: update specific commands
+- Removals: remove from commands array
+
+**Critical Actions Edits:**
+- Additions: append to critical_actions array
+- Modifications: update specific actions
+- Removals: remove from array
+
+### 5. Validate YAML After Each Edit
+
+Confirm YAML syntax is valid after each modification.
+
+### 6. Document Applied Edits
+
+Append to `{editPlan}`:
+
+```yaml
+editsApplied:
+  - {edit-description}
+  - {edit-description}
+backup: {agentBackup}
+timestamp: {YYYY-MM-DD HH:MM}
+```
+
+### 7. Auto-Advance
+
+When all edits applied successfully, load and execute `{nextStepFile}` immediately.
+
+## SUCCESS METRICS
+
+✅ Backup created
+✅ All reference files loaded
+✅ All edits applied correctly
+✅ YAML remains valid
+✅ Edit plan tracking updated
+
+## FAILURE MODES
+
+❌ Backup failed
+❌ YAML became invalid
+❌ Edits not applied as specified
+
+---
+
+**Auto-advancing to post-edit validation...

package/src/modules/bmb/workflows/agent/steps-e/e-08b-edit-expert.md

@@ -0,0 +1,117 @@
+---
+name: 'e-08b-edit-expert'
+description: 'Apply edits to Expert agent'
+
+nextStepFile: './e-09a-validate-metadata.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentFile: '{original-agent-path}'
+agentBackup: '{original-agent-path}.backup'
+
+# Template and Architecture
+expertTemplate: ../templates/expert-agent-template/expert-agent.template.md
+expertArch: ../data/expert-agent-architecture.md
+agentCompilation: ../data/agent-compilation.md
+agentMetadata: ../data/agent-metadata.md
+personaProperties: ../data/persona-properties.md
+principlesCrafting: ../data/principles-crafting.md
+agentMenuPatterns: ../data/agent-menu-patterns.md
+criticalActions: ../data/critical-actions.md
+expertValidation: ../data/expert-agent-validation.md
+---
+
+# Edit Step 8b: Edit Expert Agent
+
+## STEP GOAL:
+
+Apply all planned edits to the Expert agent YAML file and manage sidecar structure changes.
+
+## MANDATORY EXECUTION RULES:
+
+- 🛑 ALWAYS create backup before modifying agent file
+- 📖 CRITICAL: Read template and architecture files first
+- 🔄 CRITICAL: Load editPlan and agentFile
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Step-Specific Rules:
+
+- 🎯 Load all reference files before applying edits
+- 📊 Manage sidecar structure for Expert agents
+- 💾 Validate YAML and sidecar paths after edits
+- ➡️ Auto-advance to post-edit validation when complete
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load template, architecture, and data files
+- 📊 Read editPlan to get all planned changes
+- 💾 Create backup
+- 📝 Apply edits including sidecar management
+- ✅ Validate YAML and sidecar paths
+- ➡️ Auto-advance to next validation step
+
+## Sequence of Instructions:
+
+### 1. Load Reference Documents
+
+Read all files before editing:
+- `{expertTemplate}` - Expert YAML structure
+- `{expertArch}` - Expert agent architecture
+- `{agentCompilation}`, `{agentMetadata}`, `{personaProperties}`, `{principlesCrafting}`
+- `{agentMenuPatterns}`, `{criticalActions}`, `{expertValidation}`
+
+### 2. Load Edit Plan and Agent
+
+Read `{editPlan}` to get all planned edits.
+Read `{agentFile}` to get current agent YAML.
+
+### 3. Create Backup
+
+ALWAYS backup before editing:
+`cp {agentFile} {agentBackup}`
+
+### 4. Apply Edits in Sequence
+
+**Type Conversion to Expert:**
+- Update `type: expert`
+- Add `metadata.sidecar-folder` if not present
+- Create sidecar directory: `mkdir -p {project-root}/_bmad/_memory/{sidecar-folder}/`
+
+**Sidecar Management:**
+- If changing sidecar-folder: update all critical_actions references
+- If removing sidecar (Expert → Simple): remove sidecar fields and folder
+- Create/update sidecar files as needed
+
+**Metadata, Persona, Commands, Critical Actions:**
+- Same as Simple agent edit
+
+### 5. Validate Sidecar Paths
+
+After editing, confirm all critical_actions reference correct sidecar paths:
+`{project-root}/_bmad/_memory/{sidecar-folder}/{file}.md`
+
+### 6. Document Applied Edits
+
+Append to `{editPlan}` with sidecar changes noted.
+
+### 7. Auto-Advance
+
+When all edits applied successfully, load and execute `{nextStepFile}` immediately.
+
+## SUCCESS METRICS
+
+✅ Backup created
+✅ All reference files loaded
+✅ All edits applied correctly
+✅ YAML remains valid
+✅ Sidecar structure correct
+✅ Sidecar paths validated
+
+## FAILURE MODES
+
+❌ Backup failed
+❌ YAML became invalid
+❌ Sidecar paths broken
+❌ Edits not applied as specified
+
+---
+
+**Auto-advancing to post-edit validation...

package/src/modules/bmb/workflows/agent/steps-e/e-08c-edit-module.md

@@ -0,0 +1,120 @@
+---
+name: 'e-08c-edit-module'
+description: 'Apply edits to Module agent'
+
+nextStepFile: './e-09a-validate-metadata.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentFile: '{original-agent-path}'
+agentBackup: '{original-agent-path}.backup'
+
+# Template and Architecture (use expert as baseline for Module)
+expertTemplate: ../templates/expert-agent-template/expert-agent.template.md
+expertArch: ../data/expert-agent-architecture.md
+moduleArch: ../data/module-agent-validation.md
+agentCompilation: ../data/agent-compilation.md
+agentMetadata: ../data/agent-metadata.md
+personaProperties: ../data/persona-properties.md
+principlesCrafting: ../data/principles-crafting.md
+agentMenuPatterns: ../data/agent-menu-patterns.md
+criticalActions: ../data/critical-actions.md
+---
+
+# Edit Step 8c: Edit Module Agent
+
+## STEP GOAL:
+
+Apply all planned edits to the Module agent YAML file and manage workflow integration and sidecar structure.
+
+## MANDATORY EXECUTION RULES:
+
+- 🛑 ALWAYS create backup before modifying agent file
+- 📖 CRITICAL: Read template and architecture files first
+- 🔄 CRITICAL: Load editPlan and agentFile
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Step-Specific Rules:
+
+- 🎯 Load all reference files before applying edits
+- 📊 Manage workflow integration paths for Module agents
+- 💾 Validate YAML and workflow paths after edits
+- ➡️ Auto-advance to post-edit validation when complete
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load template, architecture, and data files
+- 📊 Read editPlan to get all planned changes
+- 💾 Create backup
+- 📝 Apply edits including workflow paths
+- ✅ Validate YAML and workflow paths
+- ➡️ Auto-advance to next validation step
+
+## Sequence of Instructions:
+
+### 1. Load Reference Documents
+
+Read all files before editing:
+- `{expertTemplate}` - Module uses expert as baseline
+- `{expertArch}`, `{moduleArch}` - Architecture references
+- `{agentCompilation}`, `{agentMetadata}`, `{personaProperties}`, `{principlesCrafting}`
+- `{agentMenuPatterns}`, `{criticalActions}`
+
+### 2. Load Edit Plan and Agent
+
+Read `{editPlan}` to get all planned edits.
+Read `{agentFile}` to get current agent YAML.
+
+### 3. Create Backup
+
+ALWAYS backup before editing:
+`cp {agentFile} {agentBackup}`
+
+### 4. Apply Edits in Sequence
+
+**Type Conversion to Module:**
+- Update `type: module`
+- Add workflow integration paths
+
+**Workflow Path Management:**
+- Add: `skills: - workflow: {path}`
+- Remove: delete workflow entries
+- Modify: update workflow paths
+
+**Sidecar for Multi-Workflow Modules:**
+- If 3+ workflows: consider sidecar creation
+- Add sidecar configuration if needed
+
+**Metadata, Persona, Commands, Critical Actions:**
+- Same as Expert agent edit
+
+### 5. Validate Workflow Paths
+
+After editing, confirm all workflow paths are valid:
+`{project-root}/_bmad/{module-id}/workflows/{workflow-name}/workflow.md`
+
+### 6. Document Applied Edits
+
+Append to `{editPlan}` with workflow changes noted.
+
+### 7. Auto-Advance
+
+When all edits applied successfully, load and execute `{nextStepFile}` immediately.
+
+## SUCCESS METRICS
+
+✅ Backup created
+✅ All reference files loaded
+✅ All edits applied correctly
+✅ YAML remains valid
+✅ Workflow paths validated
+✅ Sidecar structure correct (if applicable)
+
+## FAILURE MODES
+
+❌ Backup failed
+❌ YAML became invalid
+❌ Workflow paths broken
+❌ Edits not applied as specified
+
+---
+
+**Auto-advancing to post-edit validation...

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

@@ -0,0 +1,70 @@
+---
+name: 'e-09a-validate-metadata'
+description: 'Validate metadata (after edit) - no menu, auto-advance'
+
+nextStepFile: './e-09b-validate-persona.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentMetadata: ../data/agent-metadata.md
+---
+
+# Edit Step 9a: Validate Metadata (After Edit)
+
+## STEP GOAL:
+
+Validate the agent's metadata properties after edits. Record findings to editPlan and auto-advance.
+
+## 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 (validationAfter section)
+- 🚫 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}` and `{editPlan}`.
+
+### 2. Validate Metadata
+
+Perform checks on id, name, title, icon, module, hasSidecar.
+
+### 3. Record Findings
+
+Append to editPlan frontmatter:
+
+```yaml
+validationAfter:
+  metadata:
+    status: [pass|fail|warning]
+    findings:
+      - {check}: [pass|fail]
+```
+
+### 4. Auto-Advance
+
+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-09b-validate-persona.md

@@ -0,0 +1,70 @@
+---
+name: 'e-09b-validate-persona'
+description: 'Validate persona (after edit) - no menu, auto-advance'
+
+nextStepFile: './e-09c-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 9b: Validate Persona (After Edit)
+
+## STEP GOAL:
+
+Validate the agent's persona after edits. 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 (validationAfter section)
+- 🚫 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}`, `{principlesCrafting}`, and `{editPlan}`.
+
+### 2. Validate Persona
+
+Perform checks on role, identity, communication_style, principles.
+
+### 3. Record Findings
+
+Append to editPlan frontmatter:
+
+```yaml
+  persona:
+    status: [pass|fail|warning]
+    findings:
+      - {check}: [pass|fail]
+```
+
+### 4. Auto-Advance
+
+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-09c-validate-menu.md

@@ -0,0 +1,69 @@
+---
+name: 'e-09c-validate-menu'
+description: 'Validate menu structure (after edit) - no menu, auto-advance'
+
+nextStepFile: './e-09d-validate-structure.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentMenuPatterns: ../data/agent-menu-patterns.md
+---
+
+# Edit Step 9c: Validate Menu (After Edit)
+
+## STEP GOAL:
+
+Validate the agent's command menu structure after edits. 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 (validationAfter section)
+- 🚫 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}` and `{editPlan}`.
+
+### 2. Validate Menu
+
+Perform checks on A/P/C convention, command names, descriptions.
+
+### 3. Record Findings
+
+Append to editPlan frontmatter:
+
+```yaml
+  menu:
+    status: [pass|fail|warning]
+    findings:
+      - {check}: [pass|fail]
+```
+
+### 4. Auto-Advance
+
+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...**

package/src/modules/bmb/workflows/agent/steps-e/e-09d-validate-structure.md

@@ -0,0 +1,69 @@
+---
+name: 'e-09d-validate-structure'
+description: 'Validate YAML structure (after edit) - no menu, auto-advance'
+
+nextStepFile: './e-09e-validate-sidecar.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{agent-name}.md'
+agentCompilation: ../data/agent-compilation.md
+---
+
+# Edit Step 9d: Validate Structure (After Edit)
+
+## STEP GOAL:
+
+Validate the agent's YAML structure after edits. Record findings to editPlan and auto-advance.
+
+## MANDATORY EXECUTION RULES:
+
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: Read editPlan and agentCompilation 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 YAML structure and required fields
+- 📊 Record findings to editPlan frontmatter (validationAfter section)
+- 🚫 FORBIDDEN to present menu - auto-advance when complete
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load agentCompilation.md reference
+- 📊 Validate YAML structure
+- 💾 Record findings to editPlan
+- ➡️ Auto-advance to next validation step when complete
+
+## Sequence of Instructions:
+
+### 1. Load References
+
+Read `{agentCompilation}` and `{editPlan}`.
+
+### 2. Validate Structure
+
+Perform checks on YAML syntax, required fields, field types, indentation.
+
+### 3. Record Findings
+
+Append to editPlan frontmatter:
+
+```yaml
+  structure:
+    status: [pass|fail|warning]
+    findings:
+      - {check}: [pass|fail]
+```
+
+### 4. Auto-Advance
+
+Load and execute `{nextStepFile}` immediately.
+
+## SUCCESS METRICS
+
+✅ All structure checks performed and recorded
+✅ Findings saved to editPlan
+✅ Auto-advanced to next step
+
+---
+
+**Auto-advancing to sidecar validation...**