You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

step-v-04-brief-coverage-validation.md 7.0KB

5 päivää sitten
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211
  1. ---
  2. # File references (ONLY variables used in this step)
  3. nextStepFile: './step-v-05-measurability-validation.md'
  4. prdFile: '{prd_file_path}'
  5. productBrief: '{product_brief_path}'
  6. validationReportPath: '{validation_report_path}'
  7. ---
  8. # Step 4: Product Brief Coverage Validation
  9. ## STEP GOAL:
  10. Validate that PRD covers all content from Product Brief (if brief was used as input), mapping brief content to PRD sections and identifying gaps.
  11. ## MANDATORY EXECUTION RULES (READ FIRST):
  12. ### Universal Rules:
  13. - 🛑 NEVER generate content without user input
  14. - 📖 CRITICAL: Read the complete step file before taking any action
  15. - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
  16. - 📋 YOU ARE A FACILITATOR, not a content generator
  17. - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
  18. ### Role Reinforcement:
  19. - ✅ You are a Validation Architect and Quality Assurance Specialist
  20. - ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
  21. - ✅ We engage in systematic validation, not collaborative dialogue
  22. - ✅ You bring analytical rigor and traceability expertise
  23. - ✅ This step runs autonomously - no user input needed
  24. ### Step-Specific Rules:
  25. - 🎯 Focus ONLY on Product Brief coverage (conditional on brief existence)
  26. - 🚫 FORBIDDEN to validate other aspects in this step
  27. - 💬 Approach: Systematic mapping and gap analysis
  28. - 🚪 This is a validation sequence step - auto-proceeds when complete
  29. ## EXECUTION PROTOCOLS:
  30. - 🎯 Check if Product Brief exists in input documents
  31. - 💬 If no brief: Skip this check and report "N/A - No Product Brief"
  32. - 🎯 If brief exists: Map brief content to PRD sections
  33. - 💾 Append coverage findings to validation report
  34. - 📖 Display "Proceeding to next check..." and load next step
  35. - 🚫 FORBIDDEN to pause or request user input
  36. ## CONTEXT BOUNDARIES:
  37. - Available context: PRD file, input documents from step 1, validation report
  38. - Focus: Product Brief coverage only (conditional)
  39. - Limits: Don't validate other aspects, conditional execution
  40. - Dependencies: Step 1 completed - input documents loaded
  41. ## MANDATORY SEQUENCE
  42. **CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
  43. ### 1. Check for Product Brief
  44. Check if Product Brief was loaded in step 1's inputDocuments:
  45. **IF no Product Brief found:**
  46. Append to validation report:
  47. ```markdown
  48. ## Product Brief Coverage
  49. **Status:** N/A - No Product Brief was provided as input
  50. ```
  51. Display: "**Product Brief Coverage: Skipped** (No Product Brief provided)
  52. **Proceeding to next validation check...**"
  53. Without delay, read fully and follow: {nextStepFile}
  54. **IF Product Brief exists:** Continue to step 2 below
  55. ### 2. Attempt Sub-Process Validation
  56. **Try to use Task tool to spawn a subprocess:**
  57. "Perform Product Brief coverage validation:
  58. 1. Load the Product Brief
  59. 2. Extract key content:
  60. - Vision statement
  61. - Target users/personas
  62. - Problem statement
  63. - Key features
  64. - Goals/objectives
  65. - Differentiators
  66. - Constraints
  67. 3. For each item, search PRD for corresponding coverage
  68. 4. Classify coverage: Fully Covered / Partially Covered / Not Found / Intentionally Excluded
  69. 5. Note any gaps with severity: Critical / Moderate / Informational
  70. Return structured coverage map with classifications."
  71. ### 3. Graceful Degradation (if Task tool unavailable)
  72. If Task tool unavailable, perform analysis directly:
  73. **Extract from Product Brief:**
  74. - Vision: What is this product?
  75. - Users: Who is it for?
  76. - Problem: What problem does it solve?
  77. - Features: What are the key capabilities?
  78. - Goals: What are the success criteria?
  79. - Differentiators: What makes it unique?
  80. **For each item, search PRD:**
  81. - Scan Executive Summary for vision
  82. - Check User Journeys or user personas
  83. - Look for problem statement
  84. - Review Functional Requirements for features
  85. - Check Success Criteria section
  86. - Search for differentiators
  87. **Classify coverage:**
  88. - **Fully Covered:** Content present and complete
  89. - **Partially Covered:** Content present but incomplete
  90. - **Not Found:** Content missing from PRD
  91. - **Intentionally Excluded:** Content explicitly out of scope
  92. ### 4. Assess Coverage and Severity
  93. **For each gap (Partially Covered or Not Found):**
  94. - Is this Critical? (Core vision, primary users, main features)
  95. - Is this Moderate? (Secondary features, some goals)
  96. - Is this Informational? (Nice-to-have features, minor details)
  97. **Note:** Some exclusions may be intentional (valid scoping decisions)
  98. ### 5. Report Coverage Findings to Validation Report
  99. Append to validation report:
  100. ```markdown
  101. ## Product Brief Coverage
  102. **Product Brief:** {brief_file_name}
  103. ### Coverage Map
  104. **Vision Statement:** [Fully/Partially/Not Found/Intentionally Excluded]
  105. [If gap: Note severity and specific missing content]
  106. **Target Users:** [Fully/Partially/Not Found/Intentionally Excluded]
  107. [If gap: Note severity and specific missing content]
  108. **Problem Statement:** [Fully/Partially/Not Found/Intentionally Excluded]
  109. [If gap: Note severity and specific missing content]
  110. **Key Features:** [Fully/Partially/Not Found/Intentionally Excluded]
  111. [If gap: List specific features with severity]
  112. **Goals/Objectives:** [Fully/Partially/Not Found/Intentionally Excluded]
  113. [If gap: Note severity and specific missing content]
  114. **Differentiators:** [Fully/Partially/Not Found/Intentionally Excluded]
  115. [If gap: Note severity and specific missing content]
  116. ### Coverage Summary
  117. **Overall Coverage:** [percentage or qualitative assessment]
  118. **Critical Gaps:** [count] [list if any]
  119. **Moderate Gaps:** [count] [list if any]
  120. **Informational Gaps:** [count] [list if any]
  121. **Recommendation:**
  122. [If critical gaps exist] "PRD should be revised to cover critical Product Brief content."
  123. [If moderate gaps] "Consider addressing moderate gaps for complete coverage."
  124. [If minimal gaps] "PRD provides good coverage of Product Brief content."
  125. ```
  126. ### 6. Display Progress and Auto-Proceed
  127. Display: "**Product Brief Coverage Validation Complete**
  128. Overall Coverage: {assessment}
  129. **Proceeding to next validation check...**"
  130. Without delay, read fully and follow: {nextStepFile} (step-v-05-measurability-validation.md)
  131. ---
  132. ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
  133. ### ✅ SUCCESS:
  134. - Checked for Product Brief existence correctly
  135. - If no brief: Reported "N/A" and skipped gracefully
  136. - If brief exists: Mapped all key brief content to PRD sections
  137. - Coverage classified appropriately (Fully/Partially/Not Found/Intentionally Excluded)
  138. - Severity assessed for gaps (Critical/Moderate/Informational)
  139. - Findings reported to validation report
  140. - Auto-proceeds to next validation step
  141. - Subprocess attempted with graceful degradation
  142. ### ❌ SYSTEM FAILURE:
  143. - Not checking for brief existence before attempting validation
  144. - If brief exists: not mapping all key content areas
  145. - Missing coverage classifications
  146. - Not reporting findings to validation report
  147. - Not auto-proceeding
  148. **Master Rule:** Product Brief coverage is conditional - skip if no brief, validate thoroughly if brief exists. Always auto-proceed.