@event4u/agent-config 16.3.0 → 16.4.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 (486) hide show
  1. package/.augment-plugin/marketplace.json +3 -3
  2. package/.augment-plugin/plugin.json +1 -1
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/CHANGELOG.md +251 -0
  5. package/README.md +2 -2
  6. package/agents/templates/.ai-council.yml.example +26 -8
  7. package/dist/agent-src/commands/analyze/inbox.md +10 -7
  8. package/dist/agent-src/commands/bug/investigate.md +1 -1
  9. package/dist/agent-src/commands/commit/in-chunks.md +40 -31
  10. package/dist/agent-src/commands/commit.md +72 -33
  11. package/dist/agent-src/commands/condense.md +2 -8
  12. package/dist/agent-src/commands/council/debate.md +11 -7
  13. package/dist/agent-src/commands/council/default.md +10 -9
  14. package/dist/agent-src/commands/council.md +1 -1
  15. package/dist/agent-src/commands/estimate-ticket.md +1 -1
  16. package/dist/agent-src/commands/feature/explore.md +3 -3
  17. package/dist/agent-src/commands/feature/plan.md +1 -1
  18. package/dist/agent-src/commands/fix/ci.md +17 -3
  19. package/dist/agent-src/commands/fix/commit-messages.md +48 -23
  20. package/dist/agent-src/commands/fix/pr-comments.md +3 -6
  21. package/dist/agent-src/commands/implement-ticket.md +3 -3
  22. package/dist/agent-src/commands/memory/add.md +4 -16
  23. package/dist/agent-src/commands/memory/load.md +5 -6
  24. package/dist/agent-src/commands/memory/promote.md +3 -16
  25. package/dist/agent-src/commands/mission/upgrade.md +3 -2
  26. package/dist/agent-src/commands/optimize/agents-dir.md +2 -2
  27. package/dist/agent-src/commands/optimize/deep.md +4 -2
  28. package/dist/agent-src/commands/optimize/rtk.md +4 -26
  29. package/dist/agent-src/commands/pr/create/description-only.md +18 -15
  30. package/dist/agent-src/commands/pr/create.md +42 -34
  31. package/dist/agent-src/commands/pr/merge.md +136 -9
  32. package/dist/agent-src/commands/prepare-for-review.md +13 -11
  33. package/dist/agent-src/commands/project/analyze.md +7 -35
  34. package/dist/agent-src/commands/refine-ticket.md +1 -1
  35. package/dist/agent-src/commands/review/changes.md +14 -19
  36. package/dist/agent-src/commands/roadmap/next.md +10 -1
  37. package/dist/agent-src/commands/roadmap/process-full.md +52 -38
  38. package/dist/agent-src/commands/roadmap/resolve-blockers.md +64 -14
  39. package/dist/agent-src/commands/worktree/create.md +7 -3
  40. package/dist/agent-src/commands/worktree/verify.md +2 -1
  41. package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +5 -3
  42. package/dist/agent-src/contexts/communication/rules-auto/token-efficiency-mechanics.md +7 -9
  43. package/dist/agent-src/contexts/contracts/command-suggestion-flow.md +8 -6
  44. package/dist/agent-src/contexts/contracts/frugality-charter.md +8 -5
  45. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +1 -1
  46. package/dist/agent-src/contexts/execution/auto-orchestration-activation.md +0 -1
  47. package/dist/agent-src/contexts/execution/evidence-discipline.md +2 -2
  48. package/dist/agent-src/contexts/execution/non-interactive-contract.md +5 -8
  49. package/dist/agent-src/contexts/execution/rdp-gate.md +4 -4
  50. package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +9 -8
  51. package/dist/agent-src/contexts/execution/roadmap-process-loop.md +67 -52
  52. package/dist/agent-src/contexts/execution/subagent-routing.md +8 -8
  53. package/dist/agent-src/contexts/execution/subagent-steering.md +6 -4
  54. package/dist/agent-src/contexts/execution/terminal-states.md +2 -2
  55. package/dist/agent-src/contexts/execution/toolchain-resolver.md +4 -10
  56. package/dist/agent-src/contexts/subagent-configuration.md +1 -1
  57. package/dist/agent-src/guidelines/agent-infra/active-remediation-mechanics.md +39 -0
  58. package/dist/agent-src/guidelines/agent-infra/context-hygiene-mechanics.md +1 -1
  59. package/dist/agent-src/guidelines/agent-infra/cross-source-consistency-mechanics.md +8 -10
  60. package/dist/agent-src/guidelines/agent-infra/frontier-reasoning-operating-profile.md +3 -2
  61. package/dist/agent-src/guidelines/agent-infra/layered-settings.md +13 -1
  62. package/dist/agent-src/guidelines/agent-infra/roadmap-progress-mechanics.md +1 -1
  63. package/dist/agent-src/guidelines/agent-infra/self-improvement-pipeline.md +10 -3
  64. package/dist/agent-src/guidelines/agent-infra/size-and-scope.md +36 -0
  65. package/dist/agent-src/guidelines/php/git.md +15 -2
  66. package/dist/agent-src/rules/active-remediation.md +0 -1
  67. package/dist/agent-src/rules/analysis-skill-routing.md +0 -1
  68. package/dist/agent-src/rules/architecture.md +0 -1
  69. package/dist/agent-src/rules/artifact-drafting-protocol.md +0 -1
  70. package/dist/agent-src/rules/artifact-engagement-recording.md +0 -1
  71. package/dist/agent-src/rules/augment-edit-discipline.md +0 -1
  72. package/dist/agent-src/rules/autonomous-execution.md +0 -1
  73. package/dist/agent-src/rules/brand-consistency.md +0 -1
  74. package/dist/agent-src/rules/brand-source-of-truth.md +0 -1
  75. package/dist/agent-src/rules/broken-access-control.md +0 -1
  76. package/dist/agent-src/rules/cli-output-handling.md +0 -1
  77. package/dist/agent-src/rules/code-comment-discipline.md +0 -1
  78. package/dist/agent-src/rules/code-provenance.md +0 -1
  79. package/dist/agent-src/rules/command-suggestion-policy.md +0 -1
  80. package/dist/agent-src/rules/commit-conventions.md +1 -2
  81. package/dist/agent-src/rules/communication-through-line.md +1 -2
  82. package/dist/agent-src/rules/content-quoting-floor.md +1 -2
  83. package/dist/agent-src/rules/context-hygiene.md +5 -5
  84. package/dist/agent-src/rules/copilot-routing.md +1 -2
  85. package/dist/agent-src/rules/council-availability.md +4 -4
  86. package/dist/agent-src/rules/cross-source-consistency.md +4 -6
  87. package/dist/agent-src/rules/decision-revisit-gate.md +2 -3
  88. package/dist/agent-src/rules/delegation-policy.md +2 -3
  89. package/dist/agent-src/rules/design-fidelity.md +0 -1
  90. package/dist/agent-src/rules/design-review-after-ui-write.md +3 -3
  91. package/dist/agent-src/rules/devcontainer-routing.md +1 -2
  92. package/dist/agent-src/rules/doc-screenshot-hygiene.md +0 -1
  93. package/dist/agent-src/rules/docker-commands.md +0 -1
  94. package/dist/agent-src/rules/domain-adoption-policy.md +0 -1
  95. package/dist/agent-src/rules/domain-safety-disclaimer.md +0 -1
  96. package/dist/agent-src/rules/domain-safety-pii.md +0 -1
  97. package/dist/agent-src/rules/domain-safety-retention.md +0 -1
  98. package/dist/agent-src/rules/downstream-changes.md +0 -1
  99. package/dist/agent-src/rules/engineering-safety-floor.md +0 -1
  100. package/dist/agent-src/rules/external-code-graph-interop.md +0 -1
  101. package/dist/agent-src/rules/external-reference-deep-dive.md +0 -1
  102. package/dist/agent-src/rules/fast-path-marker-visibility.md +1 -2
  103. package/dist/agent-src/rules/finance-safety-floor.md +0 -1
  104. package/dist/agent-src/rules/fix-what-you-see.md +6 -32
  105. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +0 -1
  106. package/dist/agent-src/rules/git-history-discipline.md +1 -2
  107. package/dist/agent-src/rules/guidelines.md +0 -1
  108. package/dist/agent-src/rules/history-discipline.md +0 -1
  109. package/dist/agent-src/rules/icon-consistency.md +0 -1
  110. package/dist/agent-src/rules/image-likeness-and-rights.md +0 -1
  111. package/dist/agent-src/rules/improve-before-implement.md +0 -1
  112. package/dist/agent-src/rules/invite-challenge.md +0 -1
  113. package/dist/agent-src/rules/laravel-routing.md +1 -2
  114. package/dist/agent-src/rules/laravel-translations.md +0 -1
  115. package/dist/agent-src/rules/legal-safety-floor.md +0 -1
  116. package/dist/agent-src/rules/lethal-trifecta-guard.md +0 -1
  117. package/dist/agent-src/rules/linked-projects-onboarding-gate.md +0 -1
  118. package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +0 -1
  119. package/dist/agent-src/rules/markdown-safe-codeblocks.md +0 -1
  120. package/dist/agent-src/rules/media-governance-routing.md +1 -2
  121. package/dist/agent-src/rules/media-sync-ground-truth.md +0 -1
  122. package/dist/agent-src/rules/minimal-safe-diff.md +0 -1
  123. package/dist/agent-src/rules/missing-skill-recovery.md +0 -1
  124. package/dist/agent-src/rules/missing-tool-handling.md +0 -1
  125. package/dist/agent-src/rules/model-recommendation.md +0 -1
  126. package/dist/agent-src/rules/neighbour-precedence.md +64 -0
  127. package/dist/agent-src/rules/no-attribution-footers.md +0 -1
  128. package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +0 -1
  129. package/dist/agent-src/rules/no-pr-progress-comments.md +0 -1
  130. package/dist/agent-src/rules/no-roadmap-references.md +0 -1
  131. package/dist/agent-src/rules/notes-first-reasoning.md +0 -1
  132. package/dist/agent-src/rules/onboarding-gate.md +0 -1
  133. package/dist/agent-src/rules/output-discipline.md +0 -1
  134. package/dist/agent-src/rules/package-ci-checks.md +0 -1
  135. package/dist/agent-src/rules/persona-governance.md +2 -3
  136. package/dist/agent-src/rules/php-coding.md +0 -1
  137. package/dist/agent-src/rules/prefer-enums-over-literals.md +0 -1
  138. package/dist/agent-src/rules/preservation-guard.md +0 -1
  139. package/dist/agent-src/rules/provider-lifecycle-discipline.md +2 -3
  140. package/dist/agent-src/rules/question-not-instruction.md +0 -1
  141. package/dist/agent-src/rules/reviewer-awareness.md +0 -1
  142. package/dist/agent-src/rules/roadmap-ci-steps-policy.md +0 -1
  143. package/dist/agent-src/rules/roadmap-progress-sync.md +3 -6
  144. package/dist/agent-src/rules/role-mode-adherence.md +0 -1
  145. package/dist/agent-src/rules/rule-type-governance.md +0 -1
  146. package/dist/agent-src/rules/runtime-safety.md +0 -1
  147. package/dist/agent-src/rules/scale-discipline.md +0 -1
  148. package/dist/agent-src/rules/secret-vcs-guard.md +0 -1
  149. package/dist/agent-src/rules/security-sensitive-stop.md +0 -1
  150. package/dist/agent-src/rules/self-repair-loop.md +0 -1
  151. package/dist/agent-src/rules/senior-engineering-discipline.md +0 -1
  152. package/dist/agent-src/rules/session-canary.md +0 -1
  153. package/dist/agent-src/rules/settings-ask-protocol.md +5 -6
  154. package/dist/agent-src/rules/size-enforcement.md +0 -1
  155. package/dist/agent-src/rules/skill-improvement-trigger.md +2 -3
  156. package/dist/agent-src/rules/skill-quality.md +0 -1
  157. package/dist/agent-src/rules/slash-command-routing-policy.md +0 -1
  158. package/dist/agent-src/rules/source-confidentiality.md +0 -1
  159. package/dist/agent-src/rules/source-discovery-gate.md +0 -1
  160. package/dist/agent-src/rules/source-of-truth.md +0 -1
  161. package/dist/agent-src/rules/spreadsheet-source-quality.md +1 -2
  162. package/dist/agent-src/rules/strategy-safety-floor.md +0 -1
  163. package/dist/agent-src/rules/symfony-routing.md +1 -2
  164. package/dist/agent-src/rules/think-before-action.md +0 -1
  165. package/dist/agent-src/rules/token-budget-discipline.md +12 -46
  166. package/dist/agent-src/rules/token-efficiency.md +0 -1
  167. package/dist/agent-src/rules/token-optimizer-maintenance.md +0 -1
  168. package/dist/agent-src/rules/tool-safety.md +0 -1
  169. package/dist/agent-src/rules/ui-audit-gate.md +1 -2
  170. package/dist/agent-src/rules/untrusted-input-defense.md +0 -1
  171. package/dist/agent-src/rules/upstream-proposal.md +0 -1
  172. package/dist/agent-src/rules/user-interaction.md +0 -1
  173. package/dist/agent-src/rules/user-interrupt-priority.md +0 -1
  174. package/dist/agent-src/scripts/gate_budget.ts +47 -23
  175. package/dist/agent-src/scripts/gate_execute.ts +12 -4
  176. package/dist/agent-src/skills/ai-council/SKILL.md +7 -4
  177. package/dist/agent-src/skills/ai-council/references/cost-and-redaction.md +21 -11
  178. package/dist/agent-src/skills/ai-council/references/procedure.md +12 -6
  179. package/dist/agent-src/skills/analysis-autonomous-mode/SKILL.md +1 -1
  180. package/dist/agent-src/skills/bug-analyzer/SKILL.md +1 -1
  181. package/dist/agent-src/skills/command-routing/SKILL.md +3 -4
  182. package/dist/agent-src/skills/conventional-commits-writing/SKILL.md +127 -139
  183. package/dist/agent-src/skills/corpus-grounding/ATTRIBUTION.md +39 -0
  184. package/dist/agent-src/skills/corpus-grounding/SKILL.md +8 -2
  185. package/dist/agent-src/skills/database/data/manifest.json +2 -2
  186. package/dist/agent-src/skills/database/data/query-tuning.csv +13 -13
  187. package/dist/agent-src/skills/design-system-capture/SKILL.md +0 -3
  188. package/dist/agent-src/skills/estimate-ticket/SKILL.md +1 -1
  189. package/dist/agent-src/skills/feature-planning/SKILL.md +1 -1
  190. package/dist/agent-src/skills/git-workflow/SKILL.md +44 -44
  191. package/dist/agent-src/skills/git-workflow/references/branch-update.md +312 -0
  192. package/dist/agent-src/skills/git-workflow/references/commit-subject.md +205 -0
  193. package/dist/agent-src/skills/jira-integration/SKILL.md +3 -3
  194. package/dist/agent-src/skills/merge-conflicts/SKILL.md +10 -4
  195. package/dist/agent-src/skills/po-discovery/SKILL.md +1 -1
  196. package/dist/agent-src/skills/refine-ticket/SKILL.md +4 -4
  197. package/dist/agent-src/skills/roadmap-writing/SKILL.md +2 -2
  198. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +4 -2
  199. package/dist/agent-src/skills/source-discovery/SKILL.md +1 -1
  200. package/dist/agent-src/skills/tailwind-engineer/SKILL.md +3 -1
  201. package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
  202. package/dist/agent-src/skills/using-git-worktrees/SKILL.md +1 -1
  203. package/dist/agent-src/skills/verify-repair-loop/SKILL.md +2 -2
  204. package/dist/agent-src/templates/AGENTS.md +1 -1
  205. package/dist/agent-src/templates/agent-settings.md +46 -129
  206. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +3 -3
  207. package/dist/agent-src/templates/command.md +2 -2
  208. package/dist/agent-src/templates/roadmaps.md +6 -1
  209. package/dist/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +0 -6
  210. package/dist/agent-src/templates/scripts/work_engine/directives/backend/_self_fix.ts +11 -7
  211. package/dist/agent-src/templates/scripts/work_engine/hooks/builtin/decision_trace.ts +3 -2
  212. package/dist/agent-src/templates/scripts/work_engine/hooks/builtin/memory_visibility.ts +2 -1
  213. package/dist/agent-src/templates/scripts/work_engine/hooks/settings.ts +0 -6
  214. package/dist/agent-src/templates/scripts/work_engine/scoring/decision_engine.ts +9 -12
  215. package/dist/agent-src/templates/scripts/work_engine/scoring/memory_visibility.ts +2 -1
  216. package/dist/agent-src/templates/skill.md +1 -1
  217. package/dist/cli/registry.js +1 -0
  218. package/dist/cli-delegate/check_update_banner.js +195 -119
  219. package/dist/cli-delegate/{chunk-TRI6DQZ6.js → chunk-5GPULQBE.js} +60 -42
  220. package/dist/cli-delegate/{chunk-JQVYKIZA.js → chunk-6SRJTYJS.js} +33 -177
  221. package/dist/cli-delegate/chunk-6V5FMA3P.js +186 -0
  222. package/dist/cli-delegate/chunk-6YQC2HLF.js +415 -0
  223. package/dist/cli-delegate/{chunk-E4XIZDIB.js → chunk-7HKRE54K.js} +1 -64
  224. package/dist/cli-delegate/{chunk-NQ7WT43P.js → chunk-AED2VQGM.js} +65 -11
  225. package/dist/cli-delegate/{chunk-7HQ52DHU.js → chunk-AL3RZ22D.js} +1 -1
  226. package/dist/cli-delegate/{chunk-DBH4AHDK.js → chunk-ED7KCMLB.js} +9 -11
  227. package/dist/cli-delegate/{chunk-NXEILF2K.js → chunk-F3QDG2GT.js} +481 -72
  228. package/dist/cli-delegate/{chunk-CQWX336L.js → chunk-G5VVIZRC.js} +3 -3
  229. package/dist/cli-delegate/{chunk-JY2I2DXV.js → chunk-H76PHZBI.js} +137 -60
  230. package/dist/cli-delegate/chunk-IAYTIIQW.js +67 -0
  231. package/dist/cli-delegate/{chunk-LIYTLH6O.js → chunk-KXXWJTDO.js} +5 -10
  232. package/dist/cli-delegate/{chunk-T7L2QK3K.js → chunk-LQOCRFWT.js} +1 -1
  233. package/dist/cli-delegate/{chunk-S4YWNRKO.js → chunk-MDPPKQCQ.js} +34 -1
  234. package/dist/cli-delegate/{chunk-S4UMZNES.js → chunk-MSUL5NYP.js} +5 -5
  235. package/dist/cli-delegate/chunk-OAFSJBHH.js +272 -0
  236. package/dist/cli-delegate/{chunk-GKE7ZVFA.js → chunk-PWX7CKMD.js} +1 -1
  237. package/dist/cli-delegate/{chunk-NDJLNC6Q.js → chunk-T6BP34WI.js} +1 -0
  238. package/dist/cli-delegate/{chunk-RQNNW7IF.js → chunk-T7XSJSUQ.js} +433 -632
  239. package/dist/cli-delegate/{chunk-EEHDXSYD.js → chunk-WQWXGIWB.js} +12 -273
  240. package/dist/cli-delegate/{chunk-QLDHIPWR.js → chunk-XQTPXKFA.js} +1 -1
  241. package/dist/cli-delegate/cmd_analyze_session.js +223 -43
  242. package/dist/cli-delegate/cmd_brand_status.js +3 -2
  243. package/dist/cli-delegate/cmd_conformance.js +105 -35
  244. package/dist/cli-delegate/cmd_converge.js +3 -3
  245. package/dist/cli-delegate/cmd_doctor.js +15 -12
  246. package/dist/cli-delegate/cmd_doctor_neighbours.js +11 -4
  247. package/dist/cli-delegate/cmd_explain.js +43 -19
  248. package/dist/cli-delegate/cmd_export.js +10 -10
  249. package/dist/cli-delegate/cmd_git_convention.js +1851 -0
  250. package/dist/cli-delegate/cmd_handoff.js +40 -21
  251. package/dist/cli-delegate/cmd_mcp_available.js +3 -2
  252. package/dist/cli-delegate/cmd_migrate.js +3 -3
  253. package/dist/cli-delegate/cmd_packs_active.js +4 -3
  254. package/dist/cli-delegate/cmd_prune.js +10 -10
  255. package/dist/cli-delegate/cmd_route_audit.js +7 -7
  256. package/dist/cli-delegate/cmd_route_explain.js +5 -5
  257. package/dist/cli-delegate/cmd_session_recycle.js +9 -7
  258. package/dist/cli-delegate/cmd_settings_check.js +54 -7
  259. package/dist/cli-delegate/cmd_settings_get.js +18 -8
  260. package/dist/cli-delegate/cmd_settings_migrate.js +10 -10
  261. package/dist/cli-delegate/cmd_settings_set.js +1 -1
  262. package/dist/cli-delegate/cmd_sync.js +10 -10
  263. package/dist/cli-delegate/cmd_uninstall.js +10 -10
  264. package/dist/cli-delegate/cmd_update.js +7 -7
  265. package/dist/cli-delegate/cmd_upgrade.js +7 -7
  266. package/dist/cli-delegate/cmd_validate.js +10 -10
  267. package/dist/cli-delegate/cmd_versions.js +5 -5
  268. package/dist/cli-delegate/gate_budget.js +1 -1
  269. package/dist/cli-delegate/gate_execute.js +2 -2
  270. package/dist/cli-delegate/roadmap_gates.js +2 -2
  271. package/dist/discovery/deprecation-report.md +1 -1
  272. package/dist/discovery/discovery-manifest.json +129 -90
  273. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  274. package/dist/discovery/discovery-manifest.summary.md +3 -3
  275. package/dist/discovery/dormancy-report.md +1 -1
  276. package/dist/discovery/orphan-report.md +1 -1
  277. package/dist/discovery/packs.json +24 -9
  278. package/dist/discovery/trust-report.md +3 -3
  279. package/dist/discovery/workspaces.json +5 -4
  280. package/dist/hooks/dispatch.js +2151 -1820
  281. package/dist/hooks/dispatch.sha256 +1 -1
  282. package/dist/install/install.mjs +462 -431
  283. package/dist/install/installThinLayer.js +40 -12
  284. package/dist/install/installedRuleLinks.js +105 -19
  285. package/dist/mcp/awesome-mcp-servers.row.md +1 -1
  286. package/dist/mcp/mcp-cloudflare-catalogue.json +2 -2
  287. package/dist/mcp/registry-manifest.json +5 -5
  288. package/dist/mcp/server.json +2 -2
  289. package/dist/mcp/server.mjs +2702 -1995
  290. package/dist/router.json +1 -1
  291. package/dist/scripts/_lib/agent_settings.js +15 -120
  292. package/dist/scripts/_lib/compile_time_toggles.js +12 -21
  293. package/dist/scripts/_lib/git_convention.js +232 -0
  294. package/dist/scripts/_lib/global_deploy_inventory.js +730 -0
  295. package/dist/scripts/_lib/installed_layer.js +344 -18
  296. package/dist/scripts/_lib/package_root.js +68 -0
  297. package/dist/scripts/_lib/rule_law_section.js +1 -1
  298. package/dist/scripts/_lib/settings_removed_keys.js +168 -0
  299. package/dist/scripts/_lib/thin_rules.js +80 -3
  300. package/dist/server/app.js +2 -1
  301. package/dist/server/gitKeysGate.js +105 -0
  302. package/dist/server/routes/settings.js +67 -8
  303. package/dist/server/routes/wizard.js +4 -0
  304. package/dist/server/schemas/settings.js +23 -81
  305. package/dist/shared/skillRanking.js +30 -4
  306. package/dist/ui/assets/{index-Cwq4d0hX.js → index-C3djEJah.js} +2 -2
  307. package/dist/ui/index.html +1 -1
  308. package/docs/MIGRATION.md +72 -1
  309. package/docs/contracts/settings-classes.md +35 -65
  310. package/docs/guidelines/agent-infra/active-remediation-mechanics.md +39 -0
  311. package/docs/guidelines/agent-infra/context-hygiene-mechanics.md +1 -1
  312. package/docs/guidelines/agent-infra/cross-source-consistency-mechanics.md +8 -10
  313. package/docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md +3 -2
  314. package/docs/guidelines/agent-infra/layered-settings.md +13 -1
  315. package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +1 -1
  316. package/docs/guidelines/agent-infra/self-improvement-pipeline.md +10 -3
  317. package/docs/guidelines/agent-infra/size-and-scope.md +36 -0
  318. package/docs/guidelines/php/git.md +15 -2
  319. package/package.json +1 -1
  320. package/src/agent-src/scripts/gate_budget.ts +47 -23
  321. package/src/agent-src/scripts/gate_execute.ts +12 -4
  322. package/src/agent-src/templates/AGENTS.md +1 -1
  323. package/src/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +0 -6
  324. package/src/agent-src/templates/scripts/work_engine/directives/backend/_self_fix.ts +11 -7
  325. package/src/agent-src/templates/scripts/work_engine/hooks/builtin/decision_trace.ts +3 -2
  326. package/src/agent-src/templates/scripts/work_engine/hooks/builtin/memory_visibility.ts +2 -1
  327. package/src/agent-src/templates/scripts/work_engine/hooks/settings.ts +0 -6
  328. package/src/agent-src/templates/scripts/work_engine/scoring/decision_engine.ts +9 -12
  329. package/src/agent-src/templates/scripts/work_engine/scoring/memory_visibility.ts +2 -1
  330. package/src/config/agent-settings.template.yml +79 -312
  331. package/src/config/agents-paths.yml +16 -0
  332. package/src/config/assurance-capability-registry.json +7 -3
  333. package/src/config/ci-local-parity.yml +3 -0
  334. package/src/config/continuity-surface.json +3 -3
  335. package/src/config/discovery/packs.yml +17 -1
  336. package/src/config/evaluator-budgets.json +19 -6
  337. package/src/config/gate-coverage.yml +65 -23
  338. package/src/config/gate-violation-baselines.json +53 -13
  339. package/src/config/gitignore-block.txt +19 -0
  340. package/src/config/hook-bundle-budget.json +1 -1
  341. package/src/config/release-gate-locality.yml +2 -1
  342. package/src/config/routing-coverage-seed.json +48 -6
  343. package/src/config/rule-law-ceilings.json +12 -6
  344. package/src/config/rule-obligations.json +833 -0
  345. package/src/install/installThinLayer.ts +76 -10
  346. package/src/install/installedRuleLinks.ts +105 -17
  347. package/src/scripts/_cli/cmd_analyze_session.ts +9 -15
  348. package/src/scripts/_cli/cmd_conformance.ts +13 -2
  349. package/src/scripts/_cli/cmd_doctor.ts +10 -10
  350. package/src/scripts/_cli/cmd_doctor_neighbours.ts +133 -0
  351. package/src/scripts/_cli/cmd_explain.ts +72 -14
  352. package/src/scripts/_cli/cmd_git_convention.ts +637 -0
  353. package/src/scripts/_cli/cmd_settings_check.ts +66 -8
  354. package/src/scripts/_cli/cmd_settings_get.ts +18 -3
  355. package/src/scripts/_cli/doctor_execution.ts +72 -1
  356. package/src/scripts/_dispatch.bash +37 -2
  357. package/src/scripts/_lib/agent_settings.ts +15 -124
  358. package/src/scripts/_lib/blocked_by_marker.ts +1 -1
  359. package/src/scripts/_lib/compile_time_toggles.ts +12 -21
  360. package/src/scripts/_lib/dispatch_import_closure.ts +163 -0
  361. package/src/scripts/_lib/git_base_ref.ts +92 -0
  362. package/src/scripts/_lib/git_convention.ts +291 -0
  363. package/src/scripts/_lib/git_convention_carrier.ts +389 -0
  364. package/src/scripts/_lib/git_convention_grammar.ts +246 -0
  365. package/src/scripts/_lib/git_convention_measure.ts +344 -0
  366. package/src/scripts/_lib/global_deploy_inventory.ts +74 -0
  367. package/src/scripts/_lib/graph_feeder_record.ts +236 -13
  368. package/src/scripts/_lib/installed_layer.ts +448 -23
  369. package/src/scripts/_lib/knowledge_global.ts +14 -1
  370. package/src/scripts/_lib/module_reach.ts +456 -0
  371. package/src/scripts/_lib/neighbour_contradictions.ts +236 -0
  372. package/src/scripts/_lib/neighbour_tool_use.ts +8 -10
  373. package/src/scripts/_lib/ratification_artifact.ts +220 -1
  374. package/src/scripts/_lib/ratification_subject.ts +92 -0
  375. package/src/scripts/_lib/release_findings_ingest.ts +15 -7
  376. package/src/scripts/_lib/release_highlights.ts +5 -0
  377. package/src/scripts/_lib/rule_law_section.ts +1 -1
  378. package/src/scripts/_lib/rule_obligations.ts +205 -0
  379. package/src/scripts/_lib/self_repair.ts +1 -1
  380. package/src/scripts/_lib/settings_removed_keys.ts +173 -0
  381. package/src/scripts/_lib/test_red_state.ts +5 -0
  382. package/src/scripts/_lib/thin_rules.ts +83 -3
  383. package/src/scripts/_lib/touched_file_quality.ts +142 -6
  384. package/src/scripts/_lib/worker_budget.ts +1 -1
  385. package/src/scripts/adr/regenerate_index.ts +16 -1
  386. package/src/scripts/ai_council/config.ts +7 -7
  387. package/src/scripts/ai_council/modification_review.ts +100 -0
  388. package/src/scripts/ai_council/modification_review_questions.ts +90 -0
  389. package/src/scripts/ai_council/orchestrator.ts +5 -5
  390. package/src/scripts/ai_council/spend_gate.ts +18 -7
  391. package/src/scripts/ai_team/config.ts +11 -16
  392. package/src/scripts/audit_user_type_axis.ts +20 -8
  393. package/src/scripts/bench_ab_clone.ts +1 -2
  394. package/src/scripts/bench_concern_spawn_path.ts +129 -0
  395. package/src/scripts/bench_graph_feeder_latency.ts +584 -0
  396. package/src/scripts/check_agent_artifact_location.ts +36 -0
  397. package/src/scripts/check_branch_freshness.ts +147 -24
  398. package/src/scripts/check_enforcement_coverage.ts +130 -0
  399. package/src/scripts/check_evaluator_budgets.ts +4 -0
  400. package/src/scripts/check_finding_dispositions.ts +88 -25
  401. package/src/scripts/check_gate_coverage.ts +4 -3
  402. package/src/scripts/check_gate_reachability.ts +48 -1
  403. package/src/scripts/check_generator_sync.ts +48 -0
  404. package/src/scripts/check_hook_bundle_composition.ts +107 -0
  405. package/src/scripts/check_kernel_edit_ratified.ts +86 -6
  406. package/src/scripts/check_pack_size.ts +1 -1
  407. package/src/scripts/check_release_manifest_content.ts +189 -0
  408. package/src/scripts/check_standing_rule_delivery.ts +96 -0
  409. package/src/scripts/check_suppression_hygiene.ts +2 -5
  410. package/src/scripts/ci_settle.ts +42 -5
  411. package/src/scripts/classify_merge_risk.ts +320 -0
  412. package/src/scripts/closure_scan.ts +91 -1
  413. package/src/scripts/command_suggester/settings.ts +8 -108
  414. package/src/scripts/command_suggester/types.ts +4 -5
  415. package/src/scripts/consumer_matrix.ts +102 -0
  416. package/src/scripts/context_hygiene_hook.ts +13 -23
  417. package/src/scripts/cost/preflight.mjs +12 -1
  418. package/src/scripts/council_cli.ts +7 -7
  419. package/src/scripts/dispatch_r2_reviewer.ts +24 -11
  420. package/src/scripts/explain_run.ts +8 -13
  421. package/src/scripts/generate_git_convention_grammar.ts +127 -0
  422. package/src/scripts/generate_host_cost_table.ts +20 -3
  423. package/src/scripts/handoff_context_hook.ts +86 -37
  424. package/src/scripts/hook_manifest.json +1 -1
  425. package/src/scripts/hook_manifest.yaml +25 -6
  426. package/src/scripts/hooks/block_config_weakening.ts +48 -5
  427. package/src/scripts/hooks/block_plumbing_writes.ts +8 -4
  428. package/src/scripts/hooks/concern_registry.ts +2 -0
  429. package/src/scripts/hooks/delegation_nudge_hook.ts +2 -3
  430. package/src/scripts/hooks/evidence_independence.ts +12 -4
  431. package/src/scripts/hooks/mcp_usage_observation_hook.ts +121 -0
  432. package/src/scripts/hooks/push_settle_hook.ts +4 -3
  433. package/src/scripts/hooks/rule_inject_hook.ts +44 -3
  434. package/src/scripts/hooks/state_io.ts +8 -4
  435. package/src/scripts/hooks/telemetry_usage_hook.ts +7 -46
  436. package/src/scripts/hooks/turn_end_gate_hook.ts +1 -0
  437. package/src/scripts/install-hooks.sh +42 -14
  438. package/src/scripts/install.ts +7 -31
  439. package/src/scripts/lint_blocker_citations.ts +198 -0
  440. package/src/scripts/lint_evidence_artifacts.ts +9 -0
  441. package/src/scripts/lint_hook_concern_budget.ts +10 -21
  442. package/src/scripts/lint_pack_boundaries.ts +406 -28
  443. package/src/scripts/lint_roadmap_blockers.ts +282 -29
  444. package/src/scripts/lint_roadmap_complexity.ts +4 -2
  445. package/src/scripts/lint_rule_law_section.ts +151 -21
  446. package/src/scripts/lint_rule_skill_pack_reach.ts +17 -0
  447. package/src/scripts/lint_settings_classes.ts +1 -1
  448. package/src/scripts/lint_ticked_unmet_criteria.ts +165 -0
  449. package/src/scripts/lint_workflow_security.ts +12 -1
  450. package/src/scripts/measure_skill_ranker_baseline.ts +5 -0
  451. package/src/scripts/model_rule_injection.ts +3 -3
  452. package/src/scripts/onboarding_gate_hook.ts +7 -6
  453. package/src/scripts/print_required_checks.ts +15 -3
  454. package/src/scripts/probe_host_compliance.ts +33 -5
  455. package/src/scripts/probe_turnaround.ts +183 -3
  456. package/src/scripts/ratification_header.ts +77 -0
  457. package/src/scripts/refusal_envelope.ts +138 -0
  458. package/src/scripts/release_publication.ts +29 -3
  459. package/src/scripts/report_dispatch_import_closure.ts +76 -0
  460. package/src/scripts/report_installed_rule_links.ts +118 -1
  461. package/src/scripts/report_module_reach.ts +212 -0
  462. package/src/scripts/report_obligation_mechanism.ts +16 -18
  463. package/src/scripts/report_parked_blockers.ts +222 -0
  464. package/src/scripts/report_required_checks_drift.ts +196 -0
  465. package/src/scripts/report_skill_ranker_confusion.ts +103 -2
  466. package/src/scripts/report_standing_payload_by_host.ts +1 -1
  467. package/src/scripts/routing_doctor.ts +2 -2
  468. package/src/scripts/schemas/agent-settings.schema.json +17 -31
  469. package/src/scripts/schemas/command.schema.json +1 -1
  470. package/src/scripts/schemas/skill.schema.json +1 -1
  471. package/src/scripts/self_review_gate.ts +39 -2
  472. package/src/scripts/skill_tools/score_skill_relevance.ts +28 -19
  473. package/src/scripts/sync_pr_branch.ts +403 -132
  474. package/src/scripts/trigger_eval_grandfather.json +0 -16
  475. package/src/server/schemas/settings.ts +33 -177
  476. package/src/shared/skillRanking.ts +53 -4
  477. package/dist/cli-delegate/chunk-NYX3L2PZ.js +0 -99
  478. package/src/scripts/_lib/config_chain.ts +0 -477
  479. package/src/scripts/_lib/conformance_report.ts +0 -403
  480. package/src/scripts/_lib/eval_discrimination.ts +0 -95
  481. package/src/scripts/_lib/evaluator_promotion.ts +0 -225
  482. package/src/scripts/_lib/file_slicer.ts +0 -117
  483. package/src/scripts/_lib/legacy_boundary_map.ts +0 -228
  484. package/src/scripts/_lib/minimality_tiebreak.ts +0 -168
  485. package/src/scripts/_lib/overbuild_lens_contract.ts +0 -196
  486. package/src/scripts/_lib/role_split.ts +0 -338
