@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
@@ -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
@@ -1,297 +1,124 @@
1
1
  # dev-tasks
2
2
 
3
- A set of agents, skills, and instructions for GitHub Copilot, Claude Code, Kiro, and other AI coding agents to run structured, PRD-driven development workflows.
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
4
 
5
- ## Core Idea
5
+ ## Contracts
6
6
 
7
- This system brings structure and clarity to AI-assisted development by:
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 |
8
11
 
9
- - Defining scope with Product Requirements Documents (PRDs)
10
- - Breaking requirements into actionable, implementation-ready tasks
11
- - Guiding the AI to tackle one task at a time with checkpoints for review
12
- - Providing specialized **agents** that orchestrate the workflow end-to-end
13
- - Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
14
- - Standardizing visual design decisions through `/DESIGN.md` as the canonical UI contract
15
- - **Test-first design as the default**: `verifier` (Design Mode) produces compliance test plans before implementation, and `developer` writes tests before code
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.
16
13
 
17
- ## Design Standard Contract (DESIGN.md)
14
+ ## Taxonomy
18
15
 
19
- `/DESIGN.md` is the canonical design-system artifact for this repository.
20
-
21
- - `ux-engineer` **OWNS** `/DESIGN.md` and fills it per project via the interview-driven filling procedure. It **MUST** use `/DESIGN.md` as the primary style source for mockups.
22
- - `product-engineer` **MUST** reference `/DESIGN.md` for UI-impacting specs and stories.
23
- - `developer` **MUST** validate UI changes against `/DESIGN.md` and update it when the visual contract changes.
24
- - `planner` **MUST** require DESIGN.md compliance in UI-impacting delegated runs.
25
-
26
- If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MUST** create a baseline DESIGN.md before finalizing design-dependent outputs.
27
-
28
- ---
29
-
30
- ## Testing Standard Contract (TESTING.md)
31
-
32
- `/TESTING.md` is the canonical testing contract for a repository. It declares the layer taxonomy and what belongs at each layer, the per-package runner and commands, coverage thresholds and baseline policy, the fixture and mocking strategy, and the mandatory security-negative cases.
33
-
34
- - `qa-engineer` **OWNS** `/TESTING.md` and fills it per project via `activity-test-standards`.
35
- - `developer` **MUST** keep it current when the testing contract changes.
36
- - Agents that read it **MUST** treat an unfilled placeholder as "no standard established", never as permission.
37
- - The contract is **per-package**: a repository mixing languages (for example vitest and pytest) **MUST** be describable without forcing every package into one language's script names.
38
-
39
- It ships with dev-tasks as a placeholder and is listed in `consumer_owned_paths`, so `dev-tasks update` never overwrites a filled version.
40
-
41
- ---
42
-
43
- ## Taxonomy: Agent vs Skill vs Instruction
44
-
45
- | Concept | Purpose | Loaded When |
46
- | --------------- | ----------------------------------------------------------- | ---------------------------- |
47
- | **Agent** | Autonomous role with decision-making and handoff discipline | Invoked by name (`@agent`) |
48
- | **Skill** | Reusable on-demand capability (procedures/activities) | On demand (invoked by agent) |
49
- | **Instruction** | Scoped rule enforced automatically for matching context | Auto-applied by runtime |
50
-
51
- ---
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 |
52
21
 
53
22
  ## Agents
54
23
 
