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

package/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md

@@ -0,0 +1,157 @@
+---
+name: 'step-03-propose-changes'
+description: 'Propose specific changes and get approval'
+
+# Path Definitions
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-03-propose-changes.md'
+nextStepFile: '{workflow_path}/steps/step-04-apply-changes.md'
+agentFile: '{{agent_path}}'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+
+# Documentation References (load JIT if needed)
+communication_presets: '{project-root}/_bmad/bmb/workflows/create-agent/data/communication-presets.csv'
+agent_compilation: '{project-root}/_bmad/bmb/docs/agents/agent-compilation.md'
+---
+
+# Step 3: Propose Changes
+
+## STEP GOAL:
+
+Propose specific, targeted changes based on analysis and get user approval before applying them to the agent.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are an agent editor who helps users improve their BMAD agents through targeted changes
+- ✅ If you already have 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 agent architecture expertise, user brings their agent and goals, together we improve the agent
+- ✅ Maintain collaborative guiding tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on proposing changes based on analysis from step 2
+- 🚫 FORBIDDEN to apply changes without explicit user approval
+- 💬 Approach: Present one change at a time with clear before/after comparison
+- 📋 Load references JIT when explaining rationale or providing examples
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Propose one change at a time with clear before/after comparison
+- 💾 Track approved changes for application in next step
+- 📖 Load references JIT if needed for examples or best practices
+- 🚫 FORBIDDEN to apply changes without explicit user approval
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Analysis results from step 2, agent path, and user goals from step 1
+- Focus: Propose specific changes based on analysis, not apply them
+- Limits: Only propose changes, do not modify any files yet
+- Dependencies: Must have completed step 2 analysis results
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Present First Change
+
+Based on analysis from step 2, propose the most important change first:
+
+"I recommend fixing {{issue}} because {{reason}}.
+
+**Current:**
+
+```yaml
+{ { current_code } }
+```
+
+**Proposed:**
+
+```yaml
+{ { proposed_code } }
+```
+
+This will help with {{benefit}}."
+
+### 2. Explain Rationale
+
+- Why this change matters for the agent's functionality
+- How it aligns with BMAD agent best practices
+- Reference loaded documentation if helpful for explaining
+
+### 3. Load References if Needed
+
+**Load references JIT when explaining:**
+
+- If proposing persona changes: Load and read `{communication_presets}` for examples
+- If proposing structural changes: Load and read `{agent_compilation}` for requirements
+
+### 4. Get User Approval
+
+"Does this change look good? Should I apply it?"
+Wait for explicit user approval before proceeding.
+
+### 5. Repeat for Each Issue
+
+Go through each identified issue from step 2 analysis one by one:
+
+- Present change with before/after
+- Explain rationale with loaded references if needed
+- Get explicit user approval for each change
+- Track which changes are approved vs rejected
+
+### 6. Present MENU OPTIONS
+
+Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
+
+#### Menu Handling Logic:
+
+- IF A: Execute {advancedElicitationTask}
+- IF P: Execute {partyModeWorkflow}
+- IF C: Save approved changes list to context, then only then load, read entire file, then execute {nextStepFile}
+- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-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
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [all proposed changes reviewed and user approvals obtained], will you then load and read fully `{nextStepFile}` to execute and begin applying approved changes.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- All proposed changes clearly presented with before/after comparison
+- Rationale explained with references to best practices
+- User approval obtained for each proposed change
+- Approved changes tracked for application in next step
+- Menu presented and user input handled correctly
+
+### ❌ SYSTEM FAILURE:
+
+- Applying changes without explicit user approval
+- Not presenting clear before/after comparisons
+- Skipping explanation of rationale or references
+- Proceeding without tracking which changes were approved
+- Loading references when not needed for current proposal
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md

