@llipe.com/dev-tasks 0.10.0 → 0.16.1

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 (620) hide show
  1. package/.claude/agents/developer.md +108 -35
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +45 -3
  5. package/.claude/agents/researcher.md +116 -0
  6. package/.claude/agents/technical-writer.md +61 -6
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +48 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +64 -28
  12. package/.claude/commands/product-engineer.md +58 -19
  13. package/.claude/commands/researcher.md +27 -0
  14. package/.claude/commands/technical-writer.md +1 -1
  15. package/.claude/hooks/branch-guard.sh +30 -0
  16. package/.claude/hooks/git-guard.sh +483 -22
  17. package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
  18. package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  19. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  20. package/.claude/skills/activity-grill/SKILL.md +150 -0
  21. package/.claude/skills/activity-init/SKILL.md +121 -71
  22. package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
  23. package/.claude/skills/activity-refine/SKILL.md +75 -15
  24. package/.claude/skills/activity-test-standards/SKILL.md +66 -0
  25. package/.claude/skills/aws-ops/SKILL.md +155 -0
  26. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  27. package/.claude/skills/fly-ops/SKILL.md +138 -0
  28. package/.claude/skills/git-ops/SKILL.md +27 -7
  29. package/.claude/skills/implement/SKILL.md +49 -4
  30. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  31. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  32. package/.claude/skills/plan/SKILL.md +43 -1
  33. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  34. package/.github/agents/developer.agent.md +80 -18
  35. package/.github/agents/github-ops.agent.md +46 -4
  36. package/.github/agents/housekeeping.agent.md +43 -7
  37. package/.github/agents/infra-engineer.agent.md +139 -0
  38. package/.github/agents/planner.agent.md +45 -9
  39. package/.github/agents/product-engineer.agent.md +58 -19
  40. package/.github/agents/qa-engineer.agent.md +43 -4
  41. package/.github/agents/researcher.agent.md +115 -0
  42. package/.github/agents/technical-writer.agent.md +60 -6
  43. package/.github/agents/verifier.agent.md +46 -5
  44. package/.github/instructions/implement.instructions.md +49 -4
  45. package/.github/instructions/plan.instructions.md +43 -1
  46. package/.github/prompts/infra-engineer.prompt.md +12 -0
  47. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  48. package/.github/prompts/researcher.prompt.md +28 -0
  49. package/.github/prompts/technical-writer.prompt.md +1 -1
  50. package/.github/skills/activity-codebase-research/SKILL.md +146 -0
  51. package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  52. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  53. package/.github/skills/activity-grill/SKILL.md +145 -0
  54. package/.github/skills/activity-init/SKILL.md +120 -70
  55. package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
  56. package/.github/skills/activity-refine/SKILL.md +75 -15
  57. package/.github/skills/activity-test-standards/SKILL.md +66 -0
  58. package/.github/skills/aws-ops/SKILL.md +150 -0
  59. package/.github/skills/deploy-ops/SKILL.md +116 -0
  60. package/.github/skills/fly-ops/SKILL.md +133 -0
  61. package/.github/skills/git-ops/SKILL.md +27 -7
  62. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  63. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  64. package/.github/skills/supabase-ops/SKILL.md +104 -0
  65. package/.kiro/agents/developer.md +81 -19
  66. package/.kiro/agents/github-ops.md +46 -4
  67. package/.kiro/agents/housekeeping.md +44 -8
  68. package/.kiro/agents/infra-engineer.md +102 -0
  69. package/.kiro/agents/planner.md +53 -20
  70. package/.kiro/agents/product-engineer.md +61 -22
  71. package/.kiro/agents/qa-engineer.md +44 -5
  72. package/.kiro/agents/researcher.md +118 -0
  73. package/.kiro/agents/technical-writer.md +63 -9
  74. package/.kiro/agents/verifier.md +48 -7
  75. package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
  76. package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  77. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  78. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  79. package/.kiro/skills/activity-init/SKILL.md +121 -71
  80. package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
  81. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  82. package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
  83. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  84. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  85. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  86. package/.kiro/skills/git-ops/SKILL.md +27 -7
  87. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  88. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  89. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  90. package/.kiro/steering/implement.md +49 -4
  91. package/.kiro/steering/plan.md +43 -1
  92. package/AGENTS.md +88 -261
  93. package/AGENTS.md.template +124 -0
  94. package/CHANGELOG.md +196 -0
  95. package/CLAUDE.md +24 -18
  96. package/CLAUDE.md.template +103 -0
  97. package/README.md +168 -145
  98. package/TESTING.md +84 -140
  99. package/bundle-manifest.json +43 -2
  100. package/dist/bin/dev-tasks.js +65 -3
  101. package/dist/bin/dev-tasks.js.map +1 -1
  102. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  103. package/dist/bin/parse-args.d.ts.map +1 -0
  104. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  105. package/dist/bin/parse-args.js.map +1 -0
  106. package/dist/core/checks/decision-log-format.d.ts +44 -0
  107. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  108. package/dist/core/checks/decision-log-format.js +171 -0
  109. package/dist/core/checks/decision-log-format.js.map +1 -0
  110. package/dist/core/checks/docs-structure.d.ts +82 -0
  111. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  112. package/dist/core/checks/docs-structure.js +285 -0
  113. package/dist/core/checks/docs-structure.js.map +1 -0
  114. package/dist/core/checks/glossary.d.ts +178 -0
  115. package/dist/core/checks/glossary.d.ts.map +1 -0
  116. package/dist/core/checks/glossary.js +651 -0
  117. package/dist/core/checks/glossary.js.map +1 -0
  118. package/dist/core/checks/index.d.ts +19 -0
  119. package/dist/core/checks/index.d.ts.map +1 -0
  120. package/dist/core/checks/index.js +16 -0
  121. package/dist/core/checks/index.js.map +1 -0
  122. package/dist/core/checks/run.d.ts +22 -0
  123. package/dist/core/checks/run.d.ts.map +1 -0
  124. package/dist/core/checks/run.js +51 -0
  125. package/dist/core/checks/run.js.map +1 -0
  126. package/dist/core/distribution/doctor.d.ts +46 -1
  127. package/dist/core/distribution/doctor.d.ts.map +1 -1
  128. package/dist/core/distribution/doctor.js +161 -2
  129. package/dist/core/distribution/doctor.js.map +1 -1
  130. package/dist/core/distribution/index.d.ts +9 -3
  131. package/dist/core/distribution/index.d.ts.map +1 -1
  132. package/dist/core/distribution/index.js +5 -2
  133. package/dist/core/distribution/index.js.map +1 -1
  134. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  135. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  136. package/dist/core/distribution/install-if-absent.js +81 -0
  137. package/dist/core/distribution/install-if-absent.js.map +1 -0
  138. package/dist/core/distribution/install.d.ts.map +1 -1
  139. package/dist/core/distribution/install.js +5 -0
  140. package/dist/core/distribution/install.js.map +1 -1
  141. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  142. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  143. package/dist/core/distribution/migrate-docs.js +139 -0
  144. package/dist/core/distribution/migrate-docs.js.map +1 -0
  145. package/dist/core/distribution/profiles.d.ts +49 -0
  146. package/dist/core/distribution/profiles.d.ts.map +1 -1
  147. package/dist/core/distribution/profiles.js +45 -0
  148. package/dist/core/distribution/profiles.js.map +1 -1
  149. package/dist/core/distribution/update.d.ts +14 -0
  150. package/dist/core/distribution/update.d.ts.map +1 -1
  151. package/dist/core/distribution/update.js +77 -3
  152. package/dist/core/distribution/update.js.map +1 -1
  153. package/dist/core/distribution/workspace.d.ts +84 -0
  154. package/dist/core/distribution/workspace.d.ts.map +1 -0
  155. package/dist/core/distribution/workspace.js +276 -0
  156. package/dist/core/distribution/workspace.js.map +1 -0
  157. package/dist/core/exit-codes.d.ts +15 -35
  158. package/dist/core/exit-codes.d.ts.map +1 -1
  159. package/dist/core/exit-codes.js +15 -36
  160. package/dist/core/exit-codes.js.map +1 -1
  161. package/dist/core/index.d.ts +1 -6
  162. package/dist/core/index.d.ts.map +1 -1
  163. package/dist/core/index.js +1 -7
  164. package/dist/core/index.js.map +1 -1
  165. package/package.json +17 -32
  166. package/templates/claude/settings.json +48 -0
  167. package/templates/domain/ubiquitous-language.md +28 -0
  168. package/templates/infra/environments.yaml +16 -0
  169. package/templates/infra/redaction-patterns.txt +47 -0
  170. package/templates/runbooks/README.md +14 -0
  171. package/templates/runbooks/runbook-template.md +40 -0
  172. package/templates/scripts/deploy-status.sh +89 -0
  173. package/templates/scripts/deploy-verify.sh +85 -0
  174. package/templates/scripts/deploy.sh +284 -0
  175. package/templates/scripts/release.sh +170 -0
  176. package/templates/scripts/rollback.sh +109 -0
  177. package/templates/workflows/deploy-dev.yml +66 -0
  178. package/templates/workflows/deploy-prod.yml +66 -0
  179. package/templates/workflows/rollback.yml +77 -0
  180. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  181. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  182. package/dist/adapters/cli/catalog-build.js +0 -73
  183. package/dist/adapters/cli/catalog-build.js.map +0 -1
  184. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  185. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  186. package/dist/adapters/cli/catalog-query.js +0 -329
  187. package/dist/adapters/cli/catalog-query.js.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  189. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  190. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  191. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  193. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  194. package/dist/adapters/cli/catalog-validate.js +0 -122
  195. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  197. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  198. package/dist/adapters/cli/ctx-assemble.js +0 -293
  199. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  201. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  202. package/dist/adapters/cli/ctx-fetch.js +0 -267
  203. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  204. package/dist/adapters/cli/extract-all.d.ts +0 -31
  205. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  206. package/dist/adapters/cli/extract-all.js +0 -374
  207. package/dist/adapters/cli/extract-all.js.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  209. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  210. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  211. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  212. package/dist/adapters/cli/extract-component.d.ts +0 -24
  213. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  214. package/dist/adapters/cli/extract-component.js +0 -198
  215. package/dist/adapters/cli/extract-component.js.map +0 -1
  216. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  217. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  218. package/dist/adapters/cli/extract-detect.js +0 -98
  219. package/dist/adapters/cli/extract-detect.js.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  221. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  222. package/dist/adapters/cli/extract-openapi.js +0 -111
  223. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  224. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  225. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  226. package/dist/adapters/cli/extract-schema.js +0 -39
  227. package/dist/adapters/cli/extract-schema.js.map +0 -1
  228. package/dist/adapters/cli/index.d.ts +0 -6
  229. package/dist/adapters/cli/index.d.ts.map +0 -1
  230. package/dist/adapters/cli/index.js +0 -5
  231. package/dist/adapters/cli/index.js.map +0 -1
  232. package/dist/adapters/cli/init.d.ts +0 -37
  233. package/dist/adapters/cli/init.d.ts.map +0 -1
  234. package/dist/adapters/cli/init.js +0 -336
  235. package/dist/adapters/cli/init.js.map +0 -1
  236. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  237. package/dist/adapters/cli/parse-args.js.map +0 -1
  238. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  239. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  240. package/dist/adapters/cli/scope-gate.js +0 -157
  241. package/dist/adapters/cli/scope-gate.js.map +0 -1
  242. package/dist/adapters/cli/scope.d.ts +0 -26
  243. package/dist/adapters/cli/scope.d.ts.map +0 -1
  244. package/dist/adapters/cli/scope.js +0 -172
  245. package/dist/adapters/cli/scope.js.map +0 -1
  246. package/dist/adapters/cli/validate-component.d.ts +0 -24
  247. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  248. package/dist/adapters/cli/validate-component.js +0 -62
  249. package/dist/adapters/cli/validate-component.js.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  251. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  252. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  253. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  254. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  255. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  256. package/dist/adapters/cli/verify-drift.js +0 -103
  257. package/dist/adapters/cli/verify-drift.js.map +0 -1
  258. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  259. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  260. package/dist/adapters/cli/verify-impact.js +0 -119
  261. package/dist/adapters/cli/verify-impact.js.map +0 -1
  262. package/dist/adapters/mcp/index.d.ts +0 -5
  263. package/dist/adapters/mcp/index.d.ts.map +0 -1
  264. package/dist/adapters/mcp/index.js +0 -2
  265. package/dist/adapters/mcp/index.js.map +0 -1
  266. package/dist/bin/dt.d.ts +0 -7
  267. package/dist/bin/dt.d.ts.map +0 -1
  268. package/dist/bin/dt.js +0 -647
  269. package/dist/bin/dt.js.map +0 -1
  270. package/dist/core/catalog/build.d.ts +0 -143
  271. package/dist/core/catalog/build.d.ts.map +0 -1
  272. package/dist/core/catalog/build.js +0 -475
  273. package/dist/core/catalog/build.js.map +0 -1
  274. package/dist/core/catalog/checks/index.d.ts +0 -18
  275. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  276. package/dist/core/catalog/checks/index.js +0 -18
  277. package/dist/core/catalog/checks/index.js.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  279. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  280. package/dist/core/catalog/checks/v01-schema.js +0 -57
  281. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  283. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  284. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  285. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  287. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  288. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  289. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  291. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  292. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  293. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  295. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  296. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  297. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  299. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  300. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  301. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  303. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  304. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  305. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  307. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  308. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  309. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  311. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  312. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  313. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  316. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  317. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  320. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  321. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  323. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  324. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  325. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  327. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  328. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  329. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  331. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  332. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  333. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  334. package/dist/core/catalog/coverage.d.ts +0 -39
  335. package/dist/core/catalog/coverage.d.ts.map +0 -1
  336. package/dist/core/catalog/coverage.js +0 -62
  337. package/dist/core/catalog/coverage.js.map +0 -1
  338. package/dist/core/catalog/graph.d.ts +0 -49
  339. package/dist/core/catalog/graph.d.ts.map +0 -1
  340. package/dist/core/catalog/graph.js +0 -114
  341. package/dist/core/catalog/graph.js.map +0 -1
  342. package/dist/core/catalog/index-model.d.ts +0 -96
  343. package/dist/core/catalog/index-model.d.ts.map +0 -1
  344. package/dist/core/catalog/index-model.js +0 -8
  345. package/dist/core/catalog/index-model.js.map +0 -1
  346. package/dist/core/catalog/index.d.ts +0 -5
  347. package/dist/core/catalog/index.d.ts.map +0 -1
  348. package/dist/core/catalog/index.js +0 -2
  349. package/dist/core/catalog/index.js.map +0 -1
  350. package/dist/core/catalog/queries.d.ts +0 -69
  351. package/dist/core/catalog/queries.d.ts.map +0 -1
  352. package/dist/core/catalog/queries.js +0 -165
  353. package/dist/core/catalog/queries.js.map +0 -1
  354. package/dist/core/catalog/resolve.d.ts +0 -47
  355. package/dist/core/catalog/resolve.d.ts.map +0 -1
  356. package/dist/core/catalog/resolve.js +0 -318
  357. package/dist/core/catalog/resolve.js.map +0 -1
  358. package/dist/core/catalog/scaffold.d.ts +0 -31
  359. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  360. package/dist/core/catalog/scaffold.js +0 -141
  361. package/dist/core/catalog/scaffold.js.map +0 -1
  362. package/dist/core/catalog/validate-component.d.ts +0 -50
  363. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  364. package/dist/core/catalog/validate-component.js +0 -105
  365. package/dist/core/catalog/validate-component.js.map +0 -1
  366. package/dist/core/catalog/validate.d.ts +0 -71
  367. package/dist/core/catalog/validate.d.ts.map +0 -1
  368. package/dist/core/catalog/validate.js +0 -103
  369. package/dist/core/catalog/validate.js.map +0 -1
  370. package/dist/core/context/assemble.d.ts +0 -126
  371. package/dist/core/context/assemble.d.ts.map +0 -1
  372. package/dist/core/context/assemble.js +0 -197
  373. package/dist/core/context/assemble.js.map +0 -1
  374. package/dist/core/context/cache.d.ts +0 -60
  375. package/dist/core/context/cache.d.ts.map +0 -1
  376. package/dist/core/context/cache.js +0 -236
  377. package/dist/core/context/cache.js.map +0 -1
  378. package/dist/core/context/exit-codes.d.ts +0 -28
  379. package/dist/core/context/exit-codes.d.ts.map +0 -1
  380. package/dist/core/context/exit-codes.js +0 -28
  381. package/dist/core/context/exit-codes.js.map +0 -1
  382. package/dist/core/context/fetch.d.ts +0 -55
  383. package/dist/core/context/fetch.d.ts.map +0 -1
  384. package/dist/core/context/fetch.js +0 -112
  385. package/dist/core/context/fetch.js.map +0 -1
  386. package/dist/core/context/index.d.ts +0 -11
  387. package/dist/core/context/index.d.ts.map +0 -1
  388. package/dist/core/context/index.js +0 -8
  389. package/dist/core/context/index.js.map +0 -1
  390. package/dist/core/context/init.d.ts +0 -179
  391. package/dist/core/context/init.d.ts.map +0 -1
  392. package/dist/core/context/init.js +0 -532
  393. package/dist/core/context/init.js.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  395. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  396. package/dist/core/context/layers/architecture-layer.js +0 -24
  397. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  399. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  400. package/dist/core/context/layers/contracts-layer.js +0 -83
  401. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  403. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  404. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  405. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  406. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  407. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  408. package/dist/core/context/layers/flow-layer.js +0 -61
  409. package/dist/core/context/layers/flow-layer.js.map +0 -1
  410. package/dist/core/context/layers/index-layer.d.ts +0 -13
  411. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  412. package/dist/core/context/layers/index-layer.js +0 -77
  413. package/dist/core/context/layers/index-layer.js.map +0 -1
  414. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  415. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  416. package/dist/core/context/layers/primary-layer.js +0 -61
  417. package/dist/core/context/layers/primary-layer.js.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  419. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  420. package/dist/core/context/layers/secondary-layer.js +0 -52
  421. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  422. package/dist/core/context/session-lock.d.ts +0 -114
  423. package/dist/core/context/session-lock.d.ts.map +0 -1
  424. package/dist/core/context/session-lock.js +0 -90
  425. package/dist/core/context/session-lock.js.map +0 -1
  426. package/dist/core/context/tokens.d.ts +0 -35
  427. package/dist/core/context/tokens.d.ts.map +0 -1
  428. package/dist/core/context/tokens.js +0 -88
  429. package/dist/core/context/tokens.js.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  431. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  432. package/dist/core/extract/asyncapi/declared.js +0 -168
  433. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  434. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  435. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  436. package/dist/core/extract/asyncapi/index.js +0 -8
  437. package/dist/core/extract/asyncapi/index.js.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  439. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  440. package/dist/core/extract/asyncapi/payloads.js +0 -421
  441. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  443. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  444. package/dist/core/extract/asyncapi/topics.js +0 -368
  445. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  446. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  447. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  448. package/dist/core/extract/asyncapi/types.js +0 -5
  449. package/dist/core/extract/asyncapi/types.js.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  451. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  452. package/dist/core/extract/asyncapi/validate.js +0 -156
  453. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  454. package/dist/core/extract/component.d.ts +0 -204
  455. package/dist/core/extract/component.d.ts.map +0 -1
  456. package/dist/core/extract/component.js +0 -258
  457. package/dist/core/extract/component.js.map +0 -1
  458. package/dist/core/extract/detect.d.ts +0 -35
  459. package/dist/core/extract/detect.d.ts.map +0 -1
  460. package/dist/core/extract/detect.js +0 -89
  461. package/dist/core/extract/detect.js.map +0 -1
  462. package/dist/core/extract/index.d.ts +0 -12
  463. package/dist/core/extract/index.d.ts.map +0 -1
  464. package/dist/core/extract/index.js +0 -6
  465. package/dist/core/extract/index.js.map +0 -1
  466. package/dist/core/extract/ladder.d.ts +0 -79
  467. package/dist/core/extract/ladder.d.ts.map +0 -1
  468. package/dist/core/extract/ladder.js +0 -70
  469. package/dist/core/extract/ladder.js.map +0 -1
  470. package/dist/core/extract/openapi/index.d.ts +0 -43
  471. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  472. package/dist/core/extract/openapi/index.js +0 -142
  473. package/dist/core/extract/openapi/index.js.map +0 -1
  474. package/dist/core/extract/openapi/route1.d.ts +0 -36
  475. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  476. package/dist/core/extract/openapi/route1.js +0 -333
  477. package/dist/core/extract/openapi/route1.js.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  479. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  480. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  481. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  482. package/dist/core/extract/openapi/route2.d.ts +0 -69
  483. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  484. package/dist/core/extract/openapi/route2.js +0 -211
  485. package/dist/core/extract/openapi/route2.js.map +0 -1
  486. package/dist/core/extract/openapi/route3.d.ts +0 -26
  487. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  488. package/dist/core/extract/openapi/route3.js +0 -737
  489. package/dist/core/extract/openapi/route3.js.map +0 -1
  490. package/dist/core/extract/openapi/types.d.ts +0 -125
  491. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  492. package/dist/core/extract/openapi/types.js +0 -5
  493. package/dist/core/extract/openapi/types.js.map +0 -1
  494. package/dist/core/extract/openapi/validate.d.ts +0 -29
  495. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  496. package/dist/core/extract/openapi/validate.js +0 -200
  497. package/dist/core/extract/openapi/validate.js.map +0 -1
  498. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  499. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  500. package/dist/core/extract/orm/drizzle.js +0 -283
  501. package/dist/core/extract/orm/drizzle.js.map +0 -1
  502. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  503. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  504. package/dist/core/extract/orm/information-schema.js +0 -142
  505. package/dist/core/extract/orm/information-schema.js.map +0 -1
  506. package/dist/core/extract/orm/prisma.d.ts +0 -23
  507. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  508. package/dist/core/extract/orm/prisma.js +0 -234
  509. package/dist/core/extract/orm/prisma.js.map +0 -1
  510. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  511. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  512. package/dist/core/extract/orm/typeorm.js +0 -269
  513. package/dist/core/extract/orm/typeorm.js.map +0 -1
  514. package/dist/core/extract/orm/types.d.ts +0 -97
  515. package/dist/core/extract/orm/types.d.ts.map +0 -1
  516. package/dist/core/extract/orm/types.js +0 -6
  517. package/dist/core/extract/orm/types.js.map +0 -1
  518. package/dist/core/extract/prompt.d.ts +0 -21
  519. package/dist/core/extract/prompt.d.ts.map +0 -1
  520. package/dist/core/extract/prompt.js +0 -79
  521. package/dist/core/extract/prompt.js.map +0 -1
  522. package/dist/core/extract/provider.d.ts +0 -121
  523. package/dist/core/extract/provider.d.ts.map +0 -1
  524. package/dist/core/extract/provider.js +0 -6
  525. package/dist/core/extract/provider.js.map +0 -1
  526. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  527. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  528. package/dist/core/extract/providers/node-ts.js +0 -320
  529. package/dist/core/extract/providers/node-ts.js.map +0 -1
  530. package/dist/core/extract/render/schema-md.d.ts +0 -16
  531. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  532. package/dist/core/extract/render/schema-md.js +0 -140
  533. package/dist/core/extract/render/schema-md.js.map +0 -1
  534. package/dist/core/extract/report.d.ts +0 -125
  535. package/dist/core/extract/report.d.ts.map +0 -1
  536. package/dist/core/extract/report.js +0 -52
  537. package/dist/core/extract/report.js.map +0 -1
  538. package/dist/core/extract/schema.d.ts +0 -34
  539. package/dist/core/extract/schema.d.ts.map +0 -1
  540. package/dist/core/extract/schema.js +0 -146
  541. package/dist/core/extract/schema.js.map +0 -1
  542. package/dist/core/extract/workspaces.d.ts +0 -33
  543. package/dist/core/extract/workspaces.d.ts.map +0 -1
  544. package/dist/core/extract/workspaces.js +0 -193
  545. package/dist/core/extract/workspaces.js.map +0 -1
  546. package/dist/core/providers/index.d.ts +0 -6
  547. package/dist/core/providers/index.d.ts.map +0 -1
  548. package/dist/core/providers/index.js +0 -2
  549. package/dist/core/providers/index.js.map +0 -1
  550. package/dist/core/providers/tracker.d.ts +0 -74
  551. package/dist/core/providers/tracker.d.ts.map +0 -1
  552. package/dist/core/providers/tracker.js +0 -38
  553. package/dist/core/providers/tracker.js.map +0 -1
  554. package/dist/core/scope/calibration.d.ts +0 -25
  555. package/dist/core/scope/calibration.d.ts.map +0 -1
  556. package/dist/core/scope/calibration.js +0 -52
  557. package/dist/core/scope/calibration.js.map +0 -1
  558. package/dist/core/scope/closure.d.ts +0 -31
  559. package/dist/core/scope/closure.d.ts.map +0 -1
  560. package/dist/core/scope/closure.js +0 -68
  561. package/dist/core/scope/closure.js.map +0 -1
  562. package/dist/core/scope/gate.d.ts +0 -41
  563. package/dist/core/scope/gate.d.ts.map +0 -1
  564. package/dist/core/scope/gate.js +0 -165
  565. package/dist/core/scope/gate.js.map +0 -1
  566. package/dist/core/scope/index.d.ts +0 -18
  567. package/dist/core/scope/index.d.ts.map +0 -1
  568. package/dist/core/scope/index.js +0 -12
  569. package/dist/core/scope/index.js.map +0 -1
  570. package/dist/core/scope/partition.d.ts +0 -36
  571. package/dist/core/scope/partition.d.ts.map +0 -1
  572. package/dist/core/scope/partition.js +0 -78
  573. package/dist/core/scope/partition.js.map +0 -1
  574. package/dist/core/scope/prompt.d.ts +0 -39
  575. package/dist/core/scope/prompt.d.ts.map +0 -1
  576. package/dist/core/scope/prompt.js +0 -123
  577. package/dist/core/scope/prompt.js.map +0 -1
  578. package/dist/core/scope/scoping.d.ts +0 -52
  579. package/dist/core/scope/scoping.d.ts.map +0 -1
  580. package/dist/core/scope/scoping.js +0 -99
  581. package/dist/core/scope/scoping.js.map +0 -1
  582. package/dist/core/scope/types.d.ts +0 -77
  583. package/dist/core/scope/types.d.ts.map +0 -1
  584. package/dist/core/scope/types.js +0 -5
  585. package/dist/core/scope/types.js.map +0 -1
  586. package/dist/core/scope/validate.d.ts +0 -47
  587. package/dist/core/scope/validate.d.ts.map +0 -1
  588. package/dist/core/scope/validate.js +0 -90
  589. package/dist/core/scope/validate.js.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  591. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  592. package/dist/core/verify/asyncapi-diff.js +0 -209
  593. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  594. package/dist/core/verify/contract-diff.d.ts +0 -39
  595. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  596. package/dist/core/verify/contract-diff.js +0 -63
  597. package/dist/core/verify/contract-diff.js.map +0 -1
  598. package/dist/core/verify/drift.d.ts +0 -47
  599. package/dist/core/verify/drift.d.ts.map +0 -1
  600. package/dist/core/verify/drift.js +0 -122
  601. package/dist/core/verify/drift.js.map +0 -1
  602. package/dist/core/verify/impact.d.ts +0 -22
  603. package/dist/core/verify/impact.d.ts.map +0 -1
  604. package/dist/core/verify/impact.js +0 -93
  605. package/dist/core/verify/impact.js.map +0 -1
  606. package/dist/core/verify/index.d.ts +0 -10
  607. package/dist/core/verify/index.d.ts.map +0 -1
  608. package/dist/core/verify/index.js +0 -9
  609. package/dist/core/verify/index.js.map +0 -1
  610. package/dist/core/verify/openapi-diff.d.ts +0 -29
  611. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  612. package/dist/core/verify/openapi-diff.js +0 -291
  613. package/dist/core/verify/openapi-diff.js.map +0 -1
  614. package/dist/core/verify/types.d.ts +0 -138
  615. package/dist/core/verify/types.d.ts.map +0 -1
  616. package/dist/core/verify/types.js +0 -5
  617. package/dist/core/verify/types.js.map +0 -1
  618. package/schemas/component.schema.json +0 -203
  619. package/schemas/flow.schema.json +0 -75
  620. package/schemas/scope-output.schema.json +0 -62
