@llipe.com/dev-tasks 0.11.0 → 0.16.2

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 (618) hide show
  1. package/.claude/agents/developer.md +138 -62
  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 +64 -7
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +63 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +98 -29
  12. package/.claude/commands/product-engineer.md +69 -11
  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 +573 -24
  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 +61 -12
  28. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  29. package/.claude/skills/memo-cli-usage/SKILL.md +68 -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 +103 -38
  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 +79 -10
  37. package/.github/agents/product-engineer.agent.md +69 -11
  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 +63 -7
  41. package/.github/agents/verifier.agent.md +61 -5
  42. package/.github/instructions/implement.instructions.md +61 -12
  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 +68 -13
  60. package/.github/skills/supabase-ops/SKILL.md +104 -0
  61. package/.kiro/agents/developer.md +104 -39
  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 +87 -21
  66. package/.kiro/agents/product-engineer.md +72 -14
  67. package/.kiro/agents/qa-engineer.md +24 -12
  68. package/.kiro/agents/researcher.md +26 -7
  69. package/.kiro/agents/technical-writer.md +66 -10
  70. package/.kiro/agents/verifier.md +62 -6
  71. package/.kiro/hooks/scripts/git-guard.sh +96 -10
  72. package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
  73. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  74. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  75. package/.kiro/skills/activity-init/SKILL.md +121 -71
  76. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  77. package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
  78. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  79. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  80. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  81. package/.kiro/skills/git-ops/SKILL.md +27 -7
  82. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  83. package/.kiro/skills/memo-cli-usage/SKILL.md +68 -13
  84. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  85. package/.kiro/steering/implement.md +61 -12
  86. package/.kiro/steering/plan.md +43 -1
  87. package/AGENTS.md +67 -114
  88. package/AGENTS.md.template +126 -0
  89. package/CHANGELOG.md +182 -0
  90. package/CLAUDE.md +25 -19
  91. package/CLAUDE.md.template +104 -0
  92. package/README.md +168 -146
  93. package/TESTING.md +84 -148
  94. package/bundle-manifest.json +43 -2
  95. package/dist/bin/dev-tasks.js +65 -3
  96. package/dist/bin/dev-tasks.js.map +1 -1
  97. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  98. package/dist/bin/parse-args.d.ts.map +1 -0
  99. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  100. package/dist/bin/parse-args.js.map +1 -0
  101. package/dist/core/checks/decision-log-format.d.ts +44 -0
  102. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  103. package/dist/core/checks/decision-log-format.js +171 -0
  104. package/dist/core/checks/decision-log-format.js.map +1 -0
  105. package/dist/core/checks/docs-structure.d.ts +82 -0
  106. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  107. package/dist/core/checks/docs-structure.js +285 -0
  108. package/dist/core/checks/docs-structure.js.map +1 -0
  109. package/dist/core/checks/glossary.d.ts +178 -0
  110. package/dist/core/checks/glossary.d.ts.map +1 -0
  111. package/dist/core/checks/glossary.js +651 -0
  112. package/dist/core/checks/glossary.js.map +1 -0
  113. package/dist/core/checks/index.d.ts +19 -0
  114. package/dist/core/checks/index.d.ts.map +1 -0
  115. package/dist/core/checks/index.js +16 -0
  116. package/dist/core/checks/index.js.map +1 -0
  117. package/dist/core/checks/run.d.ts +22 -0
  118. package/dist/core/checks/run.d.ts.map +1 -0
  119. package/dist/core/checks/run.js +51 -0
  120. package/dist/core/checks/run.js.map +1 -0
  121. package/dist/core/distribution/doctor.d.ts +46 -1
  122. package/dist/core/distribution/doctor.d.ts.map +1 -1
  123. package/dist/core/distribution/doctor.js +161 -2
  124. package/dist/core/distribution/doctor.js.map +1 -1
  125. package/dist/core/distribution/index.d.ts +9 -3
  126. package/dist/core/distribution/index.d.ts.map +1 -1
  127. package/dist/core/distribution/index.js +5 -2
  128. package/dist/core/distribution/index.js.map +1 -1
  129. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  130. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  131. package/dist/core/distribution/install-if-absent.js +81 -0
  132. package/dist/core/distribution/install-if-absent.js.map +1 -0
  133. package/dist/core/distribution/install.d.ts.map +1 -1
  134. package/dist/core/distribution/install.js +5 -0
  135. package/dist/core/distribution/install.js.map +1 -1
  136. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  137. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  138. package/dist/core/distribution/migrate-docs.js +139 -0
  139. package/dist/core/distribution/migrate-docs.js.map +1 -0
  140. package/dist/core/distribution/profiles.d.ts +49 -0
  141. package/dist/core/distribution/profiles.d.ts.map +1 -1
  142. package/dist/core/distribution/profiles.js +45 -0
  143. package/dist/core/distribution/profiles.js.map +1 -1
  144. package/dist/core/distribution/update.d.ts +14 -0
  145. package/dist/core/distribution/update.d.ts.map +1 -1
  146. package/dist/core/distribution/update.js +77 -3
  147. package/dist/core/distribution/update.js.map +1 -1
  148. package/dist/core/distribution/workspace.d.ts +84 -0
  149. package/dist/core/distribution/workspace.d.ts.map +1 -0
  150. package/dist/core/distribution/workspace.js +276 -0
  151. package/dist/core/distribution/workspace.js.map +1 -0
  152. package/dist/core/exit-codes.d.ts +15 -35
  153. package/dist/core/exit-codes.d.ts.map +1 -1
  154. package/dist/core/exit-codes.js +15 -36
  155. package/dist/core/exit-codes.js.map +1 -1
  156. package/dist/core/index.d.ts +1 -6
  157. package/dist/core/index.d.ts.map +1 -1
  158. package/dist/core/index.js +1 -7
  159. package/dist/core/index.js.map +1 -1
  160. package/package.json +17 -32
  161. package/templates/claude/settings.json +48 -0
  162. package/templates/domain/ubiquitous-language.md +28 -0
  163. package/templates/infra/environments.yaml +16 -0
  164. package/templates/infra/redaction-patterns.txt +47 -0
  165. package/templates/runbooks/README.md +14 -0
  166. package/templates/runbooks/runbook-template.md +40 -0
  167. package/templates/scripts/deploy-status.sh +89 -0
  168. package/templates/scripts/deploy-verify.sh +85 -0
  169. package/templates/scripts/deploy.sh +284 -0
  170. package/templates/scripts/release.sh +170 -0
  171. package/templates/scripts/rollback.sh +109 -0
  172. package/templates/workflows/deploy-dev.yml +66 -0
  173. package/templates/workflows/deploy-prod.yml +66 -0
  174. package/templates/workflows/rollback.yml +77 -0
  175. package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
  176. package/.github/skills/activity-contract-validation/SKILL.md +0 -167
  177. package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
  178. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  179. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  180. package/dist/adapters/cli/catalog-build.js +0 -73
  181. package/dist/adapters/cli/catalog-build.js.map +0 -1
  182. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  183. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  184. package/dist/adapters/cli/catalog-query.js +0 -329
  185. package/dist/adapters/cli/catalog-query.js.map +0 -1
  186. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  187. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  189. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  190. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  191. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.js +0 -122
  193. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  194. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  195. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.js +0 -293
  197. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  198. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  199. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.js +0 -267
  201. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  202. package/dist/adapters/cli/extract-all.d.ts +0 -31
  203. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  204. package/dist/adapters/cli/extract-all.js +0 -374
  205. package/dist/adapters/cli/extract-all.js.map +0 -1
  206. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  207. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  209. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  210. package/dist/adapters/cli/extract-component.d.ts +0 -24
  211. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  212. package/dist/adapters/cli/extract-component.js +0 -198
  213. package/dist/adapters/cli/extract-component.js.map +0 -1
  214. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  215. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  216. package/dist/adapters/cli/extract-detect.js +0 -98
  217. package/dist/adapters/cli/extract-detect.js.map +0 -1
  218. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  219. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.js +0 -111
  221. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  222. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  223. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  224. package/dist/adapters/cli/extract-schema.js +0 -39
  225. package/dist/adapters/cli/extract-schema.js.map +0 -1
  226. package/dist/adapters/cli/index.d.ts +0 -6
  227. package/dist/adapters/cli/index.d.ts.map +0 -1
  228. package/dist/adapters/cli/index.js +0 -5
  229. package/dist/adapters/cli/index.js.map +0 -1
  230. package/dist/adapters/cli/init.d.ts +0 -37
  231. package/dist/adapters/cli/init.d.ts.map +0 -1
  232. package/dist/adapters/cli/init.js +0 -336
  233. package/dist/adapters/cli/init.js.map +0 -1
  234. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  235. package/dist/adapters/cli/parse-args.js.map +0 -1
  236. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  237. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  238. package/dist/adapters/cli/scope-gate.js +0 -157
  239. package/dist/adapters/cli/scope-gate.js.map +0 -1
  240. package/dist/adapters/cli/scope.d.ts +0 -26
  241. package/dist/adapters/cli/scope.d.ts.map +0 -1
  242. package/dist/adapters/cli/scope.js +0 -172
  243. package/dist/adapters/cli/scope.js.map +0 -1
  244. package/dist/adapters/cli/validate-component.d.ts +0 -24
  245. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  246. package/dist/adapters/cli/validate-component.js +0 -62
  247. package/dist/adapters/cli/validate-component.js.map +0 -1
  248. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  249. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  251. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  252. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  253. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  254. package/dist/adapters/cli/verify-drift.js +0 -103
  255. package/dist/adapters/cli/verify-drift.js.map +0 -1
  256. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  257. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  258. package/dist/adapters/cli/verify-impact.js +0 -119
  259. package/dist/adapters/cli/verify-impact.js.map +0 -1
  260. package/dist/adapters/mcp/index.d.ts +0 -5
  261. package/dist/adapters/mcp/index.d.ts.map +0 -1
  262. package/dist/adapters/mcp/index.js +0 -2
  263. package/dist/adapters/mcp/index.js.map +0 -1
  264. package/dist/bin/dt.d.ts +0 -7
  265. package/dist/bin/dt.d.ts.map +0 -1
  266. package/dist/bin/dt.js +0 -647
  267. package/dist/bin/dt.js.map +0 -1
  268. package/dist/core/catalog/build.d.ts +0 -143
  269. package/dist/core/catalog/build.d.ts.map +0 -1
  270. package/dist/core/catalog/build.js +0 -475
  271. package/dist/core/catalog/build.js.map +0 -1
  272. package/dist/core/catalog/checks/index.d.ts +0 -18
  273. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  274. package/dist/core/catalog/checks/index.js +0 -18
  275. package/dist/core/catalog/checks/index.js.map +0 -1
  276. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  277. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.js +0 -57
  279. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  280. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  281. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  283. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  284. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  285. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  287. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  288. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  289. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  291. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  292. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  293. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  295. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  296. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  297. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  299. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  300. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  301. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  303. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  304. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  305. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  307. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  308. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  309. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  311. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  312. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  313. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  316. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  317. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  320. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  321. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  323. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  324. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  325. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  327. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  328. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  329. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  331. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  332. package/dist/core/catalog/coverage.d.ts +0 -39
  333. package/dist/core/catalog/coverage.d.ts.map +0 -1
  334. package/dist/core/catalog/coverage.js +0 -62
  335. package/dist/core/catalog/coverage.js.map +0 -1
  336. package/dist/core/catalog/graph.d.ts +0 -49
  337. package/dist/core/catalog/graph.d.ts.map +0 -1
  338. package/dist/core/catalog/graph.js +0 -114
  339. package/dist/core/catalog/graph.js.map +0 -1
  340. package/dist/core/catalog/index-model.d.ts +0 -96
  341. package/dist/core/catalog/index-model.d.ts.map +0 -1
  342. package/dist/core/catalog/index-model.js +0 -8
  343. package/dist/core/catalog/index-model.js.map +0 -1
  344. package/dist/core/catalog/index.d.ts +0 -5
  345. package/dist/core/catalog/index.d.ts.map +0 -1
  346. package/dist/core/catalog/index.js +0 -2
  347. package/dist/core/catalog/index.js.map +0 -1
  348. package/dist/core/catalog/queries.d.ts +0 -69
  349. package/dist/core/catalog/queries.d.ts.map +0 -1
  350. package/dist/core/catalog/queries.js +0 -165
  351. package/dist/core/catalog/queries.js.map +0 -1
  352. package/dist/core/catalog/resolve.d.ts +0 -47
  353. package/dist/core/catalog/resolve.d.ts.map +0 -1
  354. package/dist/core/catalog/resolve.js +0 -318
  355. package/dist/core/catalog/resolve.js.map +0 -1
  356. package/dist/core/catalog/scaffold.d.ts +0 -31
  357. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  358. package/dist/core/catalog/scaffold.js +0 -141
  359. package/dist/core/catalog/scaffold.js.map +0 -1
  360. package/dist/core/catalog/validate-component.d.ts +0 -50
  361. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  362. package/dist/core/catalog/validate-component.js +0 -105
  363. package/dist/core/catalog/validate-component.js.map +0 -1
  364. package/dist/core/catalog/validate.d.ts +0 -71
  365. package/dist/core/catalog/validate.d.ts.map +0 -1
  366. package/dist/core/catalog/validate.js +0 -103
  367. package/dist/core/catalog/validate.js.map +0 -1
  368. package/dist/core/context/assemble.d.ts +0 -126
  369. package/dist/core/context/assemble.d.ts.map +0 -1
  370. package/dist/core/context/assemble.js +0 -197
  371. package/dist/core/context/assemble.js.map +0 -1
  372. package/dist/core/context/cache.d.ts +0 -60
  373. package/dist/core/context/cache.d.ts.map +0 -1
  374. package/dist/core/context/cache.js +0 -236
  375. package/dist/core/context/cache.js.map +0 -1
  376. package/dist/core/context/exit-codes.d.ts +0 -28
  377. package/dist/core/context/exit-codes.d.ts.map +0 -1
  378. package/dist/core/context/exit-codes.js +0 -28
  379. package/dist/core/context/exit-codes.js.map +0 -1
  380. package/dist/core/context/fetch.d.ts +0 -55
  381. package/dist/core/context/fetch.d.ts.map +0 -1
  382. package/dist/core/context/fetch.js +0 -112
  383. package/dist/core/context/fetch.js.map +0 -1
  384. package/dist/core/context/index.d.ts +0 -11
  385. package/dist/core/context/index.d.ts.map +0 -1
  386. package/dist/core/context/index.js +0 -8
  387. package/dist/core/context/index.js.map +0 -1
  388. package/dist/core/context/init.d.ts +0 -179
  389. package/dist/core/context/init.d.ts.map +0 -1
  390. package/dist/core/context/init.js +0 -532
  391. package/dist/core/context/init.js.map +0 -1
  392. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  393. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.js +0 -24
  395. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  396. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  397. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.js +0 -83
  399. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  400. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  401. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  403. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  404. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  405. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  406. package/dist/core/context/layers/flow-layer.js +0 -61
  407. package/dist/core/context/layers/flow-layer.js.map +0 -1
  408. package/dist/core/context/layers/index-layer.d.ts +0 -13
  409. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  410. package/dist/core/context/layers/index-layer.js +0 -77
  411. package/dist/core/context/layers/index-layer.js.map +0 -1
  412. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  413. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  414. package/dist/core/context/layers/primary-layer.js +0 -61
  415. package/dist/core/context/layers/primary-layer.js.map +0 -1
  416. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  417. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.js +0 -52
  419. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  420. package/dist/core/context/session-lock.d.ts +0 -114
  421. package/dist/core/context/session-lock.d.ts.map +0 -1
  422. package/dist/core/context/session-lock.js +0 -90
  423. package/dist/core/context/session-lock.js.map +0 -1
  424. package/dist/core/context/tokens.d.ts +0 -35
  425. package/dist/core/context/tokens.d.ts.map +0 -1
  426. package/dist/core/context/tokens.js +0 -88
  427. package/dist/core/context/tokens.js.map +0 -1
  428. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  429. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.js +0 -168
  431. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  432. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  433. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  434. package/dist/core/extract/asyncapi/index.js +0 -8
  435. package/dist/core/extract/asyncapi/index.js.map +0 -1
  436. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  437. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.js +0 -421
  439. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  440. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  441. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.js +0 -368
  443. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  444. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  445. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  446. package/dist/core/extract/asyncapi/types.js +0 -5
  447. package/dist/core/extract/asyncapi/types.js.map +0 -1
  448. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  449. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.js +0 -156
  451. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  452. package/dist/core/extract/component.d.ts +0 -204
  453. package/dist/core/extract/component.d.ts.map +0 -1
  454. package/dist/core/extract/component.js +0 -258
  455. package/dist/core/extract/component.js.map +0 -1
  456. package/dist/core/extract/detect.d.ts +0 -35
  457. package/dist/core/extract/detect.d.ts.map +0 -1
  458. package/dist/core/extract/detect.js +0 -89
  459. package/dist/core/extract/detect.js.map +0 -1
  460. package/dist/core/extract/index.d.ts +0 -12
  461. package/dist/core/extract/index.d.ts.map +0 -1
  462. package/dist/core/extract/index.js +0 -6
  463. package/dist/core/extract/index.js.map +0 -1
  464. package/dist/core/extract/ladder.d.ts +0 -79
  465. package/dist/core/extract/ladder.d.ts.map +0 -1
  466. package/dist/core/extract/ladder.js +0 -70
  467. package/dist/core/extract/ladder.js.map +0 -1
  468. package/dist/core/extract/openapi/index.d.ts +0 -43
  469. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  470. package/dist/core/extract/openapi/index.js +0 -142
  471. package/dist/core/extract/openapi/index.js.map +0 -1
  472. package/dist/core/extract/openapi/route1.d.ts +0 -36
  473. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  474. package/dist/core/extract/openapi/route1.js +0 -333
  475. package/dist/core/extract/openapi/route1.js.map +0 -1
  476. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  477. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  479. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  480. package/dist/core/extract/openapi/route2.d.ts +0 -69
  481. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  482. package/dist/core/extract/openapi/route2.js +0 -211
  483. package/dist/core/extract/openapi/route2.js.map +0 -1
  484. package/dist/core/extract/openapi/route3.d.ts +0 -26
  485. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  486. package/dist/core/extract/openapi/route3.js +0 -737
  487. package/dist/core/extract/openapi/route3.js.map +0 -1
  488. package/dist/core/extract/openapi/types.d.ts +0 -125
  489. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  490. package/dist/core/extract/openapi/types.js +0 -5
  491. package/dist/core/extract/openapi/types.js.map +0 -1
  492. package/dist/core/extract/openapi/validate.d.ts +0 -29
  493. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  494. package/dist/core/extract/openapi/validate.js +0 -200
  495. package/dist/core/extract/openapi/validate.js.map +0 -1
  496. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  497. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  498. package/dist/core/extract/orm/drizzle.js +0 -283
  499. package/dist/core/extract/orm/drizzle.js.map +0 -1
  500. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  501. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  502. package/dist/core/extract/orm/information-schema.js +0 -142
  503. package/dist/core/extract/orm/information-schema.js.map +0 -1
  504. package/dist/core/extract/orm/prisma.d.ts +0 -23
  505. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  506. package/dist/core/extract/orm/prisma.js +0 -234
  507. package/dist/core/extract/orm/prisma.js.map +0 -1
  508. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  509. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  510. package/dist/core/extract/orm/typeorm.js +0 -269
  511. package/dist/core/extract/orm/typeorm.js.map +0 -1
  512. package/dist/core/extract/orm/types.d.ts +0 -97
  513. package/dist/core/extract/orm/types.d.ts.map +0 -1
  514. package/dist/core/extract/orm/types.js +0 -6
  515. package/dist/core/extract/orm/types.js.map +0 -1
  516. package/dist/core/extract/prompt.d.ts +0 -21
  517. package/dist/core/extract/prompt.d.ts.map +0 -1
  518. package/dist/core/extract/prompt.js +0 -79
  519. package/dist/core/extract/prompt.js.map +0 -1
  520. package/dist/core/extract/provider.d.ts +0 -121
  521. package/dist/core/extract/provider.d.ts.map +0 -1
  522. package/dist/core/extract/provider.js +0 -6
  523. package/dist/core/extract/provider.js.map +0 -1
  524. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  525. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  526. package/dist/core/extract/providers/node-ts.js +0 -320
  527. package/dist/core/extract/providers/node-ts.js.map +0 -1
  528. package/dist/core/extract/render/schema-md.d.ts +0 -16
  529. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  530. package/dist/core/extract/render/schema-md.js +0 -140
  531. package/dist/core/extract/render/schema-md.js.map +0 -1
  532. package/dist/core/extract/report.d.ts +0 -125
  533. package/dist/core/extract/report.d.ts.map +0 -1
  534. package/dist/core/extract/report.js +0 -52
  535. package/dist/core/extract/report.js.map +0 -1
  536. package/dist/core/extract/schema.d.ts +0 -34
  537. package/dist/core/extract/schema.d.ts.map +0 -1
  538. package/dist/core/extract/schema.js +0 -146
  539. package/dist/core/extract/schema.js.map +0 -1
  540. package/dist/core/extract/workspaces.d.ts +0 -33
  541. package/dist/core/extract/workspaces.d.ts.map +0 -1
  542. package/dist/core/extract/workspaces.js +0 -193
  543. package/dist/core/extract/workspaces.js.map +0 -1
  544. package/dist/core/providers/index.d.ts +0 -6
  545. package/dist/core/providers/index.d.ts.map +0 -1
  546. package/dist/core/providers/index.js +0 -2
  547. package/dist/core/providers/index.js.map +0 -1
  548. package/dist/core/providers/tracker.d.ts +0 -74
  549. package/dist/core/providers/tracker.d.ts.map +0 -1
  550. package/dist/core/providers/tracker.js +0 -38
  551. package/dist/core/providers/tracker.js.map +0 -1
  552. package/dist/core/scope/calibration.d.ts +0 -25
  553. package/dist/core/scope/calibration.d.ts.map +0 -1
  554. package/dist/core/scope/calibration.js +0 -52
  555. package/dist/core/scope/calibration.js.map +0 -1
  556. package/dist/core/scope/closure.d.ts +0 -31
  557. package/dist/core/scope/closure.d.ts.map +0 -1
  558. package/dist/core/scope/closure.js +0 -68
  559. package/dist/core/scope/closure.js.map +0 -1
  560. package/dist/core/scope/gate.d.ts +0 -41
  561. package/dist/core/scope/gate.d.ts.map +0 -1
  562. package/dist/core/scope/gate.js +0 -165
  563. package/dist/core/scope/gate.js.map +0 -1
  564. package/dist/core/scope/index.d.ts +0 -18
  565. package/dist/core/scope/index.d.ts.map +0 -1
  566. package/dist/core/scope/index.js +0 -12
  567. package/dist/core/scope/index.js.map +0 -1
  568. package/dist/core/scope/partition.d.ts +0 -36
  569. package/dist/core/scope/partition.d.ts.map +0 -1
  570. package/dist/core/scope/partition.js +0 -78
  571. package/dist/core/scope/partition.js.map +0 -1
  572. package/dist/core/scope/prompt.d.ts +0 -39
  573. package/dist/core/scope/prompt.d.ts.map +0 -1
  574. package/dist/core/scope/prompt.js +0 -123
  575. package/dist/core/scope/prompt.js.map +0 -1
  576. package/dist/core/scope/scoping.d.ts +0 -52
  577. package/dist/core/scope/scoping.d.ts.map +0 -1
  578. package/dist/core/scope/scoping.js +0 -99
  579. package/dist/core/scope/scoping.js.map +0 -1
  580. package/dist/core/scope/types.d.ts +0 -77
  581. package/dist/core/scope/types.d.ts.map +0 -1
  582. package/dist/core/scope/types.js +0 -5
  583. package/dist/core/scope/types.js.map +0 -1
  584. package/dist/core/scope/validate.d.ts +0 -47
  585. package/dist/core/scope/validate.d.ts.map +0 -1
  586. package/dist/core/scope/validate.js +0 -90
  587. package/dist/core/scope/validate.js.map +0 -1
  588. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  589. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.js +0 -209
  591. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  592. package/dist/core/verify/contract-diff.d.ts +0 -39
  593. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  594. package/dist/core/verify/contract-diff.js +0 -63
  595. package/dist/core/verify/contract-diff.js.map +0 -1
  596. package/dist/core/verify/drift.d.ts +0 -47
  597. package/dist/core/verify/drift.d.ts.map +0 -1
  598. package/dist/core/verify/drift.js +0 -122
  599. package/dist/core/verify/drift.js.map +0 -1
  600. package/dist/core/verify/impact.d.ts +0 -22
  601. package/dist/core/verify/impact.d.ts.map +0 -1
  602. package/dist/core/verify/impact.js +0 -93
  603. package/dist/core/verify/impact.js.map +0 -1
  604. package/dist/core/verify/index.d.ts +0 -10
  605. package/dist/core/verify/index.d.ts.map +0 -1
  606. package/dist/core/verify/index.js +0 -9
  607. package/dist/core/verify/index.js.map +0 -1
  608. package/dist/core/verify/openapi-diff.d.ts +0 -29
  609. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  610. package/dist/core/verify/openapi-diff.js +0 -291
  611. package/dist/core/verify/openapi-diff.js.map +0 -1
  612. package/dist/core/verify/types.d.ts +0 -138
  613. package/dist/core/verify/types.d.ts.map +0 -1
  614. package/dist/core/verify/types.js +0 -5
  615. package/dist/core/verify/types.js.map +0 -1
  616. package/schemas/component.schema.json +0 -203
  617. package/schemas/flow.schema.json +0 -75
  618. package/schemas/scope-output.schema.json +0 -62
