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

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md

@@ -0,0 +1,258 @@
+---
+name: 'step-07-holistic-analysis'
+description: 'Analyze workflow flow, goal alignment, and meta-workflow failures'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-07-holistic-analysis.md'
+nextStepFile: '{workflow_path}/steps/step-08-generate-report.md'
+workflowFile: '{workflow_path}/workflow.md'
+complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name}.md'
+targetWorkflowFile: '{target_workflow_path}'
+
+# Template References
+complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
+
+# Documentation References
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+---
+
+# Step 7: Holistic Workflow Analysis
+
+## STEP GOAL:
+
+Perform comprehensive workflow analysis including flow validation, goal alignment assessment, optimization opportunities, and meta-workflow failure identification to provide complete compliance picture.
+
+## 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 a compliance validator and quality assurance specialist
+- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring holistic workflow analysis and optimization expertise
+- ✅ User brings their workflow and needs comprehensive assessment
+
+### Step-Specific Rules:
+
+- 🎯 Focus on holistic analysis beyond template compliance
+- 🚫 FORBIDDEN to skip flow validation or optimization assessment
+- 💬 Approach: Systematic end-to-end workflow analysis
+- 📋 Identify meta-workflow failures and improvement opportunities
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Analyze complete workflow flow from start to finish
+- 💾 Validate goal alignment and optimization opportunities
+- 📖 Identify what meta-workflows (create/edit) should have caught
+- 🚫 FORBIDDEN to provide superficial analysis without specific recommendations
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Complete workflow analysis from previous phases
+- Focus: Holistic workflow optimization and meta-process improvement
+- Limits: Analysis phase only, report generation comes next
+- Dependencies: Completed workflow.md and step validation phases
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Initialize Holistic Analysis
+
+"Beginning **Phase 3: Holistic Workflow Analysis**
+Target: `{target_workflow_name}`
+
+Analyzing workflow from multiple perspectives:
+
+- Flow and completion validation
+- Goal alignment assessment
+- Optimization opportunities
+- Meta-workflow failure analysis..."
+
+### 2. Workflow Flow Validation
+
+**A. Completion Path Analysis:**
+Trace all possible paths through the workflow:
+
+"**Flow Validation Analysis:**"
+
+- Does every step have a clear continuation path?
+- Do all menu options have valid destinations?
+- Are there any orphaned steps or dead ends?
+- Can the workflow always reach a successful completion?
+
+**Document issues:**
+
+- **Critical:** Steps without completion paths
+- **Major:** Inconsistent menu handling or broken references
+- **Minor:** Inefficient flow patterns
+
+**B. Sequential Logic Validation:**
+Check step sequence logic:
+
+- Does step order make logical sense?
+- Are dependencies properly structured?
+- Is information flow between steps optimal?
+- Are there unnecessary steps or missing functionality?
+
+### 3. Goal Alignment Assessment
+
+**A. Stated Goal Analysis:**
+Compare workflow.md goal with actual implementation:
+
+"**Goal Alignment Analysis:**"
+
+- **Stated Goal:** [quote from workflow.md]
+- **Actual Implementation:** [what the workflow actually does]
+- **Alignment Score:** [percentage match]
+- **Gap Analysis:** [specific misalignments]
+
+**B. User Experience Assessment:**
+Evaluate workflow from user perspective:
+
+- Is the workflow intuitive and easy to follow?
+- Are user inputs appropriately requested?
+- Is feedback clear and timely?
+- Is the workflow efficient for the stated purpose?
+
+### 4. Optimization Opportunities
+
+**A. Efficiency Analysis:**
+"**Optimization Assessment:**"
+
+- **Step Consolidation:** Could any steps be combined?
+- **Parallel Processing:** Could any operations run simultaneously?
+- **JIT Loading:** Are references loaded optimally?
+- **User Experience:** Where could user experience be improved?
+
+**B. Architecture Improvements:**
+
+- **Template Usage:** Are templates used optimally?
+- **Output Management:** Are outputs appropriate and necessary?
+- **Error Handling:** Is error handling comprehensive?
+- **Extensibility:** Can the workflow be easily extended?
+
+### 5. Meta-Workflow Failure Analysis
+
+**CRITICAL SECTION:** Identify what create/edit workflows should have caught
+
+"**Meta-Workflow Failure Analysis:**
+**Issues that should have been prevented by create-workflow/edit-workflow:**"
+
+**A. Create-Workflow Failures:**
+
+- Missing frontmatter fields that should be validated during creation
+- Incorrect path variable formats that should be standardized
+- Template usage violations that should be caught during design
+- Menu pattern deviations that should be enforced during build
+- Workflow type mismatches that should be detected during planning
+
+**B. Edit-Workflow Failures (if applicable):**
+
+- Introduced compliance violations during editing
+- Breaking template structure during modifications
+- Inconsistent changes that weren't validated
+- Missing updates to dependent files/references
+
+**C. Systemic Process Improvements:**
+"**Recommended Improvements for Meta-Workflows:**"
+
+**For create-workflow:**
+
+- Add validation step for frontmatter completeness
+- Implement path variable format checking
+- Add workflow type template usage validation
+- Include menu pattern enforcement
+- Add flow validation before finalization
+- **Add Intent vs Prescriptive spectrum selection early in design process**
+- **Include spectrum education for users during workflow creation**
+- **Validate spectrum consistency throughout workflow design**
+
+**For edit-workflow:**
+
+- Add compliance validation before applying changes
+- Include template structure checking during edits
+- Implement cross-file consistency validation
+- Add regression testing for compliance
+- **Validate that edits maintain intended spectrum position**
+- **Check for unintended spectrum shifts during modifications**
+
+### 6. Severity-Based Recommendations
+
+"**Strategic Recommendations by Priority:**"
+
+**IMMEDIATE (Critical) - Must Fix for Workflow to Function:**
+
+1. [Most critical issue with specific fix]
+2. [Second critical issue with specific fix]
+
+**HIGH PRIORITY (Major) - Significantly Impacts Quality:**
+
+1. [Major issue affecting maintainability]
+2. [Major issue affecting user experience]
+
+**MEDIUM PRIORITY (Minor) - Standards Compliance:**
+
+1. [Minor template compliance issue]
+2. [Cosmetic or consistency improvements]
+
+### 7. Continuation Confirmation
+
+"**Phase 5 Complete:** Holistic analysis finished
+
+- **Flow Validation:** [summary findings]
+- **Goal Alignment:** [alignment percentage and key gaps]
+- **Optimization Opportunities:** [number key improvements identified]
+- **Meta-Workflow Failures:** [number issues that should have been prevented]
+
+**Ready for Phase 8:** Comprehensive compliance report generation
+
+- All findings compiled into structured report
+- Severity-ranked violation list
+- Specific fix recommendations
+- Meta-workflow improvement suggestions
+
+**Select an Option:** [C] Continue to Report Generation [X] Exit"
+
+## Menu Handling Logic:
+
+- IF C: Save holistic analysis findings to report, update frontmatter, then load, read entire file, then execute {nextStepFile}
+- IF X: Save current findings and end with guidance for resuming
+- IF Any other comments or queries: respond and redisplay menu
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [C continue option] is selected and [holistic analysis complete with meta-workflow failures identified], will you then load and read fully `{nextStepFile}` to execute and begin comprehensive report generation.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Complete workflow flow validation with all paths traced
+- Goal alignment assessment with specific gap analysis
+- Optimization opportunities identified with prioritized recommendations
+- Meta-workflow failures documented with improvement suggestions
+- Strategic recommendations provided by severity priority
+- User ready for comprehensive report generation
+
+### ❌ SYSTEM FAILURE:
+
+- Skipping flow validation or goal alignment analysis
+- Not identifying meta-workflow failure opportunities
+- Failing to provide specific, actionable recommendations
+- Missing strategic prioritization of improvements
+- Providing superficial analysis without depth
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md