55
- | Agent | File | Purpose |
56
- | -------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
57
- | **product-engineer** | `product-engineer.agent.md` | Preparation agent — owns the full pre-coding chain: PRD, spec, stories, plan. Owns drift-reconciliation (`activity-drift-reconciliation`) for findings handed off by `developer`/`planner`. Hands off to `developer` or `planner` for execution. |
58
- | **developer** | `developer.agent.md` | Execution agent — implements code from an existing task list. Runs `implement`, including a mandatory, non-skippable `verifier` audit before every PR is marked ready. |
59
- | **planner** | `planner.agent.md` | Multi-story orchestration — dependency-ordered sequential execution with checkpoint/resume, a mandatory per-story and PRD-level rollup `verifier` audit gate, and one consolidated integration PR. |
60
- | **technical-writer** | `technical-writer.agent.md` | Autonomous documentation maintenance |
61
- | **housekeeping** | `housekeeping.agent.md` | Lint, type, and test-wiring fixes |
62
- | **github-ops** | `github-ops.agent.md` | GitHub consistency — standardizes issues, PRs, branches, labels, milestones, comments, and enforces merge authority policy |
63
- | **ux-engineer** | `ux-engineer.agent.md` | UX prototyping, DESIGN.md ownership, and gap analysis — owns `/DESIGN.md`, generates navigable screen sets at two fidelity levels (html-lite, react-full), and feeds refinements back to `product-engineer` |
64
- | **qa-engineer** | `qa-engineer.agent.md` | Quality agent — establishes the `/TESTING.md` standard, authors tests for layers the project lacks, and reports coverage and structural gaps. Invoked by `developer` at the completion gate, before the `verifier` audit |
65
- | **verifier** | `verifier.agent.md` | Verification agent — owns compliance test-plan design (`design` mode) and post-implementation grey-box fidelity auditing (`audit` mode) against codebase, `/workstream`, tests, and PRD/spec intent |
66
-
67
- `.github/agents/` and `.kiro/agents/` carry all nine agents. `.claude/agents/` carries seven by design: `planner` and `product-engineer` are orchestrators that must pause for user-approval gates, so on Claude Code they run in the main thread as `.claude/commands/` entry points rather than as subagents. See `CLAUDE.md`.
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).
68
39
 
69
40
  ## Skills
70
41
 
71
- Skills are on-demand capabilities invoked by agents — **not** loaded unless explicitly referenced.
72
-
73
42
  ### Activity Skills
74
43
 
