@llipe.com/dev-tasks 0.6.6 → 0.7.3

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 (352) hide show
  1. package/.claude/agents/developer.md +2 -0
  2. package/.claude/commands/developer.md +2 -0
  3. package/.claude/commands/planner.md +2 -0
  4. package/.claude/commands/product-engineer.md +13 -7
  5. package/.claude/skills/activity-init/SKILL.md +81 -8
  6. package/.github/agents/developer.agent.md +2 -0
  7. package/.github/agents/planner.agent.md +2 -0
  8. package/.github/agents/product-engineer.agent.md +13 -7
  9. package/.github/prompts/product-engineer-init.prompt.md +7 -1
  10. package/.github/skills/activity-init/SKILL.md +81 -8
  11. package/.kiro/agents/developer.md +2 -0
  12. package/.kiro/agents/planner.md +2 -0
  13. package/.kiro/agents/product-engineer.md +13 -7
  14. package/.kiro/skills/activity-init/SKILL.md +81 -8
  15. package/AGENTS.md +96 -1
  16. package/CHANGELOG.md +96 -0
  17. package/README.md +288 -632
  18. package/dist/adapters/cli/catalog-build.d.ts +30 -0
  19. package/dist/adapters/cli/catalog-build.d.ts.map +1 -0
  20. package/dist/adapters/cli/catalog-build.js +73 -0
  21. package/dist/adapters/cli/catalog-build.js.map +1 -0
  22. package/dist/adapters/cli/catalog-query.d.ts +13 -0
  23. package/dist/adapters/cli/catalog-query.d.ts.map +1 -0
  24. package/dist/adapters/cli/catalog-query.js +329 -0
  25. package/dist/adapters/cli/catalog-query.js.map +1 -0
  26. package/dist/adapters/cli/catalog-scaffold.d.ts +24 -0
  27. package/dist/adapters/cli/catalog-scaffold.d.ts.map +1 -0
  28. package/dist/adapters/cli/catalog-scaffold.js +46 -0
  29. package/dist/adapters/cli/catalog-scaffold.js.map +1 -0
  30. package/dist/adapters/cli/catalog-validate.d.ts +35 -0
  31. package/dist/adapters/cli/catalog-validate.d.ts.map +1 -0
  32. package/dist/adapters/cli/catalog-validate.js +122 -0
  33. package/dist/adapters/cli/catalog-validate.js.map +1 -0
  34. package/dist/adapters/cli/ctx-assemble.d.ts +19 -0
  35. package/dist/adapters/cli/ctx-assemble.d.ts.map +1 -0
  36. package/dist/adapters/cli/ctx-assemble.js +293 -0
  37. package/dist/adapters/cli/ctx-assemble.js.map +1 -0
  38. package/dist/adapters/cli/ctx-fetch.d.ts +49 -0
  39. package/dist/adapters/cli/ctx-fetch.d.ts.map +1 -0
  40. package/dist/adapters/cli/ctx-fetch.js +267 -0
  41. package/dist/adapters/cli/ctx-fetch.js.map +1 -0
  42. package/dist/adapters/cli/extract-all.d.ts +2 -2
  43. package/dist/adapters/cli/extract-all.d.ts.map +1 -1
  44. package/dist/adapters/cli/extract-all.js.map +1 -1
  45. package/dist/adapters/cli/extract-component.d.ts +2 -2
  46. package/dist/adapters/cli/extract-component.d.ts.map +1 -1
  47. package/dist/adapters/cli/extract-component.js.map +1 -1
  48. package/dist/adapters/cli/init.d.ts +37 -0
  49. package/dist/adapters/cli/init.d.ts.map +1 -0
  50. package/dist/adapters/cli/init.js +336 -0
  51. package/dist/adapters/cli/init.js.map +1 -0
  52. package/dist/adapters/cli/scope-gate.d.ts +25 -0
  53. package/dist/adapters/cli/scope-gate.d.ts.map +1 -0
  54. package/dist/adapters/cli/scope-gate.js +157 -0
  55. package/dist/adapters/cli/scope-gate.js.map +1 -0
  56. package/dist/adapters/cli/scope.d.ts +26 -0
  57. package/dist/adapters/cli/scope.d.ts.map +1 -0
  58. package/dist/adapters/cli/scope.js +172 -0
  59. package/dist/adapters/cli/scope.js.map +1 -0
  60. package/dist/adapters/cli/validate-component.d.ts +24 -0
  61. package/dist/adapters/cli/validate-component.d.ts.map +1 -0
  62. package/dist/adapters/cli/validate-component.js +62 -0
  63. package/dist/adapters/cli/validate-component.js.map +1 -0
  64. package/dist/adapters/cli/verify-contract-diff.d.ts +21 -0
  65. package/dist/adapters/cli/verify-contract-diff.d.ts.map +1 -0
  66. package/dist/adapters/cli/verify-contract-diff.js +69 -0
  67. package/dist/adapters/cli/verify-contract-diff.js.map +1 -0
  68. package/dist/adapters/cli/verify-drift.d.ts +24 -0
  69. package/dist/adapters/cli/verify-drift.d.ts.map +1 -0
  70. package/dist/adapters/cli/verify-drift.js +103 -0
  71. package/dist/adapters/cli/verify-drift.js.map +1 -0
  72. package/dist/adapters/cli/verify-impact.d.ts +23 -0
  73. package/dist/adapters/cli/verify-impact.d.ts.map +1 -0
  74. package/dist/adapters/cli/verify-impact.js +119 -0
  75. package/dist/adapters/cli/verify-impact.js.map +1 -0
  76. package/dist/bin/dev-tasks.d.ts +1 -1
  77. package/dist/bin/dev-tasks.js +28 -6
  78. package/dist/bin/dev-tasks.js.map +1 -1
  79. package/dist/bin/dt.js +488 -0
  80. package/dist/bin/dt.js.map +1 -1
  81. package/dist/core/catalog/build.d.ts +143 -0
  82. package/dist/core/catalog/build.d.ts.map +1 -0
  83. package/dist/core/catalog/build.js +475 -0
  84. package/dist/core/catalog/build.js.map +1 -0
  85. package/dist/core/catalog/checks/index.d.ts +18 -0
  86. package/dist/core/catalog/checks/index.d.ts.map +1 -0
  87. package/dist/core/catalog/checks/index.js +18 -0
  88. package/dist/core/catalog/checks/index.js.map +1 -0
  89. package/dist/core/catalog/checks/v01-schema.d.ts +17 -0
  90. package/dist/core/catalog/checks/v01-schema.d.ts.map +1 -0
  91. package/dist/core/catalog/checks/v01-schema.js +57 -0
  92. package/dist/core/catalog/checks/v01-schema.js.map +1 -0
  93. package/dist/core/catalog/checks/v02-v03-identity.d.ts +14 -0
  94. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +1 -0
  95. package/dist/core/catalog/checks/v02-v03-identity.js +60 -0
  96. package/dist/core/catalog/checks/v02-v03-identity.js.map +1 -0
  97. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +7 -0
  98. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +1 -0
  99. package/dist/core/catalog/checks/v04-referential-integrity.js +32 -0
  100. package/dist/core/catalog/checks/v04-referential-integrity.js.map +1 -0
  101. package/dist/core/catalog/checks/v05-domain-existence.d.ts +6 -0
  102. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +1 -0
  103. package/dist/core/catalog/checks/v05-domain-existence.js +23 -0
  104. package/dist/core/catalog/checks/v05-domain-existence.js.map +1 -0
  105. package/dist/core/catalog/checks/v06-v07-paths.d.ts +29 -0
  106. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +1 -0
  107. package/dist/core/catalog/checks/v06-v07-paths.js +107 -0
  108. package/dist/core/catalog/checks/v06-v07-paths.js.map +1 -0
  109. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +13 -0
  110. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +1 -0
  111. package/dist/core/catalog/checks/v08-v10-contracts.js +70 -0
  112. package/dist/core/catalog/checks/v08-v10-contracts.js.map +1 -0
  113. package/dist/core/catalog/checks/v11-manual-fields.d.ts +16 -0
  114. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +1 -0
  115. package/dist/core/catalog/checks/v11-manual-fields.js +60 -0
  116. package/dist/core/catalog/checks/v11-manual-fields.js.map +1 -0
  117. package/dist/core/catalog/checks/v12-cycles.d.ts +8 -0
  118. package/dist/core/catalog/checks/v12-cycles.d.ts.map +1 -0
  119. package/dist/core/catalog/checks/v12-cycles.js +28 -0
  120. package/dist/core/catalog/checks/v12-cycles.js.map +1 -0
  121. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +7 -0
  122. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +1 -0
  123. package/dist/core/catalog/checks/v13-orphan-contracts.js +33 -0
  124. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +1 -0
  125. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +8 -0
  126. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +1 -0
  127. package/dist/core/catalog/checks/v14-v15-lifecycle.js +42 -0
  128. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +1 -0
  129. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +7 -0
  130. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +1 -0
  131. package/dist/core/catalog/checks/v16-deprecated-consumers.js +47 -0
  132. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +1 -0
  133. package/dist/core/catalog/checks/v17-low-confidence.d.ts +7 -0
  134. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +1 -0
  135. package/dist/core/catalog/checks/v17-low-confidence.js +32 -0
  136. package/dist/core/catalog/checks/v17-low-confidence.js.map +1 -0
  137. package/dist/core/catalog/checks/v18-low-payload.d.ts +7 -0
  138. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +1 -0
  139. package/dist/core/catalog/checks/v18-low-payload.js +33 -0
  140. package/dist/core/catalog/checks/v18-low-payload.js.map +1 -0
  141. package/dist/core/catalog/checks/v19-domain-membership.d.ts +8 -0
  142. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +1 -0
  143. package/dist/core/catalog/checks/v19-domain-membership.js +55 -0
  144. package/dist/core/catalog/checks/v19-domain-membership.js.map +1 -0
  145. package/dist/core/catalog/coverage.d.ts +39 -0
  146. package/dist/core/catalog/coverage.d.ts.map +1 -0
  147. package/dist/core/catalog/coverage.js +62 -0
  148. package/dist/core/catalog/coverage.js.map +1 -0
  149. package/dist/core/catalog/graph.d.ts +49 -0
  150. package/dist/core/catalog/graph.d.ts.map +1 -0
  151. package/dist/core/catalog/graph.js +114 -0
  152. package/dist/core/catalog/graph.js.map +1 -0
  153. package/dist/core/catalog/index-model.d.ts +96 -0
  154. package/dist/core/catalog/index-model.d.ts.map +1 -0
  155. package/dist/core/catalog/index-model.js +8 -0
  156. package/dist/core/catalog/index-model.js.map +1 -0
  157. package/dist/core/catalog/queries.d.ts +69 -0
  158. package/dist/core/catalog/queries.d.ts.map +1 -0
  159. package/dist/core/catalog/queries.js +165 -0
  160. package/dist/core/catalog/queries.js.map +1 -0
  161. package/dist/core/catalog/resolve.d.ts +47 -0
  162. package/dist/core/catalog/resolve.d.ts.map +1 -0
  163. package/dist/core/catalog/resolve.js +318 -0
  164. package/dist/core/catalog/resolve.js.map +1 -0
  165. package/dist/core/catalog/scaffold.d.ts +31 -0
  166. package/dist/core/catalog/scaffold.d.ts.map +1 -0
  167. package/dist/core/catalog/scaffold.js +141 -0
  168. package/dist/core/catalog/scaffold.js.map +1 -0
  169. package/dist/core/catalog/validate-component.d.ts +50 -0
  170. package/dist/core/catalog/validate-component.d.ts.map +1 -0
  171. package/dist/core/catalog/validate-component.js +105 -0
  172. package/dist/core/catalog/validate-component.js.map +1 -0
  173. package/dist/core/catalog/validate.d.ts +71 -0
  174. package/dist/core/catalog/validate.d.ts.map +1 -0
  175. package/dist/core/catalog/validate.js +103 -0
  176. package/dist/core/catalog/validate.js.map +1 -0
  177. package/dist/core/context/assemble.d.ts +126 -0
  178. package/dist/core/context/assemble.d.ts.map +1 -0
  179. package/dist/core/context/assemble.js +197 -0
  180. package/dist/core/context/assemble.js.map +1 -0
  181. package/dist/core/context/cache.d.ts +60 -0
  182. package/dist/core/context/cache.d.ts.map +1 -0
  183. package/dist/core/context/cache.js +236 -0
  184. package/dist/core/context/cache.js.map +1 -0
  185. package/dist/core/context/exit-codes.d.ts +28 -0
  186. package/dist/core/context/exit-codes.d.ts.map +1 -0
  187. package/dist/core/context/exit-codes.js +28 -0
  188. package/dist/core/context/exit-codes.js.map +1 -0
  189. package/dist/core/context/fetch.d.ts +55 -0
  190. package/dist/core/context/fetch.d.ts.map +1 -0
  191. package/dist/core/context/fetch.js +112 -0
  192. package/dist/core/context/fetch.js.map +1 -0
  193. package/dist/core/context/index.d.ts +7 -1
  194. package/dist/core/context/index.d.ts.map +1 -1
  195. package/dist/core/context/index.js +7 -1
  196. package/dist/core/context/index.js.map +1 -1
  197. package/dist/core/context/init.d.ts +179 -0
  198. package/dist/core/context/init.d.ts.map +1 -0
  199. package/dist/core/context/init.js +532 -0
  200. package/dist/core/context/init.js.map +1 -0
  201. package/dist/core/context/layers/architecture-layer.d.ts +13 -0
  202. package/dist/core/context/layers/architecture-layer.d.ts.map +1 -0
  203. package/dist/core/context/layers/architecture-layer.js +24 -0
  204. package/dist/core/context/layers/architecture-layer.js.map +1 -0
  205. package/dist/core/context/layers/contracts-layer.d.ts +13 -0
  206. package/dist/core/context/layers/contracts-layer.d.ts.map +1 -0
  207. package/dist/core/context/layers/contracts-layer.js +83 -0
  208. package/dist/core/context/layers/contracts-layer.js.map +1 -0
  209. package/dist/core/context/layers/conventions-delta-layer.d.ts +13 -0
  210. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +1 -0
  211. package/dist/core/context/layers/conventions-delta-layer.js +37 -0
  212. package/dist/core/context/layers/conventions-delta-layer.js.map +1 -0
  213. package/dist/core/context/layers/flow-layer.d.ts +14 -0
  214. package/dist/core/context/layers/flow-layer.d.ts.map +1 -0
  215. package/dist/core/context/layers/flow-layer.js +61 -0
  216. package/dist/core/context/layers/flow-layer.js.map +1 -0
  217. package/dist/core/context/layers/index-layer.d.ts +13 -0
  218. package/dist/core/context/layers/index-layer.d.ts.map +1 -0
  219. package/dist/core/context/layers/index-layer.js +77 -0
  220. package/dist/core/context/layers/index-layer.js.map +1 -0
  221. package/dist/core/context/layers/primary-layer.d.ts +16 -0
  222. package/dist/core/context/layers/primary-layer.d.ts.map +1 -0
  223. package/dist/core/context/layers/primary-layer.js +61 -0
  224. package/dist/core/context/layers/primary-layer.js.map +1 -0
  225. package/dist/core/context/layers/secondary-layer.d.ts +19 -0
  226. package/dist/core/context/layers/secondary-layer.d.ts.map +1 -0
  227. package/dist/core/context/layers/secondary-layer.js +52 -0
  228. package/dist/core/context/layers/secondary-layer.js.map +1 -0
  229. package/dist/core/context/session-lock.d.ts +114 -0
  230. package/dist/core/context/session-lock.d.ts.map +1 -0
  231. package/dist/core/context/session-lock.js +90 -0
  232. package/dist/core/context/session-lock.js.map +1 -0
  233. package/dist/core/context/tokens.d.ts +35 -0
  234. package/dist/core/context/tokens.d.ts.map +1 -0
  235. package/dist/core/context/tokens.js +88 -0
  236. package/dist/core/context/tokens.js.map +1 -0
  237. package/dist/core/distribution/fetch-package.d.ts +18 -0
  238. package/dist/core/distribution/fetch-package.d.ts.map +1 -0
  239. package/dist/core/distribution/fetch-package.js +42 -0
  240. package/dist/core/distribution/fetch-package.js.map +1 -0
  241. package/dist/core/distribution/index.d.ts +3 -1
  242. package/dist/core/distribution/index.d.ts.map +1 -1
  243. package/dist/core/distribution/index.js +2 -1
  244. package/dist/core/distribution/index.js.map +1 -1
  245. package/dist/core/distribution/install.d.ts +1 -1
  246. package/dist/core/distribution/install.d.ts.map +1 -1
  247. package/dist/core/distribution/install.js +10 -2
  248. package/dist/core/distribution/install.js.map +1 -1
  249. package/dist/core/distribution/pin.d.ts +5 -0
  250. package/dist/core/distribution/pin.d.ts.map +1 -1
  251. package/dist/core/distribution/pin.js +17 -1
  252. package/dist/core/distribution/pin.js.map +1 -1
  253. package/dist/core/distribution/update.d.ts +11 -1
  254. package/dist/core/distribution/update.d.ts.map +1 -1
  255. package/dist/core/distribution/update.js +45 -1
  256. package/dist/core/distribution/update.js.map +1 -1
  257. package/dist/core/exit-codes.d.ts +30 -1
  258. package/dist/core/exit-codes.d.ts.map +1 -1
  259. package/dist/core/exit-codes.js +31 -1
  260. package/dist/core/exit-codes.js.map +1 -1
  261. package/dist/core/extract/component.d.ts +11 -8
  262. package/dist/core/extract/component.d.ts.map +1 -1
  263. package/dist/core/extract/component.js.map +1 -1
  264. package/dist/core/extract/index.d.ts +1 -1
  265. package/dist/core/extract/index.d.ts.map +1 -1
  266. package/dist/core/extract/openapi/route1.d.ts.map +1 -1
  267. package/dist/core/extract/openapi/route1.js +6 -0
  268. package/dist/core/extract/openapi/route1.js.map +1 -1
  269. package/dist/core/extract/providers/node-ts.d.ts.map +1 -1
  270. package/dist/core/extract/providers/node-ts.js +9 -0
  271. package/dist/core/extract/providers/node-ts.js.map +1 -1
  272. package/dist/core/index.d.ts +1 -0
  273. package/dist/core/index.d.ts.map +1 -1
  274. package/dist/core/index.js +1 -0
  275. package/dist/core/index.js.map +1 -1
  276. package/dist/core/providers/index.d.ts +3 -2
  277. package/dist/core/providers/index.d.ts.map +1 -1
  278. package/dist/core/providers/index.js +1 -1
  279. package/dist/core/providers/index.js.map +1 -1
  280. package/dist/core/providers/tracker.d.ts +74 -0
  281. package/dist/core/providers/tracker.d.ts.map +1 -0
  282. package/dist/core/providers/tracker.js +38 -0
  283. package/dist/core/providers/tracker.js.map +1 -0
  284. package/dist/core/scope/calibration.d.ts +25 -0
  285. package/dist/core/scope/calibration.d.ts.map +1 -0
  286. package/dist/core/scope/calibration.js +52 -0
  287. package/dist/core/scope/calibration.js.map +1 -0
  288. package/dist/core/scope/closure.d.ts +31 -0
  289. package/dist/core/scope/closure.d.ts.map +1 -0
  290. package/dist/core/scope/closure.js +68 -0
  291. package/dist/core/scope/closure.js.map +1 -0
  292. package/dist/core/scope/gate.d.ts +41 -0
  293. package/dist/core/scope/gate.d.ts.map +1 -0
  294. package/dist/core/scope/gate.js +165 -0
  295. package/dist/core/scope/gate.js.map +1 -0
  296. package/dist/core/scope/index.d.ts +15 -2
  297. package/dist/core/scope/index.d.ts.map +1 -1
  298. package/dist/core/scope/index.js +11 -1
  299. package/dist/core/scope/index.js.map +1 -1
  300. package/dist/core/scope/partition.d.ts +36 -0
  301. package/dist/core/scope/partition.d.ts.map +1 -0
  302. package/dist/core/scope/partition.js +78 -0
  303. package/dist/core/scope/partition.js.map +1 -0
  304. package/dist/core/scope/prompt.d.ts +39 -0
  305. package/dist/core/scope/prompt.d.ts.map +1 -0
  306. package/dist/core/scope/prompt.js +123 -0
  307. package/dist/core/scope/prompt.js.map +1 -0
  308. package/dist/core/scope/scoping.d.ts +52 -0
  309. package/dist/core/scope/scoping.d.ts.map +1 -0
  310. package/dist/core/scope/scoping.js +99 -0
  311. package/dist/core/scope/scoping.js.map +1 -0
  312. package/dist/core/scope/types.d.ts +77 -0
  313. package/dist/core/scope/types.d.ts.map +1 -0
  314. package/dist/core/scope/types.js +5 -0
  315. package/dist/core/scope/types.js.map +1 -0
  316. package/dist/core/scope/validate.d.ts +47 -0
  317. package/dist/core/scope/validate.d.ts.map +1 -0
  318. package/dist/core/scope/validate.js +90 -0
  319. package/dist/core/scope/validate.js.map +1 -0
  320. package/dist/core/verify/asyncapi-diff.d.ts +34 -0
  321. package/dist/core/verify/asyncapi-diff.d.ts.map +1 -0
  322. package/dist/core/verify/asyncapi-diff.js +209 -0
  323. package/dist/core/verify/asyncapi-diff.js.map +1 -0
  324. package/dist/core/verify/contract-diff.d.ts +39 -0
  325. package/dist/core/verify/contract-diff.d.ts.map +1 -0
  326. package/dist/core/verify/contract-diff.js +63 -0
  327. package/dist/core/verify/contract-diff.js.map +1 -0
  328. package/dist/core/verify/drift.d.ts +47 -0
  329. package/dist/core/verify/drift.d.ts.map +1 -0
  330. package/dist/core/verify/drift.js +122 -0
  331. package/dist/core/verify/drift.js.map +1 -0
  332. package/dist/core/verify/impact.d.ts +22 -0
  333. package/dist/core/verify/impact.d.ts.map +1 -0
  334. package/dist/core/verify/impact.js +93 -0
  335. package/dist/core/verify/impact.js.map +1 -0
  336. package/dist/core/verify/index.d.ts +10 -0
  337. package/dist/core/verify/index.d.ts.map +1 -0
  338. package/dist/core/verify/index.js +9 -0
  339. package/dist/core/verify/index.js.map +1 -0
  340. package/dist/core/verify/openapi-diff.d.ts +29 -0
  341. package/dist/core/verify/openapi-diff.d.ts.map +1 -0
  342. package/dist/core/verify/openapi-diff.js +291 -0
  343. package/dist/core/verify/openapi-diff.js.map +1 -0
  344. package/dist/core/verify/types.d.ts +138 -0
  345. package/dist/core/verify/types.d.ts.map +1 -0
  346. package/dist/core/verify/types.js +5 -0
  347. package/dist/core/verify/types.js.map +1 -0
  348. package/package.json +11 -2
  349. package/schemas/component.schema.json +203 -0
  350. package/schemas/flow.schema.json +75 -0
  351. package/schemas/scope-output.schema.json +62 -0
  352. package/schemas/.gitkeep +0 -0