@@ -9,7 +9,6 @@ triggers:
9
9
  - keyword: "convention"
10
10
  workspaces: [agent-config-maintainer, engineering]
11
11
  packs: [meta]
12
- # obligation: line 16
13
12
  obligation_frequency: "per-edit"
14
13
  ---
15
14
 
@@ -19,7 +19,6 @@ workspaces: [engineering]
19
19
  packs: [history-discipline]
20
20
  trust:
21
21
  level: professional
22
- # obligation: line 35
23
22
  obligation_frequency: "per-edit"
24
23
  ---
25
24
 
@@ -16,7 +16,6 @@ applies_to_user_types:
16
16
  self_contained: true
17
17
  workspaces: [engineering]
18
18
  packs: [frontend-design]
19
- # obligation: line 41
20
19
  obligation_frequency: "per-edit"
21
20
  ---
22
21
 
@@ -23,7 +23,6 @@ collision_ok:
23
23
  "/image:": "rights/likeness gate on the image-generation surface"
24
24
  "likeness": "its own core subject — the rights gate"
25
25
  "scripts/ai-image/adapters/": "adapter edits touch the likeness-gated generation path"
26
- # obligation: line 32
27
26
  obligation_frequency: "per-event"
28
27
  ---
29
28
 
@@ -20,7 +20,6 @@ collision_ok:
20
20
  "migration": "a migration is a significant behavioural change — the pre-implementation checks apply"