@@ -0,0 +1,301 @@
+---
+name: 'step-08-generate-report'
+description: 'Generate comprehensive compliance report with fix recommendations'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-08-generate-report.md'
+workflowFile: '{workflow_path}/workflow.md'
+complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name}.md'
+targetWorkflowFile: '{target_workflow_path}'
+
+# Template References
+complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
+
+# Documentation References
+stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
+---
+
+# Step 8: Comprehensive Compliance Report Generation
+
+## STEP GOAL:
+
+Generate comprehensive compliance report compiling all validation findings, provide severity-ranked fix recommendations, and offer concrete next steps for achieving full compliance.
+
+## 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
+
+### Role Reinforcement:
+
+- ✅ You are a compliance validator and quality assurance specialist
+- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring report generation and strategic recommendation expertise
+- ✅ User brings their validated workflow and needs actionable improvement plan
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on compiling comprehensive compliance report
+- 🚫 FORBIDDEN to generate report without including all findings from previous phases
+- 💬 Approach: Systematic compilation with clear, actionable recommendations
+- 📋 Ensure report is complete, accurate, and immediately useful
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Compile all findings from previous validation phases
+- 💾 Generate structured compliance report with clear sections
+- 📖 Provide severity-ranked recommendations with specific fixes
+- 🚫 FORBIDDEN to overlook any validation findings or recommendations
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Complete validation findings from all previous phases
+- Focus: Comprehensive report generation and strategic recommendations
+- Limits: Report generation only, no additional validation
+- Dependencies: Successful completion of all previous validation phases
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Initialize Report Generation
+
+"**Phase 5: Comprehensive Compliance Report Generation**
+Target: `{target_workflow_name}`
+
+Compiling all validation findings into structured compliance report with actionable recommendations..."
+
+### 2. Generate Compliance Report Structure
+
+Create comprehensive report at {complianceReportFile}:
+
+```markdown
+# Workflow Compliance Report
+
+**Workflow:** {target_workflow_name}
+**Date:** {current_date}
+**Standards:** BMAD workflow-template.md and step-template.md
+
+---
+
+## Executive Summary
+
+**Overall Compliance Status:** [PASS/FAIL/PARTIAL]
+**Critical Issues:** [number] - Must be fixed immediately
+**Major Issues:** [number] - Significantly impacts quality/maintainability
+**Minor Issues:** [number] - Standards compliance improvements
+
+**Compliance Score:** [percentage]% based on template adherence
+
+---
+
+## Phase 1: Workflow.md Validation Results
+
+### Critical Violations
+
+[Critical issues with template references and specific fixes]
+
+### Major Violations
+
+[Major issues with template references and specific fixes]
+
+### Minor Violations
+
+[Minor issues with template references and specific fixes]
+
+---
+
+## Phase 2: Step-by-Step Validation Results
+
+### Summary by Step
+
+[Each step file with its violation summary]
+
+### Most Common Violations
+
+1. [Most frequent violation type with count]
+2. [Second most frequent with count]
+3. [Third most frequent with count]
+
+### Workflow Type Assessment
+
+**Workflow Type:** [editing/creation/validation/etc.]
+**Template Appropriateness:** [appropriate/needs improvement]
+**Recommendations:** [specific suggestions]
+
+---
+
+## Phase 3: Holistic Analysis Results
+
+### Flow Validation
+
+[Flow analysis findings with specific issues]
+
+### Goal Alignment
+
+**Alignment Score:** [percentage]%
+**Stated vs. Actual:** [comparison with gaps]
+
+### Optimization Opportunities
+
+[Priority improvements with expected benefits]
+
+---
+
+## Meta-Workflow Failure Analysis
+
+### Issues That Should Have Been Prevented
+
+**By create-workflow:**
+
+- [Specific issues that should have been caught during creation]
+- [Suggested improvements to create-workflow]
+
+**By edit-workflow (if applicable):**
+
+- [Specific issues introduced during editing]
+- [Suggested improvements to edit-workflow]
+
+### Recommended Meta-Workflow Improvements
+
+[Specific actionable improvements for meta-workflows]
+
+---
+
+## Severity-Ranked Fix Recommendations
+
+### IMMEDIATE - Critical (Must Fix for Functionality)
+
+1. **[Issue Title]** - [File: filename.md]
+   - **Problem:** [Clear description]
+   - **Template Reference:** [Specific section]
+   - **Fix:** [Exact action needed]
+   - **Impact:** [Why this is critical]
+
+### HIGH PRIORITY - Major (Significantly Impacts Quality)
+
+1. **[Issue Title]** - [File: filename.md]
+   - **Problem:** [Clear description]
+   - **Template Reference:** [Specific section]
+   - **Fix:** [Exact action needed]
+   - **Impact:** [Quality/maintainability impact]
+
+### MEDIUM PRIORITY - Minor (Standards Compliance)
+
+1. **[Issue Title]** - [File: filename.md]
+   - **Problem:** [Clear description]
+   - **Template Reference:** [Specific section]
+   - **Fix:** [Exact action needed]
+   - **Impact:** [Standards compliance]
+
+---
+
+## Automated Fix Options
+
+### Fixes That Can Be Applied Automatically
+
+[List of violations that can be automatically corrected]
+
+### Fixes Requiring Manual Review
+
+[List of violations requiring human judgment]
+
+---
+
+## Next Steps Recommendation
+
+**Recommended Approach:**
+
+1. Fix all Critical issues immediately (workflow may not function)
+2. Address Major issues for reliability and maintainability
+3. Implement Minor issues for full standards compliance
+4. Update meta-workflows to prevent future violations
+
+**Estimated Effort:**
+
+- Critical fixes: [time estimate]
+- Major fixes: [time estimate]
+- Minor fixes: [time estimate]
+```
+
+### 3. Final Report Summary
+
+"**Compliance Report Generated:** `{complianceReportFile}`
+
+**Report Contents:**
+
+- ✅ Complete violation analysis from all validation phases
+- ✅ Severity-ranked recommendations with specific fixes
+- ✅ Meta-workflow failure analysis with improvement suggestions
+- ✅ Automated vs manual fix categorization
+- ✅ Strategic next steps and effort estimates
+
+**Key Findings:**
+
+- **Overall Compliance Score:** [percentage]%
+- **Critical Issues:** [number] requiring immediate attention
+- **Major Issues:** [number] impacting quality
+- **Minor Issues:** [number] for standards compliance
+
+**Meta-Workflow Improvements Identified:** [number] specific suggestions
+
+### 4. Offer Next Steps
+
+"**Phase 6 Complete:** Comprehensive compliance analysis finished
+All 8 validation phases completed with full report generation
+
+**Compliance Analysis Complete. What would you like to do next?**"
+
+**Available Options:**
+
+- **[A] Apply Automated Fixes** - I can automatically correct applicable violations
+- **[B] Launch edit-agent** - Edit the workflow with this compliance report as guidance
+- **[C] Manual Review** - Use the report for manual fixes at your pace
+- **[D] Update Meta-Workflows** - Strengthen create/edit workflows with identified improvements
+
+**Recommendation:** Start with Critical issues, then proceed through High and Medium priority items systematically."
+
+### 5. Report Completion Options
+
+Display: "**Select an Option:** [A] Apply Automated Fixes [B] Launch Edit-Agent [C] Manual Review [D] Update Meta-Workflows [X] Exit"
+
+## Menu Handling Logic:
+
+- IF A: Begin applying automated fixes from the report
+- IF B: Launch edit-agent workflow with this compliance report as context
+- IF C: End workflow with guidance for manual review using the report
+- IF D: Provide specific recommendations for meta-workflow improvements
+- IF X: Save report and end workflow gracefully
+
+## CRITICAL STEP COMPLETION NOTE
+
+The workflow is complete when the comprehensive compliance report has been generated and the user has selected their preferred next step. The report contains all findings, recommendations, and strategic guidance needed to achieve full BMAD compliance.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Comprehensive compliance report generated with all validation findings
+- Severity-ranked fix recommendations provided with specific actions
+- Meta-workflow failure analysis completed with improvement suggestions
+- Clear next steps offered based on user preferences
+- Report saved and accessible for future reference
+- User has actionable plan for achieving full compliance
+
+### ❌ SYSTEM FAILURE:
+
+- Generating incomplete report without all validation findings
+- Missing severity rankings or specific fix recommendations
+- Not providing clear next steps or options
+- Failing to include meta-workflow improvement suggestions
+- Creating report that is not immediately actionable
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/src/modules/bmb/workflows/workflow-compliance-check/templates/compliance-report.md

