code-ai-installer 4.0.0 → 4.0.1-a

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 (471) hide show
  1. package/README.md +83 -67
  2. package/dist/index.js +2 -0
  3. package/dist/mcp/audit_ledger.d.ts +12 -0
  4. package/dist/mcp/audit_ledger.js +82 -0
  5. package/dist/mcp/cli.js +7 -1
  6. package/dist/mcp/config.d.ts +23 -0
  7. package/dist/mcp/config.js +36 -0
  8. package/dist/mcp/index.d.ts +1 -2
  9. package/dist/mcp/index.js +1 -2
  10. package/dist/mcp/paths.d.ts +20 -2
  11. package/dist/mcp/paths.js +29 -5
  12. package/dist/mcp/proposal_dedup.d.ts +32 -0
  13. package/dist/mcp/proposal_dedup.js +102 -0
  14. package/dist/mcp/proposal_store.d.ts +18 -0
  15. package/dist/mcp/proposal_store.js +74 -0
  16. package/dist/mcp/scorecard.d.ts +140 -0
  17. package/dist/mcp/scorecard.js +103 -0
  18. package/dist/mcp/skill_invocations.d.ts +15 -0
  19. package/dist/mcp/skill_invocations.js +28 -0
  20. package/dist/mcp/task_state.d.ts +77 -2
  21. package/dist/mcp/tools/_subprocess.d.ts +16 -0
  22. package/dist/mcp/tools/_subprocess.js +56 -0
  23. package/dist/mcp/tools/advance_gate.js +2 -2
  24. package/dist/mcp/tools/aggregate_run_metrics.d.ts +19 -0
  25. package/dist/mcp/tools/aggregate_run_metrics.js +139 -0
  26. package/dist/mcp/tools/apply_diff.d.ts +2 -0
  27. package/dist/mcp/tools/apply_diff.js +29 -0
  28. package/dist/mcp/tools/audit_bilocale_parity.d.ts +2 -0
  29. package/dist/mcp/tools/audit_bilocale_parity.js +146 -0
  30. package/dist/mcp/tools/audit_budget_compliance.d.ts +35 -0
  31. package/dist/mcp/tools/audit_budget_compliance.js +172 -0
  32. package/dist/mcp/tools/build.d.ts +2 -0
  33. package/dist/mcp/tools/build.js +47 -0
  34. package/dist/mcp/tools/check_lint.d.ts +2 -0
  35. package/dist/mcp/tools/check_lint.js +23 -0
  36. package/dist/mcp/tools/classify_gate.js +2 -2
  37. package/dist/mcp/tools/current_gate.js +2 -2
  38. package/dist/mcp/tools/dependency_supply_chain.d.ts +2 -0
  39. package/dist/mcp/tools/dependency_supply_chain.js +59 -0
  40. package/dist/mcp/tools/docker_compose.d.ts +2 -0
  41. package/dist/mcp/tools/docker_compose.js +24 -0
  42. package/dist/mcp/tools/e2e_playwright.d.ts +2 -0
  43. package/dist/mcp/tools/e2e_playwright.js +88 -0
  44. package/dist/mcp/tools/get_skill.js +17 -0
  45. package/dist/mcp/tools/git_commit.d.ts +2 -0
  46. package/dist/mcp/tools/git_commit.js +30 -0
  47. package/dist/mcp/tools/list_proposals.d.ts +6 -0
  48. package/dist/mcp/tools/list_proposals.js +16 -0
  49. package/dist/mcp/tools/list_skills.js +9 -1
  50. package/dist/mcp/tools/load_role.d.ts +3 -4
  51. package/dist/mcp/tools/load_role.js +11 -13
  52. package/dist/mcp/tools/propose_change.d.ts +8 -0
  53. package/dist/mcp/tools/propose_change.js +36 -0
  54. package/dist/mcp/tools/record_decision.js +25 -25
  55. package/dist/mcp/tools/review_proposal.d.ts +17 -0
  56. package/dist/mcp/tools/review_proposal.js +99 -0
  57. package/dist/mcp/tools/run_drift_audit.d.ts +11 -0
  58. package/dist/mcp/tools/run_drift_audit.js +79 -0
  59. package/dist/mcp/tools/run_tests.d.ts +2 -0
  60. package/dist/mcp/tools/run_tests.js +92 -0
  61. package/dist/mcp/tools/sign_off.js +14 -2
  62. package/dist/mcp/tools/stubs.js +30 -9
  63. package/dist/mcp/tools/verify_claim.js +33 -6
  64. package/dist/mcp_setup.d.ts +8 -0
  65. package/dist/mcp_setup.js +4 -1
  66. package/dist/shared/frontmatter.d.ts +44 -2
  67. package/dist/shared/frontmatter.js +54 -6
  68. package/dist/shared/index.d.ts +0 -5
  69. package/dist/shared/index.js +0 -5
  70. package/dist/shared/persona.d.ts +2 -2
  71. package/dist/shared/persona.js +1 -1
  72. package/dist/shared/pipeline.d.ts +46 -1
  73. package/dist/shared/tools.d.ts +1382 -16
  74. package/dist/shared/tools.js +229 -0
  75. package/dist/shared/vocabulary.d.ts +99 -4
  76. package/dist/shared/vocabulary.js +94 -5
  77. package/domains/analytics/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  78. package/domains/analytics/.agents/skills/bcg-matrix/SKILL.md +345 -329
  79. package/domains/analytics/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  80. package/domains/analytics/.agents/skills/board/SKILL.md +22 -0
  81. package/domains/analytics/.agents/skills/cohort-analysis/SKILL.md +338 -322
  82. package/domains/analytics/.agents/skills/competitive-analysis/SKILL.md +413 -395
  83. package/domains/analytics/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  84. package/domains/analytics/.agents/skills/gates/SKILL.md +388 -366
  85. package/domains/analytics/.agents/skills/handoff/SKILL.md +402 -380
  86. package/domains/analytics/.agents/skills/html-pdf-report/SKILL.md +21 -289
  87. package/domains/analytics/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  88. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  89. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  90. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  91. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  92. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  93. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  94. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/skill.yaml +23 -0
  95. package/domains/analytics/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  96. package/domains/analytics/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  97. package/domains/analytics/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  98. package/domains/analytics/.agents/skills/pest-analysis/SKILL.md +324 -305
  99. package/domains/analytics/.agents/skills/porters-five-forces/SKILL.md +377 -361
  100. package/domains/analytics/.agents/skills/report-design/SKILL.md +416 -398
  101. package/domains/analytics/.agents/skills/rfm-analysis/SKILL.md +330 -314
  102. package/domains/analytics/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  103. package/domains/analytics/.agents/skills/swot-analysis/SKILL.md +340 -324
  104. package/domains/analytics/.agents/skills/tam-sam-som/SKILL.md +329 -312
  105. package/domains/analytics/.agents/skills/trend-analysis/SKILL.md +347 -331
  106. package/domains/analytics/.agents/skills/unit-economics/SKILL.md +430 -413
  107. package/domains/analytics/.agents/skills/value-chain-analysis/SKILL.md +346 -330
  108. package/domains/analytics/.agents/skills/web-research/SKILL.md +323 -308
  109. package/domains/analytics/AGENTS.md +1 -0
  110. package/domains/analytics/agents/auditor.md +76 -0
  111. package/domains/analytics/agents/conductor.md +11 -0
  112. package/domains/analytics/agents/data_analyst.md +11 -0
  113. package/domains/analytics/agents/designer.md +11 -0
  114. package/domains/analytics/agents/interviewer.md +11 -0
  115. package/domains/analytics/agents/layouter.md +11 -0
  116. package/domains/analytics/agents/mediator.md +11 -0
  117. package/domains/analytics/agents/researcher.md +11 -0
  118. package/domains/analytics/agents/strategist.md +11 -0
  119. package/domains/analytics/locales/en/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  120. package/domains/analytics/locales/en/.agents/skills/bcg-matrix/SKILL.md +345 -329
  121. package/domains/analytics/locales/en/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  122. package/domains/analytics/locales/en/.agents/skills/board/SKILL.md +22 -0
  123. package/domains/analytics/locales/en/.agents/skills/cohort-analysis/SKILL.md +338 -322
  124. package/domains/analytics/locales/en/.agents/skills/competitive-analysis/SKILL.md +413 -395
  125. package/domains/analytics/locales/en/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  126. package/domains/analytics/locales/en/.agents/skills/gates/SKILL.md +388 -366
  127. package/domains/analytics/locales/en/.agents/skills/handoff/SKILL.md +402 -380
  128. package/domains/analytics/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -289
  129. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  130. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  131. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  132. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  133. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  134. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  135. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  136. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +29 -0
  137. package/domains/analytics/locales/en/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  138. package/domains/analytics/locales/en/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  139. package/domains/analytics/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  140. package/domains/analytics/locales/en/.agents/skills/pest-analysis/SKILL.md +324 -305
  141. package/domains/analytics/locales/en/.agents/skills/porters-five-forces/SKILL.md +377 -361
  142. package/domains/analytics/locales/en/.agents/skills/report-design/SKILL.md +416 -398
  143. package/domains/analytics/locales/en/.agents/skills/rfm-analysis/SKILL.md +330 -314
  144. package/domains/analytics/locales/en/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  145. package/domains/analytics/locales/en/.agents/skills/swot-analysis/SKILL.md +340 -324
  146. package/domains/analytics/locales/en/.agents/skills/tam-sam-som/SKILL.md +329 -312
  147. package/domains/analytics/locales/en/.agents/skills/trend-analysis/SKILL.md +347 -331
  148. package/domains/analytics/locales/en/.agents/skills/unit-economics/SKILL.md +430 -413
  149. package/domains/analytics/locales/en/.agents/skills/value-chain-analysis/SKILL.md +366 -350
  150. package/domains/analytics/locales/en/.agents/skills/web-research/SKILL.md +324 -309
  151. package/domains/analytics/locales/en/AGENTS.md +1 -0
  152. package/domains/analytics/locales/en/agents/auditor.md +76 -0
  153. package/domains/analytics/locales/en/agents/conductor.md +27 -0
  154. package/domains/analytics/locales/en/agents/data_analyst.md +29 -0
  155. package/domains/analytics/locales/en/agents/designer.md +27 -0
  156. package/domains/analytics/locales/en/agents/interviewer.md +11 -0
  157. package/domains/analytics/locales/en/agents/layouter.md +11 -0
  158. package/domains/analytics/locales/en/agents/mediator.md +11 -0
  159. package/domains/analytics/locales/en/agents/researcher.md +11 -0
  160. package/domains/analytics/locales/en/agents/strategist.md +11 -0
  161. package/domains/analytics/persona/persona-base.md +94 -0
  162. package/domains/analytics/pipeline.yaml +102 -0
  163. package/domains/content/.agents/skills/audience-analysis/SKILL.md +15 -0
  164. package/domains/content/.agents/skills/board/SKILL.md +20 -0
  165. package/domains/content/.agents/skills/brand-compliance/SKILL.md +15 -0
  166. package/domains/content/.agents/skills/brand-guidelines/SKILL.md +17 -0
  167. package/domains/content/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  168. package/domains/content/.agents/skills/content-brief/SKILL.md +15 -0
  169. package/domains/content/.agents/skills/content-calendar/SKILL.md +15 -0
  170. package/domains/content/.agents/skills/content-release-gate/SKILL.md +15 -0
  171. package/domains/content/.agents/skills/content-review-checklist/SKILL.md +15 -0
  172. package/domains/content/.agents/skills/cta-optimization/SKILL.md +15 -0
  173. package/domains/content/.agents/skills/data-storytelling/SKILL.md +15 -0
  174. package/domains/content/.agents/skills/email-copywriting/SKILL.md +15 -0
  175. package/domains/content/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  176. package/domains/content/.agents/skills/fact-checking/SKILL.md +15 -0
  177. package/domains/content/.agents/skills/gates/SKILL.md +20 -0
  178. package/domains/content/.agents/skills/google-stitch-content/SKILL.md +15 -0
  179. package/domains/content/.agents/skills/handoff/SKILL.md +24 -0
  180. package/domains/content/.agents/skills/headline-formulas/SKILL.md +15 -0
  181. package/domains/content/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  182. package/domains/content/.agents/skills/karpathy-guidelines/SKILL.md +28 -0
  183. package/domains/content/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  184. package/domains/content/.agents/skills/marketing-psychology/SKILL.md +15 -0
  185. package/domains/content/.agents/skills/moodboard/SKILL.md +15 -0
  186. package/domains/content/.agents/skills/platform-compliance/SKILL.md +15 -0
  187. package/domains/content/.agents/skills/platform-strategy/SKILL.md +15 -0
  188. package/domains/content/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  189. package/domains/content/.agents/skills/readability-scoring/SKILL.md +15 -0
  190. package/domains/content/.agents/skills/seo-copywriting/SKILL.md +15 -0
  191. package/domains/content/.agents/skills/social-media-formats/SKILL.md +15 -0
  192. package/domains/content/.agents/skills/source-verification/SKILL.md +15 -0
  193. package/domains/content/.agents/skills/storytelling-framework/SKILL.md +15 -0
  194. package/domains/content/.agents/skills/tone-of-voice/SKILL.md +15 -0
  195. package/domains/content/.agents/skills/topic-research/SKILL.md +15 -0
  196. package/domains/content/.agents/skills/trend-research/SKILL.md +15 -0
  197. package/domains/content/.agents/skills/visual-brief/SKILL.md +15 -0
  198. package/domains/content/AGENTS.md +4 -0
  199. package/domains/content/agents/auditor.md +76 -0
  200. package/domains/content/agents/conductor.md +11 -0
  201. package/domains/content/agents/copywriter.md +11 -0
  202. package/domains/content/agents/researcher.md +11 -0
  203. package/domains/content/agents/reviewer.md +11 -0
  204. package/domains/content/agents/strategist.md +11 -0
  205. package/domains/content/agents/visual_concept.md +11 -0
  206. package/domains/content/locales/en/.agents/skills/audience-analysis/SKILL.md +15 -0
  207. package/domains/content/locales/en/.agents/skills/board/SKILL.md +20 -0
  208. package/domains/content/locales/en/.agents/skills/brand-compliance/SKILL.md +15 -0
  209. package/domains/content/locales/en/.agents/skills/brand-guidelines/SKILL.md +17 -0
  210. package/domains/content/locales/en/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  211. package/domains/content/locales/en/.agents/skills/content-brief/SKILL.md +15 -0
  212. package/domains/content/locales/en/.agents/skills/content-calendar/SKILL.md +15 -0
  213. package/domains/content/locales/en/.agents/skills/content-release-gate/SKILL.md +15 -0
  214. package/domains/content/locales/en/.agents/skills/content-review-checklist/SKILL.md +15 -0
  215. package/domains/content/locales/en/.agents/skills/cta-optimization/SKILL.md +15 -0
  216. package/domains/content/locales/en/.agents/skills/data-storytelling/SKILL.md +15 -0
  217. package/domains/content/locales/en/.agents/skills/email-copywriting/SKILL.md +15 -0
  218. package/domains/content/locales/en/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  219. package/domains/content/locales/en/.agents/skills/fact-checking/SKILL.md +15 -0
  220. package/domains/content/locales/en/.agents/skills/gates/SKILL.md +20 -0
  221. package/domains/content/locales/en/.agents/skills/google-stitch-content/SKILL.md +15 -0
  222. package/domains/content/locales/en/.agents/skills/handoff/SKILL.md +24 -0
  223. package/domains/content/locales/en/.agents/skills/headline-formulas/SKILL.md +15 -0
  224. package/domains/content/locales/en/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  225. package/domains/content/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +30 -1
  226. package/domains/content/locales/en/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  227. package/domains/content/locales/en/.agents/skills/marketing-psychology/SKILL.md +15 -0
  228. package/domains/content/locales/en/.agents/skills/moodboard/SKILL.md +15 -0
  229. package/domains/content/locales/en/.agents/skills/platform-compliance/SKILL.md +15 -0
  230. package/domains/content/locales/en/.agents/skills/platform-strategy/SKILL.md +15 -0
  231. package/domains/content/locales/en/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  232. package/domains/content/locales/en/.agents/skills/readability-scoring/SKILL.md +15 -0
  233. package/domains/content/locales/en/.agents/skills/seo-copywriting/SKILL.md +15 -0
  234. package/domains/content/locales/en/.agents/skills/social-media-formats/SKILL.md +15 -0
  235. package/domains/content/locales/en/.agents/skills/source-verification/SKILL.md +15 -0
  236. package/domains/content/locales/en/.agents/skills/storytelling-framework/SKILL.md +15 -0
  237. package/domains/content/locales/en/.agents/skills/tone-of-voice/SKILL.md +15 -0
  238. package/domains/content/locales/en/.agents/skills/topic-research/SKILL.md +15 -0
  239. package/domains/content/locales/en/.agents/skills/trend-research/SKILL.md +15 -0
  240. package/domains/content/locales/en/.agents/skills/visual-brief/SKILL.md +15 -0
  241. package/domains/content/locales/en/AGENTS.md +4 -0
  242. package/domains/content/locales/en/agents/auditor.md +76 -0
  243. package/domains/content/locales/en/agents/conductor.md +12 -0
  244. package/domains/content/locales/en/agents/copywriter.md +12 -0
  245. package/domains/content/locales/en/agents/researcher.md +12 -0
  246. package/domains/content/locales/en/agents/reviewer.md +12 -0
  247. package/domains/content/locales/en/agents/strategist.md +12 -0
  248. package/domains/content/locales/en/agents/visual_concept.md +12 -0
  249. package/domains/content/persona/persona-base.md +94 -0
  250. package/domains/content/pipeline.yaml +96 -0
  251. package/domains/development/.agents/skills/adr-log/SKILL.md +1 -0
  252. package/domains/development/.agents/skills/design-intake/SKILL.md +0 -4
  253. package/domains/development/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  254. package/domains/development/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  255. package/domains/development/.agents/skills/mcp-integration/SKILL.md +211 -0
  256. package/domains/development/.agents/skills/mcp-integration/agents/claude.json +22 -0
  257. package/domains/development/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  258. package/domains/development/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  259. package/domains/development/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  260. package/domains/development/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  261. package/domains/development/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  262. package/domains/development/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  263. package/domains/development/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  264. package/domains/development/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  265. package/domains/development/AGENTS.md +1 -0
  266. package/domains/development/AGENTS.yaml +1 -0
  267. package/domains/development/agents/architect.md +13 -1
  268. package/domains/development/agents/auditor.md +74 -0
  269. package/domains/development/agents/conductor.md +14 -3
  270. package/domains/development/agents/devops.md +8 -9
  271. package/domains/development/agents/reviewer.md +12 -0
  272. package/domains/development/agents/senior_full_stack.md +12 -0
  273. package/domains/development/agents/tester.md +10 -16
  274. package/domains/development/locales/en/.agents/skills/adr-log/SKILL.md +1 -0
  275. package/domains/development/locales/en/.agents/skills/current-state-analysis/SKILL.md +256 -172
  276. package/domains/development/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  277. package/domains/development/locales/en/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  278. package/domains/development/locales/en/.agents/skills/mcp-integration/SKILL.md +211 -0
  279. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/claude.json +22 -0
  280. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  281. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  282. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  283. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  284. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  285. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  286. package/domains/development/locales/en/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  287. package/domains/development/locales/en/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  288. package/domains/development/locales/en/AGENTS.md +5 -0
  289. package/domains/development/locales/en/AGENTS.yaml +1 -0
  290. package/domains/development/locales/en/agents/architect.md +13 -1
  291. package/domains/development/locales/en/agents/auditor.md +74 -0
  292. package/domains/development/locales/en/agents/conductor.md +14 -3
  293. package/domains/development/locales/en/agents/devops.md +8 -9
  294. package/domains/development/locales/en/agents/reviewer.md +12 -0
  295. package/domains/development/locales/en/agents/senior_full_stack.md +12 -0
  296. package/domains/development/locales/en/agents/tester.md +10 -16
  297. package/domains/development/persona/persona-base.md +94 -0
  298. package/domains/product/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  299. package/domains/product/.agents/skills/ab-test-design/SKILL.md +428 -412
  300. package/domains/product/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  301. package/domains/product/.agents/skills/assumption-mapping/SKILL.md +323 -307
  302. package/domains/product/.agents/skills/board/SKILL.md +24 -0
  303. package/domains/product/.agents/skills/design-brief/SKILL.md +433 -418
  304. package/domains/product/.agents/skills/epic-breakdown/SKILL.md +435 -420
  305. package/domains/product/.agents/skills/gates/SKILL.md +470 -446
  306. package/domains/product/.agents/skills/gtm-brief/SKILL.md +18 -321
  307. package/domains/product/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  308. package/domains/product/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  309. package/domains/product/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  310. package/domains/product/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  311. package/domains/product/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  312. package/domains/product/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  313. package/domains/product/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  314. package/domains/product/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  315. package/domains/product/.agents/skills/handoff/SKILL.md +463 -439
  316. package/domains/product/.agents/skills/html-pdf-report/SKILL.md +21 -663
  317. package/domains/product/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  318. package/domains/product/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  319. package/domains/product/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  320. package/domains/product/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  321. package/domains/product/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  322. package/domains/product/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  323. package/domains/product/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  324. package/domains/product/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  325. package/domains/product/.agents/skills/hypothesis-template/SKILL.md +484 -469
  326. package/domains/product/.agents/skills/jtbd-canvas/SKILL.md +274 -258
  327. package/domains/product/.agents/skills/kano-model/SKILL.md +370 -355
  328. package/domains/product/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  329. package/domains/product/.agents/skills/launch-checklist/SKILL.md +434 -419
  330. package/domains/product/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  331. package/domains/product/.agents/skills/north-star-metric/SKILL.md +317 -301
  332. package/domains/product/.agents/skills/okr-framework/SKILL.md +299 -284
  333. package/domains/product/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  334. package/domains/product/.agents/skills/prd-template/SKILL.md +18 -258
  335. package/domains/product/.agents/skills/prd-template-reference/SKILL.md +285 -0
  336. package/domains/product/.agents/skills/prd-template-reference/agents/claude.json +17 -0
  337. package/domains/product/.agents/skills/prd-template-reference/agents/copilot.json +17 -0
  338. package/domains/product/.agents/skills/prd-template-reference/agents/gemini.json +17 -0
  339. package/domains/product/.agents/skills/prd-template-reference/agents/kimi.yaml +16 -0
  340. package/domains/product/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  341. package/domains/product/.agents/skills/prd-template-reference/agents/qwen.json +17 -0
  342. package/domains/product/.agents/skills/prd-template-reference/agents/skill.yaml +23 -0
  343. package/domains/product/.agents/skills/problem-statement/SKILL.md +327 -312
  344. package/domains/product/.agents/skills/product-roadmap/SKILL.md +320 -304
  345. package/domains/product/.agents/skills/product-vision/SKILL.md +409 -394
  346. package/domains/product/.agents/skills/release-notes/SKILL.md +18 -258
  347. package/domains/product/.agents/skills/release-notes-reference/SKILL.md +285 -0
  348. package/domains/product/.agents/skills/release-notes-reference/agents/claude.json +17 -0
  349. package/domains/product/.agents/skills/release-notes-reference/agents/copilot.json +17 -0
  350. package/domains/product/.agents/skills/release-notes-reference/agents/gemini.json +17 -0
  351. package/domains/product/.agents/skills/release-notes-reference/agents/kimi.yaml +15 -0
  352. package/domains/product/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  353. package/domains/product/.agents/skills/release-notes-reference/agents/qwen.json +17 -0
  354. package/domains/product/.agents/skills/release-notes-reference/agents/skill.yaml +22 -0
  355. package/domains/product/.agents/skills/report-design/SKILL.md +17 -307
  356. package/domains/product/.agents/skills/report-design-reference/SKILL.md +331 -0
  357. package/domains/product/.agents/skills/report-design-reference/agents/claude.json +17 -0
  358. package/domains/product/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  359. package/domains/product/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  360. package/domains/product/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  361. package/domains/product/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  362. package/domains/product/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  363. package/domains/product/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  364. package/domains/product/.agents/skills/rice-scoring/SKILL.md +266 -251
  365. package/domains/product/.agents/skills/saas-metrics/SKILL.md +422 -404
  366. package/domains/product/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  367. package/domains/product/.agents/skills/user-flow/SKILL.md +491 -476
  368. package/domains/product/.agents/skills/user-interview-script/SKILL.md +315 -298
  369. package/domains/product/.agents/skills/user-story/SKILL.md +401 -385
  370. package/domains/product/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  371. package/domains/product/AGENTS.md +5 -0
  372. package/domains/product/AGENTS.yaml +1 -0
  373. package/domains/product/agents/auditor.md +76 -0
  374. package/domains/product/agents/conductor.md +11 -0
  375. package/domains/product/agents/data_analyst.md +11 -0
  376. package/domains/product/agents/designer.md +11 -0
  377. package/domains/product/agents/discovery.md +11 -0
  378. package/domains/product/agents/layouter.md +11 -0
  379. package/domains/product/agents/mediator.md +11 -0
  380. package/domains/product/agents/pm.md +11 -0
  381. package/domains/product/agents/product_strategist.md +11 -0
  382. package/domains/product/agents/tech_lead.md +11 -0
  383. package/domains/product/agents/ux_designer.md +11 -0
  384. package/domains/product/locales/en/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  385. package/domains/product/locales/en/.agents/skills/ab-test-design/SKILL.md +428 -412
  386. package/domains/product/locales/en/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  387. package/domains/product/locales/en/.agents/skills/assumption-mapping/SKILL.md +323 -307
  388. package/domains/product/locales/en/.agents/skills/board/SKILL.md +24 -0
  389. package/domains/product/locales/en/.agents/skills/design-brief/SKILL.md +433 -418
  390. package/domains/product/locales/en/.agents/skills/epic-breakdown/SKILL.md +435 -420
  391. package/domains/product/locales/en/.agents/skills/gates/SKILL.md +470 -446
  392. package/domains/product/locales/en/.agents/skills/gtm-brief/SKILL.md +18 -321
  393. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  394. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  395. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  396. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  397. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  398. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  399. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  400. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  401. package/domains/product/locales/en/.agents/skills/handoff/SKILL.md +463 -439
  402. package/domains/product/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -663
  403. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  404. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  405. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  406. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  407. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  408. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  409. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  410. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  411. package/domains/product/locales/en/.agents/skills/hypothesis-template/SKILL.md +484 -469
  412. package/domains/product/locales/en/.agents/skills/jtbd-canvas/SKILL.md +273 -257
  413. package/domains/product/locales/en/.agents/skills/kano-model/SKILL.md +370 -355
  414. package/domains/product/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  415. package/domains/product/locales/en/.agents/skills/launch-checklist/SKILL.md +434 -419
  416. package/domains/product/locales/en/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  417. package/domains/product/locales/en/.agents/skills/north-star-metric/SKILL.md +317 -301
  418. package/domains/product/locales/en/.agents/skills/okr-framework/SKILL.md +299 -284
  419. package/domains/product/locales/en/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  420. package/domains/product/locales/en/.agents/skills/prd-template/SKILL.md +18 -258
  421. package/domains/product/locales/en/.agents/skills/prd-template-reference/SKILL.md +285 -0
  422. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/claude.json +16 -0
  423. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/copilot.json +16 -0
  424. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/gemini.json +16 -0
  425. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/kimi.yaml +15 -0
  426. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  427. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/qwen.json +16 -0
  428. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/skill.yaml +22 -0
  429. package/domains/product/locales/en/.agents/skills/problem-statement/SKILL.md +327 -312
  430. package/domains/product/locales/en/.agents/skills/product-roadmap/SKILL.md +321 -305
  431. package/domains/product/locales/en/.agents/skills/product-vision/SKILL.md +410 -395
  432. package/domains/product/locales/en/.agents/skills/release-notes/SKILL.md +18 -258
  433. package/domains/product/locales/en/.agents/skills/release-notes-reference/SKILL.md +285 -0
  434. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/claude.json +16 -0
  435. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/copilot.json +16 -0
  436. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/gemini.json +16 -0
  437. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/kimi.yaml +14 -0
  438. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  439. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/qwen.json +16 -0
  440. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/skill.yaml +21 -0
  441. package/domains/product/locales/en/.agents/skills/report-design/SKILL.md +17 -307
  442. package/domains/product/locales/en/.agents/skills/report-design-reference/SKILL.md +331 -0
  443. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/claude.json +17 -0
  444. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  445. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  446. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  447. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  448. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  449. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  450. package/domains/product/locales/en/.agents/skills/rice-scoring/SKILL.md +266 -251
  451. package/domains/product/locales/en/.agents/skills/saas-metrics/SKILL.md +422 -404
  452. package/domains/product/locales/en/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  453. package/domains/product/locales/en/.agents/skills/user-flow/SKILL.md +491 -476
  454. package/domains/product/locales/en/.agents/skills/user-interview-script/SKILL.md +314 -297
  455. package/domains/product/locales/en/.agents/skills/user-story/SKILL.md +401 -385
  456. package/domains/product/locales/en/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  457. package/domains/product/locales/en/AGENTS.md +5 -0
  458. package/domains/product/locales/en/agents/auditor.md +76 -0
  459. package/domains/product/locales/en/agents/conductor.md +11 -0
  460. package/domains/product/locales/en/agents/data_analyst.md +11 -0
  461. package/domains/product/locales/en/agents/designer.md +11 -0
  462. package/domains/product/locales/en/agents/discovery.md +11 -0
  463. package/domains/product/locales/en/agents/layouter.md +11 -0
  464. package/domains/product/locales/en/agents/mediator.md +11 -0
  465. package/domains/product/locales/en/agents/pm.md +11 -0
  466. package/domains/product/locales/en/agents/product_strategist.md +11 -0
  467. package/domains/product/locales/en/agents/tech_lead.md +11 -0
  468. package/domains/product/locales/en/agents/ux_designer.md +11 -0
  469. package/domains/product/persona/persona-base.md +94 -0
  470. package/domains/product/pipeline.yaml +115 -0
  471. package/package.json +72 -70