@@ -0,0 +1,124 @@
1
+ # dev-tasks
2
+
3
+ Portable, repo-installed workflow harness for structured, PRD-driven AI-assisted development. Agents orchestrate the workflow end-to-end with branch discipline, test-first design, and GitHub-as-source-of-truth.
4
+
5
+ ## Contracts
6
+
7
+ | File | Owner | Purpose |
8
+ | ------------- | ------------- | ---------------------------------------------- |
9
+ | `/DESIGN.md` | `ux-engineer` | Canonical design-system tokens and UI guidance |
10
+ | `/TESTING.md` | `qa-engineer` | Layer taxonomy, runners, thresholds, fixtures |
11
+
12
+ If `/DESIGN.md` is missing and scope includes UI work, agents **MUST** create a baseline before finalizing design-dependent outputs. An unfilled `/TESTING.md` placeholder means "no standard established", never permission.
13
+
14
+ ## Taxonomy
15
+
16
+ | Concept | Purpose | Loaded When |
17
+ | --------------- | -------------------------------------------- | ----------------------- |
18
+ | **Agent** | Autonomous role with decisions and handoffs | Invoked by name |
19
+ | **Skill** | Reusable on-demand procedure | On demand by agent |
20
+ | **Instruction** | Scoped rule auto-applied to matching context | Auto-applied by runtime |
21
+
22
+ ## Agents
23
+
24
+ | Agent | Purpose |
25
+ | -------------------- | --------------------------------------------------------------------------------------------------------- |
26
+ | **product-engineer** | Preparation — PRD, spec, stories, plan. Owns drift-reconciliation. |
27
+ | **developer** | Execution — implements from task lists with mandatory verifier audit pre-PR. |
28
+ | **planner** | Multi-story orchestration with dependency ordering and integration PR. |
29
+ | **technical-writer** | Autonomous documentation maintenance. **Owns docs structure and content**, including `docs/runbooks/`. |
30
+ | **housekeeping** | Lint, type, and test-wiring fixes. Does **not** organize documentation. |
31
+ | **github-ops** | GitHub consistency — issues, PRs, branches, labels, milestones, merge authority. |
32
+ | **ux-engineer** | UX prototyping, DESIGN.md ownership, mockup generation. |
33
+ | **qa-engineer** | Testing standard, test authoring, coverage/gap reporting. |
34
+ | **researcher** | Bounded codebase investigation producing structured research artifacts. |
35
+ | **verifier** | Compliance test-plan design and post-implementation fidelity audit. |
36
+ | **infra-engineer** | Approval-gated, reversible, recorded infrastructure changes across AWS, fly.io, Supabase, and Cloudflare. |
37
+
38
+ Platform coverage: `.github/agents/` and `.kiro/agents/` carry all eleven. `.claude/agents/` carries eight — `planner`, `product-engineer`, and `infra-engineer` run as `.claude/commands/` (they need main-thread human-approval gates: per-step for `infra-engineer`, per-phase for the two orchestrators).
39
+
40
+ ## Skills
41
+
42
+ ### Activity Skills
43
+
44
+ | Skill | Purpose | Consumer |
45
+ | ---------------------------------------- | --------------------------------------------------------- | ---------------- |
46
+ | activity-init | Establish product context and technical guidelines | product-engineer |
47
+ | activity-refine | Issue refinement or full PRD creation | product-engineer |
48
+ | activity-grill | One-question-at-a-time, depth-first interview to a confirmed shared-understanding exit gate | product-engineer |
49
+ | activity-codebase-research | Bounded codebase investigation with structured artifact | researcher |
50
+ | activity-generate-spec | PRD to technical specification | product-engineer |
51
+ | activity-generate-stories | Spec to user stories with coverage validation | product-engineer |
52
+ | activity-publish-github | Publish stories as GitHub Issues | product-engineer |
53
+ | activity-e2e-test-design | E2E scenario generation from spec/stories | verifier |
54
+ | activity-contract-test-design | Contract and schema compatibility test strategy | verifier |
55
+ | activity-edge-case-refinement | Systematic edge-case discovery | verifier |
56
+ | activity-random-test-tactics | Randomized/fuzz/property test generation | verifier |
57
+ | activity-test-standards | Establish/maintain TESTING.md, detect harness defects | qa-engineer |
58
+ | activity-test-implementation | Author Layer 1-2 tests with security-negative category | qa-engineer |
59
+ | activity-integration-test-implementation | Layer 2.5 tests against real databases | qa-engineer |
60
+ | activity-e2e-test-implementation | Playwright E2E from verifier scenario tables | qa-engineer |
61
+ | activity-coverage-gap-analysis | Coverage measurement or structural gap analysis | qa-engineer |
62
+ | activity-drift-reconciliation | Route drift findings to task expansion or spec write-back | product-engineer |
63
+
64
+ ### Operational Skills
65
+
66
+ | Skill | Purpose | Consumer |
67
+ | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
68
+ | git-ops | Branch management, rebase, merge, conflict resolution | developer, planner |
69
+ | aws-ops | AWS CLI command sets, tiers, cost, backup/revert, log table | infra-engineer |
70
+ | fly-ops | flyctl command sets, tiers, cost, backup/revert, log table | infra-engineer |
71
+ | supabase-ops | Supabase CLI command sets, `db diff` flow, drift rule, backup/revert, log table | infra-engineer |
72
+ | deploy-ops | Deploy script contract, environment mapping, tag policy, deploy-target framing, and GitHub Actions workflow scaffolding (`templates/scripts/`, `templates/workflows/`) | infra-engineer |
73
+ | ux-scaffold | Mockup project creation (html-lite, react-full) | ux-engineer |
74
+ | ux-theme-gen | Generate theme artifacts from DESIGN.md | ux-engineer, developer |
75
+ | memo-cli-usage | Read/write decisions to shared knowledge base | technical-writer, developer |
76
+
77
+ ## Instructions
78
+
79
+ | Instruction | Scope | Purpose |
80
+ | ----------------------- | -------------------------- | -------------------------------------------------- |
81
+ | plan | `workstream/**` | Convert stories/issues into task lists |
82
+ | implement | `workstream/**/tasks-*.md` | Execute task list with branching and PR discipline |
83
+ | nextjs-pages-components | `**/app/**/*.tsx` | Next.js + React conventions |
84
+ | git-guard-notice | Always (Kiro) | Git invariants reminder |
85
+
86
+ `nextjs-pages-components` has a Claude gap: there is no automatic Claude delivery mechanism (no glob-scoped auto-load, no nested-`CLAUDE.md` scaffolding) — Claude Code consumers must manually copy the conventions into their app's nested `CLAUDE.md`. See `CLAUDE.md`'s "Domain-Specific Conventions" section.
87
+
88
+ ## Hooks
89
+
90
+ Kiro (`.kiro/hooks/`) and Claude Code (`.claude/hooks/`, wired via `.claude/settings.json`) both ship these two `PreToolUse` hooks; Copilot has no hook system, so its enforcement is prompt-level only.
91
+
92
+ | Hook | Matcher (Claude Code) | Purpose |
93
+ | ------------ | ------------------------ | ---------------------------------------------------------------------------- |
94
+ | git-guard | `Bash`, plus (issue #178) the mutating GitHub MCP tool surface — `mcp__github__merge_pull_request`, `enable_pr_auto_merge`, `push_files`, `create_or_update_file`, `delete_file`, `create_branch` | Blocks pushes/merges/writes into the default branch (resolved dynamically, not hardcoded to `main`) — including `gh pr merge` with its base resolved via `gh pr view` (not a `--base` text check), `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the resolved base is the default branch, the raw-git escape of merging a story/issue branch into an integration branch, and the equivalent MCP-tool-call forms of all of the above (base/branch resolved from structured `tool_input` fields, not a command string) — plus non-Conventional commits, inline `gh --body`, and human-only tags |
95
+ | branch-guard | `Edit\|Write\|NotebookEdit` | Blocks write operations on default branch |
96
+
97
+ Hook enforcement is best-effort and fails open on unexpected errors, with one exception: if `git-guard` cannot verify a `gh pr merge`'s (or its MCP equivalent's) base branch — the `gh pr view` lookup fails (`gh` missing, unauthenticated, or a network error), or an MCP merge/auto-merge call omits enough `tool_input` to identify the PR at all — it fails **closed** and blocks the call, since an unverified base could be the default branch.
98
+
99
+ **Hooks are advisory, not the gate.** Every hook in this table is a best-effort, local, pattern-matching check over a command string or a structured tool-input shape — not a real parser, and not a completeness guarantee against every future command form or tool surface (a new MCP server, a future first-party tool) that could reopen the same class of gap. **GitHub branch protection on the default branch — require a PR, require ≥1 approving review, require passing status checks, disable force-push and branch deletion — is the actual, server-side, unbypassable-by-any-tool-surface control.** Hooks narrow the window and catch the common cases; they do not replace branch protection. Configure it per the README "Configure branch protection" step and `activity-init`'s Repository Setup section.
100
+
101
+ ## General Agent Guidelines
102
+
103
+ All agents **MUST**:
104
+
105
+ - Create feature branches — never commit to default branch
106
+ - Use Conventional Commits (`feat`, `fix`, `chore`, `docs`, etc.)
107
+ - Create PRs for review — never self-merge into `main`; PRs targeting `main` require user approval
108
+ - Follow standards from `tech.md`
109
+ - Reference GitHub Issues in branch names and commits
110
+ - Prefer `pnpm` over `npm`; use canonical scripts: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
111
+ - Enforce quality gates before completion
112
+ - Use `git-ops` for complex branch operations
113
+ - Run `qa-engineer` at completion gate (record `coverage_gate: PASS | FAIL | SKIPPED(<reason>)`)
114
+ - Run `verifier` audit (mandatory, non-skippable) before PR is ready; drift findings route to `product-engineer`
115
+ - Follow test-first design: write tests before implementation code
116
+ - If `memo-cli` is available: read/write entries per role
117
+ - **Foundation documents: resolve the new name, fall back to the old one.** The canonical names are `docs/product.md` and `docs/tech.md`. A repository installed before the rename still carries `docs/product-context.md` and `docs/technical-guidelines.md`, and `dev-tasks update` never renames a consumer-owned file on its own. So when **reading** a foundation document, resolve the new name first and fall back to the old one only when the new name is absent; when **writing**, always write the new name. Propose `dev-tasks migrate docs` on encountering an old name. This applies to every agent and skill that reads these documents, for one release cycle (FR-45)
118
+ - Deliver a runbook in the **same PR** as any new or materially changed script under `templates/scripts/`, workflow under `templates/workflows/` or `.github/workflows/`, or `infra-engineer` change kind (FR-49a). Updating an existing runbook satisfies this
119
+ - Route a docs-structure failure in `validate` to `technical-writer`, never to `housekeeping` (FR-51): `technical-writer` owns documentation structure and content
120
+ - Treat a blocked guard as a decision, not an obstacle: when a hook blocks a tool call, surface the block verbatim, stop that line of work, and **MUST NOT** attempt an alternative command, tool surface, or sequence that achieves the same effect the block just prevented. Using a legitimate alternate mechanism for an unrelated, non-triggering purpose (e.g. `Read` instead of `grep`, `Write` instead of a shell heredoc) is not a route-around and remains allowed
121
+
122
+ ---
123
+
124
+ For workflow chains: [`docs/workflow-chains.md`](docs/workflow-chains.md). For architecture and invariants: [`docs/system-overview.md`](docs/system-overview.md). Full docs index: [`docs/README.md`](docs/README.md).
package/CHANGELOG.md CHANGED
@@ -5,6 +5,202 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/).
7
7
 