21
21
  "refactor": "refactor = significant change; the demand gate + three checks apply"
22
22
  "implement": "its own core trigger — pre-implementation validation"
23
- # obligation: line 45
24
23
  obligation_frequency: "per-task"
25
24
  ---
26
25
 
@@ -12,7 +12,6 @@ triggers:
12
12
  self_contained: true
13
13
  workspaces: [agent-config-maintainer, engineering]
14
14
  packs: [meta]
15
- # obligation: line 62
16
15
  obligation_frequency: "per-task"
17
16
  ---
18
17
 
@@ -20,7 +20,6 @@ collision_ok:
20
20
  "artisan": "artisan is a Laravel-flavoured PHP routing cue — load the laravel skill"
21
21
  "eloquent": "eloquent is a Laravel routing cue"
22
22
  "formrequest": "FormRequest is a Laravel routing cue"
23
- # obligation: line 29
24
23
  obligation_frequency: "none"
25
24
  ---
26
25
 
@@ -28,5 +27,5 @@ obligation_frequency: "none"
28
27
 
29
28
  **Iron Law.** Laravel-flavoured PHP → `laravel`. Discriminator: entry point and router, not the dependency list — `illuminate/*` with no skeleton marker is the third verdict.
30
29
 
31
- Body migrated to `skill:laravel`. Disambiguates the laravel ↔ symfony-workflow cluster head per [`adr-architectural-consensus-mechanism`](../docs/contracts/adr-architectural-consensus-mechanism.md).
30
+ Body migrated to `skill:laravel`. Disambiguates the laravel ↔ symfony-workflow cluster head per `docs/contracts/adr-architectural-consensus-mechanism.md`.
32
31
  Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -16,7 +16,6 @@ trust:
