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

package/src/modules/bmb/workflows/workflow/steps-e/step-e-06-validate-after.md

@@ -0,0 +1,190 @@
+---
+name: 'step-e-06-validate-after'
+description: 'Run validation after edits and present results'
+
+# File References
+nextStepFile: './step-e-07-complete.md'
+fixStep: './step-e-03-fix-validation.md'
+editPlan: '{bmb_creations_output_folder}/edit-plan-{workflow_name}.md'
+targetWorkflowPath: '{targetWorkflowPath}'
+validationWorkflow: '../steps-v/step-01-validate.md'
+validationReport: '{targetWorkflowPath}/validation-report-{workflow_name}.md'
+---
+
+# Edit Step 6: Validate After Edit
+
+## STEP GOAL:
+
+Run validation workflow after edits are complete, present results, and offer next steps.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 📋 YOU ARE A FACILITATOR, not an autonomous editor
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Step-Specific Rules:
+
+- 🎯 Focus on running validation and presenting results
+- 💬 Explain validation outcomes clearly
+- 🚪 Route based on validation results
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Execute validation workflow
+- 💾 Present results to user
+- 📖 Offer next steps based on findings
+
+## CONTEXT BOUNDARIES:
+
+- Edits have been applied
+- Focus: Verify quality after edits
+- This is quality assurance step
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip or shortcut.
+
+### 1. Read Edit Plan
+
+**Load the editPlan:**
+Read `{editPlan}` to understand what edits were applied.
+
+### 2. Execute Validation Workflow
+
+"**Running comprehensive validation on your edited workflow...**
+
+**Target:** {targetWorkflowPath}
+**Validation scope:** Full workflow compliance check
+
+This may take a few moments..."
+
+**Load, read entirely, then execute:** {validationWorkflow}
+
+### 3. Review Validation Results
+
+**After validation completes, load the validation report:**
+
+Read `{validationReport}` and extract:
+- Overall status
+- Critical issues count
+- Warning issues count
+- New issues vs pre-existing issues
+
+### 4. Present Validation Results
+
+"**Validation Complete!**
+
+**Overall Assessment:** [PASS/PARTIAL/FAIL]
+
+**Summary:**
+| Category | Before Edits | After Edits | Change |
+|----------|--------------|-------------|--------|
+| Critical Issues | {count} | {count} | {delta} |
+| Warnings | {count} | {count} | {delta} |
+| Compliance Score | {score} | {score} | {delta} |
+
+---
+
+**New Issues Found:** {count}
+**Issues Fixed:** {count}
+**Remaining Issues:** {count}
+
+---
+
+**What would you like to do?**"
+
+### 5. Menu Options Based on Results
+
+**IF NEW CRITICAL ISSUES FOUND:**
+
+"**[F]ix new issues** - Return to fix-validation step to address new critical issues
+**[R]eview report** - See detailed validation findings
+**[C]omplete anyway** - Finish editing with remaining issues (not recommended)"
+
+#### Menu Handling Logic:
+
+- IF F: Load, read entirely, then execute {fixStep}
+- IF R: Present detailed findings from validation report, then redisplay this menu
+- IF C: Warn user, then if confirmed, load, read entirely, then execute {nextStepFile}
+- IF Any other: help user, then redisplay menu
+
+**IF NO NEW CRITICAL ISSUES (warnings OK):**
+
+"**[R]eview report** - See detailed validation findings
+**[C]omplete** - Finish editing - workflow looks good!
+**[M]ore edits** - Make additional changes"
+
+#### Menu Handling Logic (Issues Found):
+
+- IF R: Present detailed findings from validation report, then redisplay this menu
+- IF C: Load, read entirely, then execute {nextStepFile}
+- IF M: Route to step-e-02-discover-edits.md
+- IF Any other: help user, then redisplay menu
+
+**IF FULL PASS (no issues):**
+
+"**🎉 Excellent! Your workflow is fully compliant!**
+
+**[C]omplete** - Finish editing
+**[R]eview report** - See validation details
+**[M]ore edits** - Make additional changes"
+
+#### Menu Handling Logic (Full Pass):
+
+- IF C: Load, read entirely, then execute {nextStepFile}
+- IF R: Present validation summary, then redisplay this menu
+- IF M: Route to step-e-02-discover-edits.md
+- IF Any other: help user, then redisplay menu
+
+### 6. Update Edit Plan
+
+**Before routing to complete:**
+
+Update editPlan frontmatter:
+```yaml
+completionDate: '{current-date}'
+validationAfterEdit: complete
+finalValidationStatus: {status from validation report}
+remainingCriticalIssues: {count}
+remainingWarnings: {count}
+```
+
+Document in editPlan:
+```markdown
+## Final Validation
+
+**Validation Date:** {current-date}
+**Status:** {status}
+**Issues After Editing:**
+- Critical: {count}
+- Warnings: {count}
+
+**Recommendation:** {if issues remain, suggest next steps}
+```
+
+## CRITICAL STEP COMPLETION NOTE
+
+ALWAYS present validation results clearly. Route based on severity of findings. Update edit plan with final validation status before completing.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Validation workflow executed
+- Results presented clearly with before/after comparison
+- User routed appropriately based on findings
+- Edit plan updated with final status
+
+### ❌ SYSTEM FAILURE:
+
+- Not running validation
+- Not presenting results clearly
+- Routing to complete with critical issues without warning
+- Not updating edit plan
+
+**Master Rule:** Always run validation after edits. Present clear before/after comparison. Warn user about remaining issues.

