@llipe.com/dev-tasks 0.10.0 → 0.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (620) hide show
  1. package/.claude/agents/developer.md +108 -35
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +45 -3
  5. package/.claude/agents/researcher.md +116 -0
  6. package/.claude/agents/technical-writer.md +61 -6
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +48 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +64 -28
  12. package/.claude/commands/product-engineer.md +58 -19
  13. package/.claude/commands/researcher.md +27 -0
  14. package/.claude/commands/technical-writer.md +1 -1
  15. package/.claude/hooks/branch-guard.sh +30 -0
  16. package/.claude/hooks/git-guard.sh +483 -22
  17. package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
  18. package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  19. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  20. package/.claude/skills/activity-grill/SKILL.md +150 -0
  21. package/.claude/skills/activity-init/SKILL.md +121 -71
  22. package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
  23. package/.claude/skills/activity-refine/SKILL.md +75 -15
  24. package/.claude/skills/activity-test-standards/SKILL.md +66 -0
  25. package/.claude/skills/aws-ops/SKILL.md +155 -0
  26. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  27. package/.claude/skills/fly-ops/SKILL.md +138 -0
  28. package/.claude/skills/git-ops/SKILL.md +27 -7
  29. package/.claude/skills/implement/SKILL.md +49 -4
  30. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  31. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  32. package/.claude/skills/plan/SKILL.md +43 -1
  33. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  34. package/.github/agents/developer.agent.md +80 -18
  35. package/.github/agents/github-ops.agent.md +46 -4
  36. package/.github/agents/housekeeping.agent.md +43 -7
  37. package/.github/agents/infra-engineer.agent.md +139 -0
  38. package/.github/agents/planner.agent.md +45 -9
  39. package/.github/agents/product-engineer.agent.md +58 -19
  40. package/.github/agents/qa-engineer.agent.md +43 -4
  41. package/.github/agents/researcher.agent.md +115 -0
  42. package/.github/agents/technical-writer.agent.md +60 -6
  43. package/.github/agents/verifier.agent.md +46 -5
  44. package/.github/instructions/implement.instructions.md +49 -4
  45. package/.github/instructions/plan.instructions.md +43 -1
  46. package/.github/prompts/infra-engineer.prompt.md +12 -0
  47. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  48. package/.github/prompts/researcher.prompt.md +28 -0
  49. package/.github/prompts/technical-writer.prompt.md +1 -1
  50. package/.github/skills/activity-codebase-research/SKILL.md +146 -0
  51. package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  52. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  53. package/.github/skills/activity-grill/SKILL.md +145 -0
  54. package/.github/skills/activity-init/SKILL.md +120 -70
  55. package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
  56. package/.github/skills/activity-refine/SKILL.md +75 -15
  57. package/.github/skills/activity-test-standards/SKILL.md +66 -0
  58. package/.github/skills/aws-ops/SKILL.md +150 -0
  59. package/.github/skills/deploy-ops/SKILL.md +116 -0
  60. package/.github/skills/fly-ops/SKILL.md +133 -0
  61. package/.github/skills/git-ops/SKILL.md +27 -7
  62. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  63. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  64. package/.github/skills/supabase-ops/SKILL.md +104 -0
  65. package/.kiro/agents/developer.md +81 -19
  66. package/.kiro/agents/github-ops.md +46 -4
  67. package/.kiro/agents/housekeeping.md +44 -8
  68. package/.kiro/agents/infra-engineer.md +102 -0
  69. package/.kiro/agents/planner.md +53 -20
  70. package/.kiro/agents/product-engineer.md +61 -22
  71. package/.kiro/agents/qa-engineer.md +44 -5
  72. package/.kiro/agents/researcher.md +118 -0
  73. package/.kiro/agents/technical-writer.md +63 -9
  74. package/.kiro/agents/verifier.md +48 -7
  75. package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
  76. package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  77. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  78. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  79. package/.kiro/skills/activity-init/SKILL.md +121 -71
  80. package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
  81. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  82. package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
  83. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  84. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  85. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  86. package/.kiro/skills/git-ops/SKILL.md +27 -7
  87. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  88. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  89. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  90. package/.kiro/steering/implement.md +49 -4
  91. package/.kiro/steering/plan.md +43 -1
  92. package/AGENTS.md +88 -261
  93. package/AGENTS.md.template +124 -0
  94. package/CHANGELOG.md +196 -0
  95. package/CLAUDE.md +24 -18
  96. package/CLAUDE.md.template +103 -0
  97. package/README.md +168 -145
  98. package/TESTING.md +84 -140
  99. package/bundle-manifest.json +43 -2
  100. package/dist/bin/dev-tasks.js +65 -3
  101. package/dist/bin/dev-tasks.js.map +1 -1
  102. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  103. package/dist/bin/parse-args.d.ts.map +1 -0
  104. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  105. package/dist/bin/parse-args.js.map +1 -0
  106. package/dist/core/checks/decision-log-format.d.ts +44 -0
  107. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  108. package/dist/core/checks/decision-log-format.js +171 -0
  109. package/dist/core/checks/decision-log-format.js.map +1 -0
  110. package/dist/core/checks/docs-structure.d.ts +82 -0
  111. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  112. package/dist/core/checks/docs-structure.js +285 -0
  113. package/dist/core/checks/docs-structure.js.map +1 -0
  114. package/dist/core/checks/glossary.d.ts +178 -0
  115. package/dist/core/checks/glossary.d.ts.map +1 -0
  116. package/dist/core/checks/glossary.js +651 -0
  117. package/dist/core/checks/glossary.js.map +1 -0
  118. package/dist/core/checks/index.d.ts +19 -0
  119. package/dist/core/checks/index.d.ts.map +1 -0
  120. package/dist/core/checks/index.js +16 -0
  121. package/dist/core/checks/index.js.map +1 -0
  122. package/dist/core/checks/run.d.ts +22 -0
  123. package/dist/core/checks/run.d.ts.map +1 -0
  124. package/dist/core/checks/run.js +51 -0
  125. package/dist/core/checks/run.js.map +1 -0
  126. package/dist/core/distribution/doctor.d.ts +46 -1
  127. package/dist/core/distribution/doctor.d.ts.map +1 -1
  128. package/dist/core/distribution/doctor.js +161 -2
  129. package/dist/core/distribution/doctor.js.map +1 -1
  130. package/dist/core/distribution/index.d.ts +9 -3
  131. package/dist/core/distribution/index.d.ts.map +1 -1
  132. package/dist/core/distribution/index.js +5 -2
  133. package/dist/core/distribution/index.js.map +1 -1
  134. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  135. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  136. package/dist/core/distribution/install-if-absent.js +81 -0
  137. package/dist/core/distribution/install-if-absent.js.map +1 -0
  138. package/dist/core/distribution/install.d.ts.map +1 -1
  139. package/dist/core/distribution/install.js +5 -0
  140. package/dist/core/distribution/install.js.map +1 -1
  141. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  142. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  143. package/dist/core/distribution/migrate-docs.js +139 -0
  144. package/dist/core/distribution/migrate-docs.js.map +1 -0
  145. package/dist/core/distribution/profiles.d.ts +49 -0
  146. package/dist/core/distribution/profiles.d.ts.map +1 -1
  147. package/dist/core/distribution/profiles.js +45 -0
  148. package/dist/core/distribution/profiles.js.map +1 -1
  149. package/dist/core/distribution/update.d.ts +14 -0
  150. package/dist/core/distribution/update.d.ts.map +1 -1
  151. package/dist/core/distribution/update.js +77 -3
  152. package/dist/core/distribution/update.js.map +1 -1
  153. package/dist/core/distribution/workspace.d.ts +84 -0
  154. package/dist/core/distribution/workspace.d.ts.map +1 -0
  155. package/dist/core/distribution/workspace.js +276 -0
  156. package/dist/core/distribution/workspace.js.map +1 -0
  157. package/dist/core/exit-codes.d.ts +15 -35
  158. package/dist/core/exit-codes.d.ts.map +1 -1
  159. package/dist/core/exit-codes.js +15 -36
  160. package/dist/core/exit-codes.js.map +1 -1
  161. package/dist/core/index.d.ts +1 -6
  162. package/dist/core/index.d.ts.map +1 -1
  163. package/dist/core/index.js +1 -7
  164. package/dist/core/index.js.map +1 -1
  165. package/package.json +17 -32
  166. package/templates/claude/settings.json +48 -0
  167. package/templates/domain/ubiquitous-language.md +28 -0
  168. package/templates/infra/environments.yaml +16 -0
  169. package/templates/infra/redaction-patterns.txt +47 -0
  170. package/templates/runbooks/README.md +14 -0
  171. package/templates/runbooks/runbook-template.md +40 -0
  172. package/templates/scripts/deploy-status.sh +89 -0
  173. package/templates/scripts/deploy-verify.sh +85 -0
  174. package/templates/scripts/deploy.sh +284 -0
  175. package/templates/scripts/release.sh +170 -0
  176. package/templates/scripts/rollback.sh +109 -0
  177. package/templates/workflows/deploy-dev.yml +66 -0
  178. package/templates/workflows/deploy-prod.yml +66 -0
  179. package/templates/workflows/rollback.yml +77 -0
  180. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  181. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  182. package/dist/adapters/cli/catalog-build.js +0 -73
  183. package/dist/adapters/cli/catalog-build.js.map +0 -1
  184. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  185. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  186. package/dist/adapters/cli/catalog-query.js +0 -329
  187. package/dist/adapters/cli/catalog-query.js.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  189. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  190. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  191. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  193. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  194. package/dist/adapters/cli/catalog-validate.js +0 -122
  195. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  197. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  198. package/dist/adapters/cli/ctx-assemble.js +0 -293
  199. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  201. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  202. package/dist/adapters/cli/ctx-fetch.js +0 -267
  203. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  204. package/dist/adapters/cli/extract-all.d.ts +0 -31
  205. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  206. package/dist/adapters/cli/extract-all.js +0 -374
  207. package/dist/adapters/cli/extract-all.js.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  209. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  210. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  211. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  212. package/dist/adapters/cli/extract-component.d.ts +0 -24
  213. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  214. package/dist/adapters/cli/extract-component.js +0 -198
  215. package/dist/adapters/cli/extract-component.js.map +0 -1
  216. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  217. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  218. package/dist/adapters/cli/extract-detect.js +0 -98
  219. package/dist/adapters/cli/extract-detect.js.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  221. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  222. package/dist/adapters/cli/extract-openapi.js +0 -111
  223. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  224. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  225. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  226. package/dist/adapters/cli/extract-schema.js +0 -39
  227. package/dist/adapters/cli/extract-schema.js.map +0 -1
  228. package/dist/adapters/cli/index.d.ts +0 -6
  229. package/dist/adapters/cli/index.d.ts.map +0 -1
  230. package/dist/adapters/cli/index.js +0 -5
  231. package/dist/adapters/cli/index.js.map +0 -1
  232. package/dist/adapters/cli/init.d.ts +0 -37
  233. package/dist/adapters/cli/init.d.ts.map +0 -1
  234. package/dist/adapters/cli/init.js +0 -336
  235. package/dist/adapters/cli/init.js.map +0 -1
  236. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  237. package/dist/adapters/cli/parse-args.js.map +0 -1
  238. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  239. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  240. package/dist/adapters/cli/scope-gate.js +0 -157
  241. package/dist/adapters/cli/scope-gate.js.map +0 -1
  242. package/dist/adapters/cli/scope.d.ts +0 -26
  243. package/dist/adapters/cli/scope.d.ts.map +0 -1
  244. package/dist/adapters/cli/scope.js +0 -172
  245. package/dist/adapters/cli/scope.js.map +0 -1
  246. package/dist/adapters/cli/validate-component.d.ts +0 -24
  247. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  248. package/dist/adapters/cli/validate-component.js +0 -62
  249. package/dist/adapters/cli/validate-component.js.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  251. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  252. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  253. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  254. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  255. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  256. package/dist/adapters/cli/verify-drift.js +0 -103
  257. package/dist/adapters/cli/verify-drift.js.map +0 -1
  258. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  259. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  260. package/dist/adapters/cli/verify-impact.js +0 -119
  261. package/dist/adapters/cli/verify-impact.js.map +0 -1
  262. package/dist/adapters/mcp/index.d.ts +0 -5
  263. package/dist/adapters/mcp/index.d.ts.map +0 -1
  264. package/dist/adapters/mcp/index.js +0 -2
  265. package/dist/adapters/mcp/index.js.map +0 -1
  266. package/dist/bin/dt.d.ts +0 -7
  267. package/dist/bin/dt.d.ts.map +0 -1
  268. package/dist/bin/dt.js +0 -647
  269. package/dist/bin/dt.js.map +0 -1
  270. package/dist/core/catalog/build.d.ts +0 -143
  271. package/dist/core/catalog/build.d.ts.map +0 -1
  272. package/dist/core/catalog/build.js +0 -475
  273. package/dist/core/catalog/build.js.map +0 -1
  274. package/dist/core/catalog/checks/index.d.ts +0 -18
  275. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  276. package/dist/core/catalog/checks/index.js +0 -18
  277. package/dist/core/catalog/checks/index.js.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  279. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  280. package/dist/core/catalog/checks/v01-schema.js +0 -57
  281. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  283. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  284. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  285. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  287. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  288. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  289. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  291. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  292. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  293. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  295. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  296. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  297. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  299. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  300. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  301. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  303. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  304. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  305. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  307. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  308. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  309. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  311. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  312. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  313. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  316. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  317. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  320. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  321. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  323. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  324. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  325. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  327. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  328. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  329. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  331. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  332. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  333. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  334. package/dist/core/catalog/coverage.d.ts +0 -39
  335. package/dist/core/catalog/coverage.d.ts.map +0 -1
  336. package/dist/core/catalog/coverage.js +0 -62
  337. package/dist/core/catalog/coverage.js.map +0 -1
  338. package/dist/core/catalog/graph.d.ts +0 -49
  339. package/dist/core/catalog/graph.d.ts.map +0 -1
  340. package/dist/core/catalog/graph.js +0 -114
  341. package/dist/core/catalog/graph.js.map +0 -1
  342. package/dist/core/catalog/index-model.d.ts +0 -96
  343. package/dist/core/catalog/index-model.d.ts.map +0 -1
  344. package/dist/core/catalog/index-model.js +0 -8
  345. package/dist/core/catalog/index-model.js.map +0 -1
  346. package/dist/core/catalog/index.d.ts +0 -5
  347. package/dist/core/catalog/index.d.ts.map +0 -1
  348. package/dist/core/catalog/index.js +0 -2
  349. package/dist/core/catalog/index.js.map +0 -1
  350. package/dist/core/catalog/queries.d.ts +0 -69
  351. package/dist/core/catalog/queries.d.ts.map +0 -1
  352. package/dist/core/catalog/queries.js +0 -165
  353. package/dist/core/catalog/queries.js.map +0 -1
  354. package/dist/core/catalog/resolve.d.ts +0 -47
  355. package/dist/core/catalog/resolve.d.ts.map +0 -1
  356. package/dist/core/catalog/resolve.js +0 -318
  357. package/dist/core/catalog/resolve.js.map +0 -1
  358. package/dist/core/catalog/scaffold.d.ts +0 -31
  359. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  360. package/dist/core/catalog/scaffold.js +0 -141
  361. package/dist/core/catalog/scaffold.js.map +0 -1
  362. package/dist/core/catalog/validate-component.d.ts +0 -50
  363. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  364. package/dist/core/catalog/validate-component.js +0 -105
  365. package/dist/core/catalog/validate-component.js.map +0 -1
  366. package/dist/core/catalog/validate.d.ts +0 -71
  367. package/dist/core/catalog/validate.d.ts.map +0 -1
  368. package/dist/core/catalog/validate.js +0 -103
  369. package/dist/core/catalog/validate.js.map +0 -1
  370. package/dist/core/context/assemble.d.ts +0 -126
  371. package/dist/core/context/assemble.d.ts.map +0 -1
  372. package/dist/core/context/assemble.js +0 -197
  373. package/dist/core/context/assemble.js.map +0 -1
  374. package/dist/core/context/cache.d.ts +0 -60
  375. package/dist/core/context/cache.d.ts.map +0 -1
  376. package/dist/core/context/cache.js +0 -236
  377. package/dist/core/context/cache.js.map +0 -1
  378. package/dist/core/context/exit-codes.d.ts +0 -28
  379. package/dist/core/context/exit-codes.d.ts.map +0 -1
  380. package/dist/core/context/exit-codes.js +0 -28
  381. package/dist/core/context/exit-codes.js.map +0 -1
  382. package/dist/core/context/fetch.d.ts +0 -55
  383. package/dist/core/context/fetch.d.ts.map +0 -1
  384. package/dist/core/context/fetch.js +0 -112
  385. package/dist/core/context/fetch.js.map +0 -1
  386. package/dist/core/context/index.d.ts +0 -11
  387. package/dist/core/context/index.d.ts.map +0 -1
  388. package/dist/core/context/index.js +0 -8
  389. package/dist/core/context/index.js.map +0 -1
  390. package/dist/core/context/init.d.ts +0 -179
  391. package/dist/core/context/init.d.ts.map +0 -1
  392. package/dist/core/context/init.js +0 -532
  393. package/dist/core/context/init.js.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  395. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  396. package/dist/core/context/layers/architecture-layer.js +0 -24
  397. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  399. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  400. package/dist/core/context/layers/contracts-layer.js +0 -83
  401. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  403. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  404. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  405. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  406. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  407. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  408. package/dist/core/context/layers/flow-layer.js +0 -61
  409. package/dist/core/context/layers/flow-layer.js.map +0 -1
  410. package/dist/core/context/layers/index-layer.d.ts +0 -13
  411. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  412. package/dist/core/context/layers/index-layer.js +0 -77
  413. package/dist/core/context/layers/index-layer.js.map +0 -1
  414. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  415. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  416. package/dist/core/context/layers/primary-layer.js +0 -61
  417. package/dist/core/context/layers/primary-layer.js.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  419. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  420. package/dist/core/context/layers/secondary-layer.js +0 -52
  421. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  422. package/dist/core/context/session-lock.d.ts +0 -114
  423. package/dist/core/context/session-lock.d.ts.map +0 -1
  424. package/dist/core/context/session-lock.js +0 -90
  425. package/dist/core/context/session-lock.js.map +0 -1
  426. package/dist/core/context/tokens.d.ts +0 -35
  427. package/dist/core/context/tokens.d.ts.map +0 -1
  428. package/dist/core/context/tokens.js +0 -88
  429. package/dist/core/context/tokens.js.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  431. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  432. package/dist/core/extract/asyncapi/declared.js +0 -168
  433. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  434. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  435. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  436. package/dist/core/extract/asyncapi/index.js +0 -8
  437. package/dist/core/extract/asyncapi/index.js.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  439. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  440. package/dist/core/extract/asyncapi/payloads.js +0 -421
  441. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  443. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  444. package/dist/core/extract/asyncapi/topics.js +0 -368
  445. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  446. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  447. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  448. package/dist/core/extract/asyncapi/types.js +0 -5
  449. package/dist/core/extract/asyncapi/types.js.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  451. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  452. package/dist/core/extract/asyncapi/validate.js +0 -156
  453. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  454. package/dist/core/extract/component.d.ts +0 -204
  455. package/dist/core/extract/component.d.ts.map +0 -1
  456. package/dist/core/extract/component.js +0 -258
  457. package/dist/core/extract/component.js.map +0 -1
  458. package/dist/core/extract/detect.d.ts +0 -35
  459. package/dist/core/extract/detect.d.ts.map +0 -1
  460. package/dist/core/extract/detect.js +0 -89
  461. package/dist/core/extract/detect.js.map +0 -1
  462. package/dist/core/extract/index.d.ts +0 -12
  463. package/dist/core/extract/index.d.ts.map +0 -1
  464. package/dist/core/extract/index.js +0 -6
  465. package/dist/core/extract/index.js.map +0 -1
  466. package/dist/core/extract/ladder.d.ts +0 -79
  467. package/dist/core/extract/ladder.d.ts.map +0 -1
  468. package/dist/core/extract/ladder.js +0 -70
  469. package/dist/core/extract/ladder.js.map +0 -1
  470. package/dist/core/extract/openapi/index.d.ts +0 -43
  471. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  472. package/dist/core/extract/openapi/index.js +0 -142
  473. package/dist/core/extract/openapi/index.js.map +0 -1
  474. package/dist/core/extract/openapi/route1.d.ts +0 -36
  475. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  476. package/dist/core/extract/openapi/route1.js +0 -333
  477. package/dist/core/extract/openapi/route1.js.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  479. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  480. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  481. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  482. package/dist/core/extract/openapi/route2.d.ts +0 -69
  483. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  484. package/dist/core/extract/openapi/route2.js +0 -211
  485. package/dist/core/extract/openapi/route2.js.map +0 -1
  486. package/dist/core/extract/openapi/route3.d.ts +0 -26
  487. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  488. package/dist/core/extract/openapi/route3.js +0 -737
  489. package/dist/core/extract/openapi/route3.js.map +0 -1
  490. package/dist/core/extract/openapi/types.d.ts +0 -125
  491. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  492. package/dist/core/extract/openapi/types.js +0 -5
  493. package/dist/core/extract/openapi/types.js.map +0 -1
  494. package/dist/core/extract/openapi/validate.d.ts +0 -29
  495. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  496. package/dist/core/extract/openapi/validate.js +0 -200
  497. package/dist/core/extract/openapi/validate.js.map +0 -1
  498. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  499. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  500. package/dist/core/extract/orm/drizzle.js +0 -283
  501. package/dist/core/extract/orm/drizzle.js.map +0 -1
  502. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  503. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  504. package/dist/core/extract/orm/information-schema.js +0 -142
  505. package/dist/core/extract/orm/information-schema.js.map +0 -1
  506. package/dist/core/extract/orm/prisma.d.ts +0 -23
  507. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  508. package/dist/core/extract/orm/prisma.js +0 -234
  509. package/dist/core/extract/orm/prisma.js.map +0 -1
  510. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  511. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  512. package/dist/core/extract/orm/typeorm.js +0 -269
  513. package/dist/core/extract/orm/typeorm.js.map +0 -1
  514. package/dist/core/extract/orm/types.d.ts +0 -97
  515. package/dist/core/extract/orm/types.d.ts.map +0 -1
  516. package/dist/core/extract/orm/types.js +0 -6
  517. package/dist/core/extract/orm/types.js.map +0 -1
  518. package/dist/core/extract/prompt.d.ts +0 -21
  519. package/dist/core/extract/prompt.d.ts.map +0 -1
  520. package/dist/core/extract/prompt.js +0 -79
  521. package/dist/core/extract/prompt.js.map +0 -1
  522. package/dist/core/extract/provider.d.ts +0 -121
  523. package/dist/core/extract/provider.d.ts.map +0 -1
  524. package/dist/core/extract/provider.js +0 -6
  525. package/dist/core/extract/provider.js.map +0 -1
  526. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  527. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  528. package/dist/core/extract/providers/node-ts.js +0 -320
  529. package/dist/core/extract/providers/node-ts.js.map +0 -1
  530. package/dist/core/extract/render/schema-md.d.ts +0 -16
  531. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  532. package/dist/core/extract/render/schema-md.js +0 -140
  533. package/dist/core/extract/render/schema-md.js.map +0 -1
  534. package/dist/core/extract/report.d.ts +0 -125
  535. package/dist/core/extract/report.d.ts.map +0 -1
  536. package/dist/core/extract/report.js +0 -52
  537. package/dist/core/extract/report.js.map +0 -1
  538. package/dist/core/extract/schema.d.ts +0 -34
  539. package/dist/core/extract/schema.d.ts.map +0 -1
  540. package/dist/core/extract/schema.js +0 -146
  541. package/dist/core/extract/schema.js.map +0 -1
  542. package/dist/core/extract/workspaces.d.ts +0 -33
  543. package/dist/core/extract/workspaces.d.ts.map +0 -1
  544. package/dist/core/extract/workspaces.js +0 -193
  545. package/dist/core/extract/workspaces.js.map +0 -1
  546. package/dist/core/providers/index.d.ts +0 -6
  547. package/dist/core/providers/index.d.ts.map +0 -1
  548. package/dist/core/providers/index.js +0 -2
  549. package/dist/core/providers/index.js.map +0 -1
  550. package/dist/core/providers/tracker.d.ts +0 -74
  551. package/dist/core/providers/tracker.d.ts.map +0 -1
  552. package/dist/core/providers/tracker.js +0 -38
  553. package/dist/core/providers/tracker.js.map +0 -1
  554. package/dist/core/scope/calibration.d.ts +0 -25
  555. package/dist/core/scope/calibration.d.ts.map +0 -1
  556. package/dist/core/scope/calibration.js +0 -52
  557. package/dist/core/scope/calibration.js.map +0 -1
  558. package/dist/core/scope/closure.d.ts +0 -31
  559. package/dist/core/scope/closure.d.ts.map +0 -1
  560. package/dist/core/scope/closure.js +0 -68
  561. package/dist/core/scope/closure.js.map +0 -1
  562. package/dist/core/scope/gate.d.ts +0 -41
  563. package/dist/core/scope/gate.d.ts.map +0 -1
  564. package/dist/core/scope/gate.js +0 -165
  565. package/dist/core/scope/gate.js.map +0 -1
  566. package/dist/core/scope/index.d.ts +0 -18
  567. package/dist/core/scope/index.d.ts.map +0 -1
  568. package/dist/core/scope/index.js +0 -12
  569. package/dist/core/scope/index.js.map +0 -1
  570. package/dist/core/scope/partition.d.ts +0 -36
  571. package/dist/core/scope/partition.d.ts.map +0 -1
  572. package/dist/core/scope/partition.js +0 -78
  573. package/dist/core/scope/partition.js.map +0 -1
  574. package/dist/core/scope/prompt.d.ts +0 -39
  575. package/dist/core/scope/prompt.d.ts.map +0 -1
  576. package/dist/core/scope/prompt.js +0 -123
  577. package/dist/core/scope/prompt.js.map +0 -1
  578. package/dist/core/scope/scoping.d.ts +0 -52
  579. package/dist/core/scope/scoping.d.ts.map +0 -1
  580. package/dist/core/scope/scoping.js +0 -99
  581. package/dist/core/scope/scoping.js.map +0 -1
  582. package/dist/core/scope/types.d.ts +0 -77
  583. package/dist/core/scope/types.d.ts.map +0 -1
  584. package/dist/core/scope/types.js +0 -5
  585. package/dist/core/scope/types.js.map +0 -1
  586. package/dist/core/scope/validate.d.ts +0 -47
  587. package/dist/core/scope/validate.d.ts.map +0 -1
  588. package/dist/core/scope/validate.js +0 -90
  589. package/dist/core/scope/validate.js.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  591. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  592. package/dist/core/verify/asyncapi-diff.js +0 -209
  593. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  594. package/dist/core/verify/contract-diff.d.ts +0 -39
  595. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  596. package/dist/core/verify/contract-diff.js +0 -63
  597. package/dist/core/verify/contract-diff.js.map +0 -1
  598. package/dist/core/verify/drift.d.ts +0 -47
  599. package/dist/core/verify/drift.d.ts.map +0 -1
  600. package/dist/core/verify/drift.js +0 -122
  601. package/dist/core/verify/drift.js.map +0 -1
  602. package/dist/core/verify/impact.d.ts +0 -22
  603. package/dist/core/verify/impact.d.ts.map +0 -1
  604. package/dist/core/verify/impact.js +0 -93
  605. package/dist/core/verify/impact.js.map +0 -1
  606. package/dist/core/verify/index.d.ts +0 -10
  607. package/dist/core/verify/index.d.ts.map +0 -1
  608. package/dist/core/verify/index.js +0 -9
  609. package/dist/core/verify/index.js.map +0 -1
  610. package/dist/core/verify/openapi-diff.d.ts +0 -29
  611. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  612. package/dist/core/verify/openapi-diff.js +0 -291
  613. package/dist/core/verify/openapi-diff.js.map +0 -1
  614. package/dist/core/verify/types.d.ts +0 -138
  615. package/dist/core/verify/types.d.ts.map +0 -1
  616. package/dist/core/verify/types.js +0 -5
  617. package/dist/core/verify/types.js.map +0 -1
  618. package/schemas/component.schema.json +0 -203
  619. package/schemas/flow.schema.json +0 -75
  620. package/schemas/scope-output.schema.json +0 -62