16
16
  install:
17
17
  default: false
18
18
  removable: true
19
- # obligation: line 23
20
19
  obligation_frequency: "per-edit"
21
20
  ---
22
21
 
@@ -32,7 +32,6 @@ trust:
32
32
  collision_ok:
33
33
  "controller": "'controller' is a GDPR role term (controller/processor) in the legal pack"
34
34
  "review this contract": "the legal-pack contract-review gate — both floors must fire"
35
- # obligation: line 103
36
35
  obligation_frequency: "per-task"
37
36
  ---
38
37
  <!-- agent-config:human-review-banner -->
@@ -21,7 +21,6 @@ enforced_by:
21
21
  collision_ok:
22
22
  "src/skills/": "skill authoring reviews tool grants and the egress leg"
23
23
  "src/agent-src/commands/": "command authoring reviews the three trifecta legs"
24
- # obligation: line 60
25
24
  obligation_frequency: "per-edit"
26
25
  evidence:
27
26
  source_type: external-standard
@@ -23,7 +23,6 @@ trust:
23
23
  confidence: medium
24
24
  install:
25
25
  removable: true
26
- # obligation: line 30
27
26
  obligation_frequency: "per-session"
28
27
  ---
29
28
 
@@ -12,7 +12,6 @@ triggers:
12
12
  self_contained: true