package/README.md CHANGED
@@ -8,18 +8,17 @@ A set of agents, skills, and instructions for GitHub Copilot, Claude Code, Kiro,
8
8
 
9
9
  ### 1. Install the package
10
10
 
11
+ Use npm to install the [dev-tasks package](https://www.npmjs.com/package/@llipe.com/dev-tasks/).
12
+
11
13
  ```bash
12
14
  pnpm add -g @llipe.com/dev-tasks
13
15
  ```
14
16
 
15
- This gives you two binaries:
16
-
17
- | Binary | Stability | Purpose |
18
- | ----------- | ------------ | ------------------------------------------------------- |
19
- | `dev-tasks` | **Stable** | Bootstrap: install agent files, update, status, migrate |
20
- | `dt` | **Unstable** | Runtime: extract repo metadata, build context |
17
+ This gives you one binary:
21
18
 
22
- > **⚠️ `dt` is unstable** — recommended for testing purposes only. The extraction pipeline, manifest format, and CLI surface may change without notice between releases. The rest of dev-tasks (agents, skills, instructions, `dev-tasks` CLI) is available for use.
19
+ | Binary | Stability | Purpose |
20
+ | ----------- | ---------- | ------------------------------------------------------- |
21
+ | `dev-tasks` | **Stable** | Bootstrap: install agent files, update, status, migrate |
23
22
 
24
23
  ### 2. Install agent workflow files into your repo
25
24
 
@@ -39,16 +38,50 @@ dev-tasks install --profile kiro # .kiro/ only
39
38
  dev-tasks install --profile both # copilot + claude only
40
39
  ```
41
40
 
42
- ### 3. Initialize your project context
41
+ **What each profile delivers, beyond the platform-specific agent/skill/command directories:**
42
+
43
+ | Profile | Root context files delivered |
44
+ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
+ | `copilot` | `DESIGN.md`, `TESTING.md` (install-if-absent for consumer-owned files not covered here — see below) |
46
+ | `claude` | `DESIGN.md`, `TESTING.md`, plus `CLAUDE.md` and `AGENTS.md` — project memory Claude Code loads on every turn, and the shared agent/skill registry it imports. Delivered install-if-absent: written on a fresh install, never overwritten once you fill them in |
47
+ | `kiro` | `DESIGN.md`, `TESTING.md` — Kiro's equivalent standing guidance ships as always-on steering (`.kiro/steering/git-guard-notice.md`) rather than a root file |
48
+ | `both` / `all` | Union of the profiles above |
49
+
50
+ `DESIGN.md` and `TESTING.md` install unconditionally on every run (they are canonical contract documents, not consumer-authored memory). `CLAUDE.md`, `AGENTS.md`, and `.claude/settings.json` use install-if-absent semantics instead: delivered once, then fully consumer-owned, so `install` and `update` never clobber content you've customized.
51
+
52
+ ### 3. Configure branch protection (required, not optional)
53
+
54
+ The `git-guard`/`branch-guard` hooks (Claude Code) and their Kiro equivalents are **advisory, best-effort, local checks** — defense-in-depth, not the actual gate. They are text/JSON pattern matching over a tool call and can always be evaded by a sufficiently creative command or tool-input shape; Copilot has no hook system at all. The only control that is server-side and unbypassable by any tool surface (`gh` CLI, raw `git`, or an MCP server) is a **GitHub branch protection rule** on the repository's default branch. Configure it before relying on any agent to work in this repository:
55
+
56
+ - Require a pull request before merging
57
+ - Require at least 1 approving review
58
+ - Require status checks to pass before merging
59
+ - Disable force-pushes to the default branch
60
+ - Disable branch deletion for the default branch
61
+
62
+ ```bash
63
+ gh api repos/<owner>/<repo>/branches/<default-branch>/protection \
64
+ --method PUT \
65
+ -f required_pull_request_reviews.required_approving_review_count=1 \
66
+ -F required_status_checks='{"strict":true,"contexts":[]}' \
67
+ -F enforce_admins=true \
68
+ -F restrictions=null \
69
+ -F allow_force_pushes=false \
70
+ -F allow_deletions=false
71
+ ```
72
+
73
+ Or configure it via **Settings → Branches → Branch protection rules** in the GitHub UI. Run this once per repository, immediately after installing dev-tasks.
74
+
75
+ ### 4. Initialize your project context
43
76
 
44
77
  Invoke the `product-engineer` agent in Init Mode (via `@product-engineer` or the `product-engineer-init` prompt). This creates:
45
78
 
46
- - `docs/product-context.md` — what your product is and who it's for
47
- - `docs/technical-guidelines.md` — stack, conventions, and constraints
79
+ - `docs/product.md` — what your product is and who it's for
80
+ - `docs/tech.md` — stack, conventions, and constraints
48
81
 
49
82
  Run this once per project.
50
83
 
51
- ### 4. Build a feature
84
+ ### 5. Build a feature
52
85
 
53
86
  ```text
54
87
  a) Invoke @product-engineer with a feature description or GitHub issue number