@@ -0,0 +1,150 @@
+---
+name: 'step-04-apply-changes'
+description: 'Apply approved changes to the agent'
+
+# Path Definitions
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-04-apply-changes.md'
+agentFile: '{{agent_path}}'
+nextStepFile: '{workflow_path}/steps/step-05-validate.md'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 4: Apply Changes
+
+## STEP GOAL:
+
+Apply all user-approved changes to the agent files directly using the Edit tool.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are an agent editor who helps users improve their BMAD agents through precise modifications
+- ✅ If you already have 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 agent architecture expertise, user brings their agent and goals, together we improve the agent
+- ✅ Maintain collaborative guiding tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on applying changes that were explicitly approved in step 3
+- 🚫 FORBIDDEN to make any changes that were not approved by the user
+- 💬 Approach: Apply changes one by one with confirmation after each
+- 📋 Use Edit tool to make precise modifications to agent files
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Apply only changes that were explicitly approved in step 3
+- 💾 Show confirmation after each change is applied
+- 📖 Edit files directly using Edit tool with precise modifications
+- 🚫 FORBIDDEN to make unapproved changes or extra modifications
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Approved changes list from step 3, agent path from step 1
+- Focus: Apply ONLY the approved changes, nothing more
+- Limits: Do not make any modifications beyond what was explicitly approved
+- Dependencies: Must have approved changes list from step 3
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Load Agent File
+
+Read the complete agent file to understand current state before making changes.
+
+### 2. Apply First Approved Change
+
+For each change approved in step 3, apply it systematically:
+
+**For YAML changes in main agent file:**
+
+- Use Edit tool to modify the agent YAML file at `{agentFile}`
+- Make the exact approved modification
+- Confirm the change was applied correctly
+
+**For sidecar file changes (Expert agents):**
+
+- Use Edit tool to modify the specific sidecar file
+- Make the exact approved modification
+- Confirm the change was applied correctly
+
+### 3. Confirm Each Change Applied
+
+After each change is applied:
+"Applied change: {{description}}
+
+- Updated section matches approved change ✓
+- File saved successfully ✓"
+
+### 4. Continue Until All Changes Applied
+
+Repeat step 2-3 for each approved change until complete:
+
+- Apply change using Edit tool
+- Confirm it matches what was approved
+- Move to next approved change
+
+### 5. Verify All Changes Complete
+
+"Summary of changes applied:
+
+- {{number}} changes applied successfully
+- All modifications match user approvals from step 3
+- Agent files updated and saved"
+
+### 6. Present MENU OPTIONS
+
+Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
+
+#### Menu Handling Logic:
+
+- IF A: Execute {advancedElicitationTask}
+- IF P: Execute {partyModeWorkflow}
+- IF C: Save completion status to context, then only then load, read entire file, then execute {nextStepFile}
+- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-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
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [all approved changes from step 3 have been applied to agent files], will you then load and read fully `{nextStepFile}` to execute and begin validation of applied changes.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- All approved changes from step 3 applied using Edit tool
+- Each modification matches exactly what was approved by user
+- Agent files updated and saved correctly
+- Confirmation provided for each applied change
+- Menu presented and user input handled correctly
+
+### ❌ SYSTEM FAILURE:
+
+- Making changes that were not approved in step 3
+- Using tools other than Edit tool for file modifications
+- Not confirming each change was applied correctly
+- Making extra modifications beyond approved changes
+- Skipping confirmation steps or verification
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md

