BMAD-METHOD/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md

---
name: 'step-05-compliance-check'
description: 'Run comprehensive compliance validation on the edited workflow'

# Path Definitions
workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'

# File References
thisStepFile: '{workflow_path}/steps/step-05-compliance-check.md'
workflowFile: '{workflow_path}/workflow.md'
editedWorkflowPath: '{target_workflow_path}'
complianceCheckWorkflow: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check/workflow.md'
outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'

# Task References
complianceCheckTask: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check/workflow.md'
---

# Step 5: Compliance Validation

## STEP GOAL:

Run comprehensive compliance validation on the edited workflow using the workflow-compliance-check workflow to ensure it meets all BMAD standards before 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

### Role Reinforcement:

- ✅ You are a workflow editor 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 expertise in BMAD standards and workflow validation
- ✅ User brings their edited workflow and needs quality assurance

### Step-Specific Rules:

- 🎯 Focus only on running compliance validation on the edited workflow
- 🚫 FORBIDDEN to skip compliance validation or declare workflow complete without it
- 💬 Approach: Quality-focused, thorough, and collaborative
- 📋 Ensure user understands compliance results and next steps

## EXECUTION PROTOCOLS:

- 🎯 Launch workflow-compliance-check on the edited workflow
- 💾 Review compliance report and present findings to user
- 📖 Explain any issues found and provide fix recommendations
- 🚫 FORBIDDEN to proceed without compliance validation completion

## CONTEXT BOUNDARIES:

- Available context: Edited workflow files from previous improve step
- Focus: Compliance validation using workflow-compliance-check workflow
- Limits: Validation and reporting only, no further workflow modifications
- Dependencies: Successful workflow improvements in previous step

## Sequence of Instructions (Do not deviate, skip, or optimize)

### 1. Initialize Compliance Validation

"**Final Quality Check: Workflow Compliance Validation**

Your workflow has been edited! Now let's run a comprehensive compliance check to ensure it meets all BMAD standards and follows best practices.

This validation will check:

- Template compliance (workflow-template.md and step-template.md)
- File size optimization and markdown formatting
- CSV data file standards (if applicable)
- Intent vs Prescriptive spectrum alignment
- Web search and subprocess optimization
- Overall workflow flow and goal alignment"

### 2. Launch Compliance Check Workflow

**A. Execute Compliance Validation:**

"Running comprehensive compliance validation on your edited workflow...
Target: `{editedWorkflowPath}`

**Executing:** {complianceCheckTask}
**Validation Scope:** Full 8-phase compliance analysis
**Expected Duration:** Thorough validation may take several minutes"

**B. Monitor Validation Progress:**

Provide updates as the validation progresses:

- "✅ Workflow.md validation in progress..."
- "✅ Step-by-step compliance checking..."
- "✅ File size and formatting analysis..."
- "✅ Intent spectrum assessment..."
- "✅ Web search optimization analysis..."
- "✅ Generating comprehensive compliance report..."

### 3. Compliance Report Analysis

**A. Review Validation Results:**

"**Compliance Validation Complete!**

**Overall Assessment:** [PASS/PARTIAL/FAIL - based on compliance report]

- **Critical Issues:** [number found]
- **Major Issues:** [number found]
- **Minor Issues:** [number found]
- **Compliance Score:** [percentage]%"

**B. Present Key Findings:**

"**Key Compliance Results:**

- **Template Adherence:** [summary of template compliance]
- **File Optimization:** [file size and formatting issues]
- **Intent Spectrum:** [spectrum positioning validation]
- **Performance Optimization:** [web search and subprocess findings]
- **Overall Flow:** [workflow structure and completion validation]"

### 4. Issue Resolution Options

**A. Review Compliance Issues:**

If issues are found:
"**Issues Requiring Attention:**

**Critical Issues (Must Fix):**
[List any critical violations that prevent workflow functionality]

**Major Issues (Should Fix):**
[List major issues that impact quality or maintainability]

**Minor Issues (Nice to Fix):**
[List minor standards compliance issues]"

**B. Resolution Options:**

"**Resolution Options:**

1. **Automatic Fixes** - I can apply automated fixes where possible
2. **Manual Guidance** - I'll guide you through manual fixes step by step
3. **Return to Edit** - Go back to step 3 for additional improvements
4. **Accept as Is** - Proceed with current state (if no critical issues)
5. **Detailed Review** - Review full compliance report in detail"

### 5. Final Validation Confirmation

**A. User Choice Handling:**

Based on user selection:

- **If Automatic Fixes**: Apply fixes and re-run validation
- **If Manual Guidance**: Provide step-by-step fix instructions
- **If Return to Edit**: Load step-03-discover.md with compliance report context
- **If Accept as Is**: Confirm understanding of any remaining issues
- **If Detailed Review**: Present full compliance report

**B. Final Status Confirmation:**

"**Workflow Compliance Status:** [FINAL/PROVISIONAL]

**Completion Criteria:**

- ✅ All critical issues resolved
- ✅ Major issues addressed or accepted
- ✅ Compliance documentation complete
- ✅ User understands any remaining minor issues

**Your edited workflow is ready!**"

### 6. Completion Documentation

**A. Update Compliance Status:**

Document final compliance status in {outputFile}:

- **Validation Date:** [current date]
- **Compliance Score:** [final percentage]
- **Issues Resolved:** [summary of fixes applied]
- **Remaining Issues:** [any accepted minor issues]

**B. Final User Guidance:**

"**Next Steps for Your Edited Workflow:**

1. **Test the workflow** with real users to validate functionality
2. **Monitor performance** and consider optimization opportunities
3. **Gather feedback** for potential future improvements
4. **Consider compliance check** periodically for maintenance

**Support Resources:**

- Use workflow-compliance-check for future validations
- Refer to BMAD documentation for best practices
- Use edit-workflow again for future modifications"

### 7. Final Menu Options

"**Workflow Edit and Compliance Complete!**

**Select an Option:**

- [C] Complete - Finish workflow editing with compliance validation
- [R] Review Compliance - View detailed compliance report
- [M] More Modifications - Return to editing for additional changes
- [T] Test Workflow - Try a test run (if workflow supports testing)"

## Menu Handling Logic:

- IF C: End workflow editing successfully with compliance validation summary
- IF R: Present detailed compliance report findings
- IF M: Return to step-03-discover.md for additional improvements
- IF T: If workflow supports testing, suggest test execution method
- IF Any other comments or queries: respond and redisplay completion options

## CRITICAL STEP COMPLETION NOTE

ONLY WHEN compliance validation is complete and user confirms final workflow status, will the workflow editing process be considered successfully finished.

---

## 🚨 SYSTEM SUCCESS/FAILURE METRICS

### ✅ SUCCESS:

- Comprehensive compliance validation executed on edited workflow
- All compliance issues identified and documented with severity rankings
- User provided with clear understanding of validation results
- Appropriate resolution options offered and implemented
- Final edited workflow meets BMAD standards and is ready for production
- User satisfaction with workflow quality and compliance

### ❌ SYSTEM FAILURE:

- Skipping compliance validation before workflow completion
- Not addressing critical compliance issues found during validation
- Failing to provide clear guidance on issue resolution
- Declaring workflow complete without ensuring standards compliance
- Not documenting final compliance status for future reference

**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.