agentic-flow-kit 1.8.7 → 2.0.0

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 (936) hide show
  1. package/README.md +113 -148
  2. package/bin/flow-kit.mjs +5 -2
  3. package/locales/en/installer.json +25 -0
  4. package/locales/en/overrides/.agents/commands/deploy.md +52 -0
  5. package/locales/en/overrides/.agents/commands/maintain.md +76 -0
  6. package/locales/en/overrides/.agents/commands/new-task.md +89 -0
  7. package/locales/en/overrides/.agents/commands/pipeline-run.md +56 -0
  8. package/locales/en/overrides/.agents/commands/pr-review.md +30 -0
  9. package/locales/en/overrides/.agents/commands/review.md +93 -0
  10. package/locales/en/overrides/.agents/commands/stages.md +256 -0
  11. package/locales/en/overrides/.agents/notes/pr-review-cost-discipline.md +48 -0
  12. package/locales/en/overrides/.agents/notes/process-order-rule.md +21 -0
  13. package/locales/en/overrides/.agents/notes/runtime-env.local.example.md +21 -0
  14. package/locales/en/overrides/.agents/pipelines/_TEMPLATE.md +75 -0
  15. package/locales/en/overrides/.agents/pipelines/pipeline-closing.md +28 -0
  16. package/locales/en/overrides/.agents/roles/implementer.md +28 -0
  17. package/locales/en/overrides/.agents/roles/independent-reviewer.md +39 -0
  18. package/locales/en/overrides/.agents/roles/pr-adjudicator.md +27 -0
  19. package/locales/en/overrides/.agents/roles/pr-finder.md +51 -0
  20. package/locales/en/overrides/.agents/roles/pr-verifier.md +44 -0
  21. package/locales/en/overrides/.agents/roles/ui-verifier.md +22 -0
  22. package/locales/en/overrides/.agents/roles/wiki-compiler.md +47 -0
  23. package/locales/en/overrides/.agents/skills/arena/SKILL.md +50 -0
  24. package/locales/en/overrides/.agents/skills/autonomous-run/SKILL.md +45 -0
  25. package/locales/en/overrides/.agents/skills/blast-radius/SKILL.md +53 -0
  26. package/locales/en/overrides/.agents/skills/csharp-quality-gates/SKILL.md +109 -0
  27. package/locales/en/overrides/.agents/skills/dev-tour/SKILL.md +98 -0
  28. package/locales/en/overrides/.agents/skills/dream/SKILL.md +63 -0
  29. package/locales/en/overrides/.agents/skills/eval/SKILL.md +42 -0
  30. package/locales/en/overrides/.agents/skills/interrogate/SKILL.md +49 -0
  31. package/locales/en/overrides/.agents/skills/number-vetting/SKILL.md +35 -0
  32. package/locales/en/overrides/.agents/skills/page-refactor/SKILL.md +192 -0
  33. package/locales/en/overrides/.agents/skills/papercut-fix/SKILL.md +92 -0
  34. package/locales/en/overrides/.agents/skills/pause-safely/SKILL.md +31 -0
  35. package/locales/en/overrides/.agents/skills/perf/SKILL.md +42 -0
  36. package/locales/en/overrides/.agents/skills/review-method/SKILL.md +92 -0
  37. package/locales/en/overrides/.agents/skills/session-resume/SKILL.md +69 -0
  38. package/locales/en/overrides/.agents/skills/shipyard-workflow-closeout/SKILL.md +109 -0
  39. package/locales/en/overrides/.agents/skills/show-me-your-work/SKILL.md +57 -0
  40. package/locales/en/overrides/.agents/skills/tfs-pr/SKILL.md +95 -0
  41. package/locales/en/overrides/.agents/skills/verify-ui/SKILL.md +116 -0
  42. package/locales/en/overrides/.agents/skills/visual-parity/SKILL.md +35 -0
  43. package/locales/en/overrides/.agents/skills/why/SKILL.md +56 -0
  44. package/locales/en/overrides/.agents/skills/wiki/SKILL.md +53 -0
  45. package/locales/en/overrides/.claude/agents/implementer.md +9 -0
  46. package/locales/en/overrides/.claude/agents/independent-reviewer.md +10 -0
  47. package/locales/en/overrides/.claude/agents/pr-adjudicator.md +10 -0
  48. package/locales/en/overrides/.claude/agents/pr-finder.md +10 -0
  49. package/locales/en/overrides/.claude/agents/pr-verifier.md +10 -0
  50. package/locales/en/overrides/.claude/agents/ui-verifier.md +10 -0
  51. package/locales/en/overrides/.claude/agents/wiki-compiler.md +10 -0
  52. package/locales/en/overrides/.claude/commands/wf-deploy.md +8 -0
  53. package/locales/en/overrides/.claude/commands/wf-maintain.md +8 -0
  54. package/locales/en/overrides/.claude/commands/wf-new-task.md +8 -0
  55. package/locales/en/overrides/.claude/commands/wf-pipeline-run.md +8 -0
  56. package/locales/en/overrides/.claude/commands/wf-pr-review.md +8 -0
  57. package/locales/en/overrides/.claude/commands/wf-review.md +8 -0
  58. package/locales/en/overrides/.claude/commands/wf-stages.md +8 -0
  59. package/locales/en/overrides/.cline/agents/implementer.yml +13 -0
  60. package/locales/en/overrides/.cline/agents/independent-reviewer.yml +11 -0
  61. package/locales/en/overrides/.cline/agents/pr-adjudicator.yml +11 -0
  62. package/locales/en/overrides/.cline/agents/pr-finder.yml +11 -0
  63. package/locales/en/overrides/.cline/agents/pr-verifier.yml +11 -0
  64. package/locales/en/overrides/.cline/agents/ui-verifier.yml +8 -0
  65. package/locales/en/overrides/.cline/agents/wiki-compiler.yml +14 -0
  66. package/locales/en/overrides/.cline/workflows/wf-deploy.md +8 -0
  67. package/locales/en/overrides/.cline/workflows/wf-maintain.md +8 -0
  68. package/locales/en/overrides/.cline/workflows/wf-new-task.md +8 -0
  69. package/locales/en/overrides/.cline/workflows/wf-pipeline-run.md +8 -0
  70. package/locales/en/overrides/.cline/workflows/wf-pr-review.md +8 -0
  71. package/locales/en/overrides/.cline/workflows/wf-review.md +8 -0
  72. package/locales/en/overrides/.cline/workflows/wf-stages.md +8 -0
  73. package/locales/en/overrides/.codebuddy/CODEBUDDY.md +7 -0
  74. package/locales/en/overrides/.codebuddy/agents/implementer.md +9 -0
  75. package/locales/en/overrides/.codebuddy/agents/independent-reviewer.md +10 -0
  76. package/locales/en/overrides/.codebuddy/agents/pr-adjudicator.md +10 -0
  77. package/locales/en/overrides/.codebuddy/agents/pr-finder.md +10 -0
  78. package/locales/en/overrides/.codebuddy/agents/pr-verifier.md +10 -0
  79. package/locales/en/overrides/.codebuddy/agents/ui-verifier.md +11 -0
  80. package/locales/en/overrides/.codebuddy/agents/wiki-compiler.md +10 -0
  81. package/locales/en/overrides/.codebuddy/commands/wf-deploy.md +8 -0
  82. package/locales/en/overrides/.codebuddy/commands/wf-maintain.md +8 -0
  83. package/locales/en/overrides/.codebuddy/commands/wf-new-task.md +8 -0
  84. package/locales/en/overrides/.codebuddy/commands/wf-pipeline-run.md +8 -0
  85. package/locales/en/overrides/.codebuddy/commands/wf-pr-review.md +8 -0
  86. package/locales/en/overrides/.codebuddy/commands/wf-review.md +8 -0
  87. package/locales/en/overrides/.codebuddy/commands/wf-stages.md +8 -0
  88. package/locales/en/overrides/.codebuddy/rules/backend-scope.md +5 -0
  89. package/locales/en/overrides/.codebuddy/rules/frontend-scope.md +5 -0
  90. package/locales/en/overrides/.codebuddy/skills/tfs-pr/SKILL.md +6 -0
  91. package/locales/en/overrides/.commandcode/agents/implementer.md +10 -0
  92. package/locales/en/overrides/.commandcode/agents/independent-reviewer.md +9 -0
  93. package/locales/en/overrides/.commandcode/agents/pr-adjudicator.md +9 -0
  94. package/locales/en/overrides/.commandcode/agents/pr-finder.md +9 -0
  95. package/locales/en/overrides/.commandcode/agents/pr-verifier.md +9 -0
  96. package/locales/en/overrides/.commandcode/agents/ui-verifier.md +10 -0
  97. package/locales/en/overrides/.commandcode/agents/wiki-compiler.md +10 -0
  98. package/locales/en/overrides/.commandcode/commands/wf-deploy.md +7 -0
  99. package/locales/en/overrides/.commandcode/commands/wf-maintain.md +7 -0
  100. package/locales/en/overrides/.commandcode/commands/wf-new-task.md +7 -0
  101. package/locales/en/overrides/.commandcode/commands/wf-pipeline-run.md +7 -0
  102. package/locales/en/overrides/.commandcode/commands/wf-pr-review.md +7 -0
  103. package/locales/en/overrides/.commandcode/commands/wf-review.md +7 -0
  104. package/locales/en/overrides/.commandcode/commands/wf-stages.md +7 -0
  105. package/locales/en/overrides/.opencode/agents/implementer.md +51 -0
  106. package/locales/en/overrides/.opencode/agents/independent-reviewer.md +18 -0
  107. package/locales/en/overrides/.opencode/agents/pr-adjudicator.md +18 -0
  108. package/locales/en/overrides/.opencode/agents/pr-finder.md +18 -0
  109. package/locales/en/overrides/.opencode/agents/pr-verifier.md +18 -0
  110. package/locales/en/overrides/.opencode/agents/ui-verifier.md +45 -0
  111. package/locales/en/overrides/.opencode/agents/wiki-compiler.md +51 -0
  112. package/locales/en/overrides/.opencode/commands/wf-deploy.md +7 -0
  113. package/locales/en/overrides/.opencode/commands/wf-maintain.md +7 -0
  114. package/locales/en/overrides/.opencode/commands/wf-new-task.md +7 -0
  115. package/locales/en/overrides/.opencode/commands/wf-pipeline-run.md +7 -0
  116. package/locales/en/overrides/.opencode/commands/wf-pr-review.md +7 -0
  117. package/locales/en/overrides/.opencode/commands/wf-review.md +7 -0
  118. package/locales/en/overrides/.opencode/commands/wf-stages.md +7 -0
  119. package/locales/en/overrides/.pi/agents/implementer.md +11 -0
  120. package/locales/en/overrides/.pi/agents/independent-reviewer.md +12 -0
  121. package/locales/en/overrides/.pi/agents/pr-adjudicator.md +12 -0
  122. package/locales/en/overrides/.pi/agents/pr-finder.md +11 -0
  123. package/locales/en/overrides/.pi/agents/pr-verifier.md +11 -0
  124. package/locales/en/overrides/.pi/agents/ui-verifier.md +11 -0
  125. package/locales/en/overrides/.pi/agents/wiki-compiler.md +11 -0
  126. package/locales/en/overrides/.qoder/agents/implementer.md +9 -0
  127. package/locales/en/overrides/.qoder/agents/independent-reviewer.md +10 -0
  128. package/locales/en/overrides/.qoder/agents/pr-adjudicator.md +10 -0
  129. package/locales/en/overrides/.qoder/agents/pr-finder.md +10 -0
  130. package/locales/en/overrides/.qoder/agents/pr-verifier.md +10 -0
  131. package/locales/en/overrides/.qoder/agents/ui-verifier.md +10 -0
  132. package/locales/en/overrides/.qoder/agents/wiki-compiler.md +10 -0
  133. package/locales/en/overrides/.qoder/commands/wf-deploy.md +8 -0
  134. package/locales/en/overrides/.qoder/commands/wf-maintain.md +8 -0
  135. package/locales/en/overrides/.qoder/commands/wf-new-task.md +8 -0
  136. package/locales/en/overrides/.qoder/commands/wf-pipeline-run.md +8 -0
  137. package/locales/en/overrides/.qoder/commands/wf-pr-review.md +8 -0
  138. package/locales/en/overrides/.qoder/commands/wf-review.md +8 -0
  139. package/locales/en/overrides/.qoder/commands/wf-stages.md +8 -0
  140. package/locales/en/overrides/.qwen/agents/implementer.md +10 -0
  141. package/locales/en/overrides/.qwen/agents/independent-reviewer.md +10 -0
  142. package/locales/en/overrides/.qwen/agents/pr-adjudicator.md +10 -0
  143. package/locales/en/overrides/.qwen/agents/pr-finder.md +10 -0
  144. package/locales/en/overrides/.qwen/agents/pr-verifier.md +10 -0
  145. package/locales/en/overrides/.qwen/agents/ui-verifier.md +10 -0
  146. package/locales/en/overrides/.qwen/agents/wiki-compiler.md +13 -0
  147. package/locales/en/overrides/.qwen/commands/wf-deploy.md +7 -0
  148. package/locales/en/overrides/.qwen/commands/wf-maintain.md +7 -0
  149. package/locales/en/overrides/.qwen/commands/wf-new-task.md +7 -0
  150. package/locales/en/overrides/.qwen/commands/wf-pipeline-run.md +7 -0
  151. package/locales/en/overrides/.qwen/commands/wf-pr-review.md +7 -0
  152. package/locales/en/overrides/.qwen/commands/wf-review.md +7 -0
  153. package/locales/en/overrides/.qwen/commands/wf-stages.md +7 -0
  154. package/locales/en/overrides/.trae/agents/implementer.md +9 -0
  155. package/locales/en/overrides/.trae/agents/independent-reviewer.md +10 -0
  156. package/locales/en/overrides/.trae/agents/pr-adjudicator.md +10 -0
  157. package/locales/en/overrides/.trae/agents/pr-finder.md +10 -0
  158. package/locales/en/overrides/.trae/agents/pr-verifier.md +10 -0
  159. package/locales/en/overrides/.trae/agents/ui-verifier.md +10 -0
  160. package/locales/en/overrides/.trae/agents/wiki-compiler.md +10 -0
  161. package/locales/en/overrides/.trae/commands/wf-deploy.md +8 -0
  162. package/locales/en/overrides/.trae/commands/wf-maintain.md +8 -0
  163. package/locales/en/overrides/.trae/commands/wf-new-task.md +8 -0
  164. package/locales/en/overrides/.trae/commands/wf-pipeline-run.md +8 -0
  165. package/locales/en/overrides/.trae/commands/wf-pr-review.md +8 -0
  166. package/locales/en/overrides/.trae/commands/wf-review.md +8 -0
  167. package/locales/en/overrides/.trae/commands/wf-stages.md +8 -0
  168. package/locales/en/overrides/.trae/rules/backend-scope.md +5 -0
  169. package/locales/en/overrides/.trae/rules/frontend-scope.md +5 -0
  170. package/locales/en/overrides/.zcode/agents/implementer.md +8 -0
  171. package/locales/en/overrides/.zcode/agents/independent-reviewer.md +8 -0
  172. package/locales/en/overrides/.zcode/agents/ui-verifier.md +8 -0
  173. package/locales/en/overrides/.zcode/agents/wiki-compiler.md +8 -0
  174. package/locales/en/overrides/AGENTS.md +52 -0
  175. package/locales/en/overrides/CLAUDE.md +20 -0
  176. package/locales/en/overrides/wiki/INDEX.md +33 -0
  177. package/locales/en/overrides/wiki/drafts-archive/README.md +6 -0
  178. package/locales/en/overrides/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +22 -0
  179. package/locales/en/overrides/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +230 -0
  180. package/locales/en/overrides/workflow/INDEX.md +13 -0
  181. package/locales/en/overrides/workflow/README.md +67 -0
  182. package/locales/en/overrides/workflow/archive/README.md +3 -0
  183. package/locales/en/overrides/workflow/delegations.md +4 -0
  184. package/locales/en/overrides/workflow/effective-policy.md +4 -0
  185. package/locales/en/overrides/workflow/gate-cost.md +4 -0
  186. package/locales/en/overrides/workflow/incidents/_TEMPLATE.md +49 -0
  187. package/locales/en/overrides/workflow/intents/_TEMPLATE.md +43 -0
  188. package/locales/en/overrides/workflow/metrics.md +4 -0
  189. package/locales/en/overrides/workflow/papercuts.md +3 -0
  190. package/locales/en/overrides/workflow/plans/_TEMPLATE.md +47 -0
  191. package/locales/en/overrides/workflow/regression-checklist.md +3 -0
  192. package/locales/en/overrides/workflow/specs/_TEMPLATE.md +86 -0
  193. package/locales/en/overrides/workflow/verify-evidence.md +4 -0
  194. package/locales/zh-CN/installer.json +25 -0
  195. package/package.json +23 -36
  196. package/schemas/install-manifest.schema.json +24 -0
  197. package/schemas/project-profile.schema.json +28 -0
  198. package/src/cli/args.mjs +41 -0
  199. package/src/cli/main.mjs +72 -0
  200. package/src/commands/add-host.mjs +29 -0
  201. package/src/commands/doctor.mjs +80 -0
  202. package/src/commands/install.mjs +149 -0
  203. package/src/commands/upgrade.mjs +30 -0
  204. package/src/git/config.mjs +61 -0
  205. package/src/hosts/registry.mjs +26 -0
  206. package/src/i18n.mjs +32 -0
  207. package/src/install/apply.mjs +124 -0
  208. package/src/install/manifest.mjs +40 -0
  209. package/src/install/plan.mjs +83 -0
  210. package/src/render/tokens.mjs +58 -0
  211. package/templates/engine/.agents/board/dev-tour.html +1940 -0
  212. package/templates/engine/.agents/board/index.html +835 -0
  213. package/templates/engine/.agents/commands/deploy.md +52 -0
  214. package/templates/engine/.agents/commands/maintain.md +76 -0
  215. package/templates/engine/.agents/commands/new-task.md +89 -0
  216. package/templates/engine/.agents/commands/pipeline-run.md +56 -0
  217. package/templates/engine/.agents/commands/pr-review.md +30 -0
  218. package/templates/engine/.agents/commands/review.md +93 -0
  219. package/templates/engine/.agents/commands/stages.md +256 -0
  220. package/templates/engine/.agents/config/commit-msg-rules.json +7 -0
  221. package/templates/engine/.agents/config/engine.json +11 -0
  222. package/templates/engine/.agents/config/gate-budgets.json +5 -0
  223. package/templates/engine/.agents/config/mechanism-registry.md +62 -0
  224. package/templates/engine/.agents/config/model-roles.json +26 -0
  225. package/templates/engine/.agents/config/model-roles.local.example.json +7 -0
  226. package/templates/engine/.agents/config/pr-review.json +67 -0
  227. package/templates/engine/.agents/config/principles.md +32 -0
  228. package/templates/engine/.agents/config/workflow-enums.txt +25 -0
  229. package/templates/engine/.agents/hooks/check-architecture.mjs +168 -0
  230. package/templates/engine/.agents/hooks/check-audit-fields.mjs +56 -0
  231. package/templates/engine/.agents/hooks/check-commit-plan-ref.mjs +84 -0
  232. package/templates/engine/.agents/hooks/check-confirm-order.mjs +281 -0
  233. package/templates/engine/.agents/hooks/check-delete-guard.mjs +63 -0
  234. package/templates/engine/.agents/hooks/check-notify-guard.mjs +55 -0
  235. package/templates/engine/.agents/hooks/commit-check.cjs +208 -0
  236. package/templates/engine/.agents/hooks/gates.json +33 -0
  237. package/templates/engine/.agents/hooks/local-pre-commit.mjs +27 -0
  238. package/templates/engine/.agents/hooks/pre-shell-check.cjs +361 -0
  239. package/templates/engine/.agents/hooks/pre-write-check.cjs +220 -0
  240. package/templates/engine/.agents/notes/gate-diet.md +75 -0
  241. package/templates/engine/.agents/notes/pr-review-cost-discipline.md +48 -0
  242. package/templates/engine/.agents/notes/process-order-rule.md +21 -0
  243. package/templates/engine/.agents/notes/runtime-env.local.example.md +21 -0
  244. package/templates/engine/.agents/pipelines/_TEMPLATE.md +75 -0
  245. package/templates/engine/.agents/pipelines/pipeline-closing.md +28 -0
  246. package/templates/engine/.agents/pipelines//347/244/272/344/276/213-/345/271/266/350/241/214/345/256/236/347/216/260/350/257/204/345/256/241.md +16 -0
  247. package/templates/engine/.agents/roles/implementer.md +28 -0
  248. package/templates/engine/.agents/roles/independent-reviewer.md +39 -0
  249. package/templates/engine/.agents/roles/pr-adjudicator.md +27 -0
  250. package/templates/engine/.agents/roles/pr-finder.md +51 -0
  251. package/templates/engine/.agents/roles/pr-verifier.md +44 -0
  252. package/templates/engine/.agents/roles/ui-verifier.md +22 -0
  253. package/templates/engine/.agents/roles/wiki-compiler.md +47 -0
  254. package/templates/engine/.agents/scripts/agg-delegations.mjs +439 -0
  255. package/templates/engine/.agents/scripts/agg-judgments.mjs +301 -0
  256. package/templates/engine/.agents/scripts/agg-kb-usage.mjs +196 -0
  257. package/templates/engine/.agents/scripts/append-compensation.mjs +109 -0
  258. package/templates/engine/.agents/scripts/archive-sweep.mjs +229 -0
  259. package/templates/engine/.agents/scripts/auto-tour.mjs +77 -0
  260. package/templates/engine/.agents/scripts/board-port.mjs +17 -0
  261. package/templates/engine/.agents/scripts/check-doc-body-drift.mjs +102 -0
  262. package/templates/engine/.agents/scripts/check-engine-artifacts.mjs +54 -0
  263. package/templates/engine/.agents/scripts/check-hook-wiring.mjs +75 -0
  264. package/templates/engine/.agents/scripts/check-lane-surface.mjs +393 -0
  265. package/templates/engine/.agents/scripts/check-ledger-doc-presence.mjs +71 -0
  266. package/templates/engine/.agents/scripts/check-ledger-invariant.mjs +873 -0
  267. package/templates/engine/.agents/scripts/check-local-gate-config.mjs +95 -0
  268. package/templates/engine/.agents/scripts/check-local-gates.mjs +248 -0
  269. package/templates/engine/.agents/scripts/check-loop-kit.mjs +550 -0
  270. package/templates/engine/.agents/scripts/check-loop-rev-semantics.mjs +59 -0
  271. package/templates/engine/.agents/scripts/check-loop-sections/s01-pairing.mjs +116 -0
  272. package/templates/engine/.agents/scripts/check-loop-sections/s03x-regr-evidence.mjs +38 -0
  273. package/templates/engine/.agents/scripts/check-loop-sections/s08-acceptance.mjs +130 -0
  274. package/templates/engine/.agents/scripts/check-loop-sections/s15-fingerprint.mjs +152 -0
  275. package/templates/engine/.agents/scripts/check-loop-sections/s23-convergence-audit.mjs +182 -0
  276. package/templates/engine/.agents/scripts/check-loop-sections/s29-regr-enforcer.mjs +69 -0
  277. package/templates/engine/.agents/scripts/check-loop.mjs +131 -0
  278. package/templates/engine/.agents/scripts/check-regression-consistency.mjs +252 -0
  279. package/templates/engine/.agents/scripts/check-schema-residue.mjs +144 -0
  280. package/templates/engine/.agents/scripts/check-scope-range.mjs +156 -0
  281. package/templates/engine/.agents/scripts/check-scope.mjs +121 -0
  282. package/templates/engine/.agents/scripts/check-scripts-syntax.mjs +138 -0
  283. package/templates/engine/.agents/scripts/check-secrets-lite.mjs +239 -0
  284. package/templates/engine/.agents/scripts/check-secrets.mjs +104 -0
  285. package/templates/engine/.agents/scripts/check-test-impact-map.mjs +107 -0
  286. package/templates/engine/.agents/scripts/ci-assert-frontend-deps.mjs +42 -0
  287. package/templates/engine/.agents/scripts/ci-commit-hygiene.mjs +86 -0
  288. package/templates/engine/.agents/scripts/ci-install-gitleaks.mjs +75 -0
  289. package/templates/engine/.agents/scripts/ci-push-before.mjs +49 -0
  290. package/templates/engine/.agents/scripts/closeout.mjs +127 -0
  291. package/templates/engine/.agents/scripts/compact-ledgers.mjs +70 -0
  292. package/templates/engine/.agents/scripts/confirm-doc.mjs +737 -0
  293. package/templates/engine/.agents/scripts/delegation-presence.mjs +38 -0
  294. package/templates/engine/.agents/scripts/dev-tour-model.mjs +1398 -0
  295. package/templates/engine/.agents/scripts/dream-run.mjs +283 -0
  296. package/templates/engine/.agents/scripts/ensure-board.mjs +187 -0
  297. package/templates/engine/.agents/scripts/failure-attribution.mjs +11 -0
  298. package/templates/engine/.agents/scripts/fill-intent.mjs +60 -0
  299. package/templates/engine/.agents/scripts/fill-plan.mjs +105 -0
  300. package/templates/engine/.agents/scripts/fill-spec.mjs +72 -0
  301. package/templates/engine/.agents/scripts/gen-dev-tour.mjs +191 -0
  302. package/templates/engine/.agents/scripts/gen-effective-policy.mjs +113 -0
  303. package/templates/engine/.agents/scripts/gen-engine-map.mjs +292 -0
  304. package/templates/engine/.agents/scripts/gen-narrative-claims.mjs +275 -0
  305. package/templates/engine/.agents/scripts/gen-verify-evidence.mjs +115 -0
  306. package/templates/engine/.agents/scripts/gen-wiki-board.mjs +221 -0
  307. package/templates/engine/.agents/scripts/gen-workflow-index.mjs +201 -0
  308. package/templates/engine/.agents/scripts/gen-workflow-metrics.mjs +692 -0
  309. package/templates/engine/.agents/scripts/git-merge-jsonl.mjs +62 -0
  310. package/templates/engine/.agents/scripts/judgment-ledger.mjs +68 -0
  311. package/templates/engine/.agents/scripts/kb-cache-evict.mjs +50 -0
  312. package/templates/engine/.agents/scripts/kb-search.mjs +423 -0
  313. package/templates/engine/.agents/scripts/lane-surface-audit.mjs +145 -0
  314. package/templates/engine/.agents/scripts/ledger-loader.mjs +77 -0
  315. package/templates/engine/.agents/scripts/ledger-shards.mjs +346 -0
  316. package/templates/engine/.agents/scripts/metrics-core.mjs +131 -0
  317. package/templates/engine/.agents/scripts/pipeline-run.mjs +964 -0
  318. package/templates/engine/.agents/scripts/policy.mjs +250 -0
  319. package/templates/engine/.agents/scripts/pr-create.mjs +54 -0
  320. package/templates/engine/.agents/scripts/pr-review.mjs +1551 -0
  321. package/templates/engine/.agents/scripts/quote-grounding.mjs +233 -0
  322. package/templates/engine/.agents/scripts/regen-ledgers.mjs +59 -0
  323. package/templates/engine/.agents/scripts/rewrite-file.mjs +135 -0
  324. package/templates/engine/.agents/scripts/rule-budget.mjs +246 -0
  325. package/templates/engine/.agents/scripts/stage-gates.mjs +812 -0
  326. package/templates/engine/.agents/scripts/test-impact-lib.mjs +451 -0
  327. package/templates/engine/.agents/scripts/test-impact.mjs +105 -0
  328. package/templates/engine/.agents/scripts/trust-mode.mjs +130 -0
  329. package/templates/engine/.agents/scripts/verify-scope.mjs +163 -0
  330. package/templates/engine/.agents/scripts/verify-wiki-consistency.mjs +264 -0
  331. package/templates/engine/.agents/scripts/verify.mjs +847 -0
  332. package/templates/engine/.agents/scripts/warn-format.mjs +57 -0
  333. package/templates/engine/.agents/scripts/wf-journal.mjs +230 -0
  334. package/templates/engine/.agents/scripts/workflow-board-server.mjs +696 -0
  335. package/templates/engine/.agents/scripts/workflow-enums.mjs +70 -0
  336. package/templates/engine/.agents/scripts/workflows-check.mjs +260 -0
  337. package/templates/engine/.agents/settings.json +33 -0
  338. package/templates/engine/.agents/skills/arena/SKILL.md +50 -0
  339. package/templates/engine/.agents/skills/autonomous-run/SKILL.md +45 -0
  340. package/templates/engine/.agents/skills/blast-radius/SKILL.md +53 -0
  341. package/templates/engine/.agents/skills/csharp-quality-gates/SKILL.md +109 -0
  342. package/templates/engine/.agents/skills/csharp-quality-gates/scripts/quality-gates.mjs +430 -0
  343. package/templates/engine/.agents/skills/dev-tour/SKILL.md +98 -0
  344. package/templates/engine/.agents/skills/dream/SKILL.md +63 -0
  345. package/templates/engine/.agents/skills/eval/SKILL.md +42 -0
  346. package/templates/engine/.agents/skills/eval/scripts/eval-score.mjs +59 -0
  347. package/templates/engine/.agents/skills/interrogate/SKILL.md +49 -0
  348. package/templates/engine/.agents/skills/interrogate/scripts/interrogate-plan.mjs +72 -0
  349. package/templates/engine/.agents/skills/number-vetting/SKILL.md +35 -0
  350. package/templates/engine/.agents/skills/page-refactor/SKILL.md +192 -0
  351. package/templates/engine/.agents/skills/page-refactor/references/templates.md +989 -0
  352. package/templates/engine/.agents/skills/papercut-fix/SKILL.md +92 -0
  353. package/templates/engine/.agents/skills/papercut-fix/references/response-template.md +81 -0
  354. package/templates/engine/.agents/skills/pause-safely/SKILL.md +31 -0
  355. package/templates/engine/.agents/skills/perf/SKILL.md +42 -0
  356. package/templates/engine/.agents/skills/review-method/SKILL.md +92 -0
  357. package/templates/engine/.agents/skills/review-method/golden-set.md +61 -0
  358. package/templates/engine/.agents/skills/session-resume/SKILL.md +69 -0
  359. package/templates/engine/.agents/skills/session-resume/scripts/worktree-audit.mjs +110 -0
  360. package/templates/engine/.agents/skills/shipyard-workflow-closeout/SKILL.md +109 -0
  361. package/templates/engine/.agents/skills/show-me-your-work/SKILL.md +57 -0
  362. package/templates/engine/.agents/skills/show-me-your-work/references/decision-log-template.tsv +1 -0
  363. package/templates/engine/.agents/skills/show-me-your-work/scripts/decision-log.mjs +24 -0
  364. package/templates/engine/.agents/skills/tfs-pr/SKILL.md +95 -0
  365. package/templates/engine/.agents/skills/tfs-pr/scripts/tfs-pr.mjs +947 -0
  366. package/templates/engine/.agents/skills/verify-ui/SKILL.md +116 -0
  367. package/templates/engine/.agents/skills/verify-ui/features/.gitkeep +0 -0
  368. package/templates/engine/.agents/skills/verify-ui/scripts/gen-verify-feature.mjs +114 -0
  369. package/templates/engine/.agents/skills/visual-parity/SKILL.md +35 -0
  370. package/templates/engine/.agents/skills/why/SKILL.md +56 -0
  371. package/templates/engine/.agents/skills/why/scripts/why-evidence.mjs +74 -0
  372. package/templates/engine/.agents/skills/wiki/SKILL.md +53 -0
  373. package/templates/engine/.agents/tests/auto-tour.test.mjs +82 -0
  374. package/templates/engine/.agents/tests/dev-tour-model.test.mjs +452 -0
  375. package/templates/engine/.agents/tests/fill-plan-lite.test.mjs +46 -0
  376. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-bare-mid-path.md +14 -0
  377. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-bare-mid-path.model.json +179 -0
  378. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-fake-path-guard.md +21 -0
  379. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-fake-path-guard.model.json +194 -0
  380. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-h3-batches.md +20 -0
  381. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-h3-batches.model.json +207 -0
  382. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-issues.md +24 -0
  383. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-issues.model.json +225 -0
  384. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-l1-single-file.md +15 -0
  385. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-l1-single-file.model.json +160 -0
  386. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layer-word-unique.md +29 -0
  387. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layer-word-unique.model.json +266 -0
  388. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.md +17 -0
  389. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.model.json +207 -0
  390. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.md +39 -0
  391. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.model.json +359 -0
  392. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-path-guess.md +16 -0
  393. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-path-guess.model.json +131 -0
  394. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-table-rows.md +29 -0
  395. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-table-rows.model.json +190 -0
  396. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-task-checkboxes.md +39 -0
  397. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-task-checkboxes.model.json +362 -0
  398. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-union-label.md +24 -0
  399. package/templates/engine/.agents/tests/fixtures/dev-tour/plan-union-label.model.json +224 -0
  400. package/templates/engine/.agents/tests/tools/gen-synthetic-plan.mjs +108 -0
  401. package/templates/git/.gitattributes +22 -0
  402. package/templates/git/.githooks/commit-msg +72 -0
  403. package/templates/git/.githooks/post-commit +62 -0
  404. package/templates/git/.githooks/pre-commit +197 -0
  405. package/templates/git/.githooks/pre-merge-commit +28 -0
  406. package/templates/git/.githooks/pre-push +201 -0
  407. package/templates/git/.gitignore.engine +11 -0
  408. package/templates/hosts/claude/CLAUDE.md +55 -0
  409. package/templates/hosts/claude/agents/implementer.md +7 -0
  410. package/templates/hosts/claude/agents/independent-reviewer.md +8 -0
  411. package/templates/hosts/claude/agents/pr-adjudicator.md +8 -0
  412. package/templates/hosts/claude/agents/pr-finder.md +8 -0
  413. package/templates/hosts/claude/agents/pr-verifier.md +8 -0
  414. package/templates/hosts/claude/agents/ui-verifier.md +8 -0
  415. package/templates/hosts/claude/agents/wiki-compiler.md +8 -0
  416. package/templates/hosts/claude/commands/wf-deploy.md +10 -0
  417. package/templates/hosts/claude/commands/wf-maintain.md +10 -0
  418. package/templates/hosts/claude/commands/wf-new-task.md +10 -0
  419. package/templates/hosts/claude/commands/wf-pipeline-run.md +10 -0
  420. package/templates/hosts/claude/commands/wf-pr-review.md +10 -0
  421. package/templates/hosts/claude/commands/wf-review.md +10 -0
  422. package/templates/hosts/claude/commands/wf-stages.md +10 -0
  423. package/templates/hosts/claude/settings.json +57 -0
  424. package/templates/hosts/cline/agents/implementer.yml +15 -0
  425. package/templates/hosts/cline/agents/independent-reviewer.yml +20 -0
  426. package/templates/hosts/cline/agents/pr-adjudicator.yml +18 -0
  427. package/templates/hosts/cline/agents/pr-finder.yml +19 -0
  428. package/templates/hosts/cline/agents/pr-verifier.yml +18 -0
  429. package/templates/hosts/cline/agents/ui-verifier.yml +17 -0
  430. package/templates/hosts/cline/agents/wiki-compiler.yml +20 -0
  431. package/templates/hosts/cline/hooks/PreToolUse.cjs +260 -0
  432. package/templates/hosts/cline/workflows/wf-deploy.md +8 -0
  433. package/templates/hosts/cline/workflows/wf-maintain.md +8 -0
  434. package/templates/hosts/cline/workflows/wf-new-task.md +8 -0
  435. package/templates/hosts/cline/workflows/wf-pipeline-run.md +8 -0
  436. package/templates/hosts/cline/workflows/wf-pr-review.md +8 -0
  437. package/templates/hosts/cline/workflows/wf-review.md +8 -0
  438. package/templates/hosts/cline/workflows/wf-stages.md +8 -0
  439. package/templates/hosts/codebuddy/CODEBUDDY.md +7 -0
  440. package/templates/hosts/codebuddy/agents/implementer.md +9 -0
  441. package/templates/hosts/codebuddy/agents/independent-reviewer.md +10 -0
  442. package/templates/hosts/codebuddy/agents/pr-adjudicator.md +10 -0
  443. package/templates/hosts/codebuddy/agents/pr-finder.md +10 -0
  444. package/templates/hosts/codebuddy/agents/pr-verifier.md +10 -0
  445. package/templates/hosts/codebuddy/agents/ui-verifier.md +11 -0
  446. package/templates/hosts/codebuddy/agents/wiki-compiler.md +10 -0
  447. package/templates/hosts/codebuddy/commands/wf-deploy.md +10 -0
  448. package/templates/hosts/codebuddy/commands/wf-maintain.md +10 -0
  449. package/templates/hosts/codebuddy/commands/wf-new-task.md +10 -0
  450. package/templates/hosts/codebuddy/commands/wf-pipeline-run.md +10 -0
  451. package/templates/hosts/codebuddy/commands/wf-pr-review.md +10 -0
  452. package/templates/hosts/codebuddy/commands/wf-review.md +10 -0
  453. package/templates/hosts/codebuddy/commands/wf-stages.md +10 -0
  454. package/templates/hosts/codebuddy/rules/backend-scope.md +5 -0
  455. package/templates/hosts/codebuddy/rules/frontend-scope.md +5 -0
  456. package/templates/hosts/codebuddy/settings.json +31 -0
  457. package/templates/hosts/codebuddy/skills/tfs-pr/SKILL.md +6 -0
  458. package/templates/hosts/commandcode/agents/implementer.md +10 -0
  459. package/templates/hosts/commandcode/agents/independent-reviewer.md +9 -0
  460. package/templates/hosts/commandcode/agents/pr-adjudicator.md +9 -0
  461. package/templates/hosts/commandcode/agents/pr-finder.md +9 -0
  462. package/templates/hosts/commandcode/agents/pr-verifier.md +9 -0
  463. package/templates/hosts/commandcode/agents/ui-verifier.md +11 -0
  464. package/templates/hosts/commandcode/agents/wiki-compiler.md +10 -0
  465. package/templates/hosts/commandcode/commands/wf-deploy.md +9 -0
  466. package/templates/hosts/commandcode/commands/wf-maintain.md +9 -0
  467. package/templates/hosts/commandcode/commands/wf-new-task.md +9 -0
  468. package/templates/hosts/commandcode/commands/wf-pipeline-run.md +9 -0
  469. package/templates/hosts/commandcode/commands/wf-pr-review.md +9 -0
  470. package/templates/hosts/commandcode/commands/wf-review.md +9 -0
  471. package/templates/hosts/commandcode/commands/wf-stages.md +9 -0
  472. package/templates/hosts/commandcode/settings.json +59 -0
  473. package/templates/hosts/opencode/agents/implementer.md +51 -0
  474. package/templates/hosts/opencode/agents/independent-reviewer.md +18 -0
  475. package/templates/hosts/opencode/agents/pr-adjudicator.md +18 -0
  476. package/templates/hosts/opencode/agents/pr-finder.md +18 -0
  477. package/templates/hosts/opencode/agents/pr-verifier.md +18 -0
  478. package/templates/hosts/opencode/agents/ui-verifier.md +45 -0
  479. package/templates/hosts/opencode/agents/wiki-compiler.md +51 -0
  480. package/templates/hosts/opencode/commands/wf-deploy.md +7 -0
  481. package/templates/hosts/opencode/commands/wf-maintain.md +7 -0
  482. package/templates/hosts/opencode/commands/wf-new-task.md +7 -0
  483. package/templates/hosts/opencode/commands/wf-pipeline-run.md +7 -0
  484. package/templates/hosts/opencode/commands/wf-pr-review.md +7 -0
  485. package/templates/hosts/opencode/commands/wf-review.md +7 -0
  486. package/templates/hosts/opencode/commands/wf-stages.md +7 -0
  487. package/templates/hosts/pi/agents/implementer.md +10 -0
  488. package/templates/hosts/pi/agents/independent-reviewer.md +11 -0
  489. package/templates/hosts/pi/agents/pr-adjudicator.md +11 -0
  490. package/templates/hosts/pi/agents/pr-finder.md +10 -0
  491. package/templates/hosts/pi/agents/pr-verifier.md +10 -0
  492. package/templates/hosts/pi/agents/ui-verifier.md +10 -0
  493. package/templates/hosts/pi/agents/wiki-compiler.md +10 -0
  494. package/templates/hosts/pi/extensions/lib/gates-core.cjs +196 -0
  495. package/templates/hosts/pi/extensions/shipyard-gates.ts +95 -0
  496. package/templates/hosts/pi/settings.json +5 -0
  497. package/templates/hosts/qoder/agents/implementer.md +9 -0
  498. package/templates/hosts/qoder/agents/independent-reviewer.md +10 -0
  499. package/templates/hosts/qoder/agents/pr-adjudicator.md +10 -0
  500. package/templates/hosts/qoder/agents/pr-finder.md +10 -0
  501. package/templates/hosts/qoder/agents/pr-verifier.md +10 -0
  502. package/templates/hosts/qoder/agents/ui-verifier.md +10 -0
  503. package/templates/hosts/qoder/agents/wiki-compiler.md +10 -0
  504. package/templates/hosts/qoder/commands/wf-deploy.md +8 -0
  505. package/templates/hosts/qoder/commands/wf-maintain.md +8 -0
  506. package/templates/hosts/qoder/commands/wf-new-task.md +8 -0
  507. package/templates/hosts/qoder/commands/wf-pipeline-run.md +8 -0
  508. package/templates/hosts/qoder/commands/wf-pr-review.md +8 -0
  509. package/templates/hosts/qoder/commands/wf-review.md +8 -0
  510. package/templates/hosts/qoder/commands/wf-stages.md +8 -0
  511. package/templates/hosts/qoder/settings.json +63 -0
  512. package/templates/hosts/qwen/agents/implementer.md +8 -0
  513. package/templates/hosts/qwen/agents/independent-reviewer.md +8 -0
  514. package/templates/hosts/qwen/agents/pr-adjudicator.md +8 -0
  515. package/templates/hosts/qwen/agents/pr-finder.md +8 -0
  516. package/templates/hosts/qwen/agents/pr-verifier.md +8 -0
  517. package/templates/hosts/qwen/agents/ui-verifier.md +8 -0
  518. package/templates/hosts/qwen/agents/wiki-compiler.md +11 -0
  519. package/templates/hosts/qwen/commands/wf-deploy.md +9 -0
  520. package/templates/hosts/qwen/commands/wf-maintain.md +9 -0
  521. package/templates/hosts/qwen/commands/wf-new-task.md +9 -0
  522. package/templates/hosts/qwen/commands/wf-pipeline-run.md +9 -0
  523. package/templates/hosts/qwen/commands/wf-pr-review.md +9 -0
  524. package/templates/hosts/qwen/commands/wf-review.md +9 -0
  525. package/templates/hosts/qwen/commands/wf-stages.md +9 -0
  526. package/templates/hosts/qwen/settings.json +59 -0
  527. package/templates/hosts/trae/agents/implementer.md +9 -0
  528. package/templates/hosts/trae/agents/independent-reviewer.md +10 -0
  529. package/templates/hosts/trae/agents/pr-adjudicator.md +10 -0
  530. package/templates/hosts/trae/agents/pr-finder.md +10 -0
  531. package/templates/hosts/trae/agents/pr-verifier.md +10 -0
  532. package/templates/hosts/trae/agents/ui-verifier.md +10 -0
  533. package/templates/hosts/trae/agents/wiki-compiler.md +10 -0
  534. package/templates/hosts/trae/commands/wf-deploy.md +8 -0
  535. package/templates/hosts/trae/commands/wf-maintain.md +8 -0
  536. package/templates/hosts/trae/commands/wf-new-task.md +8 -0
  537. package/templates/hosts/trae/commands/wf-pipeline-run.md +8 -0
  538. package/templates/hosts/trae/commands/wf-pr-review.md +8 -0
  539. package/templates/hosts/trae/commands/wf-review.md +8 -0
  540. package/templates/hosts/trae/commands/wf-stages.md +8 -0
  541. package/templates/hosts/trae/hooks.json +17 -0
  542. package/templates/hosts/trae/rules/backend-scope.md +5 -0
  543. package/templates/hosts/trae/rules/frontend-scope.md +5 -0
  544. package/templates/hosts/zcode/agents/implementer.md +8 -0
  545. package/templates/hosts/zcode/agents/independent-reviewer.md +8 -0
  546. package/templates/hosts/zcode/agents/ui-verifier.md +8 -0
  547. package/templates/hosts/zcode/agents/wiki-compiler.md +8 -0
  548. package/templates/hosts/zcode/config.json +31 -0
  549. package/templates/hosts/zcode/workflows/code-review.dwf.ts +428 -0
  550. package/templates/hosts/zcode/workflows/fullchain-flow-test.dwf.ts +898 -0
  551. package/templates/profiles/dotnet/.agents/config/lane-surfaces.txt +33 -0
  552. package/templates/profiles/dotnet/.agents/config/rule-budgets.txt +84 -0
  553. package/templates/profiles/dotnet/.agents/config/test-impact-map.json +590 -0
  554. package/templates/profiles/dotnet/.agents/config/workflow-modules.txt +18 -0
  555. package/templates/profiles/dotnet/.agents/hooks/commit-check.config.json +18 -0
  556. package/templates/profiles/dotnet/.agents/hooks/delete-guard-allowlist.txt +28 -0
  557. package/templates/profiles/dotnet/.agents/notes/runtime-env.md +178 -0
  558. package/templates/profiles/dotnet/AGENTS.md +52 -0
  559. package/templates/profiles/empty/.agents/config/lane-surfaces.txt +12 -0
  560. package/templates/profiles/empty/.agents/config/rule-budgets.txt +3 -0
  561. package/templates/profiles/empty/.agents/config/test-impact-map.json +8 -0
  562. package/templates/profiles/empty/.agents/config/workflow-modules.txt +2 -0
  563. package/templates/profiles/empty/.agents/hooks/commit-check.config.json +5 -0
  564. package/templates/profiles/empty/.agents/hooks/delete-guard-allowlist.txt +2 -0
  565. package/templates/profiles/empty/.agents/notes/runtime-env.md +44 -0
  566. package/templates/profiles/empty/AGENTS.md +52 -0
  567. package/templates/profiles/node/.agents/config/lane-surfaces.txt +12 -0
  568. package/templates/profiles/node/.agents/config/rule-budgets.txt +3 -0
  569. package/templates/profiles/node/.agents/config/test-impact-map.json +8 -0
  570. package/templates/profiles/node/.agents/config/workflow-modules.txt +2 -0
  571. package/templates/profiles/node/.agents/hooks/commit-check.config.json +5 -0
  572. package/templates/profiles/node/.agents/hooks/delete-guard-allowlist.txt +2 -0
  573. package/templates/profiles/node/.agents/notes/runtime-env.md +44 -0
  574. package/templates/profiles/node/AGENTS.md +52 -0
  575. package/templates/scaffold/wiki/INDEX.md +33 -0
  576. package/templates/scaffold/wiki/drafts-archive/README.md +7 -0
  577. package/templates/scaffold/wiki//344/272/247/345/223/201/351/234/200/346/261/202/.gitkeep +0 -0
  578. package/templates/scaffold/wiki//345/274/200/345/217/221/346/226/271/346/241/210/.gitkeep +0 -0
  579. package/templates/scaffold/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +22 -0
  580. package/templates/scaffold/wiki//346/265/213/350/257/225/346/212/245/345/221/212/.gitkeep +0 -0
  581. package/templates/scaffold/wiki//347/224/250/346/210/267/345/212/237/350/203/275/.gitkeep +0 -0
  582. package/templates/scaffold/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +230 -0
  583. package/templates/scaffold/wiki//351/241/271/347/233/256/350/247/204/350/214/203/.gitkeep +0 -0
  584. package/templates/scaffold/workflow/INDEX.md +13 -0
  585. package/templates/scaffold/workflow/README.md +67 -0
  586. package/templates/scaffold/workflow/archive/README.md +3 -0
  587. package/templates/scaffold/workflow/delegations.d/.gitkeep +0 -0
  588. package/templates/scaffold/workflow/delegations.md +4 -0
  589. package/templates/scaffold/workflow/effective-policy.md +4 -0
  590. package/templates/scaffold/workflow/evidence/.gitkeep +0 -0
  591. package/templates/scaffold/workflow/gate-cost.md +4 -0
  592. package/templates/scaffold/workflow/gate-metrics.d/.gitkeep +0 -0
  593. package/templates/scaffold/workflow/incidents/_TEMPLATE.md +49 -0
  594. package/templates/scaffold/workflow/intents/_TEMPLATE.md +43 -0
  595. package/templates/scaffold/workflow/metrics.md +4 -0
  596. package/templates/scaffold/workflow/papercuts.d/.gitkeep +0 -0
  597. package/templates/scaffold/workflow/papercuts.md +3 -0
  598. package/templates/scaffold/workflow/plans/_TEMPLATE.md +47 -0
  599. package/templates/scaffold/workflow/regression-checklist.d/.gitkeep +0 -0
  600. package/templates/scaffold/workflow/regression-checklist.md +3 -0
  601. package/templates/scaffold/workflow/research/.gitkeep +0 -0
  602. package/templates/scaffold/workflow/reviews.d/.gitkeep +0 -0
  603. package/templates/scaffold/workflow/specs/_TEMPLATE.md +87 -0
  604. package/templates/scaffold/workflow/verify-evidence/.gitkeep +0 -0
  605. package/templates/scaffold/workflow/verify-evidence.md +4 -0
  606. package/LICENSE +0 -21
  607. package/modules/gates/README.md +0 -25
  608. package/modules/gates/dotnet-ca/README.md +0 -24
  609. package/modules/gates/dotnet-ca/check-architecture.sh +0 -150
  610. package/modules/gates/dotnet-ca/local-pre-commit.line +0 -1
  611. package/modules/gates/generated-readonly/README.md +0 -13
  612. package/modules/gates/generated-readonly/check-generated.mjs +0 -61
  613. package/modules/gates/generated-readonly/local-pre-commit.line +0 -1
  614. package/modules/gates/node-layer/README.md +0 -9
  615. package/modules/gates/node-layer/check-node-layer.mjs +0 -29
  616. package/modules/gates/node-layer/local-pre-commit.line +0 -1
  617. package/modules/gates/py-import/README.md +0 -9
  618. package/modules/gates/py-import/check-py-import.mjs +0 -30
  619. package/modules/gates/py-import/local-pre-commit.line +0 -1
  620. package/modules/gates/test-protect/README.md +0 -23
  621. package/modules/gates/test-protect/check-test-protect.mjs +0 -64
  622. package/modules/gates/test-protect/local-pre-commit.line +0 -1
  623. package/modules/hosts/README.md +0 -57
  624. package/modules/hosts/claude/agents/implementer.md +0 -51
  625. package/modules/hosts/claude/agents/independent-reviewer.md +0 -49
  626. package/modules/hosts/claude/agents/ui-verifier.md +0 -48
  627. package/modules/hosts/claude/commands/wf-build.md +0 -69
  628. package/modules/hosts/claude/commands/wf-deploy.md +0 -58
  629. package/modules/hosts/claude/commands/wf-design.md +0 -49
  630. package/modules/hosts/claude/commands/wf-gate-checklist.md +0 -77
  631. package/modules/hosts/claude/commands/wf-maintain.md +0 -76
  632. package/modules/hosts/claude/commands/wf-new-task.md +0 -102
  633. package/modules/hosts/claude/commands/wf-pipeline-run.md +0 -35
  634. package/modules/hosts/claude/commands/wf-plan.md +0 -40
  635. package/modules/hosts/claude/commands/wf-review.md +0 -49
  636. package/modules/hosts/claude/commands/wf-sync-hosts.md +0 -64
  637. package/modules/hosts/claude/commands/wf-test.md +0 -68
  638. package/modules/hosts/codex/agents/implementer.md +0 -51
  639. package/modules/hosts/codex/agents/independent-reviewer.md +0 -49
  640. package/modules/hosts/codex/agents/ui-verifier.md +0 -48
  641. package/modules/hosts/codex/commands/wf-build.md +0 -69
  642. package/modules/hosts/codex/commands/wf-deploy.md +0 -58
  643. package/modules/hosts/codex/commands/wf-design.md +0 -49
  644. package/modules/hosts/codex/commands/wf-gate-checklist.md +0 -77
  645. package/modules/hosts/codex/commands/wf-maintain.md +0 -76
  646. package/modules/hosts/codex/commands/wf-new-task.md +0 -102
  647. package/modules/hosts/codex/commands/wf-pipeline-run.md +0 -35
  648. package/modules/hosts/codex/commands/wf-plan.md +0 -40
  649. package/modules/hosts/codex/commands/wf-review.md +0 -49
  650. package/modules/hosts/codex/commands/wf-sync-hosts.md +0 -64
  651. package/modules/hosts/codex/commands/wf-test.md +0 -68
  652. package/modules/hosts/codex/skills/flow-kit/SKILL.md +0 -14
  653. package/modules/hosts/cursor/agents/implementer.md +0 -51
  654. package/modules/hosts/cursor/agents/independent-reviewer.md +0 -49
  655. package/modules/hosts/cursor/agents/ui-verifier.md +0 -48
  656. package/modules/hosts/cursor/commands/wf-build.md +0 -69
  657. package/modules/hosts/cursor/commands/wf-deploy.md +0 -58
  658. package/modules/hosts/cursor/commands/wf-design.md +0 -49
  659. package/modules/hosts/cursor/commands/wf-gate-checklist.md +0 -77
  660. package/modules/hosts/cursor/commands/wf-maintain.md +0 -76
  661. package/modules/hosts/cursor/commands/wf-new-task.md +0 -102
  662. package/modules/hosts/cursor/commands/wf-pipeline-run.md +0 -35
  663. package/modules/hosts/cursor/commands/wf-plan.md +0 -40
  664. package/modules/hosts/cursor/commands/wf-review.md +0 -49
  665. package/modules/hosts/cursor/commands/wf-sync-hosts.md +0 -64
  666. package/modules/hosts/cursor/commands/wf-test.md +0 -68
  667. package/modules/hosts/omp/agents/implementer.md +0 -52
  668. package/modules/hosts/omp/agents/independent-reviewer.md +0 -50
  669. package/modules/hosts/omp/agents/ui-verifier.md +0 -49
  670. package/modules/hosts/opencode/agents/implementer.md +0 -59
  671. package/modules/hosts/opencode/agents/independent-reviewer.md +0 -53
  672. package/modules/hosts/opencode/agents/ui-verifier.md +0 -52
  673. package/modules/hosts/opencode/commands/wf-build.md +0 -69
  674. package/modules/hosts/opencode/commands/wf-deploy.md +0 -58
  675. package/modules/hosts/opencode/commands/wf-design.md +0 -49
  676. package/modules/hosts/opencode/commands/wf-gate-checklist.md +0 -77
  677. package/modules/hosts/opencode/commands/wf-maintain.md +0 -76
  678. package/modules/hosts/opencode/commands/wf-new-task.md +0 -102
  679. package/modules/hosts/opencode/commands/wf-pipeline-run.md +0 -35
  680. package/modules/hosts/opencode/commands/wf-plan.md +0 -40
  681. package/modules/hosts/opencode/commands/wf-review.md +0 -49
  682. package/modules/hosts/opencode/commands/wf-sync-hosts.md +0 -64
  683. package/modules/hosts/opencode/commands/wf-test.md +0 -68
  684. package/modules/hosts/trae/agents/implementer.md +0 -52
  685. package/modules/hosts/trae/agents/independent-reviewer.md +0 -51
  686. package/modules/hosts/trae/agents/ui-verifier.md +0 -50
  687. package/modules/hosts/trae/commands/wf-build.md +0 -70
  688. package/modules/hosts/trae/commands/wf-deploy.md +0 -59
  689. package/modules/hosts/trae/commands/wf-design.md +0 -50
  690. package/modules/hosts/trae/commands/wf-gate-checklist.md +0 -78
  691. package/modules/hosts/trae/commands/wf-maintain.md +0 -77
  692. package/modules/hosts/trae/commands/wf-new-task.md +0 -103
  693. package/modules/hosts/trae/commands/wf-pipeline-run.md +0 -36
  694. package/modules/hosts/trae/commands/wf-plan.md +0 -41
  695. package/modules/hosts/trae/commands/wf-review.md +0 -50
  696. package/modules/hosts/trae/commands/wf-sync-hosts.md +0 -65
  697. package/modules/hosts/trae/commands/wf-test.md +0 -69
  698. package/modules/hosts/trae/hooks/post-edit-check.cjs +0 -98
  699. package/modules/hosts/trae/hooks/pre-shell-check.cjs +0 -192
  700. package/modules/hosts/trae/hooks/resolve-shell.cjs +0 -30
  701. package/modules/hosts/trae/hooks.json +0 -29
  702. package/modules/hosts/trae/rules/beautify-input-chinese.md +0 -6
  703. package/modules/hosts/trae/rules/git-commit-message.md +0 -10
  704. package/modules/hosts/trae/rules/project-workflow.md +0 -14
  705. package/modules/hosts/zcode/agents/implementer.md +0 -51
  706. package/modules/hosts/zcode/agents/independent-reviewer.md +0 -49
  707. package/modules/hosts/zcode/agents/ui-verifier.md +0 -48
  708. package/src/add-gate.mjs +0 -116
  709. package/src/add-gate.test.mjs +0 -103
  710. package/src/add-host.mjs +0 -68
  711. package/src/cli.mjs +0 -169
  712. package/src/doctor.mjs +0 -629
  713. package/src/executor.mjs +0 -262
  714. package/src/executor.test.mjs +0 -295
  715. package/src/fresh-init.test.mjs +0 -64
  716. package/src/gate-dotnet-ca.test.mjs +0 -124
  717. package/src/gates.test.mjs +0 -143
  718. package/src/init.mjs +0 -382
  719. package/src/init.test.mjs +0 -163
  720. package/src/instance-ref.test.mjs +0 -62
  721. package/src/jscpd-drift.test.mjs +0 -145
  722. package/src/pack.test.mjs +0 -24
  723. package/src/profiles.mjs +0 -183
  724. package/src/render.mjs +0 -132
  725. package/src/rule-budget.test.mjs +0 -103
  726. package/src/run-tests.mjs +0 -56
  727. package/src/stack-profile.test.mjs +0 -95
  728. package/src/sync-hosts.mjs +0 -257
  729. package/src/sync-hosts.test.mjs +0 -291
  730. package/src/sync.mjs +0 -228
  731. package/src/sync.test.mjs +0 -452
  732. package/src/trae-hooks.test.mjs +0 -127
  733. package/src/validate.mjs +0 -77
  734. package/src/validate.test.mjs +0 -95
  735. package/templates/.gitattributes +0 -17
  736. package/templates/AGENTS.md +0 -58
  737. package/templates/_agents/board/index.html +0 -676
  738. package/templates/_agents/commands/build.md +0 -84
  739. package/templates/_agents/commands/deploy.md +0 -66
  740. package/templates/_agents/commands/design.md +0 -63
  741. package/templates/_agents/commands/gate-checklist.md +0 -91
  742. package/templates/_agents/commands/maintain.md +0 -90
  743. package/templates/_agents/commands/new-task.md +0 -110
  744. package/templates/_agents/commands/pipeline-run.md +0 -43
  745. package/templates/_agents/commands/plan.md +0 -48
  746. package/templates/_agents/commands/review.md +0 -62
  747. package/templates/_agents/commands/sync-hosts.md +0 -77
  748. package/templates/_agents/commands/test.md +0 -87
  749. package/templates/_agents/control-surfaces.txt +0 -53
  750. package/templates/_agents/engine-lock.json +0 -342
  751. package/templates/_agents/hooks/check-index-incremental.mjs +0 -48
  752. package/templates/_agents/hooks/check-pairing-incremental.mjs +0 -66
  753. package/templates/_agents/hooks/check-wiki-ledger.mjs +0 -30
  754. package/templates/_agents/hooks/commit-check.cjs +0 -193
  755. package/templates/_agents/hooks/local-pre-commit +0 -6
  756. package/templates/_agents/lane-surfaces.txt +0 -17
  757. package/templates/_agents/level-hints.txt +0 -30
  758. package/templates/_agents/loop/papercut-debt/DESIGN.md +0 -112
  759. package/templates/_agents/mechanism-registry.md +0 -35
  760. package/templates/_agents/metric-claims.txt +0 -81
  761. package/templates/_agents/notes/engine-internals.md +0 -17
  762. package/templates/_agents/notes/runtime-env.md +0 -18
  763. package/templates/_agents/roles/implementer.md +0 -47
  764. package/templates/_agents/roles/independent-reviewer.md +0 -45
  765. package/templates/_agents/roles/ui-verifier.md +0 -44
  766. package/templates/_agents/rule-budgets.txt +0 -20
  767. package/templates/_agents/scripts/agg-delegations.cjs +0 -302
  768. package/templates/_agents/scripts/agg-delegations.test.mjs +0 -282
  769. package/templates/_agents/scripts/agg-gate-stats.mjs +0 -113
  770. package/templates/_agents/scripts/agg-gate-stats.test.mjs +0 -95
  771. package/templates/_agents/scripts/agg-judgments.mjs +0 -156
  772. package/templates/_agents/scripts/agg-judgments.test.mjs +0 -93
  773. package/templates/_agents/scripts/archive-sweep.mjs +0 -235
  774. package/templates/_agents/scripts/archive-sweep.test.mjs +0 -129
  775. package/templates/_agents/scripts/check-attribution.mjs +0 -37
  776. package/templates/_agents/scripts/check-convergence.mjs +0 -124
  777. package/templates/_agents/scripts/check-engine-integrity.mjs +0 -220
  778. package/templates/_agents/scripts/check-engine-integrity.test.mjs +0 -215
  779. package/templates/_agents/scripts/check-funnel.mjs +0 -56
  780. package/templates/_agents/scripts/check-hygiene.mjs +0 -167
  781. package/templates/_agents/scripts/check-hygiene.test.mjs +0 -182
  782. package/templates/_agents/scripts/check-index-incremental.test.mjs +0 -73
  783. package/templates/_agents/scripts/check-lane-surface.mjs +0 -238
  784. package/templates/_agents/scripts/check-lane-surface.test.mjs +0 -302
  785. package/templates/_agents/scripts/check-ledger-invariant.mjs +0 -586
  786. package/templates/_agents/scripts/check-ledger-invariant.test.mjs +0 -639
  787. package/templates/_agents/scripts/check-loop-rev.test.mjs +0 -336
  788. package/templates/_agents/scripts/check-loop-unit.test.mjs +0 -103
  789. package/templates/_agents/scripts/check-loop.mjs +0 -1987
  790. package/templates/_agents/scripts/check-loop.sh +0 -6
  791. package/templates/_agents/scripts/check-loop.test.mjs +0 -3912
  792. package/templates/_agents/scripts/check-metric-claims.mjs +0 -277
  793. package/templates/_agents/scripts/check-prejudgment.mjs +0 -64
  794. package/templates/_agents/scripts/check-registry.mjs +0 -45
  795. package/templates/_agents/scripts/check-scope.mjs +0 -96
  796. package/templates/_agents/scripts/check-scope.test.mjs +0 -99
  797. package/templates/_agents/scripts/check-scripts-syntax.mjs +0 -84
  798. package/templates/_agents/scripts/check-scripts-syntax.test.mjs +0 -72
  799. package/templates/_agents/scripts/check-spec-verif.mjs +0 -47
  800. package/templates/_agents/scripts/check-stage-index.mjs +0 -40
  801. package/templates/_agents/scripts/check-stage-index.test.mjs +0 -77
  802. package/templates/_agents/scripts/closeout-l1.mjs +0 -217
  803. package/templates/_agents/scripts/closeout-l1.test.mjs +0 -105
  804. package/templates/_agents/scripts/commit-check-trigger.test.mjs +0 -205
  805. package/templates/_agents/scripts/compact-ledgers.mjs +0 -97
  806. package/templates/_agents/scripts/compact-ledgers.test.mjs +0 -162
  807. package/templates/_agents/scripts/confirm-doc.mjs +0 -610
  808. package/templates/_agents/scripts/confirm-doc.test.mjs +0 -1119
  809. package/templates/_agents/scripts/doctor.test.mjs +0 -770
  810. package/templates/_agents/scripts/draft-sediment.mjs +0 -178
  811. package/templates/_agents/scripts/draft-sediment.test.mjs +0 -272
  812. package/templates/_agents/scripts/edit-face-check.mjs +0 -109
  813. package/templates/_agents/scripts/edit-face-check.test.mjs +0 -99
  814. package/templates/_agents/scripts/ensure-board.mjs +0 -185
  815. package/templates/_agents/scripts/fill-intent.mjs +0 -91
  816. package/templates/_agents/scripts/fill-intent.test.mjs +0 -113
  817. package/templates/_agents/scripts/fill-plan.mjs +0 -79
  818. package/templates/_agents/scripts/fill-plan.test.mjs +0 -224
  819. package/templates/_agents/scripts/fill-spec.mjs +0 -70
  820. package/templates/_agents/scripts/fill-spec.test.mjs +0 -266
  821. package/templates/_agents/scripts/fixture-scripts.mjs +0 -153
  822. package/templates/_agents/scripts/fixture-scripts.test.mjs +0 -112
  823. package/templates/_agents/scripts/gate-checklist.mjs +0 -209
  824. package/templates/_agents/scripts/gate-checklist.test.mjs +0 -201
  825. package/templates/_agents/scripts/gate-seg.mjs +0 -54
  826. package/templates/_agents/scripts/gate-seg.test.mjs +0 -112
  827. package/templates/_agents/scripts/gen-effective-policy.mjs +0 -107
  828. package/templates/_agents/scripts/gen-effective-policy.test.mjs +0 -100
  829. package/templates/_agents/scripts/gen-verify-evidence.mjs +0 -107
  830. package/templates/_agents/scripts/gen-verify-evidence.test.mjs +0 -84
  831. package/templates/_agents/scripts/gen-wiki-board.mjs +0 -276
  832. package/templates/_agents/scripts/gen-wiki-board.test.mjs +0 -249
  833. package/templates/_agents/scripts/gen-workflow-dashboard.mjs +0 -251
  834. package/templates/_agents/scripts/gen-workflow-dashboard.test.mjs +0 -188
  835. package/templates/_agents/scripts/gen-workflow-index.mjs +0 -201
  836. package/templates/_agents/scripts/gen-workflow-index.test.mjs +0 -152
  837. package/templates/_agents/scripts/gen-workflow-metrics.mjs +0 -466
  838. package/templates/_agents/scripts/gen-workflow-metrics.test.mjs +0 -343
  839. package/templates/_agents/scripts/git-merge-jsonl.mjs +0 -63
  840. package/templates/_agents/scripts/git-merge-jsonl.test.mjs +0 -125
  841. package/templates/_agents/scripts/judgment-ledger.mjs +0 -65
  842. package/templates/_agents/scripts/judgment-ledger.test.mjs +0 -129
  843. package/templates/_agents/scripts/kb-cache-evict.mjs +0 -50
  844. package/templates/_agents/scripts/kb-cache-evict.test.mjs +0 -104
  845. package/templates/_agents/scripts/kb-search.mjs +0 -413
  846. package/templates/_agents/scripts/kb-search.test.mjs +0 -299
  847. package/templates/_agents/scripts/lane-surface-audit.mjs +0 -143
  848. package/templates/_agents/scripts/lane-surface-audit.test.mjs +0 -93
  849. package/templates/_agents/scripts/ledger-doc-chain.test.mjs +0 -166
  850. package/templates/_agents/scripts/ledger-loader.mjs +0 -108
  851. package/templates/_agents/scripts/ledger-loader.test.mjs +0 -131
  852. package/templates/_agents/scripts/ledger-prune.mjs +0 -96
  853. package/templates/_agents/scripts/ledger-prune.test.mjs +0 -120
  854. package/templates/_agents/scripts/ledger-shards.mjs +0 -344
  855. package/templates/_agents/scripts/ledger-shards.test.mjs +0 -356
  856. package/templates/_agents/scripts/ledger-ts-monotonic.test.mjs +0 -135
  857. package/templates/_agents/scripts/level-criteria.mjs +0 -231
  858. package/templates/_agents/scripts/level-criteria.test.mjs +0 -281
  859. package/templates/_agents/scripts/mechanism-retire-watch.mjs +0 -183
  860. package/templates/_agents/scripts/mechanism-retire-watch.test.mjs +0 -114
  861. package/templates/_agents/scripts/papercut-debt-controller.mjs +0 -141
  862. package/templates/_agents/scripts/papercut-debt-controller.test.mjs +0 -127
  863. package/templates/_agents/scripts/papercut-debt-sensor.mjs +0 -170
  864. package/templates/_agents/scripts/papercut-debt-sensor.test.mjs +0 -146
  865. package/templates/_agents/scripts/pipeline-run-docs.mjs +0 -76
  866. package/templates/_agents/scripts/pipeline-run-run.mjs +0 -63
  867. package/templates/_agents/scripts/pipeline-run.mjs +0 -867
  868. package/templates/_agents/scripts/pipeline-run.test.mjs +0 -517
  869. package/templates/_agents/scripts/policy.mjs +0 -281
  870. package/templates/_agents/scripts/pre-push.test.mjs +0 -105
  871. package/templates/_agents/scripts/resolve-merge-conflicts.mjs +0 -110
  872. package/templates/_agents/scripts/resolve-merge-conflicts.test.mjs +0 -87
  873. package/templates/_agents/scripts/rewrite-file.mjs +0 -133
  874. package/templates/_agents/scripts/rewrite-file.test.mjs +0 -148
  875. package/templates/_agents/scripts/rule-budget.mjs +0 -96
  876. package/templates/_agents/scripts/rule-budget.test.mjs +0 -118
  877. package/templates/_agents/scripts/run-tests.mjs +0 -99
  878. package/templates/_agents/scripts/run-tests.test.mjs +0 -105
  879. package/templates/_agents/scripts/solidify-task.mjs +0 -109
  880. package/templates/_agents/scripts/solidify-task.test.mjs +0 -129
  881. package/templates/_agents/scripts/stage-gates.mjs +0 -343
  882. package/templates/_agents/scripts/stage-gates.test.mjs +0 -105
  883. package/templates/_agents/scripts/trust-mode.mjs +0 -67
  884. package/templates/_agents/scripts/trust-mode.test.mjs +0 -110
  885. package/templates/_agents/scripts/verify-wiki-consistency.mjs +0 -253
  886. package/templates/_agents/scripts/verify-wiki-consistency.test.mjs +0 -123
  887. package/templates/_agents/scripts/verify.mjs +0 -345
  888. package/templates/_agents/scripts/verify.test.mjs +0 -373
  889. package/templates/_agents/scripts/wf-journal.mjs +0 -231
  890. package/templates/_agents/scripts/wf-journal.test.mjs +0 -216
  891. package/templates/_agents/scripts/wiki-search.mjs +0 -19
  892. package/templates/_agents/scripts/wiki-search.test.mjs +0 -57
  893. package/templates/_agents/scripts/workflow-board-server.mjs +0 -393
  894. package/templates/_agents/scripts/workflow-board-server.test.mjs +0 -201
  895. package/templates/_agents/scripts/workflow-enums.mjs +0 -70
  896. package/templates/_agents/scripts/workflow-enums.test.mjs +0 -118
  897. package/templates/_agents/scripts/workflows-check.mjs +0 -260
  898. package/templates/_agents/scripts/workflows-check.test.mjs +0 -278
  899. package/templates/_agents/scripts-test-exempt.txt +0 -16
  900. package/templates/_agents/skills/papercut-fix/SKILL.md +0 -60
  901. package/templates/_agents/skills/papercut-fix/references/response-template.md +0 -81
  902. package/templates/_agents/skills/review-method/SKILL.md +0 -58
  903. package/templates/_agents/skills/verify-ui/SKILL.md +0 -61
  904. package/templates/_agents/skills/wiki/SKILL.md +0 -106
  905. package/templates/_agents/workflow-enums.txt +0 -26
  906. package/templates/_agents/workflow-modules.txt +0 -11
  907. package/templates/_agents/workflows/_TEMPLATE.md +0 -75
  908. package/templates/_agents/workflows/pipeline-closing.md +0 -28
  909. package/templates/_agents/workflows//347/244/272/344/276/213-/345/271/266/350/241/214/345/256/236/347/216/260/350/257/204/345/256/241.md +0 -16
  910. package/templates/_githooks/commit-msg +0 -17
  911. package/templates/_githooks/post-commit +0 -10
  912. package/templates/_githooks/pre-commit +0 -126
  913. package/templates/_githooks/pre-merge-commit +0 -29
  914. package/templates/_githooks/pre-push +0 -136
  915. package/templates/_github/workflows/kit-ci.yml +0 -49
  916. package/templates/wiki/INDEX.md +0 -73
  917. package/templates/wiki/drafts-archive/README.md +0 -3
  918. package/templates/wiki//344/272/247/345/223/201/351/234/200/346/261/202/README.md +0 -3
  919. package/templates/wiki//345/274/200/345/217/221/346/226/271/346/241/210/README.md +0 -3
  920. package/templates/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md +0 -3
  921. package/templates/wiki//346/265/213/350/257/225/346/212/245/345/221/212/README.md +0 -3
  922. package/templates/wiki//347/224/250/346/210/267/345/212/237/350/203/275/README.md +0 -3
  923. package/templates/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html +0 -77
  924. package/templates/wiki//351/241/271/347/233/256/350/247/204/350/214/203/README.md +0 -3
  925. package/templates/wiki//351/241/271/347/233/256/350/256/241/345/210/222/README.md +0 -3
  926. package/templates/workflow/README.md +0 -91
  927. package/templates/workflow/delegations.md +0 -29
  928. package/templates/workflow/incidents/_TEMPLATE.md +0 -51
  929. package/templates/workflow/intents/_TEMPLATE.md +0 -51
  930. package/templates/workflow/papercuts.md +0 -9
  931. package/templates/workflow/plans/_TEMPLATE.md +0 -47
  932. package/templates/workflow/regression-checklist.md +0 -23
  933. package/templates/workflow/specs/_TEMPLATE.md +0 -80
  934. /package/templates/{_agents → engine/.agents}/board/marked.min.js +0 -0
  935. /package/templates/{_agents/workflows → engine/.agents/pipelines}/steps//347/244/272/344/276/213-/351/203/250/347/275/262/351/252/214/350/257/201.md" +0 -0
  936. /package/templates/{_agents → engine/.agents}/scripts/git-core.mjs +0 -0