75
- | Skill | Directory | Purpose | Primary Consumer |
76
- | ---------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
77
- | **activity-init** | `skills/activity-init/` | Establish product context and technical guidelines (mono/multi-repo/greenfield mode detection) | `product-engineer` |
78
- | **activity-refine** | `skills/activity-refine/` | Clarify scope — issue refinement or full PRD creation | `product-engineer` |
79
- | **activity-generate-spec** | `skills/activity-generate-spec/` | Transform PRD into technical specification | `product-engineer` |
80
- | **activity-generate-stories** | `skills/activity-generate-stories/` | Break spec into user stories with coverage validation | `product-engineer` |
81
- | **activity-publish-github** | `skills/activity-publish-github/` | Publish stories as GitHub Issues via MCP | `product-engineer` |
82
- | **activity-e2e-test-design** | `skills/activity-e2e-test-design/` | End-to-end black-box test scenario generation from spec/stories | `verifier` |
83
- | **activity-contract-test-design** | `skills/activity-contract-test-design/` | Consumer/provider contract and schema compatibility test strategy | `verifier` |
84
- | **activity-edge-case-refinement** | `skills/activity-edge-case-refinement/` | Systematic edge-case discovery by category with concrete examples | `verifier` |
85
- | **activity-random-test-tactics** | `skills/activity-random-test-tactics/` | Randomized, fuzz, and property-inspired test generation with reproducibility | `verifier` |
86
- | **activity-test-standards** | `skills/activity-test-standards/` | Establish and maintain `/TESTING.md`, detect harness defects, verify test-script and CI/deploy gate reachability | `qa-engineer` |
87
- | **activity-test-implementation** | `skills/activity-test-implementation/` | Author Layer 1-2 tests with enforceable boundaries and a mandatory security-negative category | `qa-engineer` |
88
- | **activity-coverage-gap-analysis** | `skills/activity-coverage-gap-analysis/` | Measure coverage against a baseline, or run risk-ranked structural gap analysis when no provider exists | `qa-engineer` |
89
- | **activity-drift-reconciliation** | `skills/activity-drift-reconciliation/` | Routes verifier drift findings into task-list/checklist expansion, new issues, or PRD/spec changelog write-back (human-confirmed) | `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 |
90
63
 
91
64
  ### Operational Skills
92
65
 
93
- | Skill | Directory | Purpose | Primary Consumer |
94
- | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
95
- | **git-ops** | `skills/git-ops/` | Branch management, rebase, merge, conflict resolution, recovery | `developer`, `planner` |
96
- | **ux-scaffold** | `skills/ux-scaffold/` | Template-aware mockup project creation with DESIGN.md-derived tokens. Supports html-lite (zero-install, navigable) and react-full (shadcn + Vite + Radix) | `ux-engineer` |
97
- | **ux-theme-gen** | `skills/ux-theme-gen/` | Generate platform-specific theme artifacts from DESIGN.md. Use when mockups or production code need consumable tokens derived from the canonical design contract | `ux-engineer`, `developer` |
98
- | **memo-cli-usage** | `skills/memo-cli-usage/` | Read and write architectural decisions to a shared Qdrant knowledge base for multi-session, multi-agent, and team-wide context continuity | `technical-writer`, `developer` |
99
-
100
- ### Third-Party Skills
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 |
101
76
 
102
- None currently vendored. Third-party skills, when added, are installed under each platform's skills directory alongside the skills above.
77
+ ## Instructions
103
78
 
104
- ## Instructions (Scoped)
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 |
105
85
 
106
- Instructions are scoped via `applyTo`/`fileMatchPattern` and auto-applied to matching files. Claude Code has no scoped-instruction mechanism, so `plan` and `implement` ship there as skills instead.
107
-
108
- | Instruction | Copilot / Kiro file | Claude equivalent | Scope | Purpose |
109
- | --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------- |
110
- | **plan** | `.github/instructions/plan.instructions.md` / `.kiro/steering/plan.md` | `.claude/skills/plan/` | `workstream/**` | Convert stories or refined issues into execution-ready task lists |
111
- | **implement** | `.github/instructions/implement.instructions.md` / `.kiro/steering/implement.md` | `.claude/skills/implement/` | `workstream/**/tasks-*.md` | Execute task list with step-gated approval, branching, and PR discipline |
112
- | **nextjs-pages-components** | `.github/instructions/domain/nextjs-pages-components.instructions.md` / `.kiro/steering/nextjs-pages-components.md` | — | `**/app/**/*.tsx` | Next.js + React conventions |
113
- | **git-guard-notice** | `.kiro/steering/git-guard-notice.md` | — | Always loaded (Kiro) | Restates the three git invariants: no push/merge to `main`, Conventional Commits, `--body-file` for `gh` bodies |
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.
114
87
 
115
88
  ## Hooks
116
89
 
117
- | Hook | Files | Purpose |
118
- | ---------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
119
- | **git-guard** | `.kiro/hooks/git-guard.json`, `.kiro/hooks/scripts/git-guard.sh`, `.claude/hooks/git-guard.sh` | Blocks pushes/merges to `main`, non-Conventional commit messages, and inline `gh --body` |
120
- | **branch-guard** | `.kiro/hooks/scripts/branch-guard.sh` | Blocks write operations while on the default branch |
121
-
122
- Hook enforcement is best-effort. Human PR review is the actual gate for these invariants.
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.
123
91
 
124
- ## Prompts
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 |
125
96
 
126
- See individual agent files for invocation modes and entry points. Reference: Copilot (`.github/prompts/`), Claude Code (`.claude/commands/`), Kiro (embedded in `.kiro/agents/`).
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.
127
98
 
128
- ---
129
-
130
- ## Agent File Format (Kiro Custom Agents)
131
-
132
- Agent files in `.kiro/agents/` use YAML frontmatter followed by a markdown body containing the system prompt. The frontmatter conforms to the [official Kiro custom agent configuration reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/).
133
-
134
- ### Frontmatter Schema
135
-
136
- ```yaml
137
- ---
138
- description: "<human-readable agent description>"
139
- tools: [<tool-tags>] # Allowed: read, write, shell, web
140
- resources: # Context files auto-loaded into the agent
141
- - file://<relative-path> # Project files (e.g., file://AGENTS.md)
142
- - skill://<glob-pattern> # Skill definitions (e.g., skill://.kiro/skills/**/SKILL.md)
143
- permissions: # (Optional) Fine-grained access control
144
- - allow: <action>
145
- paths: ["<glob>"]
146
- - deny: <action>
147
- paths: ["<glob>"]
148
- ---
149
- ```
150
-
151
- ### Field Reference
152
-
153
- | Field | Required | Description |
154
- | -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
155
- | `description` | Yes | Human-readable purpose. Used by the runtime for agent selection and routing. |
156
- | `tools` | Yes | Tag-based tool categories: `read`, `write`, `shell`, `web`. Use `["*"]` for unrestricted. |
157
- | `resources` | No | Context files auto-loaded via `file://` (project files) and `skill://` (skill definitions). |
158
- | `permissions` | No | Inline permission rules for fine-grained access control (allow/deny by path glob). **Note:** Not yet supported by the Kiro runtime as of v1.0 — presence causes agents to fail to load. |
159
- | `model` | No | Model selection override (omit to use the runtime default). |
160
- | `mcpServers` | No | Embedded MCP server configurations for tool extensions. |
161
- | `allowedTools` | No | Tools that execute without prompting (pre-approved). |
162
-
163
- ### Tool Categories
164
-
165
- | Tag | Grants Access To |
166
- | ------- | ------------------------------------- |
167
- | `read` | File reading, search, code navigation |
168
- | `write` | File creation, editing, deletion |
169
- | `shell` | Terminal command execution |
170
- | `web` | Web browsing and HTTP requests |
171
-
172
- > **Note:** `subagent` is not an official tool category. Subagent delegation is a runtime capability, not a tool permission.
173
-
174
- ### References
175
-
176
- - [Kiro Custom Agent Configuration Reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/)
177
- - [Kiro CLI v3 Agent Config](https://kiro.dev/docs/cli/v3/agent-config/)
178
- - [Sample Multi-Agent Repository](https://github.com/aws-samples/sample-kiro-cli-multiagent-development)
179
-
180
- ---
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.
181
100
 
182
101
  ## General Agent Guidelines
183
102
 
184
- All AI coding agents working in this repository **MUST**:
103
+ All agents **MUST**:
185
104
 
186
- - Always create feature branches — never commit to the default branch
105
+ - Create feature branches — never commit to default branch
187
106
  - Use Conventional Commits (`feat`, `fix`, `chore`, `docs`, etc.)
188
- - Create PRs for review — never self-merge into `main`
189
- - **PRs targeting `main` require user approval** — no agent may merge into the default branch
190
- - Follow testing, linting, and documentation standards from `technical-guidelines.md`
107
+ - Create PRs for review — never self-merge into `main`; PRs targeting `main` require user approval
108
+ - Follow standards from `tech.md`
191
109
  - Reference GitHub Issues in branch names and commits
192
- - Treat `/DESIGN.md` as the source of truth for visual tokens, components, and design guidance
193
- - Prefer `pnpm` over `npm` for JS/TS workflows
194
- - Use canonical script names: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
195
- - Enforce quality gates before completion: `test`, `lint`, `format:check`, `typecheck`, `audit`
196
- - Use the `git-ops` skill for branch management, rebase, and conflict resolution
197
- - `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate`. It **MAY** be skipped only as `SKIPPED(<reason>)` with a non-empty reason; omitting the field is treated as incomplete.
198
- - The `verifier` audit is mandatory and non-skippable before every PR is marked ready. Drift findings are non-blocking and route to `product-engineer`'s `activity-drift-reconciliation`.
199
- - **Test-first design is the default:** `product-engineer` recommends `verifier` Design Mode after planning; `developer` writes tests before implementation code; `planner` checks for test plans and enforces test-first in developer handoffs
200
- - If `memo-cli` is installed and configured: agents **MUST** read/write entries per their role (see agent files for details)
201
-
202
- ---
203
-
204
- ## Task Types
205
-
206
- ### architecture-change
207
-
208
- The `architecture-change` task type is the **only** mode that grants write authority to the meta-repo (the shared architecture/catalog repository). It enforces structural integrity of the semantic layer by restricting what can be modified, requiring formal decision records, and mandating human approval.
209
-
210
- #### Write Scope (RF-62)
211
-
212
- An `architecture-change` task **MAY** modify:
213
-
214
- - `architecture.md`
215
- - `domains.md`
216
- - `glossary.md`
217
- - `conventions.md`
218
- - `catalog/flows/` (flow definitions)
219
-
220
- An `architecture-change` task **MUST NOT** modify:
221
-
222
- - `catalog/components/*.json` — generated by CI from component-repo extraction; never hand-edited or agent-edited
223
- - `catalog/index.yaml` — generated by `dt catalog build`; never hand-edited or agent-edited
224
-
225
- #### Generated-File Prohibition
226
-
227
- `catalog/components/*.json` and `catalog/index.yaml` are **generated artifacts** produced by CI pipelines (`dt extract` and `dt catalog build`). No agent or human may edit these files directly. Changes to component metadata flow exclusively through the component-repo extraction pipeline.
228
-
229
- #### ADR Requirement
230
-
231
- Before opening any meta-repo PR under the `architecture-change` task type, the agent **MUST** produce an Architecture Decision Record (ADR) containing:
232
-
233
- - **Context:** Why the change is needed
234
- - **Decision:** What is being changed
235
- - **Consequences:** Impact on consumers, domains, or contracts
236
- - **Alternatives considered:** Other approaches evaluated and reasons for rejection
237
-
238
- The ADR **MUST** be committed as part of the PR (in the meta-repo's ADR directory).
239
-
240
- #### Human Approval Gate
241
-
242
- - PRs from the `architecture-change` task type targeting the meta-repo **REQUIRE** explicit human review and approval.
243
- - No agent may auto-merge an `architecture-change` PR into the default branch.
244
- - This aligns with the existing branch/PR discipline: PRs targeting `main` require user approval.
245
-
246
- #### Exclusion Rule (RF-64)
247
-
248
- Agents **MUST NOT** write to the meta-repo outside the `architecture-change` task type. Any attempt to modify meta-repo files (including those in the allowed write scope) outside this task type **MUST** be refused with a clear message:
249
-
250
- > "Meta-repo writes require the `architecture-change` task type. Create an architecture-change task to modify these files."
251
-
252
- This applies to all agents (`product-engineer`, `developer`, `planner`, `housekeeping`, etc.).
253
-
254
- ---
255
-
256
- ## Cross-Repo Partitioning (RF-63)
257
-
258
- When a scoping step (via `dt init --task` or manual multi-repo planning) identifies more than one `primary` component, the feature spans multiple repositories. In this case, the agent **MUST** partition the work into per-repo sub-tasks rather than treating it as a single monolithic task.
259
-
260
- ### Partitioning Procedure
261
-
262
- 1. **Detection:** If `scope.primary` contains >1 component, the feature is cross-repo and **MUST** be partitioned.
263
- 2. **One sub-task per repo:** Each `primary` component becomes its own sub-task, scoped exclusively to that component's repository.
264
- 3. **Partition proposal consumption:** 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 automated proposal is available, the agent **MUST** apply the same rules manually.
265
-
266
- ### Contract-as-Interface
267
-
268
- - Each sub-task uses the **boundary contract** (with a target version) as its interface.
269
- - Acceptance criteria for each sub-task **MUST** reference the contract definition (OpenAPI spec, AsyncAPI channel, or schema), **not** the foreign repo's internal implementation.
270
- - A sub-task is complete when it satisfies its contract obligations — it does not depend on or verify the other repo's implementation details.
271
-
272
- ### Ordering Rule
273
-
274
- Sub-tasks **MUST** be ordered **producer-before-consumers**:
275
-
276
- - The provider (producer) implements its contract first.
277
- - Consumer sub-tasks implement adaptation to the contract after the provider sub-task is complete.
278
- - This ensures the contract exists in its target form before consumers adapt to it.
279
-
280
- ### Low-Payload Elevation Guard
281
-
282
- A boundary contract with `payload_confidence: low` **MUST** be raised to at least `medium` confidence before it can serve as an acceptance boundary. This is achieved by:
283
-
284
- - Re-running extraction (`dt extract`) with improved source hints, OR
285
- - Manual confirmation of the payload shape by a human reviewer.
286
-
287
- Until the boundary contract reaches `medium` or higher confidence, the agent **MUST NOT** use it as an acceptance interface and **MUST** block the sub-task that depends on it with a clear message:
288
-
289
- > "Boundary contract `<contract-id>` has `payload_confidence: low`. Re-run extraction or manually confirm the payload shape before using it as an acceptance boundary."
290
-
291
- ### Single-Primary — No Partition
292
-
293
- When `scope.primary` contains exactly 1 component, no partitioning is needed. The feature is single-repo and proceeds with normal task planning.
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
294
121
 
295
122
  ---
296
123
 
297
- For workflow chains and sequencing diagrams, see [`docs/workflow-chains.md`](docs/workflow-chains.md). For architecture, artifacts, and invariants, see [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md). Full documentation index: [`docs/README.md`](docs/README.md).
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).