@@ -58,7 +91,7 @@ b) Invoke @developer with the task list path
58
91
  → implements, tests, and opens a PR
59
92
  ```
60
93
 
61
- ### 5. Keep files up to date
94
+ ### 6. Keep files up to date
62
95
 
63
96
  ```bash
64
97
  dev-tasks update # reconcile with hash-based conflict detection
@@ -68,85 +101,30 @@ dev-tasks status # compare installed vs latest version
68
101
 
69
102
  ---
70
103
 
71
- ## Using `dt` for Multi-Repo Context _(Unstable — testing only)_
72
-
73
- > **⚠️ Unstable:** The `dt` command is under active development and recommended for testing purposes only. APIs, flags, output formats, and exit codes may change between releases.
74
-
75
- `dt` extracts repository metadata (schema, OpenAPI, AsyncAPI), derives a `component.json` manifest with provenance and confidence tracking, and builds cross-repo context for agent sessions.
76
-
77
- ### Extract metadata from a repo
78
-
79
- ```bash
80
- cd my-service
81
-
82
- # Run the full extraction pipeline
83
- dt extract all --interactive
84
-
85
- # Or run individual extractors
86
- dt extract detect # stack, framework, ORM, messaging
87
- dt extract schema # database schema from ORM definitions
88
- dt extract openapi # OpenAPI spec (copy existing or AST inference)
89
- dt extract asyncapi # AsyncAPI spec from Kafka topic patterns
90
- dt extract component # derive component.json manifest
91
- ```
92
-
93
- ### Review outputs
94
-
95
- ```bash
96
- cat component.json # manifest with _provenance metadata
97
- cat extraction_report.json # coverage, confidence, unresolved items
98
- ```
104
+ ## `dev-tasks` CLI Reference
99
105
 
