Validate a workflow's output against its checklist/validation schema This task is invoked by workflows that have a validation step. It loads the specified checklist and validates the workflow's output file against it, reporting any issues found. Path to the validation checklist file Path to the output file to validate (auto-detected if not provided) Path to the workflow.yaml for variable context Resolve active scope before loading any paths, using the same priority chain as workflow.xml Step 0 Inline --scope argument Check if command invocation includes a scope parameter If found, store as {scope} and echo: "**[SCOPE: {scope}]** Using inline scope" Conversation memory Check if scope was set earlier in THIS conversation If remembered, use it and echo: "**[SCOPE: {scope}]** Using scope from conversation context" BMAD_SCOPE environment variable If BMAD_SCOPE is set, use its value as scope Echo: "**[SCOPE: {scope}]** Using scope from BMAD_SCOPE env var" Session context file (.bmad-scope) If exists at project root, parse YAML If enabled: false OR disabled: true → IGNORE (treat as not found) If enabled AND active_scope present → use active_scope value Echo: "**[SCOPE: {scope}]** Using scope from .bmad-scope (shared file - not parallel-safe)" If no scope from any source, echo: "**[NO SCOPE]** Running without scope isolation" Override path variables for the rest of this task: - {scope_path} = {output_folder}/{scope} - {planning_artifacts} = {scope_path}/planning-artifacts (OVERRIDE config.yaml!) - {implementation_artifacts} = {scope_path}/implementation-artifacts (OVERRIDE config.yaml!) - {scope_tests} = {scope_path}/tests config.yaml contains static pre-resolved paths from install time. When scope is active, use the overridden values above. Load the checklist file from the provided checklist_path If workflow_path provided, load workflow.yaml to get variable context Identify the output file to validate: - If output_file provided explicitly, use it (callers may pre-resolve scope paths and pass output_file directly) - Else check workflow.yaml for default_output_file; if it contains {planning_artifacts}, {implementation_artifacts}, or {scope_tests}, substitute the scoped paths resolved in Step 0 - Else ask user to specify the file to validate Load the output file content Read the checklist thoroughly to understand ALL validation criteria Identify: - Required sections that must exist - Quality criteria that must be met - Anti-patterns to check for - Completeness requirements Create a mental checklist of ALL items to verify Go through EACH checklist item systematically For each requirement: - Check if the output file satisfies it - Note any missing, incomplete, or incorrect content - Record specific line numbers or sections with issues Check for anti-patterns mentioned in the checklist Verify completeness - no placeholder text, no TODO items left Compile findings into a structured report ## Validation Report **File Validated:** {output_file} **Checklist Used:** {checklist_path} **Validation Status:** [PASS | PASS WITH WARNINGS | FAIL] ### Summary - Total checks: {count} - Passed: {passed_count} - Warnings: {warning_count} - Failed: {failed_count} ### Issues Found (if any) #### Critical Issues (Must Fix) {list critical issues with specific locations} #### Warnings (Should Review) {list warnings with recommendations} ### Recommendations {actionable recommendations for improvement} Display the validation report to user Would you like me to attempt to fix these issues? - [Y] Yes, fix the issues automatically - [N] No, I'll fix them manually - [R] Re-run validation after I make changes Attempt to fix each issue in the output file Save the corrected file Re-run validation to confirm fixes Congratulate user on passing validation Echo: "✅ Validation PASSED - output meets all checklist requirements" Never skip checklist items - validate EVERY requirement Be specific about issues - include line numbers and exact problems Provide actionable feedback - don't just say "incomplete", say what's missing Check for placeholder text like "TODO", "TBD", "FIXME", "[INSERT]"