13
13
  workspaces: [agent-config-maintainer]
14
14
  packs: [meta]
15
- # obligation: line 28
16
15
  obligation_frequency: "per-edit"
17
16
  ---
18
17
 
@@ -9,7 +9,6 @@ triggers:
9
9
  self_contained: true
10
10
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
11
11
  packs: [meta]
12
- # obligation: line 23
13
12
  obligation_frequency: "per-turn"
14
13
  ---
15
14
 
@@ -33,7 +33,6 @@ collision_ok:
33
33
  "/audio:": "routes the media policy layer for audio surfaces"
34
34
  "/video:": "routes the media policy layer for video surfaces"
35
35
  "likeness": "likeness prompts must load the policy layer before generation"
36
- # obligation: line 43
37
36
  obligation_frequency: "per-event"
38
37
  ---
39
38
 
@@ -87,4 +86,4 @@ A policy that no skill, rule, or sibling policy references is a silent policy. T
87
86
 
88
87
  - `agents/settings/policies/media/README.md` — the full enforcement-model contract.
89
88
  - [`ask-when-uncertain`](ask-when-uncertain.md) — the single-question refusal-path discipline every policy depends on.
90
- - [`docs/contracts/write-engine.md`](../docs/contracts/write-engine.md) — the prose-disclosure precedent extended to media by `agents/settings/policies/media/disclosure.md`.
89
+ - `docs/contracts/write-engine.md` — the prose-disclosure precedent extended to media by `agents/settings/policies/media/disclosure.md`.
@@ -17,7 +17,6 @@ triggers:
17
17
  self_contained: true