@@ -1,446 +1,470 @@
1
- ---
2
- name: gates
3
- description: Quality control at gates — acceptance, rejection, severity (P0/P1/Note), escalation
4
- ---
5
- # Gates — Quality Control of Product Pipeline Gates
6
-
7
- ## When to Use
8
- - **Before every transition** between gates — checking the current gate's deliverable.
9
- - **When returning for rework** — re-check after corrections.
10
- - **At session end** — checking completeness of materials before cross-session `$handoff`.
11
- - **When there is a dispute about readiness** — formal arbiter: what is done and what is not.
12
-
13
- > **Distinction from `$board`:** `$gates` checks **quality and completeness** of a deliverable. `$board` tracks **status and progress**. Gates answers "is it ready?", Board answers "where are we now?".
14
-
15
- ## Input
16
-
17
- | Field | Required | Description |
18
- |-------|:--------:|-------------|
19
- | Gate name | ✅ | Which gate to check (with ID: COND-01, DISC-01, STRAT-01α, etc.) |
20
- | Pipeline mode | ✅ | /ship-right-thing / /shape-prioritize / /quick-pm / /spec |
21
- | Gate deliverables | ✅ | Artifacts that the agent submits for review |
22
- | Iteration | ⬚ | If re-check — iteration number + gaps from previous iteration |
23
- | Session number | ⬚ | Current session (1-6 for Full A/B) |
24
- | Adversarial camp | ⬚ | α (Customer/Build) / β (Business/Cut) — for camp-specific gates |
25
-
26
- ### Related Skills
27
- | Skill | Interaction |
28
- |-------|------------|
29
- | `$board` | After gate check update gate status on board (PASS → `[✓]`, FAIL → `[↩]`) |
30
- | `$handoff` | On PASS / CONDITIONAL PASS — form handoff envelope with gate check attached |
31
- | `$session-prompt-generator` | At session end — gate check enters data for next session prompt |
32
- | Framework skills | PM / Data Analyst gates: check correct completion of the Quality Gate of each skill used ($prd-template, $rice-scoring, $saas-metrics etc.) |
33
-
34
- ## Gate and Deliverable Registry
35
-
36
- ### Full Pipeline A (`/ship-right-thing`, 6 sessions)
37
-
38
- | # | Gate | ID | Agent | Session | Camp | Required deliverables | Skills |
39
- |---|------|-----|-------|:-------:|:----:|----------------------|--------|
40
- | 1 | **Conductor** | COND-01 | Conductor | 1 | — | Mode determined, task scope, board created | `$board` |
41
- | 2 | **Discovery** | DISC-01 | Discovery | 1 | — | JTBD canvas (buyer + end-user), problem statements, assumption map, evidence inventory | `$jtbd-canvas`, `$problem-statement`, `$assumption-mapping` |
42
- | 3 | **Customer-Champion** | STRAT-01α | Product Strategist | 2 | α | Strategy Brief Alpha: vision (user-value), NSM (user metric), OKR, roadmap | `$product-vision`, `$okr-framework`, `$north-star-metric`, `$product-roadmap` |
43
- | 4 | **Business-Champion** | STRAT-02β | Product Strategist | 3 | β | Strategy Brief Beta: vision (business-value), NSM (business metric), OKR, roadmap | (same skills, different lens) |
44
- | 5 | **Mediator** | MED-01 | Mediator | 4 | | Unified Strategy Brief: position map, evidence audit, synthesis, rationale | `$gates` |
45
- | 6 | **PM (PRD)** | PM-SPEC | PM | 5 | | PRD with user stories + AC + NFR + success metrics + rollout plan | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$rice-scoring` |
46
- | 7 | **UX Designer** | UX-01 | UX Designer | 5 | | User flows, low-fi wireframes, design brief | `$user-flow`, `$design-brief` |
47
- | 8 | **Tech Lead** | TECH-01 | Tech Lead | 5 | | Feasibility matrix, NFR list, risk register, epic breakdown | `$epic-breakdown` |
48
- | 9 | **Data Analyst** | DATA-01 | Data Analyst | 5 || Metric plan, hypotheses, experiment designs, instrumentation requirements | `$hypothesis-template`, `$saas-metrics`, `$aarrr-metrics`, `$ab-test-design` |
49
- | 10 | **Designer** | DS-01 | Designer | 6 | — | Design spec (PRD layout + Product Review Deck) | `$report-design` |
50
- | 11 | **Layouter** | LY-01 | Layouter | 6 | — | HTML generated, PDF ready | `$html-pdf-report` |
51
- | 12 | **Release Gate** | RG-01 | Conductor | 6 | — | All gates passed, PDF generated, user sign-off | `$board`, `$gates` |
52
-
53
- ### Full Pipeline B (`/shape-prioritize`, 6 sessions)
54
-
55
- | # | Gate | ID | Agent | Session | Camp | Required deliverables |
56
- |---|------|-----|-------|:-------:|:----:|----------------------|
57
- | 1 | Conductor | COND-01 | Conductor | 1 | — | Mode, scope, board |
58
- | 2 | Discovery (scope intake) | DISC-01 | Discovery | 1 | — | Scope brief: what we are prioritizing, JTBD in scope, assumptions |
59
- | 3 | PM Build-Camp | PM-01α | PM | 2 | α | Build scope proposal: max RICE, rationale per item |
60
- | 4 | Tech Lead Build-Camp | TECH-01α | Tech Lead | 2 | α | Feasibility per story, "yes, X weeks at Y resources", trade-offs |
61
- | 5 | PM Cut-Camp | PM-02β | PM | 3 | β | Cut scope proposal: MoSCoW, rationale per cut |
62
- | 6 | Tech Lead Cut-Camp | TECH-02β | Tech Lead | 3 | β | Hidden risks, "without X we do not start", technical debt flags |
63
- | 7 | Mediator | MED-01 | Mediator | 4 | — | Final scope decision + rationale, out-of-scope list |
64
- | 8 | PM (final PRD) | PM-SPEC | PM | 5 | — | PRD for approved scope |
65
- | 9 | UX Designer | UX-01 | UX Designer | 5 | — | User flows for final scope |
66
- | 10 | Data Analyst | DATA-01 | Data Analyst | 5 | | Metric plan |
67
- | 11 | Designer | DS-01 | Designer | 6 | | Design spec |
68
- | 12 | Layouter | LY-01 | Layouter | 6 | — | HTML/PDF |
69
- | 13 | Release Gate | RG-01 | Conductor | 6 | — | Sign-off |
70
-
71
- ### Quick Pipeline (`/quick-pm`, 1 session)
72
-
73
- | # | Gate | ID | Agent | Required deliverables |
74
- |---|------|-----|-------|----------------------|
75
- | 1 | Conductor | COND-01 | Conductor | Mode, scope, time box |
76
- | 2 | Discovery (light) | DISC-01 | Discovery | JTBD summary, problem statement (1-liner), top 3-5 assumptions |
77
- | 3 | Product Strategist | STRAT-01 | Product Strategist | NSM alignment, OKR fit, roadmap theme |
78
- | 4 | PM | PM-01 | PM | Rough RICE, MVP sketch (3-5 stories), Kano classification |
79
- | 5 | Tech Lead | TECH-01 | Tech Lead | Feasibility rough (S/M/L/XL), top 2-3 risks |
80
- | 6 | Data Analyst | DATA-01 | Data Analyst | Primary metric, guardrail, rough target |
81
-
82
- ### Spec Pipeline (`/spec`, 1 session)
83
-
84
- | # | Gate | ID | Agent | Required deliverables |
85
- |---|------|-----|-------|----------------------|
86
- | 1 | Conductor | COND-01 | Conductor | Cross-check: strategy + scope approved |
87
- | 2 | PM (PRD draft) | PM-SPEC | PM | PRD draft via `$prd-template`, user stories via `$user-story`, AC via `$acceptance-criteria` |
88
- | 3 | UX Designer | UX-01 | UX Designer | User flow, wireframe references, accessibility notes |
89
- | 4 | Tech Lead | TECH-01 | Tech Lead | NFR, risk register, integration map, epic breakdown |
90
- | 5 | PM (final) | PM-FINAL | PM | Merged PRD (ready for engineering handoff) |
91
-
92
- ## Readiness Criteria by Gate
93
-
94
- > Each criterion has a preset severity: **[B]** = Blocker, **[G]** = Gap, **[N]** = Note. During review severity can be raised (G→B), but not lowered (B→G).
95
-
96
- ### Conductor (COND-xx)
97
- - [ ] **[B]** Pipeline mode determined and justified (Full A / Full B / Quick / Spec)
98
- - [ ] **[B]** Task scope formulated (what we're doing, for whom, constraints)
99
- - [ ] **[B]** Board created via `$board` with correct gate IDs
100
- - [ ] **[B]** For Full A/B adversarial camp determined for current session (if S2-S3)
101
- - [ ] **[G]** First gate activated
102
- - [ ] **[G]** For continuing sessions: previous handoff loaded and verified
103
- - [ ] **[G]** Clarification first: at least 5 clarifying questions asked (Session 1)
104
-
105
- ### Discovery (DISC-xx)
106
- - [ ] **[B]** JTBD canvas filled: functional + emotional + social jobs (separately for buyer and end-user in Full A/B)
107
- - [ ] **[B]** At least 5 evidence quotes per role (from `$user-interview-script`) OR explicit "discovery-light mode" for Quick
108
- - [ ] **[B]** Problem statements (top 3, structured format actor/context/pain)
109
- - [ ] **[B]** Assumption map (4 quadrants: value/usability/feasibility/viability), top 3 high-risk identified
110
- - [ ] **[G]** Evidence inventory with quality flags (✅ verified / ⚠️ aged / 🔮 assumed)
111
- - [ ] **[G]** Open questions recorded for downstream gates
112
- - [ ] **[N]** Segment split (SMB / mid-market / enterprise) where applicable
113
-
114
- ### Product Strategist (STRAT-xx)
115
- - [ ] **[B]** Vision formed (Geoffrey Moore formula)
116
- - [ ] **[B]** NSM selected with evaluation by 6 criteria (`$north-star-metric`)
117
- - [ ] **[B]** OKR (1-3 Objectives, 2-5 KRs each)
118
- - [ ] **[B]** Roadmap (Now/Next/Later) with themes
119
- - [ ] **[B]** For Full A — camp lens maintained: Alpha emphasis on user-value, Beta on business-value. Mixed = FAIL
120
- - [ ] **[G]** Kano balance for roadmap items
121
- - [ ] **[G]** Competitive differentiation sketch
122
- - [ ] **[N]** FOCUS test passed for vision
123
-
124
- **Dependency check:** Discovery Brief (JTBD + problems) cited. Vision/NSM linked to specific JTBD.
125
-
126
- ### PM Scope & Spec (PM-xx)
127
- **For PM-01α / PM-02β (Full B adversarial):**
128
- - [ ] **[B]** Scope proposal — full list with rationale per item
129
- - [ ] **[B]** Prioritization scoring (RICE / MoSCoW / WSJF)
130
- - [ ] **[B]** Camp lens maintained: Build maximum + justification, Cut minimum + "what we give up"
131
- - [ ] **[G]** Kano classification per item
132
- - [ ] **[G]** Out-of-scope list (even for Build camp)
133
-
134
- **For PM-SPEC (final PRD):**
135
- - [ ] **[B]** PRD via `$prd-template` all 14 sections filled
136
- - [ ] **[B]** User stories via `$user-story` (INVEST), min 3-5 primary
137
- - [ ] **[B]** Acceptance criteria via `$acceptance-criteria` per each story
138
- - [ ] **[B]** Success metrics (primary + secondary + guardrails) with baselines + targets
139
- - [ ] **[B]** Non-Goals explicit
140
- - [ ] **[G]** Top 5 risks with mitigation
141
- - [ ] **[G]** Rollout plan via `$launch-checklist`
142
- - [ ] **[N]** Dependencies mapped
143
-
144
- **Dependency check:** Strategy Brief (Mediator synthesis for Full A, or approved strategy for Spec/Quick/Full B) cited. PRD goals linked to OKR KRs.
145
-
146
- ### UX Designer (UX-xx)
147
- - [ ] **[B]** User flows for primary flows (happy path + decision points + errors)
148
- - [ ] **[B]** Low-fi wireframes for new UI surfaces
149
- - [ ] **[B]** Design brief via `$design-brief` (if handoff to visual designer)
150
- - [ ] **[G]** Empty / loading states covered
151
- - [ ] **[G]** Accessibility targets (WCAG level) specified
152
- - [ ] **[N]** Prototype / video walkthrough
153
-
154
- **Dependency check:** User stories from PRD covered by flows.
155
-
156
- ### Tech Lead (TECH-xx)
157
- **For TECH-01α / TECH-02β (Full B):**
158
- - [ ] **[B]** Feasibility per story (can we build? time?)
159
- - [ ] **[B]** Camp lens: Build"yes, deliver in X", Cut — "hidden risks, do not start without Y"
160
- - [ ] **[G]** Integration / migration risks identified
161
-
162
- **For TECH-01 (standalone):**
163
- - [ ] **[B]** NFR (performance, availability, security, compliance, scalability, observability)
164
- - [ ] **[B]** Risk register (top 5 with mitigation)
165
- - [ ] **[B]** Epic breakdown (stories with dependencies, critical path) via `$epic-breakdown`
166
- - [ ] **[G]** Spike candidates identified (time-boxed)
167
- - [ ] **[N]** Architecture ADR (if major decision)
168
-
169
- **Dependency check:** PRD user stories covered by feasibility + breakdown.
170
-
171
- ### Data Analyst (DATA-xx)
172
- - [ ] **[B]** Primary metric defined + baseline + target
173
- - [ ] **[B]** Guardrail metrics with thresholds
174
- - [ ] **[B]** Hypothesis (via `$hypothesis-template`) for key initiatives
175
- - [ ] **[B]** SaaS metric impact model (via `$saas-metrics`)
176
- - [ ] **[G]** Experiment design (`$ab-test-design`) if A/B planned
177
- - [ ] **[G]** Instrumentation requirements — what is logged
178
- - [ ] **[N]** Segment analysis plan pre-registered
179
-
180
- **Dependency check:** NSM from Strategy Brief used as anchor. PRD success metrics aligned with metric plan.
181
-
182
- ### Mediator (MED-xx)
183
- - [ ] **[B]** Results from both camps received (Alpha + Beta)
184
- - [ ] **[B]** Independence verified no signs of contamination
185
- - [ ] **[B]** Evidence audit per camp (scoring 1-5 evidence strength)
186
- - [ ] **[B]** Position map (where they agree / where they diverge)
187
- - [ ] **[B]** Disagreement analysis (factual / value / risk)
188
- - [ ] **[B]** Synthesis with rationale (adopt Alpha / adopt Beta / hybrid)
189
- - [ ] **[G]** Open risks + mitigation plan
190
- - [ ] **[G]** Open questions for discovery
191
-
192
- **Dependency check:** Strategy Brief Alpha + Beta (Full A) or Scope Brief Alpha + Beta (Full B) explicitly cited and compared.
193
-
194
- ### Designer (DS-xx)
195
- - [ ] **[B]** Design spec via `$report-design`
196
- - [ ] **[B]** Structure + navigation for PRD / Review Deck
197
- - [ ] **[B]** Component library (tables, callouts, status badges)
198
- - [ ] **[G]** Key visualizations (roadmap, metric tree, funnel)
199
- - [ ] **[N]** Brand consistency
200
-
201
- **Dependency check:** Structure covers all sections of final PRD / unified strategy brief.
202
-
203
- ### Layouter (LY-xx)
204
- - [ ] **[B]** HTML generated per design spec
205
- - [ ] **[B]** All visualizations rendered (Chart.js / Mermaid / SVG)
206
- - [ ] **[B]** PDF output valid (page breaks, fonts embedded)
207
- - [ ] **[G]** Self-contained (no broken references)
208
- - [ ] **[N]** File size reasonable (< 10 MB)
209
-
210
- **Dependency check:** HTML matches design spec. All sections from PRD present.
211
-
212
- ### Release Gate (RG-xx)
213
- - [ ] **[B]** All previous gates passed (status `[✓]` on `$board`)
214
- - [ ] **[B]** PDF / PRD final ready
215
- - [ ] **[B]** Launch checklist (`$launch-checklist`) if release implied
216
- - [ ] **[G]** User sign-off received
217
- - [ ] **[G]** Distribution plan (email, in-app, blog, sales)
218
-
219
- ## Criterion Severity
220
-
221
- | Severity | Marker | Definition | Impact on decision |
222
- |----------|:------:|------------|-------------------|
223
- | Blocker | **[B]** | Required deliverable is absent or critically incomplete | FAIL — return for rework |
224
- | Gap | **[G]** | Deliverable exists, but incomplete or with remarks | CONDITIONAL PASS — can pass, but gaps recorded |
225
- | Note | **[N]** | Minor remark, does not affect transition | PASS remark passed to next gate as context |
226
-
227
- > Severity can be raised (G→B if critical), but **cannot be lowered** (B→G). Preset severity is the minimum.
228
-
229
- ## Decisions
230
-
231
- | Decision | Condition | Action |
232
- |---------|---------|--------|
233
- | **PASS** | 0 Blocker + 0 Gap | Request user Approved → `$handoff` → next gate |
234
- | **CONDITIONAL PASS** | 0 Blocker + 1-2 Gap | Record gaps → Request user Approved with note → `$handoff` with note |
235
- | **FAIL** | ≥ 1 Blocker | Return to agent with specific list of gaps → Do not request Approved |
236
-
237
- > **Absolute rule:** Never skip gates, even if the task seems simple. FAIL — rework — re-check. No exceptions.
238
-
239
- ### Special Rules
240
- - Discovery (DISC): absence of JTBD canvas with 5+ evidence quotes (except `/quick-pm`) — **automatic Blocker**.
241
- - PRD without success metrics section **Blocker**.
242
- - User story without AC — **Blocker**.
243
- - In Full A/B — camp contamination (Alpha saw Beta artifacts before Mediator) — **automatic Blocker**, escalation.
244
- - Release Gate without launch checklist for production release — **Blocker**.
245
-
246
- ## Escalation Protocol on Repeated FAIL
247
-
248
- | Iteration | Action |
249
- |:---------:|--------|
250
- | 1st FAIL | Standard return: list of gaps → agent reworks → re-check |
251
- | 2nd FAIL | Extended return: gaps + specific instructions "how to fix" + warning |
252
- | 3rd FAIL | **Escalation to user** |
253
-
254
- Escalation template (3+ FAIL):
255
- ```
256
- ### ⚠️ Escalation — Gate [ID] fails check (iteration [N])
257
-
258
- **Gate:** [ID] [Name]
259
- **FAIL iterations:** [N]
260
- **Recurring gaps:** [list of gaps not fixed over N iterations]
261
-
262
- **Options:**
263
- 1. Revise scope / lower requirements for deliverable
264
- 2. Return to previous gate (problem is in source data)
265
- 3. Forced CONDITIONAL PASS (user accepts risk of gaps)
266
-
267
- Awaiting decision from user.
268
- ```
269
-
270
- ## Protocol
271
-
272
- ### Step 0 Load Context
273
- 1. Determine which gate to check (by ID from `$board`).
274
- 2. Determine pipeline mode and session number.
275
- 3. Load readiness criteria for this gate from the registry (with preset severity).
276
- 4. If re-check load gaps from previous iteration.
277
- 5. For Full A/B — check camp contamination (pre-check).
278
-
279
- ### Step 1 — Check Deliverables
280
- 1. For each readiness criterion check: fulfilled / not fulfilled / N/A.
281
- 2. For unfulfilled — apply preset severity (can raise, cannot lower).
282
- 3. For unfulfilled — describe specific gap: what is missing / what to fix.
283
- 4. **Dependency check:** verify that the previous gate's deliverable is explicitly used (not just exists, but cited / applied in the current deliverable).
284
-
285
- ### Step 2 — Make Decision
286
- 1. Count severity.
287
- 2. Apply decision rules (PASS / CONDITIONAL PASS / FAIL).
288
- 3. Check iteration number if 3+ FAIL, activate escalation protocol.
289
- 4. Add entry to check log.
290
-
291
- ### Step 3 Act on Result
292
- - **PASS:** show user → request Approved → `$handoff` → update `$board`.
293
- - **CONDITIONAL PASS:** show gaps → request Approved with gap confirmation → `$handoff` with note → update `$board`.
294
- - **FAIL:** show gaps → return to agent → update `$board` (status `[↩] Returned`). If 3+ FAIL — escalation.
295
-
296
- ## ExampleGate Check PM-SPEC (TeamFlow, `/ship-right-thing` Session 5), iteration 1 → CONDITIONAL PASS
297
-
298
- **Context:** TeamFlow (B2B SaaS, HR-tech). After Mediator synthesis (MED-01) the team wrote a PRD for AI-powered 1:1 summarization. Gate check before handoff to UX + Tech + Data.
299
-
300
- ```
301
- ### Gate CheckPM-SPEC (PM final PRD)
302
-
303
- **Mode:** /ship-right-thing (Full A)
304
- **Session:** 5 of 6
305
- **Iteration:** 1
306
- **Previous gaps:** First check
307
-
308
- ---
309
-
310
- #### Readiness Criteria
311
-
312
- | # | Criterion | Sev | Status | Gap / Comment |
313
- |---|----------|:---:|:------:|---------------|
314
- | 1 | PRD: all 14 sections filled | [B] | ✅ | TL;DR, Problem, Goals, Non-Goals, Strategy Fit, Solution, Stories, NFR, Metrics, Risks, Rollout, Deps, Q's, Appendix |
315
- | 2 | User stories (INVEST), min 3-5 primary | [B] | ✅ | 7 stories (5 primary + 2 error paths) |
316
- | 3 | AC per story (Gherkin / scenario) | [B] | ✅ | All 7 stories have AC with edge cases + error states |
317
- | 4 | Success metrics: primary + secondary + guardrails | [B] | ✅ | Primary: weekly 1:1s with AI summary (3050% in 90d). Guardrails: NPS stability, compliance ticket volume |
318
- | 5 | Non-Goals explicit | [B] | | "Not building summarization for group meetings", "Not replacing human note-takers" |
319
- | 6 | Top 5 risks with mitigation | [G] | ⚠️ | 4 risks vs target 5. Missing: compliance/legal risk re:HR data ingestion |
320
- | 7 | Rollout plan (launch-checklist) | [G] | ⚠️ | Phased rollout defined, but rollback trigger conditions are not numeric |
321
- | 8 | Dependencies mapped | [N] | ℹ️ | Platform team dependency specified, but timeline not confirmed |
322
-
323
- **Dependency check:** Unified Strategy Brief (MED-01) cited in Strategy Fit section. NSM "weekly 1:1s with AI summary" from Strategy Brief = primary success metric in PRD. ✅
324
-
325
- ---
326
-
327
- #### Summary
328
-
329
- | Severity | Count | Items |
330
- |----------|:-----:|-------|
331
- | Blocker | 0 | — |
332
- | Gap | 2 | #6 (risks count), #7 (rollback trigger) |
333
- | Note | 1 | #8 (deps timeline) |
334
-
335
- ### Decision: CONDITIONAL PASS
336
-
337
- **Rationale:** 0 Blocker, 2 Gap — acceptable for handoff to parallel work (UX, Tech, Data). Gaps noted: risk register and rollback criteria — TECH-01 and Release Gate will clarify.
338
-
339
- ---
340
-
341
- **Deliverables for handoff:**
342
- - PRD (v1 draft, 14 sections, 7 user stories with AC)
343
-
344
- **Gaps for downstream:**
345
- - [Tech Lead] Add 5th risk: compliance/legal HR data ingestion, GDPR / SOC2 implications
346
- - [Tech Lead / Data] Define numeric trigger conditions for rollback (error rate, latency, NPS drop)
347
- - [Release Gate] Confirm platform team timeline
348
-
349
- → Ready for handoff to **UX Designer + Tech Lead + Data Analyst** (in parallel). Awaiting **"Approved"**.
350
- ```
351
-
352
- ## Validation (Quality Gate)
353
-
354
- Gate check is considered complete if:
355
-
356
- - [ ] All readiness criteria checked (fulfilled / not fulfilled / N/A — no blanks)
357
- - [ ] Each criterion assigned severity from registry (B/G/N), raised if necessary
358
- - [ ] For each unfulfilled: severity, gap description, what to fix
359
- - [ ] Dependency check passed: previous gate's deliverable explicitly used in current
360
- - [ ] For Full A/B — camp contamination check passed
361
- - [ ] Decision matches rules (not subjective)
362
- - [ ] At 3+ FAIL — escalation protocol activated
363
- - [ ] Check log updated
364
- - [ ] On PASS/CONDITIONAL PASS — user Approved received
365
- - [ ] `$board` updated
366
-
367
- ## Handoff
368
- The result of `$gates` is input data for: `$handoff` (gate check attached to envelope).
369
-
370
- Transfer format: completed gate check template + decision + gaps (if CONDITIONAL PASS) + dependency check result.
371
-
372
- ## Anti-patterns
373
-
374
- | Error | Why it's bad | How to do it right |
375
- |-------|-------------|-------------------|
376
- | Skip gate "because it's simple" | Errors pass unnoticed | Never skip. No exceptions |
377
- | PASS without checking all criteria | Unnoticed gaps | Each criterion = fulfilled / not fulfilled / N/A |
378
- | "Generally ok" instead of specifics | Agent does not know what to fix | Specific gap: "Non-Goals section has only 1 item, need min 2" |
379
- | FAIL without describing gaps | Agent returns and does not know what to do | Each FAIL = list of specific reworks |
380
- | Approved without user sign-off | Pipeline protocol violation | Always explicit Approved from user |
381
- | Discovery without JTBD canvas | Pipeline operates without customer-centric foundation | JTBD — mandatory, its absence = Blocker |
382
- | Equal importance for all criteria | Minor issue blocks, critical one passes | Preset severity: [B] / [G] / [N] per criterion |
383
- | Re-check without comparing to gaps | Gap may not have been fixed | Load previous iteration gaps, check each one |
384
- | Lowering severity (B→G) | Critical deliverable passes without check | Severity can be raised, but not lowered |
385
- | Infinite FAIL cycle | Pipeline hangs | 3+ FAIL = escalation to user with options |
386
- | Formal check "exists" | Deliverable exists, but not used by next gate | Dependency check: previous deliverable cited |
387
- | Camp contamination (Full A/B) | Alpha and Beta mutually influence each other | Contamination = automatic Blocker |
388
-
389
- ## Output Template
390
-
391
- ```
392
- ### Gate Check [ID] [Gate name]
393
-
394
- **Mode:** [/ship-right-thing | /shape-prioritize | /quick-pm | /spec]
395
- **Session:** [N of M]
396
- **Camp:** [α / β / —]
397
- **Iteration:** [1 / 2 / N]
398
- **Previous gaps:** [list or "First check"]
399
-
400
- ---
401
-
402
- #### Readiness Criteria
403
-
404
- | # | Criterion | Sev | Status | Gap / Comment |
405
- |---|----------|:---:|:------:|---------------|
406
- | 1 | [Criterion from registry] | [B] | ✅/⚠️/❌ | [If not fulfilled: what is missing] |
407
-
408
- **Dependency check:** [Deliverable [previous ID] cited: ✅/❌. Details.]
409
-
410
- **Camp independence check (Full A/B):** [Verified / Contamination detected]
411
-
412
- ---
413
-
414
- #### Summary
415
-
416
- | Severity | Count | Items |
417
- |----------|:-----:|-------|
418
- | Blocker | [N] | #[list] |
419
- | Gap | [N] | #[list] |
420
- | Note | [N] | #[list] |
421
-
422
- ### Decision: [ PASS / CONDITIONAL PASS / FAIL ]
423
-
424
- **Rationale:** [by rules: 0 blocker + 0 gap = PASS etc.]
425
-
426
- ---
427
-
428
- #### On PASS / CONDITIONAL PASS:
429
- **Deliverables for handoff:**
430
- - [Artifact 1]
431
-
432
- **Gaps for next gate (if CONDITIONAL):**
433
- - [Gap 1 — what to consider]
434
-
435
- → Ready for handoff to **[Next agent]**. Awaiting **"Approved"**.
436
-
437
- #### On FAIL:
438
- **Gaps for rework:**
439
-
440
- | # | Gap | Sev | What to fix | Responsible |
441
- |---|-----|:---:|-------------|-------------|
442
- | [N] | [description] | [B] | [specific action] | [agent] |
443
-
444
- Return to **[Current agent]**. After fixes — re-check (iteration [N+1]).
445
- [If iteration ≥ 3: escalation protocol activated]
446
- ```
1
+ ---
2
+ name: gates
3
+ description: Quality control at gates — acceptance, rejection, severity (P0/P1/Note), escalation
4
+ type: mandatory
5
+ domain: product
6
+ owners:
7
+ - conductor
8
+ gates:
9
+ - DISCOVERY
10
+ - PRODUCT_STRATEGIST
11
+ - PM
12
+ - UX_DESIGNER
13
+ - TECH_LEAD
14
+ - DATA_ANALYST
15
+ - MEDIATOR
16
+ - DESIGNER
17
+ - LAYOUTER
18
+ - RELEASE_GATE
19
+ tech: []
20
+ topic: []
21
+ triggers:
22
+ - gates
23
+ - gate control
24
+ - quality gate
25
+ related: []
26
+ budget_lines: 470
27
+ schema_version: 1
28
+ ---
29
+ # GatesQuality Control of Product Pipeline Gates
30
+
31
+ ## When to Use
32
+ - **Before every transition** between gates checking the current gate's deliverable.
33
+ - **When returning for rework** — re-check after corrections.
34
+ - **At session end** — checking completeness of materials before cross-session `$handoff`.
35
+ - **When there is a dispute about readiness** — formal arbiter: what is done and what is not.
36
+
37
+ > **Distinction from `$board`:** `$gates` checks **quality and completeness** of a deliverable. `$board` tracks **status and progress**. Gates answers "is it ready?", Board answers "where are we now?".
38
+
39
+ ## Input
40
+
41
+ | Field | Required | Description |
42
+ |-------|:--------:|-------------|
43
+ | Gate name | | Which gate to check (with ID: COND-01, DISC-01, STRAT-01α, etc.) |
44
+ | Pipeline mode | | /ship-right-thing / /shape-prioritize / /quick-pm / /spec |
45
+ | Gate deliverables | | Artifacts that the agent submits for review |
46
+ | Iteration | | If re-checkiteration number + gaps from previous iteration |
47
+ | Session number | | Current session (1-6 for Full A/B) |
48
+ | Adversarial camp | | α (Customer/Build) / β (Business/Cut)for camp-specific gates |
49
+
50
+ ### Related Skills
51
+ | Skill | Interaction |
52
+ |-------|------------|
53
+ | `$board` | After gate check — update gate status on board (PASS → `[✓]`, FAIL → `[↩]`) |
54
+ | `$handoff` | On PASS / CONDITIONAL PASS — form handoff envelope with gate check attached |
55
+ | `$session-prompt-generator` | At session end gate check enters data for next session prompt |
56
+ | Framework skills | PM / Data Analyst gates: check correct completion of the Quality Gate of each skill used ($prd-template, $rice-scoring, $saas-metrics etc.) |
57
+
58
+ ## Gate and Deliverable Registry
59
+
60
+ ### Full Pipeline A (`/ship-right-thing`, 6 sessions)
61
+
62
+ | # | Gate | ID | Agent | Session | Camp | Required deliverables | Skills |
63
+ |---|------|-----|-------|:-------:|:----:|----------------------|--------|
64
+ | 1 | **Conductor** | COND-01 | Conductor | 1 | — | Mode determined, task scope, board created | `$board` |
65
+ | 2 | **Discovery** | DISC-01 | Discovery | 1 | — | JTBD canvas (buyer + end-user), problem statements, assumption map, evidence inventory | `$jtbd-canvas`, `$problem-statement`, `$assumption-mapping` |
66
+ | 3 | **Customer-Champion** | STRAT-01α | Product Strategist | 2 | α | Strategy Brief Alpha: vision (user-value), NSM (user metric), OKR, roadmap | `$product-vision`, `$okr-framework`, `$north-star-metric`, `$product-roadmap` |
67
+ | 4 | **Business-Champion** | STRAT-02β | Product Strategist | 3 | β | Strategy Brief Beta: vision (business-value), NSM (business metric), OKR, roadmap | (same skills, different lens) |
68
+ | 5 | **Mediator** | MED-01 | Mediator | 4 | — | Unified Strategy Brief: position map, evidence audit, synthesis, rationale | `$gates` |
69
+ | 6 | **PM (PRD)** | PM-SPEC | PM | 5 | — | PRD with user stories + AC + NFR + success metrics + rollout plan | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$rice-scoring` |
70
+ | 7 | **UX Designer** | UX-01 | UX Designer | 5 | — | User flows, low-fi wireframes, design brief | `$user-flow`, `$design-brief` |
71
+ | 8 | **Tech Lead** | TECH-01 | Tech Lead | 5 | — | Feasibility matrix, NFR list, risk register, epic breakdown | `$epic-breakdown` |
72
+ | 9 | **Data Analyst** | DATA-01 | Data Analyst | 5 | — | Metric plan, hypotheses, experiment designs, instrumentation requirements | `$hypothesis-template`, `$saas-metrics`, `$aarrr-metrics`, `$ab-test-design` |
73
+ | 10 | **Designer** | DS-01 | Designer | 6 | | Design spec (PRD layout + Product Review Deck) | `$report-design` |
74
+ | 11 | **Layouter** | LY-01 | Layouter | 6 | — | HTML generated, PDF ready | `$html-pdf-report` |
75
+ | 12 | **Release Gate** | RG-01 | Conductor | 6 | — | All gates passed, PDF generated, user sign-off | `$board`, `$gates` |
76
+
77
+ ### Full Pipeline B (`/shape-prioritize`, 6 sessions)
78
+
79
+ | # | Gate | ID | Agent | Session | Camp | Required deliverables |
80
+ |---|------|-----|-------|:-------:|:----:|----------------------|
81
+ | 1 | Conductor | COND-01 | Conductor | 1 | — | Mode, scope, board |
82
+ | 2 | Discovery (scope intake) | DISC-01 | Discovery | 1 | — | Scope brief: what we are prioritizing, JTBD in scope, assumptions |
83
+ | 3 | PM Build-Camp | PM-01α | PM | 2 | α | Build scope proposal: max RICE, rationale per item |
84
+ | 4 | Tech Lead Build-Camp | TECH-01α | Tech Lead | 2 | α | Feasibility per story, "yes, X weeks at Y resources", trade-offs |
85
+ | 5 | PM Cut-Camp | PM-02β | PM | 3 | β | Cut scope proposal: MoSCoW, rationale per cut |
86
+ | 6 | Tech Lead Cut-Camp | TECH-02β | Tech Lead | 3 | β | Hidden risks, "without X we do not start", technical debt flags |
87
+ | 7 | Mediator | MED-01 | Mediator | 4 | | Final scope decision + rationale, out-of-scope list |
88
+ | 8 | PM (final PRD) | PM-SPEC | PM | 5 | | PRD for approved scope |
89
+ | 9 | UX Designer | UX-01 | UX Designer | 5 | | User flows for final scope |
90
+ | 10 | Data Analyst | DATA-01 | Data Analyst | 5 | | Metric plan |
91
+ | 11 | Designer | DS-01 | Designer | 6 | — | Design spec |
92
+ | 12 | Layouter | LY-01 | Layouter | 6 | — | HTML/PDF |
93
+ | 13 | Release Gate | RG-01 | Conductor | 6 | — | Sign-off |
94
+
95
+ ### Quick Pipeline (`/quick-pm`, 1 session)
96
+
97
+ | # | Gate | ID | Agent | Required deliverables |
98
+ |---|------|-----|-------|----------------------|
99
+ | 1 | Conductor | COND-01 | Conductor | Mode, scope, time box |
100
+ | 2 | Discovery (light) | DISC-01 | Discovery | JTBD summary, problem statement (1-liner), top 3-5 assumptions |
101
+ | 3 | Product Strategist | STRAT-01 | Product Strategist | NSM alignment, OKR fit, roadmap theme |
102
+ | 4 | PM | PM-01 | PM | Rough RICE, MVP sketch (3-5 stories), Kano classification |
103
+ | 5 | Tech Lead | TECH-01 | Tech Lead | Feasibility rough (S/M/L/XL), top 2-3 risks |
104
+ | 6 | Data Analyst | DATA-01 | Data Analyst | Primary metric, guardrail, rough target |
105
+
106
+ ### Spec Pipeline (`/spec`, 1 session)
107
+
108
+ | # | Gate | ID | Agent | Required deliverables |
109
+ |---|------|-----|-------|----------------------|
110
+ | 1 | Conductor | COND-01 | Conductor | Cross-check: strategy + scope approved |
111
+ | 2 | PM (PRD draft) | PM-SPEC | PM | PRD draft via `$prd-template`, user stories via `$user-story`, AC via `$acceptance-criteria` |
112
+ | 3 | UX Designer | UX-01 | UX Designer | User flow, wireframe references, accessibility notes |
113
+ | 4 | Tech Lead | TECH-01 | Tech Lead | NFR, risk register, integration map, epic breakdown |
114
+ | 5 | PM (final) | PM-FINAL | PM | Merged PRD (ready for engineering handoff) |
115
+
116
+ ## Readiness Criteria by Gate
117
+
118
+ > Each criterion has a preset severity: **[B]** = Blocker, **[G]** = Gap, **[N]** = Note. During review severity can be raised (G→B), but not lowered (B→G).
119
+
120
+ ### Conductor (COND-xx)
121
+ - [ ] **[B]** Pipeline mode determined and justified (Full A / Full B / Quick / Spec)
122
+ - [ ] **[B]** Task scope formulated (what we're doing, for whom, constraints)
123
+ - [ ] **[B]** Board created via `$board` with correct gate IDs
124
+ - [ ] **[B]** For Full A/B adversarial camp determined for current session (if S2-S3)
125
+ - [ ] **[G]** First gate activated
126
+ - [ ] **[G]** For continuing sessions: previous handoff loaded and verified
127
+ - [ ] **[G]** Clarification first: at least 5 clarifying questions asked (Session 1)
128
+
129
+ ### Discovery (DISC-xx)
130
+ - [ ] **[B]** JTBD canvas filled: functional + emotional + social jobs (separately for buyer and end-user in Full A/B)
131
+ - [ ] **[B]** At least 5 evidence quotes per role (from `$user-interview-script`) OR explicit "discovery-light mode" for Quick
132
+ - [ ] **[B]** Problem statements (top 3, structured format actor/context/pain)
133
+ - [ ] **[B]** Assumption map (4 quadrants: value/usability/feasibility/viability), top 3 high-risk identified
134
+ - [ ] **[G]** Evidence inventory with quality flags ( verified / ⚠️ aged / 🔮 assumed)
135
+ - [ ] **[G]** Open questions recorded for downstream gates
136
+ - [ ] **[N]** Segment split (SMB / mid-market / enterprise) where applicable
137
+
138
+ ### Product Strategist (STRAT-xx)
139
+ - [ ] **[B]** Vision formed (Geoffrey Moore formula)
140
+ - [ ] **[B]** NSM selected with evaluation by 6 criteria (`$north-star-metric`)
141
+ - [ ] **[B]** OKR (1-3 Objectives, 2-5 KRs each)
142
+ - [ ] **[B]** Roadmap (Now/Next/Later) with themes
143
+ - [ ] **[B]** For Full A — camp lens maintained: Alpha emphasis on user-value, Beta on business-value. Mixed = FAIL
144
+ - [ ] **[G]** Kano balance for roadmap items
145
+ - [ ] **[G]** Competitive differentiation sketch
146
+ - [ ] **[N]** FOCUS test passed for vision
147
+
148
+ **Dependency check:** Discovery Brief (JTBD + problems) cited. Vision/NSM linked to specific JTBD.
149
+
150
+ ### PM Scope & Spec (PM-xx)
151
+ **For PM-01α / PM-02β (Full B adversarial):**
152
+ - [ ] **[B]** Scope proposal full list with rationale per item
153
+ - [ ] **[B]** Prioritization scoring (RICE / MoSCoW / WSJF)
154
+ - [ ] **[B]** Camp lens maintained: Build maximum + justification, Cut — minimum + "what we give up"
155
+ - [ ] **[G]** Kano classification per item
156
+ - [ ] **[G]** Out-of-scope list (even for Build camp)
157
+
158
+ **For PM-SPEC (final PRD):**
159
+ - [ ] **[B]** PRD via `$prd-template`all 14 sections filled
160
+ - [ ] **[B]** User stories via `$user-story` (INVEST), min 3-5 primary
161
+ - [ ] **[B]** Acceptance criteria via `$acceptance-criteria` per each story
162
+ - [ ] **[B]** Success metrics (primary + secondary + guardrails) with baselines + targets
163
+ - [ ] **[B]** Non-Goals explicit
164
+ - [ ] **[G]** Top 5 risks with mitigation
165
+ - [ ] **[G]** Rollout plan via `$launch-checklist`
166
+ - [ ] **[N]** Dependencies mapped
167
+
168
+ **Dependency check:** Strategy Brief (Mediator synthesis for Full A, or approved strategy for Spec/Quick/Full B) cited. PRD goals linked to OKR KRs.
169
+
170
+ ### UX Designer (UX-xx)
171
+ - [ ] **[B]** User flows for primary flows (happy path + decision points + errors)
172
+ - [ ] **[B]** Low-fi wireframes for new UI surfaces
173
+ - [ ] **[B]** Design brief via `$design-brief` (if handoff to visual designer)
174
+ - [ ] **[G]** Empty / loading states covered
175
+ - [ ] **[G]** Accessibility targets (WCAG level) specified
176
+ - [ ] **[N]** Prototype / video walkthrough
177
+
178
+ **Dependency check:** User stories from PRD covered by flows.
179
+
180
+ ### Tech Lead (TECH-xx)
181
+ **For TECH-01α / TECH-02β (Full B):**
182
+ - [ ] **[B]** Feasibility per story (can we build? time?)
183
+ - [ ] **[B]** Camp lens: Build "yes, deliver in X", Cut — "hidden risks, do not start without Y"
184
+ - [ ] **[G]** Integration / migration risks identified
185
+
186
+ **For TECH-01 (standalone):**
187
+ - [ ] **[B]** NFR (performance, availability, security, compliance, scalability, observability)
188
+ - [ ] **[B]** Risk register (top 5 with mitigation)
189
+ - [ ] **[B]** Epic breakdown (stories with dependencies, critical path) via `$epic-breakdown`
190
+ - [ ] **[G]** Spike candidates identified (time-boxed)
191
+ - [ ] **[N]** Architecture ADR (if major decision)
192
+
193
+ **Dependency check:** PRD user stories covered by feasibility + breakdown.
194
+
195
+ ### Data Analyst (DATA-xx)
196
+ - [ ] **[B]** Primary metric defined + baseline + target
197
+ - [ ] **[B]** Guardrail metrics with thresholds
198
+ - [ ] **[B]** Hypothesis (via `$hypothesis-template`) for key initiatives
199
+ - [ ] **[B]** SaaS metric impact model (via `$saas-metrics`)
200
+ - [ ] **[G]** Experiment design (`$ab-test-design`) if A/B planned
201
+ - [ ] **[G]** Instrumentation requirements what is logged
202
+ - [ ] **[N]** Segment analysis plan pre-registered
203
+
204
+ **Dependency check:** NSM from Strategy Brief used as anchor. PRD success metrics aligned with metric plan.
205
+
206
+ ### Mediator (MED-xx)
207
+ - [ ] **[B]** Results from both camps received (Alpha + Beta)
208
+ - [ ] **[B]** Independence verified no signs of contamination
209
+ - [ ] **[B]** Evidence audit per camp (scoring 1-5 evidence strength)
210
+ - [ ] **[B]** Position map (where they agree / where they diverge)
211
+ - [ ] **[B]** Disagreement analysis (factual / value / risk)
212
+ - [ ] **[B]** Synthesis with rationale (adopt Alpha / adopt Beta / hybrid)
213
+ - [ ] **[G]** Open risks + mitigation plan
214
+ - [ ] **[G]** Open questions for discovery
215
+
216
+ **Dependency check:** Strategy Brief Alpha + Beta (Full A) or Scope Brief Alpha + Beta (Full B) explicitly cited and compared.
217
+
218
+ ### Designer (DS-xx)
219
+ - [ ] **[B]** Design spec via `$report-design`
220
+ - [ ] **[B]** Structure + navigation for PRD / Review Deck
221
+ - [ ] **[B]** Component library (tables, callouts, status badges)
222
+ - [ ] **[G]** Key visualizations (roadmap, metric tree, funnel)
223
+ - [ ] **[N]** Brand consistency
224
+
225
+ **Dependency check:** Structure covers all sections of final PRD / unified strategy brief.
226
+
227
+ ### Layouter (LY-xx)
228
+ - [ ] **[B]** HTML generated per design spec
229
+ - [ ] **[B]** All visualizations rendered (Chart.js / Mermaid / SVG)
230
+ - [ ] **[B]** PDF output valid (page breaks, fonts embedded)
231
+ - [ ] **[G]** Self-contained (no broken references)
232
+ - [ ] **[N]** File size reasonable (< 10 MB)
233
+
234
+ **Dependency check:** HTML matches design spec. All sections from PRD present.
235
+
236
+ ### Release Gate (RG-xx)
237
+ - [ ] **[B]** All previous gates passed (status `[✓]` on `$board`)
238
+ - [ ] **[B]** PDF / PRD final ready
239
+ - [ ] **[B]** Launch checklist (`$launch-checklist`) if release implied
240
+ - [ ] **[G]** User sign-off received
241
+ - [ ] **[G]** Distribution plan (email, in-app, blog, sales)
242
+
243
+ ## Criterion Severity
244
+
245
+ | Severity | Marker | Definition | Impact on decision |
246
+ |----------|:------:|------------|-------------------|
247
+ | Blocker | **[B]** | Required deliverable is absent or critically incomplete | FAIL — return for rework |
248
+ | Gap | **[G]** | Deliverable exists, but incomplete or with remarks | CONDITIONAL PASS — can pass, but gaps recorded |
249
+ | Note | **[N]** | Minor remark, does not affect transition | PASS — remark passed to next gate as context |
250
+
251
+ > Severity can be raised (G→B if critical), but **cannot be lowered** (B→G). Preset severity is the minimum.
252
+
253
+ ## Decisions
254
+
255
+ | Decision | Condition | Action |
256
+ |---------|---------|--------|
257
+ | **PASS** | 0 Blocker + 0 Gap | Request user Approved → `$handoff` → next gate |
258
+ | **CONDITIONAL PASS** | 0 Blocker + 1-2 Gap | Record gaps → Request user Approved with note → `$handoff` with note |
259
+ | **FAIL** | ≥ 1 Blocker | Return to agent with specific list of gaps → Do not request Approved |
260
+
261
+ > **Absolute rule:** Never skip gates, even if the task seems simple. FAIL — rework — re-check. No exceptions.
262
+
263
+ ### Special Rules
264
+ - Discovery (DISC): absence of JTBD canvas with 5+ evidence quotes (except `/quick-pm`) **automatic Blocker**.
265
+ - PRD without success metrics section **Blocker**.
266
+ - User story without AC — **Blocker**.
267
+ - In Full A/B — camp contamination (Alpha saw Beta artifacts before Mediator) — **automatic Blocker**, escalation.
268
+ - Release Gate without launch checklist for production release — **Blocker**.
269
+
270
+ ## Escalation Protocol on Repeated FAIL
271
+
272
+ | Iteration | Action |
273
+ |:---------:|--------|
274
+ | 1st FAIL | Standard return: list of gaps → agent reworks → re-check |
275
+ | 2nd FAIL | Extended return: gaps + specific instructions "how to fix" + warning |
276
+ | 3rd FAIL | **Escalation to user** |
277
+
278
+ Escalation template (3+ FAIL):
279
+ ```
280
+ ### ⚠️ EscalationGate [ID] fails check (iteration [N])
281
+
282
+ **Gate:** [ID] [Name]
283
+ **FAIL iterations:** [N]
284
+ **Recurring gaps:** [list of gaps not fixed over N iterations]
285
+
286
+ **Options:**
287
+ 1. Revise scope / lower requirements for deliverable
288
+ 2. Return to previous gate (problem is in source data)
289
+ 3. Forced CONDITIONAL PASS (user accepts risk of gaps)
290
+
291
+ Awaiting decision from user.
292
+ ```
293
+
294
+ ## Protocol
295
+
296
+ ### Step 0 Load Context
297
+ 1. Determine which gate to check (by ID from `$board`).
298
+ 2. Determine pipeline mode and session number.
299
+ 3. Load readiness criteria for this gate from the registry (with preset severity).
300
+ 4. If re-check — load gaps from previous iteration.
301
+ 5. For Full A/B check camp contamination (pre-check).
302
+
303
+ ### Step 1 — Check Deliverables
304
+ 1. For each readiness criterion — check: fulfilled / not fulfilled / N/A.
305
+ 2. For unfulfilled — apply preset severity (can raise, cannot lower).
306
+ 3. For unfulfilled — describe specific gap: what is missing / what to fix.
307
+ 4. **Dependency check:** verify that the previous gate's deliverable is explicitly used (not just exists, but cited / applied in the current deliverable).
308
+
309
+ ### Step 2 — Make Decision
310
+ 1. Count severity.
311
+ 2. Apply decision rules (PASS / CONDITIONAL PASS / FAIL).
312
+ 3. Check iteration number if 3+ FAIL, activate escalation protocol.
313
+ 4. Add entry to check log.
314
+
315
+ ### Step 3 Act on Result
316
+ - **PASS:** show user request Approved `$handoff` update `$board`.
317
+ - **CONDITIONAL PASS:** show gaps request Approved with gap confirmation `$handoff` with noteupdate `$board`.
318
+ - **FAIL:** show gaps return to agent update `$board` (status `[↩] Returned`). If 3+ FAIL escalation.
319
+
320
+ ## Example Gate Check PM-SPEC (TeamFlow, `/ship-right-thing` Session 5), iteration 1 CONDITIONAL PASS
321
+
322
+ **Context:** TeamFlow (B2B SaaS, HR-tech). After Mediator synthesis (MED-01) the team wrote a PRD for AI-powered 1:1 summarization. Gate check before handoff to UX + Tech + Data.
323
+
324
+ ```
325
+ ### Gate Check — PM-SPEC (PM final PRD)
326
+
327
+ **Mode:** /ship-right-thing (Full A)
328
+ **Session:** 5 of 6
329
+ **Iteration:** 1
330
+ **Previous gaps:** First check
331
+
332
+ ---
333
+
334
+ #### Readiness Criteria
335
+
336
+ | # | Criterion | Sev | Status | Gap / Comment |
337
+ |---|----------|:---:|:------:|---------------|
338
+ | 1 | PRD: all 14 sections filled | [B] | ✅ | TL;DR, Problem, Goals, Non-Goals, Strategy Fit, Solution, Stories, NFR, Metrics, Risks, Rollout, Deps, Q's, Appendix |
339
+ | 2 | User stories (INVEST), min 3-5 primary | [B] | ✅ | 7 stories (5 primary + 2 error paths) |
340
+ | 3 | AC per story (Gherkin / scenario) | [B] | ✅ | All 7 stories have AC with edge cases + error states |
341
+ | 4 | Success metrics: primary + secondary + guardrails | [B] | ✅ | Primary: weekly 1:1s with AI summary (30→50% in 90d). Guardrails: NPS stability, compliance ticket volume |
342
+ | 5 | Non-Goals explicit | [B] | ✅ | "Not building summarization for group meetings", "Not replacing human note-takers" |
343
+ | 6 | Top 5 risks with mitigation | [G] | ⚠️ | 4 risks vs target 5. Missing: compliance/legal risk re:HR data ingestion |
344
+ | 7 | Rollout plan (launch-checklist) | [G] | ⚠️ | Phased rollout defined, but rollback trigger conditions are not numeric |
345
+ | 8 | Dependencies mapped | [N] | ℹ️ | Platform team dependency specified, but timeline not confirmed |
346
+
347
+ **Dependency check:** Unified Strategy Brief (MED-01) cited in Strategy Fit section. NSM "weekly 1:1s with AI summary" from Strategy Brief = primary success metric in PRD. ✅
348
+
349
+ ---
350
+
351
+ #### Summary
352
+
353
+ | Severity | Count | Items |
354
+ |----------|:-----:|-------|
355
+ | Blocker | 0 | — |
356
+ | Gap | 2 | #6 (risks count), #7 (rollback trigger) |
357
+ | Note | 1 | #8 (deps timeline) |
358
+
359
+ ### Decision: CONDITIONAL PASS
360
+
361
+ **Rationale:** 0 Blocker, 2 Gap acceptable for handoff to parallel work (UX, Tech, Data). Gaps noted: risk register and rollback criteria — TECH-01 and Release Gate will clarify.
362
+
363
+ ---
364
+
365
+ **Deliverables for handoff:**
366
+ - PRD (v1 draft, 14 sections, 7 user stories with AC)
367
+
368
+ **Gaps for downstream:**
369
+ - [Tech Lead] Add 5th risk: compliance/legal — HR data ingestion, GDPR / SOC2 implications
370
+ - [Tech Lead / Data] Define numeric trigger conditions for rollback (error rate, latency, NPS drop)
371
+ - [Release Gate] Confirm platform team timeline
372
+
373
+ → Ready for handoff to **UX Designer + Tech Lead + Data Analyst** (in parallel). Awaiting **"Approved"**.
374
+ ```
375
+
376
+ ## Validation (Quality Gate)
377
+
378
+ Gate check is considered complete if:
379
+
380
+ - [ ] All readiness criteria checked (fulfilled / not fulfilled / N/A no blanks)
381
+ - [ ] Each criterion assigned severity from registry (B/G/N), raised if necessary
382
+ - [ ] For each unfulfilled: severity, gap description, what to fix
383
+ - [ ] Dependency check passed: previous gate's deliverable explicitly used in current
384
+ - [ ] For Full A/B camp contamination check passed
385
+ - [ ] Decision matches rules (not subjective)
386
+ - [ ] At 3+ FAIL escalation protocol activated
387
+ - [ ] Check log updated
388
+ - [ ] On PASS/CONDITIONAL PASS — user Approved received
389
+ - [ ] `$board` updated
390
+
391
+ ## Handoff
392
+ The result of `$gates` is input data for: `$handoff` (gate check attached to envelope).
393
+
394
+ Transfer format: completed gate check template + decision + gaps (if CONDITIONAL PASS) + dependency check result.
395
+
396
+ ## Anti-patterns
397
+
398
+ | Error | Why it's bad | How to do it right |
399
+ |-------|-------------|-------------------|
400
+ | Skip gate "because it's simple" | Errors pass unnoticed | Never skip. No exceptions |
401
+ | PASS without checking all criteria | Unnoticed gaps | Each criterion = fulfilled / not fulfilled / N/A |
402
+ | "Generally ok" instead of specifics | Agent does not know what to fix | Specific gap: "Non-Goals section has only 1 item, need min 2" |
403
+ | FAIL without describing gaps | Agent returns and does not know what to do | Each FAIL = list of specific reworks |
404
+ | Approved without user sign-off | Pipeline protocol violation | Always explicit Approved from user |
405
+ | Discovery without JTBD canvas | Pipeline operates without customer-centric foundation | JTBD — mandatory, its absence = Blocker |
406
+ | Equal importance for all criteria | Minor issue blocks, critical one passes | Preset severity: [B] / [G] / [N] per criterion |
407
+ | Re-check without comparing to gaps | Gap may not have been fixed | Load previous iteration gaps, check each one |
408
+ | Lowering severity (B→G) | Critical deliverable passes without check | Severity can be raised, but not lowered |
409
+ | Infinite FAIL cycle | Pipeline hangs | 3+ FAIL = escalation to user with options |
410
+ | Formal check "exists" | Deliverable exists, but not used by next gate | Dependency check: previous deliverable cited |
411
+ | Camp contamination (Full A/B) | Alpha and Beta mutually influence each other | Contamination = automatic Blocker |
412
+
413
+ ## Output Template
414
+
415
+ ```
416
+ ### Gate Check [ID] [Gate name]
417
+
418
+ **Mode:** [/ship-right-thing | /shape-prioritize | /quick-pm | /spec]
419
+ **Session:** [N of M]
420
+ **Camp:** / β / ]
421
+ **Iteration:** [1 / 2 / N]
422
+ **Previous gaps:** [list or "First check"]
423
+
424
+ ---
425
+
426
+ #### Readiness Criteria
427
+
428
+ | # | Criterion | Sev | Status | Gap / Comment |
429
+ |---|----------|:---:|:------:|---------------|
430
+ | 1 | [Criterion from registry] | [B] | ✅/⚠️/❌ | [If not fulfilled: what is missing] |
431
+
432
+ **Dependency check:** [Deliverable [previous ID] cited: ✅/❌. Details.]
433
+
434
+ **Camp independence check (Full A/B):** [Verified / Contamination detected]
435
+
436
+ ---
437
+
438
+ #### Summary
439
+
440
+ | Severity | Count | Items |
441
+ |----------|:-----:|-------|
442
+ | Blocker | [N] | #[list] |
443
+ | Gap | [N] | #[list] |
444
+ | Note | [N] | #[list] |
445
+
446
+ ### Decision: [ PASS / CONDITIONAL PASS / FAIL ]
447
+
448
+ **Rationale:** [by rules: 0 blocker + 0 gap = PASS etc.]
449
+
450
+ ---
451
+
452
+ #### On PASS / CONDITIONAL PASS:
453
+ **Deliverables for handoff:**
454
+ - [Artifact 1]
455
+
456
+ **Gaps for next gate (if CONDITIONAL):**
457
+ - [Gap 1 — what to consider]
458
+
459
+ → Ready for handoff to **[Next agent]**. Awaiting **"Approved"**.
460
+
461
+ #### On FAIL:
462
+ **Gaps for rework:**
463
+
464
+ | # | Gap | Sev | What to fix | Responsible |
465
+ |---|-----|:---:|-------------|-------------|
466
+ | [N] | [description] | [B] | [specific action] | [agent] |
467
+
468
+ → Return to **[Current agent]**. After fixes — re-check (iteration [N+1]).
469
+ [If iteration ≥ 3: escalation protocol activated]
470
+ ```