create-hq 6.0.0 → 7.0.0

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 (315) hide show
  1. package/dist/__tests__/scaffold.test.d.ts +2 -0
  2. package/dist/__tests__/scaffold.test.d.ts.map +1 -0
  3. package/dist/__tests__/scaffold.test.js +150 -0
  4. package/dist/__tests__/scaffold.test.js.map +1 -0
  5. package/dist/cloud-sync.d.ts +11 -0
  6. package/dist/cloud-sync.d.ts.map +1 -0
  7. package/dist/cloud-sync.js +25 -0
  8. package/dist/cloud-sync.js.map +1 -0
  9. package/dist/deps.d.ts.map +1 -1
  10. package/dist/deps.js +7 -1
  11. package/dist/deps.js.map +1 -1
  12. package/dist/fetch-template.d.ts +14 -0
  13. package/dist/fetch-template.d.ts.map +1 -0
  14. package/dist/fetch-template.js +136 -0
  15. package/dist/fetch-template.js.map +1 -0
  16. package/dist/index.js +8 -7
  17. package/dist/index.js.map +1 -1
  18. package/dist/scaffold.d.ts +2 -2
  19. package/dist/scaffold.d.ts.map +1 -1
  20. package/dist/scaffold.js +95 -286
  21. package/dist/scaffold.js.map +1 -1
  22. package/dist/ui.d.ts +2 -3
  23. package/dist/ui.d.ts.map +1 -1
  24. package/dist/ui.js +90 -44
  25. package/dist/ui.js.map +1 -1
  26. package/package.json +48 -40
  27. package/template/.claude/CLAUDE.md +0 -202
  28. package/template/.claude/commands/checkpoint.md +0 -127
  29. package/template/.claude/commands/cleanup.md +0 -307
  30. package/template/.claude/commands/execute-task.md +0 -440
  31. package/template/.claude/commands/exit-plan.md +0 -41
  32. package/template/.claude/commands/handoff.md +0 -97
  33. package/template/.claude/commands/learn.md +0 -218
  34. package/template/.claude/commands/metrics.md +0 -118
  35. package/template/.claude/commands/newworker.md +0 -162
  36. package/template/.claude/commands/nexttask.md +0 -67
  37. package/template/.claude/commands/prd.md +0 -238
  38. package/template/.claude/commands/reanchor.md +0 -51
  39. package/template/.claude/commands/remember.md +0 -126
  40. package/template/.claude/commands/run-project.md +0 -348
  41. package/template/.claude/commands/run.md +0 -110
  42. package/template/.claude/commands/search-reindex.md +0 -62
  43. package/template/.claude/commands/search.md +0 -100
  44. package/template/.claude/commands/setup.md +0 -381
  45. package/template/.claude/scripts/pure-ralph-loop.ps1 +0 -312
  46. package/template/.claude/scripts/pure-ralph-loop.sh +0 -859
  47. package/template/CHANGELOG.md +0 -220
  48. package/template/LICENSE +0 -21
  49. package/template/MIGRATION.md +0 -259
  50. package/template/README.md +0 -368
  51. package/template/data/journal/.gitkeep +0 -0
  52. package/template/docs/images/ascii-banner-options.md +0 -122
  53. package/template/docs/images/hq-banner.svg +0 -105
  54. package/template/knowledge/Ralph/01-overview.md +0 -71
  55. package/template/knowledge/Ralph/02-core-concepts.md +0 -114
  56. package/template/knowledge/Ralph/03-how-ralph-works.md +0 -184
  57. package/template/knowledge/Ralph/04-back-pressure.md +0 -222
  58. package/template/knowledge/Ralph/05-specifications.md +0 -210
  59. package/template/knowledge/Ralph/06-agents-md.md +0 -222
  60. package/template/knowledge/Ralph/07-implementation.md +0 -316
  61. package/template/knowledge/Ralph/08-economics.md +0 -182
  62. package/template/knowledge/Ralph/09-resources.md +0 -145
  63. package/template/knowledge/Ralph/10-claude-code-workflow.md +0 -212
  64. package/template/knowledge/Ralph/11-team-training-guide.md +0 -383
  65. package/template/knowledge/Ralph/README.md +0 -40
  66. package/template/knowledge/ai-security-framework/CONTRIBUTING.md +0 -139
  67. package/template/knowledge/ai-security-framework/GLOSSARY.md +0 -176
  68. package/template/knowledge/ai-security-framework/LICENSE +0 -21
  69. package/template/knowledge/ai-security-framework/QUICK-START.md +0 -172
  70. package/template/knowledge/ai-security-framework/README.md +0 -232
  71. package/template/knowledge/ai-security-framework/checklists/browser-security.md +0 -301
  72. package/template/knowledge/ai-security-framework/checklists/credential-isolation.md +0 -322
  73. package/template/knowledge/ai-security-framework/checklists/incident-response.md +0 -288
  74. package/template/knowledge/ai-security-framework/checklists/pre-flight.md +0 -249
  75. package/template/knowledge/ai-security-framework/checklists/weekly-audit.md +0 -159
  76. package/template/knowledge/ai-security-framework/configs/audit-logging.md +0 -372
  77. package/template/knowledge/ai-security-framework/configs/kill-switches.md +0 -354
  78. package/template/knowledge/ai-security-framework/docs/01-core-principles.md +0 -256
  79. package/template/knowledge/ai-security-framework/docs/02-threat-landscape.md +0 -326
  80. package/template/knowledge/ai-security-framework/docs/03-security-posture.md +0 -250
  81. package/template/knowledge/ai-security-framework/templates/agents-security.md +0 -233
  82. package/template/knowledge/design-styles/README.md +0 -42
  83. package/template/knowledge/design-styles/american-industrial.md +0 -136
  84. package/template/knowledge/design-styles/ethereal-abstract.md +0 -133
  85. package/template/knowledge/design-styles/liminal-portal.md +0 -111
  86. package/template/knowledge/design-styles/swipes/american-industrial/G-3m4YPW0AADdu2.jpeg +0 -0
  87. package/template/knowledge/design-styles/swipes/american-industrial/G-JJlt5WwAABK3K.png +0 -0
  88. package/template/knowledge/design-styles/swipes/american-industrial/G-JJmj5W0AEbJ-7.png +0 -0
  89. package/template/knowledge/design-styles/swipes/american-industrial/G59fgNuXkAAKLJQ (1).jpeg +0 -0
  90. package/template/knowledge/design-styles/swipes/american-industrial/G59fgNuXkAAKLJQ.jpeg +0 -0
  91. package/template/knowledge/design-styles/swipes/american-industrial/G7fVkn3WEAAM-ST.jpeg +0 -0
  92. package/template/knowledge/design-styles/swipes/american-industrial/G8ECO5JWEAIksyn.png +0 -0
  93. package/template/knowledge/design-styles/swipes/american-industrial/G9-3GQSWoAA8eqZ.png +0 -0
  94. package/template/knowledge/design-styles/swipes/american-industrial/G9xEOqrXkAEZRcs.png +0 -0
  95. package/template/knowledge/design-styles/swipes/american-industrial/G_MVeJrXQAA8sx4.jpeg +0 -0
  96. package/template/knowledge/design-styles/swipes/american-industrial/G_RSkmGXkAAgAVZ.png +0 -0
  97. package/template/knowledge/design-styles/swipes/american-industrial/README.md +0 -31
  98. package/template/knowledge/design-styles/swipes/american-industrial/qyqtg7Dq.png +0 -0
  99. package/template/knowledge/dev-team/README.md +0 -35
  100. package/template/knowledge/dev-team/patterns/README.md +0 -34
  101. package/template/knowledge/dev-team/patterns/frontend/react-best-practices.md +0 -178
  102. package/template/knowledge/dev-team/troubleshooting/README.md +0 -31
  103. package/template/knowledge/dev-team/workflows/README.md +0 -49
  104. package/template/knowledge/hq/checkpoint-schema.json +0 -51
  105. package/template/knowledge/hq/index-md-spec.md +0 -74
  106. package/template/knowledge/hq/thread-schema.md +0 -153
  107. package/template/knowledge/hq-core/checkpoint-schema.json +0 -51
  108. package/template/knowledge/hq-core/index-md-spec.md +0 -74
  109. package/template/knowledge/hq-core/thread-schema.md +0 -153
  110. package/template/knowledge/loom/README.md +0 -51
  111. package/template/knowledge/loom/architecture.md +0 -125
  112. package/template/knowledge/loom/code-style.md +0 -169
  113. package/template/knowledge/loom/llm-proxy.md +0 -132
  114. package/template/knowledge/loom/state-machine.md +0 -131
  115. package/template/knowledge/loom/thread-system.md +0 -117
  116. package/template/knowledge/loom/tools.md +0 -94
  117. package/template/knowledge/loom/weaver.md +0 -96
  118. package/template/knowledge/loom/web-frontend.md +0 -131
  119. package/template/knowledge/projects/README.md +0 -72
  120. package/template/knowledge/projects/templates/README.template.md +0 -28
  121. package/template/knowledge/workers/README.md +0 -195
  122. package/template/knowledge/workers/ralph-loop-pattern.md +0 -157
  123. package/template/knowledge/workers/skill-schema.md +0 -182
  124. package/template/knowledge/workers/state-machine.md +0 -102
  125. package/template/knowledge/workers/templates/base-worker.yaml +0 -73
  126. package/template/knowledge/workers/templates/code-worker.yaml +0 -85
  127. package/template/knowledge/workers/templates/skill.yaml +0 -49
  128. package/template/knowledge/workers/templates/social-worker.yaml +0 -70
  129. package/template/modules/examples/full-manifest.yaml +0 -92
  130. package/template/modules/examples/minimal.yaml +0 -14
  131. package/template/modules/modules.yaml +0 -59
  132. package/template/projects/.gitkeep +0 -0
  133. package/template/projects/incorporate-workers-into-pure-ralph/prd.json +0 -88
  134. package/template/projects/pure-ralph-branch-isolation/README.md +0 -114
  135. package/template/projects/pure-ralph-branch-isolation/prd.json +0 -123
  136. package/template/projects/purist-ralph-loop/README.md +0 -148
  137. package/template/projects/purist-ralph-loop/prd.json +0 -135
  138. package/template/projects/ralph-test/prd.json +0 -50
  139. package/template/prompts/pure-ralph-base.md +0 -551
  140. package/template/settings/.gitkeep +0 -0
  141. package/template/settings/pure-ralph.json +0 -42
  142. package/template/social-content/drafts/INDEX.md +0 -21
  143. package/template/social-content/drafts/linkedin/.gitkeep +0 -1
  144. package/template/social-content/drafts/x/.gitkeep +0 -1
  145. package/template/social-content/images/.gitkeep +0 -1
  146. package/template/starter-projects/code-worker/README.md +0 -97
  147. package/template/starter-projects/code-worker/prd.json +0 -45
  148. package/template/starter-projects/personal-assistant/README.md +0 -42
  149. package/template/starter-projects/personal-assistant/prd.json +0 -43
  150. package/template/starter-projects/social-media/README.md +0 -60
  151. package/template/starter-projects/social-media/prd.json +0 -43
  152. package/template/workers/content-brand/README.md +0 -59
  153. package/template/workers/content-brand/skills/messaging-alignment.md +0 -91
  154. package/template/workers/content-brand/skills/tone-check.md +0 -76
  155. package/template/workers/content-brand/skills/voice-analysis.md +0 -68
  156. package/template/workers/content-brand/worker.yaml +0 -81
  157. package/template/workers/content-legal/README.md +0 -80
  158. package/template/workers/content-legal/skills/claim-substantiation.md +0 -150
  159. package/template/workers/content-legal/skills/compliance-scan.md +0 -123
  160. package/template/workers/content-legal/skills/disclaimer-check.md +0 -146
  161. package/template/workers/content-legal/worker.yaml +0 -118
  162. package/template/workers/content-product/README.md +0 -77
  163. package/template/workers/content-product/skills/claim-verification.md +0 -96
  164. package/template/workers/content-product/skills/feature-accuracy.md +0 -117
  165. package/template/workers/content-product/skills/stats-check.md +0 -128
  166. package/template/workers/content-product/worker.yaml +0 -97
  167. package/template/workers/content-sales/README.md +0 -70
  168. package/template/workers/content-sales/skills/conversion-analysis.md +0 -96
  169. package/template/workers/content-sales/skills/cta-audit.md +0 -107
  170. package/template/workers/content-sales/skills/value-prop-check.md +0 -114
  171. package/template/workers/content-sales/worker.yaml +0 -93
  172. package/template/workers/content-shared/cli.ts +0 -242
  173. package/template/workers/content-shared/index.ts +0 -234
  174. package/template/workers/content-shared/lib/accuracy-analyzer.ts +0 -661
  175. package/template/workers/content-shared/lib/analyze.ts +0 -370
  176. package/template/workers/content-shared/lib/brand-analyzer.ts +0 -526
  177. package/template/workers/content-shared/lib/cms-integration.ts +0 -446
  178. package/template/workers/content-shared/lib/compliance-analyzer.ts +0 -655
  179. package/template/workers/content-shared/lib/conversion-analyzer.ts +0 -555
  180. package/template/workers/content-shared/lib/github-integration.ts +0 -582
  181. package/template/workers/content-shared/lib/output.ts +0 -373
  182. package/template/workers/content-shared/lib/parser.ts +0 -771
  183. package/template/workers/content-shared/lib/priority.ts +0 -439
  184. package/template/workers/content-shared/lib/recommendations.ts +0 -512
  185. package/template/workers/content-shared/lib/reporter.ts +0 -749
  186. package/template/workers/content-shared/lib/restructure.ts +0 -664
  187. package/template/workers/content-shared/lib/scorer.ts +0 -140
  188. package/template/workers/content-shared/lib/types.ts +0 -227
  189. package/template/workers/content-shared/lib/variants.ts +0 -595
  190. package/template/workers/content-shared/package.json +0 -51
  191. package/template/workers/content-shared/pnpm-lock.yaml +0 -39
  192. package/template/workers/content-shared/test/sample-page.json +0 -115
  193. package/template/workers/content-shared/tsconfig.json +0 -20
  194. package/template/workers/dev-team/README.md +0 -166
  195. package/template/workers/dev-team/_template.yaml +0 -70
  196. package/template/workers/dev-team/architect/package.json +0 -27
  197. package/template/workers/dev-team/architect/skills/api-design.md +0 -89
  198. package/template/workers/dev-team/architect/skills/refactor-plan.md +0 -96
  199. package/template/workers/dev-team/architect/skills/system-design.md +0 -100
  200. package/template/workers/dev-team/architect/src/index.ts +0 -49
  201. package/template/workers/dev-team/architect/src/mcp-server.ts +0 -122
  202. package/template/workers/dev-team/architect/src/skills/api-design.ts +0 -316
  203. package/template/workers/dev-team/architect/src/skills/refactor-plan.ts +0 -264
  204. package/template/workers/dev-team/architect/src/skills/system-design.ts +0 -212
  205. package/template/workers/dev-team/architect/tsconfig.json +0 -19
  206. package/template/workers/dev-team/architect/worker.yaml +0 -128
  207. package/template/workers/dev-team/backend-dev/package-lock.json +0 -1252
  208. package/template/workers/dev-team/backend-dev/package.json +0 -27
  209. package/template/workers/dev-team/backend-dev/skills/implement-endpoint.md +0 -70
  210. package/template/workers/dev-team/backend-dev/skills/implement-service.md +0 -62
  211. package/template/workers/dev-team/backend-dev/src/index.ts +0 -51
  212. package/template/workers/dev-team/backend-dev/src/mcp-server.ts +0 -109
  213. package/template/workers/dev-team/backend-dev/src/skills/implement-endpoint.ts +0 -122
  214. package/template/workers/dev-team/backend-dev/src/skills/implement-service.ts +0 -126
  215. package/template/workers/dev-team/backend-dev/tsconfig.json +0 -19
  216. package/template/workers/dev-team/backend-dev/worker.yaml +0 -128
  217. package/template/workers/dev-team/code-reviewer/package-lock.json +0 -1080
  218. package/template/workers/dev-team/code-reviewer/package.json +0 -24
  219. package/template/workers/dev-team/code-reviewer/skills/merge-to-production.md +0 -61
  220. package/template/workers/dev-team/code-reviewer/skills/merge-to-staging.md +0 -54
  221. package/template/workers/dev-team/code-reviewer/skills/request-changes.md +0 -63
  222. package/template/workers/dev-team/code-reviewer/skills/review-pr.md +0 -77
  223. package/template/workers/dev-team/code-reviewer/src/index.ts +0 -56
  224. package/template/workers/dev-team/code-reviewer/src/mcp-server.ts +0 -101
  225. package/template/workers/dev-team/code-reviewer/tsconfig.json +0 -19
  226. package/template/workers/dev-team/code-reviewer/worker.yaml +0 -90
  227. package/template/workers/dev-team/database-dev/package.json +0 -22
  228. package/template/workers/dev-team/database-dev/skills/create-schema.md +0 -48
  229. package/template/workers/dev-team/database-dev/src/index.ts +0 -50
  230. package/template/workers/dev-team/database-dev/src/mcp-server.ts +0 -76
  231. package/template/workers/dev-team/database-dev/tsconfig.json +0 -18
  232. package/template/workers/dev-team/database-dev/worker.yaml +0 -90
  233. package/template/workers/dev-team/frontend-dev/package.json +0 -22
  234. package/template/workers/dev-team/frontend-dev/skills/create-component.md +0 -26
  235. package/template/workers/dev-team/frontend-dev/src/index.ts +0 -50
  236. package/template/workers/dev-team/frontend-dev/src/mcp-server.ts +0 -77
  237. package/template/workers/dev-team/frontend-dev/tsconfig.json +0 -18
  238. package/template/workers/dev-team/frontend-dev/worker.yaml +0 -132
  239. package/template/workers/dev-team/infra-dev/package.json +0 -24
  240. package/template/workers/dev-team/infra-dev/skills/add-monitoring.md +0 -73
  241. package/template/workers/dev-team/infra-dev/skills/configure-deployment.md +0 -80
  242. package/template/workers/dev-team/infra-dev/skills/create-dockerfile.md +0 -62
  243. package/template/workers/dev-team/infra-dev/skills/setup-cicd.md +0 -63
  244. package/template/workers/dev-team/infra-dev/src/index.ts +0 -55
  245. package/template/workers/dev-team/infra-dev/src/mcp-server.ts +0 -82
  246. package/template/workers/dev-team/infra-dev/tsconfig.json +0 -19
  247. package/template/workers/dev-team/infra-dev/worker.yaml +0 -92
  248. package/template/workers/dev-team/knowledge-curator/package.json +0 -24
  249. package/template/workers/dev-team/knowledge-curator/skills/curate-troubleshooting.md +0 -63
  250. package/template/workers/dev-team/knowledge-curator/skills/process-learnings.md +0 -61
  251. package/template/workers/dev-team/knowledge-curator/skills/sync-documentation.md +0 -76
  252. package/template/workers/dev-team/knowledge-curator/skills/update-patterns.md +0 -63
  253. package/template/workers/dev-team/knowledge-curator/src/index.ts +0 -53
  254. package/template/workers/dev-team/knowledge-curator/src/mcp-server.ts +0 -92
  255. package/template/workers/dev-team/knowledge-curator/tsconfig.json +0 -19
  256. package/template/workers/dev-team/knowledge-curator/worker.yaml +0 -80
  257. package/template/workers/dev-team/motion-designer/package.json +0 -22
  258. package/template/workers/dev-team/motion-designer/skills/add-animation.md +0 -25
  259. package/template/workers/dev-team/motion-designer/skills/generate-image.md +0 -36
  260. package/template/workers/dev-team/motion-designer/src/index.ts +0 -63
  261. package/template/workers/dev-team/motion-designer/src/mcp-server.ts +0 -79
  262. package/template/workers/dev-team/motion-designer/tsconfig.json +0 -18
  263. package/template/workers/dev-team/motion-designer/worker.yaml +0 -84
  264. package/template/workers/dev-team/product-planner/queue.json +0 -4
  265. package/template/workers/dev-team/product-planner/worker.yaml +0 -220
  266. package/template/workers/dev-team/project-manager/package-lock.json +0 -1252
  267. package/template/workers/dev-team/project-manager/package.json +0 -27
  268. package/template/workers/dev-team/project-manager/skills/create-prd.md +0 -66
  269. package/template/workers/dev-team/project-manager/skills/next-issue.md +0 -51
  270. package/template/workers/dev-team/project-manager/skills/project-status.md +0 -59
  271. package/template/workers/dev-team/project-manager/skills/update-learnings.md +0 -65
  272. package/template/workers/dev-team/project-manager/src/index.ts +0 -54
  273. package/template/workers/dev-team/project-manager/src/mcp-server.ts +0 -207
  274. package/template/workers/dev-team/project-manager/src/skills/create-prd.ts +0 -86
  275. package/template/workers/dev-team/project-manager/src/skills/next-issue.ts +0 -137
  276. package/template/workers/dev-team/project-manager/src/skills/project-status.ts +0 -131
  277. package/template/workers/dev-team/project-manager/src/skills/update-learnings.ts +0 -94
  278. package/template/workers/dev-team/project-manager/tsconfig.json +0 -19
  279. package/template/workers/dev-team/project-manager/worker.yaml +0 -96
  280. package/template/workers/dev-team/qa-tester/package.json +0 -24
  281. package/template/workers/dev-team/qa-tester/skills/create-demo-account.md +0 -36
  282. package/template/workers/dev-team/qa-tester/skills/run-tests.md +0 -36
  283. package/template/workers/dev-team/qa-tester/skills/write-test.md +0 -27
  284. package/template/workers/dev-team/qa-tester/src/index.ts +0 -61
  285. package/template/workers/dev-team/qa-tester/src/mcp-server.ts +0 -88
  286. package/template/workers/dev-team/qa-tester/tsconfig.json +0 -18
  287. package/template/workers/dev-team/qa-tester/worker.yaml +0 -116
  288. package/template/workers/dev-team/task-executor/package-lock.json +0 -1252
  289. package/template/workers/dev-team/task-executor/package.json +0 -27
  290. package/template/workers/dev-team/task-executor/skills/analyze-issue.md +0 -101
  291. package/template/workers/dev-team/task-executor/skills/execute.md +0 -133
  292. package/template/workers/dev-team/task-executor/skills/report-learnings.md +0 -106
  293. package/template/workers/dev-team/task-executor/skills/validate-completion.md +0 -121
  294. package/template/workers/dev-team/task-executor/src/index.ts +0 -54
  295. package/template/workers/dev-team/task-executor/src/mcp-server.ts +0 -139
  296. package/template/workers/dev-team/task-executor/src/skills/analyze-issue.ts +0 -219
  297. package/template/workers/dev-team/task-executor/src/skills/execute.ts +0 -132
  298. package/template/workers/dev-team/task-executor/src/skills/report-learnings.ts +0 -119
  299. package/template/workers/dev-team/task-executor/src/skills/validate-completion.ts +0 -142
  300. package/template/workers/dev-team/task-executor/tsconfig.json +0 -19
  301. package/template/workers/dev-team/task-executor/worker.yaml +0 -110
  302. package/template/workers/registry.yaml +0 -171
  303. package/template/workers/security-scanner/README.md +0 -73
  304. package/template/workers/security-scanner/skills/pre-deploy-check.md +0 -205
  305. package/template/workers/security-scanner/worker.yaml +0 -26
  306. package/template/workspace/checkpoints/.gitkeep +0 -0
  307. package/template/workspace/content-ideas/inbox.jsonl +0 -0
  308. package/template/workspace/drafts/.gitkeep +0 -0
  309. package/template/workspace/learnings/.gitkeep +0 -3
  310. package/template/workspace/orchestrator/.gitkeep +0 -0
  311. package/template/workspace/ralph-test/COMPLETE.md +0 -18
  312. package/template/workspace/ralph-test/hello.txt +0 -2
  313. package/template/workspace/reports/.gitkeep +0 -0
  314. package/template/workspace/scratch/.gitkeep +0 -0
  315. package/template/workspace/threads/.gitkeep +0 -3