package/src/modules/bmb/workflows/workflow/steps-e/step-e-07-complete.md

@@ -0,0 +1,206 @@
+---
+name: 'step-e-07-complete'
+description: 'Complete the edit session with summary and next steps'
+
+# File References
+editPlan: '{bmb_creations_output_folder}/edit-plan-{workflow_name}.md'
+targetWorkflowPath: '{targetWorkflowPath}'
+validationReport: '{targetWorkflowPath}/validation-report-{workflow_name}.md'
+---
+
+# Edit Step 7: Complete
+
+## STEP GOAL:
+
+Complete the edit session with a comprehensive summary of changes made and provide next steps guidance.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 📋 YOU ARE A FACILITATOR, not an autonomous editor
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Step-Specific Rules:
+
+- 🎯 Focus on summary and completion
+- 💬 Present clear change summary
+- 🚫 No more edits at this stage
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Generate comprehensive summary
+- 💾 Finalize edit plan document
+- 📖 Provide next steps guidance
+
+## CONTEXT BOUNDARIES:
+
+- All edits are complete
+- Focus: Summary and closure
+- This is the final step
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip or shortcut.
+
+### 1. Read Edit Plan and Validation Report
+
+**Load both files:**
+1. `{editPlan}` - Full edit session history
+2. `{validationReport}` - Final validation status (if exists)
+
+### 2. Generate Completion Summary
+
+"**━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━**
+
+# Edit Session Complete
+
+**Workflow:** {workflow_name}
+**Path:** {targetWorkflowPath}
+**Session Date:** {editSessionDate}
+
+---
+
+## Changes Made
+
+**Validation Fixes Applied:** {count}
+{list from edit plan}
+
+**Direct Changes Applied:** {count}
+{list from edit plan}
+
+**Files Modified:**
+{List all files that were changed}
+
+---
+
+## Final Validation Status
+
+**Status:** {status from report or 'Not run'}
+
+**Issues:**
+- Critical: {count}
+- Warnings: {count}
+
+---
+
+## Edit Session Summary
+
+Your workflow has been successfully edited. Here's what was accomplished:
+
+{Summarize the transformation in 2-3 sentences}
+
+**━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━**"
+
+### 3. Update Edit Plan with Completion
+
+**Append final completion section to editPlan:**
+
+```markdown
+## Completion Summary
+
+**Completed:** {current-date}
+**Session Duration:** {from start to end}
+
+**Total Edits:** {count}
+- Validation Fixes: {count}
+- Direct Changes: {count}
+
+**Files Modified:** {count}
+**Final Validation Status:** {status}
+
+**Workflow is ready for:** {use/testing/production with caveats}
+```
+
+### 4. Provide Next Steps Guidance
+
+"**Next Steps for Your Workflow:**
+
+1. **Test the workflow** - Run through the workflow end-to-end to verify changes
+2. **Get user feedback** - If this is for others, have them test it
+3. **Monitor for issues** - Watch for any problems in actual use
+4. **Re-validate periodically** - Run validation again after future changes
+
+**Resources:**
+- Edit this workflow again: Edit workflow mode
+- Run validation: Validate workflow mode
+- Build new workflow: Create workflow mode
+
+---
+
+**Thank you for using BMAD Workflow Creator!**
+
+Your edit session for **{workflow_name}** is complete. ✅"
+
+### 5. Final Confirmation
+
+"**Edit Session Complete.**
+
+**[F]inish** - End the edit session
+**[S]ave summary** - Save a copy of the edit summary to your output folder
+**[R]eview** - Review the full edit plan one more time"
+
+#### Menu Handling Logic:
+
+- IF F: End the session
+- IF S: Save edit summary to output folder, then end
+- IF R: Display full edit plan, then redisplay this menu
+- IF Any other: help user, then redisplay menu
+
+### 6. Save Summary (If Requested)
+
+**IF user selects [S]ave summary:**
+
+Create summary file at `{output_folder}/workflow-edit-summary-{workflow_name}-{date}.md`:
+
+```markdown
+# Workflow Edit Summary
+
+**Workflow:** {workflow_name}
+**Path:** {targetWorkflowPath}
+**Edit Date:** {current-date}
+
+## Changes Made
+
+{All changes from edit plan}
+
+## Files Modified
+
+{List with paths}
+
+## Validation Status
+
+{Final validation results}
+
+## Next Steps
+
+{Recommendations}
+```
+
+"**Summary saved to:** {output_folder}/workflow-edit-summary-{workflow_name}-{date}.md"
+
+## CRITICAL STEP COMPLETION NOTE
+
+This is the final step. Ensure edit plan is complete, summary is presented, and user has all information needed. End session gracefully.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Comprehensive summary presented
+- All changes documented clearly
+- Edit plan finalized
+- Next steps guidance provided
+- Session ended gracefully
+
+### ❌ SYSTEM FAILURE:
+
+- Not summarizing all changes
+- Missing files from change list
+- Not providing next steps
+- Ending without user confirmation
+
+**Master Rule:** Provide complete summary of all changes. Document everything. Give clear next steps. End on a positive note.