100
- ### Validate a manifest (offline, no network access)
101
-
102
- ```bash
103
- dt validate-component component.json # exit 0 valid, exit 4 invalid
104
- dt validate-component component.json --json # structured error list
105
- ```
106
-
107
- ### Typical workflow
108
-
109
- ```bash
110
- dt extract all --interactive
111
- dt validate-component component.json
112
- git add component.json contracts/ docs/schema.md extraction_report.json
113
- git commit -m "feat: add component manifest via dt extract"
114
- ```
115
-
116
- ### Artifact formats
117
-
118
- For which artifacts are JSON vs YAML, and which are generated vs hand-written, see [`docs/artifact-formats.md`](docs/artifact-formats.md). Generated artifacts (`catalog/index.yaml`, `catalog/components/`) are never hand-edited.
119
-
120
- ### CLI documentation
121
-
122
- - **`dev-tasks` (bootstrap/distribution):** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
123
- - **`dt` (extraction/catalog/context):** [`docs/dt-user-manual.md`](docs/dt-user-manual.md) — extract, catalog, context, scope
124
- - **Architecture and artifacts:** [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md)
106
+ - **CLI documentation:** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
107
+ - **Architecture and artifacts:** [`docs/system-overview.md`](docs/system-overview.md)
125
108
  - **Everything else:** [`docs/README.md`](docs/README.md)
