@llipe.com/dev-tasks 0.11.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 (617) hide show
  1. package/.claude/agents/developer.md +105 -43
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +24 -11
  5. package/.claude/agents/researcher.md +26 -6
  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 +44 -23
  12. package/.claude/commands/product-engineer.md +21 -9
  13. package/.claude/commands/researcher.md +4 -5
  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 +4 -11
  18. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  19. package/.claude/skills/activity-grill/SKILL.md +150 -0
  20. package/.claude/skills/activity-init/SKILL.md +121 -71
  21. package/.claude/skills/activity-refine/SKILL.md +75 -15
  22. package/.claude/skills/activity-test-standards/SKILL.md +25 -0
  23. package/.claude/skills/aws-ops/SKILL.md +155 -0
  24. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  25. package/.claude/skills/fly-ops/SKILL.md +138 -0
  26. package/.claude/skills/git-ops/SKILL.md +27 -7
  27. package/.claude/skills/implement/SKILL.md +49 -4
  28. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  29. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  30. package/.claude/skills/plan/SKILL.md +43 -1
  31. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  32. package/.github/agents/developer.agent.md +70 -19
  33. package/.github/agents/github-ops.agent.md +46 -4
  34. package/.github/agents/housekeeping.agent.md +43 -7
  35. package/.github/agents/infra-engineer.agent.md +139 -0
  36. package/.github/agents/planner.agent.md +25 -4
  37. package/.github/agents/product-engineer.agent.md +21 -9
  38. package/.github/agents/qa-engineer.agent.md +23 -11
  39. package/.github/agents/researcher.agent.md +25 -6
  40. package/.github/agents/technical-writer.agent.md +60 -6
  41. package/.github/agents/verifier.agent.md +46 -5
  42. package/.github/instructions/implement.instructions.md +49 -4
  43. package/.github/instructions/plan.instructions.md +43 -1
  44. package/.github/prompts/infra-engineer.prompt.md +12 -0
  45. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  46. package/.github/prompts/researcher.prompt.md +4 -5
  47. package/.github/prompts/technical-writer.prompt.md +1 -1
  48. package/.github/skills/activity-codebase-research/SKILL.md +4 -16
  49. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  50. package/.github/skills/activity-grill/SKILL.md +145 -0
  51. package/.github/skills/activity-init/SKILL.md +120 -70
  52. package/.github/skills/activity-refine/SKILL.md +75 -15
  53. package/.github/skills/activity-test-standards/SKILL.md +25 -0
  54. package/.github/skills/aws-ops/SKILL.md +150 -0
  55. package/.github/skills/deploy-ops/SKILL.md +116 -0
  56. package/.github/skills/fly-ops/SKILL.md +133 -0
  57. package/.github/skills/git-ops/SKILL.md +27 -7
  58. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  59. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  60. package/.github/skills/supabase-ops/SKILL.md +104 -0
  61. package/.kiro/agents/developer.md +71 -20
  62. package/.kiro/agents/github-ops.md +46 -4
  63. package/.kiro/agents/housekeeping.md +44 -8
  64. package/.kiro/agents/infra-engineer.md +102 -0
  65. package/.kiro/agents/planner.md +33 -15
  66. package/.kiro/agents/product-engineer.md +24 -12
  67. package/.kiro/agents/qa-engineer.md +24 -12
  68. package/.kiro/agents/researcher.md +26 -7
  69. package/.kiro/agents/technical-writer.md +63 -9
  70. package/.kiro/agents/verifier.md +47 -6
  71. package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
  72. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  73. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  74. package/.kiro/skills/activity-init/SKILL.md +121 -71
  75. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  76. package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
  77. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  78. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  79. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  80. package/.kiro/skills/git-ops/SKILL.md +27 -7
  81. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  82. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  83. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  84. package/.kiro/steering/implement.md +49 -4
  85. package/.kiro/steering/plan.md +43 -1
  86. package/AGENTS.md +60 -109
  87. package/AGENTS.md.template +124 -0
  88. package/CHANGELOG.md +163 -0
  89. package/CLAUDE.md +23 -18
  90. package/CLAUDE.md.template +103 -0
  91. package/README.md +168 -146
  92. package/TESTING.md +84 -148
  93. package/bundle-manifest.json +43 -2
  94. package/dist/bin/dev-tasks.js +65 -3
  95. package/dist/bin/dev-tasks.js.map +1 -1
  96. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  97. package/dist/bin/parse-args.d.ts.map +1 -0
  98. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  99. package/dist/bin/parse-args.js.map +1 -0
  100. package/dist/core/checks/decision-log-format.d.ts +44 -0
  101. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  102. package/dist/core/checks/decision-log-format.js +171 -0
  103. package/dist/core/checks/decision-log-format.js.map +1 -0
  104. package/dist/core/checks/docs-structure.d.ts +82 -0
  105. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  106. package/dist/core/checks/docs-structure.js +285 -0
  107. package/dist/core/checks/docs-structure.js.map +1 -0
  108. package/dist/core/checks/glossary.d.ts +178 -0
  109. package/dist/core/checks/glossary.d.ts.map +1 -0
  110. package/dist/core/checks/glossary.js +651 -0
  111. package/dist/core/checks/glossary.js.map +1 -0
  112. package/dist/core/checks/index.d.ts +19 -0
  113. package/dist/core/checks/index.d.ts.map +1 -0
  114. package/dist/core/checks/index.js +16 -0
  115. package/dist/core/checks/index.js.map +1 -0
  116. package/dist/core/checks/run.d.ts +22 -0
  117. package/dist/core/checks/run.d.ts.map +1 -0
  118. package/dist/core/checks/run.js +51 -0
  119. package/dist/core/checks/run.js.map +1 -0
  120. package/dist/core/distribution/doctor.d.ts +46 -1
  121. package/dist/core/distribution/doctor.d.ts.map +1 -1
  122. package/dist/core/distribution/doctor.js +161 -2
  123. package/dist/core/distribution/doctor.js.map +1 -1
  124. package/dist/core/distribution/index.d.ts +9 -3
  125. package/dist/core/distribution/index.d.ts.map +1 -1
  126. package/dist/core/distribution/index.js +5 -2
  127. package/dist/core/distribution/index.js.map +1 -1
  128. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  129. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  130. package/dist/core/distribution/install-if-absent.js +81 -0
  131. package/dist/core/distribution/install-if-absent.js.map +1 -0
  132. package/dist/core/distribution/install.d.ts.map +1 -1
  133. package/dist/core/distribution/install.js +5 -0
  134. package/dist/core/distribution/install.js.map +1 -1
  135. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  136. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  137. package/dist/core/distribution/migrate-docs.js +139 -0
  138. package/dist/core/distribution/migrate-docs.js.map +1 -0
  139. package/dist/core/distribution/profiles.d.ts +49 -0
  140. package/dist/core/distribution/profiles.d.ts.map +1 -1
  141. package/dist/core/distribution/profiles.js +45 -0
  142. package/dist/core/distribution/profiles.js.map +1 -1
  143. package/dist/core/distribution/update.d.ts +14 -0
  144. package/dist/core/distribution/update.d.ts.map +1 -1
  145. package/dist/core/distribution/update.js +77 -3
  146. package/dist/core/distribution/update.js.map +1 -1
  147. package/dist/core/distribution/workspace.d.ts +84 -0
  148. package/dist/core/distribution/workspace.d.ts.map +1 -0
  149. package/dist/core/distribution/workspace.js +276 -0
  150. package/dist/core/distribution/workspace.js.map +1 -0
  151. package/dist/core/exit-codes.d.ts +15 -35
  152. package/dist/core/exit-codes.d.ts.map +1 -1
  153. package/dist/core/exit-codes.js +15 -36
  154. package/dist/core/exit-codes.js.map +1 -1
  155. package/dist/core/index.d.ts +1 -6
  156. package/dist/core/index.d.ts.map +1 -1
  157. package/dist/core/index.js +1 -7
  158. package/dist/core/index.js.map +1 -1
  159. package/package.json +17 -32
  160. package/templates/claude/settings.json +48 -0
  161. package/templates/domain/ubiquitous-language.md +28 -0
  162. package/templates/infra/environments.yaml +16 -0
  163. package/templates/infra/redaction-patterns.txt +47 -0
  164. package/templates/runbooks/README.md +14 -0
  165. package/templates/runbooks/runbook-template.md +40 -0
  166. package/templates/scripts/deploy-status.sh +89 -0
  167. package/templates/scripts/deploy-verify.sh +85 -0
  168. package/templates/scripts/deploy.sh +284 -0
  169. package/templates/scripts/release.sh +170 -0
  170. package/templates/scripts/rollback.sh +109 -0
  171. package/templates/workflows/deploy-dev.yml +66 -0
  172. package/templates/workflows/deploy-prod.yml +66 -0
  173. package/templates/workflows/rollback.yml +77 -0
  174. package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
  175. package/.github/skills/activity-contract-validation/SKILL.md +0 -167
  176. package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
  177. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  178. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  179. package/dist/adapters/cli/catalog-build.js +0 -73
  180. package/dist/adapters/cli/catalog-build.js.map +0 -1
  181. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  182. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  183. package/dist/adapters/cli/catalog-query.js +0 -329
  184. package/dist/adapters/cli/catalog-query.js.map +0 -1
  185. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  186. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  187. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  188. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  189. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  190. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  191. package/dist/adapters/cli/catalog-validate.js +0 -122
  192. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  193. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  194. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  195. package/dist/adapters/cli/ctx-assemble.js +0 -293
  196. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  197. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  198. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  199. package/dist/adapters/cli/ctx-fetch.js +0 -267
  200. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  201. package/dist/adapters/cli/extract-all.d.ts +0 -31
  202. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  203. package/dist/adapters/cli/extract-all.js +0 -374
  204. package/dist/adapters/cli/extract-all.js.map +0 -1
  205. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  206. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  207. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  208. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  209. package/dist/adapters/cli/extract-component.d.ts +0 -24
  210. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  211. package/dist/adapters/cli/extract-component.js +0 -198
  212. package/dist/adapters/cli/extract-component.js.map +0 -1
  213. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  214. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  215. package/dist/adapters/cli/extract-detect.js +0 -98
  216. package/dist/adapters/cli/extract-detect.js.map +0 -1
  217. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  218. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  219. package/dist/adapters/cli/extract-openapi.js +0 -111
  220. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  221. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  222. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  223. package/dist/adapters/cli/extract-schema.js +0 -39
  224. package/dist/adapters/cli/extract-schema.js.map +0 -1
  225. package/dist/adapters/cli/index.d.ts +0 -6
  226. package/dist/adapters/cli/index.d.ts.map +0 -1
  227. package/dist/adapters/cli/index.js +0 -5
  228. package/dist/adapters/cli/index.js.map +0 -1
  229. package/dist/adapters/cli/init.d.ts +0 -37
  230. package/dist/adapters/cli/init.d.ts.map +0 -1
  231. package/dist/adapters/cli/init.js +0 -336
  232. package/dist/adapters/cli/init.js.map +0 -1
  233. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  234. package/dist/adapters/cli/parse-args.js.map +0 -1
  235. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  236. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  237. package/dist/adapters/cli/scope-gate.js +0 -157
  238. package/dist/adapters/cli/scope-gate.js.map +0 -1
  239. package/dist/adapters/cli/scope.d.ts +0 -26
  240. package/dist/adapters/cli/scope.d.ts.map +0 -1
  241. package/dist/adapters/cli/scope.js +0 -172
  242. package/dist/adapters/cli/scope.js.map +0 -1
  243. package/dist/adapters/cli/validate-component.d.ts +0 -24
  244. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  245. package/dist/adapters/cli/validate-component.js +0 -62
  246. package/dist/adapters/cli/validate-component.js.map +0 -1
  247. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  248. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  249. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  250. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  251. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  252. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  253. package/dist/adapters/cli/verify-drift.js +0 -103
  254. package/dist/adapters/cli/verify-drift.js.map +0 -1
  255. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  256. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  257. package/dist/adapters/cli/verify-impact.js +0 -119
  258. package/dist/adapters/cli/verify-impact.js.map +0 -1
  259. package/dist/adapters/mcp/index.d.ts +0 -5
  260. package/dist/adapters/mcp/index.d.ts.map +0 -1
  261. package/dist/adapters/mcp/index.js +0 -2
  262. package/dist/adapters/mcp/index.js.map +0 -1
  263. package/dist/bin/dt.d.ts +0 -7
  264. package/dist/bin/dt.d.ts.map +0 -1
  265. package/dist/bin/dt.js +0 -647
  266. package/dist/bin/dt.js.map +0 -1
  267. package/dist/core/catalog/build.d.ts +0 -143
  268. package/dist/core/catalog/build.d.ts.map +0 -1
  269. package/dist/core/catalog/build.js +0 -475
  270. package/dist/core/catalog/build.js.map +0 -1
  271. package/dist/core/catalog/checks/index.d.ts +0 -18
  272. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  273. package/dist/core/catalog/checks/index.js +0 -18
  274. package/dist/core/catalog/checks/index.js.map +0 -1
  275. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  276. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  277. package/dist/core/catalog/checks/v01-schema.js +0 -57
  278. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  279. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  280. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  281. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  282. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  283. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  284. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  285. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  286. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  287. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  288. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  289. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  290. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  291. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  292. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  293. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  294. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  295. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  296. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  297. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  298. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  299. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  300. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  301. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  302. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  303. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  304. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  305. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  306. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  307. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  308. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  309. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  310. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  311. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  312. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  313. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  315. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  316. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  317. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  319. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  320. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  321. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  322. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  323. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  324. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  325. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  326. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  327. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  328. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  329. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  330. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  331. package/dist/core/catalog/coverage.d.ts +0 -39
  332. package/dist/core/catalog/coverage.d.ts.map +0 -1
  333. package/dist/core/catalog/coverage.js +0 -62
  334. package/dist/core/catalog/coverage.js.map +0 -1
  335. package/dist/core/catalog/graph.d.ts +0 -49
  336. package/dist/core/catalog/graph.d.ts.map +0 -1
  337. package/dist/core/catalog/graph.js +0 -114
  338. package/dist/core/catalog/graph.js.map +0 -1
  339. package/dist/core/catalog/index-model.d.ts +0 -96
  340. package/dist/core/catalog/index-model.d.ts.map +0 -1
  341. package/dist/core/catalog/index-model.js +0 -8
  342. package/dist/core/catalog/index-model.js.map +0 -1
  343. package/dist/core/catalog/index.d.ts +0 -5
  344. package/dist/core/catalog/index.d.ts.map +0 -1
  345. package/dist/core/catalog/index.js +0 -2
  346. package/dist/core/catalog/index.js.map +0 -1
  347. package/dist/core/catalog/queries.d.ts +0 -69
  348. package/dist/core/catalog/queries.d.ts.map +0 -1
  349. package/dist/core/catalog/queries.js +0 -165
  350. package/dist/core/catalog/queries.js.map +0 -1
  351. package/dist/core/catalog/resolve.d.ts +0 -47
  352. package/dist/core/catalog/resolve.d.ts.map +0 -1
  353. package/dist/core/catalog/resolve.js +0 -318
  354. package/dist/core/catalog/resolve.js.map +0 -1
  355. package/dist/core/catalog/scaffold.d.ts +0 -31
  356. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  357. package/dist/core/catalog/scaffold.js +0 -141
  358. package/dist/core/catalog/scaffold.js.map +0 -1
  359. package/dist/core/catalog/validate-component.d.ts +0 -50
  360. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  361. package/dist/core/catalog/validate-component.js +0 -105
  362. package/dist/core/catalog/validate-component.js.map +0 -1
  363. package/dist/core/catalog/validate.d.ts +0 -71
  364. package/dist/core/catalog/validate.d.ts.map +0 -1
  365. package/dist/core/catalog/validate.js +0 -103
  366. package/dist/core/catalog/validate.js.map +0 -1
  367. package/dist/core/context/assemble.d.ts +0 -126
  368. package/dist/core/context/assemble.d.ts.map +0 -1
  369. package/dist/core/context/assemble.js +0 -197
  370. package/dist/core/context/assemble.js.map +0 -1
  371. package/dist/core/context/cache.d.ts +0 -60
  372. package/dist/core/context/cache.d.ts.map +0 -1
  373. package/dist/core/context/cache.js +0 -236
  374. package/dist/core/context/cache.js.map +0 -1
  375. package/dist/core/context/exit-codes.d.ts +0 -28
  376. package/dist/core/context/exit-codes.d.ts.map +0 -1
  377. package/dist/core/context/exit-codes.js +0 -28
  378. package/dist/core/context/exit-codes.js.map +0 -1
  379. package/dist/core/context/fetch.d.ts +0 -55
  380. package/dist/core/context/fetch.d.ts.map +0 -1
  381. package/dist/core/context/fetch.js +0 -112
  382. package/dist/core/context/fetch.js.map +0 -1
  383. package/dist/core/context/index.d.ts +0 -11
  384. package/dist/core/context/index.d.ts.map +0 -1
  385. package/dist/core/context/index.js +0 -8
  386. package/dist/core/context/index.js.map +0 -1
  387. package/dist/core/context/init.d.ts +0 -179
  388. package/dist/core/context/init.d.ts.map +0 -1
  389. package/dist/core/context/init.js +0 -532
  390. package/dist/core/context/init.js.map +0 -1
  391. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  392. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  393. package/dist/core/context/layers/architecture-layer.js +0 -24
  394. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  395. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  396. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  397. package/dist/core/context/layers/contracts-layer.js +0 -83
  398. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  399. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  400. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  401. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  402. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  403. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  404. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  405. package/dist/core/context/layers/flow-layer.js +0 -61
  406. package/dist/core/context/layers/flow-layer.js.map +0 -1
  407. package/dist/core/context/layers/index-layer.d.ts +0 -13
  408. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  409. package/dist/core/context/layers/index-layer.js +0 -77
  410. package/dist/core/context/layers/index-layer.js.map +0 -1
  411. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  412. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  413. package/dist/core/context/layers/primary-layer.js +0 -61
  414. package/dist/core/context/layers/primary-layer.js.map +0 -1
  415. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  416. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  417. package/dist/core/context/layers/secondary-layer.js +0 -52
  418. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  419. package/dist/core/context/session-lock.d.ts +0 -114
  420. package/dist/core/context/session-lock.d.ts.map +0 -1
  421. package/dist/core/context/session-lock.js +0 -90
  422. package/dist/core/context/session-lock.js.map +0 -1
  423. package/dist/core/context/tokens.d.ts +0 -35
  424. package/dist/core/context/tokens.d.ts.map +0 -1
  425. package/dist/core/context/tokens.js +0 -88
  426. package/dist/core/context/tokens.js.map +0 -1
  427. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  428. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  429. package/dist/core/extract/asyncapi/declared.js +0 -168
  430. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  431. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  432. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  433. package/dist/core/extract/asyncapi/index.js +0 -8
  434. package/dist/core/extract/asyncapi/index.js.map +0 -1
  435. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  436. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  437. package/dist/core/extract/asyncapi/payloads.js +0 -421
  438. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  439. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  440. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  441. package/dist/core/extract/asyncapi/topics.js +0 -368
  442. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  443. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  444. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  445. package/dist/core/extract/asyncapi/types.js +0 -5
  446. package/dist/core/extract/asyncapi/types.js.map +0 -1
  447. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  448. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  449. package/dist/core/extract/asyncapi/validate.js +0 -156
  450. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  451. package/dist/core/extract/component.d.ts +0 -204
  452. package/dist/core/extract/component.d.ts.map +0 -1
  453. package/dist/core/extract/component.js +0 -258
  454. package/dist/core/extract/component.js.map +0 -1
  455. package/dist/core/extract/detect.d.ts +0 -35
  456. package/dist/core/extract/detect.d.ts.map +0 -1
  457. package/dist/core/extract/detect.js +0 -89
  458. package/dist/core/extract/detect.js.map +0 -1
  459. package/dist/core/extract/index.d.ts +0 -12
  460. package/dist/core/extract/index.d.ts.map +0 -1
  461. package/dist/core/extract/index.js +0 -6
  462. package/dist/core/extract/index.js.map +0 -1
  463. package/dist/core/extract/ladder.d.ts +0 -79
  464. package/dist/core/extract/ladder.d.ts.map +0 -1
  465. package/dist/core/extract/ladder.js +0 -70
  466. package/dist/core/extract/ladder.js.map +0 -1
  467. package/dist/core/extract/openapi/index.d.ts +0 -43
  468. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  469. package/dist/core/extract/openapi/index.js +0 -142
  470. package/dist/core/extract/openapi/index.js.map +0 -1
  471. package/dist/core/extract/openapi/route1.d.ts +0 -36
  472. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  473. package/dist/core/extract/openapi/route1.js +0 -333
  474. package/dist/core/extract/openapi/route1.js.map +0 -1
  475. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  476. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  477. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  478. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  479. package/dist/core/extract/openapi/route2.d.ts +0 -69
  480. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  481. package/dist/core/extract/openapi/route2.js +0 -211
  482. package/dist/core/extract/openapi/route2.js.map +0 -1
  483. package/dist/core/extract/openapi/route3.d.ts +0 -26
  484. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  485. package/dist/core/extract/openapi/route3.js +0 -737
  486. package/dist/core/extract/openapi/route3.js.map +0 -1
  487. package/dist/core/extract/openapi/types.d.ts +0 -125
  488. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  489. package/dist/core/extract/openapi/types.js +0 -5
  490. package/dist/core/extract/openapi/types.js.map +0 -1
  491. package/dist/core/extract/openapi/validate.d.ts +0 -29
  492. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  493. package/dist/core/extract/openapi/validate.js +0 -200
  494. package/dist/core/extract/openapi/validate.js.map +0 -1
  495. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  496. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  497. package/dist/core/extract/orm/drizzle.js +0 -283
  498. package/dist/core/extract/orm/drizzle.js.map +0 -1
  499. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  500. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  501. package/dist/core/extract/orm/information-schema.js +0 -142
  502. package/dist/core/extract/orm/information-schema.js.map +0 -1
  503. package/dist/core/extract/orm/prisma.d.ts +0 -23
  504. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  505. package/dist/core/extract/orm/prisma.js +0 -234
  506. package/dist/core/extract/orm/prisma.js.map +0 -1
  507. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  508. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  509. package/dist/core/extract/orm/typeorm.js +0 -269
  510. package/dist/core/extract/orm/typeorm.js.map +0 -1
  511. package/dist/core/extract/orm/types.d.ts +0 -97
  512. package/dist/core/extract/orm/types.d.ts.map +0 -1
  513. package/dist/core/extract/orm/types.js +0 -6
  514. package/dist/core/extract/orm/types.js.map +0 -1
  515. package/dist/core/extract/prompt.d.ts +0 -21
  516. package/dist/core/extract/prompt.d.ts.map +0 -1
  517. package/dist/core/extract/prompt.js +0 -79
  518. package/dist/core/extract/prompt.js.map +0 -1
  519. package/dist/core/extract/provider.d.ts +0 -121
  520. package/dist/core/extract/provider.d.ts.map +0 -1
  521. package/dist/core/extract/provider.js +0 -6
  522. package/dist/core/extract/provider.js.map +0 -1
  523. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  524. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  525. package/dist/core/extract/providers/node-ts.js +0 -320
  526. package/dist/core/extract/providers/node-ts.js.map +0 -1
  527. package/dist/core/extract/render/schema-md.d.ts +0 -16
  528. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  529. package/dist/core/extract/render/schema-md.js +0 -140
  530. package/dist/core/extract/render/schema-md.js.map +0 -1
  531. package/dist/core/extract/report.d.ts +0 -125
  532. package/dist/core/extract/report.d.ts.map +0 -1
  533. package/dist/core/extract/report.js +0 -52
  534. package/dist/core/extract/report.js.map +0 -1
  535. package/dist/core/extract/schema.d.ts +0 -34
  536. package/dist/core/extract/schema.d.ts.map +0 -1
  537. package/dist/core/extract/schema.js +0 -146
  538. package/dist/core/extract/schema.js.map +0 -1
  539. package/dist/core/extract/workspaces.d.ts +0 -33
  540. package/dist/core/extract/workspaces.d.ts.map +0 -1
  541. package/dist/core/extract/workspaces.js +0 -193
  542. package/dist/core/extract/workspaces.js.map +0 -1
  543. package/dist/core/providers/index.d.ts +0 -6
  544. package/dist/core/providers/index.d.ts.map +0 -1
  545. package/dist/core/providers/index.js +0 -2
  546. package/dist/core/providers/index.js.map +0 -1
  547. package/dist/core/providers/tracker.d.ts +0 -74
  548. package/dist/core/providers/tracker.d.ts.map +0 -1
  549. package/dist/core/providers/tracker.js +0 -38
  550. package/dist/core/providers/tracker.js.map +0 -1
  551. package/dist/core/scope/calibration.d.ts +0 -25
  552. package/dist/core/scope/calibration.d.ts.map +0 -1
  553. package/dist/core/scope/calibration.js +0 -52
  554. package/dist/core/scope/calibration.js.map +0 -1
  555. package/dist/core/scope/closure.d.ts +0 -31
  556. package/dist/core/scope/closure.d.ts.map +0 -1
  557. package/dist/core/scope/closure.js +0 -68
  558. package/dist/core/scope/closure.js.map +0 -1
  559. package/dist/core/scope/gate.d.ts +0 -41
  560. package/dist/core/scope/gate.d.ts.map +0 -1
  561. package/dist/core/scope/gate.js +0 -165
  562. package/dist/core/scope/gate.js.map +0 -1
  563. package/dist/core/scope/index.d.ts +0 -18
  564. package/dist/core/scope/index.d.ts.map +0 -1
  565. package/dist/core/scope/index.js +0 -12
  566. package/dist/core/scope/index.js.map +0 -1
  567. package/dist/core/scope/partition.d.ts +0 -36
  568. package/dist/core/scope/partition.d.ts.map +0 -1
  569. package/dist/core/scope/partition.js +0 -78
  570. package/dist/core/scope/partition.js.map +0 -1
  571. package/dist/core/scope/prompt.d.ts +0 -39
  572. package/dist/core/scope/prompt.d.ts.map +0 -1
  573. package/dist/core/scope/prompt.js +0 -123
  574. package/dist/core/scope/prompt.js.map +0 -1
  575. package/dist/core/scope/scoping.d.ts +0 -52
  576. package/dist/core/scope/scoping.d.ts.map +0 -1
  577. package/dist/core/scope/scoping.js +0 -99
  578. package/dist/core/scope/scoping.js.map +0 -1
  579. package/dist/core/scope/types.d.ts +0 -77
  580. package/dist/core/scope/types.d.ts.map +0 -1
  581. package/dist/core/scope/types.js +0 -5
  582. package/dist/core/scope/types.js.map +0 -1
  583. package/dist/core/scope/validate.d.ts +0 -47
  584. package/dist/core/scope/validate.d.ts.map +0 -1
  585. package/dist/core/scope/validate.js +0 -90
  586. package/dist/core/scope/validate.js.map +0 -1
  587. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  588. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  589. package/dist/core/verify/asyncapi-diff.js +0 -209
  590. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  591. package/dist/core/verify/contract-diff.d.ts +0 -39
  592. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  593. package/dist/core/verify/contract-diff.js +0 -63
  594. package/dist/core/verify/contract-diff.js.map +0 -1
  595. package/dist/core/verify/drift.d.ts +0 -47
  596. package/dist/core/verify/drift.d.ts.map +0 -1
  597. package/dist/core/verify/drift.js +0 -122
  598. package/dist/core/verify/drift.js.map +0 -1
  599. package/dist/core/verify/impact.d.ts +0 -22
  600. package/dist/core/verify/impact.d.ts.map +0 -1
  601. package/dist/core/verify/impact.js +0 -93
  602. package/dist/core/verify/impact.js.map +0 -1
  603. package/dist/core/verify/index.d.ts +0 -10
  604. package/dist/core/verify/index.d.ts.map +0 -1
  605. package/dist/core/verify/index.js +0 -9
  606. package/dist/core/verify/index.js.map +0 -1
  607. package/dist/core/verify/openapi-diff.d.ts +0 -29
  608. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  609. package/dist/core/verify/openapi-diff.js +0 -291
  610. package/dist/core/verify/openapi-diff.js.map +0 -1
  611. package/dist/core/verify/types.d.ts +0 -138
  612. package/dist/core/verify/types.d.ts.map +0 -1
  613. package/dist/core/verify/types.js +0 -5
  614. package/dist/core/verify/types.js.map +0 -1
  615. package/schemas/component.schema.json +0 -203
  616. package/schemas/flow.schema.json +0 -75
  617. package/schemas/scope-output.schema.json +0 -62