package/src/modules/bmb/workflows/workflow/steps-v/step-01-validate-max-mode.md

@@ -0,0 +1,109 @@
+---
+name: 'step-01-validate'
+description: 'Initialize validation: create report and check file structure & size'
+
+parallel-steps: ['./step-01b-structure.md', './step-02-frontmatter-validation.md', './step-02b-path-violations.md', './step-03-menu-validation.md' './step-04-step-type-validation.md', './step-05-output-format-validation.md', './step-06-validation-design-check.md', './step-07-instruction-style-check.md', './step-08-collaborative-experience-check.md', './step-08b-subprocess-optimization.md', './step-09-cohesive-review.md']
+nextStep: './step-10-report-complete.md'
+targetWorkflowPath: '{workflow_folder_path}'
+workflowPlanFile: '{workflow_folder_path}/workflow-plan.md'
+validationReportFile: '{workflow_folder_path}/validation-report-{datetime}.md'
+partialValidationFragmentFile: '{workflow_folder_path}/validation-report-{step-name}.md'
+stepFileRules: '../data/step-file-rules.md'
+---
+
+# Validation Step 1: File Structure & Size
+
+## STEP GOAL:
+
+To create the validation report that all parallel tasks that this will kick off will be able to report to.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 DO NOT BE LAZY - LOAD AND REVIEW EVERY FILE
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step, ensure entire file is read
+- ✅ Validation does NOT stop for user input - auto-proceed through all validation steps
+- ⚙️ If any instruction references a subprocess, subagent, or tool you do not have access to, you MUST still achieve the outcome in your main context
+
+### Step-Specific Rules:
+
+- 🎯 Create validation report with header structure using subprocess optimization when available
+- 🚫 DO NOT skip checking any file - DO NOT BE LAZY
+- 💬 Subprocess must either update validation report directly OR return structured findings to parent for aggregation
+- 🚪 This is validation - systematic and thorough
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load and check EVERY file in the workflow using subprocess optimization when available - single subprocess for bash/grep operations, separate subprocess per file for size analysis
+- 💾 Subprocesses must either update validation report OR return findings for parent aggregation
+- 📖 Save report before loading next validation step
+- 🚫 DO NOT halt for user input - validation runs to completion
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip or shortcut. IF there is no subprocess type tool available that can achieve running a process in a subprocess and handle starting multiple - let the user know they need to restart validation specifically NOT using max-parallel mode and HALT and end this workflow!
+
+### 1. Create Validation Report
+
+Create {validationReportFile} with header structure:
+
+```markdown
+---
+validationDate: [current date]
+workflowName: {new_workflow_name}
+workflowPath: {workflow_folder_path}
+validationStatus: IN_PROGRESS
+---
+
+# Validation Report: {new_workflow_name}
+
+**Validation Started:** [current date]
+**Validator:** BMAD Workflow Validation System
+**Standards Version:** BMAD Workflow Standards
+
+{{TOC}}
+
+{{#each parallel-steps}}
+## {{title}}
+
+{{results}}
+
+{{/each}}
+
+```
+
+Save the file (without the handlebars output of course) before proceeding.
+
+### 2. Launch Mass Parallelization and consolidate results!
+
+Utilizing a subprocess for each step file in {parallel-steps} - complete all of these - with the caveat indication to the subprocess that at the end of the specific step it will not on its own proceed to the nextStep file!
+
+Critically - instruct that instructions to write out or return results within each subprocess for a step file in the array MUST ensure that it writes it to {partialValidationFragmentFile} file name even though the step file it loads might indicate otherwise!
+
+Once every process has completed - there should be a separate validation file for each given step. Also - each step should return JUST its results and recommendations to you also.
+
+### 3. CRITICAL WRITES to the report.
+
+You MUST now ensure that all results are added to the final cohesive {validationReportFile} following the indicated handlebars sequence - and then after appending each subprocess report to a level 2 section - and the TOC to accurately reflect the documents state using proper markdown linking conventions to the actual heading names you created.
+
+IF a file is missing or empty from a given subprocess - but it did return to you results - you will append those results - ONLY do this if you cannot access the specific steps file produced or it is empty though. IE File from subprocess is primary, results returned from step complete are backup insurance.
+
+### 4. Proceed to Completion Step
+
+ONLY after ensuring all has been written to the final report, let the user know about the final report that is a consolidation - and they can ignore or remove the smaller files or use them as they like to focus on a specific validation (but its all in the master doc), and then proceed to {nextStep}, ensuring that in the {nextStep} it is focused on the {validationReportFile}
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Validation report created with header structure
+- EVERY section of the template is filled in with content from a subprocess that added the results of its area of expertise
+
+### ❌ SYSTEM FAILURE:
+
+- Output Report does not exist with content all filled in
+- EVERY step listed in {parallel-steps} was not executed in a subprocess and completed with its results captured in output