18
18
  workspaces: [agent-config-maintainer, engineering, gtm]
19
19
  packs: [ai-video]
20
- # obligation: line 31
21
20
  obligation_frequency: "per-event"
22
21
  ---
23
22
 
@@ -17,7 +17,6 @@ enforced_by:
17
17
  - "hook:minimal-safe-diff"
18
18
  collision_ok:
19
19
  "fix": "a fix is the smallest change that solves the stated problem"
20
- # obligation: line 25
21
20
  obligation_frequency: "per-edit"
22
21
  ---
23
22
 
@@ -15,7 +15,6 @@ applies_to_user_types:
15
15
  self_contained: true
16
16
  workspaces: [engineering]
17
17
  packs: [meta]
18
- # obligation: line 41
19
18
  enforced_by:
20
19
  - "instruction-only: nothing can observe an agent concluding that no skill exists; the skill-route concern covers only the prompts where the ranker is confident"
21
20
  obligation_frequency: "per-turn"
@@ -9,7 +9,6 @@ routes_to:
9
9
  - "guideline:agent-infra/missing-tool-handling"
10
10
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
11
11
  packs: [meta]
12
- # obligation: line 16
13
12
  obligation_frequency: "per-event"
14
13
  ---
15
14
 
@@ -13,7 +13,6 @@ routes_to:
13
13
  - "guideline:agent-infra/model-recommendation"
14
14
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
15
15
  packs: [meta]
16
- # obligation: line 4
17
16
  obligation_frequency: "per-task"
18
17
  ---
19
18
 
@@ -0,0 +1,64 @@
1
+ ---
2
+ type: "auto"
3
+ tier: "2b"
4
+ description: "A neighbour package's skill, always-on text or MCP tool text disagrees with this suite or the project — follow the source order below the four authority bands; name what you followed"
5
+ triggers:
6
+ - phrase: "neighbour skill"
7
+ - phrase: "neighbor skill"
8
+ - phrase: "conflicting instructions"
9
+ - phrase: "which instruction wins"
10
+ - phrase: "instruction precedence"
11
+ - phrase: "another package's rule"
12
+ - phrase: "widersprüchliche anweisungen"
13
+ enforced_by:
14
+ - "instruction-only: the order is prose and a neighbour's prose can outvote it; only the listed effects hold"
15
+ obligation_frequency: "per-turn"
16
+ self_contained: true
17
+ workspaces: [engineering, agent-config-maintainer]
18
+ packs: [meta]
19
+ ---
20
+
21
+ # Neighbour Precedence
22
+
23
+ ## The Iron Law
24
+
25
+ ```
26
+ THE FOUR BANDS OF agent-authority COME FIRST AND NOTHING BELOW LIFTS THEM.
27
+ BELOW THEM, FOLLOW THE SOURCE ORDER. THE PROJECT FILE WINS TIES.
28
+ NAME THE INSTRUCTION YOU FOLLOWED, ONCE PER TURN, WHEN SOURCES DISAGREED.
29
+ A NEIGHBOUR'S "DONE" IS A PROVIDER STATUS, NEVER THIS SUITE'S COMPLETION.
30
+ ```
31
+
32
+ ## The source order — instruction sources, below the bands
33
+
34
+ 1. the current-turn instruction (never lifts band 1, the Hard Floor, of [`agent-authority`](agent-authority.md))
35
+ 2. `agents/overrides/`
36
+ 3. the project's own instruction files and `agents/` folder
37
+ 4. this suite's routed guidance
38
+ 5. a neighbour skill body the agent explicitly invoked
39
+ 6. a neighbour's always-on text
40
+ 7. a neighbour skill body merely discoverable
41
+ 8. a neighbour MCP tool description
42
+
43
+ A project file (rank 3) may replace, override or extend workflow; it may never
44
+ lower a floor of the four bands. One global install of this suite is the
45
+ preferred shape — the order does not presume a project-local install. Overlapping
46
+ neighbour skills stay **visible**: rank decides which instruction is followed,
47
+ never which skill is shown (decision D13, K16).
48
+
49
+ ## A neighbour's completion signal
50
+
51
+ A neighbour's "done" or "all checks passed" is a provider status — evidence,
52
+ never completion, which stays with the stop gate and `verify-before-complete`.
53
+
54
+ ## Non-negotiables are effects
55
+
56
+ What this suite guarantees against a neighbour is only what it enforces as an
57
+ effect: a fail-closed `permission` concern (honoured as a deny on `claude`) or
58
+ the stop gate's refusal. Everything else here is prose and may be outvoted.
59
+
60
+ | Obligation | Effect |
61
+ |---|---|
62
+ | no hook-skipping commit flag; no agent write to a kernel rule or hook plumbing | fail-closed denies: `block-no-verify`, `block-kernel-rule-writes`, `block-plumbing-writes` |
63
+ | no promissory close, no unverified edit, no completion claim without evidence, no dropped pending decision, reply language | `turn-end-gate` refusal (exit 2) — allowed through when a neighbour set `stop_hook_active` |
64
+ | never commit unasked · never push, merge or deploy without this-turn confirmation · one question per turn (`one-question-per-ask` fails open) · threat-model a security surface first · this source order itself | prose-only — may be outvoted |
@@ -8,7 +8,6 @@ triggers:
8
8
  self_contained: true
9
9
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
10
10
  packs: [meta]
11
- # obligation: line 18
12
11
  obligation_frequency: "per-commit"
13
12
  ---
14
13
 
@@ -17,7 +17,6 @@ triggers:
17
17
  self_contained: true
18
18
  workspaces: [agent-config-maintainer, engineering]
19
19
  packs: [meta]
20
- # obligation: line 27
21
20
  obligation_frequency: "per-commit"
22
21
  ---
23
22
 
@@ -10,7 +10,6 @@ triggers:
10
10
  self_contained: true
11
11
  workspaces: [agent-config-maintainer, engineering]
12
12
  packs: [meta]
13
- # obligation: line 20
14
13
  obligation_frequency: "per-commit"
15
14
  ---
16
15
 
@@ -17,7 +17,6 @@ enforced_by:
17
17
  - "validator:src/scripts/check_council_references.ts"
18
18
  collision_ok:
19
19
  "agents/roadmaps/": "roadmap edits are where transient-ref links get written"
20
- # obligation: line 47
21
20
  obligation_frequency: "per-edit"
22
21
  ---
23
22
 
@@ -17,7 +17,6 @@ workspaces: [agent-config-maintainer, engineering]
17
17
  packs: [meta]
18
18
  collision_ok:
19
19
  "debug": "debug hypotheses belong in the session notes file"
20
- # obligation: line 35
21
20
  obligation_frequency: "per-turn"
22
21
  ---
23
22
 