package/README.md CHANGED
@@ -2,390 +2,202 @@
2
2
 
3
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. Inspired by [snarktank/ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks).
4
4
 
5
- ## Quick Start
6
-
7
- ### Agent workflow (skills + instructions)
5
+ ---
8
6
 
9
- ```bash
10
- # 1. Bootstrap the installer into your repo
11
- curl -fsSL https://raw.githubusercontent.com/llipe/dev-tasks/main/dev-tasks.sh \
12
- -o dev-tasks.sh && chmod +x dev-tasks.sh
13
-
14
- # 2. Install (default: all platforms — Copilot + Claude Code + Kiro)
15
- ./dev-tasks.sh install
16
-
17
- # 3. Initialize your project context (run once per project)
18
- # Invoke @product-engineer in Init Mode — produces docs/product-context.md
19
- # and docs/technical-guidelines.md
20
-
21
- # 4. Build a feature
22
- # a) Invoke @product-engineer with a feature description or GitHub issue number
23
- # → creates PRD → spec → stories → task list
24
- # b) Invoke @developer with the task list path
25
- # → implements, tests, and opens a PR
26
-
27
- # 5. Keep up to date
28
- ./dev-tasks.sh update # update toolkit files
29
- ./dev-tasks.sh update --backup # same, but backs up current files first
30
- ./dev-tasks.sh check # compare installed vs latest version
31
- ```
7
+ ## Getting Started
32
8
 