@@ -0,0 +1,22 @@
1
+ # 数据维护台账
2
+
3
+ 本目录登记全项目数据维护 SQL 与执行状态,按阶段分类:
4
+
5
+ | 目录 | 用途 |
6
+ |---|---|
7
+ | `schema变更/` | 表结构变更(DDL),每个批次一个 `日期-主题/` 子目录 |
8
+ | `数据修复/` | 存量数据修复(DML),须写明影响行数与回滚口径 |
9
+ | `数据导入/` | 外部数据导入脚本与映射说明 |
10
+ | `查询/` | 只读排查 SQL |
11
+ | `备份/` | 备份与恢复脚本 |
12
+
13
+ ## 硬约束
14
+
15
+ - 新增 SQL 必须登记执行状态与授权来源。
16
+ - 禁止无 `WHERE` 的全表 `DELETE` / `UPDATE`。
17
+ - 执行生产 SQL 属不可逆操作,须用户明确授权,且按项目数据维护台账与 DB 验证口径走。
18
+ - 脚本与台账示例见 `_TEMPLATE.md`(若存在)。
19
+
20
+ ## 生成物
21
+
22
+ `README.md` 由本目录协议维护;具体批次清单以子目录与 git 历史为准。
@@ -0,0 +1,230 @@
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <title>知识沉淀总览 · {{projectName}}</title>
6
+ <style>
7
+ :root {
8
+ --bg: #f7f8fb;
9
+ --card: #ffffff;
10
+ --border: #e6e8ee;
11
+ --text: #1f2937;
12
+ --muted: #6b7280;
13
+ --accent: #2563eb;
14
+ --accent-soft: #eff4ff;
15
+ --warn: #d97706;
16
+ --shadow: 0 1px 2px rgba(0,0,0,.04), 0 4px 16px rgba(0,0,0,.04);
17
+ }
18
+ * { box-sizing: border-box; }
19
+ body {
20
+ margin: 0;
21
+ font-family: -apple-system, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
22
+ background: var(--bg);
23
+ color: var(--text);
24
+ line-height: 1.5;
25
+ }
26
+ header {
27
+ padding: 32px 40px 16px;
28
+ background: linear-gradient(135deg, #1e3a8a 0%, #2563eb 100%);
29
+ color: #fff;
30
+ }
31
+ header h1 { margin: 0 0 4px; font-size: 24px; font-weight: 600; }
32
+ header .meta { opacity: .85; font-size: 13px; }
33
+ main { max-width: 1400px; margin: 0 auto; padding: 24px 40px 64px; }
34
+ .summary {
35
+ display: grid;
36
+ grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
37
+ gap: 12px;
38
+ margin-bottom: 24px;
39
+ }
40
+ .stat {
41
+ background: var(--card);
42
+ border: 1px solid var(--border);
43
+ border-radius: 10px;
44
+ padding: 14px 16px;
45
+ box-shadow: var(--shadow);
46
+ }
47
+ .stat .num { font-size: 22px; font-weight: 600; color: var(--accent); }
48
+ .stat .lbl { font-size: 12px; color: var(--muted); margin-top: 2px; }
49
+ .toolbar {
50
+ display: flex;
51
+ gap: 8px;
52
+ margin-bottom: 12px;
53
+ flex-wrap: wrap;
54
+ align-items: center;
55
+ }
56
+ .toolbar input {
57
+ flex: 1 1 280px;
58
+ max-width: 480px;
59
+ padding: 8px 12px;
60
+ border: 1px solid var(--border);
61
+ border-radius: 8px;
62
+ font-size: 13px;
63
+ background: var(--card);
64
+ }
65
+ .toolbar select {
66
+ padding: 8px 12px;
67
+ border: 1px solid var(--border);
68
+ border-radius: 8px;
69
+ font-size: 13px;
70
+ background: var(--card);
71
+ }
72
+ .topic-section {
73
+ background: var(--card);
74
+ border: 1px solid var(--border);
75
+ border-radius: 12px;
76
+ margin-bottom: 16px;
77
+ overflow: hidden;
78
+ box-shadow: var(--shadow);
79
+ }
80
+ .topic-header {
81
+ padding: 12px 16px;
82
+ background: var(--accent-soft);
83
+ display: flex;
84
+ align-items: center;
85
+ justify-content: space-between;
86
+ cursor: pointer;
87
+ user-select: none;
88
+ }
89
+ .topic-header:hover { background: #e0ebff; }
90
+ .topic-header .name { font-weight: 600; color: var(--accent); font-size: 15px; }
91
+ .topic-header .count {
92
+ background: var(--accent);
93
+ color: #fff;
94
+ border-radius: 12px;
95
+ padding: 2px 10px;
96
+ font-size: 12px;
97
+ font-weight: 500;
98
+ }
99
+ table {
100
+ width: 100%;
101
+ border-collapse: collapse;
102
+ font-size: 13px;
103
+ }
104
+ thead th {
105
+ text-align: left;
106
+ padding: 10px 16px;
107
+ background: #fafbfd;
108
+ border-bottom: 1px solid var(--border);
109
+ color: var(--muted);
110
+ font-weight: 500;
111
+ font-size: 12px;
112
+ text-transform: uppercase;
113
+ letter-spacing: .04em;
114
+ }
115
+ tbody td {
116
+ padding: 8px 16px;
117
+ border-bottom: 1px solid #f0f2f5;
118
+ vertical-align: top;
119
+ }
120
+ tbody tr:last-child td { border-bottom: none; }
121
+ tbody tr:hover { background: #fafbff; }
122
+ td.file { font-family: "SF Mono", Consolas, monospace; font-size: 12.5px; color: #111827; }
123
+ td.file a { color: var(--accent); text-decoration: none; }
124
+ td.file a:hover { text-decoration: underline; }
125
+ td.topic-cell { color: var(--muted); }
126
+ td.dir a {
127
+ color: var(--accent);
128
+ text-decoration: none;
129
+ font-family: "SF Mono", Consolas, monospace;
130
+ font-size: 12px;
131
+ }
132
+ td.dir a:hover { text-decoration: underline; }
133
+ footer { padding: 24px 40px; color: var(--muted); font-size: 12px; text-align: center; }
134
+ </style>
135
+ </head>
136
+ <body>
137
+ <header>
138
+ <h1>知识沉淀总览</h1>
139
+ <div class="meta">{{projectName}} · 项目知识沉淀</div>
140
+ </header>
141
+
142
+ <main>
143
+ <div class="summary" id="summary"></div>
144
+
145
+ <div class="toolbar">
146
+ <input type="text" id="search" placeholder="🔍 搜索文件名 / 主题 / 归属目录…" />
147
+ <select id="topicFilter">
148
+ <option value="">全部主题</option>
149
+ </select>
150
+ </div>
151
+
152
+ <div id="topics"></div>
153
+ </main>
154
+
155
+ <footer>看板由 wiki 技能生成 · 原始数据见 wiki/INDEX.md</footer>
156
+
157
+ <script>
158
+ const DATA = {
159
+ "summary": { "total": 0, "topics": 0, "files": 0, "archive": 0 },
160
+ "topics": []
161
+ };
162
+
163
+ // 顶部统计卡片
164
+ document.getElementById('summary').innerHTML = `
165
+ <div class="stat"><div class="num">${DATA.summary.topics}</div><div class="lbl">主题数</div></div>
166
+ <div class="stat"><div class="num">${DATA.summary.files}</div><div class="lbl">知识文档</div></div>
167
+ <div class="stat"><div class="num">${DATA.summary.archive}</div><div class="lbl">草稿归档</div></div>
168
+ <div class="stat"><div class="num">${DATA.topics.reduce((s,t)=>s+t.files.length,0)}</div><div class="lbl">合计记录</div></div>
169
+ `;
170
+
171
+ // 主题过滤器
172
+ const sel = document.getElementById('topicFilter');
173
+ DATA.topics.forEach(t => {
174
+ const o = document.createElement('option');
175
+ o.value = t.name; o.textContent = `${t.name} (${t.files.length})`;
176
+ sel.appendChild(o);
177
+ });
178
+
179
+ function escapeHtml(s){ return String(s).replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c])); }
180
+
181
+ function render(filterText='', topicFilter='') {
182
+ const container = document.getElementById('topics');
183
+ container.innerHTML = '';
184
+ DATA.topics
185
+ .filter(t => !topicFilter || t.name === topicFilter)
186
+ .forEach(t => {
187
+ const rows = t.files.filter(f =>
188
+ !filterText ||
189
+ f.file.toLowerCase().includes(filterText.toLowerCase()) ||
190
+ f.topic.toLowerCase().includes(filterText.toLowerCase()) ||
191
+ f.dir.toLowerCase().includes(filterText.toLowerCase())
192
+ );
193
+ if (rows.length === 0) return;
194
+ const section = document.createElement('div');
195
+ section.className = 'topic-section';
196
+ section.innerHTML = `
197
+ <div class="topic-header">
198
+ <span class="name">📁 ${escapeHtml(t.name)}</span>
199
+ <span class="count">${rows.length}</span>
200
+ </div>
201
+ <table>
202
+ <thead><tr><th style="width:40%">文件名</th><th style="width:20%">主题</th><th>归属目录</th></tr></thead>
203
+ <tbody>
204
+ ${rows.map(f => {
205
+ const base = f.file.split('/').pop();
206
+ const fileCell = /\.(html)$/i.test(f.file)
207
+ ? `<td class="file"><a href="${escapeHtml(f.dir + base)}" target="_blank" title="打开文档">${escapeHtml(f.file)}</a></td>`
208
+ : `<td class="file">${escapeHtml(f.file)}</td>`;
209
+ return `
210
+ <tr>
211
+ ${fileCell}
212
+ <td class="topic-cell">${escapeHtml(f.topic)}</td>
213
+ <td class="dir"><a href="${escapeHtml(f.dir)}" title="打开目录">${escapeHtml(f.dir)}</a></td>
214
+ </tr>`;
215
+ }).join('')}
216
+ </tbody>
217
+ </table>`;
218
+ container.appendChild(section);
219
+ });
220
+ if (!container.innerHTML) {
221
+ container.innerHTML = '<div class="topic-section" style="padding:24px;text-align:center;color:var(--muted)">无匹配记录</div>';
222
+ }
223
+ }
224
+
225
+ document.getElementById('search').addEventListener('input', e => render(e.target.value, sel.value));
226
+ sel.addEventListener('change', e => render(document.getElementById('search').value, e.target.value));
227
+ render();
228
+ </script>
229
+ </body>
230
+ </html>
@@ -0,0 +1,13 @@
1
+ # workflow 索引(生成物,勿手改)
2
+
3
+ > 由 `node .agents/scripts/gen-workflow-index.mjs` 从 `workflow/{intents,specs,plans,incidents}/` 重生成。
4
+ > 本文件为新装户占位;首次生成后自动填充活跃层与档案表。
5
+
6
+ ## 活跃(0)
7
+
8
+ | 类型 | 级别 | 状态 | 日期 | 模块 | 主题 | 进度 |
9
+ |---|---|---|---|---|---|---|
10
+
11
+ ## 档案(只读,不增量)
12
+
13
+ (历史终态件归档后由生成器列出。)
@@ -0,0 +1,67 @@
1
+ # workflow — AI 驱动闭环流程(唯一真相源)
2
+
3
+ 本目录是 AI 工作流引擎的唯一载体。L1 新需求以一份 plan 为入口;L2/L3 新需求走 intent → spec → plan;修复走 incident。微观任务层采用「任务责任人(Task Owner)+ AI 结对闭环」,确认在对话内一句话完成(TTY / 委托代录);宏观主干层支持多人协作协同,主干(main)合并由 TFS PR 分支策略(Peer Review 团队评审 + 与本地脚本同源的 Azure Pipelines CI 门禁)把关,追溯靠 git(commit + PR 记录 + release tag)。
4
+
5
+ > 闭环新增记录一律写在本目录。
6
+
7
+ ## 目录结构
8
+
9
+ | 目录 | 放什么 | 命名 |
10
+ |------|--------|------|
11
+ | `intents/` | L2/L3 新需求入口:背景、目标/非目标、验收标准、级别、触达红线。L1 新需求不建 | `YYYY-MM-DD-<主题>.md` |
12
+ | `specs/` | L2/L3 设计规格:功能行为、数据流、系统改动、约束遵守映射。L1 不建 | 与 intent / incident 同名 |
13
+ | `plans/` | L1 新需求入口(来源 / 目标 / 红线 / 改动方案 / 约束与风险 / 验证计划 / 验收标准)。L2/L3 与修复仍与 intent / incident 同名 | `YYYY-MM-DD-<主题>.md` |
14
+ | `incidents/` | 事故复盘:时间线、根因、为什么没拦住、复盘三件套 | `YYYY-MM-DD-<主题>.md` |
15
+
16
+ **命名一律英文 kebab-case**(如 `2026-09-07-supplier-rating-field.md`),**禁中文文件名**——原 check-loop §9 非 ASCII 文件名 warning 已随 2026-10-28 引擎减重退役,命名约定不变。文档内容(标题/正文)不受此限。
17
+
18
+ **文档协议(2026-09-13 结构化)**:四类文档头部一律为 YAML frontmatter(受限子集,每行 `键: 值`,附 check-loop 机器字段唯一来源)——`状态`(intent/spec/plan:draft/approved/done/superseded/cancelled;incident:open/fixed/closed,**严格枚举**,附注写 `备注:` 键)、`级别`(L1/L2/L3)、`日期`/`发现`(YYYY-MM-DD)、`模块`(**2026-09-22 起新建文档必填**,取值见 `.agents/config/workflow-modules.txt` 词表,单值取主导模块;存量不回填,AI 触碰时顺手补)、L3 spec 的 `确认结果`/`确认时间`、回填件 `流程: legacy`。**`日期` 兜底口径(2026-10-27 修)**:plan 由 `fill-plan.mjs` 与 `plans/_TEMPLATE.md` 生成,**2026-10-27 起 frontmatter 写入 `日期`**(此前 renderPlan 收了 date 参数却不落盘)——凡以 frontmatter `日期` 为适用前提的门(委派台账在场门;检查 18 已随 2026-10-28 引擎减重退役),日期缺省时仍**回落文件名前缀** `YYYY-MM-DD` 作为第二道保险(沿检查 15 既有口径;检查 19 已退役);frontmatter 与文件名皆无日期 → 不可判定 → 跳过。旧口径「无日期即整段跳过」曾使委派门对绝大多数 L2/L3 plan 静默失效(实测 52 份锚后 L2/L3 终态件从未被对账)。**`状态` 迁移须经 `approved`**(确认环节的机器可见态,`done` 只在关单出现):2026-09-23 起新建的 spec/plan 若已 done 而 git 历史中从未出现行首 `状态: approved`,check-loop 报「确认态缺失」warning。check-loop 只扫 frontmatter 取机器字段(`fm_get` 字段断言),正文不再写「状态:/级别:」行;叙述性字段(独立复核/复盘三件套/验收勾验)仍留正文按节锚定。协议变更与存量迁移见 2026-09-13 `docs(workflow)` 提交。**模糊点显式阻断(2026-10-16,NEEDS-CLARIFICATION 标记)**:spec/plan 起草或修订遇无法自行决策的模糊点(多种解释 / 口径缺失 / 依赖外部事实)**禁止脑补**——原地插入 `[NEEDS CLARIFICATION]: <一句话问题>` 向用户求澄清,澄清后删除标记并把决策落为正文;状态推进 approved 前标记须清零(自检纪律;活跃件 grep 该标记即待澄清清单。跨产物断层自动体检延后——与「暂缓加门」取舍的冲突已显式登记,D6 度量补齐后再议)。**承诺面绑定(2026-10-27 新增)**:用户在 approved 那一刻点头的是**承诺面**(判据文本 / 红线 / 目标 / 改动方案 / 约束与风险)——承诺在确认后被改写而未重新点头 = 用户点头的不是关单时兑现的那一份。关单期合法动作(勾验收 + 证据回填、`确认结果`/`确认时间` 回填、复核行改锚)**不改承诺面**,经归一后不误伤;承诺判据被改写则 hard 拦(检查 15)+ 关单时刻拒收(confirm-doc 承诺面绑定门)。改承诺的**唯一出路** = 用户重新点头后跑 `confirm-doc <doc> --reconfirm --delegated "<原话>"` 重录承诺面指纹(不推进状态,状态行仍由 confirm-doc 写,不手改 frontmatter);存量(上线前确认、台账行无 `commit` 字段)不追溯。**改已关单正文须同笔重录指纹(2026-11-10,incident 2026-10-26-workflow-confirmation-drift-hard-block)**:改已关单(done/superseded/closed/cancelled/fixed)文档正文 = 须同笔重录确认指纹(`confirm-doc` / `--reconfirm`)或走补偿行(`append-compensation.mjs`),否则 check-loop 判「确认内容漂移」;提交期有 `check-doc-body-drift.mjs` advisory 可见性(不合门)。
19
+
20
+ 各子目录内 `_TEMPLATE.md` 为起步模板,复制后填写,不直接改动模板本身。
21
+
22
+ 根目录 `regression-checklist.md` 为**活文档回归清单**:deploy 回归必过条目与 incident 防复发验证的统一落点,随模块上线补充、随 incident 追加。
23
+
24
+ **三份 append-only 台账已分片**(2026-10-13 ledger-shard-ledgers):`regression-checklist` / `delegations` / `papercuts` 的数据行按月存 `workflow/<台账>.d/<YYYY-MM>.md`,主台账只留说明、表头与 GENERATED 区——消除「每次追加全量重写整文件」的体积与合并冲突面。读写单源 = `.agents/scripts/ledger-shards.mjs`(读侧自动合并主台账 ∪ 全部分片,既有消费者无需改动);追加一行用 `node .agents/scripts/ledger-shards.mjs --append <台账> --row "<行>"`。(第四份 `deploy-observations` 已随 deploy 仪式退役删除——2026-10-29 owner 拍板:实际发布不走 tag/24h 观察仪式,合入 = PR 创建→审查→回归→合并→归档,见 `deploy.md` 头注。)confirmations.d 分片始于 2026-10,2026-09 无分片(该月确认仅 git 口径可溯,历史缺口不回补);jsonl 各台账 schema 代际以字段有无自描述(如 quoteGrounding 自 2026-10-24 起),不设版本字段(2026-11-05 决策)。
25
+
26
+ **门禁判定月度分片**(2026-10-22 gate-metrics-shard):`workflow/gate-metrics.d/<YYYY-MM>.jsonl` 每月一行(规则 × WARN/BLOCK),由 `node .agents/scripts/agg-judgments.mjs --emit-month` 生成、随提交入库;pre-push 月检自动补生成上月分片。退役判据(连续 N 月 = 0)读「本地 `.agents/judgments.jsonl` ∪ 分片」取 max——换机/换 worktree 不再归零,多机并集(`.gitattributes` 复用 `jsonl-union`)。
27
+
28
+ ## 使用方式
29
+
30
+ - **发起新任务**:执行 `.agents/commands/new-task.md`(定级 + L0 极简道 / L1 快速道总入口);L2/L3 进 `.agents/commands/stages.md` 四章(Plan → Design → Build → Test,2026-11-08 档 2-F 四并一)
31
+ - **看板(可选,默认不拉起)**:需要时手动跑 `node .agents/scripts/ensure-board.mjs`(幂等:探活 / 旧代码自动重启 / 全新启动弹浏览器),实时只读 http://127.0.0.1:8933;**预警层,非门禁;告警口径对齐 check-loop 硬断档**。「旧代码」=`board/index.html` 或 `workflow-board-server.mjs` 的 LastWriteTime 晚于看板进程启动 2s(任一更新即重启);端口被占用时先探活 `/api/board`——响应不含 `cards` 即判为他人进程,不动手不 kill、跳过试下一端口
32
+ - **检索**:活跃流程读 `INDEX.md`(生成物,`node .agents/scripts/gen-workflow-index.mjs` 重生成、`--check` 校验漂移);跨语料检索 `node .agents/scripts/kb-search.mjs "<词>"`(workflow 按节级定位 + wiki 全文,`--type/--module/--status/-n` 过滤;`--status all` 显式全量)
33
+ - **归档**:关单即归档(2026-10-13 archive-on-close)——`confirm-doc.mjs` 落终态后自动把**本次确认涉及的家族**(同名 intent/spec/plan/incident 整族)`git mv` 进 `workflow/archive/<终态月>/{类型}/`,活跃目录不再累积终态件。**特性分支默认不归档**(2026-10-15 起,防 CI 泳道门拦合法合并)——合并后由 main/develop 关单或 sweep 承接,未满 21 天窗的滞留属正常态。历史积压用 `node .agents/scripts/archive-sweep.mjs [--window 21] [--execute]`(缺省 dry-run)手工批次清理;归档件仍可被 `kb-search` 检索(`archive/<批次>/<type>` 已覆盖),check-loop 配对门与内容绑定只扫四目录直下、对归档件不触发。终态件积压时人工月度跑一轮 archive-sweep(dry-run 先看候选,`--execute` 执行)。
34
+ - **spec 生命周期口径(2026-10-16 owner 拍板,Böckeler 三层分类取 spec-anchored + 长期维护)**:spec 是**持续对照的事实源,交付后不失效**——代码改动触及某 spec 覆盖的行为时须对照该 spec(含归档件):行为漂移要么改代码回到 spec,要么同一提交回改 spec;有争议立 incident 裁决。**归档是容量治理不是失效**:归档只把终态件移出活跃扫描面(INDEX 活跃行 / check-loop 四目录扫描 / 月度再生),事实源地位与修订权不变——归档 spec 可原地修订,修订不改归档位置。体积治理先观察后设限:spec 行数/验收条数分布由 metrics.md 观察列采集(advisory 上限与「暂缓加门」取舍冲突,显式延后至 D6 度量补齐后再议)。
35
+ - **同功能续作(先查后建,2026-10-22)**:动工前按「模块 + 功能关键词」检索 `workflow/specs/`、`workflow/archive/**/specs/`、`.agents/skills/verify-ui/features/`、`workflow/regression-checklist.md`。命中覆盖同一行为 → 在原件上修订(spec 按上条口径原地改,不新建);确属新特性才新建。新建任务文档时 topic 带特性键,便于后续检索。
36
+ - **验证**:`.agents/commands/stages.md` Test 章(静态门 + UI 实测);切库探活与 API 防复发断言跑 `node scripts/verify/business/regression-smoke.mjs`(默认只读;`--writes` 自建自清探针,仅 dev 库)
37
+ - **评审**:`.agents/commands/review.md`(按 P0 / P1 / P2 分级:机器兜底 + AI 自查出清单,用户决策定性与合入)
38
+ - **PR 面板评审**:面板已退役为**手动工具**(2026-11-09 自动门退役)——pre-push / CI / pr-create 不再强制评审台账,需要时按 `.agents/commands/pr-review.md` 手动编排;建 PR 走 `node .agents/scripts/pr-create.mjs ...`(先 gate 再调 `tfs-pr create`)
39
+ - **上线**:`.agents/commands/deploy.md`(上线前必跑清单)
40
+ - **量化**:委派/自做结果记 `delegations.md`,聚合跑 `node .agents/scripts/agg-delegations.mjs`(**并发扩容门槛见该文件——数字达标前不扩并发**);语料与常驻面体积的**月度快照**跑 `node .agents/scripts/gen-workflow-metrics.mjs`(每月一行落 `metrics.md`,同月重跑即更新;明细看 stdout)
41
+ - **追溯**:git 即审计。两条驱动路径二选一、禁混用——手动阶段路由(确认后的 workflow 文档用 `docs(workflow)` 收成一笔,代码提交另笔;L1 普通需求只有 plan,修复为 incident+plan,L2/L3 为入口+spec+plan)或 `pipeline-run` 状态机(按阶段 `docsCommit` 落同形态提交,驱动协议单源 `.agents/commands/pipeline-run.md`)。上线不走 tag/24h 观察仪式(release tag 与发布观察台账已退役,2026-10-29)。本地开发依靠 Independent Reviewer 做认知隔离自查,主干合并通过 TFS PR 团队评审与 git 历史形成完整审计证据
42
+ - **级别**:L1 实现级(未命中 L2/L3;新需求的入口是 plan)| L2 规则 / 契约(编码权威 / 共享契约 / 既有接口语义 / 全局横切口径,触达面闭集见 `.agents/commands/new-task.md`)| L3 数据与运行时结构(schema / 迁移 SQL / DI 链 / 认证与中间件管线)。混合改动就高不就低
43
+
44
+ ## 执行模型
45
+
46
+ - 默认宿主主智能体负责阶段路由、用户确认、关键判断和最终验收,不注册为额外角色。
47
+ - 阶段命令仅在边界明确时委派 `.agents/roles/implementer.md`、`.agents/roles/independent-reviewer.md`、`.agents/roles/ui-verifier.md`。
48
+ - OpenCode、Trae、ZCode 分别通过 `.opencode/agents/`、`.trae/agents/`、`.zcode/agents/` 下的薄 Adapter 注册角色;角色行为只维护在 `.agents/roles/`。
49
+ - PI 通过 `.pi/agents/` 注册 7 篇角色薄壳(契约同 `.agents/roles/`);`.pi/extensions/` 把 tool_call 接到 `.agents/hooks/` 两门,判据单源不复制。`.pi/` 为本机私有目录(`.gitignore`),不随 clone 传播;阶段命令按根 `AGENTS.md` §4 路由表由主 Agent 直读 `.agents/commands/*.md`(pi 无 wf-* 命令壳),接线实态由 `check-local-gates.mjs` advisory 对账,机理见 `runtime-env.md` §6.4。
50
+ - Cline 通过 `.cline/workflows/`(7 篇指针壳 → `.agents/commands/`)与 `.cline/agents/`(7 篇角色定义,**YAML** → `.agents/roles/`)接入;Cline 原生读 `AGENTS.md` 与 `.agents/skills/`,故规则面与技能面零改动生效。`.cline/` 为本机私有目录(`.gitignore`),不随 clone 传播;**两道门未接线**(Cline hook 协议与仓库 `.agents/hooks/*.cjs` 不兼容,接入需协议适配层),机理见 `runtime-env.md` §6.4。
51
+ - 宿主不支持子智能体时按命令 frontmatter 的 `fallback` 执行;但**独立复核项不设 fallback**——L2 / L3 的 `independent-reviewer` 一律 `required: true`,宿主不支持子智能体时另开新会话,不得回退为原主智能体自查。
52
+ - 子智能体不得跨越用户确认门,也不得自行提交、合入或上线;所有结果由主智能体复核后交用户决策。
53
+
54
+ ## 闭环规则
55
+
56
+ 1. L1 新需求始于已确认的 plan,不另立 intent。L2/L3 新需求始于已确认的 intent。修复始于已确认的 incident;L1 修复再立同名 L1 plan,走 `.agents/commands/new-task.md` §L1 快速道(常态不打开 `stages.md`)
57
+ 2. L2/L3 必须先有同名 spec 确认通过(L2/L3 一律强制独立复核,见 `stages.md` Design §3),方可起草 plan。L1 plan 在 `new-task.md` §L1 快速道起草并确认(`stages.md` 只管 L2/L3),节为入口 / 改动方案 / 约束与风险 / 验证计划 / 验收标准
58
+ 3. 实现产物必须通过静态门(架构红线 + build + test)
59
+ 4. 线上 / 实测缺陷回落到 `incidents/`,复盘三件套(新 intent、防复发验证、规范条目)缺一不可;**根因属「门禁缺位 / 规范未落地 / 系统性问题」时,即使结构性修复已完成也必须立新 intent** 追踪系统性改进,禁止以「修复已完成」为由绕过 intent 回路
60
+ 5. 关单在 test,不依赖是否上 prod。L1 勾验 plan「验收标准」并补证据后 plan → done。L2/L3 勾验 intent「验收标准」后 intent → done,同名 plan 一并 done。修复类 incident 走 open → fixed → closed,同名 plan 一并 done。done 仍有未勾项会被 check-loop 拦(2026-09-12 起新建文档 hard-block,存量仅提示不回填)。上 prod 另走 deploy(PR 合入清单,不走 tag/24h 仪式)
61
+ 6. 放弃留档:方案曾确认后不做 → `superseded`;未完成即取消 → `cancelled`。二者均为已确认终态,check-loop 不按「状态未确认」拦截;L3 放弃件豁免「确认结果必须为 approved」
62
+ 7. 后续回归清单与周检清单也归档本目录
63
+ 8. **检查 17(发版草稿门)已于 2026-10-21 退役删码**:本仓根 `package.json` 无 `version` 字段,版本锚条件永不成立(2026-10-06 盘点);发版不走 tag 仪式(见「追溯」节)。该 hard 门已不存在,勿再按「恒跳过」理解
64
+
65
+ ## 历史归档(只读,不增量)
66
+
67
+ - 新需求设计文档一律写进 `workflow/specs/` 或 `workflow/plans/`;关键路径提炼进 `workflow/regression-checklist.md`。
@@ -0,0 +1,3 @@
1
+ # 历史归档
2
+
3
+ > 终态件按年月归档于此,只读不增量。归档协议见 `workflow/README.md`。
@@ -0,0 +1,4 @@
1
+ # 委派台账月度快照(生成物,勿手改)
2
+
3
+ > 由 `node .agents/scripts/agg-delegations.mjs --write` 重生成。
4
+ > 新装户占位;首次生成后自动填充。
@@ -0,0 +1,4 @@
1
+ # 生效策略快照(生成物,勿手改)
2
+
3
+ > 由 `node .agents/scripts/gen-effective-policy.mjs` 重生成。
4
+ > 新装户占位;锚表与生效策略在首次生成后自动填充。
File without changes
@@ -0,0 +1,4 @@
1
+ # 门禁成本近窗快照(生成物,勿手改)
2
+
3
+ > 由 `node .agents/scripts/gen-workflow-metrics.mjs --gate-cost-only` 重生成。
4
+ > 新装户占位;首次生成后自动填充近窗门禁耗时。
@@ -0,0 +1,49 @@
1
+ ---
2
+ 状态: open
3
+ 级别: L1
4
+ 发现: YYYY-MM-DD
5
+ 来源: <self | user | test | monitor——谁发现,见 .agents/config/workflow-enums.txt incident.source.all>
6
+ 影响环境: <dev | staging | prod | none——缺陷触达的环境,none=未触达运行环境>
7
+ 模块: <词表之一,见 .agents/config/workflow-modules.txt>
8
+ ---
9
+ # INCIDENT — <日期 主题>
10
+ <!-- 复制为 YYYY-MM-DD-<主题>.md;线上或实测发现的功能缺陷都记录,历史 BUG 可回填 -->
11
+ <!-- frontmatter 受限子集(2026-09-13):状态∈open/fixed/closed(严格枚举,附注写备注键);级别∈L1/L2/L3;闭环引擎启用前的回填件加一行 `流程: legacy`(豁免级别/配对检查);正文不再写状态/级别/发现行 -->
12
+ <!-- 归因两键(2026-10-11 incident-attribution 起新建件必填,check-loop 检查 24 校验):锚前存量不回填;「来源」是缺陷发现方(供来源×环境交叉表机器复算,替代逐件人工判读),「影响环境」写实际触达环境(未触达写 none) -->
13
+
14
+ ## 时间线
15
+ - <发现 → 定位 → 止血 → 恢复,带时刻>
16
+ - 用户确认:草稿过目通过(<日期>)
17
+ <!-- 上行是**L2/L3 起草 spec 的机器前置**(fill-spec / confirm-doc 校验):须为「时间线」小节内的行首条目;
18
+ 接受形态 `- 用户确认:…` / `- **用户确认**:…` / `- <日期> 用户确认:…`(词前词后加粗、日期前缀均可);
19
+ 正文叙述句(如「用户确认了方案」)不算留痕。形态清单写在本注释内,避免样例行自含描述文字 -->
20
+
21
+ ## 影响面
22
+ - <页面 / 接口 / 数据范围>
23
+
24
+ ## 根因
25
+ <一句话;深层原因另起一行>
26
+
27
+ ## 为什么之前没拦住
28
+ <门禁 / 测试 / 规范各查一遍:哪一层本可以拦住>
29
+
30
+ ## 复盘三件套(缺一不可)
31
+
32
+ > 目的:让事故真正回到 Plan,不让「防复发」承诺停留在文档里。模块已逐步上线,事故可能来自 dev / staging / prod 任一环境。
33
+
34
+ 1. 结构性修复
35
+ - 修复 commit:<SHA + 改动文件清单>
36
+ - 影响环境:dev / staging / prod(已上线模块若波及 prod,需附影响用户数 / 持续时长 / 是否回滚)
37
+ - 是否需要新 intent:
38
+ - 是 → ../intents/YYYY-MM-DD-<主题>.md(根因属「门禁缺位 / 规范未落地 / 系统性问题」时强制立,即使结构性修复已完成)
39
+ - 否 → 理由:<根因属实现 bug、单点修复已完成,且已有规范条目覆盖>
40
+
41
+ 2. 防复发验证(必须落到自动化用例或回归清单条目,禁止只写「已人工验证」)
42
+ - 自动化用例:tests/<测试文件>(<用例名 / 数量>)
43
+ - 或 test 步骤:.agents/commands/stages.md Test 章 + <具体操作>
44
+ - 或回归清单条目:workflow/regression-checklist.md(防复发验证节追加一行)
45
+
46
+ 3. 规范条目(必须有可追溯的落点)
47
+ - 落点(多选):AGENTS.md <章节> / .agents/hooks/<脚本> / .agents/skills/<skill> / .agents/commands/<cmd> / 回归清单 §<章节>
48
+ - 引用:commit <SHA> / 文件:<路径>#L<行>
49
+ - 若无新增条目,理由:<已有条目覆盖,说明条目位置>
@@ -0,0 +1,43 @@
1
+ ---
2
+ 状态: draft
3
+ 级别: L1
4
+ 日期: YYYY-MM-DD
5
+ 模块: <词表之一,见 .agents/config/workflow-modules.txt>
6
+ 备注: <可选:附注自由文本,check-loop 不解析>
7
+ ---
8
+ # INTENT — <主题>
9
+ <!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写;plans/ 下同名文件与本文件配对 -->
10
+ <!-- frontmatter 受限子集(2026-09-13):每行 `键: 值`;状态∈draft/approved/done/superseded/cancelled(严格枚举,附注写备注键);级别∈L1/L2/L3;check-loop 只扫 frontmatter 取机器字段,正文不再写状态/级别行 -->
11
+
12
+ ## 背景与问题
13
+ <为什么做;写明需求来源(工单 / 沟通记录 / 待办事项)>
14
+
15
+ ## 目标
16
+ - <可验证的目标>
17
+
18
+ ## 非目标(L1 微改动无实质内容可删本节,不硬填)
19
+ - <明确不做的,防止范围蔓延>
20
+
21
+ ## 约束(L1 微改动无实质内容可删本节,不硬填)
22
+ - <复用什么、不许动什么>
23
+
24
+ ## 影响面
25
+ - 模块:shared / material(Domain / Application / Infrastructure / API)
26
+ - 数据库:无 / <表名>(涉及 schema 变更 → L3;无 schema 的运行时 / 管线结构面亦为 L3,判据见 `.agents/commands/new-task.md` §级别判断)
27
+ - 前端页面:<路由或组件,无则删本行>
28
+
29
+ ## 触达红线(对照 AGENTS.md,勾选仅标记触及范围;具体如何满足在同名 spec 中说明)
30
+ - [ ] Application 禁引 Infrastructure / DbContext(豁免仅限分类树原生 LINQ)
31
+ - [ ] 编码生成逻辑(FormulaEngine / CategoryPrefix)→ 级别至少 L2
32
+ - [ ] 跨调用方契约变更(共享层基类 / DTO 形状 / 接口签名 / 既有参数语义 / 全局响应与分页校验口径)→ 级别至少 L2
33
+ - [ ] schema / 迁移 SQL / DI 链 → 级别 L3
34
+ - [ ] 前端:Drawer 一律 / 禁 a-select 大数据量 / 样式统一 style.css
35
+
36
+ > 触及任一红线即为 L2 / L3,必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足,方可起草 plan。
37
+
38
+ ## 验收标准(可测试)
39
+ <!-- 每条加稳定编号 A1..An(锚 coverageSince 2026-10-22 起,spec 确认门按编号查覆盖);增删用新号、不复用旧号。 -->
40
+ - [ ] A1 <逐条可测试;写不出可测试判据 = 还没想清楚>
41
+
42
+ > **闭环对账**:关单在 test 阶段(不依赖 deploy)。intent 置 done 前逐条勾验,每条勾选项后补证据——`- [x] <判据>(证据:<commit SHA / 测试用例名 / 冒烟脚本输出>)`。
43
+ > done 状态仍有未勾项会被 check-loop 拦截(2026-09-12 起新建 intent 为 hard-block,存量 intent 仅 warning 提示);勾选但缺「证据:」为 warning。
@@ -0,0 +1,4 @@
1
+ # workflow metrics(生成物,勿手改)
2
+
3
+ > 由 `node .agents/scripts/gen-workflow-metrics.mjs` 从台账与文档树重生成。
4
+ > 新装户占位;首次生成后自动填充月度指标。
@@ -0,0 +1,3 @@
1
+ # Papercuts 清单
2
+
3
+ > 手工维护:记录高频小痛点与处置状态。格式与条目协议见 `workflow/README.md`。
@@ -0,0 +1,47 @@
1
+ ---
2
+ 状态: draft
3
+ 级别: L1
4
+ 日期: <YYYY-MM-DD 建档日>
5
+ 模块: <词表之一,见 .agents/config/workflow-modules.txt>
6
+ ---
7
+ # PLAN — <与入口文档同名主题>
8
+ <!-- 与 intents/ 或 incidents/ 下同名入口文档配对;L2/L3 必须先有 ../specs/ 同名 spec 确认通过;AI 起草、用户对话内确认后开工 -->
9
+ <!-- frontmatter 受限子集(2026-09-13):状态∈draft/approved/done/superseded/cancelled(严格枚举,附注写备注键);级别∈L1/L2/L3;正文不再写状态/级别行 -->
10
+ <!-- L1(2026-10-10):新单用 fill-plan.mjs --level L1,本文件即入口,不另立 intent。节:入口 / 改动方案 / 约束与风险 / 验证计划 / 验收标准。下面保留的「改动面 / 验证方式」是存量极简形态,新单不要再复制这两节标题。 -->
11
+ <!-- 模糊点纪律(2026-10-16):起草/修订遇无法自行决策的模糊点(多种解释/口径缺失/依赖外部事实)禁止脑补——在对应节原地插入 [NEEDS CLARIFICATION]: <一句话问题> 并保持 draft 向用户求澄清;澄清后删除标记、把决策落为正文。approved 前标记须清零(口径见 workflow/README.md 文档协议「模糊点显式阻断」)。 -->
12
+
13
+ 对应入口:L1 = 本 plan。修复类另保留 ../incidents/YYYY-MM-DD-<主题>.md。L2/L3 = ../intents/YYYY-MM-DD-<主题>.md
14
+ 对应 spec:../specs/YYYY-MM-DD-<主题>.md(仅 L2/L3)
15
+
16
+ ## 改动面(L1 极简形态主节;L2/L3 可作任务拆解的汇总或删本节)
17
+ - <文件/组件>:<做什么;判据细节直接写进条目,如「L771 message.success 改『更新成功』」>
18
+ <!-- stages.md Build §2 确认的改动清单确认后回填本节落盘(对话留痕仅供当次)——改动面 + 任务勾选态 + git status = 会话重入三锚(2026-10-11 session-context) -->
19
+
20
+ ## 任务拆解(L2/L3 必填;L1 仅多文件多步骤时用,单任务微改动删本节)
21
+ <!-- 任务即勾选态(2026-10-11 session-context):完成一项立刻勾选并回填留痕;压缩 / 新会话续作先读本表勾选态 + git status 重建进度,禁凭记忆补勾 -->
22
+ <!-- 依赖行(blocking edges,matt to-tickets 同构):显式声明阻塞关系后「依赖行所指任务已勾选」即可开工——无未决阻塞的任务集 = frontier,可并行派发(多 worktree / 委派「新开+合并范围」);纯顺序链依赖行退化为「任务 N-1」,零额外成本 -->
23
+ - [ ] 1. <任务>
24
+ - 判据:<怎样算完成;尽量对应一个测试或可复现操作>
25
+ - 依赖:无(可立即开工)/ 被任务 <N> 阻塞
26
+ - 风险:低 / 中 / 高(<原因>)
27
+ - 留痕:(勾选时回填 commit SHA / 测试名 / 实测输出)
28
+ - [ ] 2. <任务>
29
+ - 判据:…
30
+ - 依赖:…
31
+ - 风险:…
32
+ - 留痕:…
33
+
34
+ ## 执行顺序(L2/L3 必填;L1 单文件微改动删本节)
35
+ <1 → 2 → 3;依赖已在上表「依赖」行显式化时本节只写一句「见任务拆解依赖行,frontier = 无未决阻塞任务」,纯顺序链写 1 → N 即可>
36
+
37
+ ## 验证方式
38
+ - 构建:<项目构建命令>(+ <测试命令>)
39
+ - 前端:cd frontend && npm run build(vue-tsc)
40
+ - UI:.agents/commands/stages.md Test 章(涉及页面改动必走,headless Chrome 实测)
41
+ - L2 追加:<契约 / 规则面比对:编码结果抽样 / 接口契约断言 / 口径对账>
42
+ - L3 追加:<含 schema 变更:备份 + 回滚 SQL 就绪后执行;仅运行时 / 管线:回退上一 release tag + 配置开关预案>
43
+
44
+ ## 确认与复核
45
+ > 确认 = 用户在对话内一句话通过;确认后本 plan 状态 `draft → approved` 并回填本节(确认环节的机器可见态),`done` 只在关单出现——禁从 `draft` 直跳 `done`(2026-09-22 papercut)。
46
+ - 确认结果:approved(YYYY-MM-DD 用户对话内确认);done(YYYY-MM-DD 关单,随入口文档置终态)
47
+ - 确认门记录:plan 草稿全文过目 + 改动清单确认(`stages.md` Build 两道门,逐次,不合并)
@@ -0,0 +1,3 @@
1
+ # 回归清单
2
+
3
+ > 手工维护:关键路径与防复发验证项。新增条目须关联 incident 或 plan。
File without changes
File without changes