@@ -11,7 +11,6 @@ workspaces: [agent-config-maintainer, construction, engineering, finance, founde
11
11
  packs: [meta]
12
12
  enforced_by:
13
13
  - "hook:onboarding-gate"
14
- # obligation: line 18
15
14
  obligation_frequency: "per-session"
16
15
  ---
17
16
 
@@ -12,7 +12,6 @@ workspaces: [engineering]
12
12
  packs: [engineering-base]
13
13
  enforced_by:
14
14
  - "validator:src/scripts/lint_output_slop.ts"
15
- # obligation: line 22
16
15
  obligation_frequency: "per-edit"
17
16
  ---
18
17
 
@@ -10,7 +10,6 @@ routes_to:
10
10
  - "skill:lint-skills"
11
11
  workspaces: [agent-config-maintainer]
12
12
  packs: [meta]
13
- # obligation: line 17
14
13
  obligation_frequency: "per-commit"
15
14
  ---
16
15
 
@@ -27,7 +27,6 @@ workspaces: [agent-config-maintainer]
27
27
  packs: [meta]
28
28
  enforced_by:
29
29
  - "validator:src/scripts/lint_persona_governance.ts"
30
- # obligation: line 41
31
30
  obligation_frequency: "per-edit"
32
31
  ---
33
32
 
@@ -42,12 +41,12 @@ NO NEW SPECIALIST WITHOUT A DEPRECATION CANDIDATE WHEN THE DOMAIN IS FULL.
42
41
 
43
42
  Fires on creating, editing, or proposing a persona (review lens) — the four discipline checks: **1. per-domain cap (≤ 2 specialists)** · **2. skill citation floor (≥ 1 cite)** · **3. deprecation path (delete + record in commit)** · **4. schema conformance (skill linter)**.
44
43
 
45
- Body migrated to [`docs/contracts/persona-schema.md § 8`](../docs/contracts/persona-schema.md#-8--governance-discipline-the-four-checks) (per P4 of `road-to-kernel-and-router.md`) — the four checks' detail tables, failure modes, day-one state.
44
+ Body migrated to `docs/contracts/persona-schema.md` § 8 (per P4 of `road-to-kernel-and-router.md`) — the four checks' detail tables, failure modes, day-one state.
46
45
  Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
47
46
 
48
47
  ## See also
49
48
 
50
- - [`docs/contracts/persona-schema.md`](../docs/contracts/persona-schema.md) — schema lock, tiers, sections, size budgets, linter enforcement surface, and the migrated governance checks (§ 8).
49
+ - `docs/contracts/persona-schema.md` — schema lock, tiers, sections, size budgets, linter enforcement surface, and the migrated governance checks (§ 8).
51
50
  - `docs/personas.md` — active persona catalog, citation map, ownership column.
52
51
  - [`ai-council`](../skills/ai-council/SKILL.md) — neutral second-opinion mechanism used for merge / deprecation decisions.
53
52
  - [`skill-quality`](skill-quality.md) — sibling discipline rule for skill files.
@@ -18,7 +18,6 @@ install:
18
18
  removable: true
19
19
  collision_ok:
20
20
  "phpstan": "phpstan findings are the PHP pattern floor's own quality surface"
21
- # obligation: line 25
22
21
  obligation_frequency: "per-edit"
23
22
  ---
24
23
 
@@ -15,7 +15,6 @@ packs: [engineering-base]
15
15
  collision_ok:
16
16
  "migration": "migrations add columns — multi-state fields should land as enums from the start"
17
17
  "category": "a category field is the canonical enum candidate"
18
- # obligation: line 27
19
18
  obligation_frequency: "per-edit"
20
19
  ---
21
20
 
@@ -15,7 +15,6 @@ packs: [meta]
15
15
  enforced_by:
16
16
  - "validator:src/scripts/check_condensation.ts"
17
17
  - "validator:src/scripts/skill_linter.ts"
18
- # obligation: line 22
19
18
  obligation_frequency: "per-edit"
20
19
  ---
21
20
 
@@ -30,7 +30,6 @@ collision_ok:
30
30
  "/audio:": "provider-tier gate for audio providers"
31
31
  "/video:": "provider-tier gate for video providers"
32
32
  "scripts/ai-image/adapters/": "adapter edits are the lifecycle contract's surface"
33
- # obligation: line 41
34
33
  obligation_frequency: "per-event"
35
34
  ---
36
35
 
@@ -48,12 +47,12 @@ Fires whenever a `/video:* / /image:* / /audio:*` surface fires, an adapter unde
48
47
  - **Read the tier before picking** — the `<lifecycle>` element in the provider XML AND the adapter's `Lifecycle:` header comment; a mismatch is a contract violation.
49
48
  - **Refuse-and-surface on non-stable** — name the tier, emit ONE clarifying question (per [`ask-when-uncertain`](ask-when-uncertain.md)); no silent default.
50
49
 
51
- Body migrated to [`docs/contracts/provider-lifecycle.md § 4–4b`](../docs/contracts/provider-lifecycle.md#-4--agent-obligations) (per P4 of `road-to-kernel-and-router.md`) — the five enforcement points' detail, agent-side failure modes, day-one state (§ 5), why-agent-in-the-loop rationale.
50
+ Body migrated to `docs/contracts/provider-lifecycle.md` § 4–4b (per P4 of `road-to-kernel-and-router.md`) — the five enforcement points' detail, agent-side failure modes, day-one state (§ 5), why-agent-in-the-loop rationale.
52
51
  Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
53
52
 
54
53
  ## See also
55
54
 
56
- - [`docs/contracts/provider-lifecycle.md`](../docs/contracts/provider-lifecycle.md) — the full tier definitions, promotion / demotion criteria, day-one assignment matrix, and the migrated enforcement detail (§ 4–4b).
55
+ - `docs/contracts/provider-lifecycle.md` — the full tier definitions, promotion / demotion criteria, day-one assignment matrix, and the migrated enforcement detail (§ 4–4b).
57
56
  - `src/scripts/media/lib/adapter-contract.md` — the four-method shell surface every adapter implements; the tier tag is read alongside this contract.
58
57
  - [`media-governance-routing`](media-governance-routing.md) — sibling tier-2a rule that surfaces the prompt-side policy layer; this rule covers the provider-side discipline.
59
58
  - [`ask-when-uncertain`](ask-when-uncertain.md) — the one-question-per-turn discipline the refuse-and-surface path uses.
@@ -25,7 +25,6 @@ applies_to_user_types:
25
25
  self_contained: true
26
26
  workspaces: [engineering]
27
27
  packs: [meta]
28
- # obligation: line 32
29
28
  obligation_frequency: "per-turn"
30
29
  ---
31
30
 
@@ -13,7 +13,6 @@ routes_to:
13
13
  workspaces: [agent-config-maintainer, engineering]
14
14
  packs: [meta]
15
15
  roles: [reviewer]
16
- # obligation: line 20
17
16
  obligation_frequency: "per-commit"
18
17
  ---
19
18
 
@@ -30,7 +30,6 @@ packs: [meta]
30
30
  roles: [planner]
31
31
  collision_ok:
32
32
  "agents/roadmaps/": "roadmap steps must not schedule CI-shaped gates"
33
- # obligation: line 41
34
33
  obligation_frequency: "per-edit"
35
34
  ---
36
35
 
@@ -22,7 +22,6 @@ enforced_by:
22
22
  - "hook:roadmap-progress"
23
23
  collision_ok:
24
24
  "agents/roadmaps/": "any roadmap touch regenerates the dashboard, same response"
25
- # obligation: line 26
26
25
  obligation_frequency: "per-edit"
27
26
  ---
28
27
 
@@ -150,11 +149,9 @@ Before sending any reply that landed roadmap work:
150
149
  line at `agents/tmp.old/<name>`. A consumed inbox file left in
151
150
  `agents/tmp/` is a rule violation, not tidiness. Move ONLY the file(s)
152
151
  explicitly named as input — never sweep the rest of the inbox.
153
- 3. Is regen due now per `roadmap.dashboard_regen_cadence`?
154
- - `per_step` → yes, always.
155
- - `every_5_steps` → yes when this is the 5th, 10th, … closed step in the run, or the last step of the reply.
156
- - `phase_boundary` → only when this reply closes the phase or run.
157
- - Any file-shape touch (rename / phase add / archive) → yes, regardless of cadence.
152
+ 3. Is regen due now? The cadence is fixed: yes when this is the 5th, 10th, … closed
153
+ step in the run, the last step of the reply, or a phase boundary — and on any
154
+ file-shape touch (rename / phase add / archive), regardless.
158
155
  If yes and not run yet → run `./agent-config roadmap:progress`, then continue.
159
156
  4. Did `count_open` reach 0?
160
157
  - **No (real open work remains)** → continue normally.
@@ -9,7 +9,6 @@ triggers:
9
9
  self_contained: true
10
10
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
11
11
  packs: [meta]
12
- # obligation: line 23
13
12
  obligation_frequency: "per-turn"
14
13
  ---
15
14
 
@@ -8,7 +8,6 @@ workspaces: [agent-config-maintainer]
8
8
  packs: [meta]
9
9
  collision_ok:
10
10
  "src/rules/": "the always-vs-auto choice fires on every rule edit"
11
- # obligation: line 17
12
11
  obligation_frequency: "per-edit"
13
12
  ---
14
13
 
@@ -11,7 +11,6 @@ triggers:
11
11
  self_contained: true
12
12
  workspaces: [agent-config-maintainer, engineering]
13
13
  packs: [meta]
14
- # obligation: line 32
15
14
  obligation_frequency: "per-edit"
16
15
  ---
17
16
 
@@ -26,7 +26,6 @@ trust:
26
26
  collision_ok:
27
27
  "migration": "R-A6 migration-safety owns reversibility/index/retention rules"
28
28
  "schema": "schema change routes the persistence pack floor (R-A6/R-A2)"
29
- # obligation: line 41
30
29
  obligation_frequency: "per-edit"
31
30
  ---
32
31
 
@@ -28,7 +28,6 @@ enforced_by:
28
28
  - "validator:src/scripts/check_secret_leak.ts"
29
29
  collision_ok:
30
30
  "commit": "committing is the credential-leak moment this guard exists for"
31
- # obligation: line 43
32
31
  obligation_frequency: "per-edit"
33
32
  evidence:
34
33
  source_type: own-analysis
@@ -29,7 +29,6 @@ enforced_by:
29
29
  - "instruction-only: threat-model-before-you-edit is a pre-edit reasoning step only the model observes"
30
30
  collision_ok:
31
31
  "tenant": "tenancy is a threat-model-before-edit surface"
32
- # obligation: line 36
33
32
  obligation_frequency: "per-edit"
34
33
  evidence:
35
34
  source_type: own-analysis
@@ -14,7 +14,6 @@ workspaces: [agent-config-maintainer, construction, engineering, finance, founde
14
14
  packs: [meta]
15
15
  enforced_by:
16
16
  - "hook:self-repair"
17
- # obligation: line 28
18
17
  obligation_frequency: "per-turn"
19
18
  ---
20
19
 
@@ -25,7 +25,6 @@ collision_ok:
25
25
  "implement": "implementation = the invisible-controls checklist"
26
26
  "endpoint": "endpoint row of the surface-to-controls table"
27
27
  "component": "component work = generalize + reuse duty"
28
- # obligation: line 69
29
28
  obligation_frequency: "per-edit"
30
29
  ---
31
30
 
@@ -15,7 +15,6 @@ workspaces: [agent-config-maintainer, construction, engineering, finance, founde
15
15
  packs: [meta]
16
16
  enforced_by:
17
17
  - "hook:session-canary"
18
- # obligation: line 33
19
18
  obligation_frequency: "per-task"
20
19
  # frequency-override: the per-turn phrases in the body describe the CARRIER
21
20
  # (a per-turn beat is the closest reachable cover for a per-task obligation),
@@ -25,7 +25,6 @@ enforced_by:
25
25
  - "instruction-only: no gate counts the questions in a chat turn; settings:set fences the illegal WRITE, never the badly-shaped ask"
26
26
  collision_ok:
27
27
  "canary_name": "the nickname ask is this protocol's canonical B-class instance — session-canary owns what the NAME then does and which layers already supply it, this rule owns how it is asked for and where the answer goes"
28
- # obligation: line 39
29
28
  obligation_frequency: "per-task"
30
29
  # frequency-override: the per-turn phrase at line 175 is a See-also cross-reference to
31
30
  # ask-when-uncertain's rule, not this rule's own obligation, which is per command execution.
@@ -34,7 +33,7 @@ obligation_frequency: "per-task"
34
33
  # Settings-Ask Protocol
35
34
 
36
35
  A settings question is the one ask where the agent poses the question *and* owns
37
- where the answer goes. Seven keys can produce one, in two mechanisms that look
36
+ where the answer goes. Five keys can produce one, in two mechanisms that look
38
37
  identical from outside and differ completely underneath.
39
38
 
40
39
  ## The Iron Law
@@ -70,7 +69,7 @@ How long it stays cached in working state is the key's own business, and several
70
69
  keys state their own scope. Reading the C path as "re-ask every execution" would
71
70
  turn a fence against illegal writes into a source of extra questions.
72
71
 
73
- ## The seven keys
72
+ ## The five keys
74
73
 
75
74
  **Class B — persist once**: `personal.canary_name` ·
76
75
  `personal.open_edited_files` · `memory.learn_on_session_end`. Each ships a
@@ -78,8 +77,8 @@ conservative default (`""`, `false`, `false`), so absent is indistinguishable
78
77
  from *no* and never from *yes*.
79
78
 
80
79
  **Class C carrying an `ask` value in its own enum** — a runtime question whose
81
- answer dies with the run: `tokens.rich_skills`,
82
- `subagents.adversarial_council`, `decision_engine.on_block`. **None of them
80
+ answer dies with the run: `subagents.adversarial_council`,
81
+ `decision_engine.on_block`. **None of them
83
82
  ships as `ask`** — a human sets it, so the whole class is opt-in and no shipped
84
83
  default routes a question through this protocol at all.
85
84
 
@@ -180,7 +179,7 @@ only a badly-shaped *ask*.
180
179
 
181
180
  ## See also
182
181
 
183
- - [`docs/contracts/settings-classes.md`](../docs/contracts/settings-classes.md) — the A/B/C source of truth; slot 4 is read from it.
182
+ - `docs/contracts/settings-classes.md` — the A/B/C source of truth; slot 4 is read from it.
184
183
  - [`ask-when-uncertain`](ask-when-uncertain.md) — one question per turn; this narrows it to one *settings* question per execution.
185
184
  - [`no-cheap-questions`](no-cheap-questions.md) — the floor a settings question clears before it is asked at all.
186
185
  - [`user-interaction`](user-interaction.md) — the numbered-options shape slot 3 uses.
@@ -5,7 +5,6 @@ description: "Creating or editing rules, skills, commands, guidelines, AGENTS.md
5
5
  alwaysApply: false
6
6
  workspaces: [agent-config-maintainer]
7
7
  packs: [meta]
8
- # obligation: line 21
9
8
  obligation_frequency: "per-edit"
10
9
  ---
11
10
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "After a meaningful task — trigger post-task learning capture if pipelines.skill_improvement is enabled"
4
+ description: "After a meaningful task — trigger the post-task learning capture; it proposes, the user confirms"
5
5
  triggers:
6
6
  - phrase: "after completing"
7
7
  - keyword: "improvement"
@@ -10,13 +10,12 @@ routes_to:
10
10
  - "skill:skill-improvement-pipeline"
11
11
  workspaces: [agent-config-maintainer, engineering]
12
12
  packs: [meta]
13
- # obligation: line 17
14
13
  obligation_frequency: "per-task"
15
14
  ---
16
15
 
17
16
  # Skill Improvement Trigger
18
17
 
19
- **Iron Law.** After a meaningful task, trigger the post-task learning capture if `pipelines.skill_improvement` is enabled.
18
+ **Iron Law.** After a meaningful task, trigger the post-task learning capture — always on; it is a proposal the user confirms.
20
19
 
21
20
  Body migrated to `skill:skill-improvement-pipeline` (per P4 of `road-to-kernel-and-router.md`).
22
21
  Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -10,7 +10,6 @@ enforced_by:
10
10
  - "validator:src/scripts/skill_linter.ts"
11
11
  collision_ok:
12
12
  "src/skills/": "every skill edit passes the executable-quality floor"
13
- # obligation: line 14
14
13
  obligation_frequency: "per-edit"
15
14
  ---
16
15
 
@@ -11,7 +11,6 @@ routes_to:
11
11
  - "skill:command-routing"
12
12
  workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
13
13
  packs: [meta]
14
- # obligation: line 18
15
14
  obligation_frequency: "per-turn"
16
15
  ---
17
16