33
- ### `dt` CLI (multi-repo context)
9
+ ### 1. Install the package
34
10
 
35
11
  ```bash
36
- # 1. Install the npm package
37
12
  pnpm add -g @llipe.com/dev-tasks
13
+ ```
38
14
 
39
- # 2. Extract your repo's metadata
40
- dt extract all --interactive
41
-
42
- # 3. Review the generated component.json and extraction_report.json
43
- cat component.json
44
- cat extraction_report.json
15
+ This gives you two binaries:
45
16
 
46
- # 4. Keep distribution up to date with hash-based reconciliation
47
- dev-tasks update
48
- ```
17
+ | Binary | Purpose |
18
+ | ----------- | ------------------------------------------------------- |
19
+ | `dev-tasks` | Bootstrap: install agent files, update, status, migrate |
20
+ | `dt` | Runtime: extract repo metadata, build context |
49
21
 
50
- **Platform profiles** — install only what you need:
22
+ ### 2. Install agent workflow files into your repo
51
23
 
52
24
  ```bash
53
- ./dev-tasks.sh install --profile copilot # .github/ only
54
- ./dev-tasks.sh install --profile claude # .claude/ only
55
- ./dev-tasks.sh install --profile kiro # .kiro/ only
56
- ./dev-tasks.sh install --profile claude,kiro # mix and match
57
- ./dev-tasks.sh install --profile all # everything (default)
25
+ cd your-project
26
+ dev-tasks install
58
27
  ```
59
28
 
60
- ---
61
-
62
- ## The Core Idea
63
-
64
- This system brings structure and clarity to AI-assisted development by:
65
-
66
- - Defining scope with Product Requirements Documents (PRDs)
67
- - Breaking requirements into actionable, implementation-ready tasks
68
- - Guiding the AI to tackle one task at a time with checkpoints for review
69
- - Providing specialized **agents** that orchestrate the workflow end-to-end
70
- - Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
71
-
72
- ---
29
+ This installs agent definitions, skills, instructions, and prompts into your project for the AI platforms you use. By default it installs for all platforms (`--profile all`).
73
30
 
74
- ## Taxonomy: Agent vs Skill vs Instruction
31
+ **Choose your platform profile:**
75
32
 
76
- | Concept | Purpose | Loaded When | Decision Rule |
77
- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- | ------------------------------------------------------------------------------------------- |
78
- | **Agent** | Autonomous role with decision-making, phases, and handoff discipline. Owns a workflow end-to-end. | Invoked by name (`@agent`) | "Does it make decisions, own a multi-phase workflow, and hand off to other agents?" → Agent |
79
- | **Skill** | Reusable on-demand capability. Describes _procedures_ or _activities_ that any agent can invoke when needed. Not loaded unless referenced. | On demand (invoked by agent or prompt) | "Is this capability needed only sometimes, by one or more agents?" → Skill |
80
- | **Instruction** | Always-loaded rule scoped via `applyTo` frontmatter. Enforced automatically for every matching context. | Always (auto-applied by runtime) | "Must this rule be enforced every time, for every matching file or context?" → Instruction |
81
-
82
- **Key distinctions:**
83
-
84
- - Skills save context window space — they are loaded only when invoked, unlike instructions which are always present.
85
- - Agent files define _who_ (identity, phases, handoff rules). Skill files define _how_ (procedures, templates, steps).
86
- - Instructions are for cross-cutting rules that must never be forgotten (e.g., implementation discipline, planning format).
33
+ ```bash
34
+ dev-tasks install --profile copilot # .github/ only
35
+ dev-tasks install --profile claude # .claude/ only
36
+ dev-tasks install --profile kiro # .kiro/ only
37
+ dev-tasks install --profile both # copilot + claude only
38
+ ```
87
39
 
88
- ---
40
+ ### 3. Initialize your project context
89
41
 
90
- ## Installation
42
+ Invoke the `product-engineer` agent in Init Mode (via `@product-engineer` or the `product-engineer-init` prompt). This creates:
91
43
 
92
- ### Prerequisites
44
+ - `docs/product-context.md` — what your product is and who it's for
45
+ - `docs/technical-guidelines.md` — stack, conventions, and constraints
93
46
 
94
- - macOS / Linux (or WSL on Windows)
95
- - `git`
96
- - `curl`
97
- - `tar`
98
- - `shasum` (or `sha256sum`)
47
+ Run this once per project.
99
48
 
100
- ### Option A: Install `dev-tasks` into any repository (recommended)
49
+ ### 4. Build a feature
101
50
 
102
- Run this in the repository where you want to use the workflow:
51
+ ```text
52
+ a) Invoke @product-engineer with a feature description or GitHub issue number
53
+ → creates PRD → spec → stories → task list
103
54
 
