agentic-qe 3.4.1 → 3.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (496) hide show
  1. package/.claude/skills/.validation/README.md +111 -0
  2. package/.claude/skills/.validation/examples/chaos-engineering-output.example.json +530 -0
  3. package/.claude/skills/.validation/examples/performance-testing-output.example.json +252 -0
  4. package/.claude/skills/.validation/examples/security-testing-output.example.json +413 -0
  5. package/.claude/skills/.validation/examples/testability-scoring-output.example.json +350 -0
  6. package/.claude/skills/.validation/schemas/skill-eval.schema.json +452 -0
  7. package/.claude/skills/.validation/schemas/skill-frontmatter.schema.json +341 -0
  8. package/.claude/skills/.validation/schemas/skill-output-meta.schema.json +199 -0
  9. package/.claude/skills/.validation/schemas/skill-output.template.json +610 -0
  10. package/.claude/skills/.validation/skill-validation-mcp-integration.md +250 -0
  11. package/.claude/skills/.validation/templates/eval.template.yaml +366 -0
  12. package/.claude/skills/.validation/templates/schemas/output.json +145 -0
  13. package/.claude/skills/.validation/templates/security-testing-eval.template.yaml +725 -0
  14. package/.claude/skills/.validation/templates/skill-frontmatter.example.yaml +225 -0
  15. package/.claude/skills/.validation/templates/validate.template.sh +1060 -0
  16. package/.claude/skills/.validation/templates/validator-lib.sh +1031 -0
  17. package/.claude/skills/.validation/test-data/invalid-output.json +5 -0
  18. package/.claude/skills/.validation/test-data/minimal-output.json +9 -0
  19. package/.claude/skills/.validation/test-data/sample-output.json +73 -0
  20. package/.claude/skills/TRUST-TIERS.md +158 -0
  21. package/.claude/skills/a11y-ally/SKILL.md +1664 -1658
  22. package/.claude/skills/a11y-ally/evals/a11y-ally.yaml +376 -0
  23. package/.claude/skills/a11y-ally/schemas/output.json +549 -0
  24. package/.claude/skills/a11y-ally/scripts/validate.sh +690 -0
  25. package/.claude/skills/accessibility-testing/SKILL.md +8 -1
  26. package/.claude/skills/accessibility-testing/evals/accessibility-testing.yaml +719 -0
  27. package/.claude/skills/accessibility-testing/schemas/output.json +776 -0
  28. package/.claude/skills/accessibility-testing/scripts/validate.sh +943 -0
  29. package/.claude/skills/accessibility-testing/test-data/sample-output.json +191 -0
  30. package/.claude/skills/agentic-quality-engineering/SKILL.md +4 -0
  31. package/.claude/skills/agentic-quality-engineering/schemas/output.json +577 -0
  32. package/.claude/skills/api-testing-patterns/SKILL.md +5 -0
  33. package/.claude/skills/api-testing-patterns/evals/api-testing-patterns.yaml +696 -0
  34. package/.claude/skills/api-testing-patterns/schemas/output.json +845 -0
  35. package/.claude/skills/api-testing-patterns/scripts/validate.sh +931 -0
  36. package/.claude/skills/aqe-v2-v3-migration/schemas/output.json +513 -0
  37. package/.claude/skills/aqe-v2-v3-migration/skill.md +4 -0
  38. package/.claude/skills/brutal-honesty-review/SKILL.md +5 -0
  39. package/.claude/skills/brutal-honesty-review/schemas/output.json +291 -0
  40. package/.claude/skills/brutal-honesty-review/scripts/validate.sh +130 -0
  41. package/.claude/skills/bug-reporting-excellence/SKILL.md +5 -0
  42. package/.claude/skills/bug-reporting-excellence/schemas/output.json +288 -0
  43. package/.claude/skills/bug-reporting-excellence/scripts/validate.sh +108 -0
  44. package/.claude/skills/chaos-engineering-resilience/SKILL.md +5 -0
  45. package/.claude/skills/chaos-engineering-resilience/evals/chaos-engineering-resilience.yaml +761 -0
  46. package/.claude/skills/chaos-engineering-resilience/schemas/output.json +1205 -0
  47. package/.claude/skills/chaos-engineering-resilience/scripts/validate.sh +1107 -0
  48. package/.claude/skills/cicd-pipeline-qe-orchestrator/SKILL.md +6 -0
  49. package/.claude/skills/cicd-pipeline-qe-orchestrator/evals/cicd-pipeline-qe-orchestrator.yaml +157 -0
  50. package/.claude/skills/cicd-pipeline-qe-orchestrator/schemas/output.json +542 -0
  51. package/.claude/skills/cicd-pipeline-qe-orchestrator/scripts/validate.sh +310 -0
  52. package/.claude/skills/code-review-quality/SKILL.md +5 -0
  53. package/.claude/skills/code-review-quality/schemas/output.json +264 -0
  54. package/.claude/skills/code-review-quality/scripts/validate.sh +113 -0
  55. package/.claude/skills/compatibility-testing/evals/compatibility-testing.yaml +410 -0
  56. package/.claude/skills/compatibility-testing/schemas/output.json +551 -0
  57. package/.claude/skills/compatibility-testing/scripts/validate.sh +605 -0
  58. package/.claude/skills/compliance-testing/SKILL.md +7 -0
  59. package/.claude/skills/compliance-testing/evals/compliance-testing.yaml +1107 -0
  60. package/.claude/skills/compliance-testing/schemas/output.json +845 -0
  61. package/.claude/skills/compliance-testing/scripts/validate.sh +888 -0
  62. package/.claude/skills/consultancy-practices/SKILL.md +4 -0
  63. package/.claude/skills/consultancy-practices/schemas/output.json +282 -0
  64. package/.claude/skills/context-driven-testing/SKILL.md +3 -0
  65. package/.claude/skills/contract-testing/SKILL.md +5 -0
  66. package/.claude/skills/contract-testing/evals/contract-testing.yaml +748 -0
  67. package/.claude/skills/contract-testing/schemas/output.json +638 -0
  68. package/.claude/skills/contract-testing/scripts/validate.sh +1033 -0
  69. package/.claude/skills/database-testing/SKILL.md +5 -0
  70. package/.claude/skills/database-testing/evals/database-testing.yaml +968 -0
  71. package/.claude/skills/database-testing/schemas/output.json +1446 -0
  72. package/.claude/skills/database-testing/scripts/validate.sh +1099 -0
  73. package/.claude/skills/exploratory-testing-advanced/SKILL.md +3 -0
  74. package/.claude/skills/holistic-testing-pact/SKILL.md +3 -0
  75. package/.claude/skills/localization-testing/SKILL.md +6 -0
  76. package/.claude/skills/localization-testing/evals/localization-testing.yaml +544 -0
  77. package/.claude/skills/localization-testing/schemas/output.json +325 -0
  78. package/.claude/skills/localization-testing/scripts/validate.sh +131 -0
  79. package/.claude/skills/mobile-testing/SKILL.md +6 -0
  80. package/.claude/skills/mobile-testing/evals/mobile-testing.yaml +537 -0
  81. package/.claude/skills/mobile-testing/schemas/output.json +318 -0
  82. package/.claude/skills/mobile-testing/scripts/validate.sh +127 -0
  83. package/.claude/skills/mutation-testing/SKILL.md +8 -1
  84. package/.claude/skills/mutation-testing/evals/mutation-testing.yaml +652 -0
  85. package/.claude/skills/mutation-testing/schemas/output.json +707 -0
  86. package/.claude/skills/mutation-testing/scripts/validate.sh +992 -0
  87. package/.claude/skills/mutation-testing/test-data/sample-output.json +295 -0
  88. package/.claude/skills/n8n-expression-testing/SKILL.md +6 -0
  89. package/.claude/skills/n8n-expression-testing/evals/n8n-expression-testing.yaml +450 -0
  90. package/.claude/skills/n8n-expression-testing/schemas/output.json +369 -0
  91. package/.claude/skills/n8n-expression-testing/scripts/validate.sh +162 -0
  92. package/.claude/skills/n8n-integration-testing-patterns/SKILL.md +6 -0
  93. package/.claude/skills/n8n-integration-testing-patterns/evals/n8n-integration-testing-patterns.yaml +522 -0
  94. package/.claude/skills/n8n-integration-testing-patterns/schemas/output.json +291 -0
  95. package/.claude/skills/n8n-integration-testing-patterns/scripts/validate.sh +104 -0
  96. package/.claude/skills/n8n-security-testing/SKILL.md +6 -0
  97. package/.claude/skills/n8n-security-testing/evals/n8n-security-testing.yaml +493 -0
  98. package/.claude/skills/n8n-security-testing/schemas/output.json +293 -0
  99. package/.claude/skills/n8n-security-testing/scripts/validate.sh +120 -0
  100. package/.claude/skills/n8n-trigger-testing-strategies/SKILL.md +6 -0
  101. package/.claude/skills/n8n-trigger-testing-strategies/evals/n8n-trigger-testing-strategies.yaml +500 -0
  102. package/.claude/skills/n8n-trigger-testing-strategies/schemas/output.json +295 -0
  103. package/.claude/skills/n8n-trigger-testing-strategies/scripts/validate.sh +121 -0
  104. package/.claude/skills/n8n-workflow-testing-fundamentals/SKILL.md +6 -0
  105. package/.claude/skills/n8n-workflow-testing-fundamentals/evals/n8n-workflow-testing-fundamentals.yaml +497 -0
  106. package/.claude/skills/n8n-workflow-testing-fundamentals/schemas/output.json +254 -0
  107. package/.claude/skills/n8n-workflow-testing-fundamentals/scripts/validate.sh +126 -0
  108. package/.claude/skills/performance-analysis/SKILL.md +6 -0
  109. package/.claude/skills/performance-analysis/evals/performance-analysis.yaml +144 -0
  110. package/.claude/skills/performance-analysis/schemas/output.json +588 -0
  111. package/.claude/skills/performance-analysis/scripts/validate.sh +63 -0
  112. package/.claude/skills/performance-testing/SKILL.md +5 -0
  113. package/.claude/skills/performance-testing/evals/performance-testing.yaml +772 -0
  114. package/.claude/skills/performance-testing/schemas/output.json +1184 -0
  115. package/.claude/skills/performance-testing/scripts/validate.sh +1090 -0
  116. package/.claude/skills/qcsd-ideation-swarm/SKILL.md +1759 -1753
  117. package/.claude/skills/qcsd-ideation-swarm/evals/qcsd-ideation-swarm.yaml +138 -0
  118. package/.claude/skills/qcsd-ideation-swarm/schemas/output.json +568 -0
  119. package/.claude/skills/qcsd-ideation-swarm/scripts/validate.sh +56 -0
  120. package/.claude/skills/qe-chaos-resilience/SKILL.md +6 -0
  121. package/.claude/skills/qe-chaos-resilience/evals/qe-chaos-resilience.yaml +443 -0
  122. package/.claude/skills/qe-chaos-resilience/schemas/output.json +314 -0
  123. package/.claude/skills/qe-chaos-resilience/scripts/validate.sh +401 -0
  124. package/.claude/skills/qe-code-intelligence/SKILL.md +6 -0
  125. package/.claude/skills/qe-code-intelligence/evals/qe-code-intelligence.yaml +459 -0
  126. package/.claude/skills/qe-code-intelligence/schemas/output.json +315 -0
  127. package/.claude/skills/qe-code-intelligence/scripts/validate.sh +408 -0
  128. package/.claude/skills/qe-contract-testing/SKILL.md +6 -0
  129. package/.claude/skills/qe-contract-testing/evals/qe-contract-testing.yaml +513 -0
  130. package/.claude/skills/qe-contract-testing/schemas/output.json +295 -0
  131. package/.claude/skills/qe-contract-testing/scripts/validate.sh +421 -0
  132. package/.claude/skills/qe-coverage-analysis/SKILL.md +6 -0
  133. package/.claude/skills/qe-coverage-analysis/evals/qe-coverage-analysis.yaml +494 -0
  134. package/.claude/skills/qe-coverage-analysis/schemas/output.json +286 -0
  135. package/.claude/skills/qe-coverage-analysis/scripts/validate.sh +453 -0
  136. package/.claude/skills/qe-defect-intelligence/SKILL.md +6 -0
  137. package/.claude/skills/qe-defect-intelligence/evals/qe-defect-intelligence.yaml +511 -0
  138. package/.claude/skills/qe-defect-intelligence/schemas/output.json +283 -0
  139. package/.claude/skills/qe-defect-intelligence/scripts/validate.sh +466 -0
  140. package/.claude/skills/qe-iterative-loop/SKILL.md +445 -440
  141. package/.claude/skills/qe-iterative-loop/schemas/output.json +264 -0
  142. package/.claude/skills/qe-iterative-loop/scripts/validate.sh +474 -0
  143. package/.claude/skills/qe-learning-optimization/SKILL.md +6 -0
  144. package/.claude/skills/qe-learning-optimization/evals/qe-learning-optimization.yaml +144 -0
  145. package/.claude/skills/qe-learning-optimization/schemas/output.json +288 -0
  146. package/.claude/skills/qe-learning-optimization/scripts/validate.sh +56 -0
  147. package/.claude/skills/qe-quality-assessment/SKILL.md +6 -0
  148. package/.claude/skills/qe-quality-assessment/evals/qe-quality-assessment.yaml +506 -0
  149. package/.claude/skills/qe-quality-assessment/schemas/output.json +550 -0
  150. package/.claude/skills/qe-quality-assessment/scripts/validate.sh +352 -0
  151. package/.claude/skills/qe-requirements-validation/SKILL.md +6 -0
  152. package/.claude/skills/qe-requirements-validation/evals/qe-requirements-validation.yaml +598 -0
  153. package/.claude/skills/qe-requirements-validation/schemas/output.json +587 -0
  154. package/.claude/skills/qe-requirements-validation/scripts/validate.sh +275 -0
  155. package/.claude/skills/qe-security-compliance/SKILL.md +6 -0
  156. package/.claude/skills/qe-security-compliance/evals/qe-security-compliance.yaml +595 -0
  157. package/.claude/skills/qe-security-compliance/schemas/output.json +498 -0
  158. package/.claude/skills/qe-security-compliance/scripts/validate.sh +305 -0
  159. package/.claude/skills/qe-test-execution/SKILL.md +6 -0
  160. package/.claude/skills/qe-test-execution/evals/qe-test-execution.yaml +607 -0
  161. package/.claude/skills/qe-test-execution/schemas/output.json +529 -0
  162. package/.claude/skills/qe-test-execution/scripts/validate.sh +323 -0
  163. package/.claude/skills/qe-test-generation/SKILL.md +6 -0
  164. package/.claude/skills/qe-test-generation/evals/qe-test-generation.yaml +148 -0
  165. package/.claude/skills/qe-test-generation/schemas/output.json +439 -0
  166. package/.claude/skills/qe-test-generation/scripts/validate.sh +56 -0
  167. package/.claude/skills/qe-visual-accessibility/SKILL.md +6 -0
  168. package/.claude/skills/qe-visual-accessibility/evals/qe-visual-accessibility.yaml +142 -0
  169. package/.claude/skills/qe-visual-accessibility/schemas/output.json +491 -0
  170. package/.claude/skills/qe-visual-accessibility/scripts/validate.sh +56 -0
  171. package/.claude/skills/quality-metrics/SKILL.md +6 -0
  172. package/.claude/skills/quality-metrics/evals/quality-metrics.yaml +494 -0
  173. package/.claude/skills/quality-metrics/schemas/output.json +403 -0
  174. package/.claude/skills/quality-metrics/scripts/validate.sh +434 -0
  175. package/.claude/skills/refactoring-patterns/SKILL.md +5 -0
  176. package/.claude/skills/refactoring-patterns/schemas/output.json +475 -0
  177. package/.claude/skills/refactoring-patterns/scripts/validate.sh +241 -0
  178. package/.claude/skills/regression-testing/SKILL.md +6 -0
  179. package/.claude/skills/regression-testing/evals/regression-testing.yaml +504 -0
  180. package/.claude/skills/regression-testing/schemas/output.json +311 -0
  181. package/.claude/skills/regression-testing/scripts/validate.sh +130 -0
  182. package/.claude/skills/risk-based-testing/SKILL.md +6 -0
  183. package/.claude/skills/risk-based-testing/evals/risk-based-testing.yaml +141 -0
  184. package/.claude/skills/risk-based-testing/schemas/output.json +480 -0
  185. package/.claude/skills/risk-based-testing/scripts/validate.sh +56 -0
  186. package/.claude/skills/security-testing/SKILL.md +5 -0
  187. package/.claude/skills/security-testing/evals/security-testing.yaml +789 -0
  188. package/.claude/skills/security-testing/schemas/output.json +879 -0
  189. package/.claude/skills/security-testing/scripts/validate.sh +967 -0
  190. package/.claude/skills/security-visual-testing/SKILL.md +223 -217
  191. package/.claude/skills/security-visual-testing/evals/security-visual-testing.yaml +163 -0
  192. package/.claude/skills/security-visual-testing/schemas/output.json +486 -0
  193. package/.claude/skills/security-visual-testing/scripts/validate.sh +748 -0
  194. package/.claude/skills/sherlock-review/SKILL.md +5 -0
  195. package/.claude/skills/sherlock-review/schemas/output.json +297 -0
  196. package/.claude/skills/sherlock-review/scripts/validate.sh +115 -0
  197. package/.claude/skills/shift-left-testing/SKILL.md +6 -0
  198. package/.claude/skills/shift-left-testing/evals/shift-left-testing.yaml +145 -0
  199. package/.claude/skills/shift-left-testing/schemas/output.json +459 -0
  200. package/.claude/skills/shift-left-testing/scripts/validate.sh +56 -0
  201. package/.claude/skills/shift-right-testing/SKILL.md +6 -0
  202. package/.claude/skills/shift-right-testing/evals/shift-right-testing.yaml +147 -0
  203. package/.claude/skills/shift-right-testing/schemas/output.json +418 -0
  204. package/.claude/skills/shift-right-testing/scripts/validate.sh +56 -0
  205. package/.claude/skills/six-thinking-hats/SKILL.md +3 -0
  206. package/.claude/skills/tdd-london-chicago/SKILL.md +5 -0
  207. package/.claude/skills/tdd-london-chicago/schemas/output.json +444 -0
  208. package/.claude/skills/tdd-london-chicago/scripts/validate.sh +214 -0
  209. package/.claude/skills/technical-writing/SKILL.md +4 -0
  210. package/.claude/skills/technical-writing/schemas/output.json +268 -0
  211. package/.claude/skills/test-automation-strategy/SKILL.md +6 -0
  212. package/.claude/skills/test-automation-strategy/evals/test-automation-strategy.yaml +148 -0
  213. package/.claude/skills/test-automation-strategy/schemas/output.json +444 -0
  214. package/.claude/skills/test-automation-strategy/scripts/validate.sh +195 -0
  215. package/.claude/skills/test-data-management/SKILL.md +6 -0
  216. package/.claude/skills/test-data-management/evals/test-data-management.yaml +504 -0
  217. package/.claude/skills/test-data-management/schemas/output.json +284 -0
  218. package/.claude/skills/test-data-management/scripts/validate.sh +137 -0
  219. package/.claude/skills/test-design-techniques/SKILL.md +6 -0
  220. package/.claude/skills/test-design-techniques/evals/test-design-techniques.yaml +142 -0
  221. package/.claude/skills/test-design-techniques/schemas/output.json +295 -0
  222. package/.claude/skills/test-design-techniques/scripts/validate.sh +91 -0
  223. package/.claude/skills/test-environment-management/SKILL.md +4 -0
  224. package/.claude/skills/test-environment-management/schemas/output.json +310 -0
  225. package/.claude/skills/test-reporting-analytics/SKILL.md +6 -0
  226. package/.claude/skills/test-reporting-analytics/evals/test-reporting-analytics.yaml +155 -0
  227. package/.claude/skills/test-reporting-analytics/schemas/output.json +329 -0
  228. package/.claude/skills/test-reporting-analytics/scripts/validate.sh +77 -0
  229. package/.claude/skills/testability-scoring/SKILL.md +5 -0
  230. package/.claude/skills/testability-scoring/evals/testability-scoring.yaml +814 -0
  231. package/.claude/skills/testability-scoring/schemas/output.json +606 -0
  232. package/.claude/skills/testability-scoring/scripts/validate.sh +891 -0
  233. package/.claude/skills/trust-tier-manifest.json +2333 -0
  234. package/.claude/skills/verification-quality/SKILL.md +6 -0
  235. package/.claude/skills/verification-quality/evals/verification-quality.yaml +150 -0
  236. package/.claude/skills/verification-quality/schemas/output.json +432 -0
  237. package/.claude/skills/verification-quality/scripts/validate.sh +77 -0
  238. package/.claude/skills/visual-testing-advanced/SKILL.md +6 -0
  239. package/.claude/skills/visual-testing-advanced/evals/visual-testing-advanced.yaml +154 -0
  240. package/.claude/skills/visual-testing-advanced/schemas/output.json +294 -0
  241. package/.claude/skills/visual-testing-advanced/scripts/validate.sh +77 -0
  242. package/.claude/skills/xp-practices/SKILL.md +3 -0
  243. package/README.md +39 -2
  244. package/package.json +4 -1
  245. package/scripts/run-skill-eval.ts +1097 -0
  246. package/scripts/test-schema-validation.js +301 -0
  247. package/scripts/update-skill-manifest.ts +751 -0
  248. package/scripts/validate-skill-frontmatter.js +141 -0
  249. package/v3/CHANGELOG.md +21 -0
  250. package/v3/README.md +43 -3
  251. package/v3/assets/agents/v3/qe-test-idea-rewriter.md +375 -375
  252. package/v3/assets/skills/.validation/README.md +111 -0
  253. package/v3/assets/skills/.validation/examples/chaos-engineering-output.example.json +530 -0
  254. package/v3/assets/skills/.validation/examples/performance-testing-output.example.json +252 -0
  255. package/v3/assets/skills/.validation/examples/security-testing-output.example.json +413 -0
  256. package/v3/assets/skills/.validation/examples/testability-scoring-output.example.json +350 -0
  257. package/v3/assets/skills/.validation/schemas/skill-eval.schema.json +452 -0
  258. package/v3/assets/skills/.validation/schemas/skill-frontmatter.schema.json +341 -0
  259. package/v3/assets/skills/.validation/schemas/skill-output-meta.schema.json +199 -0
  260. package/v3/assets/skills/.validation/schemas/skill-output.template.json +610 -0
  261. package/v3/assets/skills/.validation/skill-validation-mcp-integration.md +250 -0
  262. package/v3/assets/skills/.validation/templates/eval.template.yaml +366 -0
  263. package/v3/assets/skills/.validation/templates/schemas/output.json +145 -0
  264. package/v3/assets/skills/.validation/templates/security-testing-eval.template.yaml +725 -0
  265. package/v3/assets/skills/.validation/templates/skill-frontmatter.example.yaml +225 -0
  266. package/v3/assets/skills/.validation/templates/validate.template.sh +1060 -0
  267. package/v3/assets/skills/.validation/templates/validator-lib.sh +1031 -0
  268. package/v3/assets/skills/.validation/test-data/invalid-output.json +5 -0
  269. package/v3/assets/skills/.validation/test-data/minimal-output.json +9 -0
  270. package/v3/assets/skills/.validation/test-data/sample-output.json +73 -0
  271. package/v3/assets/skills/accessibility-testing/SKILL.md +8 -1
  272. package/v3/assets/skills/accessibility-testing/evals/accessibility-testing.yaml +719 -0
  273. package/v3/assets/skills/accessibility-testing/schemas/output.json +776 -0
  274. package/v3/assets/skills/accessibility-testing/scripts/validate.sh +943 -0
  275. package/v3/assets/skills/accessibility-testing/test-data/sample-output.json +191 -0
  276. package/v3/assets/skills/agentic-quality-engineering/SKILL.md +4 -0
  277. package/v3/assets/skills/agentic-quality-engineering/schemas/output.json +577 -0
  278. package/v3/assets/skills/api-testing-patterns/SKILL.md +5 -0
  279. package/v3/assets/skills/api-testing-patterns/evals/api-testing-patterns.yaml +696 -0
  280. package/v3/assets/skills/api-testing-patterns/schemas/output.json +845 -0
  281. package/v3/assets/skills/api-testing-patterns/scripts/validate.sh +931 -0
  282. package/v3/assets/skills/aqe-v2-v3-migration/schemas/output.json +513 -0
  283. package/v3/assets/skills/aqe-v2-v3-migration/skill.md +20 -16
  284. package/v3/assets/skills/bug-reporting-excellence/SKILL.md +5 -0
  285. package/v3/assets/skills/bug-reporting-excellence/schemas/output.json +288 -0
  286. package/v3/assets/skills/bug-reporting-excellence/scripts/validate.sh +108 -0
  287. package/v3/assets/skills/chaos-engineering-resilience/SKILL.md +5 -0
  288. package/v3/assets/skills/chaos-engineering-resilience/evals/chaos-engineering-resilience.yaml +761 -0
  289. package/v3/assets/skills/chaos-engineering-resilience/schemas/output.json +1205 -0
  290. package/v3/assets/skills/chaos-engineering-resilience/scripts/validate.sh +1107 -0
  291. package/v3/assets/skills/code-review-quality/SKILL.md +5 -0
  292. package/v3/assets/skills/code-review-quality/schemas/output.json +264 -0
  293. package/v3/assets/skills/code-review-quality/scripts/validate.sh +113 -0
  294. package/v3/assets/skills/compatibility-testing/evals/compatibility-testing.yaml +410 -0
  295. package/v3/assets/skills/compatibility-testing/schemas/output.json +551 -0
  296. package/v3/assets/skills/compatibility-testing/scripts/validate.sh +605 -0
  297. package/v3/assets/skills/compliance-testing/SKILL.md +7 -0
  298. package/v3/assets/skills/compliance-testing/evals/compliance-testing.yaml +1107 -0
  299. package/v3/assets/skills/compliance-testing/schemas/output.json +845 -0
  300. package/v3/assets/skills/compliance-testing/scripts/validate.sh +888 -0
  301. package/v3/assets/skills/consultancy-practices/SKILL.md +4 -0
  302. package/v3/assets/skills/consultancy-practices/schemas/output.json +282 -0
  303. package/v3/assets/skills/context-driven-testing/SKILL.md +3 -0
  304. package/v3/assets/skills/contract-testing/SKILL.md +5 -0
  305. package/v3/assets/skills/contract-testing/evals/contract-testing.yaml +748 -0
  306. package/v3/assets/skills/contract-testing/schemas/output.json +638 -0
  307. package/v3/assets/skills/contract-testing/scripts/validate.sh +1033 -0
  308. package/v3/assets/skills/database-testing/SKILL.md +5 -0
  309. package/v3/assets/skills/database-testing/evals/database-testing.yaml +968 -0
  310. package/v3/assets/skills/database-testing/schemas/output.json +1446 -0
  311. package/v3/assets/skills/database-testing/scripts/validate.sh +1099 -0
  312. package/v3/assets/skills/exploratory-testing-advanced/SKILL.md +3 -0
  313. package/v3/assets/skills/holistic-testing-pact/SKILL.md +3 -0
  314. package/v3/assets/skills/localization-testing/SKILL.md +6 -0
  315. package/v3/assets/skills/localization-testing/evals/localization-testing.yaml +544 -0
  316. package/v3/assets/skills/localization-testing/schemas/output.json +325 -0
  317. package/v3/assets/skills/localization-testing/scripts/validate.sh +131 -0
  318. package/v3/assets/skills/mobile-testing/SKILL.md +6 -0
  319. package/v3/assets/skills/mobile-testing/evals/mobile-testing.yaml +537 -0
  320. package/v3/assets/skills/mobile-testing/schemas/output.json +318 -0
  321. package/v3/assets/skills/mobile-testing/scripts/validate.sh +127 -0
  322. package/v3/assets/skills/mutation-testing/SKILL.md +8 -1
  323. package/v3/assets/skills/mutation-testing/evals/mutation-testing.yaml +652 -0
  324. package/v3/assets/skills/mutation-testing/schemas/output.json +707 -0
  325. package/v3/assets/skills/mutation-testing/scripts/validate.sh +992 -0
  326. package/v3/assets/skills/mutation-testing/test-data/sample-output.json +295 -0
  327. package/v3/assets/skills/n8n-expression-testing/scripts/validate.sh +162 -0
  328. package/v3/assets/skills/n8n-integration-testing-patterns/scripts/validate.sh +104 -0
  329. package/v3/assets/skills/n8n-security-testing/scripts/validate.sh +120 -0
  330. package/v3/assets/skills/n8n-trigger-testing-strategies/scripts/validate.sh +121 -0
  331. package/v3/assets/skills/n8n-workflow-testing-fundamentals/scripts/validate.sh +126 -0
  332. package/v3/assets/skills/performance-testing/SKILL.md +5 -0
  333. package/v3/assets/skills/performance-testing/evals/performance-testing.yaml +772 -0
  334. package/v3/assets/skills/performance-testing/schemas/output.json +1184 -0
  335. package/v3/assets/skills/performance-testing/scripts/validate.sh +1090 -0
  336. package/v3/assets/skills/qe-chaos-resilience/SKILL.md +6 -0
  337. package/v3/assets/skills/qe-chaos-resilience/evals/qe-chaos-resilience.yaml +443 -0
  338. package/v3/assets/skills/qe-chaos-resilience/schemas/output.json +314 -0
  339. package/v3/assets/skills/qe-chaos-resilience/scripts/validate.sh +401 -0
  340. package/v3/assets/skills/qe-code-intelligence/SKILL.md +6 -0
  341. package/v3/assets/skills/qe-code-intelligence/evals/qe-code-intelligence.yaml +459 -0
  342. package/v3/assets/skills/qe-code-intelligence/schemas/output.json +315 -0
  343. package/v3/assets/skills/qe-code-intelligence/scripts/validate.sh +408 -0
  344. package/v3/assets/skills/qe-contract-testing/SKILL.md +6 -0
  345. package/v3/assets/skills/qe-contract-testing/evals/qe-contract-testing.yaml +513 -0
  346. package/v3/assets/skills/qe-contract-testing/schemas/output.json +295 -0
  347. package/v3/assets/skills/qe-contract-testing/scripts/validate.sh +421 -0
  348. package/v3/assets/skills/qe-coverage-analysis/SKILL.md +6 -0
  349. package/v3/assets/skills/qe-coverage-analysis/evals/qe-coverage-analysis.yaml +494 -0
  350. package/v3/assets/skills/qe-coverage-analysis/schemas/output.json +286 -0
  351. package/v3/assets/skills/qe-coverage-analysis/scripts/validate.sh +453 -0
  352. package/v3/assets/skills/qe-defect-intelligence/SKILL.md +6 -0
  353. package/v3/assets/skills/qe-defect-intelligence/evals/qe-defect-intelligence.yaml +511 -0
  354. package/v3/assets/skills/qe-defect-intelligence/schemas/output.json +283 -0
  355. package/v3/assets/skills/qe-defect-intelligence/scripts/validate.sh +466 -0
  356. package/v3/assets/skills/qe-iterative-loop/SKILL.md +445 -443
  357. package/v3/assets/skills/qe-iterative-loop/schemas/output.json +264 -0
  358. package/v3/assets/skills/qe-iterative-loop/scripts/validate.sh +474 -0
  359. package/v3/assets/skills/qe-learning-optimization/SKILL.md +6 -0
  360. package/v3/assets/skills/qe-learning-optimization/evals/qe-learning-optimization.yaml +144 -0
  361. package/v3/assets/skills/qe-learning-optimization/schemas/output.json +288 -0
  362. package/v3/assets/skills/qe-learning-optimization/scripts/validate.sh +56 -0
  363. package/v3/assets/skills/qe-quality-assessment/SKILL.md +6 -0
  364. package/v3/assets/skills/qe-quality-assessment/evals/qe-quality-assessment.yaml +506 -0
  365. package/v3/assets/skills/qe-quality-assessment/schemas/output.json +550 -0
  366. package/v3/assets/skills/qe-quality-assessment/scripts/validate.sh +352 -0
  367. package/v3/assets/skills/qe-requirements-validation/SKILL.md +6 -0
  368. package/v3/assets/skills/qe-requirements-validation/evals/qe-requirements-validation.yaml +598 -0
  369. package/v3/assets/skills/qe-requirements-validation/schemas/output.json +587 -0
  370. package/v3/assets/skills/qe-requirements-validation/scripts/validate.sh +275 -0
  371. package/v3/assets/skills/qe-security-compliance/SKILL.md +6 -0
  372. package/v3/assets/skills/qe-security-compliance/evals/qe-security-compliance.yaml +595 -0
  373. package/v3/assets/skills/qe-security-compliance/schemas/output.json +498 -0
  374. package/v3/assets/skills/qe-security-compliance/scripts/validate.sh +305 -0
  375. package/v3/assets/skills/qe-test-execution/SKILL.md +6 -0
  376. package/v3/assets/skills/qe-test-execution/evals/qe-test-execution.yaml +607 -0
  377. package/v3/assets/skills/qe-test-execution/schemas/output.json +529 -0
  378. package/v3/assets/skills/qe-test-execution/scripts/validate.sh +323 -0
  379. package/v3/assets/skills/qe-test-generation/SKILL.md +6 -0
  380. package/v3/assets/skills/qe-test-generation/evals/qe-test-generation.yaml +148 -0
  381. package/v3/assets/skills/qe-test-generation/schemas/output.json +439 -0
  382. package/v3/assets/skills/qe-test-generation/scripts/validate.sh +56 -0
  383. package/v3/assets/skills/qe-visual-accessibility/SKILL.md +6 -0
  384. package/v3/assets/skills/qe-visual-accessibility/evals/qe-visual-accessibility.yaml +142 -0
  385. package/v3/assets/skills/qe-visual-accessibility/schemas/output.json +491 -0
  386. package/v3/assets/skills/qe-visual-accessibility/scripts/validate.sh +56 -0
  387. package/v3/assets/skills/quality-metrics/SKILL.md +6 -0
  388. package/v3/assets/skills/quality-metrics/evals/quality-metrics.yaml +494 -0
  389. package/v3/assets/skills/quality-metrics/schemas/output.json +403 -0
  390. package/v3/assets/skills/quality-metrics/scripts/validate.sh +434 -0
  391. package/v3/assets/skills/refactoring-patterns/SKILL.md +5 -0
  392. package/v3/assets/skills/refactoring-patterns/schemas/output.json +475 -0
  393. package/v3/assets/skills/refactoring-patterns/scripts/validate.sh +241 -0
  394. package/v3/assets/skills/regression-testing/SKILL.md +6 -0
  395. package/v3/assets/skills/regression-testing/evals/regression-testing.yaml +504 -0
  396. package/v3/assets/skills/regression-testing/schemas/output.json +311 -0
  397. package/v3/assets/skills/regression-testing/scripts/validate.sh +130 -0
  398. package/v3/assets/skills/risk-based-testing/SKILL.md +6 -0
  399. package/v3/assets/skills/risk-based-testing/evals/risk-based-testing.yaml +141 -0
  400. package/v3/assets/skills/risk-based-testing/schemas/output.json +480 -0
  401. package/v3/assets/skills/risk-based-testing/scripts/validate.sh +56 -0
  402. package/v3/assets/skills/security-testing/SKILL.md +5 -0
  403. package/v3/assets/skills/security-testing/evals/security-testing.yaml +789 -0
  404. package/v3/assets/skills/security-testing/schemas/output.json +879 -0
  405. package/v3/assets/skills/security-testing/scripts/validate.sh +967 -0
  406. package/v3/assets/skills/shift-left-testing/SKILL.md +6 -0
  407. package/v3/assets/skills/shift-left-testing/evals/shift-left-testing.yaml +145 -0
  408. package/v3/assets/skills/shift-left-testing/schemas/output.json +459 -0
  409. package/v3/assets/skills/shift-left-testing/scripts/validate.sh +56 -0
  410. package/v3/assets/skills/shift-right-testing/SKILL.md +6 -0
  411. package/v3/assets/skills/shift-right-testing/evals/shift-right-testing.yaml +147 -0
  412. package/v3/assets/skills/shift-right-testing/schemas/output.json +418 -0
  413. package/v3/assets/skills/shift-right-testing/scripts/validate.sh +56 -0
  414. package/v3/assets/skills/six-thinking-hats/SKILL.md +3 -0
  415. package/v3/assets/skills/tdd-london-chicago/SKILL.md +5 -0
  416. package/v3/assets/skills/tdd-london-chicago/schemas/output.json +444 -0
  417. package/v3/assets/skills/tdd-london-chicago/scripts/validate.sh +214 -0
  418. package/v3/assets/skills/technical-writing/SKILL.md +4 -0
  419. package/v3/assets/skills/technical-writing/schemas/output.json +268 -0
  420. package/v3/assets/skills/test-automation-strategy/SKILL.md +6 -0
  421. package/v3/assets/skills/test-automation-strategy/evals/test-automation-strategy.yaml +148 -0
  422. package/v3/assets/skills/test-automation-strategy/schemas/output.json +444 -0
  423. package/v3/assets/skills/test-automation-strategy/scripts/validate.sh +195 -0
  424. package/v3/assets/skills/test-data-management/SKILL.md +6 -0
  425. package/v3/assets/skills/test-data-management/evals/test-data-management.yaml +504 -0
  426. package/v3/assets/skills/test-data-management/schemas/output.json +284 -0
  427. package/v3/assets/skills/test-data-management/scripts/validate.sh +137 -0
  428. package/v3/assets/skills/test-design-techniques/SKILL.md +6 -0
  429. package/v3/assets/skills/test-design-techniques/evals/test-design-techniques.yaml +142 -0
  430. package/v3/assets/skills/test-design-techniques/schemas/output.json +295 -0
  431. package/v3/assets/skills/test-design-techniques/scripts/validate.sh +91 -0
  432. package/v3/assets/skills/test-environment-management/SKILL.md +4 -0
  433. package/v3/assets/skills/test-environment-management/schemas/output.json +310 -0
  434. package/v3/assets/skills/test-reporting-analytics/SKILL.md +6 -0
  435. package/v3/assets/skills/test-reporting-analytics/evals/test-reporting-analytics.yaml +155 -0
  436. package/v3/assets/skills/test-reporting-analytics/schemas/output.json +329 -0
  437. package/v3/assets/skills/test-reporting-analytics/scripts/validate.sh +77 -0
  438. package/v3/assets/skills/verification-quality/SKILL.md +6 -0
  439. package/v3/assets/skills/verification-quality/evals/verification-quality.yaml +150 -0
  440. package/v3/assets/skills/verification-quality/schemas/output.json +432 -0
  441. package/v3/assets/skills/verification-quality/scripts/validate.sh +77 -0
  442. package/v3/assets/skills/visual-testing-advanced/SKILL.md +6 -0
  443. package/v3/assets/skills/visual-testing-advanced/evals/visual-testing-advanced.yaml +154 -0
  444. package/v3/assets/skills/visual-testing-advanced/schemas/output.json +294 -0
  445. package/v3/assets/skills/visual-testing-advanced/scripts/validate.sh +77 -0
  446. package/v3/assets/skills/xp-practices/SKILL.md +3 -0
  447. package/v3/assets/templates/validation-report.md.hbs +139 -0
  448. package/v3/assets/templates/validation-summary.json +56 -0
  449. package/v3/dist/cli/bundle.js +7368 -3418
  450. package/v3/dist/cli/commands/eval.d.ts +18 -0
  451. package/v3/dist/cli/commands/eval.d.ts.map +1 -0
  452. package/v3/dist/cli/commands/eval.js +505 -0
  453. package/v3/dist/cli/commands/eval.js.map +1 -0
  454. package/v3/dist/cli/commands/validate-swarm.d.ts +16 -0
  455. package/v3/dist/cli/commands/validate-swarm.d.ts.map +1 -0
  456. package/v3/dist/cli/commands/validate-swarm.js +251 -0
  457. package/v3/dist/cli/commands/validate-swarm.js.map +1 -0
  458. package/v3/dist/cli/commands/validate.d.ts +14 -0
  459. package/v3/dist/cli/commands/validate.d.ts.map +1 -0
  460. package/v3/dist/cli/commands/validate.js +408 -0
  461. package/v3/dist/cli/commands/validate.js.map +1 -0
  462. package/v3/dist/cli/index.js +6 -0
  463. package/v3/dist/cli/index.js.map +1 -1
  464. package/v3/dist/index.d.ts +2 -0
  465. package/v3/dist/index.d.ts.map +1 -1
  466. package/v3/dist/index.js +10 -0
  467. package/v3/dist/index.js.map +1 -1
  468. package/v3/dist/init/skills-installer.d.ts +6 -0
  469. package/v3/dist/init/skills-installer.d.ts.map +1 -1
  470. package/v3/dist/init/skills-installer.js +48 -0
  471. package/v3/dist/init/skills-installer.js.map +1 -1
  472. package/v3/dist/learning/index.d.ts +2 -0
  473. package/v3/dist/learning/index.d.ts.map +1 -1
  474. package/v3/dist/learning/index.js +4 -0
  475. package/v3/dist/learning/index.js.map +1 -1
  476. package/v3/dist/learning/skill-validation-learner.d.ts +264 -0
  477. package/v3/dist/learning/skill-validation-learner.d.ts.map +1 -0
  478. package/v3/dist/learning/skill-validation-learner.js +515 -0
  479. package/v3/dist/learning/skill-validation-learner.js.map +1 -0
  480. package/v3/dist/validation/index.d.ts +19 -0
  481. package/v3/dist/validation/index.d.ts.map +1 -0
  482. package/v3/dist/validation/index.js +31 -0
  483. package/v3/dist/validation/index.js.map +1 -0
  484. package/v3/dist/validation/parallel-eval-runner.d.ts +307 -0
  485. package/v3/dist/validation/parallel-eval-runner.d.ts.map +1 -0
  486. package/v3/dist/validation/parallel-eval-runner.js +566 -0
  487. package/v3/dist/validation/parallel-eval-runner.js.map +1 -0
  488. package/v3/dist/validation/swarm-skill-validator.d.ts +282 -0
  489. package/v3/dist/validation/swarm-skill-validator.d.ts.map +1 -0
  490. package/v3/dist/validation/swarm-skill-validator.js +460 -0
  491. package/v3/dist/validation/swarm-skill-validator.js.map +1 -0
  492. package/v3/dist/validation/validation-result-aggregator.d.ts +232 -0
  493. package/v3/dist/validation/validation-result-aggregator.d.ts.map +1 -0
  494. package/v3/dist/validation/validation-result-aggregator.js +630 -0
  495. package/v3/dist/validation/validation-result-aggregator.js.map +1 -0
  496. package/v3/package.json +1 -1