@@ -86,12 +86,78 @@ Non-JS packages are **not** held to these names. Record their equivalent command
86
86
 
87
87
  Report per package: reached, or missed with the gate that fails to reach it.
88
88
 
89
+ ### Per-package procedure (monorepo)
90
+
91
+ The checklist above is per package, not per repository. Run it once for
92
+ each package, from the same list the package map in `docs/tech.md`
93
+ records:
94
+
95
+ 1. Enumerate packages from the package map. Where it is absent or stale,
96
+ fall back to the workspace signals themselves.
97
+ 2. For each package, record the test command it actually defines and
98
+ whether the aggregate root command reaches it.
99
+ 3. **A package with no test script is a finding, not a pass.** Record it
100
+ as `no test script` — distinct from `unreachable`, because the fix
101
+ differs: one needs a script, the other needs wiring.
102
+ 4. Report one row per package:
103
+
104
+ | Package | Test command | Reached by root `test` | Finding |
105
+ | ----------- | ------------ | ---------------------- | ------------------------------ |
106
+ | `@acme/api` | `vitest run` | yes | — |
107
+ | `@acme/web` | `vitest run` | **no** | unreachable from the aggregate |
108
+ | `@acme/cli` | — | n/a | no test script |
109
+
110
+ This is an extension of the single-package procedure, not a parallel
111
+ monorepo path. A single-package repository produces the same table with
112
+ one row.
113
+
89
114
  ### Worked example