126
109
 
127
110
  ### Global options
128
111
 
129
- | Flag | Description |
130
- | -------------------- | ---------------------------- |
131
- | `--json` | Machine-readable JSON output |
132
- | `--meta-repo <path>` | Path or URL to the meta-repo |
133
- | `-v` | Verbose diagnostics (stderr) |
112
+ | Flag | Description |
113
+ | -------- | ---------------------------- |
114
+ | `--json` | Machine-readable JSON output |
115
+ | `-v` | Verbose diagnostics (stderr) |
134
116
 
135
117
  ### Exit codes
136
118
 
137
- Both binaries share one exit-code table. Common cases:
138
-
139
- | Code | Meaning |
140
- | ---- | ------------------------------------------------- |
141
- | 0 | OK |
142
- | 1 | Unexpected error |
143
- | 2 | Incorrect usage |
144
- | 7 | Gate aborted (scope gate G1–G4) |
145
- | 8 | Breaking contract change detected |
146
- | 13 | Incomplete extraction: required fields unresolved |
147
- | 14 | Reconciliation conflict (edited fields) |
119
+ | Code | Meaning |
120
+ | ---- | --------------------------------------- |
121
+ | 0 | Success |
122
+ | 1 | Unexpected error |
123
+ | 2 | Incorrect usage |
124
+ | 11 | Dependency check failed (`doctor`) |
125
+ | 14 | Reconciliation conflict (edited fields) |
148
126
 