@@ -65,7 +65,7 @@ The task list **MUST** follow this structure:
65
65
 
66
66
  - [ ] 1.0 Implement Story [ID]: [Story Title] (or: Implement Issue [#] - [Github_Issue_URL]: [Title])
67
67
 
68
- - [ ] 1.1 [First implementation step]
68
+ - [ ] 1.1 [First implementation step] (D-NN, when traceable — omit otherwise)
69
69
  - [ ] 1.2 [Second implementation step]
70
70
  - [ ] 1.x Verify Acceptance Criterion: [Criterion 1]
71
71
  - [ ] 1.y Verify Acceptance Criterion: [Criterion 2]
@@ -74,8 +74,48 @@ The task list **MUST** follow this structure:
74
74
  - [ ] 2.0 Implement Story [ID]: [Story Title] (or: Implement Issue [#] - [Github_Issue_URL]: [Title])
75
75
  - [ ] 2.1 [First implementation step]
76
76
  - ...
77
+
78
+ ## Decisions Consumed
79
+
80
+ | ID | Decision (short form) |
81
+ | ---- | --------------------- |
82
+ | D-NN | … |
77
83
  ```
78
84
 
85
+ ## Decision Citations
86
+
87
+ A task line that derives from a specific decision cites it inline, at the
88
+ end of the line: `- [ ] 3.2 Add cap-reached prompt (D-55)` (FR-16).
89
+
90
+ - Citations reference the feature's own `decisions-<feature>.md` by
91
+ unqualified `D-NN` — a task list belongs to exactly one feature, so the
92
+ qualified `<feature>#D-NN` form `activity-refine`/`activity-generate-spec`
93
+ use for cross-feature reuse is never needed here.
94
+ - This is **additive only**: a task with no traceable decision cites none.
95
+ You **MUST NOT** fabricate a citation to give a task one.
96
+ - The task list closes with a `## Decisions Consumed` section aggregating
97
+ every decision ID cited anywhere in the list, in the same `ID | Decision
98
+ (short form)` table shape the decision log itself uses. A task list that
99
+ cites no decisions still includes the section, empty (header plus
100
+ table skeleton, no rows) — consistent with how `activity-refine`'s and
101
+ `activity-generate-spec`'s own `## Decisions` sections may legitimately
102
+ be empty.
103
+
104
+ ## Package Attribution
105
+
106
+ Every task **MUST** name the package it changes (FR-63), so a reader can
107
+ tell the blast radius from the task list without opening the diff.
108
+
109
+ - Read the package map in `docs/tech.md` for the package list.
110
+ - Write the package in the sub-task text, in brackets, first:
111
+ `- [ ] 1.1 [@acme/api] Add the token-refresh endpoint`.
112
+ - A sub-task touching several packages lists them all. A sub-task that
113
+ touches _most_ packages is usually the wrong size — split it.
114
+ - In a **single-package repository the bracket is omitted**, not left
115
+ empty. It is optional there, never blank.
116
+ - Non-code tasks (docs, workflow files) that belong to no package use
117
+ `[repo root]`.
118
+
79
119
  ## Conversion Guidelines
80
120
 
81
121
  When converting a **User Story** or **Refined Issue** to a **Parent Task**:
@@ -94,6 +134,7 @@ When converting a **User Story** or **Refined Issue** to a **Parent Task**:
94
134
  - If schema or data-model changes are involved, migration tasks are **required by default**; omission is allowed only with an explicit documented opt-out rationale.
95
135
  - Migration flows **MUST** include: create migration artifact, document rollback/impact, request user confirmation before apply, apply migration after confirmation, and verify applied state.
96
136
  - If the story involves data models, you **SHOULD** include a sub-task to generate seed data.
137
+ - When `workstream/decisions-<feature>.md` exists, you **MUST** cite the decision ID inline (`… (D-NN)`) on any sub-task whose approach or scope traces to a specific decision row, and **MUST** populate the closing `## Decisions Consumed` section with every ID cited anywhere in the list. This is additive only — a sub-task with no traceable decision cites none; do not fabricate a citation.
97
138
 
98
139
  3. **Context:** You **MAY** add a `> Note:` block under the parent task for quick reference (User Story text or Business Rules), but the checkbox structure **MUST** remain clean.
99
140
  4. **Relevant Files:** You **MUST** aggregate all "Files to Create/Modify" from selected stories into the top-level `Relevant Files` section.
@@ -139,6 +180,7 @@ If this is a **greenfield project** or a **new component**, you **MUST** include
139
180
  5. You **MUST** ensure all Implementation Steps, Acceptance Criteria, and Testing requirements are preserved as sub-tasks.
140
181
  6. For JS/TS repositories, you **MUST** prefer `pnpm` commands and canonical script names in generated tasks.
141
182
  7. You **MUST** ensure each task includes both implementation and test/validation steps, including edge-case validation.
183
+ 7a. When a decision log exists for the feature, you **MUST** cite the decision ID inline on any traceable sub-task and populate the closing `## Decisions Consumed` section (FR-16) — additively, never fabricated.
142
184
  8. For schema/data-model changes, you **MUST** include migration lifecycle tasks and an explicit user-confirmation gate before applying migrations unless an opt-out rationale is documented.
143
185
  9. You **MUST** update the corresponding GitHub Issue(s) with the task checklist by delegating to `github-ops` whenever possible. If no issue exists, you **MUST** ask the user whether to create one first.
144
186
  10. You **MUST** save the task list file.
package/AGENTS.md CHANGED
@@ -21,53 +21,58 @@ If `/DESIGN.md` is missing and scope includes UI work, agents **MUST** create a
21
21
 
22
22
  ## Agents
23
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. |
30
- | **housekeeping** | Lint, type, and test-wiring fixes. |
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
-
37
- Platform coverage: `.github/agents/` and `.kiro/agents/` carry all ten. `.claude/agents/` carries eight — `planner` and `product-engineer` run as `.claude/commands/` (need user-approval gates).
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).
38
39
 
39
40
  ## Skills
40
41
 
41
42
  ### Activity Skills
42
43
 
43
- | Skill | Purpose | Consumer |
44
- | ---------------------------------------- | --------------------------------------------------------- | ---------------- |
45
- | activity-init | Establish product context and technical guidelines | product-engineer |
46
- | activity-refine | Issue refinement or full PRD creation | product-engineer |
47
- | activity-codebase-research | Bounded codebase investigation with structured artifact | researcher |
48
- | activity-generate-spec | PRD to technical specification | product-engineer |
49
- | activity-generate-stories | Spec to user stories with coverage validation | product-engineer |
50
- | activity-publish-github | Publish stories as GitHub Issues | product-engineer |
51
- | activity-e2e-test-design | E2E scenario generation from spec/stories | verifier |
52
- | activity-contract-test-design | Contract and schema compatibility test strategy | verifier |
53
- | activity-edge-case-refinement | Systematic edge-case discovery | verifier |
54
- | activity-random-test-tactics | Randomized/fuzz/property test generation | verifier |
55
- | activity-test-standards | Establish/maintain TESTING.md, detect harness defects | qa-engineer |
56
- | activity-test-implementation | Author Layer 1-2 tests with security-negative category | qa-engineer |
57
- | activity-integration-test-implementation | Layer 2.5 tests against real databases | qa-engineer |
58
- | activity-e2e-test-implementation | Playwright E2E from verifier scenario tables | qa-engineer |
59
- | activity-contract-validation | API contract drift/breaking-change detection | qa-engineer |
60
- | activity-coverage-gap-analysis | Coverage measurement or structural gap analysis | qa-engineer |
61
- | activity-drift-reconciliation | Route drift findings to task expansion or spec write-back | product-engineer |
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 |
62
63
 
63
64
  ### Operational Skills
64
65
 
65
- | Skill | Purpose | Consumer |
66
- | -------------- | ----------------------------------------------------- | --------------------------- |
67
- | git-ops | Branch management, rebase, merge, conflict resolution | developer, planner |
68
- | ux-scaffold | Mockup project creation (html-lite, react-full) | ux-engineer |
69
- | ux-theme-gen | Generate theme artifacts from DESIGN.md | ux-engineer, developer |
70
- | memo-cli-usage | Read/write decisions to shared knowledge base | technical-writer, developer |
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 |
71
76
 
72
77
  ## Instructions
73
78
 
@@ -78,14 +83,20 @@ Platform coverage: `.github/agents/` and `.kiro/agents/` carry all ten. `.claude
78
83
  | nextjs-pages-components | `**/app/**/*.tsx` | Next.js + React conventions |
79
84
  | git-guard-notice | Always (Kiro) | Git invariants reminder |
80
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
+
81
88
  ## Hooks
82
89
 
83
- | Hook | Purpose |
84
- | ------------ | ---------------------------------------------------------------------------- |
85
- | git-guard | Blocks pushes/merges to `main`, non-Conventional commits, inline `gh --body` |
86
- | branch-guard | Blocks write operations on default branch |
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.
87
98
 
88
- Hook enforcement is best-effort. Human PR review is the actual gate.
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.
89
100
 
90
101
  ## General Agent Guidelines
91
102
 
@@ -94,7 +105,7 @@ All agents **MUST**:
94
105
  - Create feature branches — never commit to default branch
95
106
  - Use Conventional Commits (`feat`, `fix`, `chore`, `docs`, etc.)
96
107
  - Create PRs for review — never self-merge into `main`; PRs targeting `main` require user approval
97
- - Follow standards from `technical-guidelines.md`
108
+ - Follow standards from `tech.md`
98
109
  - Reference GitHub Issues in branch names and commits
99
110
  - Prefer `pnpm` over `npm`; use canonical scripts: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
100
111
  - Enforce quality gates before completion
@@ -103,70 +114,10 @@ All agents **MUST**:
103
114
  - Run `verifier` audit (mandatory, non-skippable) before PR is ready; drift findings route to `product-engineer`
104
115
  - Follow test-first design: write tests before implementation code
105
116
  - If `memo-cli` is available: read/write entries per role
106
-
107
- ---
108
-
109
- ## Task Types
110
-
111
- ### architecture-change
112
-
113
- The only mode granting write authority to the meta-repo. Agents **MUST NOT** write to the meta-repo outside this task type — applies to `product-engineer`, `developer`, `planner`, `housekeeping`, and all others.
114
-
115
- #### Write Scope (RF-62)
116
-
117
- **MAY** modify: `architecture.md`, `domains.md`, `glossary.md`, `conventions.md`, `catalog/flows/`.
118
-
119
- **MUST NOT** modify: `catalog/components/*.json`, `catalog/index.yaml` — generated by CI (`dt extract` and `dt catalog build`), never hand-edited or agent-edited.
120
-
121
- #### Generated-File Prohibition
122
-
123
- `catalog/components/*.json` and `catalog/index.yaml` are generated by CI pipelines. No agent or human may edit these files directly.
124
-
125
- #### ADR Requirement
126
-
127
- Before opening any meta-repo PR under this task type, the agent **MUST** produce an Architecture Decision Record (ADR) containing: **Context** (why), **Decision** (what), **Consequences** (impact), and **Alternatives considered** (rejected approaches). The ADR **MUST** be committed as part of the PR.
128
-
129
- #### Human Approval Gate
130
-
131
- PRs from this task type targeting the meta-repo **REQUIRE** explicit human review and approval. No agent may auto-merge an `architecture-change` PR into the default branch.
132
-
133
- #### Exclusion Rule (RF-64)
134
-
135
- Agents **MUST NOT** write to the meta-repo outside the `architecture-change` task type. Refuse with:
136
-
137
- > "Meta-repo writes require the `architecture-change` task type. Create an architecture-change task to modify these files."
138
-
139
- ---
140
-
141
- ## Cross-Repo Partitioning (RF-63)
142
-
143
- When a scoping step identifies more than one `primary` component, the feature spans multiple repositories and the agent **MUST** partition the work into per-repo sub-tasks.
144
-
145
- ### Partitioning Procedure
146
-
147
- 1. **Detection:** If `scope.primary` contains >1 component, partition is **REQUIRED**.
148
- 2. **One sub-task per repo:** Each `primary` component becomes its own sub-task, scoped exclusively to that component's repository.
149
- 3. **Partition proposal:** When a partition proposal is available from `dt scope gate` (G1 abort, exit 7), the agent **SHOULD** use it as the basis for the partition. When no proposal exists, the agent **MUST** apply the same rules manually.
150
-
151
- ### Contract-as-Interface
152
-
153
- Each sub-task uses the **boundary contract** (with a target version) as its interface. Acceptance criteria **MUST** reference the contract definition, **not** the foreign repo's internal implementation.
154
-
155
- ### Ordering Rule
156
-
157
- Sub-tasks **MUST** be ordered producer-before-consumers: the provider (producer) implements its contract first. Consumer sub-tasks implement adaptation to the contract after the provider sub-task is complete.
158
-
159
- ### Low-Payload Elevation Guard
160
-
161
- A boundary contract with `payload_confidence: low` **MUST** be raised to at least `medium` before use as an acceptance boundary. This is achieved by Re-running extraction (`dt extract`) with improved source hints, or Manual confirmation of the payload shape by a human reviewer.
162
-
163
- Until elevated, the agent **MUST NOT** use it as an acceptance interface and **MUST** block the sub-task with:
164
-
165
- > "Boundary contract `<contract-id>` has `payload_confidence: low`. Re-run extraction or manually confirm the payload shape before using it as an acceptance boundary."
166
-
167
- ### Single-Primary — No Partition
168
-
169
- When `scope.primary` contains exactly 1 component, no partitioning is needed. The feature is single-repo and proceeds normally.
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
170
121
 
171
122
  ---
172
123
 
@@ -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,169 @@ 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
+
8
171
  ## [0.11.0] - 2026-08-25
9
172
 
10
173
  ### Added