90
115
 
91
116
  A monorepo defines `test:node` as `app && scraper && db` while the `api` package holds the largest suite. Every script name is canonical. The CI job and the deploy quality gate both run the aggregate.
92
117
 
93
118
  Correct output: **defect** — `api` is unreachable from the aggregate; the CI gate and the deploy gate both let untested backend code through. Reporting "all script names conform" here is a false pass.
94
119
 
120
+ ## Part 4 — Integration, E2E, and Contract Infrastructure Detection
121
+
122
+ Detect the presence and configuration state of higher-layer test infrastructure. Report findings as **informational** — missing infrastructure is not a defect, but it informs the gap analysis.
123
+
124
+ ### Integration testing infrastructure
125
+
126
+ | Check | What to look for |
127
+ | ----------------------- | ------------------------------------------------------------- |
128
+ | **Testcontainers** | `@testcontainers/postgresql` or similar in dependencies |
129
+ | **Docker Compose** | `docker-compose.yml` or `compose.yml` with a database service |
130
+ | **Supabase local CLI** | `supabase/config.toml` or `.supabase/` directory |
131
+ | **Docker availability** | `docker info` succeeds (report if unavailable) |
132
+
133
+ ### E2E testing infrastructure
134
+
135
+ | Check | What to look for |
136
+ | ------------------------- | -------------------------------------------------------------------------------- |
137
+ | **Playwright config** | `playwright.config.ts` or `playwright.config.js` present |
138
+ | **Base URL configured** | Config references `process.env.BASE_URL` or equivalent (not hardcoded localhost) |
139
+ | **Auth setup project** | A `global-setup` or setup project defined in Playwright config |
140
+ | **Browser install in CI** | CI workflow includes `playwright install` step |
141
+ | **`test:e2e` script** | Present in `package.json` and reachable from aggregate |
142
+
143
+ ### Contract validation infrastructure
144
+
145
+ | Check | What to look for |
146
+ | -------------------------- | ------------------------------------------------------ |
147
+ | **OpenAPI spec** | `openapi.yaml`, `openapi.json`, `swagger.*` in repo |
148
+ | **AsyncAPI spec** | `asyncapi.yaml`, `asyncapi.json` in repo |
149
+ | **`dt` CLI** | `which dt` succeeds |
150
+ | **`test:contract` script** | Present in `package.json` and reachable from aggregate |
151
+
152
+ ### Reporting
153
+
154
+ Report each finding as:
155
+
156
+ - `[INFO] <infrastructure> detected: <path or status>`
157
+ - `[INFO] <infrastructure> not found — Layer {X} tests require this`
158
+
159
+ These are informational findings for the gap analysis. They do **NOT** block or fail the standards check.
160
+
95
161
  ## Failure Modes
