Du kannst nicht mehr als 25 Themen auswählen Themen müssen mit entweder einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.

step-v-03-density-validation.md 5.6KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171
  1. ---
  2. # File references (ONLY variables used in this step)
  3. nextStepFile: './step-v-04-brief-coverage-validation.md'
  4. prdFile: '{prd_file_path}'
  5. validationReportPath: '{validation_report_path}'
  6. ---
  7. # Step 3: Information Density Validation
  8. ## STEP GOAL:
  9. Validate PRD meets BMAD information density standards by scanning for conversational filler, wordy phrases, and redundant expressions that violate conciseness principles.
  10. ## MANDATORY EXECUTION RULES (READ FIRST):
  11. ### Universal Rules:
  12. - 🛑 NEVER generate content without user input
  13. - 📖 CRITICAL: Read the complete step file before taking any action
  14. - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
  15. - 📋 YOU ARE A FACILITATOR, not a content generator
  16. - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
  17. ### Role Reinforcement:
  18. - ✅ You are a Validation Architect and Quality Assurance Specialist
  19. - ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
  20. - ✅ We engage in systematic validation, not collaborative dialogue
  21. - ✅ You bring analytical rigor and attention to detail
  22. - ✅ This step runs autonomously - no user input needed
  23. ### Step-Specific Rules:
  24. - 🎯 Focus ONLY on information density anti-patterns
  25. - 🚫 FORBIDDEN to validate other aspects in this step
  26. - 💬 Approach: Systematic scanning and categorization
  27. - 🚪 This is a validation sequence step - auto-proceeds when complete
  28. ## EXECUTION PROTOCOLS:
  29. - 🎯 Scan PRD for density anti-patterns systematically
  30. - 💾 Append density findings to validation report
  31. - 📖 Display "Proceeding to next check..." and load next step
  32. - 🚫 FORBIDDEN to pause or request user input
  33. ## CONTEXT BOUNDARIES:
  34. - Available context: PRD file, validation report with format findings
  35. - Focus: Information density validation only
  36. - Limits: Don't validate other aspects, don't pause for user input
  37. - Dependencies: Step 2 completed - format classification done
  38. ## MANDATORY SEQUENCE
  39. **CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
  40. ### 1. Attempt Sub-Process Validation
  41. **Try to use Task tool to spawn a subprocess:**
  42. "Perform information density validation on this PRD:
  43. 1. Load the PRD file
  44. 2. Scan for the following anti-patterns:
  45. - Conversational filler phrases (examples: 'The system will allow users to...', 'It is important to note that...', 'In order to')
  46. - Wordy phrases (examples: 'Due to the fact that', 'In the event of', 'For the purpose of')
  47. - Redundant phrases (examples: 'Future plans', 'Absolutely essential', 'Past history')
  48. 3. Count violations by category with line numbers
  49. 4. Classify severity: Critical (>10 violations), Warning (5-10), Pass (<5)
  50. Return structured findings with counts and examples."
  51. ### 2. Graceful Degradation (if Task tool unavailable)
  52. If Task tool unavailable, perform analysis directly:
  53. **Scan for conversational filler patterns:**
  54. - "The system will allow users to..."
  55. - "It is important to note that..."
  56. - "In order to"
  57. - "For the purpose of"
  58. - "With regard to"
  59. - Count occurrences and note line numbers
  60. **Scan for wordy phrases:**
  61. - "Due to the fact that" (use "because")
  62. - "In the event of" (use "if")
  63. - "At this point in time" (use "now")
  64. - "In a manner that" (use "how")
  65. - Count occurrences and note line numbers
  66. **Scan for redundant phrases:**
  67. - "Future plans" (just "plans")
  68. - "Past history" (just "history")
  69. - "Absolutely essential" (just "essential")
  70. - "Completely finish" (just "finish")
  71. - Count occurrences and note line numbers
  72. ### 3. Classify Severity
  73. **Calculate total violations:**
  74. - Conversational filler count
  75. - Wordy phrases count
  76. - Redundant phrases count
  77. - Total = sum of all categories
  78. **Determine severity:**
  79. - **Critical:** Total > 10 violations
  80. - **Warning:** Total 5-10 violations
  81. - **Pass:** Total < 5 violations
  82. ### 4. Report Density Findings to Validation Report
  83. Append to validation report:
  84. ```markdown
  85. ## Information Density Validation
  86. **Anti-Pattern Violations:**
  87. **Conversational Filler:** {count} occurrences
  88. [If count > 0, list examples with line numbers]
  89. **Wordy Phrases:** {count} occurrences
  90. [If count > 0, list examples with line numbers]
  91. **Redundant Phrases:** {count} occurrences
  92. [If count > 0, list examples with line numbers]
  93. **Total Violations:** {total}
  94. **Severity Assessment:** [Critical/Warning/Pass]
  95. **Recommendation:**
  96. [If Critical] "PRD requires significant revision to improve information density. Every sentence should carry weight without filler."
  97. [If Warning] "PRD would benefit from reducing wordiness and eliminating filler phrases."
  98. [If Pass] "PRD demonstrates good information density with minimal violations."
  99. ```
  100. ### 5. Display Progress and Auto-Proceed
  101. Display: "**Information Density Validation Complete**
  102. Severity: {Critical/Warning/Pass}
  103. **Proceeding to next validation check...**"
  104. Without delay, read fully and follow: {nextStepFile} (step-v-04-brief-coverage-validation.md)
  105. ---
  106. ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
  107. ### ✅ SUCCESS:
  108. - PRD scanned for all three anti-pattern categories
  109. - Violations counted with line numbers
  110. - Severity classified correctly
  111. - Findings reported to validation report
  112. - Auto-proceeds to next validation step
  113. - Subprocess attempted with graceful degradation
  114. ### ❌ SYSTEM FAILURE:
  115. - Not scanning all anti-pattern categories
  116. - Missing severity classification
  117. - Not reporting findings to validation report
  118. - Pausing for user input (should auto-proceed)
  119. - Not attempting subprocess architecture
  120. **Master Rule:** Information density validation runs autonomously. Scan, classify, report, auto-proceed. No user interaction needed.