@@ -0,0 +1,140 @@
+# Workflow Compliance Report Template
+
+**Workflow:** {workflow_name}
+**Date:** {validation_date}
+**Standards:** BMAD workflow-template.md and step-template.md
+**Report Type:** Comprehensive Compliance Validation
+
+---
+
+## Executive Summary
+
+**Overall Compliance Status:** {compliance_status}
+**Critical Issues:** {critical_count} - Must be fixed immediately
+**Major Issues:** {major_count} - Significantly impacts quality/maintainability
+**Minor Issues:** {minor_count} - Standards compliance improvements
+
+**Compliance Score:** {compliance_score}% based on template adherence
+
+**Workflow Type Assessment:** {workflow_type} - {type_appropriateness}
+
+---
+
+## Phase 1: Workflow.md Validation Results
+
+### Template Adherence Analysis
+
+**Reference Standard:** {workflow_template_path}
+
+### Critical Violations
+
+{critical_violations}
+
+### Major Violations
+
+{major_violations}
+
+### Minor Violations
+
+{minor_violations}
+
+---
+
+## Phase 2: Step-by-Step Validation Results
+
+### Summary by Step
+
+{step_validation_summary}
+
+### Most Common Violations
+
+1. {most_common_violation_1}
+2. {most_common_violation_2}
+3. {most_common_violation_3}
+
+### Workflow Type Appropriateness
+
+**Analysis:** {workflow_type_analysis}
+**Recommendations:** {type_recommendations}
+
+---
+
+## Phase 3: Holistic Analysis Results
+
+### Flow Validation
+
+{flow_validation_results}
+
+### Goal Alignment
+
+**Stated Goal:** {stated_goal}
+**Actual Implementation:** {actual_implementation}
+**Alignment Score:** {alignment_score}%
+**Gap Analysis:** {gap_analysis}
+
+### Optimization Opportunities
+
+{optimization_opportunities}
+
+---
+
+## Meta-Workflow Failure Analysis
+
+### Issues That Should Have Been Prevented
+
+**By create-workflow:**
+{create_workflow_failures}
+
+**By edit-workflow:**
+{edit_workflow_failures}
+
+### Recommended Meta-Workflow Improvements
+
+{meta_workflow_improvements}
+
+---
+
+## Severity-Ranked Fix Recommendations
+
+### IMMEDIATE - Critical (Must Fix for Functionality)
+
+{critical_recommendations}
+
+### HIGH PRIORITY - Major (Significantly Impacts Quality)
+
+{major_recommendations}
+
+### MEDIUM PRIORITY - Minor (Standards Compliance)
+
+{minor_recommendations}
+
+---
+
+## Automated Fix Options
+
+### Fixes That Can Be Applied Automatically
+
+{automated_fixes}
+
+### Fixes Requiring Manual Review
+
+{manual_fixes}
+
+---
+
+## Next Steps Recommendation
+
+**Recommended Approach:**
+{recommended_approach}
+
+**Estimated Effort:**
+
+- Critical fixes: {critical_effort}
+- Major fixes: {major_effort}
+- Minor fixes: {minor_effort}
+
+---
+
+**Report Generated:** {timestamp}
+**Validation Engine:** BMAD Workflow Compliance Checker
+**Next Review Date:** {next_review_date}