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,450 +1,474 @@
1
- ---
2
- name: session-prompt-generator
3
- description: Generating a ready-to-paste prompt for the next session — context, role, tasks, inputs, expected outputs
4
- ---
5
- # Session Prompt Generator — Generating a Prompt for the Next Session
6
-
7
- ## When to Use
8
- - At the **end of a session** in Full Pipeline A (`/ship-right-thing`) or Full Pipeline B (`/shape-prioritize`) — before an inter-session `$handoff`.
9
- - When **handing the project to another operator** — forming a self-contained prompt.
10
- - When the **user requests** «generate a prompt to continue» — at any point.
11
- - During **emergency session termination** — preserving maximum context for recovery.
12
-
13
- > **Key principle:** the next session starts from **ZERO** context. The prompt must contain everything necessary for a new session to continue without loss.
14
-
15
- ## Input
16
-
17
- | Field | Required | Description |
18
- |-------|:--------:|-------------|
19
- | `$board` state | ✅ | Current task board with all statuses |
20
- | Completed deliverables | ✅ | Complete artifacts from current and previous sessions |
21
- | Current gate | ✅ | Where we stopped (gate ID from `$board`) |
22
- | Next gate | ✅ | Where we are going (next gate ID) |
23
- | Adversarial camp | ⬚ | For Full A: Customer-Champion (α) / Business-Champion (β). For Full B: Build-Camp (α) / Cut-Camp (β). Determines artifact filtering |
24
- | Open questions | ⬚ | Blockers, unresolved conflicts, questions for the user |
25
- | Current session number | ✅ | Which session is ending (1-6) |
26
- | Initiative name | ✅ | Name of the product initiative |
27
-
28
- ### Related Skills
29
- | Skill | Interaction | When |
30
- |-------|-------------|------|
31
- | `$board` | Source: current board state is included in the prompt (block 5) | Step 0 |
32
- | `$handoff` | Prompt is included in the inter-session handoff file | Step 5 |
33
- | `$gates` | Source: next gate requirements define the task (block 6) | Step 0 |
34
- | Framework skills | Completed frameworks ($prd-template, $rice-scoring etc.) included in full text in block 4 | Step 1 |
35
-
36
- ## Session → Gates → Agents → Skills Mapping
37
-
38
- ### Full Pipeline A (`/ship-right-thing`, Customer-vs-Business)
39
-
40
- | Session | Gates | Agents | Required Skills | Framework Skills |
41
- |:-------:|-------|--------|----------------|-----------------|
42
- | **1** | COND-01, DISC-01 | Conductor, Discovery | `$board`, `$gates`, `$handoff` | `$jtbd-canvas`, `$problem-statement`, `$assumption-mapping`, `$user-interview-script` |
43
- | **2** | COND-02, STRAT-01α | Conductor, Product Strategist (Customer-Champion) | `$board`, `$gates`, `$handoff` | `$product-vision`, `$okr-framework`, `$north-star-metric`, `$product-roadmap` |
44
- | **3** | COND-03, STRAT-02β | Conductor, Product Strategist (Business-Champion) | `$board`, `$gates`, `$handoff` | (same skills, business lens) |
45
- | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
46
- | **5** | COND-05, PM-SPEC, UX-01, TECH-01, DATA-01 | Conductor, PM, UX Designer, Tech Lead, Data Analyst | `$board`, `$gates`, `$handoff` | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$user-flow`, `$design-brief`, `$epic-breakdown`, `$hypothesis-template`, `$saas-metrics`, `$ab-test-design` |
47
- | **6** | COND-06, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report`, `$launch-checklist` | |
48
-
49
- ### Full Pipeline B (`/shape-prioritize`, Build-vs-Cut)
50
-
51
- | Session | Gates | Agents | Required Skills | Framework Skills |
52
- |:-------:|-------|--------|----------------|-----------------|
53
- | **1** | COND-01, DISC-01 | Conductor, Discovery | `$board`, `$gates`, `$handoff` | `$problem-statement`, `$assumption-mapping` |
54
- | **2** | COND-02, PM-01α, TECH-01α | Conductor, PM (Build-Camp), Tech Lead (Build-Camp) | `$board`, `$gates`, `$handoff` | `$rice-scoring`, `$kano-model`, `$epic-breakdown` |
55
- | **3** | COND-03, PM-02β, TECH-02β | Conductor, PM (Cut-Camp), Tech Lead (Cut-Camp) | `$board`, `$gates`, `$handoff` | `$moscow-prioritization`, `$wsjf-scoring`, `$epic-breakdown` |
56
- | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | |
57
- | **5** | COND-05, PM-SPEC, UX-01, DATA-01 | Conductor, PM, UX Designer, Data Analyst | `$board`, `$gates`, `$handoff` | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$saas-metrics` |
58
- | **6** | COND-06, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | |
59
-
60
- ### Quick Pipeline (`/quick-pm`) and Spec (`/spec`)
61
- Single session — prompt not needed (all gates within one session).
62
-
63
- ## Protocol
64
-
65
- ### Step 0 — State Collection
66
- 1. Read the current `$board` state all gates, statuses, deliverables.
67
- 2. Collect all completed artifacts from the current session.
68
- 3. Load the cumulative index from previous sessions (if available).
69
- 4. Determine the next gate and its requirements from `$gates`.
70
- 5. For Full A/B determine the next session's camp / β / Mediator-neutral).
71
- 6. Using the «Session Gates Agents Skills» mapping determine what to load.
72
-
73
- ### Step 1 Identifying Critical Data
74
- 1. Identify data that is **unrecoverable** without previous context:
75
-
76
- | Category | Examples | Priority |
77
- |----------|---------|:--------:|
78
- | User responses | Discovery interviews (DISC-01), clarifications, decisions | 🔴 Critical |
79
- | JTBD canvas / problems | Canvas, top 3 problem statements | 🔴 Critical |
80
- | Evidence quotes | Verbatim customer quotes | 🔴 Critical |
81
- | Strategy Briefs (Full A) | Alpha + Beta strategy | 🔴 Critical |
82
- | Scope proposals (Full B) | Build + Cut proposals | 🔴 Critical |
83
- | Mediator synthesis | Unified strategy / scope + rationale | 🔴 Critical |
84
- | PRD content | User stories + AC | 🔴 Critical |
85
- | User decisions | Approved, rejections, scope changes | 🟡 Important |
86
- | Progress metrics | Time on gates, blockers | 🟢 Nice-to-have |
87
-
88
- 2. **Rule:** all 🔴 Critical data is included in **full text**. No exceptions.
89
- 3. **Adversarial filter (Full A/B):** if the next session is the opposing camp (Beta after Alpha, before Mediator), opposing camp artifacts are **EXCLUDED** from the prompt. This is a direct consequence of the camp independence rule.
90
-
91
- ### Step 2 Identifying Agents and Skills
92
- 1. Using the mapping determine: which agents and skills are needed in the next session.
93
- 2. Form a list of files to load (specific paths).
94
- 3. For framework skills: specify the concrete skills if already known (from Strategy Brief or PRD).
95
-
96
- ### Step 3 — Forming the Prompt
97
- 1. Fill in the prompt template (6 blocks — see below).
98
- 2. Include FULL TEXT of critical data (not links, not summaries).
99
- 3. Formulate a specific task for the next session.
100
- 4. Specify which agents and skills to activate (specific file paths).
101
- 5. For Full A/B — explicitly state the camp (Alpha / Beta / neutral).
102
-
103
- ### Step 4 Prompt Validation
104
- Self-sufficiency test for each point answer «can this be done without external context?»:
105
-
106
- | # | Check | Result |
107
- |---|-------|:------:|
108
- | 1 | Can work begin having ONLY this prompt? | Yes / No |
109
- | 2 | No references to «previous context» / «as discussed»? | Yes / No |
110
- | 3 | All 🔴 Critical data included in full text? | Yes / No |
111
- | 4 | Session task is specific (gate, action, deliverable)? | Yes / No |
112
- | 5 | Agents and skills listed with file paths? | Yes / No |
113
- | 6 | Task board included? | Yes / No |
114
- | 7 | Open questions recorded? | Yes / No |
115
- | 8 | Camp explicitly stated (Full A/B)? | Yes / No |
116
- | 9 | Opposing camp artifacts excluded (Full A/B)? | Yes / No |
117
-
118
- **If even one = No revise the prompt.**
119
-
120
- ### Step 5Saving
121
- 1. Include the prompt in the `$handoff` file: `docs/product/session-N-handoff.md`.
122
- 2. Show the prompt to the user for saving / copying.
123
- 3. Warn: «This prompt paste it at the start of the next session».
124
-
125
- ### Step 6Emergency Mode
126
- If the session terminates unexpectedly (timeout, error, context loss):
127
-
128
- 1. **Immediately** save everything available: board, last deliverable, open questions.
129
- 2. Form an **emergency prompt** (minimum version):
130
- - Block 1 (identification) required.
131
- - Block 5 (board state) — required.
132
- - Block 4 (data) everything that could be collected.
133
- - Block 6 (task) «Restore context from session-N-handoff.md, verify data integrity, continue from gate [ID]».
134
- 3. Mark the prompt as **⚠️ EMERGENCY possible data loss**.
135
- 4. Indicate which data might have been lost and how to recover (repeat user interview, request from user).
136
-
137
- ## Generated Prompt Structure
138
-
139
- ### Block 1 Initiative Identification
140
- - Initiative name.
141
- - Pipeline mode (/ship-right-thing / /shape-prioritize).
142
- - Next session number.
143
- - Which sessions are complete.
144
- - Next session camp (Alpha / Beta / Mediator-neutral / —).
145
-
146
- ### Block 2 Loading Instructions
147
- - Read `domains/product/AGENTS.md`.
148
- - Load agents needed in this session (from mapping).
149
- - Load skills: `$board`, `$handoff`, `$gates` + gate-specific ones.
150
- - Specific file paths.
151
-
152
- ### Block 3 Work Completed (summary)
153
- - What was done in previous sessions (2-3 sentences per session).
154
- - Key decisions and their rationale.
155
-
156
- ### Block 4 — Critical Data
157
- - FULL TEXT of key artifacts needed to continue.
158
- - Discovery Brief, JTBD canvas, Strategy Briefs, Mediator synthesis.
159
- - User responses to interviews (if any).
160
- - **Camp filter:** opposing camp artifacts excluded (Full A/B, before Mediator).
161
-
162
- ### Block 5 — Current State
163
- - Task board (`$board`) in current state.
164
- - Which gate is next.
165
- - Open questions and blockers.
166
-
167
- ### Block 6 Session Task
168
- - Specific formulation: what needs to be done in this session.
169
- - Expected outcome (deliverables).
170
- - Constraints and specifics (camp lens for Full A/B).
171
-
172
- ## Prompt Formation Rules
173
-
174
- ### Required Rules
175
- 1. **Self-sufficiency** — the prompt must work without ANY previous context.
176
- 2. **Data completeness**include FULL text, not links and not summaries.
177
- 3. **Task specificity** not «continue work», but «execute STRAT-02β: form Business-Champion Strategy Brief based on Discovery Brief, ignore Camp Alpha artifacts».
178
- 4. **Structure** clear blocks, marked with headings.
179
- 5. **Skills loading** — explicitly state which agents and skills to load with file paths.
180
- 6. **Adversarial independence**for Full A/B when handing off to opposing camp: explicitly record artifact exclusion.
181
-
182
- ### Prohibited Elements
183
- 1. References to «previous session» without full content.
184
- 2. «As we discussed» no context, nothing was discussed.
185
- 3. «See results above» — there is no «above», everything must be in the prompt.
186
- 4. Abbreviated data«key conclusions: ...». ALL conclusions are needed.
187
- 5. Assumptions about context «you already know that...».
188
- 6. In Full A/B: mixing artifacts from different camps before Mediator.
189
-
190
- ## Example — Prompt for Session 3 (TeamFlow, `/ship-right-thing`, Beta Camp: Business-Champion)
191
-
192
- **Context:** TeamFlow (B2B SaaS HR-tech, $8M ARR). Initiative: AI-powered 1:1 summarization. Session 2 complete Camp Alpha (Customer-Champion) formed their Strategy Brief. Session 3: Camp Beta (Business-Champion). KEY: Alpha artifacts are EXCLUDED.
193
-
194
- ```
195
- ---
196
- ## Prompt for Session 3 — AI-powered 1:1 Summarization (TeamFlow)
197
-
198
- ### 1. Initiative
199
- - **Name:** AI-powered 1:1 note summarization for TeamFlow
200
- - **Mode:** Full Pipeline A (/ship-right-thing)
201
- - **Session:** 3 of 6
202
- - **Camp:** **BetaBusiness-Champion**
203
- - **Previous sessions:** 1 (Discovery Brief), 2 (Strategy Brief Alpha: Customer-Champion, EXCLUDED from this prompt)
204
-
205
- ### 2. Loading
206
- Read:
207
- - `domains/product/AGENTS.md`
208
- - `domains/product/.agents/skills/board/SKILL.md`
209
- - `domains/product/.agents/skills/handoff/SKILL.md`
210
- - `domains/product/.agents/skills/gates/SKILL.md`
211
- - `domains/product/.agents/skills/product-vision/SKILL.md`
212
- - `domains/product/.agents/skills/okr-framework/SKILL.md`
213
- - `domains/product/.agents/skills/north-star-metric/SKILL.md`
214
- - `domains/product/.agents/skills/product-roadmap/SKILL.md`
215
- - `domains/product/agents/product_strategist.md`
216
- - `domains/product/agents/conductor.md`
217
-
218
- Activate: Conductor (COND-03), Product Strategist (STRAT-02β).
219
- Role: **Business-Champion (β)** — focus on revenue, margin, competitive moat, strategic positioning. Do NOT play Customer-Champion.
220
-
221
- ### 3. What Was Done
222
- **Session 1:** Discovery. Conducted 8 customer interviews (4 buyer VP HR + 4 end-user managers). JTBD canvas (buyer + end-user separately). Top 3 problem statements. Assumption map (12 assumptions, 4 high-risk).
223
- **Session 2:** Camp Alpha (Customer-Champion) formed their Strategy Brief. **IMPORTANT:** this brief is NOT passed to you until MED-01 (Step 4). You work independently, based on Discovery Brief ONLY.
224
-
225
- **Key decisions:**
226
- | # | Decision | Rationale | Who decided |
227
- |---|---------|-----------|-------------|
228
- | 1 | Focus on mid-market + enterprise (not SMB) | SMB pays less + higher churn | User, Session 1 |
229
- | 2 | Adversarial: Customer vs Business | High-stakes initiative, two perspectives insufficient | User, Session 1 |
230
-
231
- ### 4. Data (full text, with camp filtering)
232
-
233
- #### Discovery Brief (from DISC-01 / session-1-handoff.md)
234
-
235
- **ICP:**
236
- - Firmographic: B2B SaaS / Tech companies, 100-500 employees, $5M-$50M ARR
237
- - Buyer persona: VP People/HR, 5-10 years experience, reports to CEO/COO
238
- - End-user persona: People managers (5-15 direct reports), some ICs in structured programs
239
- - Geographic: US (60%) + EU (30%) + APAC (10%)
240
-
241
- **JTBD (buyer = VP HR):**
242
- - **Functional:** «Ensure every manager runs consistently high-quality 1:1s across org»
243
- - **Emotional:** «Feel confident that people development does not depend on individual manager skill»
244
- - **Social:** «Be seen as data-driven People leader by CEO»
245
-
246
- **JTBD (end-user = manager):**
247
- - **Functional:** «Capture 1:1 discussion and not lose action items between meetings»
248
- - **Emotional:** «Feel prepared without spending 30 min before each 1:1»
249
- - **Social:** «Be seen as supportive manager by reports»
250
-
251
- **Top 3 Problem Statements:**
252
- 1. Managers with 5+ reports spend 45-60 min/week on prep + note-taking, 30% of them acknowledge burnout from admin overhead. Evidence: 6 of 8 interviews + 120 support tickets Q1 2026.
253
- 2. VP HR has no visibility into 1:1 quality/frequency across org relying on self-report + anecdote. Evidence: 3 of 4 buyer interviews.
254
- 3. Action items from 1:1s are not completed in 40% of cases (by self-report), often forgotten. Evidence: 5 of 8 end-user interviews + internal product analytics (action items marked completed vs total created).
255
-
256
- **Top 4 High-Risk Assumptions:**
257
- - **Value (V1):** Customers will pay $5-15/seat/month premium for AI summarization feature. Uncertainty 4, Impact 5, Risk 20.
258
- - **Feasibility (F1):** LLM summarization quality acceptable (no hallucinations) for sensitive HR conversations. Uncertainty 4, Impact 5, Risk 20.
259
- - **Viability (Vi1):** Privacy / GDPR / SOC2 compliance implications manageable for HR data ingestion. Uncertainty 3, Impact 5, Risk 15.
260
- - **Usability (U1):** Managers will trust AI summaries enough to use them instead of manual notes. Uncertainty 4, Impact 4, Risk 16.
261
-
262
- **Evidence Inventory:** 8 interviews (verbatim quotes attached in session-1-handoff.md), 120 support tickets Q1 2026, internal product analytics, competitor feature comparison (Lattice, 15Five, Culture Amp).
263
-
264
- **Open Questions:**
265
- - Pricing model: per-seat premium vs bundled vs usage-based?
266
- - Build vs Buy for LLM (OpenAI vs fine-tuned open-source)?
267
- - Scope: just 1:1s or all meetings (team meetings, reviews)?
268
-
269
- **🚫 Camp Alpha Strategy Brief — EXCLUDED from prompt (independence rule).**
270
-
271
- ### 5. Current State
272
-
273
- #### Task Board
274
- 📊 Progress: 29% (5/17) | Session: 3/6 | Blockers: 0
275
-
276
- | # | ID | Gate | Session | Camp | Status | Deliverable |
277
- |---|-----|------|:-------:|:----:|:------:|-------------|
278
- | 1 | COND-01 | Conductor | 1 | | [✓] | Mode /ship-right-thing |
279
- | 2 | DISC-01 | Discovery | 1 | — | [✓] | Discovery Brief |
280
- | 3 | COND-02 | Conductor (s.2) | 2 | — | [✓] | Camp Alpha assigned |
281
- | 4 | STRAT-01α | Customer-Champion | 2 | α | [✓] | Strategy Brief Alpha (EXCLUDED) |
282
- | 5 | COND-03 | Conductor (s.3) | 3 | | [→] | |
283
- | 6 | STRAT-02β | Business-Champion | 3 | β | [ ] | |
284
- | 7-17 | ... | ... | 4-6 | ... | [ ] | |
285
-
286
- #### Open Questions
287
- - Pricing model (buyer interview gave no clear signal)
288
- - LLM build vs buy
289
-
290
- ### 6. Session 3 Task (Beta Camp)
291
-
292
- **Gates:** COND-03 → STRAT-02β
293
-
294
- **What to do (Business-Champion lens):**
295
- 1. **COND-03 (Conductor):** Load Discovery Brief, assign Camp Beta role explicitly. Verify Camp Alpha artifacts EXCLUDED (independence check).
296
- 2. **STRAT-02β (Product Strategist):** Form Business-Champion Strategy Brief:
297
- - **Vision** — business outcome frame («help companies measurably improve manager effectiveness and retain talent»)
298
- - **NSM** business-value metric (example: «ARR from accounts with AI summarization enabled on >60% teams»)
299
- - **OKR** — quarterly goals with revenue / NRR / competitive moat emphasis
300
- - **Roadmap** themes with business ROI rationale
301
- - **Pricing hypothesis** — specific model (per-seat premium? usage-based?)
302
-
303
- **Expected outcome:**
304
- `strategy-brief-beta.md` (~800-1200 words) with explicit business-lens argument. Include:
305
- - Why now (market timing)
306
- - Revenue impact model (3-year forecast scenarios)
307
- - Competitive moat angle
308
- - NRR / expansion story
309
-
310
- **Constraints:**
311
- - **DO NOT** pretend to play Customer-Champion lens
312
- - **DO NOT** request Camp Alpha artifacts (they're held by Conductor until MED-01)
313
- - Mediator (MED-01, Session 4) synthesizes — your task is to present the sharpest business case
314
-
315
- → Start as Conductor (COND-03). Verify camp isolation, activate Product Strategist (β). Pass Discovery Brief (ONLY) as input.
316
- ---
317
- ```
318
-
319
- ## Validation (Quality Gate)
320
-
321
- A prompt is considered correct if:
322
-
323
- - [ ] Prompt is self-contained work can begin without external context
324
- - [ ] Initiative name and mode stated
325
- - [ ] Session number and session history stated
326
- - [ ] Camp explicitly stated (Full A/B)
327
- - [ ] Agents and skills for loading listed with file paths (from mapping)
328
- - [ ] All 🔴 Critical data included in full text
329
- - [ ] Task board (`$board`) included in current state with metrics
330
- - [ ] Next gate and task formulated specifically (gate, action, deliverable)
331
- - [ ] Camp filter applied: opposing camp artifacts explicitly excluded (Full A/B, before Mediator)
332
- - [ ] Open questions and blockers recorded
333
- - [ ] No prohibited elements (references without content, abbreviations, assumptions)
334
- - [ ] Validation test (9 points, step 4) — all «Yes»
335
- - [ ] In emergency mode prompt marked ⚠️, lost data indicated
336
-
337
- ## Handoff
338
- The result of `$session-prompt-generator` is input for:
339
- - **Next session** via user copying the prompt.
340
- - **`$handoff`** — prompt included in `docs/product/session-N-handoff.md` file.
341
- - **`$board`** — board state saved in the prompt.
342
-
343
- Transfer format: prompt in markdown, ready to paste at the start of a new session.
344
-
345
- ## Anti-patterns
346
-
347
- | Error | Why it's bad | How to do it right |
348
- |-------|-------------|-------------------|
349
- | Prompt without Discovery data | Next session loses customer-centric foundation | Include FULL text of Discovery Brief |
350
- | «Continue work» | No context, nothing to continue from | Specific task: gate, action, deliverable |
351
- | File references without content | Files may be unavailable | Include content directly in the prompt |
352
- | Prompt without task board | Unclear where we are in the pipeline | Always include `$board` with metrics |
353
- | Abbreviated artifacts | Loss of critical details | Full text of each 🔴 Critical artifact |
354
- | Skipping open questions | Problems will resurface | Record all blockers and questions |
355
- | No loading instructions | Session won't load needed agents | Mapping specific file paths |
356
- | Prompt > 50% «filler» | Dilutes critical data | Structure: blocks, tables, specifics |
357
- | Emergency termination without prompt | Total context loss | Emergency mode: minimal prompt + ⚠️ mark |
358
- | Camp contamination in prompt | Opposing camp artifacts enter prompt → independence violated | Explicit filter + note «EXCLUDED» for missing artifacts |
359
-
360
- ## Output Template
361
-
362
- ```
363
- ---
364
- ## Prompt for Session [N+1] [Initiative Name]
365
-
366
- ### 1. Initiative
367
- - **Name:** [Name]
368
- - **Mode:** [/ship-right-thing | /shape-prioritize]
369
- - **Session:** [N+1] of 6
370
- - **Camp:** [Alpha (Customer/Build) | Beta (Business/Cut) | Mediator-neutral | —]
371
- - **Previous sessions:** 1-[N] complete
372
-
373
- ### 2. Loading
374
- Read:
375
- - `domains/product/AGENTS.md`
376
- - `domains/product/.agents/skills/board/SKILL.md`
377
- - `domains/product/.agents/skills/handoff/SKILL.md`
378
- - `domains/product/.agents/skills/gates/SKILL.md`
379
- - [Specific skills: file paths]
380
-
381
- Activate agents: [List of agents with gate IDs]
382
-
383
- Role: **[Camp]** — [description of lens: focus on X, do not do Y]
384
-
385
- ### 3. What Was Done
386
- **Session 1:** [Summary 2-3 sentences]
387
- **Session [N]:** [Summary 2-3 sentences]
388
-
389
- **Key decisions:**
390
- | # | Decision | Rationale | Who decided |
391
- |---|---------|-----------|-------------|
392
- | 1 | [Decision] | [Why] | [User / Conductor] |
393
-
394
- ### 4. Data (full text, with camp filtering)
395
-
396
- #### Discovery Brief (from DISC-01)
397
- [FULL TEXT]
398
-
399
- #### Strategy Briefs (if Mediator Session)
400
- #### Alpha: [FULL TEXT]
401
- #### Beta: [FULL TEXT]
402
-
403
- #### [Other artifacts as needed]
404
- [FULL TEXT]
405
-
406
- **🚫 Excluded (camp filter):**
407
- - [Opposing camp artifacts, if applicable]
408
-
409
- ### 5. Current State
410
-
411
- #### Task Board
412
- [Full board from $board with progress metrics]
413
-
414
- #### Open Questions
415
- | # | Question / Blocker | Severity | For which gate |
416
- |---|-------------------|:--------:|:--------------:|
417
- | 1 | [Description] | 🔴/🟡/🟢 | [ID] |
418
-
419
- ### 6. Session [N+1] Task
420
- **Gates:** [ID list]
421
- **What to do:** [Specific description per gate + camp lens]
422
- **Expected outcome:** [Deliverables]
423
- **Constraints:** [Camp independence rules, DO NOT do, DO NOT request]
424
-
425
- Start as Conductor (COND-xx). Load board, verify camp isolation, pass control to [next agent].
426
- ---
427
- ```
428
-
429
- ### Emergency Prompt (minimum version)
430
-
431
- ```
432
- ---
433
- ## ⚠️ EMERGENCY PROMPT — Session [N+1] — [Initiative Name]
434
-
435
- **Status:** Session [N] terminated abnormally. Data loss possible.
436
-
437
- ### What Was Saved
438
- [Everything that could be collected: board, last deliverable, questions]
439
-
440
- ### What May Have Been Lost
441
- | # | Data | Recovery Method |
442
- |---|------|-----------------|
443
- | 1 | [What was lost] | [Repeat interview / request from user / restore from handoff] |
444
-
445
- ### Task
446
- Restore context from `docs/product/session-[N]-handoff.md`. Verify data integrity. For Full A/B — verify camp isolation. Continue from gate [ID].
447
-
448
- → Start as Conductor (COND-xx). Priority: data integrity verification before continuing.
449
- ---
450
- ```
1
+ ---
2
+ name: session-prompt-generator
3
+ description: Generating a ready-to-paste prompt for the next session — context, role, tasks, inputs, expected outputs
4
+ type: triggered
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
+ - session-prompt-generator
23
+ - session prompt
24
+ - next session prompt
25
+ related: []
26
+ budget_lines: 474
27
+ schema_version: 1
28
+ ---
29
+ # Session Prompt Generator Generating a Prompt for the Next Session
30
+
31
+ ## When to Use
32
+ - At the **end of a session** in Full Pipeline A (`/ship-right-thing`) or Full Pipeline B (`/shape-prioritize`) — before an inter-session `$handoff`.
33
+ - When **handing the project to another operator** forming a self-contained prompt.
34
+ - When the **user requests** «generate a prompt to continue» at any point.
35
+ - During **emergency session termination** — preserving maximum context for recovery.
36
+
37
+ > **Key principle:** the next session starts from **ZERO** context. The prompt must contain everything necessary for a new session to continue without loss.
38
+
39
+ ## Input
40
+
41
+ | Field | Required | Description |
42
+ |-------|:--------:|-------------|
43
+ | `$board` state | | Current task board with all statuses |
44
+ | Completed deliverables | | Complete artifacts from current and previous sessions |
45
+ | Current gate | | Where we stopped (gate ID from `$board`) |
46
+ | Next gate | | Where we are going (next gate ID) |
47
+ | Adversarial camp | | For Full A: Customer-Champion (α) / Business-Champion (β). For Full B: Build-Camp (α) / Cut-Camp (β). Determines artifact filtering |
48
+ | Open questions | ⬚ | Blockers, unresolved conflicts, questions for the user |
49
+ | Current session number | ✅ | Which session is ending (1-6) |
50
+ | Initiative name | ✅ | Name of the product initiative |
51
+
52
+ ### Related Skills
53
+ | Skill | Interaction | When |
54
+ |-------|-------------|------|
55
+ | `$board` | Source: current board state is included in the prompt (block 5) | Step 0 |
56
+ | `$handoff` | Prompt is included in the inter-session handoff file | Step 5 |
57
+ | `$gates` | Source: next gate requirements define the task (block 6) | Step 0 |
58
+ | Framework skills | Completed frameworks ($prd-template, $rice-scoring etc.) included in full text in block 4 | Step 1 |
59
+
60
+ ## Session Gates Agents → Skills Mapping
61
+
62
+ ### Full Pipeline A (`/ship-right-thing`, Customer-vs-Business)
63
+
64
+ | Session | Gates | Agents | Required Skills | Framework Skills |
65
+ |:-------:|-------|--------|----------------|-----------------|
66
+ | **1** | COND-01, DISC-01 | Conductor, Discovery | `$board`, `$gates`, `$handoff` | `$jtbd-canvas`, `$problem-statement`, `$assumption-mapping`, `$user-interview-script` |
67
+ | **2** | COND-02, STRAT-01α | Conductor, Product Strategist (Customer-Champion) | `$board`, `$gates`, `$handoff` | `$product-vision`, `$okr-framework`, `$north-star-metric`, `$product-roadmap` |
68
+ | **3** | COND-03, STRAT-02β | Conductor, Product Strategist (Business-Champion) | `$board`, `$gates`, `$handoff` | (same skills, business lens) |
69
+ | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
70
+ | **5** | COND-05, PM-SPEC, UX-01, TECH-01, DATA-01 | Conductor, PM, UX Designer, Tech Lead, Data Analyst | `$board`, `$gates`, `$handoff` | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$user-flow`, `$design-brief`, `$epic-breakdown`, `$hypothesis-template`, `$saas-metrics`, `$ab-test-design` |
71
+ | **6** | COND-06, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report`, `$launch-checklist` | — |
72
+
73
+ ### Full Pipeline B (`/shape-prioritize`, Build-vs-Cut)
74
+
75
+ | Session | Gates | Agents | Required Skills | Framework Skills |
76
+ |:-------:|-------|--------|----------------|-----------------|
77
+ | **1** | COND-01, DISC-01 | Conductor, Discovery | `$board`, `$gates`, `$handoff` | `$problem-statement`, `$assumption-mapping` |
78
+ | **2** | COND-02, PM-01α, TECH-01α | Conductor, PM (Build-Camp), Tech Lead (Build-Camp) | `$board`, `$gates`, `$handoff` | `$rice-scoring`, `$kano-model`, `$epic-breakdown` |
79
+ | **3** | COND-03, PM-02β, TECH-02β | Conductor, PM (Cut-Camp), Tech Lead (Cut-Camp) | `$board`, `$gates`, `$handoff` | `$moscow-prioritization`, `$wsjf-scoring`, `$epic-breakdown` |
80
+ | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
81
+ | **5** | COND-05, PM-SPEC, UX-01, DATA-01 | Conductor, PM, UX Designer, Data Analyst | `$board`, `$gates`, `$handoff` | `$prd-template`, `$user-story`, `$acceptance-criteria`, `$saas-metrics` |
82
+ | **6** | COND-06, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | — |
83
+
84
+ ### Quick Pipeline (`/quick-pm`) and Spec (`/spec`)
85
+ Single session prompt not needed (all gates within one session).
86
+
87
+ ## Protocol
88
+
89
+ ### Step 0 State Collection
90
+ 1. Read the current `$board` state — all gates, statuses, deliverables.
91
+ 2. Collect all completed artifacts from the current session.
92
+ 3. Load the cumulative index from previous sessions (if available).
93
+ 4. Determine the next gate and its requirements from `$gates`.
94
+ 5. For Full A/B determine the next session's camp (α / β / Mediator-neutral).
95
+ 6. Using the «Session → Gates → Agents → Skills» mapping determine what to load.
96
+
97
+ ### Step 1 Identifying Critical Data
98
+ 1. Identify data that is **unrecoverable** without previous context:
99
+
100
+ | Category | Examples | Priority |
101
+ |----------|---------|:--------:|
102
+ | User responses | Discovery interviews (DISC-01), clarifications, decisions | 🔴 Critical |
103
+ | JTBD canvas / problems | Canvas, top 3 problem statements | 🔴 Critical |
104
+ | Evidence quotes | Verbatim customer quotes | 🔴 Critical |
105
+ | Strategy Briefs (Full A) | Alpha + Beta strategy | 🔴 Critical |
106
+ | Scope proposals (Full B) | Build + Cut proposals | 🔴 Critical |
107
+ | Mediator synthesis | Unified strategy / scope + rationale | 🔴 Critical |
108
+ | PRD content | User stories + AC | 🔴 Critical |
109
+ | User decisions | Approved, rejections, scope changes | 🟡 Important |
110
+ | Progress metrics | Time on gates, blockers | 🟢 Nice-to-have |
111
+
112
+ 2. **Rule:** all 🔴 Critical data is included in **full text**. No exceptions.
113
+ 3. **Adversarial filter (Full A/B):** if the next session is the opposing camp (Beta after Alpha, before Mediator), opposing camp artifacts are **EXCLUDED** from the prompt. This is a direct consequence of the camp independence rule.
114
+
115
+ ### Step 2 Identifying Agents and Skills
116
+ 1. Using the mapping determine: which agents and skills are needed in the next session.
117
+ 2. Form a list of files to load (specific paths).
118
+ 3. For framework skills: specify the concrete skills if already known (from Strategy Brief or PRD).
119
+
120
+ ### Step 3Forming the Prompt
121
+ 1. Fill in the prompt template (6 blocks see below).
122
+ 2. Include FULL TEXT of critical data (not links, not summaries).
123
+ 3. Formulate a specific task for the next session.
124
+ 4. Specify which agents and skills to activate (specific file paths).
125
+ 5. For Full A/B explicitly state the camp (Alpha / Beta / neutral).
126
+
127
+ ### Step 4 — Prompt Validation
128
+ Self-sufficiency test for each point answer «can this be done without external context?»:
129
+
130
+ | # | Check | Result |
131
+ |---|-------|:------:|
132
+ | 1 | Can work begin having ONLY this prompt? | Yes / No |
133
+ | 2 | No references to «previous context» / «as discussed»? | Yes / No |
134
+ | 3 | All 🔴 Critical data included in full text? | Yes / No |
135
+ | 4 | Session task is specific (gate, action, deliverable)? | Yes / No |
136
+ | 5 | Agents and skills listed with file paths? | Yes / No |
137
+ | 6 | Task board included? | Yes / No |
138
+ | 7 | Open questions recorded? | Yes / No |
139
+ | 8 | Camp explicitly stated (Full A/B)? | Yes / No |
140
+ | 9 | Opposing camp artifacts excluded (Full A/B)? | Yes / No |
141
+
142
+ **If even one = No — revise the prompt.**
143
+
144
+ ### Step 5 Saving
145
+ 1. Include the prompt in the `$handoff` file: `docs/product/session-N-handoff.md`.
146
+ 2. Show the prompt to the user for saving / copying.
147
+ 3. Warn: «This prompt — paste it at the start of the next session».
148
+
149
+ ### Step 6 Emergency Mode
150
+ If the session terminates unexpectedly (timeout, error, context loss):
151
+
152
+ 1. **Immediately** save everything available: board, last deliverable, open questions.
153
+ 2. Form an **emergency prompt** (minimum version):
154
+ - Block 1 (identification) required.
155
+ - Block 5 (board state) — required.
156
+ - Block 4 (data) everything that could be collected.
157
+ - Block 6 (task) «Restore context from session-N-handoff.md, verify data integrity, continue from gate [ID]».
158
+ 3. Mark the prompt as **⚠️ EMERGENCY possible data loss**.
159
+ 4. Indicate which data might have been lost and how to recover (repeat user interview, request from user).
160
+
161
+ ## Generated Prompt Structure
162
+
163
+ ### Block 1 Initiative Identification
164
+ - Initiative name.
165
+ - Pipeline mode (/ship-right-thing / /shape-prioritize).
166
+ - Next session number.
167
+ - Which sessions are complete.
168
+ - Next session camp (Alpha / Beta / Mediator-neutral / —).
169
+
170
+ ### Block 2 Loading Instructions
171
+ - Read `domains/product/AGENTS.md`.
172
+ - Load agents needed in this session (from mapping).
173
+ - Load skills: `$board`, `$handoff`, `$gates` + gate-specific ones.
174
+ - Specific file paths.
175
+
176
+ ### Block 3Work Completed (summary)
177
+ - What was done in previous sessions (2-3 sentences per session).
178
+ - Key decisions and their rationale.
179
+
180
+ ### Block 4Critical Data
181
+ - FULL TEXT of key artifacts needed to continue.
182
+ - Discovery Brief, JTBD canvas, Strategy Briefs, Mediator synthesis.
183
+ - User responses to interviews (if any).
184
+ - **Camp filter:** opposing camp artifacts excluded (Full A/B, before Mediator).
185
+
186
+ ### Block 5Current State
187
+ - Task board (`$board`) in current state.
188
+ - Which gate is next.
189
+ - Open questions and blockers.
190
+
191
+ ### Block 6 — Session Task
192
+ - Specific formulation: what needs to be done in this session.
193
+ - Expected outcome (deliverables).
194
+ - Constraints and specifics (camp lens for Full A/B).
195
+
196
+ ## Prompt Formation Rules
197
+
198
+ ### Required Rules
199
+ 1. **Self-sufficiency** the prompt must work without ANY previous context.
200
+ 2. **Data completeness** include FULL text, not links and not summaries.
201
+ 3. **Task specificity** not «continue work», but «execute STRAT-02β: form Business-Champion Strategy Brief based on Discovery Brief, ignore Camp Alpha artifacts».
202
+ 4. **Structure** — clear blocks, marked with headings.
203
+ 5. **Skills loading** explicitly state which agents and skills to load with file paths.
204
+ 6. **Adversarial independence** — for Full A/B when handing off to opposing camp: explicitly record artifact exclusion.
205
+
206
+ ### Prohibited Elements
207
+ 1. References to «previous session» without full content.
208
+ 2. «As we discussed» — no context, nothing was discussed.
209
+ 3. «See results above» — there is no «above», everything must be in the prompt.
210
+ 4. Abbreviated data — «key conclusions: ...». ALL conclusions are needed.
211
+ 5. Assumptions about context — «you already know that...».
212
+ 6. In Full A/B: mixing artifacts from different camps before Mediator.
213
+
214
+ ## Example — Prompt for Session 3 (TeamFlow, `/ship-right-thing`, Beta Camp: Business-Champion)
215
+
216
+ **Context:** TeamFlow (B2B SaaS HR-tech, $8M ARR). Initiative: AI-powered 1:1 summarization. Session 2 complete — Camp Alpha (Customer-Champion) formed their Strategy Brief. Session 3: Camp Beta (Business-Champion). KEY: Alpha artifacts are EXCLUDED.
217
+
218
+ ```
219
+ ---
220
+ ## Prompt for Session 3 — AI-powered 1:1 Summarization (TeamFlow)
221
+
222
+ ### 1. Initiative
223
+ - **Name:** AI-powered 1:1 note summarization for TeamFlow
224
+ - **Mode:** Full Pipeline A (/ship-right-thing)
225
+ - **Session:** 3 of 6
226
+ - **Camp:** **Beta Business-Champion**
227
+ - **Previous sessions:** 1 (Discovery Brief), 2 (Strategy Brief Alpha: Customer-Champion, EXCLUDED from this prompt)
228
+
229
+ ### 2. Loading
230
+ Read:
231
+ - `domains/product/AGENTS.md`
232
+ - `domains/product/.agents/skills/board/SKILL.md`
233
+ - `domains/product/.agents/skills/handoff/SKILL.md`
234
+ - `domains/product/.agents/skills/gates/SKILL.md`
235
+ - `domains/product/.agents/skills/product-vision/SKILL.md`
236
+ - `domains/product/.agents/skills/okr-framework/SKILL.md`
237
+ - `domains/product/.agents/skills/north-star-metric/SKILL.md`
238
+ - `domains/product/.agents/skills/product-roadmap/SKILL.md`
239
+ - `domains/product/agents/product_strategist.md`
240
+ - `domains/product/agents/conductor.md`
241
+
242
+ Activate: Conductor (COND-03), Product Strategist (STRAT-02β).
243
+ Role: **Business-Champion (β)** focus on revenue, margin, competitive moat, strategic positioning. Do NOT play Customer-Champion.
244
+
245
+ ### 3. What Was Done
246
+ **Session 1:** Discovery. Conducted 8 customer interviews (4 buyer VP HR + 4 end-user managers). JTBD canvas (buyer + end-user separately). Top 3 problem statements. Assumption map (12 assumptions, 4 high-risk).
247
+ **Session 2:** Camp Alpha (Customer-Champion) formed their Strategy Brief. **IMPORTANT:** this brief is NOT passed to you until MED-01 (Step 4). You work independently, based on Discovery Brief ONLY.
248
+
249
+ **Key decisions:**
250
+ | # | Decision | Rationale | Who decided |
251
+ |---|---------|-----------|-------------|
252
+ | 1 | Focus on mid-market + enterprise (not SMB) | SMB pays less + higher churn | User, Session 1 |
253
+ | 2 | Adversarial: Customer vs Business | High-stakes initiative, two perspectives insufficient | User, Session 1 |
254
+
255
+ ### 4. Data (full text, with camp filtering)
256
+
257
+ #### Discovery Brief (from DISC-01 / session-1-handoff.md)
258
+
259
+ **ICP:**
260
+ - Firmographic: B2B SaaS / Tech companies, 100-500 employees, $5M-$50M ARR
261
+ - Buyer persona: VP People/HR, 5-10 years experience, reports to CEO/COO
262
+ - End-user persona: People managers (5-15 direct reports), some ICs in structured programs
263
+ - Geographic: US (60%) + EU (30%) + APAC (10%)
264
+
265
+ **JTBD (buyer = VP HR):**
266
+ - **Functional:** «Ensure every manager runs consistently high-quality 1:1s across org»
267
+ - **Emotional:** «Feel confident that people development does not depend on individual manager skill»
268
+ - **Social:** «Be seen as data-driven People leader by CEO»
269
+
270
+ **JTBD (end-user = manager):**
271
+ - **Functional:** «Capture 1:1 discussion and not lose action items between meetings»
272
+ - **Emotional:** «Feel prepared without spending 30 min before each 1:1»
273
+ - **Social:** «Be seen as supportive manager by reports»
274
+
275
+ **Top 3 Problem Statements:**
276
+ 1. Managers with 5+ reports spend 45-60 min/week on prep + note-taking, 30% of them acknowledge burnout from admin overhead. Evidence: 6 of 8 interviews + 120 support tickets Q1 2026.
277
+ 2. VP HR has no visibility into 1:1 quality/frequency across org — relying on self-report + anecdote. Evidence: 3 of 4 buyer interviews.
278
+ 3. Action items from 1:1s are not completed in 40% of cases (by self-report), often forgotten. Evidence: 5 of 8 end-user interviews + internal product analytics (action items marked completed vs total created).
279
+
280
+ **Top 4 High-Risk Assumptions:**
281
+ - **Value (V1):** Customers will pay $5-15/seat/month premium for AI summarization feature. Uncertainty 4, Impact 5, Risk 20.
282
+ - **Feasibility (F1):** LLM summarization quality acceptable (no hallucinations) for sensitive HR conversations. Uncertainty 4, Impact 5, Risk 20.
283
+ - **Viability (Vi1):** Privacy / GDPR / SOC2 compliance implications manageable for HR data ingestion. Uncertainty 3, Impact 5, Risk 15.
284
+ - **Usability (U1):** Managers will trust AI summaries enough to use them instead of manual notes. Uncertainty 4, Impact 4, Risk 16.
285
+
286
+ **Evidence Inventory:** 8 interviews (verbatim quotes attached in session-1-handoff.md), 120 support tickets Q1 2026, internal product analytics, competitor feature comparison (Lattice, 15Five, Culture Amp).
287
+
288
+ **Open Questions:**
289
+ - Pricing model: per-seat premium vs bundled vs usage-based?
290
+ - Build vs Buy for LLM (OpenAI vs fine-tuned open-source)?
291
+ - Scope: just 1:1s or all meetings (team meetings, reviews)?
292
+
293
+ **🚫 Camp Alpha Strategy Brief — EXCLUDED from prompt (independence rule).**
294
+
295
+ ### 5. Current State
296
+
297
+ #### Task Board
298
+ 📊 Progress: 29% (5/17) | Session: 3/6 | Blockers: 0
299
+
300
+ | # | ID | Gate | Session | Camp | Status | Deliverable |
301
+ |---|-----|------|:-------:|:----:|:------:|-------------|
302
+ | 1 | COND-01 | Conductor | 1 | — | [✓] | Mode /ship-right-thing |
303
+ | 2 | DISC-01 | Discovery | 1 | — | [✓] | Discovery Brief |
304
+ | 3 | COND-02 | Conductor (s.2) | 2 | | [✓] | Camp Alpha assigned |
305
+ | 4 | STRAT-01α | Customer-Champion | 2 | α | [✓] | Strategy Brief Alpha (EXCLUDED) |
306
+ | 5 | COND-03 | Conductor (s.3) | 3 | — | [→] | — |
307
+ | 6 | STRAT-02β | Business-Champion | 3 | β | [ ] | — |
308
+ | 7-17 | ... | ... | 4-6 | ... | [ ] | — |
309
+
310
+ #### Open Questions
311
+ - Pricing model (buyer interview gave no clear signal)
312
+ - LLM build vs buy
313
+
314
+ ### 6. Session 3 Task (Beta Camp)
315
+
316
+ **Gates:** COND-03 → STRAT-02β
317
+
318
+ **What to do (Business-Champion lens):**
319
+ 1. **COND-03 (Conductor):** Load Discovery Brief, assign Camp Beta role explicitly. Verify Camp Alpha artifacts EXCLUDED (independence check).
320
+ 2. **STRAT-02β (Product Strategist):** Form Business-Champion Strategy Brief:
321
+ - **Vision** business outcome frame («help companies measurably improve manager effectiveness and retain talent»)
322
+ - **NSM** — business-value metric (example: «ARR from accounts with AI summarization enabled on >60% teams»)
323
+ - **OKR** quarterly goals with revenue / NRR / competitive moat emphasis
324
+ - **Roadmap** themes with business ROI rationale
325
+ - **Pricing hypothesis** specific model (per-seat premium? usage-based?)
326
+
327
+ **Expected outcome:**
328
+ `strategy-brief-beta.md` (~800-1200 words) with explicit business-lens argument. Include:
329
+ - Why now (market timing)
330
+ - Revenue impact model (3-year forecast scenarios)
331
+ - Competitive moat angle
332
+ - NRR / expansion story
333
+
334
+ **Constraints:**
335
+ - **DO NOT** pretend to play Customer-Champion lens
336
+ - **DO NOT** request Camp Alpha artifacts (they're held by Conductor until MED-01)
337
+ - Mediator (MED-01, Session 4) synthesizes — your task is to present the sharpest business case
338
+
339
+ → Start as Conductor (COND-03). Verify camp isolation, activate Product Strategist (β). Pass Discovery Brief (ONLY) as input.
340
+ ---
341
+ ```
342
+
343
+ ## Validation (Quality Gate)
344
+
345
+ A prompt is considered correct if:
346
+
347
+ - [ ] Prompt is self-contained work can begin without external context
348
+ - [ ] Initiative name and mode stated
349
+ - [ ] Session number and session history stated
350
+ - [ ] Camp explicitly stated (Full A/B)
351
+ - [ ] Agents and skills for loading listed with file paths (from mapping)
352
+ - [ ] All 🔴 Critical data included in full text
353
+ - [ ] Task board (`$board`) included in current state with metrics
354
+ - [ ] Next gate and task formulated specifically (gate, action, deliverable)
355
+ - [ ] Camp filter applied: opposing camp artifacts explicitly excluded (Full A/B, before Mediator)
356
+ - [ ] Open questions and blockers recorded
357
+ - [ ] No prohibited elements (references without content, abbreviations, assumptions)
358
+ - [ ] Validation test (9 points, step 4) all «Yes»
359
+ - [ ] In emergency mode — prompt marked ⚠️, lost data indicated
360
+
361
+ ## Handoff
362
+ The result of `$session-prompt-generator` is input for:
363
+ - **Next session** — via user copying the prompt.
364
+ - **`$handoff`** prompt included in `docs/product/session-N-handoff.md` file.
365
+ - **`$board`** — board state saved in the prompt.
366
+
367
+ Transfer format: prompt in markdown, ready to paste at the start of a new session.
368
+
369
+ ## Anti-patterns
370
+
371
+ | Error | Why it's bad | How to do it right |
372
+ |-------|-------------|-------------------|
373
+ | Prompt without Discovery data | Next session loses customer-centric foundation | Include FULL text of Discovery Brief |
374
+ | «Continue work» | No context, nothing to continue from | Specific task: gate, action, deliverable |
375
+ | File references without content | Files may be unavailable | Include content directly in the prompt |
376
+ | Prompt without task board | Unclear where we are in the pipeline | Always include `$board` with metrics |
377
+ | Abbreviated artifacts | Loss of critical details | Full text of each 🔴 Critical artifact |
378
+ | Skipping open questions | Problems will resurface | Record all blockers and questions |
379
+ | No loading instructions | Session won't load needed agents | Mapping → specific file paths |
380
+ | Prompt > 50% «filler» | Dilutes critical data | Structure: blocks, tables, specifics |
381
+ | Emergency termination without prompt | Total context loss | Emergency mode: minimal prompt + ⚠️ mark |
382
+ | Camp contamination in prompt | Opposing camp artifacts enter prompt → independence violated | Explicit filter + note «EXCLUDED» for missing artifacts |
383
+
384
+ ## Output Template
385
+
386
+ ```
387
+ ---
388
+ ## Prompt for Session [N+1] — [Initiative Name]
389
+
390
+ ### 1. Initiative
391
+ - **Name:** [Name]
392
+ - **Mode:** [/ship-right-thing | /shape-prioritize]
393
+ - **Session:** [N+1] of 6
394
+ - **Camp:** [Alpha (Customer/Build) | Beta (Business/Cut) | Mediator-neutral | —]
395
+ - **Previous sessions:** 1-[N] complete
396
+
397
+ ### 2. Loading
398
+ Read:
399
+ - `domains/product/AGENTS.md`
400
+ - `domains/product/.agents/skills/board/SKILL.md`
401
+ - `domains/product/.agents/skills/handoff/SKILL.md`
402
+ - `domains/product/.agents/skills/gates/SKILL.md`
403
+ - [Specific skills: file paths]
404
+
405
+ Activate agents: [List of agents with gate IDs]
406
+
407
+ Role: **[Camp]** [description of lens: focus on X, do not do Y]
408
+
409
+ ### 3. What Was Done
410
+ **Session 1:** [Summary 2-3 sentences]
411
+ **Session [N]:** [Summary 2-3 sentences]
412
+
413
+ **Key decisions:**
414
+ | # | Decision | Rationale | Who decided |
415
+ |---|---------|-----------|-------------|
416
+ | 1 | [Decision] | [Why] | [User / Conductor] |
417
+
418
+ ### 4. Data (full text, with camp filtering)
419
+
420
+ #### Discovery Brief (from DISC-01)
421
+ [FULL TEXT]
422
+
423
+ #### Strategy Briefs (if Mediator Session)
424
+ #### Alpha: [FULL TEXT]
425
+ #### Beta: [FULL TEXT]
426
+
427
+ #### [Other artifacts as needed]
428
+ [FULL TEXT]
429
+
430
+ **🚫 Excluded (camp filter):**
431
+ - [Opposing camp artifacts, if applicable]
432
+
433
+ ### 5. Current State
434
+
435
+ #### Task Board
436
+ [Full board from $board with progress metrics]
437
+
438
+ #### Open Questions
439
+ | # | Question / Blocker | Severity | For which gate |
440
+ |---|-------------------|:--------:|:--------------:|
441
+ | 1 | [Description] | 🔴/🟡/🟢 | [ID] |
442
+
443
+ ### 6. Session [N+1] Task
444
+ **Gates:** [ID list]
445
+ **What to do:** [Specific description per gate + camp lens]
446
+ **Expected outcome:** [Deliverables]
447
+ **Constraints:** [Camp independence rules, DO NOT do, DO NOT request]
448
+
449
+ → Start as Conductor (COND-xx). Load board, verify camp isolation, pass control to [next agent].
450
+ ---
451
+ ```
452
+
453
+ ### Emergency Prompt (minimum version)
454
+
455
+ ```
456
+ ---
457
+ ## ⚠️ EMERGENCY PROMPT — Session [N+1] — [Initiative Name]
458
+
459
+ **Status:** Session [N] terminated abnormally. Data loss possible.
460
+
461
+ ### What Was Saved
462
+ [Everything that could be collected: board, last deliverable, questions]
463
+
464
+ ### What May Have Been Lost
465
+ | # | Data | Recovery Method |
466
+ |---|------|-----------------|
467
+ | 1 | [What was lost] | [Repeat interview / request from user / restore from handoff] |
468
+
469
+ ### Task
470
+ Restore context from `docs/product/session-[N]-handoff.md`. Verify data integrity. For Full A/B — verify camp isolation. Continue from gate [ID].
471
+
472
+ → Start as Conductor (COND-xx). Priority: data integrity verification before continuing.
473
+ ---
474
+ ```