104
- ```bash
105
- curl -fsSL https://raw.githubusercontent.com/llipe/dev-tasks/main/dev-tasks.sh \
106
- -o dev-tasks.sh && chmod +x dev-tasks.sh
107
- ./dev-tasks.sh install
55
+ b) Invoke @developer with the task list path
56
+ → implements, tests, and opens a PR
108
57
  ```
109
58
 
110
- ### Option B: Set up this repository locally (contributors)
59
+ ### 5. Keep files up to date
111
60
 
112
61
  ```bash
113
- git clone https://github.com/llipe/dev-tasks.git
114
- cd dev-tasks
115
- chmod +x dev-tasks.sh
116
- ./dev-tasks.sh version
117
- ./dev-tasks.sh check
62
+ dev-tasks update # reconcile with hash-based conflict detection
63
+ dev-tasks update --force # accept all upstream changes
64
+ dev-tasks status # compare installed vs latest version
118
65
  ```
119
66
 
120
- ### Verify the installation
121
-
122
- After install, confirm these paths exist in your target repo:
123
-
124
- - `.github/agents/`
125
- - `.github/skills/`
126
- - `.github/instructions/`
127
- - `.github/prompts/`
128
- - `.dev-tasks-version`
129
-
130
- The default `--profile both` installs Copilot (`.github/`) and Claude Code (`.claude/`) file sets only. If you installed with `--profile kiro` or `--profile all`, also confirm:
131
-
132
- - `.kiro/agents/`
133
- - `.kiro/skills/`
134
- - `.kiro/steering/`
135
- - `.kiro/hooks/`
136
-
137
67
  ---
138
68
 
139
- ## Getting Started
140
-
141
- ### 1. Install with the single-script installer
142
-
143
- Bootstrap from any repository with one command:
69
+ ## Using `dt` for Multi-Repo Context
144
70
 
145
- ```bash
146
- curl -fsSL https://raw.githubusercontent.com/llipe/dev-tasks/main/dev-tasks.sh \
147
- -o dev-tasks.sh && chmod +x dev-tasks.sh
148
- ./dev-tasks.sh install
149
- ```
150
-
151
- This downloads the latest versioned bundle from GitHub Releases, places all managed files in `.github/agents/`, `.github/skills/`, `.github/instructions/`, and `.github/prompts/`, writes `.dev-tasks-version` for traceability, and prints an **AGENTS.md integration prompt** showing what changed.
71
+ `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.
152
72
 
153
- **Pin to a specific version:**
73
+ ### Extract metadata from a repo
154
74
 
155
75
  ```bash
156
- ./dev-tasks.sh install v1.2.0
157
- ```
76
+ cd my-service
158
77
 
159
- **Check for updates:**
78
+ # Run the full extraction pipeline
79
+ dt extract all --interactive
160
80
 
161
- ```bash
162
- ./dev-tasks.sh check
81
+ # Or run individual extractors
82
+ dt extract detect # stack, framework, ORM, messaging
83
+ dt extract schema # database schema from ORM definitions
84
+ dt extract openapi # OpenAPI spec (copy existing or AST inference)
85
+ dt extract asyncapi # AsyncAPI spec from Kafka topic patterns
86
+ dt extract component # derive component.json manifest
163
87
  ```
164
88
 
165
- **List installed files and directories:**
89
+ ### Review outputs
166
90
 
167
91
  ```bash
168
- ./dev-tasks.sh list
92
+ cat component.json # manifest with _provenance metadata
93
+ cat extraction_report.json # coverage, confidence, unresolved items
169
94
  ```
170
95
 
171
- **Update (with automatic backup):**
96
+ ### Validate a manifest (offline, no network access)
172
97
 
173
98
  ```bash
174
- ./dev-tasks.sh update --backup
99
+ dt validate-component component.json # exit 0 valid, exit 4 invalid
100
+ dt validate-component component.json --json # structured error list
175
101
  ```
176
102
 
177
- **Preview what would change without writing any files:**
103
+ ### Typical workflow
178
104
 
179
105
  ```bash
180
- ./dev-tasks.sh update --dry-run
181
- ```
182
-
183
- See [Distribution & Script Reference](#distribution--script-reference) below for full documentation.
184
-
185
- After install, your repo contains (Copilot + Claude Code, the default `--profile both`):
186
-
187
- ```text
188
- your-repo/
189
- ├── dev-tasks.sh # Keep this — used for future updates
190
- ├── .dev-tasks-version # Installed version metadata (JSON)
191
- ├── .github/
192
- │ ├── instructions/ # Always-loaded rules
193
- │ │ ├── plan.instructions.md
194
- │ │ ├── implement.instructions.md
195
- │ │ └── domain/
196
- │ │ └── nextjs-pages-components.instructions.md
197
- │ ├── agents/ # Agent definitions (8 agents)
198
- │ ├── skills/ # On-demand capabilities (13 skills)
199
- │ └── prompts/ # Ready-to-use prompt templates
200
- ├── docs/ # Foundation docs (generated by init)
201
- ├── workstream/ # Active feature work
202
- └── AGENTS.md # Master registry (you own this — see integration prompt)
203
- ```
204
-
205
- With `--profile kiro` or `--profile all`, your repo additionally (or instead, for `kiro`) contains:
206
-
207
- ```text
208
- your-repo/
209
- └── .kiro/
210
- ├── steering/ # Kiro's "instructions" equivalent (4 files)
211
- │ ├── plan.md # inclusion: always
212
- │ ├── implement.md # inclusion: always
213
- │ ├── nextjs-pages-components.md # inclusion: fileMatch, fileMatchPattern: "**/*.tsx"
214
- │ └── git-guard-notice.md # inclusion: always — Kiro-specific hook-limitation disclosure
215
- ├── agents/ # Agent definitions (8 agents; prompts folded in as "Invocation Modes")
216
- ├── skills/ # On-demand capabilities (13 skills, one dir each with SKILL.md)
217
- └── hooks/
218
- ├── git-guard.json # PreToolUse hook definition
219
- └── scripts/git-guard.sh
106
+ dt extract all --interactive
107
+ dt validate-component component.json
108
+ git add component.json contracts/ docs/schema.md extraction_report.json
109
+ git commit -m "feat: add component manifest via dt extract"
220
110
  ```
221
111
 
222
- ### 2. Initialize your project foundation
112
+ ### Artifact formats
223
113
 
224
- Run the `product-engineer` agent in **Init Mode** to establish your product context and technical guidelines:
114
+ 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.
225
115
 
226
- > Use the `product-engineer-init` prompt or invoke `@product-engineer` with a project description.
116
+ ### CLI documentation
227
117
 
228
- This produces `docs/product-context.md` and `docs/technical-guidelines.md`. Run this once per project (or when a major pivot occurs).
118
+ - **`dev-tasks` (bootstrap/distribution):** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
119
+ - **`dt` (extraction/catalog/context):** [`docs/dt-user-manual.md`](docs/dt-user-manual.md) — extract, catalog, context, scope
229
120
 
230
- ### 3. Start building
231
-
232
- | Situation | How to start |
233
- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
234
- | **New feature / epic** | Invoke `product-engineer` with a feature description, then `developer` to implement |
235
- | **Single GitHub Issue** | Invoke `product-engineer` with an issue number, then `developer` to implement |
236
- | **Already have a task list** | Invoke `developer` with a task list path |
237
- | **Multi-story PRD batch** | Invoke `planner` with a `/workstream` task file or milestone |
238
- | **UX prototype** | Invoke `ux-engineer` with a PRD or SPEC path |
239
- | **Docs out of date** | Invoke `technical-writer` |
240
- | **Lint/type/test cleanup** | Invoke `housekeeping` |
241
- | **Verifier compliance testing** | Invoke `verifier` with a spec or story to generate test plans (Design Mode) and audit delivered fidelity (Audit Mode) |
121
+ ### Global options
242
122
 
243
- ### 4. (Optional) Add domain-specific instructions
123
+ | Flag | Description |
124
+ | -------------------- | ---------------------------- |
125
+ | `--json` | Machine-readable JSON output |
126
+ | `--meta-repo <path>` | Path or URL to the meta-repo |
127
+ | `-v` | Verbose diagnostics (stderr) |
244
128
 
245
- Create technology-specific instruction files scoped to certain file patterns via `applyTo` frontmatter:
129
+ ### Exit codes
246
130
 
247
- ```yaml
248
- ---
249
- applyTo: "apps/my-app/src/**/*.tsx"
250
- ---
251
- # Your project-specific component conventions here
252
- ```
131
+ | Code | Meaning |
132
+ | ---- | ------------------------------------------------- |
133
+ | 0 | OK |
134
+ | 1 | Unexpected error |
135
+ | 2 | Incorrect usage |
136
+ | 13 | Incomplete extraction: required fields unresolved |
137
+ | 14 | Reconciliation conflict (edited fields) |
253
138
 
254
139
  ---
255
140
 
256
- ## Workflow Chains
141
+ ## `dev-tasks` Command Reference
257
142
 
258
- These diagrams show how agents hand off to one another for each type of work. Match your situation to a chain below, then invoke the first agent in the chain — it drives the rest of the flow. The per-agent details are in the [Agents](#agents) reference that follows.
259
-
260
- ### Agent Interaction Overview
261
-
262
- ```mermaid
263
- flowchart TD
264
- %% Agents
265
- PE[product-engineer]
266
- DEV[developer]
267
- PL[planner]
268
- UX[ux-engineer]
269
- VD[verifier\nDesign Mode]
270
- VA[verifier\nAudit Mode]
271
- GO[github-ops]
272
- TW[technical-writer]
273
- HK[housekeeping]
274
-
275
- %% Skills (grouped)
276
- subgraph "product-engineer skills"
277
- S_INIT[activity-init]
278
- S_REFINE[activity-refine]
279
- S_SPEC[activity-generate-spec]
280
- S_STORIES[activity-generate-stories]
281
- S_PUBLISH[activity-publish-github]
282
- S_DRIFT[activity-drift-reconciliation]
283
- end
284
-
285
- subgraph "verifier skills"
286
- S_E2E[activity-e2e-test-design]
287
- S_CONTRACT[activity-contract-test-design]
288
- S_EDGE[activity-edge-case-refinement]
289
- S_RANDOM[activity-random-test-tactics]
290
- end
291
-
292
- subgraph "shared skills"
293
- S_GITOPS[git-ops]
294
- S_MEMO[memo-cli-usage]
295
- S_MOCKUP[webapp-mockup]
296
- end
297
-
298
- %% Main workflow: product-engineer → developer
299
- PE -->|"PRD → spec → stories → plan"| DEV
300
- PE -->|"multi-story plan"| PL
301
- PL -->|"delegates per story"| DEV
302
-
303
- %% UX loop
304
- PE -->|"spec"| UX
305
- UX -->|"gap analysis & refinements"| PE
306
-
307
- %% Verifier design mode (test-first)
308
- PE -->|"spec/stories"| VD
309
- VD -->|"test plan"| DEV
310
-
311
- %% Mandatory audit before PR
312
- DEV -->|"PR ready"| VA
313
- VA -->|"fidelity report"| DEV
314
-
315
- %% Drift reconciliation
316
- VA -.->|"drift findings\n(non-blocking)"| PE
317
-
318
- %% Skill usage
319
- PE --- S_INIT & S_REFINE & S_SPEC & S_STORIES & S_PUBLISH & S_DRIFT
320
- VD --- S_E2E & S_CONTRACT & S_EDGE & S_RANDOM
321
- DEV --- S_GITOPS & S_MEMO
322
- PL --- S_GITOPS
323
- UX --- S_MOCKUP
324
- TW --- S_MEMO
325
- PE --- S_MEMO
326
-
327
- %% GitHub-ops supports all agents
328
- GO -.->|"issues, PRs, labels"| PE
329
- GO -.->|"issues, PRs, labels"| DEV
330
- GO -.->|"issues, PRs, labels"| PL
143
+ ```bash
144
+ dev-tasks install [--pin <version>] # Install skill files + write manifest
145
+ dev-tasks update [--force] # Reconcile with hash-based conflict detection
146
+ dev-tasks status # Compare installed/pinned/latest versions
147
+ dev-tasks pin <version> # Pin to a specific version
148
+ dev-tasks unpin # Remove the version pin
149
+ dev-tasks doctor # Check Node ≥20, git ≥2.37, cache writable
150
+ dev-tasks migrate # Migrate from legacy shell-script install
331
151
  ```
