code-ai-installer 4.0.0 → 4.0.1-b

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 +44 -6
  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 +14 -3
  65. package/dist/mcp_setup.js +15 -6
  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,378 +1,400 @@
1
- ---
2
- name: session-prompt-generator
3
- description: Generation of the prompt for the next session — context gathering, prompt formulation, progress saving
4
- ---
5
- # Session Prompt Generator — Generating a Prompt for the Next Session
6
-
7
- ## When to Use
8
- - When **completing a session** in the Full Pipeline (`/analyze`) — before the inter-session `$handoff`.
9
- - When **needing to hand off the project** to another operator — forming a self-sufficient prompt.
10
- - Upon **user request** "generate a prompt to continue" — at any point.
11
- - During an **abnormal termination** of a session — saving maximum context for recovery.
12
-
13
- > **Key Principle:** The next session starts with **ZERO** context. The prompt must contain everything necessary for the new session to continue work without losses.
14
-
15
- ## Input
16
-
17
- | Field | Required | Description |
18
- |------|:-----------:|----------|
19
- | `$board` state | ✅ | Current task board with all statuses |
20
- | Completed deliverables | ✅ | Full artifacts of the current and previous sessions |
21
- | Current gate | | Where we stopped (gate ID from `$board`) |
22
- | Next gate | | Where we are moving (next gate ID) |
23
- | Open questions | ⬚ | Blockers, unresolved conflicts, questions for the user |
24
- | Current session number | ✅ | Which session is ending (1-5) |
25
- | Project name | ✅ | Name of the analytical project |
26
-
27
- ### Relationship with Other Skills
28
- | Skill | Interaction | When |
29
- |------|----------------|-------|
30
- | `$board` | Source: the current board state is included in the prompt (block 5) | Step 0 |
31
- | `$handoff` | The prompt is included in the inter-session handoff file | Step 5 |
32
- | `$gates` | Source: requirements for the next gate define the task (block 6) | Step 0 |
33
- | Framework skills | Completed frameworks are included as full text in block 4 | Step 1 |
34
-
35
- ## Mapping "Session Gates Agents Skills"
36
-
37
- ### Full Pipeline (`/analyze`)
38
-
39
- | Session | Gates | Agents | Required Skills | Framework Skills |
40
- |:------:|-------|--------|-------------------|-----------------|
41
- | **1** | COND-01, INT-01 | Conductor, Interviewer | `$board`, `$gates`, `$handoff` | |
42
- | **2** | COND-02, RES-01, AN-01, ST-01 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | By AN-01 choice (min 2) |
43
- | **3** | COND-03, RES-02, AN-02, ST-02 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | By AN-02 choice (counter-frameworks) |
44
- | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | |
45
- | **5** | COND-05, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter, Conductor (RG) | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | — |
46
-
47
- ### Quick Pipeline (`/quick-insight`)
48
- One session — no prompt needed (all gates are within a single session).
49
-
50
- ## Protocol
51
-
52
- ### Step 0 — Gathering State
53
- 1. Read the current `$board` state all gates, statuses, deliverables.
54
- 2. Collect all completed artifacts of the current session.
55
- 3. Load the cumulative index from previous sessions (if any).
56
- 4. Determine the next gate and its requirements from `$gates`.
57
- 5. Use the "Session → Gates → Agents → Skills" mapping to determine what to output.
58
-
59
- ### Step 1 — Identifying Critical Data
60
- 1. Highlight data that is **irrecoverable** without previous context:
61
-
62
- | Category | Examples | Priority |
63
- |-----------|---------|:---------:|
64
- | User responses | Interview (INT-01), clarifications, decisions | 🔴 Critical |
65
- | Collected data | RES-xx data with URLs and sources | 🔴 Critical |
66
- | Analysis results | AN-xx frameworks, scoring, findings | 🔴 Critical |
67
- | Strategic recommendations | ST-xx strategy, action plan | 🔴 Critical |
68
- | Mediator's verdict | MED-01 conclusion, reasoning | 🔴 Critical |
69
- | User decisions | Approved, rejections, scope changes | 🟡 Important |
70
- | Progress metrics | Time per gate, blockers | 🟢 Nice-to-have |
71
-
72
- 2. **Rule:** All 🔴 Critical data is included **as full text**. No exceptions.
73
-
74
- ### Step 2Determining Agents and Skills
75
- 1. Use the mapping to determine: which agents and skills are needed in the next session.
76
- 2. Form a list of files to load (specific paths).
77
- 3. For framework skills: specify concrete skills if already known (from AN-01 or research brief).
78
-
79
- ### Step 3 Forming the Prompt
80
- 1. Fill out the prompt template (6 blocks — see below).
81
- 2. Include the FULL text of critical data (no links, no summaries).
82
- 3. Formulate a specific task for the next session.
83
- 4. Specify which agents and skills to activate (specific file paths).
84
-
85
- ### Step 4 — Prompt Validation
86
- Self-sufficiency test for each point, answer "is it possible without external context?":
87
-
88
- | # | Check | Result |
89
- |---|----------|:---------:|
90
- | 1 | Can work start with ONLY this prompt? | Yes / No |
91
- | 2 | Are there no references to "previous context" / "as discussed"? | Yes / No |
92
- | 3 | Is all 🔴 Critical data included as full text? | Yes / No |
93
- | 4 | Is the task for the session specific (gate, action, deliverable)? | Yes / No |
94
- | 5 | Are agents and skills listed with file paths? | Yes / No |
95
- | 6 | Is the task board included? | Yes / No |
96
- | 7 | Are open questions noted? | Yes / No |
97
-
98
- **If at least one = No refine the prompt.**
99
-
100
- ### Step 5 — Saving
101
- 1. Include the prompt in the `$handoff` file: `docs/analytics/session-N-handoff.md`.
102
- 2. Present the prompt to the user to save / copy.
103
- 3. Warn: "This is the prompt insert it at the beginning of the next session."
104
-
105
- ### Step 6 Emergency Mode
106
- If the session ends abruptly (timeout, error, context loss):
107
-
108
- 1. **Immediately** save everything available: the board, the latest deliverable, open questions.
109
- 2. Form an **emergency prompt** (minimal version):
110
- - Block 1 (identification) mandatory.
111
- - Block 5 (board state) — mandatory.
112
- - Block 4 (data) everything that could be collected.
113
- - Block 6 (task) "Restore context from session-N-handoff.md, check data integrity, continue from gate [ID]."
114
- 3. Mark the prompt as **⚠️ EMERGENCY possible data loss**.
115
- 4. Indicate what data might have been lost and how to recover it (repeated `$web-research`, asking the user).
116
-
117
- ## Generated Prompt Structure
118
-
119
- ### Block 1 — Project Identification
120
- - Project name.
121
- - Pipeline mode (Full / Quick).
122
- - Next session number.
123
- - Which sessions are completed.
124
-
125
- ### Block 2Loading Instruction
126
- - Read AGENTS.md of the analytics domain.
127
- - Load agents needed in this session (from mapping).
128
- - Load skills: `$board`, `$handoff`, `$gates` + gate-specific.
129
- - Specific file paths.
130
-
131
- ### Block 3 Completed Work (Summary)
132
- - What was done in previous sessions (2-3 sentences per session).
133
- - Key decisions and their reasoning.
134
-
135
- ### Block 4Critical Data
136
- - FULL TEXT of key artifacts needed to continue.
137
- - Research data, analysis findings, recommendations.
138
- - User responses to the interview (if any).
139
-
140
- ### Block 5 — Current State
141
- - Task board (`$board`) in its current state.
142
- - What the next gate is.
143
- - Open questions and blockers.
144
-
145
- ### Block 6 Task for the Session
146
- - Specific formulation: what needs to be done in this session.
147
- - Expected result (deliverables).
148
- - Constraints and specifics.
149
-
150
- ## Prompt Generation Rules
151
-
152
- ### Mandatory Rules
153
- 1. **Self-sufficiency**the prompt must work without ANY previous context.
154
- 2. **Data completeness** include FULL text, not links and not summaries.
155
- 3. **Task specificity** — not "continue analysis", but "execute RES-02: research [topic] from the Critics' perspective, Analysts' data: [data]".
156
- 4. **Structure** — clear blocks, marked with headings.
157
- 5. **Skill loading**explicitly state which agents and skills to load with file paths.
158
-
159
- ### Forbidden Elements
160
- 1. Links to "previous session" without full content.
161
- 2. "As we discussed" — there is no context, nothing to discuss.
162
- 3. "See results above" there is no "above", everything must be in the prompt.
163
- 4. Abbreviated data "main findings: ...". ALL findings are needed.
164
- 5. Assumptions about context "you already know that...".
165
-
166
- ## Example — Prompt for Session 3 (Team Beta: Critics)
167
-
168
- ```markdown
169
- ---
170
- ## Prompt for Session 3 — Analysis of EdTech Market RU
171
-
172
- ### 1. Project
173
- - **Name:** Analysis of EdTech Market RU for corporate training
174
- - **Mode:** Full Pipeline (/analyze)
175
- - **Session:** 3 of 5
176
- - **Previous Sessions:** 1 (Interview + Brief), 2 (Team Alpha: Research + Analysis + Strategy)
177
-
178
- ### 2. Loading
179
- Read:
180
- - `domains/analytics/AGENTS.md`
181
- - `domains/analytics/.agents/skills/board/SKILL.md`
182
- - `domains/analytics/.agents/skills/handoff/SKILL.md`
183
- - `domains/analytics/.agents/skills/gates/SKILL.md`
184
- - `domains/analytics/.agents/skills/web-research/SKILL.md`
185
- - `domains/analytics/.agents/skills/competitive-analysis/SKILL.md`
186
- - `domains/analytics/.agents/skills/porters-five-forces/SKILL.md`
187
-
188
- Activate agents: Conductor (COND-03), Researcher (RES-02), Data Analyst (AN-02), Strategist (ST-02).
189
- Role: **Team Beta (Critics)** — task: critique and alternative analysis of Team Alpha's results.
190
-
191
- ### 3. What is Completed
192
- **Session 1:** Conducted interview, formed research brief (12 questions), defined scope: corporate training, B2B SaaS, RU, 3-year horizon. Evaluation mode: scoring.
193
- **Session 2:** Team Alpha (Analysts) conducted research (28 sources), applied TAM/SAM/SOM + Competitive Analysis + PEST. Strategic recommendation: "AI-first corporate training platform, focus on 50-500 headcount companies."
194
-
195
- ### 4. Data (full text)
196
-
197
- #### Research Brief (from INT-01)
198
- 1. What is the size of EdTech Market RU (TAM/SAM/SOM) for corporate training?
199
- 2. Who are the key competitors and what are their shares?
200
- 3. What technological trends are changing the market?
201
- 4. What regulatory factors affect EdTech?
202
- [... all 12 questions ...]
203
-
204
- #### Team Alpha Research Data (from RES-01)
205
- **TAM:** $4.2B (EdTech RU, 2026). Source: Smart Ranking, Jan 2026 ✅
206
- **SAM:** $1.8B (corporate training). Source: HSE, Mar 2026 ✅
207
- **SOM:** $180M (B2B SaaS platforms). Source: calculation ⚠️ (2 sources instead of 3)
208
-
209
- **Competitors:**
210
- | Competitor | Share | Threat Score | Key Strength |
211
- |-----------|------|-------------|---------------|
212
- | Skillbox (B2B) | 15% | 7.2 | Brand, content |
213
- | Netology | 12% | 6.8 | Corp. programs |
214
- | Yandex Praktikum | 18% | 7.6 | Yandex Ecosystem |
215
- [... full data ...]
216
-
217
- #### Team Alpha Analysis Results (from AN-01, ST-01)
218
- [FULL TEXT: TAM/SAM/SOM framework, Competitive Analysis, PEST, strategic recommendations]
219
-
220
- ### 5. Current State
221
-
222
- #### Task Board
223
- 📊 Progress: 40% (6/15) | Session: 3/5 | Blockers: 0
224
-
225
- | # | ID | Gate | Session | Status | Deliverable |
226
- |---|----|------|:------:|:------:|-------------|
227
- | 1 | COND-01 | Conductor | 1 | [✓] | Full Pipeline |
228
- | 2 | INT-01 | Interviewer | 1 | [✓] | Brief: 12 questions |
229
- | 3 | COND-02 | Conductor (s.2) | 2 | [✓] | Context loaded |
230
- | 4 | RES-01 | Researcher (Alpha) | 2 | [✓] | 28 sources |
231
- | 5 | AN-01 | Data Analyst (Alpha) | 2 | [✓] | 3 frameworks |
232
- | 6 | ST-01 | Strategist (Alpha) | 2 | [✓] | AI-first strategy |
233
- | 7 | COND-03 | Conductor (s.3) | 3 | [→] | — |
234
- | 8 | RES-02 | Researcher (Beta) | 3 | [ ] | |
235
- | 9 | AN-02 | Data Analyst (Beta) | 3 | [ ] | — |
236
- | 10 | ST-02 | Strategist (Beta) | 3 | [ ] | — |
237
- [... remaining gates ...]
238
-
239
- #### Open Questions
240
- - ⚠️ SOM is calculated based on 2 sources (Alpha recommended verifying)
241
-
242
- ### 6. Task for Session 3
243
- **Gates:** COND-03 → RES-02 → AN-02 → ST-02
244
- **What to do:** Team Beta (Critics) must:
245
- 1. **RES-02:** Investigate the EdTech market from alternative perspectives. Check Alpha's data. Find counter-arguments. Verify SOM (find 3rd source).
246
- 2. **AN-02:** Apply alternative frameworks (Porter's 5 Forces, Blue Ocean). Find weaknesses in Alpha's analysis.
247
- 3. **ST-02:** Formulate an alternative strategy. Critique Alpha's strategy with reasoning.
248
- **Expected Result:** Alternative package (data + analysis + strategy) for handoff to Mediator in session 4.
249
-
250
- Start as Conductor (COND-03). Load the board, check Alpha's data, pass control to Researcher (RES-02).
251
- ---
252
- ```
253
-
254
- ## Validation (Quality Gate)
255
-
256
- A prompt is considered correct if:
257
-
258
- - [ ] The prompt is self-sufficient work can start without external context
259
- - [ ] Project name and mode are specified
260
- - [ ] Session number and session history are specified
261
- - [ ] Agents and skills to load are listed with file paths (from mapping)
262
- - [ ] All 🔴 Critical data is included as full text
263
- - [ ] Task board (`$board`) is included in its current state with metrics
264
- - [ ] The next gate and task are formulated specifically (gate, action, deliverable)
265
- - [ ] Open questions and blockers are noted
266
- - [ ] No forbidden elements (links without content, abbreviations, assumptions)
267
- - [ ] Validation test (7 points, step 4) all "Yes"
268
- - [ ] In emergency mode prompt is marked ⚠️, lost data is indicated
269
-
270
- ## Handoff
271
- The output of `$session-prompt-generator` is an input for:
272
- - **Next session** via user copying the prompt.
273
- - **`$handoff`** — the prompt is included in the `docs/analytics/session-N-handoff.md` file.
274
- - **`$board`** — the board state is saved in the prompt.
275
-
276
- Handoff format: prompt in markdown, ready to be pasted at the beginning of the new session.
277
-
278
- ## Anti-patterns
279
-
280
- | Error | Why it's bad | How to do it right |
281
- |--------|-------------|---------------|
282
- | Prompt without research data | The next session will lose all collected facts | Include FULL text of data (🔴 Critical) |
283
- | "Continue work" | No context on what to continue | Specific task: gate, action, deliverable |
284
- | File links without content | Files might be inaccessible | Include content directly in the prompt |
285
- | Prompt without task board | Unclear where we are in the pipeline | Always include `$board` with metrics |
286
- | Abbreviated artifacts | Critical details are lost | Full text of every 🔴 Critical artifact |
287
- | Skipping open questions | Problems will resurface | Note all blockers and questions |
288
- | No loading instructions | The session will not load the needed agents | Mapping → specific file paths |
289
- | Prompt > 50% "fluff" | Dilution of critical data | Structure: blocks, tables, specifics |
290
- | Abnormal termination without prompt | Total loss of context | Emergency mode: minimal prompt + ⚠️ mark |
291
-
292
- ## Output Template
293
-
294
- ```markdown
295
- ---
296
- ## Prompt for Session [N+1] [Project Name]
297
-
298
- ### 1. Project
299
- - **Name:** [Name]
300
- - **Mode:** Full Pipeline (/analyze)
301
- - **Session:** [N+1] of 5
302
- - **Previous Sessions:** 1-[N] completed
303
-
304
- ### 2. Loading
305
- Read:
306
- - `domains/analytics/AGENTS.md`
307
- - `domains/analytics/.agents/skills/board/SKILL.md`
308
- - `domains/analytics/.agents/skills/handoff/SKILL.md`
309
- - `domains/analytics/.agents/skills/gates/SKILL.md`
310
- - [Specific skills: file paths]
311
-
312
- Activate agents: [List of agents with Gate IDs]
313
-
314
- ### 3. What is Completed
315
- **Session 1:** [Summary 2-3 sentences]
316
- **Session [N]:** [Summary 2-3 sentences]
317
-
318
- **Key decisions:**
319
- | # | Decision | Reasoning | Adopted by |
320
- |---|---------|-------------|------------|
321
- | 1 | [Decision] | [Why] | [User / Conductor] |
322
-
323
- ### 4. Data (full text)
324
-
325
- #### Research Brief (from INT-01)
326
- [FULL TEXT research brief]
327
-
328
- #### Research Data (from RES-xx)
329
- [FULL TEXT data with sources and URLs]
330
-
331
- #### Analysis Results (from AN-xx)
332
- [FULL TEXT frameworks and findings]
333
-
334
- #### [Other artifacts as needed]
335
- [FULL TEXT]
336
-
337
- ### 5. Current State
338
-
339
- #### Task Board
340
- [Full board from $board with progress metrics]
341
-
342
- #### Open Questions
343
- | # | Question / Blocker | Severity | For which gate |
344
- |---|-----------------|:--------:|:----------------:|
345
- | 1 | [Description] | 🔴/🟡/🟢 | [ID] |
346
-
347
- ### 6. Task for Session [N+1]
348
- **Gates:** [ID list]
349
- **What to do:** [Specific description per gate]
350
- **Expected Result:** [Deliverables]
351
- **Constraints:** [If any]
352
-
353
- Start as Conductor (COND-xx). Load the board, check the data, pass control to [next agent].
354
- ---
355
- ```
356
-
357
- ### Emergency Prompt (minimal version)
358
-
359
- ```markdown
360
- ---
361
- ## ⚠️ EMERGENCY PROMPT — Session [N+1] — [Project Name]
362
-
363
- **Status:** Session [N] terminated abnormally. Possible data loss.
364
-
365
- ### What is Saved
366
- [Everything collected: board, latest deliverable, questions]
367
-
368
- ### What might be lost
369
- | # | Data | Recovery Method |
370
- |---|--------|-----------------------|
371
- | 1 | [Lost data] | [Repeated web-research / ask user / recover from handoff] |
372
-
373
- ### Task
374
- Restore context from `docs/analytics/session-[N]-handoff.md`. Check data integrity. Continue from gate [ID].
375
-
376
- → Start as Conductor (COND-xx). Priority: verify data integrity before continuing.
377
- ---
378
- ```
1
+ ---
2
+ name: session-prompt-generator
3
+ description: Generation of the prompt for the next session — context gathering, prompt formulation, progress saving
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - conductor
8
+ gates:
9
+ - INTERVIEWER
10
+ - RESEARCHER
11
+ - DATA_ANALYST
12
+ - STRATEGIST
13
+ - MEDIATOR
14
+ - DESIGNER
15
+ - LAYOUTER
16
+ - RELEASE_GATE
17
+ tech: []
18
+ topic: []
19
+ triggers:
20
+ - "session-prompt-generator"
21
+ - "Генерация промпта для следующей сессии"
22
+ - "Генерация промпта для следующей сессии сбор контекста, формирование промпта, сохранение прогресса"
23
+ related: []
24
+ budget_lines: 400
25
+ schema_version: 1
26
+ ---
27
+ # Session Prompt Generator — Generating a Prompt for the Next Session
28
+
29
+ ## When to Use
30
+ - When **completing a session** in the Full Pipeline (`/analyze`) before the inter-session `$handoff`.
31
+ - When **needing to hand off the project** to another operator forming a self-sufficient prompt.
32
+ - Upon **user request** "generate a prompt to continue" at any point.
33
+ - During an **abnormal termination** of a session saving maximum context for recovery.
34
+
35
+ > **Key Principle:** The next session starts with **ZERO** context. The prompt must contain everything necessary for the new session to continue work without losses.
36
+
37
+ ## Input
38
+
39
+ | Field | Required | Description |
40
+ |------|:-----------:|----------|
41
+ | `$board` state | | Current task board with all statuses |
42
+ | Completed deliverables | | Full artifacts of the current and previous sessions |
43
+ | Current gate | | Where we stopped (gate ID from `$board`) |
44
+ | Next gate | | Where we are moving (next gate ID) |
45
+ | Open questions | | Blockers, unresolved conflicts, questions for the user |
46
+ | Current session number | ✅ | Which session is ending (1-5) |
47
+ | Project name | ✅ | Name of the analytical project |
48
+
49
+ ### Relationship with Other Skills
50
+ | Skill | Interaction | When |
51
+ |------|----------------|-------|
52
+ | `$board` | Source: the current board state is included in the prompt (block 5) | Step 0 |
53
+ | `$handoff` | The prompt is included in the inter-session handoff file | Step 5 |
54
+ | `$gates` | Source: requirements for the next gate define the task (block 6) | Step 0 |
55
+ | Framework skills | Completed frameworks are included as full text in block 4 | Step 1 |
56
+
57
+ ## Mapping "Session → Gates → Agents → Skills"
58
+
59
+ ### Full Pipeline (`/analyze`)
60
+
61
+ | Session | Gates | Agents | Required Skills | Framework Skills |
62
+ |:------:|-------|--------|-------------------|-----------------|
63
+ | **1** | COND-01, INT-01 | Conductor, Interviewer | `$board`, `$gates`, `$handoff` | — |
64
+ | **2** | COND-02, RES-01, AN-01, ST-01 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | By AN-01 choice (min 2) |
65
+ | **3** | COND-03, RES-02, AN-02, ST-02 | Conductor, Researcher, Data Analyst, Strategist | `$board`, `$gates`, `$handoff`, `$web-research` | By AN-02 choice (counter-frameworks) |
66
+ | **4** | COND-04, MED-01 | Conductor, Mediator | `$board`, `$gates`, `$handoff` | — |
67
+ | **5** | COND-05, DS-01, LY-01, RG-01 | Conductor, Designer, Layouter, Conductor (RG) | `$board`, `$gates`, `$handoff`, `$report-design`, `$html-pdf-report` | — |
68
+
69
+ ### Quick Pipeline (`/quick-insight`)
70
+ One session no prompt needed (all gates are within a single session).
71
+
72
+ ## Protocol
73
+
74
+ ### Step 0Gathering State
75
+ 1. Read the current `$board` state all gates, statuses, deliverables.
76
+ 2. Collect all completed artifacts of the current session.
77
+ 3. Load the cumulative index from previous sessions (if any).
78
+ 4. Determine the next gate and its requirements from `$gates`.
79
+ 5. Use the "Session Gates → Agents → Skills" mapping to determine what to output.
80
+
81
+ ### Step 1 Identifying Critical Data
82
+ 1. Highlight data that is **irrecoverable** without previous context:
83
+
84
+ | Category | Examples | Priority |
85
+ |-----------|---------|:---------:|
86
+ | User responses | Interview (INT-01), clarifications, decisions | 🔴 Critical |
87
+ | Collected data | RES-xx data with URLs and sources | 🔴 Critical |
88
+ | Analysis results | AN-xx frameworks, scoring, findings | 🔴 Critical |
89
+ | Strategic recommendations | ST-xx strategy, action plan | 🔴 Critical |
90
+ | Mediator's verdict | MED-01 conclusion, reasoning | 🔴 Critical |
91
+ | User decisions | Approved, rejections, scope changes | 🟡 Important |
92
+ | Progress metrics | Time per gate, blockers | 🟢 Nice-to-have |
93
+
94
+ 2. **Rule:** All 🔴 Critical data is included **as full text**. No exceptions.
95
+
96
+ ### Step 2 Determining Agents and Skills
97
+ 1. Use the mapping to determine: which agents and skills are needed in the next session.
98
+ 2. Form a list of files to load (specific paths).
99
+ 3. For framework skills: specify concrete skills if already known (from AN-01 or research brief).
100
+
101
+ ### Step 3 Forming the Prompt
102
+ 1. Fill out the prompt template (6 blocks see below).
103
+ 2. Include the FULL text of critical data (no links, no summaries).
104
+ 3. Formulate a specific task for the next session.
105
+ 4. Specify which agents and skills to activate (specific file paths).
106
+
107
+ ### Step 4 — Prompt Validation
108
+ Self-sufficiency test for each point, answer "is it possible without external context?":
109
+
110
+ | # | Check | Result |
111
+ |---|----------|:---------:|
112
+ | 1 | Can work start with ONLY this prompt? | Yes / No |
113
+ | 2 | Are there no references to "previous context" / "as discussed"? | Yes / No |
114
+ | 3 | Is all 🔴 Critical data included as full text? | Yes / No |
115
+ | 4 | Is the task for the session specific (gate, action, deliverable)? | Yes / No |
116
+ | 5 | Are agents and skills listed with file paths? | Yes / No |
117
+ | 6 | Is the task board included? | Yes / No |
118
+ | 7 | Are open questions noted? | Yes / No |
119
+
120
+ **If at least one = No — refine the prompt.**
121
+
122
+ ### Step 5 — Saving
123
+ 1. Include the prompt in the `$handoff` file: `docs/analytics/session-N-handoff.md`.
124
+ 2. Present the prompt to the user to save / copy.
125
+ 3. Warn: "This is the prompt insert it at the beginning of the next session."
126
+
127
+ ### Step 6 Emergency Mode
128
+ If the session ends abruptly (timeout, error, context loss):
129
+
130
+ 1. **Immediately** save everything available: the board, the latest deliverable, open questions.
131
+ 2. Form an **emergency prompt** (minimal version):
132
+ - Block 1 (identification) mandatory.
133
+ - Block 5 (board state) — mandatory.
134
+ - Block 4 (data) — everything that could be collected.
135
+ - Block 6 (task) "Restore context from session-N-handoff.md, check data integrity, continue from gate [ID]."
136
+ 3. Mark the prompt as **⚠️ EMERGENCY possible data loss**.
137
+ 4. Indicate what data might have been lost and how to recover it (repeated `$web-research`, asking the user).
138
+
139
+ ## Generated Prompt Structure
140
+
141
+ ### Block 1 Project Identification
142
+ - Project name.
143
+ - Pipeline mode (Full / Quick).
144
+ - Next session number.
145
+ - Which sessions are completed.
146
+
147
+ ### Block 2 — Loading Instruction
148
+ - Read AGENTS.md of the analytics domain.
149
+ - Load agents needed in this session (from mapping).
150
+ - Load skills: `$board`, `$handoff`, `$gates` + gate-specific.
151
+ - Specific file paths.
152
+
153
+ ### Block 3 Completed Work (Summary)
154
+ - What was done in previous sessions (2-3 sentences per session).
155
+ - Key decisions and their reasoning.
156
+
157
+ ### Block 4Critical Data
158
+ - FULL TEXT of key artifacts needed to continue.
159
+ - Research data, analysis findings, recommendations.
160
+ - User responses to the interview (if any).
161
+
162
+ ### Block 5Current State
163
+ - Task board (`$board`) in its current state.
164
+ - What the next gate is.
165
+ - Open questions and blockers.
166
+
167
+ ### Block 6 — Task for the Session
168
+ - Specific formulation: what needs to be done in this session.
169
+ - Expected result (deliverables).
170
+ - Constraints and specifics.
171
+
172
+ ## Prompt Generation Rules
173
+
174
+ ### Mandatory 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 analysis", but "execute RES-02: research [topic] from the Critics' perspective, Analysts' data: [data]".
178
+ 4. **Structure** — clear blocks, marked with headings.
179
+ 5. **Skill loading** — explicitly state which agents and skills to load with file paths.
180
+
181
+ ### Forbidden Elements
182
+ 1. Links to "previous session" without full content.
183
+ 2. "As we discussed" — there is no context, nothing to discuss.
184
+ 3. "See results above" — there is no "above", everything must be in the prompt.
185
+ 4. Abbreviated data — "main findings: ...". ALL findings are needed.
186
+ 5. Assumptions about context — "you already know that...".
187
+
188
+ ## Example Prompt for Session 3 (Team Beta: Critics)
189
+
190
+ ```markdown
191
+ ---
192
+ ## Prompt for Session 3 Analysis of EdTech Market RU
193
+
194
+ ### 1. Project
195
+ - **Name:** Analysis of EdTech Market RU for corporate training
196
+ - **Mode:** Full Pipeline (/analyze)
197
+ - **Session:** 3 of 5
198
+ - **Previous Sessions:** 1 (Interview + Brief), 2 (Team Alpha: Research + Analysis + Strategy)
199
+
200
+ ### 2. Loading
201
+ Read:
202
+ - `domains/analytics/AGENTS.md`
203
+ - `domains/analytics/.agents/skills/board/SKILL.md`
204
+ - `domains/analytics/.agents/skills/handoff/SKILL.md`
205
+ - `domains/analytics/.agents/skills/gates/SKILL.md`
206
+ - `domains/analytics/.agents/skills/web-research/SKILL.md`
207
+ - `domains/analytics/.agents/skills/competitive-analysis/SKILL.md`
208
+ - `domains/analytics/.agents/skills/porters-five-forces/SKILL.md`
209
+
210
+ Activate agents: Conductor (COND-03), Researcher (RES-02), Data Analyst (AN-02), Strategist (ST-02).
211
+ Role: **Team Beta (Critics)** — task: critique and alternative analysis of Team Alpha's results.
212
+
213
+ ### 3. What is Completed
214
+ **Session 1:** Conducted interview, formed research brief (12 questions), defined scope: corporate training, B2B SaaS, RU, 3-year horizon. Evaluation mode: scoring.
215
+ **Session 2:** Team Alpha (Analysts) conducted research (28 sources), applied TAM/SAM/SOM + Competitive Analysis + PEST. Strategic recommendation: "AI-first corporate training platform, focus on 50-500 headcount companies."
216
+
217
+ ### 4. Data (full text)
218
+
219
+ #### Research Brief (from INT-01)
220
+ 1. What is the size of EdTech Market RU (TAM/SAM/SOM) for corporate training?
221
+ 2. Who are the key competitors and what are their shares?
222
+ 3. What technological trends are changing the market?
223
+ 4. What regulatory factors affect EdTech?
224
+ [... all 12 questions ...]
225
+
226
+ #### Team Alpha Research Data (from RES-01)
227
+ **TAM:** $4.2B (EdTech RU, 2026). Source: Smart Ranking, Jan 2026
228
+ **SAM:** $1.8B (corporate training). Source: HSE, Mar 2026 ✅
229
+ **SOM:** $180M (B2B SaaS platforms). Source: calculation ⚠️ (2 sources instead of 3)
230
+
231
+ **Competitors:**
232
+ | Competitor | Share | Threat Score | Key Strength |
233
+ |-----------|------|-------------|---------------|
234
+ | Skillbox (B2B) | 15% | 7.2 | Brand, content |
235
+ | Netology | 12% | 6.8 | Corp. programs |
236
+ | Yandex Praktikum | 18% | 7.6 | Yandex Ecosystem |
237
+ [... full data ...]
238
+
239
+ #### Team Alpha Analysis Results (from AN-01, ST-01)
240
+ [FULL TEXT: TAM/SAM/SOM framework, Competitive Analysis, PEST, strategic recommendations]
241
+
242
+ ### 5. Current State
243
+
244
+ #### Task Board
245
+ 📊 Progress: 40% (6/15) | Session: 3/5 | Blockers: 0
246
+
247
+ | # | ID | Gate | Session | Status | Deliverable |
248
+ |---|----|------|:------:|:------:|-------------|
249
+ | 1 | COND-01 | Conductor | 1 | [✓] | Full Pipeline |
250
+ | 2 | INT-01 | Interviewer | 1 | [✓] | Brief: 12 questions |
251
+ | 3 | COND-02 | Conductor (s.2) | 2 | [✓] | Context loaded |
252
+ | 4 | RES-01 | Researcher (Alpha) | 2 | [✓] | 28 sources |
253
+ | 5 | AN-01 | Data Analyst (Alpha) | 2 | [✓] | 3 frameworks |
254
+ | 6 | ST-01 | Strategist (Alpha) | 2 | [✓] | AI-first strategy |
255
+ | 7 | COND-03 | Conductor (s.3) | 3 | [→] | — |
256
+ | 8 | RES-02 | Researcher (Beta) | 3 | [ ] | — |
257
+ | 9 | AN-02 | Data Analyst (Beta) | 3 | [ ] | — |
258
+ | 10 | ST-02 | Strategist (Beta) | 3 | [ ] | — |
259
+ [... remaining gates ...]
260
+
261
+ #### Open Questions
262
+ - ⚠️ SOM is calculated based on 2 sources (Alpha recommended verifying)
263
+
264
+ ### 6. Task for Session 3
265
+ **Gates:** COND-03 RES-02 AN-02 ST-02
266
+ **What to do:** Team Beta (Critics) must:
267
+ 1. **RES-02:** Investigate the EdTech market from alternative perspectives. Check Alpha's data. Find counter-arguments. Verify SOM (find 3rd source).
268
+ 2. **AN-02:** Apply alternative frameworks (Porter's 5 Forces, Blue Ocean). Find weaknesses in Alpha's analysis.
269
+ 3. **ST-02:** Formulate an alternative strategy. Critique Alpha's strategy with reasoning.
270
+ **Expected Result:** Alternative package (data + analysis + strategy) for handoff to Mediator in session 4.
271
+
272
+ → Start as Conductor (COND-03). Load the board, check Alpha's data, pass control to Researcher (RES-02).
273
+ ---
274
+ ```
275
+
276
+ ## Validation (Quality Gate)
277
+
278
+ A prompt is considered correct if:
279
+
280
+ - [ ] The prompt is self-sufficient work can start without external context
281
+ - [ ] Project name and mode are specified
282
+ - [ ] Session number and session history are specified
283
+ - [ ] Agents and skills to load are listed with file paths (from mapping)
284
+ - [ ] All 🔴 Critical data is included as full text
285
+ - [ ] Task board (`$board`) is included in its current state with metrics
286
+ - [ ] The next gate and task are formulated specifically (gate, action, deliverable)
287
+ - [ ] Open questions and blockers are noted
288
+ - [ ] No forbidden elements (links without content, abbreviations, assumptions)
289
+ - [ ] Validation test (7 points, step 4) all "Yes"
290
+ - [ ] In emergency mode prompt is marked ⚠️, lost data is indicated
291
+
292
+ ## Handoff
293
+ The output of `$session-prompt-generator` is an input for:
294
+ - **Next session** — via user copying the prompt.
295
+ - **`$handoff`** — the prompt is included in the `docs/analytics/session-N-handoff.md` file.
296
+ - **`$board`** the board state is saved in the prompt.
297
+
298
+ Handoff format: prompt in markdown, ready to be pasted at the beginning of the new session.
299
+
300
+ ## Anti-patterns
301
+
302
+ | Error | Why it's bad | How to do it right |
303
+ |--------|-------------|---------------|
304
+ | Prompt without research data | The next session will lose all collected facts | Include FULL text of data (🔴 Critical) |
305
+ | "Continue work" | No context on what to continue | Specific task: gate, action, deliverable |
306
+ | File links without content | Files might be inaccessible | Include content directly in the prompt |
307
+ | Prompt without task board | Unclear where we are in the pipeline | Always include `$board` with metrics |
308
+ | Abbreviated artifacts | Critical details are lost | Full text of every 🔴 Critical artifact |
309
+ | Skipping open questions | Problems will resurface | Note all blockers and questions |
310
+ | No loading instructions | The session will not load the needed agents | Mapping → specific file paths |
311
+ | Prompt > 50% "fluff" | Dilution of critical data | Structure: blocks, tables, specifics |
312
+ | Abnormal termination without prompt | Total loss of context | Emergency mode: minimal prompt + ⚠️ mark |
313
+
314
+ ## Output Template
315
+
316
+ ```markdown
317
+ ---
318
+ ## Prompt for Session [N+1] — [Project Name]
319
+
320
+ ### 1. Project
321
+ - **Name:** [Name]
322
+ - **Mode:** Full Pipeline (/analyze)
323
+ - **Session:** [N+1] of 5
324
+ - **Previous Sessions:** 1-[N] completed
325
+
326
+ ### 2. Loading
327
+ Read:
328
+ - `domains/analytics/AGENTS.md`
329
+ - `domains/analytics/.agents/skills/board/SKILL.md`
330
+ - `domains/analytics/.agents/skills/handoff/SKILL.md`
331
+ - `domains/analytics/.agents/skills/gates/SKILL.md`
332
+ - [Specific skills: file paths]
333
+
334
+ Activate agents: [List of agents with Gate IDs]
335
+
336
+ ### 3. What is Completed
337
+ **Session 1:** [Summary 2-3 sentences]
338
+ **Session [N]:** [Summary 2-3 sentences]
339
+
340
+ **Key decisions:**
341
+ | # | Decision | Reasoning | Adopted by |
342
+ |---|---------|-------------|------------|
343
+ | 1 | [Decision] | [Why] | [User / Conductor] |
344
+
345
+ ### 4. Data (full text)
346
+
347
+ #### Research Brief (from INT-01)
348
+ [FULL TEXT research brief]
349
+
350
+ #### Research Data (from RES-xx)
351
+ [FULL TEXT data with sources and URLs]
352
+
353
+ #### Analysis Results (from AN-xx)
354
+ [FULL TEXT frameworks and findings]
355
+
356
+ #### [Other artifacts as needed]
357
+ [FULL TEXT]
358
+
359
+ ### 5. Current State
360
+
361
+ #### Task Board
362
+ [Full board from $board with progress metrics]
363
+
364
+ #### Open Questions
365
+ | # | Question / Blocker | Severity | For which gate |
366
+ |---|-----------------|:--------:|:----------------:|
367
+ | 1 | [Description] | 🔴/🟡/🟢 | [ID] |
368
+
369
+ ### 6. Task for Session [N+1]
370
+ **Gates:** [ID list]
371
+ **What to do:** [Specific description per gate]
372
+ **Expected Result:** [Deliverables]
373
+ **Constraints:** [If any]
374
+
375
+ → Start as Conductor (COND-xx). Load the board, check the data, pass control to [next agent].
376
+ ---
377
+ ```
378
+
379
+ ### Emergency Prompt (minimal version)
380
+
381
+ ```markdown
382
+ ---
383
+ ## ⚠️ EMERGENCY PROMPT — Session [N+1] — [Project Name]
384
+
385
+ **Status:** Session [N] terminated abnormally. Possible data loss.
386
+
387
+ ### What is Saved
388
+ [Everything collected: board, latest deliverable, questions]
389
+
390
+ ### What might be lost
391
+ | # | Data | Recovery Method |
392
+ |---|--------|-----------------------|
393
+ | 1 | [Lost data] | [Repeated web-research / ask user / recover from handoff] |
394
+
395
+ ### Task
396
+ Restore context from `docs/analytics/session-[N]-handoff.md`. Check data integrity. Continue from gate [ID].
397
+
398
+ → Start as Conductor (COND-xx). Priority: verify data integrity before continuing.
399
+ ---
400
+ ```