@@ -1,1753 +1,1759 @@
1
- ---
2
- name: qcsd-ideation-swarm
3
- description: "QCSD Ideation phase swarm for Quality Criteria sessions using HTSM v6.3, Risk Storming, and Testability analysis before development begins. Uses 5-tier browser cascade: Vibium → agent-browser → Playwright+Stealth → WebFetch → WebSearch-fallback."
4
- category: qcsd-phases
5
- priority: critical
6
- version: 7.5.1
7
- tokenEstimate: 3500
8
- # DDD Domain Mapping (from QCSD-AGENTIC-QE-MAPPING-FRAMEWORK.md)
9
- domains:
10
- primary:
11
- - domain: requirements-validation
12
- agents: [qe-quality-criteria-recommender, qe-requirements-validator]
13
- - domain: coverage-analysis
14
- agents: [qe-risk-assessor]
15
- conditional:
16
- - domain: security-compliance
17
- agents: [qe-security-auditor]
18
- - domain: visual-accessibility
19
- agents: [qe-accessibility-auditor]
20
- - domain: cross-domain
21
- agents: [qe-qx-partner]
22
- # Agent Inventory
23
- agents:
24
- core: [qe-quality-criteria-recommender, qe-risk-assessor, qe-requirements-validator]
25
- conditional: [qe-accessibility-auditor, qe-security-auditor, qe-qx-partner]
26
- total: 6
27
- sub_agents: 0
28
- skills: [testability-scoring, risk-based-testing, context-driven-testing, holistic-testing-pact]
29
- # Execution Models (Task Tool is PRIMARY)
30
- execution:
31
- primary: task-tool
32
- alternatives: [mcp-tools, cli]
33
- swarm_pattern: true
34
- parallel_batches: 2
35
- last_updated: 2026-01-28
36
- # v7.5.1 Changelog: Added prominent follow-up recommendation box at end of swarm execution (Phase URL-9)
37
- # v7.5.0 Changelog: Added HAS_VIDEO flag detection with /a11y-ally follow-up recommendation for video caption generation
38
- # v7.4.0 Changelog: Automated browser cascade via scripts/fetch-content.js with 30s per-tier timeouts
39
- # v7.2.0 Changelog: Added 5-tier browser cascade (Vibium → agent-browser → Playwright+Stealth → WebFetch → WebSearch)
40
- html_output: true
41
- enforcement_level: strict
42
- tags: [qcsd, ideation, htsm, quality-criteria, risk-storming, testability, swarm, parallel, ddd]
43
- ---
44
-
45
- # QCSD Ideation Swarm v7.0
46
-
47
- Shift-left quality engineering swarm for PI Planning and Sprint Planning.
48
-
49
- ---
50
-
51
- ## URL-Based Analysis Mode (v7.1)
52
-
53
- When analyzing a live website URL, use this specialized execution pattern.
54
-
55
- ### Parameters
56
-
57
- - `URL`: Website to analyze (required)
58
- - `OUTPUT_FOLDER`: Where to save reports (default: `${PROJECT_ROOT}/Agentic QCSD/{domain}/` or `./Agentic QCSD/{domain}/`)
59
-
60
- ---
61
-
62
- ## ⛔ URL MODE: COMPLETE EXECUTION FLOW
63
-
64
- **You MUST follow ALL phases in order. Skipping phases is a FAILURE.**
65
-
66
- ### PHASE URL-1: Setup and Content Fetch (AUTOMATED CASCADE)
67
-
68
- **The browser cascade is now FULLY AUTOMATED via `scripts/fetch-content.js`.**
69
-
70
- **Single command - automatic tier fallback with 30s timeout per tier:**
71
-
72
- ```bash
73
- # SINGLE COMMAND - handles all tiers automatically:
74
- # Use npx for installed package, or node with relative path for local development
75
- npx aqe fetch-content "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
76
- # OR if running from project root:
77
- node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
78
- ```
79
-
80
- **What the script does automatically:**
81
- 1. Creates output folder
82
- 2. Tries Playwright+Stealth (30s timeout)
83
- 3. Falls back to HTTP Fetch (30s timeout)
84
- 4. Falls back to WebSearch placeholder (30s timeout)
85
- 5. Saves `content.html`, `screenshot.png`, and `fetch-result.json`
86
-
87
- **Execution:**
88
-
89
- ```javascript
90
- // 1. Run the automated fetch cascade (use relative path from project root)
91
- const fetchResult = Bash({
92
- command: `node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000`,
93
- timeout: 120000 // 2 min total max
94
- })
95
-
96
- // 2. Parse the JSON result from stdout
97
- const result = JSON.parse(fetchResult.stdout)
98
-
99
- // 3. Read the content
100
- const content = Read({ file_path: `${OUTPUT_FOLDER}/content.html` })
101
- const fetchMethod = result.tier
102
- const contentSize = result.contentSize
103
- ```
104
-
105
- **If script is not available, fall back to inline Playwright:**
106
-
107
- ```javascript
108
- // FALLBACK: Only if scripts/fetch-content.js doesn't exist
109
- Bash({ command: `mkdir -p "${OUTPUT_FOLDER}"` })
110
-
111
- // Quick Playwright fetch (single tier, no cascade)
112
- Bash({
113
- command: `cd /tmp && rm -rf qcsd-fetch && mkdir qcsd-fetch && cd qcsd-fetch && npm init -y && npm install playwright-extra puppeteer-extra-plugin-stealth playwright 2>/dev/null`,
114
- timeout: 60000
115
- })
116
-
117
- // ... minimal inline script as last resort
118
- ```
119
-
120
- **MANDATORY: Output fetch method used:**
121
- ```
122
- ┌─────────────────────────────────────────────────────────────┐
123
- │ CONTENT FETCH RESULT │
124
- ├─────────────────────────────────────────────────────────────┤
125
- │ Method Used: [vibium/agent-browser/playwright/webfetch/ │
126
- │ websearch-fallback] │
127
- │ Content Size: [X KB] │
128
- │ Status: [SUCCESS/DEGRADED] │
129
-
130
- │ If DEGRADED (websearch-fallback), analysis is based on │
131
- public information, not live page inspection.
132
- └─────────────────────────────────────────────────────────────┘
133
- ```
134
-
135
- ### PHASE URL-2: Programmatic Flag Detection (MANDATORY)
136
-
137
- **You MUST detect flags from the fetched content. Do NOT skip this phase.**
138
-
139
- ```javascript
140
- // Detect HAS_UI
141
- const HAS_UI = (
142
- /<(form|button|input|select|textarea|img|video|canvas|nav|header|footer|aside)/i.test(content) ||
143
- /carousel|slider|modal|dialog|dropdown|menu|tab|accordion/i.test(content) ||
144
- /class=["'][^"']*btn|button|card|grid|flex/i.test(content)
145
- );
146
-
147
- // Detect HAS_SECURITY
148
- const HAS_SECURITY = (
149
- /login|password|auth|token|session|credential|oauth|jwt|sso/i.test(content) ||
150
- /newsletter|subscribe|signup|email.*input|register/i.test(content) || // PII collection
151
- /payment|checkout|credit.*card|billing/i.test(content) ||
152
- /cookie|consent|gdpr|privacy/i.test(content)
153
- );
154
-
155
- // Detect HAS_UX
156
- const HAS_UX = (
157
- /user|customer|visitor|journey|experience|engagement/i.test(content) ||
158
- /<form/i.test(content) && /<button/i.test(content) || // Interactive forms
159
- /onboarding|wizard|step.*step|progress/i.test(content) ||
160
- /feedback|rating|review|comment/i.test(content)
161
- );
162
-
163
- // Detect HAS_VIDEO (for a11y-ally follow-up recommendation)
164
- const HAS_VIDEO = (
165
- /<video/i.test(content) ||
166
- /youtube\.com\/embed|vimeo\.com|wistia\.com/i.test(content) ||
167
- /\.mp4|\.webm|\.m3u8/i.test(content) ||
168
- /data-video-url|data-mobile-url|data-desktop-url/i.test(content)
169
- );
170
- ```
171
-
172
- **You MUST output flag detection results before proceeding:**
173
-
174
- ```
175
- ┌─────────────────────────────────────────────────────────────┐
176
- │ FLAG DETECTION RESULTS │
177
- ├─────────────────────────────────────────────────────────────┤
178
- │ │
179
- │ HAS_UI: [TRUE/FALSE] │
180
- │ Evidence: [what triggered it - specific patterns] │
181
- │ │
182
- HAS_SECURITY: [TRUE/FALSE]
183
- │ Evidence: [what triggered it - specific patterns] │
184
- │ │
185
- HAS_UX: [TRUE/FALSE] │
186
- │ Evidence: [what triggered it - specific patterns] │
187
- │ │
188
- HAS_VIDEO: [TRUE/FALSE] │
189
- │ Evidence: [video URLs found - for a11y follow-up] │
190
- │ │
191
- EXPECTED AGENTS:
192
- │ - Core: 3 (always)
193
- - Conditional: [count based on TRUE flags]
194
- - TOTAL: [3 + conditional count]
195
-
196
- FOLLOW-UP RECOMMENDED:
197
- - /a11y-ally: [YES if HAS_VIDEO=TRUE, else NO]
198
-
199
- └─────────────────────────────────────────────────────────────┘
200
- ```
201
-
202
- **❌ DO NOT proceed to Phase URL-3 without outputting flag detection results.**
203
-
204
- ### PHASE URL-3: Spawn Core Agents (PARALLEL)
205
-
206
- **All 3 core agents MUST be spawned. Fewer is a FAILURE.**
207
-
208
- Spawn ALL THREE in a single message:
209
-
210
- ```javascript
211
- // Agent 1: Quality Criteria (HTSM v6.3)
212
- Task({
213
- description: "QCSD Quality Criteria Analysis",
214
- prompt: `You are qe-quality-criteria-recommender analyzing ${URL}.
215
-
216
- ## WEBSITE CONTENT
217
- ${content}
218
-
219
- ## ANALYSIS REQUIREMENTS
220
- Analyze ALL 10 HTSM v6.3 categories with weight and testability score for each.
221
-
222
- ## OUTPUT REQUIREMENTS (MANDATORY)
223
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/02-quality-criteria-analysis.md
224
- 2. Use the Write tool to save BEFORE completing
225
- 3. Report MUST be complete - no placeholders`,
226
- subagent_type: "qe-quality-criteria-recommender",
227
- run_in_background: true
228
- })
229
-
230
- // Agent 2: Risk Assessment (SFDIPOT)
231
- Task({
232
- description: "QCSD Risk Assessment",
233
- prompt: `You are qe-risk-assessor analyzing ${URL}.
234
-
235
- ## WEBSITE CONTENT
236
- ${content}
237
-
238
- ## ANALYSIS REQUIREMENTS
239
- Apply SFDIPOT framework: Structure, Function, Data, Interfaces, Platform, Operations, Time.
240
- Identify minimum 10 risks with probability, impact, and score.
241
-
242
- ## OUTPUT REQUIREMENTS (MANDATORY)
243
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/04-risk-assessment.md
244
- 2. Use the Write tool to save BEFORE completing
245
- 3. Report MUST be complete - no placeholders`,
246
- subagent_type: "qe-risk-assessor",
247
- run_in_background: true
248
- })
249
-
250
- // Agent 3: Requirements Validator (Testability)
251
- Task({
252
- description: "QCSD Testability Assessment",
253
- prompt: `You are qe-requirements-validator analyzing ${URL}.
254
-
255
- ## WEBSITE CONTENT
256
- ${content}
257
-
258
- ## ANALYSIS REQUIREMENTS
259
- Apply 10 Principles of Testability. Score each principle 0-100.
260
- Identify blockers and recommendations.
261
-
262
- ## OUTPUT REQUIREMENTS (MANDATORY)
263
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/03-testability-assessment.md
264
- 2. Use the Write tool to save BEFORE completing
265
- 3. Report MUST be complete - no placeholders`,
266
- subagent_type: "qe-requirements-validator",
267
- run_in_background: true
268
- })
269
- ```
270
-
271
- ### PHASE URL-4: Spawn Conditional Agents (PARALLEL)
272
-
273
- **Spawn agents based on flags detected in Phase URL-2.**
274
-
275
- ```javascript
276
- // IF HAS_UI === TRUE
277
- Task({
278
- description: "QCSD Accessibility Audit",
279
- prompt: `You are qe-accessibility-auditor analyzing ${URL}.
280
-
281
- ## WEBSITE CONTENT
282
- ${content}
283
-
284
- ## ANALYSIS REQUIREMENTS
285
- Perform WCAG 2.2 AA compliance assessment.
286
- Identify accessibility barriers, missing ARIA, color contrast issues.
287
-
288
- ## OUTPUT REQUIREMENTS (MANDATORY)
289
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/07-accessibility-audit.md
290
- 2. Use the Write tool to save BEFORE completing`,
291
- subagent_type: "qe-accessibility-auditor",
292
- run_in_background: true
293
- })
294
-
295
- // IF HAS_SECURITY === TRUE
296
- Task({
297
- description: "QCSD Security Threat Model",
298
- prompt: `You are qe-security-auditor analyzing ${URL}.
299
-
300
- ## WEBSITE CONTENT
301
- ${content}
302
-
303
- ## ANALYSIS REQUIREMENTS
304
- Apply STRIDE threat modeling framework.
305
- Identify vulnerabilities, attack vectors, and mitigations.
306
-
307
- ## OUTPUT REQUIREMENTS (MANDATORY)
308
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/05-security-threat-model.md
309
- 2. Use the Write tool to save BEFORE completing`,
310
- subagent_type: "qe-security-auditor",
311
- run_in_background: true
312
- })
313
-
314
- // IF HAS_UX === TRUE
315
- Task({
316
- description: "QCSD Quality Experience Analysis",
317
- prompt: `You are qe-qx-partner analyzing ${URL}.
318
-
319
- ## WEBSITE CONTENT
320
- ${content}
321
-
322
- ## ANALYSIS REQUIREMENTS
323
- Analyze user journeys, experience quality, friction points.
324
- Map key user flows and identify UX risks.
325
-
326
- ## OUTPUT REQUIREMENTS (MANDATORY)
327
- 1. Write your complete analysis to: ${OUTPUT_FOLDER}/08-quality-experience.md
328
- 2. Use the Write tool to save BEFORE completing`,
329
- subagent_type: "qe-qx-partner",
330
- run_in_background: true
331
- })
332
- ```
333
-
334
- ### PHASE URL-5: Agent Count Validation
335
-
336
- **Before proceeding, verify agent count:**
337
-
338
- ```
339
- ┌─────────────────────────────────────────────────────────────┐
340
- │ AGENT COUNT VALIDATION │
341
- ├─────────────────────────────────────────────────────────────┤
342
- │ │
343
- │ CORE AGENTS (ALWAYS 3): │
344
- │ □ qe-quality-criteria-recommender - SPAWNED? [Y/N] │
345
- │ □ qe-risk-assessor - SPAWNED? [Y/N] │
346
- qe-requirements-validator - SPAWNED? [Y/N]
347
- │ │
348
- CONDITIONAL AGENTS (based on flags):
349
- qe-accessibility-auditor - SPAWNED? [Y/N] (HAS_UI)
350
- │ □ qe-security-auditor - SPAWNED? [Y/N] (HAS_SECURITY)
351
- │ □ qe-qx-partner - SPAWNED? [Y/N] (HAS_UX)
352
-
353
- VALIDATION:
354
- Expected agents: [3 + count of TRUE flags]
355
- Actual spawned: [count]
356
- Status: [PASS/FAIL]
357
-
358
- If ACTUAL < EXPECTED, you have FAILED. Spawn missing
359
- agents before proceeding.
360
-
361
- └─────────────────────────────────────────────────────────────┘
362
- ```
363
-
364
- **❌ DO NOT proceed if validation FAILS.**
365
-
366
- ### PHASE URL-6: Wait for Agents and Verify Reports
367
-
368
- After spawning, inform user and wait:
369
-
370
- ```
371
- I've launched [N] agents in background:
372
- - 📊 Quality Criteria Recommender: HTSM v6.3 analysis → 02-quality-criteria-analysis.md
373
- - ⚠️ Risk Assessor: SFDIPOT analysis → 04-risk-assessment.md
374
- - 🧪 Requirements Validator: Testability assessment → 03-testability-assessment.md
375
- [IF HAS_UI]
376
- - ♿ Accessibility Auditor: WCAG 2.2 audit → 07-accessibility-audit.md
377
- [IF HAS_SECURITY]
378
- - 🔒 Security Auditor: STRIDE threat model05-security-threat-model.md
379
- [IF HAS_UX]
380
- - 🎯 QX Partner: User experience analysis 08-quality-experience.md
381
-
382
- Each agent will write directly to: ${OUTPUT_FOLDER}/
383
- ```
384
-
385
- Verify reports exist before synthesis:
386
- ```bash
387
- ls -la "${OUTPUT_FOLDER}"
388
- ```
389
-
390
- ### PHASE URL-7: Invoke Related Skills (MANDATORY)
391
-
392
- **After agent reports are complete, invoke these skills:**
393
-
394
- ```javascript
395
- // Testability Scoring - applies formal scoring methodology
396
- Skill({ skill: "testability-scoring", args: `${OUTPUT_FOLDER}/03-testability-assessment.md` })
397
-
398
- // Risk-Based Testing - prioritizes test selection
399
- Skill({ skill: "risk-based-testing", args: `${OUTPUT_FOLDER}/04-risk-assessment.md` })
400
- ```
401
-
402
- **Required Skill Invocations:**
403
-
404
- | Skill | When | Purpose |
405
- |-------|------|---------|
406
- | `testability-scoring` | After testability report | Formal 0-100 score calculation |
407
- | `risk-based-testing` | After risk report | Test prioritization matrix |
408
- | `context-driven-testing` | Always | Apply CDT principles to recommendations |
409
- | `holistic-testing-pact` | Always | Validate test strategy completeness |
410
-
411
- **❌ Analysis is INCOMPLETE without invoking related skills.**
412
-
413
- ### PHASE URL-8: Synthesis and Executive Summary
414
-
415
- After all agents complete and skills are invoked:
416
-
417
- 1. **Read all agent reports**
418
- 2. **Generate Executive Summary** → `${OUTPUT_FOLDER}/01-executive-summary.md`
419
- 3. **Generate Consolidated Test Ideas** `${OUTPUT_FOLDER}/06-test-ideas.md`
420
- 4. **Add Follow-up Recommendations** (if HAS_VIDEO=TRUE):
421
- ```markdown
422
- ## Recommended Follow-up Actions
423
-
424
- | Action | Skill/Command | Reason |
425
- |--------|---------------|--------|
426
- | Generate Video Captions | `/a11y-ally ${URL}` | Video detected without captions - WCAG 1.2.2 compliance |
427
- ```
428
- 5. **Store learnings in memory**:
429
- ```bash
430
- npx @claude-flow/cli@latest memory store \
431
- --key "qcsd-${domain}-pattern" \
432
- --value "[key learnings from this analysis]" \
433
- --namespace patterns
434
- ```
435
-
436
- **IMPORTANT:** If HAS_VIDEO=TRUE, the Executive Summary MUST include a "Recommended Follow-up Actions" section recommending `/a11y-ally` for video caption generation. This is NOT automatic - it's a recommendation for the user to run separately.
437
-
438
- ### Report Filename Mapping
439
-
440
- | Agent | Report Filename |
441
- |-------|----------------|
442
- | qe-quality-criteria-recommender | `02-quality-criteria-analysis.md` |
443
- | qe-requirements-validator | `03-testability-assessment.md` |
444
- | qe-risk-assessor | `04-risk-assessment.md` |
445
- | qe-security-auditor | `05-security-threat-model.md` |
446
- | qe-accessibility-auditor | `07-accessibility-audit.md` |
447
- | qe-qx-partner | `08-quality-experience.md` |
448
- | Synthesis | `01-executive-summary.md` |
449
- | Synthesis | `06-test-ideas.md` |
450
-
451
- ### PHASE URL-9: Final Output with Follow-up Recommendations (MANDATORY)
452
-
453
- **At the very end of swarm execution, ALWAYS output this completion summary:**
454
-
455
- ```
456
- ┌─────────────────────────────────────────────────────────────────────┐
457
- │ QCSD IDEATION SWARM COMPLETE │
458
- ├─────────────────────────────────────────────────────────────────────┤
459
- │ │
460
- │ URL Analyzed: ${URL} │
461
- │ Reports Generated: 8 │
462
- │ Output Folder: ${OUTPUT_FOLDER} │
463
-
464
- │ QUALITY SCORES: │
465
- ├─ Risk Assessment: [score]
466
- ├─ Security Posture: [score]
467
- ├─ Quality Experience: [score]
468
- ├─ Testability: [score]
469
- └─ Accessibility: [score]
470
-
471
- └─────────────────────────────────────────────────────────────────────┘
472
- ```
473
-
474
- **IF HAS_VIDEO=TRUE, ALSO output this prominent recommendation box:**
475
-
476
- ```
477
- ┌─────────────────────────────────────────────────────────────────────┐
478
- │ ⚠️ FOLLOW-UP ACTION RECOMMENDED │
479
- ├─────────────────────────────────────────────────────────────────────┤
480
- │ │
481
- │ VIDEO DETECTED WITHOUT CAPTIONS │
482
- │ │
483
- │ To generate WCAG 1.2.2 compliant captions, run: │
484
-
485
- │ /a11y-ally ${URL} │
486
- │ │
487
- This will:
488
- • Download video and extract frames
489
- Analyze each frame with Claude Vision
490
- • Generate captions.vtt and audiodesc.vtt
491
- • Save to docs/accessibility-scans/{page-slug}/
492
- │ │
493
- └─────────────────────────────────────────────────────────────────────┘
494
- ```
495
-
496
- **❌ DO NOT end the swarm without displaying the completion summary.**
497
- **❌ DO NOT skip the follow-up recommendation box if HAS_VIDEO=TRUE.**
498
-
499
- ---
500
-
501
- ## DDD Domain Integration
502
-
503
- This swarm operates across **3 primary domains** and **3 conditional domains**:
504
-
505
- ```
506
- ┌─────────────────────────────────────────────────────────────────────────────┐
507
- │ QCSD IDEATION - DOMAIN MAP │
508
- ├─────────────────────────────────────────────────────────────────────────────┤
509
- │ │
510
- │ PRIMARY DOMAINS (Always Active) │
511
- │ ┌─────────────────────────┐ ┌─────────────────────────┐ │
512
- │ │ requirements-validation │ │ coverage-analysis │ │
513
- │ ─────────────────────── │ ─────────────────────
514
- │ │ • qe-quality-criteria- │ │ • qe-risk-assessor │ │
515
- recommender (PRIMARY) │ │ │ │
516
- │ • qe-requirements- │ │ │
517
- │ validator │ │ │
518
- └─────────────────────────┘ └─────────────────────────┘
519
-
520
- CONDITIONAL DOMAINS (Based on Epic Content)
521
- ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
522
- │ │security-complnce│ │visual-a11y │ │ cross-domain
523
- │─────────────────│ │─────────────────│ │─────────────────│
524
- │qe-security- │qe-accessibility-│ │ qe-qx-partner │ │
525
- auditor │ │auditor │ │ │ │
526
- │[IF HAS_SECURITY]│ │[IF HAS_UI] │ │[IF HAS_UX]
527
- └─────────────────┘ └─────────────────┘ └─────────────────┘
528
-
529
- └─────────────────────────────────────────────────────────────────────────────┘
530
- ```
531
-
532
- ---
533
-
534
- ## Execution Model Options
535
-
536
- This skill supports **3 execution models**. Choose based on your environment:
537
-
538
- | Model | When to Use | Pros | Cons |
539
- |-------|-------------|------|------|
540
- | **Task Tool** (PRIMARY) | Claude Code sessions | Full agent capabilities, parallel execution | Requires Claude Code |
541
- | **MCP Tools** | MCP server available | Fleet coordination, memory persistence | Requires MCP setup |
542
- | **CLI** | Terminal/scripts | Works anywhere, scriptable | Sequential only |
543
-
544
- ### Quick Start by Model
545
-
546
- **Option A: Task Tool (RECOMMENDED)**
547
- ```
548
- Just follow the skill phases below - uses Task() calls with run_in_background: true
549
- ```
550
-
551
- **Option B: MCP Tools**
552
- ```javascript
553
- // Initialize fleet for Ideation domains
554
- mcp__agentic_qe__fleet_init({
555
- topology: "hierarchical",
556
- enabledDomains: ["requirements-validation", "coverage-analysis", "security-compliance"],
557
- maxAgents: 6
558
- })
559
-
560
- // Orchestrate ideation task
561
- mcp__agentic_qe__task_orchestrate({
562
- task: "qcsd-ideation-analysis",
563
- strategy: "parallel"
564
- })
565
- ```
566
-
567
- **Option C: CLI**
568
- ```bash
569
- # Initialize coordination
570
- npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 6
571
-
572
- # Route task
573
- npx @claude-flow/cli@latest hooks pre-task --description "QCSD Ideation for [Epic]"
574
-
575
- # Execute agents
576
- npx @claude-flow/cli@latest agent spawn --type qe-quality-criteria-recommender
577
- npx @claude-flow/cli@latest agent spawn --type qe-risk-assessor
578
- npx @claude-flow/cli@latest agent spawn --type qe-requirements-validator
579
- ```
580
-
581
- ---
582
-
583
- ## ENFORCEMENT RULES - READ FIRST
584
-
585
- **These rules are NON-NEGOTIABLE. Violation means skill execution failure.**
586
-
587
- | Rule | Enforcement |
588
- |------|-------------|
589
- | **E1** | You MUST spawn ALL THREE core agents in Phase 2. No exceptions. |
590
- | **E2** | You MUST put all parallel Task calls in a SINGLE message. |
591
- | **E3** | You MUST STOP and WAIT after each batch. No proceeding early. |
592
- | **E4** | You MUST spawn conditional agents if flags are TRUE. No skipping. |
593
- | **E5** | You MUST apply GO/CONDITIONAL/NO-GO logic exactly as specified. |
594
- | **E6** | You MUST generate the full report structure. No abbreviated versions. |
595
- | **E7** | Each agent MUST read its reference files before analysis. |
596
-
597
- **❌ PROHIBITED BEHAVIORS:**
598
- - Summarizing instead of spawning agents
599
- - Skipping agents "for brevity"
600
- - Proceeding before background tasks complete
601
- - Providing your own analysis instead of spawning specialists
602
- - Omitting report sections
603
- - Using placeholder text like "[details here]"
604
-
605
- ---
606
-
607
- ## PHASE 1: Analyze Epic Content
608
-
609
- **⚠️ MANDATORY: You must complete this analysis before Phase 2.**
610
-
611
- Scan the epic content and SET these flags. Do not skip any flag.
612
-
613
- ### Flag Detection (Check ALL THREE)
614
-
615
- ```
616
- □ HAS_UI = FALSE
617
- Set TRUE if epic contains ANY of: UI, frontend, visual, design,
618
- component, screen, page, form, button, modal, dialog, dashboard,
619
- widget, interface, display, view, layout, CSS, styling
620
-
621
- □ HAS_SECURITY = FALSE
622
- Set TRUE if epic contains ANY of: auth, security, credential, token,
623
- encrypt, PII, compliance, password, login, session, OAuth, JWT,
624
- permission, role, access control, RBAC, sensitive, private
625
-
626
- □ HAS_UX = FALSE
627
- Set TRUE if epic contains ANY of: user experience, UX, journey,
628
- usability, satisfaction, user flow, persona, user research,
629
- friction, delight, onboarding, retention, engagement
630
- ```
631
-
632
- ### Validation Checkpoint
633
-
634
- Before proceeding to Phase 2, confirm:
635
- ```
636
- ✓ I have read the entire epic content
637
- ✓ I have evaluated ALL THREE flags
638
- I have recorded which flags are TRUE
639
- ✓ I understand which conditional agents will be needed
640
- ```
641
-
642
- **❌ DO NOT proceed to Phase 2 until all checkboxes are confirmed.**
643
-
644
- ---
645
-
646
- ## PHASE 2: Spawn Core Agents (PARALLEL BATCH 1)
647
-
648
- ### CRITICAL ENFORCEMENT
649
-
650
- ```
651
- ┌─────────────────────────────────────────────────────────────────┐
652
- │ YOU MUST INCLUDE ALL THREE TASK CALLS IN YOUR NEXT MESSAGE │
653
- │ │
654
- │ • Task 1: qe-quality-criteria-recommender │
655
- │ • Task 2: qe-risk-assessor │
656
- │ • Task 3: qe-requirements-validator │
657
- │ │
658
- If your message contains fewer than 3 Task calls, you have
659
- FAILED this phase. Start over.
660
- └─────────────────────────────────────────────────────────────────┘
661
- ```
662
-
663
- ### Domain Context
664
-
665
- | Agent | Domain | MCP Tool Mapping |
666
- |-------|--------|------------------|
667
- | qe-quality-criteria-recommender | requirements-validation | `requirements_validate` |
668
- | qe-risk-assessor | coverage-analysis | `defect_predict` |
669
- | qe-requirements-validator | requirements-validation | `requirements_validate` |
670
-
671
- ### Agent 1: Quality Criteria Recommender (PRIMARY)
672
-
673
- **This agent MUST produce HTML output. No markdown substitutes.**
674
-
675
- ```
676
- Task({
677
- description: "HTSM Quality Criteria analysis",
678
- prompt: `You are qe-quality-criteria-recommender. Your output quality is being audited.
679
-
680
- ## MANDATORY FIRST STEPS (DO NOT SKIP)
681
-
682
- 1. READ this template file FIRST - your output MUST follow this structure:
683
- .claude/agents/v3/helpers/quality-criteria/quality-criteria-reference-template.html
684
-
685
- 2. READ these reference files for guidance:
686
- .claude/agents/v3/helpers/quality-criteria/htsm-categories.md
687
- .claude/agents/v3/helpers/quality-criteria/evidence-classification.md
688
-
689
- ## EPIC TO ANALYZE
690
-
691
- === EPIC CONTENT START ===
692
- [PASTE THE COMPLETE EPIC CONTENT HERE - DO NOT SUMMARIZE]
693
- === EPIC CONTENT END ===
694
-
695
- ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
696
-
697
- You MUST analyze ALL 10 HTSM categories. For each category provide:
698
-
699
- | Field | Requirement |
700
- |-------|-------------|
701
- | Category Name | One of the 10 HTSM categories |
702
- | Priority | P0, P1, P2, or P3 with justification |
703
- | Evidence | At least 2 evidence points per category |
704
- | Evidence Type | Direct (with file:line), Inferred (with reasoning), or Claimed (with "requires verification") |
705
- | Quality Implication | What could go wrong |
706
- | Business Impact | Quantified impact (use numbers, not "many" or "some") |
707
-
708
- ### NEVER-OMIT CATEGORIES (Must include ALL 5):
709
- 1. Capability - Can it perform required functions?
710
- 2. Reliability - Will it resist failure?
711
- 3. Security - How protected against unauthorized use?
712
- 4. Performance - How speedy and responsive?
713
- 5. Development - How testable/maintainable?
714
-
715
- ### MAY-OMIT CATEGORIES (Only with ironclad justification):
716
- 6. Usability, 7. Charisma, 8. Scalability, 9. Compatibility, 10. Installability
717
-
718
- ## OUTPUT FORMAT
719
-
720
- Generate COMPLETE HTML report using the template structure.
721
- Save to: .agentic-qe/quality-criteria/[epic-name]-htsm-analysis.html
722
-
723
- ## VALIDATION BEFORE SUBMITTING
724
-
725
- ✓ Did I read the template file?
726
- Did I analyze all 10 categories (or justify omissions)?
727
- Does every evidence point have proper classification?
728
- ✓ Are business impacts quantified with numbers?
729
- Is output in HTML format using template structure?`,
730
- subagent_type: "qe-quality-criteria-recommender",
731
- run_in_background: true
732
- })
733
- ```
734
-
735
- ### Agent 2: Risk Assessor
736
-
737
- **This agent MUST identify at least 5 risks. Fewer is a failure.**
738
-
739
- ```
740
- Task({
741
- description: "Risk Storming analysis",
742
- prompt: `You are qe-risk-assessor. Your output quality is being audited.
743
-
744
- ## METHODOLOGY
745
-
746
- Apply risk-based-testing methodology systematically.
747
-
748
- ## EPIC TO ANALYZE
749
-
750
- === EPIC CONTENT START ===
751
- [PASTE THE COMPLETE EPIC CONTENT HERE - DO NOT SUMMARIZE]
752
- === EPIC CONTENT END ===
753
-
754
- ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
755
-
756
- ### Risk Identification Requirements
757
-
758
- You MUST identify risks in ALL FOUR categories:
759
- 1. **Technical Risks** - Architecture, integration, dependencies, complexity
760
- 2. **Business Risks** - Revenue impact, user impact, compliance, reputation
761
- 3. **Quality Risks** - Testability, maintainability, reliability concerns
762
- 4. **Integration Risks** - Third-party services, APIs, data flows
763
-
764
- **MINIMUM: 5 total risks. Target: 10+ risks.**
765
-
766
- ### For EACH Risk, Provide:
767
-
768
- | Field | Requirement |
769
- |-------|-------------|
770
- | Risk ID | R001, R002, etc. |
771
- | Description | Specific, actionable description (not vague) |
772
- | Category | Technical, Business, Quality, or Integration |
773
- | Likelihood | 1-5 scale with justification |
774
- | Impact | 1-5 scale with justification |
775
- | Risk Score | Likelihood × Impact |
776
- | Mitigation | Specific mitigation strategy |
777
- | Owner | Suggested owner (Dev, QE, Product, Ops) |
778
-
779
- ### Critical Risk Threshold
780
- - Score 15 = CRITICAL (must be flagged prominently)
781
- - Score 10-14 = HIGH
782
- - Score 5-9 = MEDIUM
783
- - Score < 5 = LOW
784
-
785
- ## OUTPUT FORMAT
786
-
787
- Markdown with:
788
- 1. Executive Summary (top 3 risks in bold)
789
- 2. Risk Matrix Table (sorted by score descending)
790
- 3. Critical Risks Section (if any score ≥ 15)
791
- 4. Mitigation Priority List
792
-
793
- ## VALIDATION BEFORE SUBMITTING
794
-
795
- Did I identify at least 5 risks?
796
- Did I cover all 4 risk categories?
797
- Does every risk have likelihood, impact, AND score?
798
- ✓ Are critical risks (≥15) clearly flagged?
799
- Does every risk have a specific mitigation?`,
800
- subagent_type: "qe-risk-assessor",
801
- run_in_background: true
802
- })
803
- ```
804
-
805
- ### Agent 3: Requirements Validator
806
-
807
- **This agent MUST provide testability score 0-100. No ranges.**
808
-
809
- ```
810
- Task({
811
- description: "AC validation and testability scoring",
812
- prompt: `You are qe-requirements-validator. Your output quality is being audited.
813
-
814
- ## METHODOLOGY
815
-
816
- Apply context-driven-testing and testability-scoring principles.
817
-
818
- ## ACCEPTANCE CRITERIA TO VALIDATE
819
-
820
- === ACCEPTANCE CRITERIA START ===
821
- [PASTE THE COMPLETE ACCEPTANCE CRITERIA HERE - DO NOT SUMMARIZE]
822
- === ACCEPTANCE CRITERIA END ===
823
-
824
- ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
825
-
826
- ### 1. Testability Score (MANDATORY - SINGLE NUMBER)
827
-
828
- Score each of the 10 testability principles (0-10 each):
829
-
830
- | Principle | Score | Evidence |
831
- |-----------|-------|----------|
832
- | Controllability | X/10 | Can we control inputs/state? |
833
- | Observability | X/10 | Can we observe outputs/behavior? |
834
- | Isolability | X/10 | Can we test in isolation? |
835
- | Separation of Concerns | X/10 | Are responsibilities clear? |
836
- | Understandability | X/10 | Is behavior clearly specified? |
837
- | Automatability | X/10 | Can tests be automated? |
838
- | Heterogeneity | X/10 | Works across environments? |
839
- | Simplicity | X/10 | Is complexity manageable? |
840
- | Stability | X/10 | Are requirements stable? |
841
- | Information Availability | X/10 | Do we have needed info? |
842
-
843
- **TOTAL TESTABILITY SCORE: XX/100**
844
-
845
- ### 2. AC Completeness Assessment
846
-
847
- For EACH acceptance criterion:
848
-
849
- | AC ID | Text | INVEST Score | Issues | Testable? |
850
- |-------|------|--------------|--------|-----------|
851
- | AC1 | ... | X/6 | ... | Yes/No |
852
-
853
- INVEST Criteria:
854
- - **I**ndependent (can be tested alone)
855
- - **N**egotiable (not over-specified)
856
- - **V**aluable (delivers value)
857
- - **E**stimable (can estimate effort)
858
- - **S**mall (testable in one session)
859
- - **T**estable (clear pass/fail)
860
-
861
- **AC COMPLETENESS: XX%** (ACs that are fully testable / total ACs)
862
-
863
- ### 3. Gaps Identified (MANDATORY)
864
-
865
- List ALL gaps found:
866
- - Missing scenarios
867
- - Unclear requirements
868
- - Untestable criteria
869
- - Ambiguous language
870
- - Missing edge cases
871
-
872
- **MINIMUM: Identify at least 3 gaps or explicitly state "No gaps found after thorough analysis"**
873
-
874
- ### 4. Recommendations
875
-
876
- Specific, actionable recommendations to improve testability.
877
-
878
- ## VALIDATION BEFORE SUBMITTING
879
-
880
- Did I score all 10 testability principles?
881
- ✓ Did I calculate a single testability score (not a range)?
882
- Did I assess every AC against INVEST?
883
- ✓ Did I calculate AC completeness percentage?
884
- Did I identify gaps (or explicitly confirm none)?`,
885
- subagent_type: "qe-requirements-validator",
886
- run_in_background: true
887
- })
888
- ```
889
-
890
- ### Alternative: MCP Tools Execution
891
-
892
- If using MCP instead of Task tool:
893
-
894
- ```javascript
895
- // Option 1: Orchestrate via Queen Coordinator
896
- mcp__agentic_qe__fleet_init({
897
- topology: "hierarchical",
898
- enabledDomains: ["requirements-validation", "coverage-analysis"],
899
- maxAgents: 6,
900
- lazyLoading: true
901
- })
902
-
903
- // Submit tasks to specific domains
904
- mcp__agentic_qe__task_submit({
905
- type: "quality-criteria-analysis",
906
- priority: "p0",
907
- payload: {
908
- epicContent: epicContent,
909
- outputFormat: "html",
910
- htsmVersion: "6.3"
911
- }
912
- })
913
-
914
- mcp__agentic_qe__task_submit({
915
- type: "risk-assessment",
916
- priority: "p0",
917
- payload: {
918
- epicContent: epicContent,
919
- riskCategories: ["technical", "business", "quality", "integration"]
920
- }
921
- })
922
-
923
- mcp__agentic_qe__task_submit({
924
- type: "requirements-validation",
925
- priority: "p0",
926
- payload: {
927
- acceptanceCriteria: acContent,
928
- scoreTestability: true,
929
- validateInvest: true
930
- }
931
- })
932
-
933
- // Check task status
934
- mcp__agentic_qe__task_list({ status: "pending" })
935
- ```
936
-
937
- ### Alternative: CLI Execution
938
-
939
- If using CLI instead of Task tool:
940
-
941
- ```bash
942
- # Initialize swarm for ideation
943
- npx @claude-flow/cli@latest swarm init \
944
- --topology hierarchical \
945
- --max-agents 6 \
946
- --strategy specialized
947
-
948
- # Pre-task hook for routing
949
- npx @claude-flow/cli@latest hooks pre-task \
950
- --description "QCSD Ideation: Quality Criteria, Risk Assessment, AC Validation"
951
-
952
- # Spawn agents (run in separate terminals or background)
953
- npx @claude-flow/cli@latest agent spawn \
954
- --type qe-quality-criteria-recommender \
955
- --task "Analyze HTSM categories for epic" &
956
-
957
- npx @claude-flow/cli@latest agent spawn \
958
- --type qe-risk-assessor \
959
- --task "Risk storming analysis" &
960
-
961
- npx @claude-flow/cli@latest agent spawn \
962
- --type qe-requirements-validator \
963
- --task "AC validation and testability scoring" &
964
-
965
- # Wait for completion
966
- wait
967
-
968
- # Check swarm status
969
- npx @claude-flow/cli@latest swarm status
970
- ```
971
-
972
- ### Post-Spawn Confirmation
973
-
974
- After sending all three Task calls, you MUST tell the user:
975
-
976
- ```
977
- I've launched 3 core agents in parallel:
978
-
979
- 🎯 qe-quality-criteria-recommender [Domain: requirements-validation]
980
- - Analyzing all 10 HTSM v6.3 categories
981
- - Collecting evidence with classifications
982
- - Generating HTML report
983
-
984
- ⚠️ qe-risk-assessor [Domain: coverage-analysis]
985
- - Identifying Technical, Business, Quality, Integration risks
986
- - Scoring likelihood × impact
987
- - Prioritizing mitigations
988
-
989
- ✅ qe-requirements-validator [Domain: requirements-validation]
990
- - Scoring testability (10 principles)
991
- - Validating ACs against INVEST
992
- - Identifying gaps
993
-
994
- ⏳ WAITING for all agents to complete before proceeding...
995
- ```
996
-
997
- **❌ DO NOT proceed to Phase 3 until you have sent this confirmation.**
998
-
999
- ---
1000
-
1001
- ## PHASE 3: Wait for Batch 1 Completion
1002
-
1003
- ### ENFORCEMENT: NO EARLY PROCEEDING
1004
-
1005
- ```
1006
- ┌─────────────────────────────────────────────────────────────────┐
1007
- │ YOU MUST WAIT FOR ALL THREE BACKGROUND TASKS TO COMPLETE │
1008
- │ │
1009
- │ ❌ DO NOT summarize what agents "would" find │
1010
- │ ❌ DO NOT proceed to Phase 4 early │
1011
- │ ❌ DO NOT provide your own analysis as substitute │
1012
- │ │
1013
- WAIT for actual agent results
1014
- ✓ ONLY proceed when all three have returned
1015
- └─────────────────────────────────────────────────────────────────┘
1016
- ```
1017
-
1018
- ### Results Extraction Checklist
1019
-
1020
- When results return, extract and record:
1021
-
1022
- ```
1023
- From qe-quality-criteria-recommender:
1024
- htsmCoverage = __/10 categories analyzed
1025
- □ p0Count = __ P0 priority items
1026
- evidenceQuality = Direct __%, Inferred __%, Claimed __%
1027
-
1028
- From qe-risk-assessor:
1029
- totalRisks = __ risks identified
1030
- criticalRisks = __ risks with score ≥ 15
1031
- topRiskScore = __ (highest score)
1032
-
1033
- From qe-requirements-validator:
1034
- testabilityScore = __/100
1035
- acCompleteness = __%
1036
- gapsIdentified = __ gaps
1037
- ```
1038
-
1039
- **❌ DO NOT proceed to Phase 4 until ALL fields are filled.**
1040
-
1041
- ---
1042
-
1043
- ## PHASE 4: Spawn Conditional Agents (PARALLEL BATCH 2)
1044
-
1045
- ### ENFORCEMENT: NO SKIPPING CONDITIONAL AGENTS
1046
-
1047
- ```
1048
- ┌─────────────────────────────────────────────────────────────────┐
1049
- │ IF A FLAG IS TRUE, YOU MUST SPAWN THAT AGENT │
1050
- │ │
1051
- │ HAS_UI = TRUE → MUST spawn qe-accessibility-auditor │
1052
- │ HAS_SECURITY = TRUE → MUST spawn qe-security-auditor │
1053
- │ HAS_UX = TRUE → MUST spawn qe-qx-partner │
1054
- │ │
1055
- Skipping a flagged agent is a FAILURE of this skill.
1056
- └─────────────────────────────────────────────────────────────────┘
1057
- ```
1058
-
1059
- ### Conditional Domain Mapping
1060
-
1061
- | Flag | Agent | Domain | MCP Tool |
1062
- |------|-------|--------|----------|
1063
- | HAS_UI | qe-accessibility-auditor | visual-accessibility | `accessibility_test` |
1064
- | HAS_SECURITY | qe-security-auditor | security-compliance | `security_scan_comprehensive` |
1065
- | HAS_UX | qe-qx-partner | cross-domain | `task_orchestrate` |
1066
-
1067
- ### Decision Tree
1068
-
1069
- ```
1070
- IF HAS_UI == FALSE AND HAS_SECURITY == FALSE AND HAS_UX == FALSE:
1071
- Skip to Phase 5 (no conditional agents needed)
1072
- → State: "No conditional agents needed based on epic analysis"
1073
-
1074
- ELSE:
1075
- → Spawn ALL applicable agents in ONE message
1076
- Count how many you're spawning: __
1077
- ```
1078
-
1079
- ### IF HAS_UI: Accessibility Auditor (MANDATORY WHEN FLAGGED)
1080
-
1081
- ```
1082
- Task({
1083
- description: "Early accessibility review",
1084
- prompt: `You are qe-accessibility-auditor. Your output quality is being audited.
1085
-
1086
- ## EPIC CONTENT
1087
-
1088
- === EPIC CONTENT START ===
1089
- [PASTE THE COMPLETE EPIC CONTENT HERE]
1090
- === EPIC CONTENT END ===
1091
-
1092
- ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1093
-
1094
- ### 1. UI Components Inventory
1095
-
1096
- List EVERY UI component mentioned or implied:
1097
- | Component | Type | A11y Risk Level |
1098
- |-----------|------|-----------------|
1099
-
1100
- ### 2. WCAG 2.1 AA Risk Assessment
1101
-
1102
- For each component, assess against:
1103
- - Perceivable (text alternatives, captions, adaptable, distinguishable)
1104
- - Operable (keyboard, timing, seizures, navigation)
1105
- - Understandable (readable, predictable, input assistance)
1106
- - Robust (compatible with assistive tech)
1107
-
1108
- ### 3. Keyboard Navigation Requirements
1109
-
1110
- List ALL interactions that MUST support keyboard:
1111
- - [ ] Requirement 1
1112
- - [ ] Requirement 2
1113
- - ...
1114
-
1115
- ### 4. Screen Reader Considerations
1116
-
1117
- What must be announced? What ARIA roles needed?
1118
-
1119
- ### 5. Findings Summary
1120
-
1121
- | Finding | Severity | WCAG Criterion | Recommendation |
1122
- |---------|----------|----------------|----------------|
1123
-
1124
- Severity: Critical (blocker), Major (significant barrier), Minor (inconvenience)
1125
-
1126
- **MINIMUM: 3 findings or explicit "No accessibility risks identified after thorough analysis"**`,
1127
- subagent_type: "qe-accessibility-auditor",
1128
- run_in_background: true
1129
- })
1130
- ```
1131
-
1132
- ### IF HAS_SECURITY: Security Auditor (MANDATORY WHEN FLAGGED)
1133
-
1134
- ```
1135
- Task({
1136
- description: "Security threat modeling",
1137
- prompt: `You are qe-security-auditor. Your output quality is being audited.
1138
-
1139
- ## EPIC CONTENT
1140
-
1141
- === EPIC CONTENT START ===
1142
- [PASTE THE COMPLETE EPIC CONTENT HERE]
1143
- === EPIC CONTENT END ===
1144
-
1145
- ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1146
-
1147
- ### 1. STRIDE Threat Model
1148
-
1149
- Analyze against ALL SIX categories:
1150
-
1151
- | Threat Type | Applicable? | Threats Identified | Mitigations |
1152
- |-------------|-------------|-------------------|-------------|
1153
- | **S**poofing | Yes/No | ... | ... |
1154
- | **T**ampering | Yes/No | ... | ... |
1155
- | **R**epudiation | Yes/No | ... | ... |
1156
- | **I**nformation Disclosure | Yes/No | ... | ... |
1157
- | **D**enial of Service | Yes/No | ... | ... |
1158
- | **E**levation of Privilege | Yes/No | ... | ... |
1159
-
1160
- ### 2. Authentication/Authorization Requirements
1161
-
1162
- - Auth method required: ___
1163
- - Session management: ___
1164
- - Permission model: ___
1165
-
1166
- ### 3. Data Protection Concerns
1167
-
1168
- | Data Type | Classification | Protection Required |
1169
- |-----------|---------------|---------------------|
1170
- | ... | PII/Sensitive/Public | Encryption/Masking/None |
1171
-
1172
- ### 4. Compliance Implications
1173
-
1174
- Check ALL that apply:
1175
- - [ ] GDPR (EU user data)
1176
- - [ ] CCPA (California user data)
1177
- - [ ] SOC 2 (security controls)
1178
- - [ ] HIPAA (health data)
1179
- - [ ] PCI-DSS (payment data)
1180
- - [ ] Other: ___
1181
-
1182
- ### 5. Security Testing Requirements
1183
-
1184
- What security tests MUST be performed?
1185
-
1186
- **MINIMUM: Identify threats in at least 3 STRIDE categories**`,
1187
- subagent_type: "qe-security-auditor",
1188
- run_in_background: true
1189
- })
1190
- ```
1191
-
1192
- ### IF HAS_UX: QX Partner (MANDATORY WHEN FLAGGED)
1193
-
1194
- ```
1195
- Task({
1196
- description: "Quality Experience analysis",
1197
- prompt: `You are qe-qx-partner. Your output quality is being audited.
1198
-
1199
- ## METHODOLOGY
1200
-
1201
- Apply holistic-testing-pact methodology (PACT principles).
1202
-
1203
- ## EPIC CONTENT
1204
-
1205
- === EPIC CONTENT START ===
1206
- [PASTE THE COMPLETE EPIC CONTENT HERE]
1207
- === EPIC CONTENT END ===
1208
-
1209
- ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1210
-
1211
- ### 1. PACT Analysis
1212
-
1213
- | Dimension | Analysis |
1214
- |-----------|----------|
1215
- | **P**eople | Who are the users? Personas? Needs? |
1216
- | **A**ctivities | What are they trying to do? Goals? |
1217
- | **C**ontexts | Where/when/how do they use this? |
1218
- | **T**echnologies | What tech constraints exist? |
1219
-
1220
- ### 2. User Personas Affected
1221
-
1222
- | Persona | Impact Level | Key Concerns |
1223
- |---------|--------------|--------------|
1224
- | ... | High/Medium/Low | ... |
1225
-
1226
- ### 3. User Journey Impact
1227
-
1228
- Map affected touchpoints:
1229
- ```
1230
- [Entry] [Step 1] [Step 2] → [Exit]
1231
- ↑ Impact ↑ Impact
1232
- ```
1233
-
1234
- ### 4. Quality Experience Risks
1235
-
1236
- | QX Risk | User Feeling | Business Impact |
1237
- |---------|--------------|-----------------|
1238
- | ... | Frustrated/Confused/Delighted | ... |
1239
-
1240
- ### 5. UX Testing Recommendations
1241
-
1242
- What UX-specific tests are needed?
1243
- - Usability testing needs
1244
- - User research gaps
1245
- - A/B testing candidates
1246
-
1247
- **MINIMUM: Identify 3 QX risks or explicit "No QX risks after thorough analysis"**`,
1248
- subagent_type: "qe-qx-partner",
1249
- run_in_background: true
1250
- })
1251
- ```
1252
-
1253
- ### Alternative: MCP Tools for Conditional Agents
1254
-
1255
- ```javascript
1256
- // IF HAS_UI - Enable visual-accessibility domain
1257
- if (HAS_UI) {
1258
- mcp__agentic_qe__accessibility_test({
1259
- url: targetUrl, // if web-based
1260
- standard: "WCAG21AA"
1261
- })
1262
- }
1263
-
1264
- // IF HAS_SECURITY - Enable security-compliance domain
1265
- if (HAS_SECURITY) {
1266
- mcp__agentic_qe__security_scan_comprehensive({
1267
- target: "src/",
1268
- sast: true,
1269
- dast: false // No runtime yet in ideation
1270
- })
1271
- }
1272
-
1273
- // IF HAS_UX - Cross-domain analysis
1274
- if (HAS_UX) {
1275
- mcp__agentic_qe__task_orchestrate({
1276
- task: "qx-analysis",
1277
- strategy: "adaptive"
1278
- })
1279
- }
1280
- ```
1281
-
1282
- ### Alternative: CLI for Conditional Agents
1283
-
1284
- ```bash
1285
- # IF HAS_UI
1286
- if [ "$HAS_UI" = "TRUE" ]; then
1287
- npx @claude-flow/cli@latest agent spawn \
1288
- --type qe-accessibility-auditor \
1289
- --task "WCAG 2.1 AA assessment" &
1290
- fi
1291
-
1292
- # IF HAS_SECURITY
1293
- if [ "$HAS_SECURITY" = "TRUE" ]; then
1294
- npx @claude-flow/cli@latest agent spawn \
1295
- --type qe-security-auditor \
1296
- --task "STRIDE threat modeling" &
1297
- fi
1298
-
1299
- # IF HAS_UX
1300
- if [ "$HAS_UX" = "TRUE" ]; then
1301
- npx @claude-flow/cli@latest agent spawn \
1302
- --type qe-qx-partner \
1303
- --task "PACT quality experience analysis" &
1304
- fi
1305
-
1306
- # Wait for conditional agents
1307
- wait
1308
- ```
1309
-
1310
- ### Post-Spawn Confirmation (If Applicable)
1311
-
1312
- ```
1313
- I've launched [N] conditional agent(s) in parallel:
1314
-
1315
- [IF HAS_UI] ♿ qe-accessibility-auditor [Domain: visual-accessibility] - WCAG 2.1 AA assessment
1316
- [IF HAS_SECURITY] 🔒 qe-security-auditor [Domain: security-compliance] - STRIDE threat modeling
1317
- [IF HAS_UX] 💫 qe-qx-partner [Domain: cross-domain] - PACT quality experience analysis
1318
-
1319
- WAITING for conditional agents to complete...
1320
- ```
1321
-
1322
- ---
1323
-
1324
- ## PHASE 5: Synthesize Results & Determine Recommendation
1325
-
1326
- ### ⛔ ENFORCEMENT: EXACT DECISION LOGIC
1327
-
1328
- **You MUST apply this logic EXACTLY. No interpretation.**
1329
-
1330
- ```
1331
- STEP 1: Check NO-GO conditions (ANY triggers NO-GO)
1332
- ─────────────────────────────────────────────────
1333
- IF testabilityScore < 40 → NO-GO (reason: "Testability critically low")
1334
- IF htsmCoverage < 6 → NO-GO (reason: "Insufficient quality coverage")
1335
- IF acCompleteness < 50 → NO-GO (reason: "Acceptance criteria incomplete")
1336
- IF criticalRisks > 2 → NO-GO (reason: "Too many critical risks")
1337
-
1338
- STEP 2: Check GO conditions (ALL required for GO)
1339
- ─────────────────────────────────────────────────
1340
- IF testabilityScore >= 80
1341
- AND htsmCoverage >= 8
1342
- AND acCompleteness >= 90
1343
- AND criticalRisks == 0 → GO
1344
-
1345
- STEP 3: Default
1346
- ─────────────────────────────────────────────────
1347
- ELSE → CONDITIONAL
1348
- ```
1349
-
1350
- ### Decision Recording
1351
-
1352
- ```
1353
- METRICS:
1354
- - testabilityScore = __/100
1355
- - htsmCoverage = __/10
1356
- - acCompleteness = __%
1357
- - criticalRisks = __
1358
-
1359
- NO-GO CHECK:
1360
- - testabilityScore < 40? __ (YES/NO)
1361
- - htsmCoverage < 6? __ (YES/NO)
1362
- - acCompleteness < 50? __ (YES/NO)
1363
- - criticalRisks > 2? __ (YES/NO)
1364
-
1365
- GO CHECK (only if no NO-GO triggered):
1366
- - testabilityScore >= 80? __ (YES/NO)
1367
- - htsmCoverage >= 8? __ (YES/NO)
1368
- - acCompleteness >= 90? __ (YES/NO)
1369
- - criticalRisks == 0? __ (YES/NO)
1370
-
1371
- FINAL RECOMMENDATION: [GO / CONDITIONAL / NO-GO]
1372
- REASON: ___
1373
- ```
1374
-
1375
- ---
1376
-
1377
- ## PHASE 6: Generate Ideation Report
1378
-
1379
- ### ⛔ ENFORCEMENT: COMPLETE REPORT STRUCTURE
1380
-
1381
- **ALL sections below are MANDATORY. No abbreviations.**
1382
-
1383
- ```markdown
1384
- # QCSD Ideation Report: [Epic Name]
1385
-
1386
- **Generated**: [Date/Time]
1387
- **Recommendation**: [GO / CONDITIONAL / NO-GO]
1388
- **Agents Executed**: [List all agents that ran]
1389
-
1390
- ---
1391
-
1392
- ## Executive Summary
1393
-
1394
- | Metric | Value | Threshold | Status |
1395
- |--------|-------|-----------|--------|
1396
- | HTSM Coverage | X/10 | ≥8 | ✅/⚠️/❌ |
1397
- | Testability Score | X% | ≥80% | ✅/⚠️/❌ |
1398
- | AC Completeness | X% | ≥90% | ✅/⚠️/❌ |
1399
- | Critical Risks | X | 0 | ✅/⚠️/❌ |
1400
-
1401
- **Recommendation Rationale**: [1-2 sentences explaining why GO/CONDITIONAL/NO-GO]
1402
-
1403
- ---
1404
-
1405
- ## Quality Criteria Analysis (HTSM v6.3)
1406
-
1407
- [EMBED or LINK the HTML report from qe-quality-criteria-recommender]
1408
-
1409
- ### Priority Items Summary
1410
-
1411
- | Priority | Count | Categories |
1412
- |----------|-------|------------|
1413
- | P0 (Critical) | X | [list] |
1414
- | P1 (High) | X | [list] |
1415
- | P2 (Medium) | X | [list] |
1416
- | P3 (Low) | X | [list] |
1417
-
1418
- ### Cross-Cutting Concerns
1419
- [List any concerns that span multiple categories]
1420
-
1421
- ---
1422
-
1423
- ## Risk Assessment
1424
-
1425
- ### Risk Matrix
1426
-
1427
- | ID | Risk | Category | L | I | Score | Mitigation |
1428
- |----|------|----------|---|---|-------|------------|
1429
- [ALL risks from qe-risk-assessor, sorted by score]
1430
-
1431
- ### Critical Risks (Score ≥ 15)
1432
- [Highlight critical risks with detailed mitigation plans]
1433
-
1434
- ### Risk Distribution
1435
- - Technical: X risks
1436
- - Business: X risks
1437
- - Quality: X risks
1438
- - Integration: X risks
1439
-
1440
- ---
1441
-
1442
- ## Requirements Validation
1443
-
1444
- ### Testability Score: X/100
1445
-
1446
- | Principle | Score | Notes |
1447
- |-----------|-------|-------|
1448
- [All 10 principles from qe-requirements-validator]
1449
-
1450
- ### AC Completeness: X%
1451
-
1452
- | AC | Status | Issues |
1453
- |----|--------|--------|
1454
- [All ACs evaluated]
1455
-
1456
- ### Gaps Identified
1457
- 1. [Gap 1]
1458
- 2. [Gap 2]
1459
- [All gaps from qe-requirements-validator]
1460
-
1461
- ---
1462
-
1463
- ## Conditional Analysis
1464
-
1465
- [INCLUDE ONLY IF APPLICABLE - based on which conditional agents ran]
1466
-
1467
- ### Accessibility Review (IF HAS_UI)
1468
- [Full output from qe-accessibility-auditor]
1469
-
1470
- ### Security Assessment (IF HAS_SECURITY)
1471
- [Full output from qe-security-auditor]
1472
-
1473
- ### Quality Experience (IF HAS_UX)
1474
- [Full output from qe-qx-partner]
1475
-
1476
- ---
1477
-
1478
- ## Recommended Next Steps
1479
-
1480
- ### Immediate Actions (Before Development)
1481
- - [ ] [Action based on findings]
1482
- - [ ] [Action based on findings]
1483
-
1484
- ### During Development
1485
- - [ ] [Action based on findings]
1486
-
1487
- ### Pre-Release
1488
- - [ ] [Action based on findings]
1489
-
1490
- ---
1491
-
1492
- ## Appendix: Agent Outputs
1493
-
1494
- [Link to or embed full outputs from each agent]
1495
-
1496
- ---
1497
-
1498
- *Generated by QCSD Ideation Swarm v6.1*
1499
- *Execution Model: Task Tool Parallel Swarm*
1500
- ```
1501
-
1502
- ### Report Validation Checklist
1503
-
1504
- Before presenting report:
1505
- ```
1506
- ✓ Executive Summary table is complete with all 4 metrics
1507
- ✓ Recommendation matches decision logic output
1508
- Quality Criteria section includes priority summary
1509
- ✓ Risk Matrix includes ALL identified risks
1510
- Testability score shows all 10 principles
1511
- ✓ All gaps are listed
1512
- Conditional sections included for all spawned agents
1513
- Next steps are specific and actionable (not generic)
1514
- ```
1515
-
1516
- **❌ DO NOT present an incomplete report.**
1517
-
1518
- ---
1519
-
1520
- ## PHASE 7: Store Learnings & Persist State
1521
-
1522
- ### Purpose
1523
-
1524
- Store ideation findings for:
1525
- - Cross-phase feedback loops (Production → next Ideation cycle)
1526
- - Historical analysis of GO/CONDITIONAL/NO-GO decisions
1527
- - Pattern learning across epics
1528
-
1529
- ### Option A: MCP Memory Tools (RECOMMENDED)
1530
-
1531
- ```javascript
1532
- // Store ideation findings
1533
- mcp__agentic_qe__memory_store({
1534
- key: `qcsd-ideation-${epicId}-${Date.now()}`,
1535
- namespace: "qcsd-ideation",
1536
- value: {
1537
- epicId: epicId,
1538
- epicName: epicName,
1539
- recommendation: recommendation, // GO, CONDITIONAL, NO-GO
1540
- metrics: {
1541
- htsmCoverage: htsmCoverage,
1542
- testabilityScore: testabilityScore,
1543
- acCompleteness: acCompleteness,
1544
- criticalRisks: criticalRisks
1545
- },
1546
- domains: {
1547
- requirementsValidation: true,
1548
- coverageAnalysis: true,
1549
- securityCompliance: HAS_SECURITY,
1550
- visualAccessibility: HAS_UI,
1551
- crossDomain: HAS_UX
1552
- },
1553
- agentsInvoked: agentList,
1554
- timestamp: new Date().toISOString()
1555
- }
1556
- })
1557
-
1558
- // Share learnings with learning coordinator for cross-domain patterns
1559
- mcp__agentic_qe__memory_share({
1560
- sourceAgentId: "qcsd-ideation-swarm",
1561
- targetAgentIds: ["qe-learning-coordinator", "qe-pattern-learner"],
1562
- knowledgeDomain: "ideation-patterns"
1563
- })
1564
-
1565
- // Query previous ideation results for similar epics
1566
- mcp__agentic_qe__memory_query({
1567
- pattern: "qcsd-ideation-*",
1568
- namespace: "qcsd-ideation"
1569
- })
1570
- ```
1571
-
1572
- ### Option B: CLI Memory Commands
1573
-
1574
- ```bash
1575
- # Store ideation findings
1576
- npx @claude-flow/cli@latest memory store \
1577
- --key "qcsd-ideation-${EPIC_ID}" \
1578
- --value '{"recommendation":"GO","testabilityScore":85,"htsmCoverage":9}' \
1579
- --namespace qcsd-ideation
1580
-
1581
- # Search for similar epics
1582
- npx @claude-flow/cli@latest memory search \
1583
- --query "ideation recommendation" \
1584
- --namespace qcsd-ideation
1585
-
1586
- # List all ideation records
1587
- npx @claude-flow/cli@latest memory list \
1588
- --namespace qcsd-ideation
1589
-
1590
- # Post-task hook for learning
1591
- npx @claude-flow/cli@latest hooks post-task \
1592
- --task-id "qcsd-ideation-${EPIC_ID}" \
1593
- --success true
1594
- ```
1595
-
1596
- ### Option C: Direct File Storage (Fallback)
1597
-
1598
- If MCP/CLI not available, save to `.agentic-qe/`:
1599
-
1600
- ```bash
1601
- # Output directory structure
1602
- .agentic-qe/
1603
- ├── quality-criteria/
1604
- │ └── [epic-name]-htsm-analysis.html
1605
- ├── ideation-reports/
1606
- │ └── [epic-name]-ideation-report.md
1607
- └── learnings/
1608
- └── [epic-id]-ideation-metrics.json
1609
- ```
1610
-
1611
- ---
1612
-
1613
- ## Quick Reference
1614
-
1615
- ### Enforcement Summary
1616
-
1617
- | Phase | Must Do | Failure Condition |
1618
- |-------|---------|-------------------|
1619
- | 1 | Check ALL 3 flags | Missing flag evaluation |
1620
- | 2 | Spawn ALL 3 core agents in ONE message | Fewer than 3 Task calls |
1621
- | 3 | WAIT for completion | Proceeding before results |
1622
- | 4 | Spawn ALL flagged conditional agents | Skipping a TRUE flag |
1623
- | 5 | Apply EXACT decision logic | Wrong recommendation |
1624
- | 6 | Generate COMPLETE report | Missing sections |
1625
- | 7 | Store learnings (if MCP/CLI available) | Pattern loss |
1626
-
1627
- ### Quality Gate Thresholds
1628
-
1629
- | Metric | GO | CONDITIONAL | NO-GO |
1630
- |--------|-----|-------------|-------|
1631
- | Testability | ≥80% | 40-79% | <40% |
1632
- | HTSM Coverage | ≥8/10 | 6-7/10 | <6/10 |
1633
- | AC Completeness | ≥90% | 50-89% | <50% |
1634
- | Critical Risks | 0 | 1-2 | >2 |
1635
-
1636
- ### Domain-to-Agent Mapping
1637
-
1638
- | Domain | Agent | Primary Phase |
1639
- |--------|-------|---------------|
1640
- | requirements-validation | qe-quality-criteria-recommender | Ideation (P) |
1641
- | requirements-validation | qe-requirements-validator | Ideation (P) |
1642
- | coverage-analysis | qe-risk-assessor | Ideation (P) |
1643
- | security-compliance | qe-security-auditor | Ideation (S - conditional) |
1644
- | visual-accessibility | qe-accessibility-auditor | Ideation (S - conditional) |
1645
- | cross-domain | qe-qx-partner | Ideation (S - conditional) |
1646
-
1647
- ### Execution Model Quick Reference
1648
-
1649
- | Model | Initialization | Agent Spawn | Memory Store |
1650
- |-------|---------------|-------------|--------------|
1651
- | **Task Tool** | N/A | `Task({ subagent_type, run_in_background: true })` | N/A (use MCP) |
1652
- | **MCP Tools** | `fleet_init({})` | `task_submit({})` | `memory_store({})` |
1653
- | **CLI** | `swarm init` | `agent spawn` | `memory store` |
1654
-
1655
- ### MCP Tools Quick Reference
1656
-
1657
- ```javascript
1658
- // Initialization
1659
- mcp__agentic_qe__fleet_init({ topology: "hierarchical", enabledDomains: [...], maxAgents: 6 })
1660
-
1661
- // Task submission
1662
- mcp__agentic_qe__task_submit({ type: "...", priority: "p0", payload: {...} })
1663
- mcp__agentic_qe__task_orchestrate({ task: "...", strategy: "parallel" })
1664
-
1665
- // Status
1666
- mcp__agentic_qe__fleet_status({ verbose: true })
1667
- mcp__agentic_qe__task_list({ status: "pending" })
1668
-
1669
- // Memory
1670
- mcp__agentic_qe__memory_store({ key: "...", value: {...}, namespace: "qcsd-ideation" })
1671
- mcp__agentic_qe__memory_query({ pattern: "qcsd-*", namespace: "qcsd-ideation" })
1672
- mcp__agentic_qe__memory_share({ sourceAgentId: "...", targetAgentIds: [...], knowledgeDomain: "..." })
1673
- ```
1674
-
1675
- ### CLI Quick Reference
1676
-
1677
- ```bash
1678
- # Initialization
1679
- npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 6
1680
-
1681
- # Agent operations
1682
- npx @claude-flow/cli@latest agent spawn --type [agent-type] --task "[description]"
1683
- npx @claude-flow/cli@latest hooks pre-task --description "[task]"
1684
- npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
1685
-
1686
- # Status
1687
- npx @claude-flow/cli@latest swarm status
1688
-
1689
- # Memory
1690
- npx @claude-flow/cli@latest memory store --key "[key]" --value "[json]" --namespace qcsd-ideation
1691
- npx @claude-flow/cli@latest memory search --query "[query]" --namespace qcsd-ideation
1692
- npx @claude-flow/cli@latest memory list --namespace qcsd-ideation
1693
- ```
1694
-
1695
- ### Swarm Topology
1696
-
1697
- ```
1698
- QCSD IDEATION SWARM v7.0
1699
-
1700
- ┌───────────────┼───────────────┐
1701
- │ │ │
1702
- ┌────▼────┐ ┌─────▼─────┐ ┌─────▼─────┐
1703
- │Quality │ │ Risk │ │ AC │
1704
- │Criteria │ │ Assessor │ │ Validator │
1705
- (HTML) │ │ │ │ │
1706
- │─────────│ │───────────│ │───────────│
1707
- req-valid cov-anlysis│ │req-valid │
1708
- └────┬────┘ └─────┬─────┘ └─────┬─────┘
1709
-
1710
- └───────────────┼───────────────┘
1711
-
1712
- [QUALITY GATE]
1713
-
1714
- ┌───────────────┼───────────────┐
1715
- │ │ │
1716
- ┌────▼────┐ ┌─────▼─────┐ ┌─────▼─────┐
1717
- A11y │ │ Security │ │ QX │
1718
- [IF UI] │ │[IF AUTH] │ │ [IF UX] │
1719
- │─────────│ │───────────│ │───────────│
1720
- │vis-a11y │ │sec-compli │ │cross-dom │
1721
- └─────────┘ └───────────┘ └───────────┘
1722
- ```
1723
-
1724
- ---
1725
-
1726
- ## Inventory Summary
1727
-
1728
- | Resource Type | Count | Primary | Conditional |
1729
- |---------------|:-----:|:-------:|:-----------:|
1730
- | **Agents** | 6 | 3 | 3 |
1731
- | **Sub-agents** | 0 | - | - |
1732
- | **Skills** | 4 | 4 | - |
1733
- | **Domains** | 5 | 2 | 3 |
1734
-
1735
- **Skills Used:**
1736
- 1. `testability-scoring` - 10 testability principles
1737
- 2. `risk-based-testing` - Risk prioritization
1738
- 3. `context-driven-testing` - Context-appropriate strategy
1739
- 4. `holistic-testing-pact` - PACT methodology (People, Activities, Contexts, Technologies)
1740
-
1741
- ---
1742
-
1743
- ## Key Principle
1744
-
1745
- **Quality is built in from the start, not tested in at the end.**
1746
-
1747
- This swarm provides:
1748
- 1. **What quality criteria matter?** → HTSM Analysis (10 categories)
1749
- 2. **What risks exist?** → Risk Storming (4 categories)
1750
- 3. **Are requirements testable?** → AC Validation (10 principles)
1751
- 4. **Is it accessible/secure/good UX?** Conditional specialists
1752
- 5. **Should we proceed?** → GO/CONDITIONAL/NO-GO decision
1753
- 6. **What did we learn?** → Memory persistence for future cycles
1
+ ---
2
+ name: qcsd-ideation-swarm
3
+ description: "QCSD Ideation phase swarm for Quality Criteria sessions using HTSM v6.3, Risk Storming, and Testability analysis before development begins. Uses 5-tier browser cascade: Vibium → agent-browser → Playwright+Stealth → WebFetch → WebSearch-fallback."
4
+ category: qcsd-phases
5
+ priority: critical
6
+ version: 7.5.1
7
+ tokenEstimate: 3500
8
+ # DDD Domain Mapping (from QCSD-AGENTIC-QE-MAPPING-FRAMEWORK.md)
9
+ domains:
10
+ primary:
11
+ - domain: requirements-validation
12
+ agents: [qe-quality-criteria-recommender, qe-requirements-validator]
13
+ - domain: coverage-analysis
14
+ agents: [qe-risk-assessor]
15
+ conditional:
16
+ - domain: security-compliance
17
+ agents: [qe-security-auditor]
18
+ - domain: visual-accessibility
19
+ agents: [qe-accessibility-auditor]
20
+ - domain: cross-domain
21
+ agents: [qe-qx-partner]
22
+ # Agent Inventory
23
+ agents:
24
+ core: [qe-quality-criteria-recommender, qe-risk-assessor, qe-requirements-validator]
25
+ conditional: [qe-accessibility-auditor, qe-security-auditor, qe-qx-partner]
26
+ total: 6
27
+ sub_agents: 0
28
+ skills: [testability-scoring, risk-based-testing, context-driven-testing, holistic-testing-pact]
29
+ # Execution Models (Task Tool is PRIMARY)
30
+ execution:
31
+ primary: task-tool
32
+ alternatives: [mcp-tools, cli]
33
+ swarm_pattern: true
34
+ parallel_batches: 2
35
+ last_updated: 2026-01-28
36
+ # v7.5.1 Changelog: Added prominent follow-up recommendation box at end of swarm execution (Phase URL-9)
37
+ # v7.5.0 Changelog: Added HAS_VIDEO flag detection with /a11y-ally follow-up recommendation for video caption generation
38
+ # v7.4.0 Changelog: Automated browser cascade via scripts/fetch-content.js with 30s per-tier timeouts
39
+ # v7.2.0 Changelog: Added 5-tier browser cascade (Vibium → agent-browser → Playwright+Stealth → WebFetch → WebSearch)
40
+ html_output: true
41
+ enforcement_level: strict
42
+ tags: [qcsd, ideation, htsm, quality-criteria, risk-storming, testability, swarm, parallel, ddd]
43
+ trust_tier: 3
44
+ validation:
45
+ schema_path: schemas/output.json
46
+ validator_path: scripts/validate.sh
47
+ eval_path: evals/qcsd-ideation-swarm.yaml
48
+
49
+ ---
50
+
51
+ # QCSD Ideation Swarm v7.0
52
+
53
+ Shift-left quality engineering swarm for PI Planning and Sprint Planning.
54
+
55
+ ---
56
+
57
+ ## URL-Based Analysis Mode (v7.1)
58
+
59
+ When analyzing a live website URL, use this specialized execution pattern.
60
+
61
+ ### Parameters
62
+
63
+ - `URL`: Website to analyze (required)
64
+ - `OUTPUT_FOLDER`: Where to save reports (default: `${PROJECT_ROOT}/Agentic QCSD/{domain}/` or `./Agentic QCSD/{domain}/`)
65
+
66
+ ---
67
+
68
+ ## URL MODE: COMPLETE EXECUTION FLOW
69
+
70
+ **You MUST follow ALL phases in order. Skipping phases is a FAILURE.**
71
+
72
+ ### PHASE URL-1: Setup and Content Fetch (AUTOMATED CASCADE)
73
+
74
+ **The browser cascade is now FULLY AUTOMATED via `scripts/fetch-content.js`.**
75
+
76
+ **Single command - automatic tier fallback with 30s timeout per tier:**
77
+
78
+ ```bash
79
+ # SINGLE COMMAND - handles all tiers automatically:
80
+ # Use npx for installed package, or node with relative path for local development
81
+ npx aqe fetch-content "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
82
+ # OR if running from project root:
83
+ node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
84
+ ```
85
+
86
+ **What the script does automatically:**
87
+ 1. Creates output folder
88
+ 2. Tries Playwright+Stealth (30s timeout)
89
+ 3. Falls back to HTTP Fetch (30s timeout)
90
+ 4. Falls back to WebSearch placeholder (30s timeout)
91
+ 5. Saves `content.html`, `screenshot.png`, and `fetch-result.json`
92
+
93
+ **Execution:**
94
+
95
+ ```javascript
96
+ // 1. Run the automated fetch cascade (use relative path from project root)
97
+ const fetchResult = Bash({
98
+ command: `node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000`,
99
+ timeout: 120000 // 2 min total max
100
+ })
101
+
102
+ // 2. Parse the JSON result from stdout
103
+ const result = JSON.parse(fetchResult.stdout)
104
+
105
+ // 3. Read the content
106
+ const content = Read({ file_path: `${OUTPUT_FOLDER}/content.html` })
107
+ const fetchMethod = result.tier
108
+ const contentSize = result.contentSize
109
+ ```
110
+
111
+ **If script is not available, fall back to inline Playwright:**
112
+
113
+ ```javascript
114
+ // FALLBACK: Only if scripts/fetch-content.js doesn't exist
115
+ Bash({ command: `mkdir -p "${OUTPUT_FOLDER}"` })
116
+
117
+ // Quick Playwright fetch (single tier, no cascade)
118
+ Bash({
119
+ command: `cd /tmp && rm -rf qcsd-fetch && mkdir qcsd-fetch && cd qcsd-fetch && npm init -y && npm install playwright-extra puppeteer-extra-plugin-stealth playwright 2>/dev/null`,
120
+ timeout: 60000
121
+ })
122
+
123
+ // ... minimal inline script as last resort
124
+ ```
125
+
126
+ **MANDATORY: Output fetch method used:**
127
+ ```
128
+ ┌─────────────────────────────────────────────────────────────┐
129
+ CONTENT FETCH RESULT
130
+ ├─────────────────────────────────────────────────────────────┤
131
+ Method Used: [vibium/agent-browser/playwright/webfetch/
132
+ │ websearch-fallback] │
133
+ │ Content Size: [X KB] │
134
+ │ Status: [SUCCESS/DEGRADED] │
135
+ │ │
136
+ │ If DEGRADED (websearch-fallback), analysis is based on │
137
+ │ public information, not live page inspection.
138
+ └─────────────────────────────────────────────────────────────┘
139
+ ```
140
+
141
+ ### PHASE URL-2: Programmatic Flag Detection (MANDATORY)
142
+
143
+ **You MUST detect flags from the fetched content. Do NOT skip this phase.**
144
+
145
+ ```javascript
146
+ // Detect HAS_UI
147
+ const HAS_UI = (
148
+ /<(form|button|input|select|textarea|img|video|canvas|nav|header|footer|aside)/i.test(content) ||
149
+ /carousel|slider|modal|dialog|dropdown|menu|tab|accordion/i.test(content) ||
150
+ /class=["'][^"']*btn|button|card|grid|flex/i.test(content)
151
+ );
152
+
153
+ // Detect HAS_SECURITY
154
+ const HAS_SECURITY = (
155
+ /login|password|auth|token|session|credential|oauth|jwt|sso/i.test(content) ||
156
+ /newsletter|subscribe|signup|email.*input|register/i.test(content) || // PII collection
157
+ /payment|checkout|credit.*card|billing/i.test(content) ||
158
+ /cookie|consent|gdpr|privacy/i.test(content)
159
+ );
160
+
161
+ // Detect HAS_UX
162
+ const HAS_UX = (
163
+ /user|customer|visitor|journey|experience|engagement/i.test(content) ||
164
+ /<form/i.test(content) && /<button/i.test(content) || // Interactive forms
165
+ /onboarding|wizard|step.*step|progress/i.test(content) ||
166
+ /feedback|rating|review|comment/i.test(content)
167
+ );
168
+
169
+ // Detect HAS_VIDEO (for a11y-ally follow-up recommendation)
170
+ const HAS_VIDEO = (
171
+ /<video/i.test(content) ||
172
+ /youtube\.com\/embed|vimeo\.com|wistia\.com/i.test(content) ||
173
+ /\.mp4|\.webm|\.m3u8/i.test(content) ||
174
+ /data-video-url|data-mobile-url|data-desktop-url/i.test(content)
175
+ );
176
+ ```
177
+
178
+ **You MUST output flag detection results before proceeding:**
179
+
180
+ ```
181
+ ┌─────────────────────────────────────────────────────────────┐
182
+ FLAG DETECTION RESULTS
183
+ ├─────────────────────────────────────────────────────────────┤
184
+ │ │
185
+ HAS_UI: [TRUE/FALSE] │
186
+ │ Evidence: [what triggered it - specific patterns] │
187
+ │ │
188
+ HAS_SECURITY: [TRUE/FALSE] │
189
+ │ Evidence: [what triggered it - specific patterns] │
190
+ │ │
191
+ HAS_UX: [TRUE/FALSE]
192
+ Evidence: [what triggered it - specific patterns]
193
+
194
+ HAS_VIDEO: [TRUE/FALSE]
195
+ Evidence: [video URLs found - for a11y follow-up]
196
+
197
+ EXPECTED AGENTS:
198
+ - Core: 3 (always)
199
+ │ - Conditional: [count based on TRUE flags] │
200
+ │ - TOTAL: [3 + conditional count] │
201
+ │ │
202
+ │ FOLLOW-UP RECOMMENDED: │
203
+ │ - /a11y-ally: [YES if HAS_VIDEO=TRUE, else NO] │
204
+ │ │
205
+ └─────────────────────────────────────────────────────────────┘
206
+ ```
207
+
208
+ **❌ DO NOT proceed to Phase URL-3 without outputting flag detection results.**
209
+
210
+ ### PHASE URL-3: Spawn Core Agents (PARALLEL)
211
+
212
+ **All 3 core agents MUST be spawned. Fewer is a FAILURE.**
213
+
214
+ Spawn ALL THREE in a single message:
215
+
216
+ ```javascript
217
+ // Agent 1: Quality Criteria (HTSM v6.3)
218
+ Task({
219
+ description: "QCSD Quality Criteria Analysis",
220
+ prompt: `You are qe-quality-criteria-recommender analyzing ${URL}.
221
+
222
+ ## WEBSITE CONTENT
223
+ ${content}
224
+
225
+ ## ANALYSIS REQUIREMENTS
226
+ Analyze ALL 10 HTSM v6.3 categories with weight and testability score for each.
227
+
228
+ ## OUTPUT REQUIREMENTS (MANDATORY)
229
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/02-quality-criteria-analysis.md
230
+ 2. Use the Write tool to save BEFORE completing
231
+ 3. Report MUST be complete - no placeholders`,
232
+ subagent_type: "qe-quality-criteria-recommender",
233
+ run_in_background: true
234
+ })
235
+
236
+ // Agent 2: Risk Assessment (SFDIPOT)
237
+ Task({
238
+ description: "QCSD Risk Assessment",
239
+ prompt: `You are qe-risk-assessor analyzing ${URL}.
240
+
241
+ ## WEBSITE CONTENT
242
+ ${content}
243
+
244
+ ## ANALYSIS REQUIREMENTS
245
+ Apply SFDIPOT framework: Structure, Function, Data, Interfaces, Platform, Operations, Time.
246
+ Identify minimum 10 risks with probability, impact, and score.
247
+
248
+ ## OUTPUT REQUIREMENTS (MANDATORY)
249
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/04-risk-assessment.md
250
+ 2. Use the Write tool to save BEFORE completing
251
+ 3. Report MUST be complete - no placeholders`,
252
+ subagent_type: "qe-risk-assessor",
253
+ run_in_background: true
254
+ })
255
+
256
+ // Agent 3: Requirements Validator (Testability)
257
+ Task({
258
+ description: "QCSD Testability Assessment",
259
+ prompt: `You are qe-requirements-validator analyzing ${URL}.
260
+
261
+ ## WEBSITE CONTENT
262
+ ${content}
263
+
264
+ ## ANALYSIS REQUIREMENTS
265
+ Apply 10 Principles of Testability. Score each principle 0-100.
266
+ Identify blockers and recommendations.
267
+
268
+ ## OUTPUT REQUIREMENTS (MANDATORY)
269
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/03-testability-assessment.md
270
+ 2. Use the Write tool to save BEFORE completing
271
+ 3. Report MUST be complete - no placeholders`,
272
+ subagent_type: "qe-requirements-validator",
273
+ run_in_background: true
274
+ })
275
+ ```
276
+
277
+ ### PHASE URL-4: Spawn Conditional Agents (PARALLEL)
278
+
279
+ **Spawn agents based on flags detected in Phase URL-2.**
280
+
281
+ ```javascript
282
+ // IF HAS_UI === TRUE
283
+ Task({
284
+ description: "QCSD Accessibility Audit",
285
+ prompt: `You are qe-accessibility-auditor analyzing ${URL}.
286
+
287
+ ## WEBSITE CONTENT
288
+ ${content}
289
+
290
+ ## ANALYSIS REQUIREMENTS
291
+ Perform WCAG 2.2 AA compliance assessment.
292
+ Identify accessibility barriers, missing ARIA, color contrast issues.
293
+
294
+ ## OUTPUT REQUIREMENTS (MANDATORY)
295
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/07-accessibility-audit.md
296
+ 2. Use the Write tool to save BEFORE completing`,
297
+ subagent_type: "qe-accessibility-auditor",
298
+ run_in_background: true
299
+ })
300
+
301
+ // IF HAS_SECURITY === TRUE
302
+ Task({
303
+ description: "QCSD Security Threat Model",
304
+ prompt: `You are qe-security-auditor analyzing ${URL}.
305
+
306
+ ## WEBSITE CONTENT
307
+ ${content}
308
+
309
+ ## ANALYSIS REQUIREMENTS
310
+ Apply STRIDE threat modeling framework.
311
+ Identify vulnerabilities, attack vectors, and mitigations.
312
+
313
+ ## OUTPUT REQUIREMENTS (MANDATORY)
314
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/05-security-threat-model.md
315
+ 2. Use the Write tool to save BEFORE completing`,
316
+ subagent_type: "qe-security-auditor",
317
+ run_in_background: true
318
+ })
319
+
320
+ // IF HAS_UX === TRUE
321
+ Task({
322
+ description: "QCSD Quality Experience Analysis",
323
+ prompt: `You are qe-qx-partner analyzing ${URL}.
324
+
325
+ ## WEBSITE CONTENT
326
+ ${content}
327
+
328
+ ## ANALYSIS REQUIREMENTS
329
+ Analyze user journeys, experience quality, friction points.
330
+ Map key user flows and identify UX risks.
331
+
332
+ ## OUTPUT REQUIREMENTS (MANDATORY)
333
+ 1. Write your complete analysis to: ${OUTPUT_FOLDER}/08-quality-experience.md
334
+ 2. Use the Write tool to save BEFORE completing`,
335
+ subagent_type: "qe-qx-partner",
336
+ run_in_background: true
337
+ })
338
+ ```
339
+
340
+ ### PHASE URL-5: Agent Count Validation
341
+
342
+ **Before proceeding, verify agent count:**
343
+
344
+ ```
345
+ ┌─────────────────────────────────────────────────────────────┐
346
+ AGENT COUNT VALIDATION
347
+ ├─────────────────────────────────────────────────────────────┤
348
+
349
+ CORE AGENTS (ALWAYS 3):
350
+ │ □ qe-quality-criteria-recommender - SPAWNED? [Y/N]
351
+ │ □ qe-risk-assessor - SPAWNED? [Y/N]
352
+ □ qe-requirements-validator - SPAWNED? [Y/N]
353
+
354
+ CONDITIONAL AGENTS (based on flags):
355
+ qe-accessibility-auditor - SPAWNED? [Y/N] (HAS_UI)
356
+ □ qe-security-auditor - SPAWNED? [Y/N] (HAS_SECURITY)
357
+ □ qe-qx-partner - SPAWNED? [Y/N] (HAS_UX)
358
+
359
+ VALIDATION:
360
+ Expected agents: [3 + count of TRUE flags]
361
+ │ Actual spawned: [count] │
362
+ │ Status: [PASS/FAIL] │
363
+ │ │
364
+ │ If ACTUAL < EXPECTED, you have FAILED. Spawn missing │
365
+ │ agents before proceeding. │
366
+ │ │
367
+ └─────────────────────────────────────────────────────────────┘
368
+ ```
369
+
370
+ **❌ DO NOT proceed if validation FAILS.**
371
+
372
+ ### PHASE URL-6: Wait for Agents and Verify Reports
373
+
374
+ After spawning, inform user and wait:
375
+
376
+ ```
377
+ I've launched [N] agents in background:
378
+ - 📊 Quality Criteria Recommender: HTSM v6.3 analysis02-quality-criteria-analysis.md
379
+ - ⚠️ Risk Assessor: SFDIPOT analysis → 04-risk-assessment.md
380
+ - 🧪 Requirements Validator: Testability assessment03-testability-assessment.md
381
+ [IF HAS_UI]
382
+ - Accessibility Auditor: WCAG 2.2 audit → 07-accessibility-audit.md
383
+ [IF HAS_SECURITY]
384
+ - 🔒 Security Auditor: STRIDE threat model → 05-security-threat-model.md
385
+ [IF HAS_UX]
386
+ - 🎯 QX Partner: User experience analysis → 08-quality-experience.md
387
+
388
+ Each agent will write directly to: ${OUTPUT_FOLDER}/
389
+ ```
390
+
391
+ Verify reports exist before synthesis:
392
+ ```bash
393
+ ls -la "${OUTPUT_FOLDER}"
394
+ ```
395
+
396
+ ### PHASE URL-7: Invoke Related Skills (MANDATORY)
397
+
398
+ **After agent reports are complete, invoke these skills:**
399
+
400
+ ```javascript
401
+ // Testability Scoring - applies formal scoring methodology
402
+ Skill({ skill: "testability-scoring", args: `${OUTPUT_FOLDER}/03-testability-assessment.md` })
403
+
404
+ // Risk-Based Testing - prioritizes test selection
405
+ Skill({ skill: "risk-based-testing", args: `${OUTPUT_FOLDER}/04-risk-assessment.md` })
406
+ ```
407
+
408
+ **Required Skill Invocations:**
409
+
410
+ | Skill | When | Purpose |
411
+ |-------|------|---------|
412
+ | `testability-scoring` | After testability report | Formal 0-100 score calculation |
413
+ | `risk-based-testing` | After risk report | Test prioritization matrix |
414
+ | `context-driven-testing` | Always | Apply CDT principles to recommendations |
415
+ | `holistic-testing-pact` | Always | Validate test strategy completeness |
416
+
417
+ **❌ Analysis is INCOMPLETE without invoking related skills.**
418
+
419
+ ### PHASE URL-8: Synthesis and Executive Summary
420
+
421
+ After all agents complete and skills are invoked:
422
+
423
+ 1. **Read all agent reports**
424
+ 2. **Generate Executive Summary** `${OUTPUT_FOLDER}/01-executive-summary.md`
425
+ 3. **Generate Consolidated Test Ideas** → `${OUTPUT_FOLDER}/06-test-ideas.md`
426
+ 4. **Add Follow-up Recommendations** (if HAS_VIDEO=TRUE):
427
+ ```markdown
428
+ ## Recommended Follow-up Actions
429
+
430
+ | Action | Skill/Command | Reason |
431
+ |--------|---------------|--------|
432
+ | Generate Video Captions | `/a11y-ally ${URL}` | Video detected without captions - WCAG 1.2.2 compliance |
433
+ ```
434
+ 5. **Store learnings in memory**:
435
+ ```bash
436
+ npx @claude-flow/cli@latest memory store \
437
+ --key "qcsd-${domain}-pattern" \
438
+ --value "[key learnings from this analysis]" \
439
+ --namespace patterns
440
+ ```
441
+
442
+ **IMPORTANT:** If HAS_VIDEO=TRUE, the Executive Summary MUST include a "Recommended Follow-up Actions" section recommending `/a11y-ally` for video caption generation. This is NOT automatic - it's a recommendation for the user to run separately.
443
+
444
+ ### Report Filename Mapping
445
+
446
+ | Agent | Report Filename |
447
+ |-------|----------------|
448
+ | qe-quality-criteria-recommender | `02-quality-criteria-analysis.md` |
449
+ | qe-requirements-validator | `03-testability-assessment.md` |
450
+ | qe-risk-assessor | `04-risk-assessment.md` |
451
+ | qe-security-auditor | `05-security-threat-model.md` |
452
+ | qe-accessibility-auditor | `07-accessibility-audit.md` |
453
+ | qe-qx-partner | `08-quality-experience.md` |
454
+ | Synthesis | `01-executive-summary.md` |
455
+ | Synthesis | `06-test-ideas.md` |
456
+
457
+ ### PHASE URL-9: Final Output with Follow-up Recommendations (MANDATORY)
458
+
459
+ **At the very end of swarm execution, ALWAYS output this completion summary:**
460
+
461
+ ```
462
+ ┌─────────────────────────────────────────────────────────────────────┐
463
+ QCSD IDEATION SWARM COMPLETE
464
+ ├─────────────────────────────────────────────────────────────────────┤
465
+
466
+ URL Analyzed: ${URL}
467
+ Reports Generated: 8
468
+ Output Folder: ${OUTPUT_FOLDER}
469
+
470
+ QUALITY SCORES:
471
+ │ ├─ Risk Assessment: [score] │
472
+ │ ├─ Security Posture: [score] │
473
+ │ ├─ Quality Experience: [score] │
474
+ │ ├─ Testability: [score] │
475
+ │ └─ Accessibility: [score] │
476
+ │ │
477
+ └─────────────────────────────────────────────────────────────────────┘
478
+ ```
479
+
480
+ **IF HAS_VIDEO=TRUE, ALSO output this prominent recommendation box:**
481
+
482
+ ```
483
+ ┌─────────────────────────────────────────────────────────────────────┐
484
+ ⚠️ FOLLOW-UP ACTION RECOMMENDED
485
+ ├─────────────────────────────────────────────────────────────────────┤
486
+ │ │
487
+ VIDEO DETECTED WITHOUT CAPTIONS
488
+
489
+ To generate WCAG 1.2.2 compliant captions, run:
490
+
491
+ /a11y-ally ${URL}
492
+ │ │
493
+ │ This will: │
494
+ │ • Download video and extract frames │
495
+ │ • Analyze each frame with Claude Vision │
496
+ │ • Generate captions.vtt and audiodesc.vtt │
497
+ │ • Save to docs/accessibility-scans/{page-slug}/ │
498
+ │ │
499
+ └─────────────────────────────────────────────────────────────────────┘
500
+ ```
501
+
502
+ **❌ DO NOT end the swarm without displaying the completion summary.**
503
+ **❌ DO NOT skip the follow-up recommendation box if HAS_VIDEO=TRUE.**
504
+
505
+ ---
506
+
507
+ ## DDD Domain Integration
508
+
509
+ This swarm operates across **3 primary domains** and **3 conditional domains**:
510
+
511
+ ```
512
+ ┌─────────────────────────────────────────────────────────────────────────────┐
513
+ QCSD IDEATION - DOMAIN MAP
514
+ ├─────────────────────────────────────────────────────────────────────────────┤
515
+
516
+ PRIMARY DOMAINS (Always Active)
517
+ ┌─────────────────────────┐ ┌─────────────────────────┐
518
+ │ requirements-validation │ │ coverage-analysis │
519
+ ─────────────────────── │ │ ───────────────────── │ │
520
+ │ • qe-quality-criteria- │ │ • qe-risk-assessor
521
+ │ recommender (PRIMARY) │ │ │
522
+ │ │ qe-requirements- │ │
523
+ │ validator │ │ │
524
+ └─────────────────────────┘ └─────────────────────────┘
525
+
526
+ CONDITIONAL DOMAINS (Based on Epic Content)
527
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
528
+ security-complnce│ │visual-a11y │ │ cross-domain │ │
529
+ │ │─────────────────│ │─────────────────│ │─────────────────│ │
530
+ │ │qe-security- │ │qe-accessibility-│ │ qe-qx-partner │ │
531
+ │ │auditor │ │auditor │ │ │ │
532
+ │ │[IF HAS_SECURITY]│ │[IF HAS_UI] │ │[IF HAS_UX] │ │
533
+ │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
534
+ │ │
535
+ └─────────────────────────────────────────────────────────────────────────────┘
536
+ ```
537
+
538
+ ---
539
+
540
+ ## Execution Model Options
541
+
542
+ This skill supports **3 execution models**. Choose based on your environment:
543
+
544
+ | Model | When to Use | Pros | Cons |
545
+ |-------|-------------|------|------|
546
+ | **Task Tool** (PRIMARY) | Claude Code sessions | Full agent capabilities, parallel execution | Requires Claude Code |
547
+ | **MCP Tools** | MCP server available | Fleet coordination, memory persistence | Requires MCP setup |
548
+ | **CLI** | Terminal/scripts | Works anywhere, scriptable | Sequential only |
549
+
550
+ ### Quick Start by Model
551
+
552
+ **Option A: Task Tool (RECOMMENDED)**
553
+ ```
554
+ Just follow the skill phases below - uses Task() calls with run_in_background: true
555
+ ```
556
+
557
+ **Option B: MCP Tools**
558
+ ```javascript
559
+ // Initialize fleet for Ideation domains
560
+ mcp__agentic_qe__fleet_init({
561
+ topology: "hierarchical",
562
+ enabledDomains: ["requirements-validation", "coverage-analysis", "security-compliance"],
563
+ maxAgents: 6
564
+ })
565
+
566
+ // Orchestrate ideation task
567
+ mcp__agentic_qe__task_orchestrate({
568
+ task: "qcsd-ideation-analysis",
569
+ strategy: "parallel"
570
+ })
571
+ ```
572
+
573
+ **Option C: CLI**
574
+ ```bash
575
+ # Initialize coordination
576
+ npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 6
577
+
578
+ # Route task
579
+ npx @claude-flow/cli@latest hooks pre-task --description "QCSD Ideation for [Epic]"
580
+
581
+ # Execute agents
582
+ npx @claude-flow/cli@latest agent spawn --type qe-quality-criteria-recommender
583
+ npx @claude-flow/cli@latest agent spawn --type qe-risk-assessor
584
+ npx @claude-flow/cli@latest agent spawn --type qe-requirements-validator
585
+ ```
586
+
587
+ ---
588
+
589
+ ## ENFORCEMENT RULES - READ FIRST
590
+
591
+ **These rules are NON-NEGOTIABLE. Violation means skill execution failure.**
592
+
593
+ | Rule | Enforcement |
594
+ |------|-------------|
595
+ | **E1** | You MUST spawn ALL THREE core agents in Phase 2. No exceptions. |
596
+ | **E2** | You MUST put all parallel Task calls in a SINGLE message. |
597
+ | **E3** | You MUST STOP and WAIT after each batch. No proceeding early. |
598
+ | **E4** | You MUST spawn conditional agents if flags are TRUE. No skipping. |
599
+ | **E5** | You MUST apply GO/CONDITIONAL/NO-GO logic exactly as specified. |
600
+ | **E6** | You MUST generate the full report structure. No abbreviated versions. |
601
+ | **E7** | Each agent MUST read its reference files before analysis. |
602
+
603
+ **❌ PROHIBITED BEHAVIORS:**
604
+ - Summarizing instead of spawning agents
605
+ - Skipping agents "for brevity"
606
+ - Proceeding before background tasks complete
607
+ - Providing your own analysis instead of spawning specialists
608
+ - Omitting report sections
609
+ - Using placeholder text like "[details here]"
610
+
611
+ ---
612
+
613
+ ## PHASE 1: Analyze Epic Content
614
+
615
+ **⚠️ MANDATORY: You must complete this analysis before Phase 2.**
616
+
617
+ Scan the epic content and SET these flags. Do not skip any flag.
618
+
619
+ ### Flag Detection (Check ALL THREE)
620
+
621
+ ```
622
+ HAS_UI = FALSE
623
+ Set TRUE if epic contains ANY of: UI, frontend, visual, design,
624
+ component, screen, page, form, button, modal, dialog, dashboard,
625
+ widget, interface, display, view, layout, CSS, styling
626
+
627
+ HAS_SECURITY = FALSE
628
+ Set TRUE if epic contains ANY of: auth, security, credential, token,
629
+ encrypt, PII, compliance, password, login, session, OAuth, JWT,
630
+ permission, role, access control, RBAC, sensitive, private
631
+
632
+ HAS_UX = FALSE
633
+ Set TRUE if epic contains ANY of: user experience, UX, journey,
634
+ usability, satisfaction, user flow, persona, user research,
635
+ friction, delight, onboarding, retention, engagement
636
+ ```
637
+
638
+ ### Validation Checkpoint
639
+
640
+ Before proceeding to Phase 2, confirm:
641
+ ```
642
+ I have read the entire epic content
643
+ ✓ I have evaluated ALL THREE flags
644
+ ✓ I have recorded which flags are TRUE
645
+ ✓ I understand which conditional agents will be needed
646
+ ```
647
+
648
+ **❌ DO NOT proceed to Phase 2 until all checkboxes are confirmed.**
649
+
650
+ ---
651
+
652
+ ## PHASE 2: Spawn Core Agents (PARALLEL BATCH 1)
653
+
654
+ ### CRITICAL ENFORCEMENT
655
+
656
+ ```
657
+ ┌─────────────────────────────────────────────────────────────────┐
658
+ YOU MUST INCLUDE ALL THREE TASK CALLS IN YOUR NEXT MESSAGE
659
+
660
+ │ • Task 1: qe-quality-criteria-recommender │
661
+ │ • Task 2: qe-risk-assessor │
662
+ │ • Task 3: qe-requirements-validator │
663
+ │ │
664
+ │ If your message contains fewer than 3 Task calls, you have │
665
+ │ FAILED this phase. Start over. │
666
+ └─────────────────────────────────────────────────────────────────┘
667
+ ```
668
+
669
+ ### Domain Context
670
+
671
+ | Agent | Domain | MCP Tool Mapping |
672
+ |-------|--------|------------------|
673
+ | qe-quality-criteria-recommender | requirements-validation | `requirements_validate` |
674
+ | qe-risk-assessor | coverage-analysis | `defect_predict` |
675
+ | qe-requirements-validator | requirements-validation | `requirements_validate` |
676
+
677
+ ### Agent 1: Quality Criteria Recommender (PRIMARY)
678
+
679
+ **This agent MUST produce HTML output. No markdown substitutes.**
680
+
681
+ ```
682
+ Task({
683
+ description: "HTSM Quality Criteria analysis",
684
+ prompt: `You are qe-quality-criteria-recommender. Your output quality is being audited.
685
+
686
+ ## MANDATORY FIRST STEPS (DO NOT SKIP)
687
+
688
+ 1. READ this template file FIRST - your output MUST follow this structure:
689
+ .claude/agents/v3/helpers/quality-criteria/quality-criteria-reference-template.html
690
+
691
+ 2. READ these reference files for guidance:
692
+ .claude/agents/v3/helpers/quality-criteria/htsm-categories.md
693
+ .claude/agents/v3/helpers/quality-criteria/evidence-classification.md
694
+
695
+ ## EPIC TO ANALYZE
696
+
697
+ === EPIC CONTENT START ===
698
+ [PASTE THE COMPLETE EPIC CONTENT HERE - DO NOT SUMMARIZE]
699
+ === EPIC CONTENT END ===
700
+
701
+ ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
702
+
703
+ You MUST analyze ALL 10 HTSM categories. For each category provide:
704
+
705
+ | Field | Requirement |
706
+ |-------|-------------|
707
+ | Category Name | One of the 10 HTSM categories |
708
+ | Priority | P0, P1, P2, or P3 with justification |
709
+ | Evidence | At least 2 evidence points per category |
710
+ | Evidence Type | Direct (with file:line), Inferred (with reasoning), or Claimed (with "requires verification") |
711
+ | Quality Implication | What could go wrong |
712
+ | Business Impact | Quantified impact (use numbers, not "many" or "some") |
713
+
714
+ ### NEVER-OMIT CATEGORIES (Must include ALL 5):
715
+ 1. Capability - Can it perform required functions?
716
+ 2. Reliability - Will it resist failure?
717
+ 3. Security - How protected against unauthorized use?
718
+ 4. Performance - How speedy and responsive?
719
+ 5. Development - How testable/maintainable?
720
+
721
+ ### MAY-OMIT CATEGORIES (Only with ironclad justification):
722
+ 6. Usability, 7. Charisma, 8. Scalability, 9. Compatibility, 10. Installability
723
+
724
+ ## OUTPUT FORMAT
725
+
726
+ Generate COMPLETE HTML report using the template structure.
727
+ Save to: .agentic-qe/quality-criteria/[epic-name]-htsm-analysis.html
728
+
729
+ ## VALIDATION BEFORE SUBMITTING
730
+
731
+ Did I read the template file?
732
+ ✓ Did I analyze all 10 categories (or justify omissions)?
733
+ ✓ Does every evidence point have proper classification?
734
+ ✓ Are business impacts quantified with numbers?
735
+ Is output in HTML format using template structure?`,
736
+ subagent_type: "qe-quality-criteria-recommender",
737
+ run_in_background: true
738
+ })
739
+ ```
740
+
741
+ ### Agent 2: Risk Assessor
742
+
743
+ **This agent MUST identify at least 5 risks. Fewer is a failure.**
744
+
745
+ ```
746
+ Task({
747
+ description: "Risk Storming analysis",
748
+ prompt: `You are qe-risk-assessor. Your output quality is being audited.
749
+
750
+ ## METHODOLOGY
751
+
752
+ Apply risk-based-testing methodology systematically.
753
+
754
+ ## EPIC TO ANALYZE
755
+
756
+ === EPIC CONTENT START ===
757
+ [PASTE THE COMPLETE EPIC CONTENT HERE - DO NOT SUMMARIZE]
758
+ === EPIC CONTENT END ===
759
+
760
+ ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
761
+
762
+ ### Risk Identification Requirements
763
+
764
+ You MUST identify risks in ALL FOUR categories:
765
+ 1. **Technical Risks** - Architecture, integration, dependencies, complexity
766
+ 2. **Business Risks** - Revenue impact, user impact, compliance, reputation
767
+ 3. **Quality Risks** - Testability, maintainability, reliability concerns
768
+ 4. **Integration Risks** - Third-party services, APIs, data flows
769
+
770
+ **MINIMUM: 5 total risks. Target: 10+ risks.**
771
+
772
+ ### For EACH Risk, Provide:
773
+
774
+ | Field | Requirement |
775
+ |-------|-------------|
776
+ | Risk ID | R001, R002, etc. |
777
+ | Description | Specific, actionable description (not vague) |
778
+ | Category | Technical, Business, Quality, or Integration |
779
+ | Likelihood | 1-5 scale with justification |
780
+ | Impact | 1-5 scale with justification |
781
+ | Risk Score | Likelihood × Impact |
782
+ | Mitigation | Specific mitigation strategy |
783
+ | Owner | Suggested owner (Dev, QE, Product, Ops) |
784
+
785
+ ### Critical Risk Threshold
786
+ - Score ≥ 15 = CRITICAL (must be flagged prominently)
787
+ - Score 10-14 = HIGH
788
+ - Score 5-9 = MEDIUM
789
+ - Score < 5 = LOW
790
+
791
+ ## OUTPUT FORMAT
792
+
793
+ Markdown with:
794
+ 1. Executive Summary (top 3 risks in bold)
795
+ 2. Risk Matrix Table (sorted by score descending)
796
+ 3. Critical Risks Section (if any score ≥ 15)
797
+ 4. Mitigation Priority List
798
+
799
+ ## VALIDATION BEFORE SUBMITTING
800
+
801
+ Did I identify at least 5 risks?
802
+ ✓ Did I cover all 4 risk categories?
803
+ ✓ Does every risk have likelihood, impact, AND score?
804
+ ✓ Are critical risks (≥15) clearly flagged?
805
+ Does every risk have a specific mitigation?`,
806
+ subagent_type: "qe-risk-assessor",
807
+ run_in_background: true
808
+ })
809
+ ```
810
+
811
+ ### Agent 3: Requirements Validator
812
+
813
+ **This agent MUST provide testability score 0-100. No ranges.**
814
+
815
+ ```
816
+ Task({
817
+ description: "AC validation and testability scoring",
818
+ prompt: `You are qe-requirements-validator. Your output quality is being audited.
819
+
820
+ ## METHODOLOGY
821
+
822
+ Apply context-driven-testing and testability-scoring principles.
823
+
824
+ ## ACCEPTANCE CRITERIA TO VALIDATE
825
+
826
+ === ACCEPTANCE CRITERIA START ===
827
+ [PASTE THE COMPLETE ACCEPTANCE CRITERIA HERE - DO NOT SUMMARIZE]
828
+ === ACCEPTANCE CRITERIA END ===
829
+
830
+ ## REQUIRED OUTPUT (ALL SECTIONS MANDATORY)
831
+
832
+ ### 1. Testability Score (MANDATORY - SINGLE NUMBER)
833
+
834
+ Score each of the 10 testability principles (0-10 each):
835
+
836
+ | Principle | Score | Evidence |
837
+ |-----------|-------|----------|
838
+ | Controllability | X/10 | Can we control inputs/state? |
839
+ | Observability | X/10 | Can we observe outputs/behavior? |
840
+ | Isolability | X/10 | Can we test in isolation? |
841
+ | Separation of Concerns | X/10 | Are responsibilities clear? |
842
+ | Understandability | X/10 | Is behavior clearly specified? |
843
+ | Automatability | X/10 | Can tests be automated? |
844
+ | Heterogeneity | X/10 | Works across environments? |
845
+ | Simplicity | X/10 | Is complexity manageable? |
846
+ | Stability | X/10 | Are requirements stable? |
847
+ | Information Availability | X/10 | Do we have needed info? |
848
+
849
+ **TOTAL TESTABILITY SCORE: XX/100**
850
+
851
+ ### 2. AC Completeness Assessment
852
+
853
+ For EACH acceptance criterion:
854
+
855
+ | AC ID | Text | INVEST Score | Issues | Testable? |
856
+ |-------|------|--------------|--------|-----------|
857
+ | AC1 | ... | X/6 | ... | Yes/No |
858
+
859
+ INVEST Criteria:
860
+ - **I**ndependent (can be tested alone)
861
+ - **N**egotiable (not over-specified)
862
+ - **V**aluable (delivers value)
863
+ - **E**stimable (can estimate effort)
864
+ - **S**mall (testable in one session)
865
+ - **T**estable (clear pass/fail)
866
+
867
+ **AC COMPLETENESS: XX%** (ACs that are fully testable / total ACs)
868
+
869
+ ### 3. Gaps Identified (MANDATORY)
870
+
871
+ List ALL gaps found:
872
+ - Missing scenarios
873
+ - Unclear requirements
874
+ - Untestable criteria
875
+ - Ambiguous language
876
+ - Missing edge cases
877
+
878
+ **MINIMUM: Identify at least 3 gaps or explicitly state "No gaps found after thorough analysis"**
879
+
880
+ ### 4. Recommendations
881
+
882
+ Specific, actionable recommendations to improve testability.
883
+
884
+ ## VALIDATION BEFORE SUBMITTING
885
+
886
+ Did I score all 10 testability principles?
887
+ ✓ Did I calculate a single testability score (not a range)?
888
+ ✓ Did I assess every AC against INVEST?
889
+ ✓ Did I calculate AC completeness percentage?
890
+ Did I identify gaps (or explicitly confirm none)?`,
891
+ subagent_type: "qe-requirements-validator",
892
+ run_in_background: true
893
+ })
894
+ ```
895
+
896
+ ### Alternative: MCP Tools Execution
897
+
898
+ If using MCP instead of Task tool:
899
+
900
+ ```javascript
901
+ // Option 1: Orchestrate via Queen Coordinator
902
+ mcp__agentic_qe__fleet_init({
903
+ topology: "hierarchical",
904
+ enabledDomains: ["requirements-validation", "coverage-analysis"],
905
+ maxAgents: 6,
906
+ lazyLoading: true
907
+ })
908
+
909
+ // Submit tasks to specific domains
910
+ mcp__agentic_qe__task_submit({
911
+ type: "quality-criteria-analysis",
912
+ priority: "p0",
913
+ payload: {
914
+ epicContent: epicContent,
915
+ outputFormat: "html",
916
+ htsmVersion: "6.3"
917
+ }
918
+ })
919
+
920
+ mcp__agentic_qe__task_submit({
921
+ type: "risk-assessment",
922
+ priority: "p0",
923
+ payload: {
924
+ epicContent: epicContent,
925
+ riskCategories: ["technical", "business", "quality", "integration"]
926
+ }
927
+ })
928
+
929
+ mcp__agentic_qe__task_submit({
930
+ type: "requirements-validation",
931
+ priority: "p0",
932
+ payload: {
933
+ acceptanceCriteria: acContent,
934
+ scoreTestability: true,
935
+ validateInvest: true
936
+ }
937
+ })
938
+
939
+ // Check task status
940
+ mcp__agentic_qe__task_list({ status: "pending" })
941
+ ```
942
+
943
+ ### Alternative: CLI Execution
944
+
945
+ If using CLI instead of Task tool:
946
+
947
+ ```bash
948
+ # Initialize swarm for ideation
949
+ npx @claude-flow/cli@latest swarm init \
950
+ --topology hierarchical \
951
+ --max-agents 6 \
952
+ --strategy specialized
953
+
954
+ # Pre-task hook for routing
955
+ npx @claude-flow/cli@latest hooks pre-task \
956
+ --description "QCSD Ideation: Quality Criteria, Risk Assessment, AC Validation"
957
+
958
+ # Spawn agents (run in separate terminals or background)
959
+ npx @claude-flow/cli@latest agent spawn \
960
+ --type qe-quality-criteria-recommender \
961
+ --task "Analyze HTSM categories for epic" &
962
+
963
+ npx @claude-flow/cli@latest agent spawn \
964
+ --type qe-risk-assessor \
965
+ --task "Risk storming analysis" &
966
+
967
+ npx @claude-flow/cli@latest agent spawn \
968
+ --type qe-requirements-validator \
969
+ --task "AC validation and testability scoring" &
970
+
971
+ # Wait for completion
972
+ wait
973
+
974
+ # Check swarm status
975
+ npx @claude-flow/cli@latest swarm status
976
+ ```
977
+
978
+ ### Post-Spawn Confirmation
979
+
980
+ After sending all three Task calls, you MUST tell the user:
981
+
982
+ ```
983
+ I've launched 3 core agents in parallel:
984
+
985
+ 🎯 qe-quality-criteria-recommender [Domain: requirements-validation]
986
+ - Analyzing all 10 HTSM v6.3 categories
987
+ - Collecting evidence with classifications
988
+ - Generating HTML report
989
+
990
+ ⚠️ qe-risk-assessor [Domain: coverage-analysis]
991
+ - Identifying Technical, Business, Quality, Integration risks
992
+ - Scoring likelihood × impact
993
+ - Prioritizing mitigations
994
+
995
+ ✅ qe-requirements-validator [Domain: requirements-validation]
996
+ - Scoring testability (10 principles)
997
+ - Validating ACs against INVEST
998
+ - Identifying gaps
999
+
1000
+ ⏳ WAITING for all agents to complete before proceeding...
1001
+ ```
1002
+
1003
+ **❌ DO NOT proceed to Phase 3 until you have sent this confirmation.**
1004
+
1005
+ ---
1006
+
1007
+ ## PHASE 3: Wait for Batch 1 Completion
1008
+
1009
+ ### ENFORCEMENT: NO EARLY PROCEEDING
1010
+
1011
+ ```
1012
+ ┌─────────────────────────────────────────────────────────────────┐
1013
+ YOU MUST WAIT FOR ALL THREE BACKGROUND TASKS TO COMPLETE
1014
+
1015
+ │ ❌ DO NOT summarize what agents "would" find │
1016
+ │ ❌ DO NOT proceed to Phase 4 early │
1017
+ │ ❌ DO NOT provide your own analysis as substitute │
1018
+ │ │
1019
+ │ ✓ WAIT for actual agent results │
1020
+ │ ✓ ONLY proceed when all three have returned │
1021
+ └─────────────────────────────────────────────────────────────────┘
1022
+ ```
1023
+
1024
+ ### Results Extraction Checklist
1025
+
1026
+ When results return, extract and record:
1027
+
1028
+ ```
1029
+ From qe-quality-criteria-recommender:
1030
+ htsmCoverage = __/10 categories analyzed
1031
+ p0Count = __ P0 priority items
1032
+ □ evidenceQuality = Direct __%, Inferred __%, Claimed __%
1033
+
1034
+ From qe-risk-assessor:
1035
+ totalRisks = __ risks identified
1036
+ criticalRisks = __ risks with score ≥ 15
1037
+ □ topRiskScore = __ (highest score)
1038
+
1039
+ From qe-requirements-validator:
1040
+ □ testabilityScore = __/100
1041
+ □ acCompleteness = __%
1042
+ □ gapsIdentified = __ gaps
1043
+ ```
1044
+
1045
+ **❌ DO NOT proceed to Phase 4 until ALL fields are filled.**
1046
+
1047
+ ---
1048
+
1049
+ ## PHASE 4: Spawn Conditional Agents (PARALLEL BATCH 2)
1050
+
1051
+ ### ENFORCEMENT: NO SKIPPING CONDITIONAL AGENTS
1052
+
1053
+ ```
1054
+ ┌─────────────────────────────────────────────────────────────────┐
1055
+ IF A FLAG IS TRUE, YOU MUST SPAWN THAT AGENT
1056
+ │ │
1057
+ │ HAS_UI = TRUE → MUST spawn qe-accessibility-auditor │
1058
+ │ HAS_SECURITY = TRUE → MUST spawn qe-security-auditor │
1059
+ │ HAS_UX = TRUE → MUST spawn qe-qx-partner │
1060
+ │ │
1061
+ │ Skipping a flagged agent is a FAILURE of this skill. │
1062
+ └─────────────────────────────────────────────────────────────────┘
1063
+ ```
1064
+
1065
+ ### Conditional Domain Mapping
1066
+
1067
+ | Flag | Agent | Domain | MCP Tool |
1068
+ |------|-------|--------|----------|
1069
+ | HAS_UI | qe-accessibility-auditor | visual-accessibility | `accessibility_test` |
1070
+ | HAS_SECURITY | qe-security-auditor | security-compliance | `security_scan_comprehensive` |
1071
+ | HAS_UX | qe-qx-partner | cross-domain | `task_orchestrate` |
1072
+
1073
+ ### Decision Tree
1074
+
1075
+ ```
1076
+ IF HAS_UI == FALSE AND HAS_SECURITY == FALSE AND HAS_UX == FALSE:
1077
+ → Skip to Phase 5 (no conditional agents needed)
1078
+ → State: "No conditional agents needed based on epic analysis"
1079
+
1080
+ ELSE:
1081
+ → Spawn ALL applicable agents in ONE message
1082
+ → Count how many you're spawning: __
1083
+ ```
1084
+
1085
+ ### IF HAS_UI: Accessibility Auditor (MANDATORY WHEN FLAGGED)
1086
+
1087
+ ```
1088
+ Task({
1089
+ description: "Early accessibility review",
1090
+ prompt: `You are qe-accessibility-auditor. Your output quality is being audited.
1091
+
1092
+ ## EPIC CONTENT
1093
+
1094
+ === EPIC CONTENT START ===
1095
+ [PASTE THE COMPLETE EPIC CONTENT HERE]
1096
+ === EPIC CONTENT END ===
1097
+
1098
+ ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1099
+
1100
+ ### 1. UI Components Inventory
1101
+
1102
+ List EVERY UI component mentioned or implied:
1103
+ | Component | Type | A11y Risk Level |
1104
+ |-----------|------|-----------------|
1105
+
1106
+ ### 2. WCAG 2.1 AA Risk Assessment
1107
+
1108
+ For each component, assess against:
1109
+ - Perceivable (text alternatives, captions, adaptable, distinguishable)
1110
+ - Operable (keyboard, timing, seizures, navigation)
1111
+ - Understandable (readable, predictable, input assistance)
1112
+ - Robust (compatible with assistive tech)
1113
+
1114
+ ### 3. Keyboard Navigation Requirements
1115
+
1116
+ List ALL interactions that MUST support keyboard:
1117
+ - [ ] Requirement 1
1118
+ - [ ] Requirement 2
1119
+ - ...
1120
+
1121
+ ### 4. Screen Reader Considerations
1122
+
1123
+ What must be announced? What ARIA roles needed?
1124
+
1125
+ ### 5. Findings Summary
1126
+
1127
+ | Finding | Severity | WCAG Criterion | Recommendation |
1128
+ |---------|----------|----------------|----------------|
1129
+
1130
+ Severity: Critical (blocker), Major (significant barrier), Minor (inconvenience)
1131
+
1132
+ **MINIMUM: 3 findings or explicit "No accessibility risks identified after thorough analysis"**`,
1133
+ subagent_type: "qe-accessibility-auditor",
1134
+ run_in_background: true
1135
+ })
1136
+ ```
1137
+
1138
+ ### IF HAS_SECURITY: Security Auditor (MANDATORY WHEN FLAGGED)
1139
+
1140
+ ```
1141
+ Task({
1142
+ description: "Security threat modeling",
1143
+ prompt: `You are qe-security-auditor. Your output quality is being audited.
1144
+
1145
+ ## EPIC CONTENT
1146
+
1147
+ === EPIC CONTENT START ===
1148
+ [PASTE THE COMPLETE EPIC CONTENT HERE]
1149
+ === EPIC CONTENT END ===
1150
+
1151
+ ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1152
+
1153
+ ### 1. STRIDE Threat Model
1154
+
1155
+ Analyze against ALL SIX categories:
1156
+
1157
+ | Threat Type | Applicable? | Threats Identified | Mitigations |
1158
+ |-------------|-------------|-------------------|-------------|
1159
+ | **S**poofing | Yes/No | ... | ... |
1160
+ | **T**ampering | Yes/No | ... | ... |
1161
+ | **R**epudiation | Yes/No | ... | ... |
1162
+ | **I**nformation Disclosure | Yes/No | ... | ... |
1163
+ | **D**enial of Service | Yes/No | ... | ... |
1164
+ | **E**levation of Privilege | Yes/No | ... | ... |
1165
+
1166
+ ### 2. Authentication/Authorization Requirements
1167
+
1168
+ - Auth method required: ___
1169
+ - Session management: ___
1170
+ - Permission model: ___
1171
+
1172
+ ### 3. Data Protection Concerns
1173
+
1174
+ | Data Type | Classification | Protection Required |
1175
+ |-----------|---------------|---------------------|
1176
+ | ... | PII/Sensitive/Public | Encryption/Masking/None |
1177
+
1178
+ ### 4. Compliance Implications
1179
+
1180
+ Check ALL that apply:
1181
+ - [ ] GDPR (EU user data)
1182
+ - [ ] CCPA (California user data)
1183
+ - [ ] SOC 2 (security controls)
1184
+ - [ ] HIPAA (health data)
1185
+ - [ ] PCI-DSS (payment data)
1186
+ - [ ] Other: ___
1187
+
1188
+ ### 5. Security Testing Requirements
1189
+
1190
+ What security tests MUST be performed?
1191
+
1192
+ **MINIMUM: Identify threats in at least 3 STRIDE categories**`,
1193
+ subagent_type: "qe-security-auditor",
1194
+ run_in_background: true
1195
+ })
1196
+ ```
1197
+
1198
+ ### IF HAS_UX: QX Partner (MANDATORY WHEN FLAGGED)
1199
+
1200
+ ```
1201
+ Task({
1202
+ description: "Quality Experience analysis",
1203
+ prompt: `You are qe-qx-partner. Your output quality is being audited.
1204
+
1205
+ ## METHODOLOGY
1206
+
1207
+ Apply holistic-testing-pact methodology (PACT principles).
1208
+
1209
+ ## EPIC CONTENT
1210
+
1211
+ === EPIC CONTENT START ===
1212
+ [PASTE THE COMPLETE EPIC CONTENT HERE]
1213
+ === EPIC CONTENT END ===
1214
+
1215
+ ## REQUIRED ANALYSIS (ALL SECTIONS MANDATORY)
1216
+
1217
+ ### 1. PACT Analysis
1218
+
1219
+ | Dimension | Analysis |
1220
+ |-----------|----------|
1221
+ | **P**eople | Who are the users? Personas? Needs? |
1222
+ | **A**ctivities | What are they trying to do? Goals? |
1223
+ | **C**ontexts | Where/when/how do they use this? |
1224
+ | **T**echnologies | What tech constraints exist? |
1225
+
1226
+ ### 2. User Personas Affected
1227
+
1228
+ | Persona | Impact Level | Key Concerns |
1229
+ |---------|--------------|--------------|
1230
+ | ... | High/Medium/Low | ... |
1231
+
1232
+ ### 3. User Journey Impact
1233
+
1234
+ Map affected touchpoints:
1235
+ ```
1236
+ [Entry] [Step 1] [Step 2] [Exit]
1237
+ ↑ Impact ↑ Impact
1238
+ ```
1239
+
1240
+ ### 4. Quality Experience Risks
1241
+
1242
+ | QX Risk | User Feeling | Business Impact |
1243
+ |---------|--------------|-----------------|
1244
+ | ... | Frustrated/Confused/Delighted | ... |
1245
+
1246
+ ### 5. UX Testing Recommendations
1247
+
1248
+ What UX-specific tests are needed?
1249
+ - Usability testing needs
1250
+ - User research gaps
1251
+ - A/B testing candidates
1252
+
1253
+ **MINIMUM: Identify 3 QX risks or explicit "No QX risks after thorough analysis"**`,
1254
+ subagent_type: "qe-qx-partner",
1255
+ run_in_background: true
1256
+ })
1257
+ ```
1258
+
1259
+ ### Alternative: MCP Tools for Conditional Agents
1260
+
1261
+ ```javascript
1262
+ // IF HAS_UI - Enable visual-accessibility domain
1263
+ if (HAS_UI) {
1264
+ mcp__agentic_qe__accessibility_test({
1265
+ url: targetUrl, // if web-based
1266
+ standard: "WCAG21AA"
1267
+ })
1268
+ }
1269
+
1270
+ // IF HAS_SECURITY - Enable security-compliance domain
1271
+ if (HAS_SECURITY) {
1272
+ mcp__agentic_qe__security_scan_comprehensive({
1273
+ target: "src/",
1274
+ sast: true,
1275
+ dast: false // No runtime yet in ideation
1276
+ })
1277
+ }
1278
+
1279
+ // IF HAS_UX - Cross-domain analysis
1280
+ if (HAS_UX) {
1281
+ mcp__agentic_qe__task_orchestrate({
1282
+ task: "qx-analysis",
1283
+ strategy: "adaptive"
1284
+ })
1285
+ }
1286
+ ```
1287
+
1288
+ ### Alternative: CLI for Conditional Agents
1289
+
1290
+ ```bash
1291
+ # IF HAS_UI
1292
+ if [ "$HAS_UI" = "TRUE" ]; then
1293
+ npx @claude-flow/cli@latest agent spawn \
1294
+ --type qe-accessibility-auditor \
1295
+ --task "WCAG 2.1 AA assessment" &
1296
+ fi
1297
+
1298
+ # IF HAS_SECURITY
1299
+ if [ "$HAS_SECURITY" = "TRUE" ]; then
1300
+ npx @claude-flow/cli@latest agent spawn \
1301
+ --type qe-security-auditor \
1302
+ --task "STRIDE threat modeling" &
1303
+ fi
1304
+
1305
+ # IF HAS_UX
1306
+ if [ "$HAS_UX" = "TRUE" ]; then
1307
+ npx @claude-flow/cli@latest agent spawn \
1308
+ --type qe-qx-partner \
1309
+ --task "PACT quality experience analysis" &
1310
+ fi
1311
+
1312
+ # Wait for conditional agents
1313
+ wait
1314
+ ```
1315
+
1316
+ ### Post-Spawn Confirmation (If Applicable)
1317
+
1318
+ ```
1319
+ I've launched [N] conditional agent(s) in parallel:
1320
+
1321
+ [IF HAS_UI] ♿ qe-accessibility-auditor [Domain: visual-accessibility] - WCAG 2.1 AA assessment
1322
+ [IF HAS_SECURITY] 🔒 qe-security-auditor [Domain: security-compliance] - STRIDE threat modeling
1323
+ [IF HAS_UX] 💫 qe-qx-partner [Domain: cross-domain] - PACT quality experience analysis
1324
+
1325
+ ⏳ WAITING for conditional agents to complete...
1326
+ ```
1327
+
1328
+ ---
1329
+
1330
+ ## PHASE 5: Synthesize Results & Determine Recommendation
1331
+
1332
+ ### ⛔ ENFORCEMENT: EXACT DECISION LOGIC
1333
+
1334
+ **You MUST apply this logic EXACTLY. No interpretation.**
1335
+
1336
+ ```
1337
+ STEP 1: Check NO-GO conditions (ANY triggers NO-GO)
1338
+ ─────────────────────────────────────────────────
1339
+ IF testabilityScore < 40 → NO-GO (reason: "Testability critically low")
1340
+ IF htsmCoverage < 6 → NO-GO (reason: "Insufficient quality coverage")
1341
+ IF acCompleteness < 50 → NO-GO (reason: "Acceptance criteria incomplete")
1342
+ IF criticalRisks > 2 → NO-GO (reason: "Too many critical risks")
1343
+
1344
+ STEP 2: Check GO conditions (ALL required for GO)
1345
+ ─────────────────────────────────────────────────
1346
+ IF testabilityScore >= 80
1347
+ AND htsmCoverage >= 8
1348
+ AND acCompleteness >= 90
1349
+ AND criticalRisks == 0 → GO
1350
+
1351
+ STEP 3: Default
1352
+ ─────────────────────────────────────────────────
1353
+ ELSE → CONDITIONAL
1354
+ ```
1355
+
1356
+ ### Decision Recording
1357
+
1358
+ ```
1359
+ METRICS:
1360
+ - testabilityScore = __/100
1361
+ - htsmCoverage = __/10
1362
+ - acCompleteness = __%
1363
+ - criticalRisks = __
1364
+
1365
+ NO-GO CHECK:
1366
+ - testabilityScore < 40? __ (YES/NO)
1367
+ - htsmCoverage < 6? __ (YES/NO)
1368
+ - acCompleteness < 50? __ (YES/NO)
1369
+ - criticalRisks > 2? __ (YES/NO)
1370
+
1371
+ GO CHECK (only if no NO-GO triggered):
1372
+ - testabilityScore >= 80? __ (YES/NO)
1373
+ - htsmCoverage >= 8? __ (YES/NO)
1374
+ - acCompleteness >= 90? __ (YES/NO)
1375
+ - criticalRisks == 0? __ (YES/NO)
1376
+
1377
+ FINAL RECOMMENDATION: [GO / CONDITIONAL / NO-GO]
1378
+ REASON: ___
1379
+ ```
1380
+
1381
+ ---
1382
+
1383
+ ## PHASE 6: Generate Ideation Report
1384
+
1385
+ ### ⛔ ENFORCEMENT: COMPLETE REPORT STRUCTURE
1386
+
1387
+ **ALL sections below are MANDATORY. No abbreviations.**
1388
+
1389
+ ```markdown
1390
+ # QCSD Ideation Report: [Epic Name]
1391
+
1392
+ **Generated**: [Date/Time]
1393
+ **Recommendation**: [GO / CONDITIONAL / NO-GO]
1394
+ **Agents Executed**: [List all agents that ran]
1395
+
1396
+ ---
1397
+
1398
+ ## Executive Summary
1399
+
1400
+ | Metric | Value | Threshold | Status |
1401
+ |--------|-------|-----------|--------|
1402
+ | HTSM Coverage | X/10 | ≥8 | ✅/⚠️/❌ |
1403
+ | Testability Score | X% | ≥80% | ✅/⚠️/❌ |
1404
+ | AC Completeness | X% | ≥90% | ✅/⚠️/❌ |
1405
+ | Critical Risks | X | 0 | ✅/⚠️/❌ |
1406
+
1407
+ **Recommendation Rationale**: [1-2 sentences explaining why GO/CONDITIONAL/NO-GO]
1408
+
1409
+ ---
1410
+
1411
+ ## Quality Criteria Analysis (HTSM v6.3)
1412
+
1413
+ [EMBED or LINK the HTML report from qe-quality-criteria-recommender]
1414
+
1415
+ ### Priority Items Summary
1416
+
1417
+ | Priority | Count | Categories |
1418
+ |----------|-------|------------|
1419
+ | P0 (Critical) | X | [list] |
1420
+ | P1 (High) | X | [list] |
1421
+ | P2 (Medium) | X | [list] |
1422
+ | P3 (Low) | X | [list] |
1423
+
1424
+ ### Cross-Cutting Concerns
1425
+ [List any concerns that span multiple categories]
1426
+
1427
+ ---
1428
+
1429
+ ## Risk Assessment
1430
+
1431
+ ### Risk Matrix
1432
+
1433
+ | ID | Risk | Category | L | I | Score | Mitigation |
1434
+ |----|------|----------|---|---|-------|------------|
1435
+ [ALL risks from qe-risk-assessor, sorted by score]
1436
+
1437
+ ### Critical Risks (Score ≥ 15)
1438
+ [Highlight critical risks with detailed mitigation plans]
1439
+
1440
+ ### Risk Distribution
1441
+ - Technical: X risks
1442
+ - Business: X risks
1443
+ - Quality: X risks
1444
+ - Integration: X risks
1445
+
1446
+ ---
1447
+
1448
+ ## Requirements Validation
1449
+
1450
+ ### Testability Score: X/100
1451
+
1452
+ | Principle | Score | Notes |
1453
+ |-----------|-------|-------|
1454
+ [All 10 principles from qe-requirements-validator]
1455
+
1456
+ ### AC Completeness: X%
1457
+
1458
+ | AC | Status | Issues |
1459
+ |----|--------|--------|
1460
+ [All ACs evaluated]
1461
+
1462
+ ### Gaps Identified
1463
+ 1. [Gap 1]
1464
+ 2. [Gap 2]
1465
+ [All gaps from qe-requirements-validator]
1466
+
1467
+ ---
1468
+
1469
+ ## Conditional Analysis
1470
+
1471
+ [INCLUDE ONLY IF APPLICABLE - based on which conditional agents ran]
1472
+
1473
+ ### Accessibility Review (IF HAS_UI)
1474
+ [Full output from qe-accessibility-auditor]
1475
+
1476
+ ### Security Assessment (IF HAS_SECURITY)
1477
+ [Full output from qe-security-auditor]
1478
+
1479
+ ### Quality Experience (IF HAS_UX)
1480
+ [Full output from qe-qx-partner]
1481
+
1482
+ ---
1483
+
1484
+ ## Recommended Next Steps
1485
+
1486
+ ### Immediate Actions (Before Development)
1487
+ - [ ] [Action based on findings]
1488
+ - [ ] [Action based on findings]
1489
+
1490
+ ### During Development
1491
+ - [ ] [Action based on findings]
1492
+
1493
+ ### Pre-Release
1494
+ - [ ] [Action based on findings]
1495
+
1496
+ ---
1497
+
1498
+ ## Appendix: Agent Outputs
1499
+
1500
+ [Link to or embed full outputs from each agent]
1501
+
1502
+ ---
1503
+
1504
+ *Generated by QCSD Ideation Swarm v6.1*
1505
+ *Execution Model: Task Tool Parallel Swarm*
1506
+ ```
1507
+
1508
+ ### Report Validation Checklist
1509
+
1510
+ Before presenting report:
1511
+ ```
1512
+ Executive Summary table is complete with all 4 metrics
1513
+ Recommendation matches decision logic output
1514
+ ✓ Quality Criteria section includes priority summary
1515
+ ✓ Risk Matrix includes ALL identified risks
1516
+ Testability score shows all 10 principles
1517
+ ✓ All gaps are listed
1518
+ ✓ Conditional sections included for all spawned agents
1519
+ ✓ Next steps are specific and actionable (not generic)
1520
+ ```
1521
+
1522
+ **❌ DO NOT present an incomplete report.**
1523
+
1524
+ ---
1525
+
1526
+ ## PHASE 7: Store Learnings & Persist State
1527
+
1528
+ ### Purpose
1529
+
1530
+ Store ideation findings for:
1531
+ - Cross-phase feedback loops (Production → next Ideation cycle)
1532
+ - Historical analysis of GO/CONDITIONAL/NO-GO decisions
1533
+ - Pattern learning across epics
1534
+
1535
+ ### Option A: MCP Memory Tools (RECOMMENDED)
1536
+
1537
+ ```javascript
1538
+ // Store ideation findings
1539
+ mcp__agentic_qe__memory_store({
1540
+ key: `qcsd-ideation-${epicId}-${Date.now()}`,
1541
+ namespace: "qcsd-ideation",
1542
+ value: {
1543
+ epicId: epicId,
1544
+ epicName: epicName,
1545
+ recommendation: recommendation, // GO, CONDITIONAL, NO-GO
1546
+ metrics: {
1547
+ htsmCoverage: htsmCoverage,
1548
+ testabilityScore: testabilityScore,
1549
+ acCompleteness: acCompleteness,
1550
+ criticalRisks: criticalRisks
1551
+ },
1552
+ domains: {
1553
+ requirementsValidation: true,
1554
+ coverageAnalysis: true,
1555
+ securityCompliance: HAS_SECURITY,
1556
+ visualAccessibility: HAS_UI,
1557
+ crossDomain: HAS_UX
1558
+ },
1559
+ agentsInvoked: agentList,
1560
+ timestamp: new Date().toISOString()
1561
+ }
1562
+ })
1563
+
1564
+ // Share learnings with learning coordinator for cross-domain patterns
1565
+ mcp__agentic_qe__memory_share({
1566
+ sourceAgentId: "qcsd-ideation-swarm",
1567
+ targetAgentIds: ["qe-learning-coordinator", "qe-pattern-learner"],
1568
+ knowledgeDomain: "ideation-patterns"
1569
+ })
1570
+
1571
+ // Query previous ideation results for similar epics
1572
+ mcp__agentic_qe__memory_query({
1573
+ pattern: "qcsd-ideation-*",
1574
+ namespace: "qcsd-ideation"
1575
+ })
1576
+ ```
1577
+
1578
+ ### Option B: CLI Memory Commands
1579
+
1580
+ ```bash
1581
+ # Store ideation findings
1582
+ npx @claude-flow/cli@latest memory store \
1583
+ --key "qcsd-ideation-${EPIC_ID}" \
1584
+ --value '{"recommendation":"GO","testabilityScore":85,"htsmCoverage":9}' \
1585
+ --namespace qcsd-ideation
1586
+
1587
+ # Search for similar epics
1588
+ npx @claude-flow/cli@latest memory search \
1589
+ --query "ideation recommendation" \
1590
+ --namespace qcsd-ideation
1591
+
1592
+ # List all ideation records
1593
+ npx @claude-flow/cli@latest memory list \
1594
+ --namespace qcsd-ideation
1595
+
1596
+ # Post-task hook for learning
1597
+ npx @claude-flow/cli@latest hooks post-task \
1598
+ --task-id "qcsd-ideation-${EPIC_ID}" \
1599
+ --success true
1600
+ ```
1601
+
1602
+ ### Option C: Direct File Storage (Fallback)
1603
+
1604
+ If MCP/CLI not available, save to `.agentic-qe/`:
1605
+
1606
+ ```bash
1607
+ # Output directory structure
1608
+ .agentic-qe/
1609
+ ├── quality-criteria/
1610
+ │ └── [epic-name]-htsm-analysis.html
1611
+ ├── ideation-reports/
1612
+ │ └── [epic-name]-ideation-report.md
1613
+ └── learnings/
1614
+ └── [epic-id]-ideation-metrics.json
1615
+ ```
1616
+
1617
+ ---
1618
+
1619
+ ## Quick Reference
1620
+
1621
+ ### Enforcement Summary
1622
+
1623
+ | Phase | Must Do | Failure Condition |
1624
+ |-------|---------|-------------------|
1625
+ | 1 | Check ALL 3 flags | Missing flag evaluation |
1626
+ | 2 | Spawn ALL 3 core agents in ONE message | Fewer than 3 Task calls |
1627
+ | 3 | WAIT for completion | Proceeding before results |
1628
+ | 4 | Spawn ALL flagged conditional agents | Skipping a TRUE flag |
1629
+ | 5 | Apply EXACT decision logic | Wrong recommendation |
1630
+ | 6 | Generate COMPLETE report | Missing sections |
1631
+ | 7 | Store learnings (if MCP/CLI available) | Pattern loss |
1632
+
1633
+ ### Quality Gate Thresholds
1634
+
1635
+ | Metric | GO | CONDITIONAL | NO-GO |
1636
+ |--------|-----|-------------|-------|
1637
+ | Testability | ≥80% | 40-79% | <40% |
1638
+ | HTSM Coverage | ≥8/10 | 6-7/10 | <6/10 |
1639
+ | AC Completeness | ≥90% | 50-89% | <50% |
1640
+ | Critical Risks | 0 | 1-2 | >2 |
1641
+
1642
+ ### Domain-to-Agent Mapping
1643
+
1644
+ | Domain | Agent | Primary Phase |
1645
+ |--------|-------|---------------|
1646
+ | requirements-validation | qe-quality-criteria-recommender | Ideation (P) |
1647
+ | requirements-validation | qe-requirements-validator | Ideation (P) |
1648
+ | coverage-analysis | qe-risk-assessor | Ideation (P) |
1649
+ | security-compliance | qe-security-auditor | Ideation (S - conditional) |
1650
+ | visual-accessibility | qe-accessibility-auditor | Ideation (S - conditional) |
1651
+ | cross-domain | qe-qx-partner | Ideation (S - conditional) |
1652
+
1653
+ ### Execution Model Quick Reference
1654
+
1655
+ | Model | Initialization | Agent Spawn | Memory Store |
1656
+ |-------|---------------|-------------|--------------|
1657
+ | **Task Tool** | N/A | `Task({ subagent_type, run_in_background: true })` | N/A (use MCP) |
1658
+ | **MCP Tools** | `fleet_init({})` | `task_submit({})` | `memory_store({})` |
1659
+ | **CLI** | `swarm init` | `agent spawn` | `memory store` |
1660
+
1661
+ ### MCP Tools Quick Reference
1662
+
1663
+ ```javascript
1664
+ // Initialization
1665
+ mcp__agentic_qe__fleet_init({ topology: "hierarchical", enabledDomains: [...], maxAgents: 6 })
1666
+
1667
+ // Task submission
1668
+ mcp__agentic_qe__task_submit({ type: "...", priority: "p0", payload: {...} })
1669
+ mcp__agentic_qe__task_orchestrate({ task: "...", strategy: "parallel" })
1670
+
1671
+ // Status
1672
+ mcp__agentic_qe__fleet_status({ verbose: true })
1673
+ mcp__agentic_qe__task_list({ status: "pending" })
1674
+
1675
+ // Memory
1676
+ mcp__agentic_qe__memory_store({ key: "...", value: {...}, namespace: "qcsd-ideation" })
1677
+ mcp__agentic_qe__memory_query({ pattern: "qcsd-*", namespace: "qcsd-ideation" })
1678
+ mcp__agentic_qe__memory_share({ sourceAgentId: "...", targetAgentIds: [...], knowledgeDomain: "..." })
1679
+ ```
1680
+
1681
+ ### CLI Quick Reference
1682
+
1683
+ ```bash
1684
+ # Initialization
1685
+ npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 6
1686
+
1687
+ # Agent operations
1688
+ npx @claude-flow/cli@latest agent spawn --type [agent-type] --task "[description]"
1689
+ npx @claude-flow/cli@latest hooks pre-task --description "[task]"
1690
+ npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
1691
+
1692
+ # Status
1693
+ npx @claude-flow/cli@latest swarm status
1694
+
1695
+ # Memory
1696
+ npx @claude-flow/cli@latest memory store --key "[key]" --value "[json]" --namespace qcsd-ideation
1697
+ npx @claude-flow/cli@latest memory search --query "[query]" --namespace qcsd-ideation
1698
+ npx @claude-flow/cli@latest memory list --namespace qcsd-ideation
1699
+ ```
1700
+
1701
+ ### Swarm Topology
1702
+
1703
+ ```
1704
+ QCSD IDEATION SWARM v7.0
1705
+
1706
+ ┌───────────────┼───────────────┐
1707
+
1708
+ ┌────▼────┐ ┌─────▼─────┐ ┌─────▼─────┐
1709
+ Quality Risk │ │ AC │
1710
+ │Criteria │ │ Assessor │ │ Validator │
1711
+ (HTML) │ │ │ │ │
1712
+ │─────────│ │───────────│ │───────────│
1713
+ req-valid│ │cov-anlysis│ │req-valid │
1714
+ └────┬────┘ └─────┬─────┘ └─────┬─────┘
1715
+ │ │ │
1716
+ └───────────────┼───────────────┘
1717
+
1718
+ [QUALITY GATE]
1719
+
1720
+ ┌───────────────┼───────────────┐
1721
+ │ │ │
1722
+ ┌────▼────┐ ┌─────▼─────┐ ┌─────▼─────┐
1723
+ │ A11y │ │ Security │ │ QX │
1724
+ │[IF UI] │ │[IF AUTH] │ │ [IF UX] │
1725
+ │─────────│ │───────────│ │───────────│
1726
+ │vis-a11y │ │sec-compli │ │cross-dom │
1727
+ └─────────┘ └───────────┘ └───────────┘
1728
+ ```
1729
+
1730
+ ---
1731
+
1732
+ ## Inventory Summary
1733
+
1734
+ | Resource Type | Count | Primary | Conditional |
1735
+ |---------------|:-----:|:-------:|:-----------:|
1736
+ | **Agents** | 6 | 3 | 3 |
1737
+ | **Sub-agents** | 0 | - | - |
1738
+ | **Skills** | 4 | 4 | - |
1739
+ | **Domains** | 5 | 2 | 3 |
1740
+
1741
+ **Skills Used:**
1742
+ 1. `testability-scoring` - 10 testability principles
1743
+ 2. `risk-based-testing` - Risk prioritization
1744
+ 3. `context-driven-testing` - Context-appropriate strategy
1745
+ 4. `holistic-testing-pact` - PACT methodology (People, Activities, Contexts, Technologies)
1746
+
1747
+ ---
1748
+
1749
+ ## Key Principle
1750
+
1751
+ **Quality is built in from the start, not tested in at the end.**
1752
+
1753
+ This swarm provides:
1754
+ 1. **What quality criteria matter?** → HTSM Analysis (10 categories)
1755
+ 2. **What risks exist?** → Risk Storming (4 categories)
1756
+ 3. **Are requirements testable?** → AC Validation (10 principles)
1757
+ 4. **Is it accessible/secure/good UX?** → Conditional specialists
1758
+ 5. **Should we proceed?** → GO/CONDITIONAL/NO-GO decision
1759
+ 6. **What did we learn?** → Memory persistence for future cycles