8
+ ## [0.16.1] - 2026-09-23
9
+
10
+ ### Fixed
11
+
12
+ - fix: infra script contract test wiring and shellcheck warning (#252)
13
+
14
+ ## [0.16.0] - 2026-09-23
15
+
16
+ ### Added
17
+
18
+ - feat: ubiquitous language — glossary delivery, structural validation, and vocabulary lifecycle (Phase 3) (#251)
19
+ - feat(memo): adopt memo-cli 1.3.0 banks, recall, and episodic writes (#240)
20
+ - feat: deliver grilling, decision log, and refine/spec/plan integration (Phase 2) (#228)
21
+
22
+ ### Fixed
23
+
24
+ - fix: prettier pass
25
+
26
+ ### Changed
27
+
28
+ - docs(workstream): Phase 3 specification, stories, and implementation plan (#235)
29
+ - docs(workstream): shared-understanding Phase 2 specification, stories, and implementation plan (#220)
30
+ - chore(workstream): archive completed phase 0, 1, and supporting work artifacts (#212)
31
+
32
+ ## [0.15.0] - 2026-09-20
33
+
34
+ ### Added
35
+
36
+ - feat: docs foundation and repository shape (Phase 1) (#211)
37
+
38
+ ### Changed
39
+
40
+ - chore: pre-release prettier formatting
41
+
42
+ ## [0.14.0] - 2026-09-20
43
+
44
+ ### Added
45
+
46
+ - feat!: retire the dt binary and multi-repo context layer (Phase 0) (#200)
47
+
48
+ ### Fixed
49
+
50
+ - fix(gitignore): stop ignoring /docs behind a rotting allowlist (#209)
51
+
52
+ ### Changed
53
+
54
+ - chore: prettier run
55
+ - docs(workstream): Phase 1 specification, stories, and implementation plan (#210)
56
+ - docs: add shared-understanding PRD and simplicity contract (#194)
57
+
58
+ ## [Unreleased]
59
+
60
+ ### Added
61
+
62
+ - **`dev-tasks migrate docs`** — proposes the foundation-document rename to a consumer repository and applies it under `--force`, backing the originals up first. Report-only by default; exits `14` when a rename is skipped because its target already exists. `--json` on every path. Note the deliberate asymmetry with the bare `dev-tasks migrate`, which applies immediately (`shared-understanding#D-52`).
63
+ - **`dev-tasks doctor`** gains two checks: `foundation-doc-names` (fails when a repository still carries the pre-rename names and names the command that fixes it) and `package-map` (warns, never fails, when `docs/tech.md`'s package map and the workspace disagree).
64
+ - **`docs/runbooks/`** — ten runbooks covering install, branch protection, the foundation-doc migration, npm release, deploy, rollback, hook troubleshooting, local Supabase, simplicity tooling, and the `dt` retirement. `install` scaffolds the directory, its index, and a template into a consumer repository with install-if-absent semantics.
65
+ - **`core/checks/`** with the docs-structure check, chained into `lint`. Fails on a broken docs index, a malformed runbook, or a dangling `related` path; reports a `last_verified` over 90 days without failing.
66
+ - **Repository-shape detection** (`core/distribution/workspace.ts`) — single-package or monorepo from six signals, with the package map recorded in `docs/tech.md`.
67
+
68
+ ### Changed
69
+
70
+ - **Foundation documents renamed:** `docs/product-context.md` → `docs/product.md`, `docs/technical-guidelines.md` → `docs/tech.md`. Content is byte-identical. Agents resolve the new name first and fall back to the old one for one release cycle, so a repository installed before the rename keeps working; `dev-tasks update` never renames a consumer-owned file on its own.
71
+ - `INSTALL_IF_ABSENT_FILES` accepts a platform-agnostic entry, so a file belonging to the repository rather than to one platform is delivered once per run.
72
+ - `researcher`, `plan`, `implement`, and `activity-test-standards` are package-aware: findings, tasks, and commit scopes name their package in a monorepo, and reachability is verified per package. Optional — never blank — in a single-package repository.
73
+ - `verifier` reports a runbook-coverage finding when a PR performs a repeatable procedure and leaves no runbook. Advisory; never blocks PR readiness.
74
+ - Documentation ownership is explicit: `technical-writer` owns docs structure and content, `housekeeping` does not, and a docs-structure failure in `validate` routes to `technical-writer`.
75
+ - `activity-init`'s "Mode A — Mono-Repo" renamed to "Mode A — Documented Repository", freeing the term for repository shape (`shared-understanding#D-44`).
76
+
77
+ ### Removed
78
+
79
+ - **`dt` binary and the entire multi-repo context layer** (ADR-007). Restore path: tag `v0.13.0`, commit `0a6f35e`.
80
+ - `dt init`
81
+ - `dt extract detect`, `dt extract all`, `dt extract component`, `dt extract openapi`, `dt extract asyncapi`, `dt extract schema`
82
+ - `dt catalog build`, `dt catalog validate`, `dt catalog query`, `dt catalog scaffold`
83
+ - `dt scope`, `dt scope gate`
84
+ - `dt verify contract-diff`, `dt verify impact`, `dt verify drift`
85
+ - `dt ctx fetch`, `dt ctx assemble`
86
+ - `docs/dt-user-manual.md`, `docs/data-model.md`, `docs/artifact-formats.md`, `docs/requirements/prd-multi-repo-context.md`.
87
+ - The `architecture-change` task type and Cross-Repo Partitioning (RF-63) rules from `AGENTS.md` and `AGENTS.md.template`.
88
+ - The `activity-contract-validation` skill (all three platform trees).
89
+
90
+ ### Changed
91
+
92
+ - `core/exit-codes.ts` collapsed to a 5-code contract (`Success`, `GeneralError`, `InvalidUsage`, `DependencyError`, `ReconciliationConflict`); all deprecated aliases removed.
93
+ - `bin/parse-args.ts` moved from `adapters/cli/parse-args.ts`; dead flags `metaRepo`, `strategy`, `interactive`, `dbUrl` dropped.
94
+ - ADR-001 and ADR-002 marked Superseded by ADR-007.
95
+
96
+ ## [0.13.0] - 2026-09-17
97
+
98
+ ### Added
99
+
100
+ - feat(claude): deliver runtime parity and enforcement (v0.13) (#193)
101
+
102
+ ### Changed
103
+
104
+ - chore: format
105
+ - Merge pull request #168 from llipe:claude/tasks-implementation-review-txyjhu
106
+ - docs(workstream): add planner merge-path, MCP bypass, and guard-routing fixes
107
+ - docs(workstream): add Claude runtime parity and enforcement task list
108
+ - Merge pull request #167 from llipe:issue/141-pr-teach-team-mvp
109
+ - docs(pr-kt): refine issue #141 as MVP and add compliance test plan
110
+ - Merge pull request #166 from llipe:chore/reconcile-infra-engineer-tasklist
111
+ - docs(infra): reconcile task-list checkboxes with merged v0.12.0 state
112
+
113
+ ## [0.12.0] - 2026-09-14
114
+
115
+ ### Added
116
+
117
+ - feat(infra): wire housekeeping, planner, product-engineer, and github-ops to infra-engineer (#163)
118
+ - feat(infra): route platform writes from developer and implement to infra-engineer (#163)
119
+ - feat(infra): register deploy-ops + workflow templates and wire planner deploy handoff (#162)
120
+ - feat(infra): register templates/scripts+workflows as managed, workflows consumer-owned (#162)
121
+ - feat(infra): add GitHub Actions deploy/rollback workflow templates (#162)
122
+ - feat(infra): add deploy-ops skill across three trees (#161)
123
+ - feat(infra): add deploy-ops script templates (deploy, verify, rollback, status, release) (#161)
124
+ - feat: enforce consumer-owned directory-prefix protection on update (#159)
125
+ - feat(infra): add git-guard tag rule 4 and exact-semver workflow filters (#160)
126
+ - feat(infra): add redaction pattern set and security-negative test (#158)
127
+ - feat(infra): add supabase-ops skill and supabase log research (#157)
128
+ - feat(infra): add fly-ops skill (#156)
129
+ - feat(infra): add aws-ops skill and infra skill parity test (#155)
130
+ - feat(infra): add agent contract and branch hygiene (#153 #154)
131
+
132
+ ### Fixed
133
+
134
+ - fix(testing): align TESTING.md layer-boundary wording with issue-130 taxonomy contract
135
+ - fix(infra): add non-interactive guard to deploy.sh prod to match release.sh (#161)
136
+ - fix(deps): tighten fast-uri override to >=4.1.3 to clear high advisories
137
+ - fix(infra): align parity assertions and branch tables (#153 #154)
138
+ - fix: Update tools for orchestration agent
139
+
140
+ ### Changed
141
+
142
+ - chore: md format fix
143
+ - test(fixtures): update catalog index timestamps and generator version
144
+ - Merge pull request #165 from llipe:fix/testing-md-taxonomy-phrasing
145
+ - Merge pull request #164 from llipe:issue/153-branch-convention-hygiene
146
+ - docs(testing): fill in QA testing standard with auto-detected configuration
147
+ - docs(infra): add Infrastructure Change chain and infra-engineer reverse-direction routing (#163)
148
+ - test(infra): add S-010 caller-wiring and reverse-direction parity block (#163)
149
+ - docs(infra): mark S-009 checklist done (9.1-9.6, 9.5b, 9.8); 9.7 manual not-run (#162)
150
+ - style(infra): apply prettier formatting to S-009 test files (#162)
151
+ - test(infra): assert release.sh suggests bump from Conventional Commits (#161)
152
+ - docs: mark S-008 subtasks complete in task plan (#161)
153
+ - style(infra): apply prettier to deploy-ops contract test (#161)
154
+ - test(infra): add ref-rule and dirty-tree edge cases for deploy.sh (#161)
155
+ - test(infra): add deploy-ops script contract test and stub fixtures (#161)
156
+ - docs: register infra-engineer and add ADR-005 (#159)
157
+ - docs: sync S-007 checklist parent state with issue #160 (#160)
158
+ - docs(infra): add tag policy to github-ops, git-ops, and technical-guidelines (#160)
159
+ - docs: mark S-007 code subtasks 7.1-7.3 complete (#160)
160
+ - Merge pull request #152 from llipe/claude/charming-edison-0lvhip
161
+ - docs: correct the claim that quality-gate CI workflows exist
162
+ - docs: add S-010 caller wiring story and Task 10 to infra-engineer plan
163
+ - docs: add infra-engineer spec, user stories, and task list
164
+ - docs: infra-engineer PRD v1.3 with trunk-based environment mapping
165
+ - docs: infra-engineer PRD v1.2 with step-gated execution and pipeline ownership
166
+ - docs: simplify infra-engineer PRD to three phases and one skill each
167
+ - Merge pull request #151 from llipe:issue/143-infra-prd
168
+ - docs: add infra-engineer PRD absorbing #143 #144 #145 #150
169
+ - Update README with installation instructions
170
+
171
+ ## [0.11.0] - 2026-08-25
172
+
173
+ ### Added
174
+
175
+ - feat(agent): add researcher agent and activity-codebase-research skill
176
+ - feat(test): add integration, E2E, and contract validation skills (#130)
177
+
178
+ ### Fixed
179
+
180
+ - fix: trim AGENTS.md from 2678 to 1218 words
181
+
182
+ ### Changed
183
+
184
+ - chore: prettier
185
+ - chore: archive workstream
186
+ - Merge pull request #147 from llipe:issue/139-research-agent
187
+ - docs: fix drift found by technical-writer pass
188
+ - Merge pull request #146 from llipe:issue/142-clean-agents-md
189
+ - test(fixtures): update catalog fixture timestamps and generator version
190
+ - Merge pull request #138 from llipe/issue/130-integration-testing-playwright-e2e
191
+ - test: add parity and content tests for issue #130 skills
192
+
193
+ ## [Unreleased]
194
+
195
+ ### Added
196
+
197
+ - feat(agent): add `researcher` agent and `activity-codebase-research` skill (#139)
198
+ - Ten-agent roster (Copilot/Kiro), eight Claude subagents
199
+ - Eight-slice taxonomy, 250-line/30-file budget caps
200
+ - Conditional pre-refine (Issue Mode) and pre-spec (Feature Mode) research step
201
+ - Developer troubleshooting and planner pre-orchestration paths
202
+ - ADR-004: pre-spec codebase research step
203
+
8
204
  ## [0.10.0] - 2026-08-19
9
205
 
10
206
  ### Added
package/CLAUDE.md CHANGED
@@ -15,7 +15,7 @@ All work in this repository **MUST**:
15
15
  - Always create feature branches — never commit directly to the default branch (`main`).
16
16
  - Use [Conventional Commits](https://www.conventionalcommits.org/) (`feat`, `fix`, `chore`, `docs`, `refactor`, `test`, `ci`).
17
17
  - Open PRs for review — **never self-merge into `main`**. PRs targeting `main` require **user** approval and the **user** merges them. No agent may merge into `main`.
18
- - Follow testing, linting, and documentation standards from `docs/technical-guidelines.md`.
18
+ - Follow testing, linting, and documentation standards from `docs/tech.md`.
19
19
  - Prefer `pnpm` over `npm` for JavaScript/TypeScript workflows (fallback to `npm` only when `pnpm` is unavailable or explicitly disallowed).
20
20
  - Use canonical `package.json` script names for JS/TS projects: `lint`, `lint:fix`, `format`, `format:check`, `typecheck`, `test`, `test:unit`, `test:integration`, `test:e2e`, `audit`, `validate`.
21
21
  - Before developer/planner completion, enforce and record quality gates: `test`, `lint`, `format:check`, `typecheck`, `audit`.
@@ -27,6 +27,10 @@ All work in this repository **MUST**:
27
27
  - Produce English-only output for docs, comments, and generated content.
28
28
  - The `verifier` audit (`audit` mode) is a mandatory, non-skippable step triggered automatically by `developer` (per issue, pre-PR-ready) and `planner` (per story and PRD-level rollup). Drift findings are non-blocking to PR/issue completion and route to `product-engineer`'s `activity-drift-reconciliation` skill for write-back into task lists, GitHub issues, or PRD/spec changelogs.
29
29
  - **Test-first design is the default:** `product-engineer` recommends `verifier` Design Mode after planning to produce a compliance test plan; `developer` writes tests before implementation code for each behavioral sub-task; `planner` checks for test plans and enforces test-first in developer handoffs.
30
+ - **Foundation documents: resolve the new name, fall back to the old one.** The canonical names are `docs/product.md` and `docs/tech.md`. A repository installed before the rename still carries `docs/product-context.md` and `docs/technical-guidelines.md`, and `dev-tasks update` never renames a consumer-owned file on its own. When **reading** a foundation document, resolve the new name first and fall back to the old one only when the new name is absent; when **writing**, always write the new name, and propose `dev-tasks migrate docs`. This binds every agent and skill that reads these documents, for one release cycle (FR-45). Stating it here rather than repeating it in all 32 prompt files that name these documents is deliberate: this file is always loaded, and 32 copies would drift.
31
+ - **Documentation ownership is explicit.** `technical-writer` owns documentation structure and content — `/docs`, its indexes, and `docs/runbooks/`. `housekeeping` does **not** organize documentation, and a docs-structure failure in `validate` (from `core/checks/docs-structure.ts`) routes to `technical-writer` (FR-51).
32
+ - **A runbook ships in the same PR as the procedure it documents.** Any new or materially changed script under `templates/scripts/`, workflow under `templates/workflows/` or `.github/workflows/`, or `infra-engineer` change kind **MUST** arrive with a runbook in the same draft PR, not a follow-up issue (FR-49a). Updating an existing runbook satisfies this. The `verifier` reports a runbook-coverage finding when it does not; that finding is advisory and never blocks PR readiness.
33
+ - **A blocked guard is a decision, not an obstacle.** When a hook (e.g. `git-guard.sh`) blocks a tool call, the agent **MUST** surface the block verbatim and stop that line of work. It **MUST NOT** attempt an alternative command, tool surface, or sequence that achieves the same effect the block just prevented — that includes retrying the same operation via a different CLI flag, a different tool (e.g. an MCP tool instead of `Bash`, or vice versa), or a workaround that produces the same end state through a different mechanism. A legitimate alternate mechanism used for an unrelated, non-triggering purpose (e.g. the `Read` tool instead of `grep`, or the `Write` tool instead of a shell heredoc) is not a route-around and remains allowed. If blocked, report the block message to the user and ask how to proceed.
30
34
 
31
35
  These mirror the General Agent Guidelines in `AGENTS.md`. The "no merge to `main`" and Conventional Commits rules are additionally enforced deterministically by hooks in `.claude/settings.json`.
32
36
 
@@ -46,33 +50,35 @@ This toolkit is exposed as **commands** (entry points you invoke with `/`), **su
46
50
 
47
51
  ### Commands (entry points)
48
52
 
49
- | Command | Purpose |
50
- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
51
- | `/product-engineer` | **Orchestrator (main thread).** Init / Feature / Issue mode: refine → spec → stories → publish → plan. Hands off to `/developer` or `/planner`. |
52
- | `/planner` | **Orchestrator (main thread).** Multi-story execution with dependency ordering, per-story delegation to the `developer` subagent, checkpoint/resume (auto-detected), and one consolidated PR. |
53
- | `/developer` | **Interactive (main thread).** Step-gated implementation of a task list, pausing for approval after each sub-task. |
54
- | `/github-ops` | Audit/standardize GitHub artifacts. |
55
- | `/technical-writer` | Sync `/docs` with the codebase. |
56
- | `/housekeeping` | Fix lint/type/test-wiring issues. |
57
- | `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
58
- | `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
59
- | `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
60
- | `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
53
+ | Command | Purpose |
54
+ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
55
+ | `/product-engineer` | **Orchestrator (main thread).** Init / Feature / Issue mode: refine → spec → stories → publish → plan. Hands off to `/developer` or `/planner`. |
56
+ | `/planner` | **Orchestrator (main thread).** Multi-story execution with dependency ordering, per-story delegation to the `developer` subagent, checkpoint/resume (auto-detected), and one consolidated PR. |
57
+ | `/developer` | **Interactive (main thread).** Step-gated implementation of a task list, pausing for approval after each sub-task. |
58
+ | `/github-ops` | Audit/standardize GitHub artifacts. |
59
+ | `/technical-writer` | Sync `/docs` with the codebase. Owns docs structure and content, including `docs/runbooks/`. |
60
+ | `/housekeeping` | Fix lint/type/test-wiring issues. Does not organize documentation. |
61
+ | `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
62
+ | `/researcher` | Bounded codebase investigation producing a structured research artifact at `/workstream/research-*.md`. |
63
+ | `/infra-engineer` | **Interactive (main thread).** Plan and apply infrastructure changes one approved, reversible, recorded step at a time (AWS, fly.io, Supabase, Cloudflare); hands off a draft PR. Never merges. |
64
+ | `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
65
+ | `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
66
+ | `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
61
67
 
62
68
  ### Subagents (`.claude/agents/`)
63
69
 
64
- `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
70
+ `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer`, `researcher` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
65
71
 
66
72
  ### Orchestration model (important)
67
73
 
68
74
  Claude Code subagents **cannot spawn other subagents** — the hierarchy is flat (main session → workers). dev-tasks is delegation-heavy, so:
69
75
 
70
- - **Orchestrators run in the main thread as commands** (`/product-engineer`, `/planner`), not as subagents, so they can delegate to leaf subagents _and_ pause for the required user-approval gates.
76
+ - **Orchestrators run in the main thread as commands** (`/product-engineer`, `/planner`), not as subagents, so they can delegate to leaf subagents _and_ pause for the required user-approval gates. `/infra-engineer` runs in the main thread for the same reason — it pauses for one human approval per infrastructure step.
71
77
  - **Step-gated approval requires the main thread.** A subagent runs to completion and only returns a summary; it cannot pause mid-run for a "yes". Use `/developer` (main thread) for interactive step-gated work; the `developer` _subagent_ is for `/planner`'s autonomous per-story delegation, which gates at the **story** boundary, not per sub-task.
72
78
 
73
79
  ### Skills (`.claude/skills/`)
74
80
 
75
- Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
81
+ Activity skills: `activity-init`, `activity-refine`, `activity-grill` (one-question-at-a-time, depth-first interview invoked by `activity-refine` and `activity-generate-spec`, to a confirmed shared-understanding exit gate), `activity-codebase-research`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-e2e-test-implementation`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-integration-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `aws-ops`, `fly-ops`, `supabase-ops`, `deploy-ops`, `ux-scaffold`, `ux-theme-gen`, `memo-cli-usage`.
76
82
 
77
83
  `plan` and `implement` are scoped instructions on Copilot (`applyTo`) and scoped steering on Kiro (`fileMatchPattern`); as Claude skills they load on demand instead of consuming context on every matching turn.
78
84
 
@@ -80,7 +86,7 @@ Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `
80
86
 
81
87
  ## Domain-Specific Conventions
82
88
 
83
- Copilot's `applyTo`-scoped instructions have no direct Claude Code equivalent (there is no glob-scoped auto-load). The Next.js/React conventions (scoped to `**/*.tsx`) are preserved as a nested `CLAUDE.md` inside each React app's root directory when that app exists, so they load only while working in that subtree. When generating UI, follow those conventions and `/DESIGN.md`.
89
+ Copilot's `applyTo`-scoped instructions have no direct Claude Code equivalent (there is no glob-scoped auto-load), and there is no automatic Claude delivery mechanism that scaffolds a nested `CLAUDE.md` for the Next.js/React conventions (scoped to `**/*.tsx`) — no code in this repository creates one. Consumers who want those conventions to load only while working inside a React app's subtree **MUST** do it manually: copying the conventions into their app's nested `CLAUDE.md`. When generating UI, follow those conventions (wherever placed) and `/DESIGN.md`.
84
90
 
85
91
  ---
86
92
 
@@ -88,7 +94,7 @@ Copilot's `applyTo`-scoped instructions have no direct Claude Code equivalent (t
88
94
 
89
95
  | Directory | Contents |
90
96
  | --------------------- | --------------------------------------------------------------------- |
91
- | `/docs/` | Foundation docs — product-context, technical-guidelines, ADRs |
97
+ | `/docs/` | Foundation docs — product.md, tech.md, ADRs |
92
98
  | `/docs/requirements/` | PRDs |
93
99
  | `/workstream/` | Active feature work — specs, stories, task lists, planner state files |
94
100
  | `.claude/agents/` | Subagent definitions |
@@ -0,0 +1,103 @@
1
+ # CLAUDE.md
2
+
3
+ Project memory for Claude Code. This file is always loaded. It defines the cross-cutting rules every agent in this repository **MUST** follow, and points to the dev-tasks workflow (subagents, skills, and commands under `.claude/`).
4
+
5
+ > The canonical project/agent registry lives in `AGENTS.md` and is imported below. `/DESIGN.md` is the canonical UI/design contract.
6
+
7
+ @AGENTS.md
8
+
9
+ ---
10
+
11
+ ## General Agent Guidelines (Always Enforced)
12
+
13
+ All work in this repository **MUST**:
14
+
15
+ - Always create feature branches — never commit directly to the default branch (`main`).
16
+ - Use [Conventional Commits](https://www.conventionalcommits.org/) (`feat`, `fix`, `chore`, `docs`, `refactor`, `test`, `ci`).
17
+ - Open PRs for review — **never self-merge into `main`**. PRs targeting `main` require **user** approval and the **user** merges them. No agent may merge into `main`.
18
+ - Follow testing, linting, and documentation standards from `docs/tech.md`.
19
+ - Prefer `pnpm` over `npm` for JavaScript/TypeScript workflows (fallback to `npm` only when `pnpm` is unavailable or explicitly disallowed).
20
+ - Use canonical `package.json` script names for JS/TS projects: `lint`, `lint:fix`, `format`, `format:check`, `typecheck`, `test`, `test:unit`, `test:integration`, `test:e2e`, `audit`, `validate`.
21
+ - Before developer/planner completion, enforce and record quality gates: `test`, `lint`, `format:check`, `typecheck`, `audit`.
22
+ - `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate: PASS | FAIL | SKIPPED(<reason>)`. Skipping requires a non-empty reason; omitting the field is treated as incomplete.
23
+ - `/TESTING.md` is the canonical testing contract — owned by `qa-engineer`, kept current by `developer`, and treated as "no standard established" while unfilled.
24
+ - Reference GitHub Issues in branch names and commits; follow the `github-ops` conventions for all GitHub artifacts (issues, PRs, branches, labels, milestones, comments).
25
+ - Treat `/DESIGN.md` as the source of truth for visual tokens, components, and design guidance; update it whenever UI contracts change.
26
+ - Maintain document changelogs when updating generated artifacts (PRDs, specs, stories, refinements).
27
+ - Produce English-only output for docs, comments, and generated content.
28
+ - The `verifier` audit (`audit` mode) is a mandatory, non-skippable step triggered automatically by `developer` (per issue, pre-PR-ready) and `planner` (per story and PRD-level rollup). Drift findings are non-blocking to PR/issue completion and route to `product-engineer`'s `activity-drift-reconciliation` skill for write-back into task lists, GitHub issues, or PRD/spec changelogs.
29
+ - **Test-first design is the default:** `product-engineer` recommends `verifier` Design Mode after planning to produce a compliance test plan; `developer` writes tests before implementation code for each behavioral sub-task; `planner` checks for test plans and enforces test-first in developer handoffs.
30
+ - **Foundation documents: resolve the new name, fall back to the old one.** The canonical names are `docs/product.md` and `docs/tech.md`. A repository installed before the rename still carries `docs/product-context.md` and `docs/technical-guidelines.md`, and `dev-tasks update` never renames a consumer-owned file on its own. When **reading** a foundation document, resolve the new name first and fall back to the old one only when the new name is absent; when **writing**, always write the new name, and propose `dev-tasks migrate docs`. This binds every agent and skill that reads these documents, for one release cycle (FR-45). Stating it here rather than repeating it in all 32 prompt files that name these documents is deliberate: this file is always loaded, and 32 copies would drift.
31
+ - **Documentation ownership is explicit.** `technical-writer` owns documentation structure and content — `/docs`, its indexes, and `docs/runbooks/`. `housekeeping` does **not** organize documentation, and a docs-structure failure in `validate` (from `core/checks/docs-structure.ts`) routes to `technical-writer` (FR-51).
32
+ - **A runbook ships in the same PR as the procedure it documents.** Any new or materially changed script under `templates/scripts/`, workflow under `templates/workflows/` or `.github/workflows/`, or `infra-engineer` change kind **MUST** arrive with a runbook in the same draft PR, not a follow-up issue (FR-49a). Updating an existing runbook satisfies this. The `verifier` reports a runbook-coverage finding when it does not; that finding is advisory and never blocks PR readiness.
33
+ - **A blocked guard is a decision, not an obstacle.** When a hook (e.g. `git-guard.sh`) blocks a tool call, the agent **MUST** surface the block verbatim and stop that line of work. It **MUST NOT** attempt an alternative command, tool surface, or sequence that achieves the same effect the block just prevented — that includes retrying the same operation via a different CLI flag, a different tool (e.g. an MCP tool instead of `Bash`, or vice versa), or a workaround that produces the same end state through a different mechanism. A legitimate alternate mechanism used for an unrelated, non-triggering purpose (e.g. the `Read` tool instead of `grep`, or the `Write` tool instead of a shell heredoc) is not a route-around and remains allowed. If blocked, report the block message to the user and ask how to proceed.
34
+
35
+ These mirror the General Agent Guidelines in `AGENTS.md`. The "no merge to `main`" and Conventional Commits rules are additionally enforced deterministically by hooks in `.claude/settings.json`.
36
+
37
+ ## GitHub Operations
38
+
39
+ GitHub operations run through the **`gh` CLI** (over Bash). The `github-ops` subagent owns all conventions. A GitHub MCP server is optional; if one is configured, agents may use it instead, but no MCP server is required.
40
+
41
+ ## memo-cli (Optional)
42
+
43
+ If `memo-cli` is installed and `memo setup validate` passes: `product-engineer` reads context at session start; `developer` writes intent/outcome entries per story; `technical-writer` writes one entry per ADR and significant doc change. If installed but not configured, ask the user to run `memo setup init` first. If not installed, skip silently. See the `memo-cli-usage` skill.
44
+
45
+ ---
46
+
47
+ ## How to Run the Workflow
48
+
49
+ This toolkit is exposed as **commands** (entry points you invoke with `/`), **subagents** (isolated workers Claude delegates to), and **skills** (on-demand procedures, auto-loaded when relevant or invoked by name).
50
+
51
+ ### Commands (entry points)
52
+
53
+ | Command | Purpose |
54
+ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
55
+ | `/product-engineer` | **Orchestrator (main thread).** Init / Feature / Issue mode: refine → spec → stories → publish → plan. Hands off to `/developer` or `/planner`. |
56
+ | `/planner` | **Orchestrator (main thread).** Multi-story execution with dependency ordering, per-story delegation to the `developer` subagent, checkpoint/resume (auto-detected), and one consolidated PR. |
57
+ | `/developer` | **Interactive (main thread).** Step-gated implementation of a task list, pausing for approval after each sub-task. |
58
+ | `/github-ops` | Audit/standardize GitHub artifacts. |
59
+ | `/technical-writer` | Sync `/docs` with the codebase. Owns docs structure and content, including `docs/runbooks/`. |
60
+ | `/housekeeping` | Fix lint/type/test-wiring issues. Does not organize documentation. |
61
+ | `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
62
+ | `/researcher` | Bounded codebase investigation producing a structured research artifact at `/workstream/research-*.md`. |
63
+ | `/infra-engineer` | **Interactive (main thread).** Plan and apply infrastructure changes one approved, reversible, recorded step at a time (AWS, fly.io, Supabase, Cloudflare); hands off a draft PR. Never merges. |
64
+ | `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
65
+ | `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
66
+ | `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
67
+
68
+ ### Subagents (`.claude/agents/`)
69
+
70
+ `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer`, `researcher` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
71
+
72
+ ### Orchestration model (important)
73
+
74
+ Claude Code subagents **cannot spawn other subagents** — the hierarchy is flat (main session → workers). dev-tasks is delegation-heavy, so:
75
+
76
+ - **Orchestrators run in the main thread as commands** (`/product-engineer`, `/planner`), not as subagents, so they can delegate to leaf subagents _and_ pause for the required user-approval gates. `/infra-engineer` runs in the main thread for the same reason — it pauses for one human approval per infrastructure step.
77
+ - **Step-gated approval requires the main thread.** A subagent runs to completion and only returns a summary; it cannot pause mid-run for a "yes". Use `/developer` (main thread) for interactive step-gated work; the `developer` _subagent_ is for `/planner`'s autonomous per-story delegation, which gates at the **story** boundary, not per sub-task.
78
+
79
+ ### Skills (`.claude/skills/`)
80
+
81
+ Activity skills: `activity-init`, `activity-refine`, `activity-grill` (one-question-at-a-time, depth-first interview invoked by `activity-refine` and `activity-generate-spec`, to a confirmed shared-understanding exit gate), `activity-codebase-research`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-e2e-test-implementation`, `activity-contract-test-design`, `activity-contract-validation`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-integration-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `aws-ops`, `fly-ops`, `supabase-ops`, `deploy-ops`, `ux-scaffold`, `ux-theme-gen`, `memo-cli-usage`.
82
+
83
+ `plan` and `implement` are scoped instructions on Copilot (`applyTo`) and scoped steering on Kiro (`fileMatchPattern`); as Claude skills they load on demand instead of consuming context on every matching turn.
84
+
85
+ ---
86
+
87
+ ## Domain-Specific Conventions
88
+
89
+ Copilot's `applyTo`-scoped instructions have no direct Claude Code equivalent (there is no glob-scoped auto-load), and there is no automatic Claude delivery mechanism that scaffolds a nested `CLAUDE.md` for the Next.js/React conventions (scoped to `**/*.tsx`) — no code in this repository creates one. Consumers who want those conventions to load only while working inside a React app's subtree **MUST** do it manually: copying the conventions into their app's nested `CLAUDE.md`. When generating UI, follow those conventions (wherever placed) and `/DESIGN.md`.
90
+
91
+ ---
92
+
93
+ ## File Organization
94
+
95
+ | Directory | Contents |
96
+ | --------------------- | --------------------------------------------------------------------- |
97
+ | `/docs/` | Foundation docs — product.md, tech.md, ADRs |
98
+ | `/docs/requirements/` | PRDs |
99
+ | `/workstream/` | Active feature work — specs, stories, task lists, planner state files |
100
+ | `.claude/agents/` | Subagent definitions |
101
+ | `.claude/skills/` | On-demand skills |
102
+ | `.claude/commands/` | Command entry points |
103
+ | `/mockups/` | UX mockups |