96
162
 
97
163
  | Condition | Required behavior |
@@ -0,0 +1,155 @@
1
+ ---
2
+ name: aws-ops
3
+ description: "AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying AWS infrastructure changes."
4
+ ---
5
+
6
+ # AWS Operations (aws-ops)
7
+
8
+ Per-surface mechanism skill for `infra-engineer`. It supplies the AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and the AWS log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. AWS has no native plan, so this skill provides the synthesized plan inputs: discovery commands, the delta, and the exact forward and revert commands per change kind.
9
+
10
+ ---
11
+
12
+ > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
+
14
+ ## Tool declaration
15
+
16
+ | Field | Value |
17
+ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
18
+ | `name` | `aws` |
19
+ | `probe` | `aws --version` (expects `aws-cli/2.x`) |
20
+ | `floor` | AWS CLI `2.15` minimum; major `2.x` REQUIRED. A `1.x` install is `below-floor`. |
21
+ | `auth_probe` | `aws sts get-caller-identity --output json` |
22
+ | `remediation` | "Install AWS CLI v2 (`2.15`+) from the AWS docs and run `aws configure` or set a named profile; this skill never auto-installs and offers no v1 fallback." |
23
+
24
+ Any non-`ok` tool-check result blocks the phase with the remediation string. All parseable output uses `--output json`. Identity is asserted by comparing `Account` from `sts get-caller-identity` with the target environment's `aws.account_id`; a mismatch is `wrong-identity` and blocks.
25
+
26
+ ## Resource tiers
27
+
28
+ | Tier | AWS resources |
29
+ | --------------- | --------------------------------------------------------------------------------------------------------------- |
30
+ | **foundation** | VPC, subnets, route tables, internet/NAT gateways, ECS cluster, ECR registry, IAM roles/trust, KMS keys |
31
+ | **application** | ECS service, task definition, target group, security group, Secrets Manager secret, ACM certificate, DNS record |
32
+
33
+ Foundation resources are **discovery-only**: this skill provides no apply commands for them. A foundation change is routed to the environment's `tier0_tool` (cdk, terraform, cloudformation) with `status: routed-to-<tool>`; the agent never writes foundation resources directly.
34
+
35
+ ## Command sets per change kind
36
+
37
+ Every command references secrets by ARN or name, never by value. Forward and revert are paired so `rollback.sh` can be generated.
38
+
39
+ ### Discover (read-only)
40
+
41
+ ```sh
42
+ aws sts get-caller-identity --output json
43
+ aws ecs list-clusters --output json
44
+ aws ecs list-services --cluster "$CLUSTER" --output json
45
+ aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --output json
46
+ aws ecr describe-repositories --output json
47
+ aws elbv2 describe-target-groups --output json
48
+ aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
49
+ aws iam list-attached-role-policies --role-name "$ROLE" --output json
50
+ aws secretsmanager list-secrets --output json
51
+ aws acm list-certificates --output json
52
+ ```
53
+
54
+ ### Build and push image (ECR)
55
+
56
+ - Forward:
57
+ ```sh
58
+ aws ecr get-login-password --region "$REGION" | docker login --username AWS --password-stdin "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com"
59
+ docker build -t "$REPO:$TAG" .
60
+ docker push "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com/$REPO:$TAG"
61
+ ```
62
+ - Revert: redeploy the previous image tag (see ECS below); images are immutable, so no delete is required for revert.
63
+
64
+ ### Create and update ECS service and task definition
65
+
66
+ - Forward:
67
+ ```sh
68
+ aws ecs register-task-definition --cli-input-json file://taskdef.json --output json
69
+ aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$REV" --output json
70
+ ```
71
+ - Verify: `aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --query 'services[0].deployments' --output json` shows the new revision `PRIMARY` and `runningCount == desiredCount`.
72
+ - Revert: `aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$PREV_REV"` using the **previous task definition revision** recorded before the change.
73
+
74
+ ### IAM policy create and attach
75
+
76
+ - Forward:
77
+ ```sh
78
+ aws iam create-policy --policy-name "$NAME" --policy-document file://policy.json --output json
79
+ aws iam attach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"
80
+ ```
81
+ - Verify: `aws iam list-attached-role-policies --role-name "$ROLE"` includes the ARN.
82
+ - Revert (reverse order): `aws iam detach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"` then `aws iam delete-policy --policy-arn "$POLICY_ARN"`.
83
+
84
+ ### Secrets Manager (reference by ARN)
85
+
86
+ - Forward: `aws secretsmanager create-secret --name "$NAME" --secret-string file://value.json` or `put-secret-value`. Consumers reference the secret by its ARN in task definitions; the value is never read into a shell variable that is later echoed.
87
+ - Revert: `aws secretsmanager delete-secret --secret-id "$ARN" --recovery-window-in-days 7` (recoverable) or restore the prior version by `put-secret-value` from the source of truth, never from a transcript.
88
+
89
+ ### ACM certificate request and DNS validation
90
+
91
+ - Forward:
92
+ ```sh
93
+ aws acm request-certificate --domain-name "$FQDN" --validation-method DNS --output json
94
+ aws acm describe-certificate --certificate-arn "$CERT_ARN" --query 'Certificate.DomainValidationOptions' --output json
95
+ ```
96
+ DNS validation records are added through the Cloudflare DNS step in the agent body.
97
+ - Revert: `aws acm delete-certificate --certificate-arn "$CERT_ARN"` once no listener references it.
98
+
99
+ ### ALB target health and CloudWatch retention
100
+
101
+ ```sh
102
+ aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
103
+ aws logs put-retention-policy --log-group-name "$LG" --retention-in-days 30
104
+ ```
105
+
106
+ ## Cost estimation
107
+
108
+ `plan.md` lists each resource with a monthly estimate and its source (the AWS pricing page URL or a `aws pricing get-products` call). The always-relevant cost list is stated on every AWS plan even when zero:
109
+
110
+ - **NAT gateway** — hourly + per-GB processing.
111
+ - **Application Load Balancer** — hourly + LCU.
112
+ - **RDS instance** — instance-hours + storage + backups.
113
+ - **EC2 / Fargate capacity** — vCPU and memory hours.
114
+ - **Interface VPC endpoints** — hourly per AZ + per-GB.
115
+
116
+ Any resource at or above the environment cost threshold is marked `APPROVAL REQUIRED` and approved by name.
117
+
118
+ ## Backup commands and revert sources
119
+
120
+ | Change kind | Backup command (production, touches state) | Revert source |
121
+ | ---------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- |
122
+ | RDS schema/data | `aws rds create-db-snapshot --db-instance-identifier "$DB" --db-snapshot-identifier "$SNAP"` | Restore snapshot to a new instance |
123
+ | S3 object change | Confirm versioning: `aws s3api get-bucket-versioning --bucket "$B"`; require `Enabled` before overwrite | Previous object version id |
124
+ | ECS deploy | Record current task definition revision | **Previous task definition revision** |
125
+ | Image deploy | Record current image tag | **Previous image tag** |
126
+
127
+ A production step with `touches state: yes` records the backup id and restore command in `result.md` before it applies.
128
+
129
+ ## AWS log table
130
+
131
+ Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
132
+
133
+ | Source | Command |
134
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
135
+ | CloudWatch Logs | `aws logs tail "$LG" --since "$START" --format short` |
136
+ | ECS task failure | `aws ecs describe-tasks --cluster "$CLUSTER" --tasks "$TASK" --query 'tasks[0].stoppedReason'` |
137
+ | ALB access logs | Query the S3 access-log prefix for the bounded window |
138
+ | Logs Insights | `aws logs start-query --log-group-name "$LG" --start-time "$S" --end-time "$E" --query-string ...` with a **bounded window** and stated scan scope before the billed query |
139
+ | VPC Flow Logs | Filtered by ENI and the bounded window |
140
+ | CloudTrail | `aws cloudtrail lookup-events --start-time "$S" --end-time "$E" --lookup-attributes ...` |
141
+ | GitHub Actions | `gh run view "$RUN" --log-failed` |
142
+
143
+ ## Cost sweep categories (read-only)
144
+
145
+ - Unassociated Elastic IPs (`eip` addresses with no association).
146
+ - Available (unattached) EBS volumes.
147
+ - Stale EBS snapshots past a retention age.
148
+ - Idle NAT gateways with negligible processed bytes.
149
+ - Load balancers with no healthy targets.
150
+ - Zero-scaled ECS services still holding a load balancer.
151
+ - Resources whose `ExpiresAt` tag is in the past.
152
+ - Untagged resources missing environment/owner/ChangeId tags.
153
+ - CloudWatch log groups without a retention policy.
154
+
155
+ Sweep findings are reported, never remediated automatically.
@@ -0,0 +1,121 @@
1
+ ---
2
+ name: deploy-ops
3
+ description: "Deploy script contract, environment mapping, tag policy, deploy-target framing, and workflow scaffolding for infra-engineer. Use when planning or applying deploys, rollbacks, or releases."
4
+ ---
5
+
6
+ # Deploy Operations (deploy-ops)
7
+
8
+ Cross-surface mechanism skill for `infra-engineer`. It supplies the deploy **script contract**, the environment mapping table, the tag policy summary, the deploy-target framing, and the workflow scaffolding procedure. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body — and it contains no deploy logic itself: the logic lives in the `templates/scripts/*.sh` files, which this skill only documents and wires. The skill declares the tools `yq` and `gh`.
9
+
10
+ ---
11
+
12
+ > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
+
14
+ ## Tool declaration
15
+
16
+ | Field | Value |
17
+ | ------------- | ------------------------------------------------------------------------------------------------------------------------- |
18
+ | `name` | `yq`, `gh` |
19
+ | `probe` | `yq --version`; `gh --version` |
20
+ | `floor` | `yq` 4.x (the mikefarah Go implementation); minimum `4.0`. A 3.x or Python `yq` is `below-floor`. `gh` any current 2.x. |
21
+ | `auth_probe` | `gh auth status` (for release/PR operations); `yq` needs no auth. |
22
+ | `remediation` | "Install `yq` 4.x from mikefarah/yq and `gh` from cli.github.com; this skill never auto-installs and offers no fallback." |
23
+
24
+ `yq` reads and resolves `infra/environments.yaml`; `gh` performs release and PR operations for the release flow. Every command references secrets by name, never by value, and every log or status query passes through the redaction pattern set before it reaches a transcript.
25
+
26
+ ## Script contract
27
+
28
+ The deploy surface is a fixed set of `bash` scripts under `templates/scripts/`. Each is `set -euo pipefail`, supports `--help`, reads the environment definition from `infra/environments.yaml` via `yq`, and contains no environment names or secrets of its own.
29
+
30
+ | Script | Purpose | Mutates? | `--dry-run` | Exit codes |
31
+ | ------------------ | ------------------------------------------------------------ | -------- | ----------- | ------------------------------------------ |
32
+ | `deploy.sh` | Ordered deploy pipeline for one environment | yes | yes | 0 ok · 1 error · 2 blocked · 3 verify-fail |
33
+ | `deploy-verify.sh` | Post-deploy health check; prints the rollback line on fail | no | no | 0 healthy · 2 blocked · 3 fail |
34
+ | `rollback.sh` | Roll back to the previous good version from `infra/changes/` | yes | yes | 0 ok · 1 error · 2 blocked |
35
+ | `deploy-status.sh` | Read-only current status of an environment | no | n/a | 0 ok · 2 blocked |
36
+ | `release.sh` | Generalized changelog/version/tag/push release automation | yes | yes | 0 ok · 1 error · 2 blocked |
37
+
38
+ ### `deploy.sh` ordered steps
39
+
40
+ `deploy.sh <env>` runs eight ordered steps and exits `2` on any blocked condition:
41
+
42
+ 1. **preflight** — clean tree, ref rules, identity assertion.
43
+ 2. **validate** — the project quality gate; **never** skippable by any flag.
44
+ 3. **build** — artifact tagged `vX.Y.Z` (production) or `main-<short-sha>` (non-production).
45
+ 4. **backup** — taken when the environment is production **and** the change migrates; **never** skipped for production.
46
+ 5. **migrate** — with explicit confirmation for production.
47
+ 6. **deploy** — via the detected deploy kind.
48
+ 7. **verify** — delegates to `deploy-verify.sh`.
49
+ 8. **record** — appends a change record under `infra/changes/`.
50
+
51
+ No `latest` mutable tag is ever a deploy target. The deploy kind is detected from the platform blocks present in the environment; `deploy.sh` refuses (`exit 2`) when the detection is ambiguous (more than one platform block and no explicit `deploy_kind`), per spec open question 3.
52
+
53
+ ### Failure and rollback
54
+
55
+ `deploy-verify.sh` exits `3` on a failed health check and prints the exact `rollback.sh <env>` invocation to run next. `rollback.sh <env>` resolves the previous good version from `infra/changes/` with no manual lookup; `--to <version>` overrides the resolved version.
56
+
57
+ ## Environment mapping table
58
+
59
+ Environment names and platform blocks are read from `infra/environments.yaml` via `yq`. A missing or template-status (`# status: template`) file exits `2`.
60
+
61
+ | Trigger / ref | Environment | Rule |
62
+ | ---------------------------- | ----------- | ----------------------------------------------------------------------------- |
63
+ | push to `main` | `dev` | non-production deploys `main` HEAD; artifact tagged `main-<short-sha>` |
64
+ | annotated tag `vX.Y.Z` | `prod` | production refuses any ref that is not an annotated tag on `main` |
65
+ | manual (`workflow_dispatch`) | any | dev is optional; installed only when a `production: false` environment exists |
66
+
67
+ ## Tag policy summary
68
+
69
+ Tags are human-only and owned by the policy in `github-ops`: annotated `vX.Y.Z`, created on `main` only, immutable, no prerelease in v1. `deploy-ops` never creates, moves, or deletes a tag — `git-guard` rule 4 blocks agent tag operations deterministically. `release.sh` suggests the bump type from Conventional Commits and confirms it; production deploys consume the resulting annotated tag.
70
+
71
+ ## Deploy-target framing
72
+
73
+ `deploy-ops` does not choose the platform for a consumer. It frames the decision so the operator (or `infra-engineer`) picks a **deploy target** deliberately, then records the choice in `infra/environments.yaml`.
74
+
75
+ | Decision input | Question the operator answers |
76
+ | ---------------- | -------------------------------------------------------------------- |
77
+ | compute platform | fly.io app, AWS ECS service, or another target? |
78
+ | data platform | is there a Supabase (or other) migration step to sequence? |
79
+ | environment tier | is this environment `production: true` or `false`? |
80
+ | ref discipline | does production consume an annotated tag, and does dev track `main`? |
81
+ | rollback source | is the previous good version recorded in `infra/changes/`? |
82
+
83
+ When two platform blocks are present with no explicit `deploy_kind`, the deploy target is ambiguous and `deploy.sh` refuses until the operator sets `deploy_kind`.
84
+
85
+ ## Workflow scaffolding procedure
86
+
87
+ `deploy-ops` scaffolds the GitHub Actions workflow templates (`templates/workflows/`) into a consumer repo as recorded changes delivered by a draft PR — never applied silently.
88
+
89
+ 1. Read `infra/environments.yaml`.
90
+ 2. Install `deploy-dev.yml` **only when** an environment with `production: false` is declared.
91
+ 3. Install `deploy-prod.yml` (triggered on the exact-semver tag, behind a required reviewer) and `rollback.yml` (`workflow_dispatch`) when a `production: true` environment exists.
92
+ 4. Every workflow calls the canonical scripts only — no inline deploy logic.
93
+ 5. Workflow edits are recorded changes; they are delivered by PR and reviewed by a human.
94
+
95
+ ## `package.json` wrappers for JS/TS repos
96
+
97
+ For JavaScript/TypeScript repos only, `deploy-ops` generates thin `package.json` script wrappers so the deploy surface is reachable through the project's canonical script runner. The shell scripts remain the implementation; the wrappers are one-line delegations:
98
+
99
+ ```jsonc
100
+ {
101
+ "scripts": {
102
+ "deploy": "bash templates/scripts/deploy.sh",
103
+ "deploy:verify": "bash templates/scripts/deploy-verify.sh",
104
+ "deploy:rollback": "bash templates/scripts/rollback.sh",
105
+ "deploy:status": "bash templates/scripts/deploy-status.sh",
106
+ "release": "bash templates/scripts/release.sh",
107
+ },
108
+ }
109
+ ```
110
+
111
+ Non-JS/TS repos call the scripts directly; no wrapper is generated.
112
+
113
+ ## Human-only guard
114
+
115
+ `release.sh` and `deploy.sh prod` refuse to run when `CI` is set without `INFRA_HUMAN_APPROVED=1` exported by the protected-environment job, and refuse in a non-interactive agent context. This keeps release and production deploy decisions with a human even when the scripts run inside automation.
116
+
117
+ ## Boundary rules
118
+
119
+ - No deploy logic lives in this skill or in a workflow; it lives only in `templates/scripts/*.sh`.
120
+ - No deploy targets a mutable `latest` tag.
121
+ - The agent never creates tags; tags are human-only per `github-ops`.
@@ -0,0 +1,138 @@
1
+ ---
2
+ name: fly-ops
3
+ description: "flyctl command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying fly.io infrastructure changes."
4
+ ---
5
+
6
+ # Fly.io Operations (fly-ops)
7
+
8
+ Per-surface mechanism skill for `infra-engineer`. It supplies the `flyctl` command sets, resource tiers, cost inputs, backup and revert sources, and the fly.io log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. fly.io has release history (`fly releases`) that makes revert concrete and volume snapshots that make backup concrete, so it is the cheapest surface for the manual Phase 1 verification.
9
+
10
+ ---
11
+
12
+ > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
+
14
+ ## Tool declaration
15
+
16
+ | Field | Value |
17
+ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
18
+ | `name` | `flyctl` |
19
+ | `probe` | `flyctl version` |
20
+ | `floor` | Current major release channel; minimum `0.3`. An older channel is `below-floor`. |
21
+ | `auth_probe` | `flyctl auth whoami` |
22
+ | `remediation` | "Install `flyctl` from fly.io and run `flyctl auth login` (or export `FLY_API_TOKEN`); this skill never auto-installs and offers no fallback." |
23
+
24
+ Use `--json` wherever `flyctl` supports it. Identity is asserted by comparing the authenticated org (from `flyctl auth whoami` / `flyctl orgs list --json`) with the target environment's `fly.org`; a mismatch is `wrong-identity` and blocks.
25
+
26
+ ## Resource tiers
27
+
28
+ | Tier | Fly resources |
29
+ | --------------- | ----------------------------------------------------------------- |
30
+ | **foundation** | org |
31
+ | **application** | app, machine, volume, secret, certificate |
32
+ | **ephemeral** | throwaway apps, which carry an `ExpiresAt` tag and a cleanup step |
33
+
34
+ An ephemeral app without an `ExpiresAt` is a finding. Foundation (org) changes are routed, never written by this agent.
35
+
36
+ ## Command sets per change kind
37
+
38
+ Every command references secrets by name, never by value.
39
+
40
+ ### Discover (read-only)
41
+
42
+ ```sh
43
+ flyctl auth whoami
44
+ flyctl apps list --json
45
+ flyctl status -a "$APP" --json
46
+ flyctl machine list -a "$APP" --json
47
+ flyctl volumes list -a "$APP" --json
48
+ flyctl secrets list -a "$APP"
49
+ flyctl certs list -a "$APP"
50
+ flyctl releases -a "$APP" --json
51
+ ```
52
+
53
+ ### Create app
54
+
55
+ - Forward: `fly apps create "$APP" --org "$ORG"`
56
+ - Verify: `flyctl status -a "$APP" --json`
57
+ - Revert: `fly apps destroy "$APP" --yes` (requires the typed app name and environment name per the agent body).
58
+
59
+ ### Deploy
60
+
61
+ - Forward: `fly deploy -a "$APP" --image "$IMAGE"` or a build then deploy:
62
+ ```sh
63
+ fly deploy -a "$APP" --build-only --push --image-label "$TAG"
64
+ fly deploy -a "$APP" --image "registry.fly.io/$APP:$TAG"
65
+ ```
66
+ - Verify: `flyctl status -a "$APP" --json` shows the new release healthy.
67
+ - Revert: `fly deploy -a "$APP" --image <previous>` using the previous image from `fly releases`.
68
+
69
+ ### Secrets
70
+
71
+ - Forward: `fly secrets set KEY=value -a "$APP"` (value from its source of truth, never a transcript) / `fly secrets unset KEY -a "$APP"`.
72
+ - Revert: re-set the prior value from its source of truth; **never** reconstruct a secret from a transcript or log.
73
+
74
+ ### Volumes
75
+
76
+ - Forward: `fly volumes create "$NAME" -a "$APP" --region "$REGION" --size "$GB"`.
77
+ - Backup: `fly volumes snapshots create "$VOL_ID"` before any production step touching a volume.
78
+ - Revert: restore from the recorded snapshot; `fly volumes destroy "$VOL_ID"` only after the typed confirmation.
79
+
80
+ ### Certificates
81
+
82
+ - Forward: `fly certs add "$FQDN" -a "$APP"`; then `fly certs check "$FQDN" -a "$APP"`.
83
+ - Revert: `fly certs remove "$FQDN" -a "$APP" --yes`.
84
+
85
+ ### Scale and machines
86
+
87
+ ```sh
88
+ fly scale count "$N" -a "$APP"
89
+ fly scale vm "$SIZE" -a "$APP"
90
+ fly machine status "$MACHINE" -a "$APP" --json
91
+ ```
92
+
93
+ Revert for a scale change is the prior count/size recorded before the step.
94
+
95
+ ### Destroy
96
+
97
+ `fly apps destroy "$APP" --yes` requires the operator to type both the app name and the environment name. A production foundation target is refused.
98
+
99
+ ## Revert sources
100
+
101
+ - **Deploy:** `fly releases -a "$APP" --json` supplies the previous image; revert is `fly deploy --image <previous>`.
102
+ - **Secret:** re-set the prior value from its source of truth.
103
+ - **Volume:** the snapshot recorded as backup.
104
+ - **Scale/cert:** the prior value/record captured before the step.
105
+
106
+ ## Backup
107
+
108
+ `fly volumes snapshots create "$VOL_ID"` runs before any production step that touches a volume; the snapshot id and the restore command are recorded in `result.md` before the step applies.
109
+
110
+ ## Fly log table
111
+
112
+ Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
113
+
114
+ | Source | Command |
115
+ | --------------- | ----------------------------------------- |
116
+ | App logs | `fly logs -a "$APP" --since "$START"` |
117
+ | App status | `fly status -a "$APP" --json` |
118
+ | Machine status | `fly machine status "$MACHINE" -a "$APP"` |
119
+ | Release history | `fly releases -a "$APP" --json` |
120
+
121
+ ## Cost entries and sweep
122
+
123
+ Cost entries listed on every fly plan:
124
+
125
+ - **Machines** by size (shared/performance vCPU + memory).
126
+ - **Volumes** by GB.
127
+ - **Dedicated IPv4** addresses.
128
+
129
+ Sweep categories (read-only, reported never remediated):
130
+
131
+ - Stopped machines still holding volumes.
132
+ - Unattached volumes.
133
+ - Apps past their `ExpiresAt` tag.
134
+
135
+ ## Boundary rules
136
+
137
+ - No AWS Secrets Manager entry for a fly-only workload; fly secrets stay on fly.
138
+ - `fly apps destroy` requires the typed app name and environment name.
@@ -39,7 +39,7 @@ git checkout -b <branch-name>
39
39
 