@@ -1,220 +0,0 @@
1
- worker:
2
- id: product-planner
3
- name: "Product Planner"
4
- type: CodeWorker
5
- version: "1.0"
6
- created: "2026-01-24"
7
-
8
- identity:
9
- voice_guide: agents.md
10
- purpose: |
11
- PRD creation, project planning, requirements analysis, and technical
12
- specification writing. Translates business needs into actionable
13
- technical documents.
14
-
15
- execution:
16
- mode: on-demand
17
- max_runtime: 20m
18
- retry_attempts: 2
19
-
20
- context:
21
- base:
22
- - agents.md
23
- - companies/*/settings/*.md
24
- - knowledge/*/architecture.md
25
- dynamic:
26
- - projects/*/brief.md
27
- - projects/*/user-feedback.md
28
- - workspace/scratch/planning-notes.md
29
- exclude:
30
- - "**/*.test.*"
31
- - "**/*.spec.*"
32
- - "**/node_modules/**"
33
- - "**/.git/**"
34
- - "**/dist/**"
35
- - "**/build/**"
36
-
37
- skills:
38
- installed:
39
- - api-design-principles
40
- - typescript-advanced-types
41
-
42
- capabilities:
43
- - Product requirements documentation
44
- - Technical specification writing
45
- - User story creation with acceptance criteria
46
- - API design and documentation
47
- - System architecture planning
48
- - Data model design
49
- - Risk assessment and mitigation planning
50
-
51
- verification:
52
- pre_execute:
53
- - Ensure project brief exists or user has provided context
54
- - Confirm target company/project scope
55
-
56
- post_execute:
57
- - PRD includes problem statement
58
- - PRD includes success metrics
59
- - Technical specs are implementation-ready
60
- - API contracts are well-defined
61
- - Data models are normalized
62
- - Dependencies are identified
63
-
64
- approval_required: true
65
-
66
- tasks:
67
- source: workers/public/dev-team/product-planner/queue.json
68
- one_at_a_time: true
69
-
70
- # State Machine (Loom pattern)
71
- state_machine:
72
- enabled: true
73
- max_retries: 1
74
- hooks:
75
- post_execute:
76
- - auto_checkpoint
77
- - log_metrics
78
- on_error:
79
- - log_error
80
- - checkpoint_error_state
81
-
82
- output:
83
- destination: projects/{project-name}/
84
- format: markdown
85
- files:
86
- - prd.md
87
- - technical-spec.md
88
- - api-contracts.md
89
- - data-model.md
90
-
91
- instructions: |
92
- You are the Product Planner worker. Your role is to transform business
93
- ideas and requirements into comprehensive, actionable technical documentation.
94
-
95
- ## Your Process
96
-
97
- 1. **Understand the Problem**
98
- - Read any project briefs or user feedback
99
- - Identify the core problem being solved
100
- - Clarify ambiguities with questions
101
-
102
- 2. **Define Success**
103
- - Set measurable success metrics
104
- - Define acceptance criteria
105
- - Identify key user outcomes
106
-
107
- 3. **Design the Solution**
108
- - Break down into components
109
- - Design API contracts (use api-design-principles skill)
110
- - Model data structures (normalize, identify relationships)
111
- - Consider edge cases and error handling
112
-
113
- 4. **Plan Implementation**
114
- - Identify technical dependencies
115
- - Suggest implementation phases
116
- - Call out risk areas
117
- - Estimate complexity (avoid time estimates)
118
-
119
- 5. **Document Everything**
120
- - Write clear, concise PRDs
121
- - Create implementation-ready technical specs
122
- - Document API contracts with examples
123
- - Provide data model diagrams (ERD as markdown)
124
-
125
- ## Output Format
126
-
127
- ### prd.md Structure
128
- ```markdown
129
- # [Project Name] - Product Requirements Document
130
-
131
- ## Problem Statement
132
- [Clear description of the problem]
133
-
134
- ## Goals
135
- - [Measurable goal 1]
136
- - [Measurable goal 2]
137
-
138
- ## Success Metrics
139
- - [Metric 1]: [Target]
140
- - [Metric 2]: [Target]
141
-
142
- ## User Stories
143
- ### Story 1: [Title]
144
- **As a** [user type]
145
- **I want** [goal]
146
- **So that** [benefit]
147
-
148
- **Acceptance Criteria:**
149
- - [ ] [Criterion 1]
150
- - [ ] [Criterion 2]
151
-
152
- ## Non-Goals
153
- - [What's explicitly out of scope]
154
-
155
- ## Open Questions
156
- - [ ] [Question 1]
157
- - [ ] [Question 2]
158
- ```
159
-
160
- ### technical-spec.md Structure
161
- ```markdown
162
- # [Project Name] - Technical Specification
163
-
164
- ## Architecture Overview
165
- [High-level architecture diagram as markdown]
166
-
167
- ## Components
168
- ### Component 1: [Name]
169
- **Purpose:** [Description]
170
- **Dependencies:** [List]
171
- **Interface:** [Public API]
172
-
173
- ## Technology Stack
174
- - Frontend: [Framework, libraries]
175
- - Backend: [Runtime, framework]
176
- - Database: [Type, specific DB]
177
- - Infrastructure: [Hosting, CI/CD]
178
-
179
- ## Data Flow
180
- [Sequence of operations]
181
-
182
- ## Security Considerations
183
- - [Consideration 1]
184
- - [Consideration 2]
185
-
186
- ## Performance Considerations
187
- - [Consideration 1]
188
- - [Consideration 2]
189
-
190
- ## Implementation Phases
191
- ### Phase 1: [Name]
192
- - [Task 1]
193
- - [Task 2]
194
-
195
- ## Risk Assessment
196
- | Risk | Impact | Mitigation |
197
- |------|--------|------------|
198
- | [Risk] | [H/M/L] | [Strategy] |
199
- ```
200
-
201
- ### api-contracts.md Structure
202
- Use the api-design-principles skill to ensure contracts follow best practices.
203
- Include request/response examples, error codes, rate limits.
204
-
205
- ### data-model.md Structure
206
- Show entities, relationships, indexes, and migration considerations.
207
-
208
- ## Important Notes
209
- - Always re-anchor on the problem being solved
210
- - Ask clarifying questions before making assumptions
211
- - Consider maintainability and scalability
212
- - Document the "why" behind decisions
213
- - Keep specs implementation-ready (devs should not need to guess)
214
-
215
- ## Before You Finalize
216
- - [ ] Reviewed with api-design-principles skill
217
- - [ ] Checked data model normalization
218
- - [ ] Confirmed all dependencies identified
219
- - [ ] Verified success metrics are measurable
220
- - [ ] Asked user for approval on approach