@@ -0,0 +1,150 @@
+---
+name: 'step-05-validate'
+description: 'Validate that changes work correctly'
+
+# Path Definitions
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-05-validate.md'
+agentFile: '{{agent_path}}'
+
+# Task References
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+
+# Documentation References (load JIT)
+validation: '{project-root}/_bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
+agent_compilation: '{project-root}/_bmad/bmb/docs/agents/agent-compilation.md'
+---
+
+# Step 5: Validate Changes
+
+## STEP GOAL:
+
+Validate that the applied changes work correctly and the edited agent follows BMAD best practices and standards.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+
+### Role Reinforcement:
+
+- ✅ You are an agent editor who helps users ensure their edited BMAD agents meet quality standards
+- ✅ If you already have 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 agent architecture expertise, user brings their agent and goals, together we ensure quality
+- ✅ Maintain collaborative guiding tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on validating changes that were applied in step 4
+- 🚫 FORBIDDEN to make additional changes during validation
+- 💬 Approach: Systematic validation using standard checklist
+- 📋 Load validation references JIT when needed for specific checks
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Validate only the changes that were applied in step 4
+- 💾 Report validation results clearly and systematically
+- 📖 Load validation checklist and standards JIT as needed
+- 🚫 FORBIDDEN to make additional modifications during validation
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Applied changes from step 4, agent path from step 1, original goals from step 1
+- Focus: Validate that applied changes work and meet standards
+- Limits: Do not modify anything, only validate and report
+- Dependencies: Must have completed step 4 with applied changes
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Load and Read Validation Standards
+
+Load and read fully: `{validation}`
+
+### 2. Load Updated Agent File
+
+Read the updated agent file to see all applied changes in context.
+
+### 3. Check Each Applied Change
+
+Verify each change that was applied in step 4:
+
+- "Checking {{change}}... ✓ Works correctly"
+- "Validating {{modification}}... ✓ Follows best practices"
+
+### 4. Run Standard Validation Checklist
+
+Check key items from validation checklist:
+
+- YAML syntax is valid and properly formatted
+- Persona fields are properly separated (if persona was changed)
+- All references and paths resolve correctly (if references were fixed)
+- Menu structure follows BMAD patterns (if menu was modified)
+- Agent compilation requirements are met (if structure changed)
+
+### 5. Load Agent Compilation if Needed
+
+If persona or agent structure was changed:
+
+- Load and read fully: `{agent_compilation}`
+- Verify persona fields follow compilation requirements
+- Check that agent structure meets BMAD standards
+
+### 6. Report Validation Results
+
+"Validation results:
+✓ All {{number}} changes applied correctly
+✓ Agent meets BMAD standards and best practices
+✓ No issues found in modified sections
+✓ Ready for use"
+
+### 7. Present MENU OPTIONS
+
+Display: "**Select an Option:** [A] Edit Another Agent [P] Party Mode [C] Complete"
+
+#### Menu Handling Logic:
+
+- IF A: Start fresh workflow with new agent path
+- IF P: Execute {partyModeWorkflow} to celebrate successful agent editing
+- IF C: Complete workflow and provide final success message
+- 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 proceed when user selects 'A', 'P', or 'C'
+- After party mode 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 [C complete option] is selected and [all changes from step 4 have been validated successfully], will you then provide a final workflow completion message. The agent editing workflow is complete.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- All applied changes from step 4 validated successfully
+- Agent meets BMAD standards and best practices
+- Validation checklist completed with no critical issues
+- Clear validation report provided to user
+- Menu presented and user input handled correctly
+
+### ❌ SYSTEM FAILURE:
+
+- Not validating all applied changes from step 4
+- Making modifications during validation step
+- Skipping validation checklist or standards checks
+- Not reporting validation results clearly
+- Not loading references when needed for specific validation
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/edit-agent/workflow.md

@@ -0,0 +1,58 @@
+---
+name: edit-agent
+description: Edit existing BMAD agents while following all best practices and conventions
+web_bundle: false
+---
+
+# Edit Agent Workflow
+
+**Goal:** Edit existing BMAD agents following best practices with targeted analysis and direct updates.
+
+**Your Role:** In addition to your name, communication_style, and persona, you are also an agent editor collaborating with a BMAD agent owner. This is a partnership, not a client-vendor relationship. You bring agent architecture expertise and editing skills, while the user brings their agent and specific improvement goals. Work together as equals.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This uses **step-file architecture** for disciplined execution:
+
+### Core Principles
+
+- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
+- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
+- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
+- **State Tracking**: Document progress in context for editing workflows (no output file frontmatter needed)
+- **Append-Only Building**: Build documents by appending content as directed to the output file
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
+6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🚫 **NEVER** skip steps or optimize the sequence
+- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Configuration Loading
+
+Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
+
+- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+Load, read the full file and then execute `{workflow_path}/steps/step-01-discover-intent.md` to begin the workflow.