40
40
  - Story branches: `story/<story-id>-<short-description>`
41
41
  - Issue branches: `issue/<issue-number>-<short-description>`
42
- - Integration branches: `integrate/<milestone-or-prd-name>`
42
+ - Integration branches: `integration/<plan-id>-<short-description>`
43
43
 
44
44
  ### 2. Create Branch from Integration Branch
45
45
 
@@ -96,13 +96,13 @@ Before merging any PR or branch, verify:
96
96
 
97
97
  Choose the appropriate strategy based on context:
98
98
 
99
- | Strategy | When to Use | Command |
100
- | ---------------- | ----------------------------------------------------------------------------------- | --------------------------- |
101
- | **Squash merge** | Story/issue PRs → integration or main branch. Produces clean single-commit history. | `gh pr merge <pr> --squash` |
102
- | **Merge commit** | Integration branch → main. Preserves the full story history. | `gh pr merge <pr> --merge` |
103
- | **Rebase merge** | Small PRs with clean linear history. Avoid for multi-commit stories. | `gh pr merge <pr> --rebase` |
99
+ | Strategy | When to Use | Command |
100
+ | ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
101
+ | **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
102
+ | **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
103
+ | **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
104
104
 
105
- **Default**: Squash merge for story PRs, merge commit for integration PRs to main.
105
+ **Default**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
106
106
 