149
- Full table with all 15 codes: [`docs/data-model.md`](docs/data-model.md#exit-code-contract).
127
+ Full contract, including retirement history for codes no longer in use: [`core/exit-codes.ts`](core/exit-codes.ts).
150
128
 
151
129
  ---
152
130
 
@@ -158,8 +136,9 @@ dev-tasks update [--force] # Reconcile with hash-based conflict detec
158
136
  dev-tasks status # Compare installed/pinned/latest versions
159
137
  dev-tasks pin <version> # Pin to a specific version
160
138
  dev-tasks unpin # Remove the version pin
161
- dev-tasks doctor # Check Node ≥20, git ≥2.37, cache writable
139
+ dev-tasks doctor # Check Node ≥24, git ≥2.37, cache writable
162
140
  dev-tasks migrate # Migrate from legacy shell-script install
141
+ dev-tasks migrate docs [--force] # Rename the foundation docs to their current names
163
142
  ```
164
143
 
165
144
  ### Version Pinning
@@ -183,6 +162,46 @@ dev-tasks unpin # Remove the pin (update will use the local package versi
183
162
 
184
163
  `update` never overwrites a locally modified managed file without `--force`; it reports the conflict and exits `14`.
185
164
 
165
+ ### Foundation Document Migration
166
+
167
+ The two foundation documents were renamed:
168
+
169
+ | Before | After |
170
+ | ------------------------------ | ----------------- |
171
+ | `docs/product-context.md` | `docs/product.md` |
172
+ | `docs/technical-guidelines.md` | `docs/tech.md` |
173
+
174
+ Nothing breaks if you do not migrate. Agents resolve the new name first and
175
+ fall back to the old one, so a repository installed before the rename keeps
176
+ working — they will just propose this command when they encounter an old name.
177
+ `dev-tasks doctor` reports the old names as a **warning**, not a failure, for
178
+ the same reason: it is telling you the migration is available, not that
179
+ anything is broken. Your exit code stays `0`.
180
+
181
+ `dev-tasks migrate docs` is **report-only**. It prints the pending renames and
182
+ the files of your own that still reference the old names, and changes nothing:
183
+
184
+ ```bash
185
+ dev-tasks migrate docs # Show what would change
186
+ dev-tasks migrate docs --force # Perform the renames
187
+ ```
188
+
189
+ `--force` renames the files with their content unchanged, after copying the
190
+ originals into `.dev-tasks/backup/<timestamp>/`. A rename whose target already
191
+ exists is skipped rather than overwritten — if you half-migrated by hand, your
192
+ file stays — and the command exits `14` so the skip is visible to a script.
193
+ Both forms accept `--json`.
194
+
195
+ Files you own are yours to update. The command reports which of them still
196
+ name the old documents; it does not edit them, and neither does
197
+ `dev-tasks update`.
198
+
199
+ **Note the asymmetry with the bare `migrate` command.** `dev-tasks migrate`
200
+ (no sub-verb) migrates a legacy shell-script install and applies its change
201
+ immediately. `dev-tasks migrate docs` proposes by default. The difference is
202
+ deliberate: `migrate` shipped with that behavior, and quietly turning it into
203
+ a dry run would break anyone already scripting it.
204
+
186
205
  ---
187
206
 
188
207
  ## The Core Idea
@@ -217,13 +236,13 @@ This system brings structure and clarity to AI-assisted development by:
217
236
 
218
237
  Agents are autonomous personas that orchestrate skills and activities.
219
238
 
220
- > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). Copilot and Kiro define all 9 agents below. On Claude Code, the two orchestrators (`planner`, `product-engineer`) run in the main thread as `/commands` so they can pause for approval gates; the other 7 are subagents.
239
+ > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). Copilot and Kiro define all 11 agents below. On Claude Code, the two orchestrators (`planner`, `product-engineer`) and `infra-engineer` run in the main thread as `/commands` so they can pause for approval gates (per-phase for the orchestrators, per-step for `infra-engineer`); the other 8 are subagents.
221
240
 
222
241
  ### `product-engineer`
223
242
 
224
243
  Preparation agent — owns the full pre-coding chain:
225
244
 
226
- - **Init Mode**: `activity-init` → product-context.md + technical-guidelines.md
245
+ - **Init Mode**: `activity-init` → product.md + tech.md
227
246
  - **Feature Mode**: `activity-refine` → `activity-generate-spec` → `activity-generate-stories` → `activity-publish-github` → `plan`
228
247
  - **Issue Mode**: `activity-refine` → `plan`
229
248
 
@@ -249,15 +268,16 @@ Multi-story orchestration with checkpoint/resume:
249
268
 
250
269
  ### Other Agents
251
270
 
252
- | Agent | Purpose |
253
- | ------------------ | ------------------------------------------------------------------------------- |
254
- | `ux-engineer` | PRD/SPEC-to-screen visualization (lite/full), DESIGN.md ownership, gap analysis |
255
- | `technical-writer` | Documentation maintenance |
256
- | `housekeeping` | Lint, type, and test-wiring fixes |
257
- | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
258
- | `verifier` | Compliance test-plan design and fidelity auditing |
259
- | `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
260
- | `researcher` | Bounded codebase investigation producing structured research artifacts |
271
+ | Agent | Purpose |
272
+ | ------------------ | ----------------------------------------------------------------------------------------------- |
273
+ | `ux-engineer` | PRD/SPEC-to-screen visualization (lite/full), DESIGN.md ownership, gap analysis |
274
+ | `technical-writer` | Documentation maintenance |
275
+ | `housekeeping` | Lint, type, and test-wiring fixes |
276
+ | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
277
+ | `verifier` | Compliance test-plan design and fidelity auditing |
278
+ | `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
279
+ | `researcher` | Bounded codebase investigation producing structured research artifacts |
280
+ | `infra-engineer` | Approval-gated, reversible, recorded infrastructure changes (AWS, fly.io, Supabase, Cloudflare) |
261
281
 
262
282
  ---
263
283
 
@@ -265,25 +285,29 @@ Multi-story orchestration with checkpoint/resume:
265
285
 
266
286
  On-demand capabilities loaded only when invoked.
267
287
 
268
- | Skill | Purpose | Consumer |
269
- | -------------------------------- | ------------------------------------------------------- | --------------------------------------------------- |
270
- | `activity-init` | Product context and technical guidelines | `product-engineer` |
271
- | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
272
- | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
273
- | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
274
- | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
275
- | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
276
- | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
277
- | `ux-scaffold` | Template-aware mockup generation (lite/full) | `ux-engineer` |
278
- | `ux-theme-gen` | DESIGN.md → theme artifacts (CSS vars, Tailwind v4, RN) | `ux-engineer`, `developer` |
279
- | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
280
- | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
281
- | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
282
- | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
283
- | `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
284
- | `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
285
- | `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
286
- | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
288
+ | Skill | Purpose | Consumer |
289
+ | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
290
+ | `activity-init` | Product context and technical guidelines | `product-engineer` |
291
+ | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
292
+ | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
293
+ | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
294
+ | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
295
+ | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
296
+ | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
297
+ | `aws-ops` | AWS CLI command sets, tiers, cost, backup/revert, logs | `infra-engineer` |
298
+ | `fly-ops` | flyctl command sets, tiers, cost, backup/revert, logs | `infra-engineer` |
299
+ | `supabase-ops` | Supabase CLI sets, `db diff` flow, drift rule, logs | `infra-engineer` |
300
+ | `deploy-ops` | Deploy script contract, env mapping, tag policy, and workflow scaffolding (`templates/scripts/`, `templates/workflows/`) | `infra-engineer` |
301
+ | `ux-scaffold` | Template-aware mockup generation (lite/full) | `ux-engineer` |
302
+ | `ux-theme-gen` | DESIGN.md → theme artifacts (CSS vars, Tailwind v4, RN) | `ux-engineer`, `developer` |
303
+ | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
304
+ | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
305
+ | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
306
+ | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
307
+ | `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
308
+ | `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
309
+ | `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
310
+ | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
287
311
 
288
312
  ---
289
313
 
@@ -302,7 +326,7 @@ Copilot reads `.github/instructions/*.instructions.md`, Kiro reads `.kiro/steeri
302
326
 
303
327
  ### Hooks
304
328
 
305
- `git-guard` blocks pushes and merges to `main`, non-Conventional commit messages, and inline `gh --body`. `branch-guard` blocks write operations while on the default branch. Both are best-effort; human PR review is the actual gate.
329
+ Kiro (`.kiro/hooks/`) and Claude Code (`.claude/hooks/`, wired via `.claude/settings.json`) both ship two deterministic `PreToolUse` hooks; Copilot has no hook system. `git-guard` matches shell (`Bash`/terminal) commands and blocks pushes and merges into the default branch (resolved dynamically — `master`/`trunk` repos are protected identically to `main`), including `gh pr merge` with its base resolved via `gh pr view` (not a `--base` text check, which doesn't exist on that subcommand), `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the resolved base is the default branch, and the raw-git escape of merging a story/issue branch straight into an integration branch, plus non-Conventional commit messages, inline `gh --body`, and human-only tags. `branch-guard` matches file-write tools (`Edit`/`Write`/`NotebookEdit` on Claude Code) and blocks write operations while on the default branch. Both hooks fail open on unexpected errors — except `git-guard`'s PR-base lookup, which fails **closed** (blocks the merge) if `gh pr view` can't verify the base, since an unverified base could be the default branch. Human PR review is the actual gate.
306
330
 
307
331
  ---
308
332
 
@@ -310,21 +334,22 @@ Copilot reads `.github/instructions/*.instructions.md`, Kiro reads `.kiro/steeri
310
334
 
311
335
  > Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
312
336
 
313
- | Prompt | Agent | Purpose |
314
- | -------------------------- | ---------------- | ---------------------------------- |
315
- | `product-engineer-init` | product-engineer | Initialize foundation documents |
316
- | `product-engineer-feature` | product-engineer | Design and plan a feature |
317
- | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
318
- | `developer-execute` | developer | Execute an existing task list |
319
- | `planner` | planner | Orchestrate multi-story execution |
320
- | `planner-resume` | planner | Resume from checkpoint |
321
- | `ux-engineer` | ux-engineer | Generate UX mockups |
322
- | `github-ops` | github-ops | GitHub consistency |
323
- | `technical-writer` | technical-writer | Documentation maintenance |
324
- | `housekeeping` | housekeeping | Lint, type, test fixes |
325
- | `qa-engineer` | qa-engineer | Testing standard and coverage gate |
326
- | `verifier-design` | verifier | Generate compliance test plan |
327
- | `verifier-audit` | verifier | Grey-box fidelity audit |
337
+ | Prompt | Agent | Purpose |
338
+ | -------------------------- | ---------------- | ------------------------------------- |
339
+ | `product-engineer-init` | product-engineer | Initialize foundation documents |
340
+ | `product-engineer-feature` | product-engineer | Design and plan a feature |
341
+ | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
342
+ | `developer-execute` | developer | Execute an existing task list |
343
+ | `planner` | planner | Orchestrate multi-story execution |
344
+ | `planner-resume` | planner | Resume from checkpoint |
345
+ | `ux-engineer` | ux-engineer | Generate UX mockups |
346
+ | `github-ops` | github-ops | GitHub consistency |
347
+ | `technical-writer` | technical-writer | Documentation maintenance |
348
+ | `housekeeping` | housekeeping | Lint, type, test fixes |
349
+ | `qa-engineer` | qa-engineer | Testing standard and coverage gate |
350
+ | `infra-engineer` | infra-engineer | Plan and apply infrastructure changes |
351
+ | `verifier-design` | verifier | Generate compliance test plan |
352
+ | `verifier-audit` | verifier | Grey-box fidelity audit |
328
353
 
329
354
  ---
330
355
 
@@ -349,23 +374,20 @@ The `verifier` audit after implementation is mandatory and non-skippable before
349
374
 
350
375
  ## File Organization
351
376
 
352
- | Directory | Contents |
353
- | --------------------- | ----------------------------------------------------------------------- |
354
- | `/docs/` | Documentation — see [`docs/README.md`](docs/README.md) for the index |
355
- | `/docs/adr/` | Architecture decision records |
356
- | `/docs/requirements/` | PRDs produced by the refine skill |
357
- | `/workstream/` | Active feature work — specs, stories, task lists, fidelity reports |
358
- | `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
359
- | `core/` | Business logic — catalog, context, distribution, extract, scope, verify |
360
- | `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
361
- | `adapters/mcp/` | MCP adapter placeholder (not implemented) |
362
- | `schemas/` | JSON Schemas for validation |
363
- | `scripts/` | Bundle build, release, and formatting scripts |
364
- | `templates/` | Meta-repo scaffold and CI templates |
365
- | `test/` | Unit and integration tests + fixtures |
366
- | `.github/` | Copilot agents, skills, instructions, prompts; CI workflows |
367
- | `.claude/` | Claude Code agents, skills, commands, hooks |
368
- | `.kiro/` | Kiro agents, skills, steering, hooks |
377
+ | Directory | Contents |
378
+ | --------------------- | -------------------------------------------------------------------- |
379
+ | `/docs/` | Documentation — see [`docs/README.md`](docs/README.md) for the index |
380
+ | `/docs/adr/` | Architecture decision records |
381
+ | `/docs/requirements/` | PRDs produced by the refine skill |
382
+ | `/workstream/` | Active feature work — specs, stories, task lists, fidelity reports |
383
+ | `bin/` | CLI entrypoint (`dev-tasks.ts`) and its argument parser |
384
+ | `core/` | Business logic — `distribution` (install/update/status/pin/doctor) |
385
+ | `scripts/` | Bundle build, release, and formatting scripts |
386
+ | `templates/` | Claude settings, infra scaffold, deploy scripts, and CI workflows |
387
+ | `test/` | Unit and integration tests + fixtures |
388
+ | `.github/` | Copilot agents, skills, instructions, prompts; CI workflows |
389
+ | `.claude/` | Claude Code agents, skills, commands, hooks |
390
+ | `.kiro/` | Kiro agents, skills, steering, hooks |
369
391
 
370
392
  ---
371
393