332
152
 
333
- **Reading the diagram:**
334
-
335
- - Solid arrows → direct handoffs between agents
336
- - Dashed arrows → supporting/non-blocking interactions
337
- - Boxes at the bottom → skills invoked by each agent
338
- - The `verifier` audit before every PR is mandatory and non-skippable
153
+ ### Version Pinning
339
154
 
340
- ### Full Feature (PRD-Driven)
155
+ Pin locks your project to a specific version. When pinned, `update` fetches the pinned version from the npm registry and reconciles against it — even if your locally installed package is newer:
341
156
 
342
- ```
343
- product-engineer: refine → generate-spec → generate-stories → publish-github → plan
344
- ↓
345
- developer: implement
157
+ ```bash
158
+ dev-tasks pin 0.5.0 # Lock to 0.5.0
159
+ dev-tasks update # Fetches 0.5.0 from registry and reconciles against it
160
+ dev-tasks unpin # Remove the pin (update will use the local package version)
346
161
  ```
347
162
 
348
- ### Single GitHub Issue
163
+ ### Options (install / update)
349
164
 
350
- ```
351
- product-engineer: refine → plan
352
- ↓
353
- developer: implement
354
- ```
165
+ | Option | Description |
166
+ | ------------------ | ---------------------------------------------------- |
167
+ | `--profile <name>` | `copilot` \| `claude` \| `kiro` \| `both` \| `all` |
168
+ | `--dry-run` | Print planned changes without writing any files |
169
+ | `--backup` | Backup managed files before replacing |
170
+ | `--yes` | Skip confirmation prompts (useful in CI) |
171
+ | `--pin <version>` | Pin to a specific release version |
172
+ | `--force` | Accept all upstream changes without conflict prompts |
355
173
 
356
- ### Multi-Story Orchestration
174
+ ---
357
175
 
358
- ```
359
- product-engineer: ... → plan
360
- ↓
361
- planner: orchestrate → developer: implement (per story, sequential)
362
- ```
176
+ ## The Core Idea
363
177
 
364
- ### Quick Fix
178
+ This system brings structure and clarity to AI-assisted development by:
365
179
 
366
- ```
367
- developer: implement
368
- ```
180
+ - Defining scope with Product Requirements Documents (PRDs)
181
+ - Breaking requirements into actionable, implementation-ready tasks
182
+ - Guiding the AI to tackle one task at a time with checkpoints for review
183
+ - Providing specialized **agents** that orchestrate the workflow end-to-end
184
+ - Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
369
185
 
370
- ### UX Validation Loop
186
+ ---
371
187
 
372
- ```
373
- product-engineer: refine → generate-spec → ux-engineer: mockups → product-engineer: update
374
- ```
188
+ ## Taxonomy: Agent vs Skill vs Instruction
375
189
 
376
- ### Test-First Design (Verifier)
190
+ | Concept | Purpose | Loaded When |
191
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
192
+ | **Agent** | Autonomous role with decision-making, phases, and handoff discipline. Owns a workflow end-to-end. | Invoked by name (`@agent`) |
193
+ | **Skill** | Reusable on-demand capability. Describes _procedures_ or _activities_ that any agent can invoke when needed. Not loaded unless referenced. | On demand (invoked by agent or prompt) |
194
+ | **Instruction** | Always-loaded rule scoped via `applyTo` frontmatter. Enforced automatically for every matching context. | Always (auto-applied by runtime) |
377
195
 
378
- ```
379
- product-engineer: refine → spec → stories → plan
380
- ↓
381
- verifier (design mode): generate test plan (from spec or stories)
382
- ↓
383
- developer/planner: implement (feature + tests from test plan)
384
- ↓ (automatic, mandatory, non-skippable)
385
- verifier (audit mode): grey-box fidelity audit → fidelity report
386
- ↓ (drift findings, non-blocking)
387
- product-engineer: activity-drift-reconciliation
388
- ```
196
+ **Key distinctions:**
197
+
198
+ - Skills save context window space — they are loaded only when invoked, unlike instructions which are always present.
199
+ - Agent files define _who_ (identity, phases, handoff rules). Skill files define _how_ (procedures, templates, steps).
200
+ - Instructions are for cross-cutting rules that must never be forgotten (e.g., implementation discipline, planning format).
389
201
 
390
202
  ---
391
203
 
@@ -393,7 +205,7 @@ developer/planner: implement (feature + tests from test plan)
393
205
 
394
206
  Agents are autonomous personas that orchestrate skills and activities.
395
207
 
396
- > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). All three platforms define the same 8 agents below. On Kiro, each agent file also embeds an "Invocation Modes" section (see [Prompts](#prompts)).
208
+ > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). All three platforms define the same 8 agents below.
397
209
 
398
210
  ### `product-engineer`
399
211
 
@@ -403,37 +215,35 @@ Preparation agent — owns the full pre-coding chain:
403
215
  - **Feature Mode**: `activity-refine` → `activity-generate-spec` → `activity-generate-stories` → `activity-publish-github` → `plan`
404
216
  - **Issue Mode**: `activity-refine` → `plan`
405
217
 
406
- Also owns drift reconciliation: routes `verifier` drift findings handed off by `developer`/`planner` into task-list/checklist expansion, new GitHub issues, or human-confirmed PRD/spec changelog updates via `activity-drift-reconciliation`.
407
-
408
- Hands off to `developer` or `planner` for execution.
218
+ Also owns drift reconciliation via `activity-drift-reconciliation`.
409
219
 
410
220
  ### `developer`
411
221
 
412
- Execution agent — implements code from an existing task list. Runs `implement`, which includes a mandatory, non-skippable `verifier` audit (`audit` mode) before every PR is marked ready — this is automatic, not optional. Uses `git-ops` for branch management.
222
+ Execution agent — implements code from an existing task list. Runs `implement`, including a mandatory `verifier` audit before every PR is marked ready. Uses `git-ops` for branch management.
413
223
 
414
224
  ### `planner`
415
225
 
416
226
  Multi-story orchestration with checkpoint/resume:
417
227
 
418
- | Phase | What Happens |
419
- | ----- | ---------------------------------------------------------------------------------------------------------- |
420
- | 0 | Discover task source |
421
- | 0.5 | Resume detection — checks for existing checkpoint state file |
422
- | 1 | Parse stories and infer dependencies |
423
- | 2 | Dependency graph — **user approval required** |
424
- | 3 | Pre-flight — creates integration branch |
425
- | 4 | Delegate to `developer` per story (each gated on a mandatory `verifier` audit); merge and write checkpoint |
426
- | 5 | PRD-level rollup `verifier` audit, then consolidated PR to `main` — **user must approve** |
228
+ | Phase | What Happens |
229
+ | ----- | ----------------------------------------------------------------- |
230
+ | 0 | Discover task source |
231
+ | 0.5 | Resume detection |
232
+ | 1 | Parse stories and infer dependencies |
233
+ | 2 | Dependency graph — user approval required |
234
+ | 3 | Pre-flight — creates integration branch |
235
+ | 4 | Delegate to `developer` per story; merge and write checkpoint |
236
+ | 5 | PRD-level rollup `verifier` audit, then consolidated PR to `main` |
427
237
 
428
238
  ### Other Agents
429
239
 
430
- | Agent | Purpose |
431
- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
432
- | `ux-engineer` | PRD/SPEC-to-mockup — feeds refinements back to `product-engineer` |
433
- | `technical-writer` | Documentation maintenance |
434
- | `housekeeping` | Lint, type, and test-wiring fixes |
435
- | `github-ops` | GitHub consistency — issues, PRs, branches, labels, milestones |
436
- | `verifier` | Verification agent — compliance test-plan design (`design` mode) and post-implementation grey-box fidelity auditing (`audit` mode) against codebase, `/workstream`, tests, and PRD/spec intent |
240
+ | Agent | Purpose |
241
+ | ------------------ | -------------------------------------------------- |
242
+ | `ux-engineer` | PRD/SPEC-to-mockup prototyping |
243
+ | `technical-writer` | Documentation maintenance |
244
+ | `housekeeping` | Lint, type, and test-wiring fixes |
245
+ | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
246
+ | `verifier` | Compliance test-plan design and fidelity auditing |
437
247
 
438
248
  ---
439
249
 
@@ -441,30 +251,26 @@ Multi-story orchestration with checkpoint/resume:
441
251
 
442
252
  On-demand capabilities loaded only when invoked.
443
253
 
444
- > **Available for:** Copilot (`.github/skills/<name>/SKILL.md`), Claude Code (`.claude/skills/<name>/SKILL.md`), Kiro (`.kiro/skills/<name>/SKILL.md`). Same 13 skills on all three platforms.
445
-
446
- | Skill | Purpose | Consumer |
447
- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
448
- | `activity-init` | Product context and technical guidelines | `product-engineer` |
449
- | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
450
- | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
451
- | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
452
- | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
453
- | `activity-drift-reconciliation` | Routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates | `product-engineer` |
454
- | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
455
- | `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
456
- | `activity-e2e-test-design` | E2E black-box test scenario generation from spec/stories | `verifier` |
457
- | `activity-contract-test-design` | Consumer/provider contract and schema compatibility testing | `verifier` |
458
- | `activity-edge-case-refinement` | Systematic edge-case discovery by category with examples | `verifier` |
459
- | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired test generation | `verifier` |
460
- | `memo-cli-usage` | Shared architectural memory with `memo-cli` (read session context, write intent/outcome and ADR/decision rationale) | `product-engineer`, `developer`, `technical-writer` |
254
+ | Skill | Purpose | Consumer |
255
+ | ------------------------------- | ----------------------------------------------- | --------------------------------------------------- |
256
+ | `activity-init` | Product context and technical guidelines | `product-engineer` |
257
+ | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
258
+ | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
259
+ | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
260
+ | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
261
+ | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
262
+ | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
263
+ | `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
264
+ | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
265
+ | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
266
+ | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
267
+ | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
268
+ | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
461
269
 
462
270
  ---
463
271
 
464
272
  ## Instructions (Always-Loaded)
465
273
 
466
- > **Available for:** Copilot (`.github/instructions/*.instructions.md`, scoped via `applyTo`), Claude Code (`plan` and `implement` are on-demand skills instead of always-loaded instructions — see `CLAUDE.md`), Kiro (`.kiro/steering/*.md`, called "steering" and scoped via `inclusion: always|fileMatch` + `fileMatchPattern`, the Kiro analogue of `applyTo`). Kiro's steering set has a 4th file, `git-guard-notice.md` (`inclusion: always`), with no equivalent on Copilot or Claude Code — it discloses a Kiro-specific hook enforcement gap.
467
-
468
274
  | Instruction | Scope | Purpose |
469
275
  | ------------------------------------------------ | ---------- | -------------------------------------- |
470
276
  | `plan.instructions.md` | `**` | Convert stories/issues into task lists |
@@ -475,361 +281,211 @@ On-demand capabilities loaded only when invoked.
475
281
 
476
282
  ## Prompts
477
283
 
478
- > **Available for:** Copilot (`.github/prompts/*.prompt.md`), Claude Code (`.claude/commands/*.md`, invoked with `/command-name`). Kiro has no separate "prompts" concept — the 12 invocation modes below are folded directly into the corresponding `.kiro/agents/*.md` file as an "Invocation Modes" section instead of standalone files.
479
-
480
- | Prompt | Agent | Purpose |
481
- | -------------------------- | ---------------- | ----------------------------------------------------------------------------------------------- |
482
- | `product-engineer-init` | product-engineer | Initialize foundation documents |
483
- | `product-engineer-feature` | product-engineer | Design and plan a feature |
484
- | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
485
- | `developer-execute` | developer | Execute an existing task list |
486
- | `planner` | planner | Orchestrate multi-story execution |
487
- | `planner-resume` | planner | Resume from checkpoint |
488
- | `ux-engineer` | ux-engineer | Generate UX mockups |
489
- | `github-ops` | github-ops | GitHub consistency |
490
- | `technical-writer` | technical-writer | Documentation maintenance |
491
- | `housekeeping` | housekeeping | Lint, type, test fixes |
492
- | `verifier-design` | verifier | Generate compliance test plan from spec or stories (Design Mode) |
493
- | `verifier-audit` | verifier | Grey-box fidelity audit of delivered work against spec/stories and PRD/spec intent (Audit Mode) |
284
+ > Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
285
+
286
+ | Prompt | Agent | Purpose |
287
+ | -------------------------- | ---------------- | --------------------------------- |
288
+ | `product-engineer-init` | product-engineer | Initialize foundation documents |
289
+ | `product-engineer-feature` | product-engineer | Design and plan a feature |
290
+ | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
291
+ | `developer-execute` | developer | Execute an existing task list |
292
+ | `planner` | planner | Orchestrate multi-story execution |
293
+ | `planner-resume` | planner | Resume from checkpoint |
294
+ | `ux-engineer` | ux-engineer | Generate UX mockups |
295
+ | `github-ops` | github-ops | GitHub consistency |
296
+ | `technical-writer` | technical-writer | Documentation maintenance |
297
+ | `housekeeping` | housekeeping | Lint, type, test fixes |
298
+ | `verifier-design` | verifier | Generate compliance test plan |
299
+ | `verifier-audit` | verifier | Grey-box fidelity audit |
494
300
 
495
301
  ---
496
302
 
497
- ## File Organization
498
-
499
- | Directory | Contents |
500
- | ------------------------------ | ------------------------------------------------------------------------------------------------- |
501
- | `/docs/` | Foundation documents — product-context, technical-guidelines, ADRs |
502
- | `/docs/requirements/` | PRDs produced by the refine skill |
503
- | `/workstream/` | Active feature work — specs, stories, task lists, planner state files |
504
- | `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
505
- | `core/` | Business logic library (extract, distribution, reconcile) — no CLI deps |
506
- | `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
507
- | `schemas/` | JSON Schemas for validation (`component.schema.json`) |
508
- | `test/` | Unit and integration tests + fixture repos |
509
- | `.github/instructions/` | Always-loaded instruction files |
510
- | `.github/instructions/domain/` | Project-specific coding standards (auto-applied) |
511
- | `.github/agents/` | Agent definition files |
512
- | `.github/skills/` | On-demand skill definitions |
513
- | `.github/prompts/` | Agent invocation prompts |
514
- | `.kiro/steering/` | Always-loaded/file-matched steering docs (Kiro's instructions equivalent; `--profile kiro`/`all`) |
515
- | `.kiro/agents/` | Agent definition files, with invocation modes folded in (`--profile kiro`/`all`) |
516
- | `.kiro/skills/` | On-demand skill definitions (`--profile kiro`/`all`) |
517
- | `.kiro/hooks/` | Guard hook definition + script (`--profile kiro`/`all`) |
518
-
519
- ---
520
-
521
- ## Tips
522
-
523
- - Use `step-gated` mode (default) to review each sub-task
524
- - Use `pre-approved autonomous batch` mode when you trust the agent to run autonomously
525
- - Use `planner-resume` when a multi-story orchestration is interrupted
526
- - Run `housekeeping` after major feature branches to catch regressions
527
- - Domain instructions are auto-applied based on `applyTo` patterns
303
+ ## Workflow Chains
528
304
 
529
- ## memo-cli Integration (Optional)
305
+ Match your situation to a chain below, then invoke the first agent in the chain.
530
306
 
531
- When `memo-cli` is installed and configured, this workflow supports shared context across sessions, agents, and repositories.
307
+ ### Full Feature (PRD-Driven)
532
308
 
533
- - `product-engineer` reads context from memo at session start and before major design choices.
534
- - `developer` writes an `intent` entry before story implementation and an `outcome` entry after completion.
535
- - `technical-writer` writes one memo entry per ADR and per significant technical documentation change.
309
+ ```
310
+ product-engineer: refine → generate-spec → generate-stories → publish-github → plan
311
+ ↓
312
+ developer: implement
313
+ ```
536
314
 
537
- Recommended startup check:
315
+ ### Single GitHub Issue
538
316
 
539
- ```bash
540
- which memo && memo setup validate
317
+ ```
318
+ product-engineer: refine → plan
319
+ ↓
320
+ developer: implement
541
321
  ```
542
322
 
543
- If `memo` is installed but validation fails, configure the repo first:
323
+ ### Multi-Story Orchestration
544
324
 
545
- ```bash
546
- memo setup init --repo <repo-name> --org <org-name> --domain <domain>
325
+ ```
326
+ product-engineer: ... → plan
327
+ ↓
328
+ planner: orchestrate → developer: implement (per story, sequential)
547
329
  ```
548
330
 
549
- Use `--scope related` for cross-repo context when `relates_to` is configured in `memo.config.json`.
331
+ ### Quick Fix
550
332
 
551
- ### Formatting
333
+ ```
334
+ developer: implement
335
+ ```
552
336
 
553
- Use the repo-local formatter wrapper for tracked Markdown, JSON, and YAML files:
337
+ ### Test-First Design (Verifier)
554
338
 
555
- ```bash
556
- ./scripts/format.sh --check
557
- ./scripts/format.sh --write
558
339
  ```
559
-
560
- The script uses `prettier` from your `PATH` when available and falls back to `npx --yes prettier` otherwise.
340
+ product-engineer: spec → stories → plan
341
+ ↓
342
+ verifier (design mode): generate test plan
343
+ ↓
344
+ developer: implement (tests first, then code)
345
+ ↓ (mandatory)
346
+ verifier (audit mode): fidelity audit → report
347
+ ↓ (drift findings, non-blocking)
348
+ product-engineer: drift-reconciliation
349
+ ```
561
350
 
562
351
  ---
563
352
 
564
- ## Distribution & Script Reference
565
-
566
- The toolkit is distributed as a versioned tarball via **GitHub Releases**. `dev-tasks.sh` is the single installer/updater — no runtime beyond standard POSIX tools (`curl`, `tar`, `shasum`) is required.
567
-
568
- ### Commands
569
-
570
- | Command | Description |
571
- | ---------------------------------- | -------------------------------------------------------- |
572
- | `./dev-tasks.sh install [version]` | Install latest or a pinned version |
573
- | `./dev-tasks.sh update [version]` | Update managed files to the latest or a specific version |
574
- | `./dev-tasks.sh check` | Compare installed version vs latest release |
575
- | `./dev-tasks.sh list` | List installed directories, files, and metadata |
576
- | `./dev-tasks.sh version` | Print installed version and script version |
577
-
578
- ### Options (install / update)
579
-
580
- | Option | Description |
581
- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
582
- | `--profile <name>` | Install/update file sets: `copilot` \| `claude` \| `kiro` \| `both` \| `all` (default: `both`, meaning Copilot + Claude only) |
583
- | `--dry-run` | Print planned changes without writing any files |
584
- | `--backup` | Copy managed files to `.dev-tasks-backup/<timestamp>/` before replacing |
585
- | `--yes` | Skip confirmation prompts (useful in CI) |
586
-
587
- > **Kiro guard hook — enforcement gap disclosure:** `--profile kiro`/`all` installs `.kiro/hooks/git-guard.json` + `.kiro/hooks/scripts/git-guard.sh`, a best-effort port of `.claude/hooks/git-guard.sh` that blocks pushes/merges to `main`, non-Conventional-Commit messages, and inline `--body` on `gh issue`/`pr create|edit|comment|review` (must use `--body-file`, which prevents markdown-flattening in PR/issue bodies). **This hook is not guaranteed to be equivalent to `.claude/hooks/git-guard.sh`.** A tracked upstream Kiro defect (kirodotdev/Kiro#7375) may prevent Kiro IDE's `PreToolUse` hook from seeing command text, in which case it cannot reliably block anything; when it can't see command context it fails loud (stderr warning) rather than silently allowing. Until this is verified fixed on a live Kiro install, treat PR review as the actual enforcement backstop for these rules on Kiro. See `.kiro/steering/git-guard-notice.md` for the full disclosure.
588
-
589
- ### Managed file surface
590
-
591
- The script owns these paths and may overwrite them on update:
592
-
593
- | Path | Contents |
594
- | ------------------------------------------------- | -------------------------------------------------------------------------------- |
595
- | `.github/agents/*.agent.md` | Agent definitions |
596
- | `.github/skills/*/SKILL.md` | Activity and operational skills |
597
- | `.github/instructions/*.instructions.md` | Always-loaded instructions |
598
- | `.github/instructions/domain/` | Domain-specific instructions |
599
- | `.github/prompts/*.prompt.md` | Prompt entry points |
600
- | `.kiro/agents/*.md` | Agent definitions (installed with `--profile kiro`/`all`) |
601
- | `.kiro/skills/*/SKILL.md` | Activity and operational skills (installed with `--profile kiro`/`all`) |
602
- | `.kiro/steering/*.md` | Always-loaded/file-matched steering docs (installed with `--profile kiro`/`all`) |
603
- | `.kiro/hooks/*.json` + `.kiro/hooks/scripts/*.sh` | Guard hook definition and script (installed with `--profile kiro`/`all`) |
604
- | `.dev-tasks-version` | Installed version metadata |
353
+ ## File Organization
605
354
 
606
- **Never touched by the script:** `AGENTS.md` — the script prints an integration prompt instead (see below).
355
+ | Directory | Contents |
356
+ | --------------------- | ------------------------------------------------------- |
357
+ | `/docs/` | Foundation docs — product-context, technical-guidelines |
358
+ | `/docs/requirements/` | PRDs produced by the refine skill |
359
+ | `/workstream/` | Active feature work — specs, stories, task lists |
360
+ | `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
361
+ | `core/` | Business logic library (extract, distribution) |
362
+ | `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
363
+ | `schemas/` | JSON Schemas for validation |
364
+ | `test/` | Unit and integration tests + fixtures |
365
+ | `.github/` | Copilot agents, skills, instructions, prompts |
366
+ | `.kiro/` | Kiro agents, skills, steering, hooks |
607
367
 
608
- ### AGENTS.md integration prompt
368
+ ---
609
369
 
610
- After every install or update, the script prints a `=== AGENTS.md Integration ===` block showing the diff between the bundled reference `AGENTS.md` and your local copy. It also saves the reference to `.dev-tasks-agents-update.md`. The script **never** silently overwrites your `AGENTS.md` — you decide what to merge.
370
+ ## memo-cli Integration (Optional)
611
371
 
612
- ### Version pinning and rollback
372
+ When `memo-cli` is installed and configured, agents share context across sessions and repositories.
613
373
 
614
374
  ```bash
615
- # Pin to a specific version
616
- ./dev-tasks.sh install v0.1.3
617
-
618
- # Update with backup so you can roll back manually
619
- ./dev-tasks.sh update --backup
620
-
621
- # Roll back: restore from backup
622
- cp -r .dev-tasks-backup/<timestamp>/. ./
375
+ which memo && memo setup validate
623
376
  ```
624
377
 
625
- ### Version metadata file
626
-
627
- `.dev-tasks-version` is written after every install/update:
378
+ If `memo` is installed but validation fails:
628
379
 
629
- ```json
630
- {
631
- "version": "1.2.0",
632
- "installed_at": "2026-04-20T12:00:00Z",
633
- "script_version": "1.0.0",
634
- "source": "https://github.com/llipe/dev-tasks"
635
- }
380
+ ```bash
381
+ memo setup init --repo <repo-name> --org <org-name> --domain <domain>
636
382
  ```
637
383
 
638
- ### Release publishing (maintainers)
384
+ ---
639
385
 
640
- Every git tag matching `v*.*.*` triggers two workflows:
386
+ ## Known Limitations
641
387
 
642
- - `.github/workflows/release-bundle.yml` — builds the tarball bundle and creates a GitHub Release
643
- - `.github/workflows/publish-npm.yml` — publishes the `@llipe.com/dev-tasks` npm package
388
+ - **Route 2 (isolated framework boot) is interface-only** — only routes 1 and 3 are functional for OpenAPI extraction.
389
+ - **LLM inference is stubbed** — no real LLM provider is wired yet.
390
+ - **Only Node/TS provider** — other language stacks require additional extraction providers.
391
+ - **Zod extraction handles basic `z.object` patterns only** — complex compositions are not fully supported.
392
+ - **Only kafkajs patterns supported** — other messaging clients are not detected.
644
393
 
645
- #### How to create a new release
394
+ ---
646
395
 
647
- Use the release automation script:
396
+ ## Tips
648
397
 
649
- ```bash
650
- git checkout main
651
- git pull origin main
652
- ./scripts/release.sh patch # or minor / major
653
- ```
398
+ - Use `step-gated` mode (default) to review each sub-task
399
+ - Use `pre-approved autonomous batch` mode when you trust the agent to run autonomously
400
+ - Use `planner-resume` when a multi-story orchestration is interrupted
401
+ - Run `housekeeping` after major feature branches to catch regressions
402
+ - Domain instructions are auto-applied based on `applyTo` patterns
654
403
 
655
- The script:
404
+ ---
656
405
 
657
- 1. Validates pre-flight conditions (branch, clean tree, format check).
658
- 2. Auto-generates a CHANGELOG.md entry from commit history and merged PR metadata.
659
- 3. Suggests an increment type based on Conventional Commit analysis.
660
- 4. Updates `package.json` version to the new semver value.
661
- 5. Commits both CHANGELOG.md and package.json (`chore(release): v<version>`).
662
- 6. Creates an annotated git tag.
663
- 7. Pushes the commit to `main` and the tag to `origin`.
664
- 8. The tag push triggers both CI workflows automatically.
406
+ ## Contributing
665
407
 
666
- After the workflows complete, verify:
408
+ ### Prerequisites
667
409
 
668
- - GitHub Release contains `dev-tasks-bundle-v<version>.tar.gz` + `.sha256`
669
- - npm package is published: `npm view @llipe.com/dev-tasks version`
410
+ - Node.js >= 20
411
+ - pnpm (via `corepack enable`)
412
+ - git >= 2.37
670
413
 
671
- Optional post-release validation:
414
+ ### Setup
672
415
 
673
416
  ```bash
674
- ./dev-tasks.sh install v1.3.0
417
+ git clone https://github.com/llipe/dev-tasks.git
418
+ cd dev-tasks
419
+ pnpm install
675
420
  ```
676
421
 
677
- #### CI setup required
678
-
679
- The npm publish workflow uses **Trusted Publishers (OIDC)** — no npm token secret is needed. Configure once on npmjs.com:
680
-
681
- 1. Go to npmjs.com → Packages → `@llipe.com/dev-tasks` → Settings → Trusted Publisher
682
- 2. Select **GitHub Actions** and fill in:
683
- - Organization or user: `llipe`
684
- - Repository: `dev-tasks`
685
- - Workflow filename: `publish-npm.yml`
686
- - Environment name: `npm`
687
- - Allowed actions: npm publish
688
-
689
- Also create a GitHub environment named `npm` in the repo (Settings → Environments → New environment → `npm`). No secrets needed.
690
-
691
- #### Option: download assets directly from the Releases page
692
-
693
- If you prefer manual installation, download the bundle and checksum from:
694
-
695
- - https://github.com/llipe/dev-tasks/releases
696
-
697
- Example for a specific version:
422
+ ### Build
698
423
 
699
424
  ```bash
700
- VERSION=v1.3.0
701
- BASE_URL="https://github.com/llipe/dev-tasks/releases/download/${VERSION}"
702
-
703
- curl -fL -o "dev-tasks-bundle-${VERSION}.tar.gz" \
704
- "${BASE_URL}/dev-tasks-bundle-${VERSION}.tar.gz"
705
- curl -fL -o "dev-tasks-bundle-${VERSION}.tar.gz.sha256" \
706
- "${BASE_URL}/dev-tasks-bundle-${VERSION}.tar.gz.sha256"
707
-
708
- # Verify checksum
709
- shasum -a 256 -c "dev-tasks-bundle-${VERSION}.tar.gz.sha256"
710
-
711
- # Extract
712
- tar -xzf "dev-tasks-bundle-${VERSION}.tar.gz"
425
+ pnpm run build # compile TypeScript to dist/
426
+ pnpm run typecheck # type-check without emitting
713
427
  ```
714
428
 
715
- ---
716
-
717
- ## `dt` — Multi-Repo Context CLI
718
-
719
- `dt` is the runtime binary for the `@llipe.com/dev-tasks` npm package. It extracts repository metadata (schema, OpenAPI, AsyncAPI), derives a `component.json` manifest with provenance and confidence tracking, and (in later phases) builds a cross-repo catalog and resolves scoped context bundles for agent sessions.
720
-
721
- ### Installation
429
+ ### Test
722
430
 
723
431
  ```bash
724
- # Install globally (or as a dev dependency)
725
- pnpm add -g @llipe.com/dev-tasks
726
-
727
- # Verify
728
- dt --version
729
- dev-tasks --version
432
+ pnpm run test # all tests (vitest)
433
+ pnpm run test:unit # unit tests only
434
+ pnpm run test:integration # integration tests only
730
435
  ```
731
436
 
732
- Two binaries are provided:
733
-
734
- | Binary | Purpose |
735
- | ----------- | --------------------------------------------------- |
736
- | `dev-tasks` | Bootstrap: install, update, status, pin, doctor |
737
- | `dt` | Runtime: extract, catalog, ctx, scope, init, verify |
738
-
739
- ### Commands
740
-
741
- #### `dt extract` — Repository metadata extraction
437
+ ### Lint and Format
742
438
 
743
439
  ```bash
744
- # Detect stack, framework, ORM, and messaging with evidence
745
- dt extract detect
746
-
747
- # Extract database schema from ORM definitions (Prisma, Drizzle, TypeORM)
748
- dt extract schema [--db-url <url>]
749
-
750
- # Extract OpenAPI spec (route 1: copy existing, route 3: AST inference)
751
- dt extract openapi [--strategy auto|1|3]
752
-
753
- # Extract AsyncAPI spec from Kafka topic patterns (kafkajs)
754
- dt extract asyncapi
755
-
756
- # Derive component.json with provenance and confidence
757
- dt extract component [--interactive]
758
-
759
- # Run full extraction pipeline (detect → schema → openapi → asyncapi → component → report)
760
- dt extract all [--interactive] [--force]
440
+ pnpm run lint # ESLint (zero warnings)
441
+ pnpm run lint:fix # auto-fix lint issues
442
+ pnpm run format:check # Prettier check
443
+ pnpm run format # Prettier write
761
444
  ```
762
445
 
763
- #### `dev-tasks` — Bootstrap and distribution
446
+ ### Full validation (CI equivalent)
764
447
 
765
448
  ```bash
766
- dev-tasks install [--pin <version>] # Install skill files + write manifest
767
- dev-tasks update [--force] # Reconcile with hash-based conflict detection
768
- dev-tasks status # Compare installed/pinned/latest versions
769
- dev-tasks pin <version> # Pin to a specific version
770
- dev-tasks doctor # Check Node ≥20, git ≥2.37, cache writable
771
- dev-tasks migrate # Migrate from legacy dev-tasks.sh
449
+ pnpm run validate # typecheck + lint + format:check + test
772
450
  ```
773
451
 
774
- ### Global options
452
+ ### Releasing a new version
775
453
 
776
- All commands accept:
777
-
778
- | Flag | Description |
779
- | -------------------- | ---------------------------- |
780
- | `--json` | Machine-readable JSON output |
781
- | `--meta-repo <path>` | Path or URL to the meta-repo |
782
- | `-v` | Verbose diagnostics (stderr) |
783
-
784
- ### Exit codes
785
-
786
- | Code | Meaning |
787
- | ---- | ------------------------------------------------- |
788
- | 0 | OK |
789
- | 1 | Unexpected error |
790
- | 2 | Incorrect usage |
791
- | 13 | Incomplete extraction: required fields unresolved |
792
- | 14 | Reconciliation conflict (edited fields) |
793
-
794
- ### Typical workflow
454
+ Releases are automated via git tags. Use the release script:
795
455
 
796
456
  ```bash
797
- # 1. Run extraction in a component repo
798
- cd my-service
799
- dt extract all --interactive
800
-
801
- # 2. Review outputs
802
- cat component.json # manifest with _provenance
803
- cat extraction_report.json # coverage, confidence, unresolved items
804
-
805
- # 3. Validate
806
- dt validate-component # (Phase 2+) checks against JSON Schema
807
-
808
- # 4. Commit and push
809
- git add component.json contracts/ docs/schema.md extraction_report.json
810
- git commit -m "feat: add component manifest via dt extract"
457
+ git checkout main
458
+ git pull origin main
459
+ ./scripts/release.sh patch # or: minor / major
811
460
  ```
812
461
 
813
- ### Current implementation status
462
+ The script:
814
463
 
815
- Phase 0 (distribution) and Phase 1 (extraction) are implemented. The following are available:
464
+ 1. Validates pre-flight conditions (branch, clean tree, format check).
465
+ 2. Auto-generates a CHANGELOG entry from commit history.
466
+ 3. Updates `package.json` version.
467
+ 4. Commits (`chore(release): v<version>`), creates an annotated tag, and pushes.
468
+ 5. The tag push triggers CI workflows:
469
+ - `.github/workflows/release-bundle.yml` — builds the tarball and creates a GitHub Release
470
+ - `.github/workflows/publish-npm.yml` — publishes to npm as `@llipe.com/dev-tasks`
816
471
 
817
- - `dev-tasks install|update|status|pin|doctor|migrate`
818
- - `dt extract detect|schema|openapi|asyncapi|component|all`
819
- - Hash-based reconciliation with conflict detection
820
- - Legacy shell-script migration shim
472
+ After the workflows complete, verify:
821
473
 
822
- Phases 2-5 (catalog, context, scoping, product-engineer integration) are specified but not yet implemented.
474
+ ```bash
475
+ npm view @llipe.com/dev-tasks version
476
+ ```
823
477
 
824
- ---
478
+ ### CI setup (npm Trusted Publishers)
825
479
 
826
- ## Known Limitations
480
+ The npm publish workflow uses OIDC — no npm token secret needed. Configure once on npmjs.com:
827
481
 
828
- - **Route 2 (isolated framework boot) is interface-only** — the hook exists but is not implemented; only routes 1 and 3 are functional for OpenAPI extraction.
829
- - **LLM inference is stubbed** — no real LLM provider is wired yet; description passes produce placeholder output.
830
- - **Only Node/TS provider** — other language stacks (Python, Go, Java, etc.) require additional extraction providers.
831
- - **Zod extraction handles basic `z.object` patterns only** — complex Zod compositions (unions, intersections, lazy schemas) are not fully supported.
832
- - **Only kafkajs Kafka patterns supported** — other messaging clients (confluent-kafka, rhea/AMQP, bullmq) are not detected.
482
+ 1. Go to npmjs.com → `@llipe.com/dev-tasks` → Settings → Trusted Publisher
483
+ 2. Select GitHub Actions:
484
+ - Organization/user: `llipe`
485
+ - Repository: `dev-tasks`
486
+ - Workflow: `publish-npm.yml`
487
+ - Environment: `npm`
488
+ 3. Create a GitHub environment named `npm` in the repo (Settings → Environments)
833
489
 
834
490
  ---
835
491