107
107
  ### 6. Resolve Merge Conflicts
108
108
 
@@ -197,6 +197,26 @@ git push --force-with-lease origin <branch-name>
197
197
 
198
198
  **Never use** `git push --force` without `--with-lease`.
199
199
 
200
+ ### 10. Tag Procedure (Human-Only)
201
+
202
+ Tags are the production deploy trigger and are created **only by a human**. Agents **MUST NOT** create, move, delete, or push tags; `git-guard` rule 4 enforces this. This section documents the procedure a human follows — it is not an agent action.
203
+
204
+ ```bash
205
+ # Ensure you are on main at the exact release commit
206
+ git checkout main
207
+ git pull origin main
208
+
209
+ # Create an annotated, immutable release tag (exact semver only)
210
+ git tag -a v<major>.<minor>.<patch> -m "Release v<major>.<minor>.<patch>"
211
+
212
+ # Push the tag (triggers the production deploy workflow)
213
+ git push origin v<major>.<minor>.<patch>
214
+ ```
215
+
216
+ Rules: annotated tags only (never lightweight), exact `v<major>.<minor>.<patch>` (no prerelease suffixes in v1), tag a commit on `main`, and never move or delete a pushed tag.
217
+
218
+ **Hotfix:** a hotfix ships as the next patch tag (`vX.Y.Z+1`) cut from `main` after the fix merges; never re-point or force-update an existing tag.
219
+
200
220
  ---
201
221
 
202
222
  ## Conflict Resolution Heuristics