@event4u/agent-config 7.5.0 → 8.1.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 (429) hide show
  1. package/.claude-plugin/marketplace.json +8 -1
  2. package/AGENTS.md +9 -9
  3. package/CHANGELOG.md +317 -260
  4. package/README.md +35 -5
  5. package/dist/agent-src/commands/analytics/prune.md +1 -1
  6. package/dist/agent-src/commands/analytics/show.md +1 -1
  7. package/dist/agent-src/commands/analyze/decision.md +2 -2
  8. package/dist/agent-src/commands/analyze/incident.md +2 -2
  9. package/dist/agent-src/commands/analyze/near-miss.md +2 -2
  10. package/dist/agent-src/commands/analyze/postmortem.md +2 -2
  11. package/dist/agent-src/commands/analyze/premortem.md +2 -2
  12. package/dist/agent-src/commands/cost-report.md +25 -0
  13. package/dist/agent-src/commands/evals/analyze.json +30 -0
  14. package/dist/agent-src/commands/evals/mission-upgrade.json +30 -0
  15. package/dist/agent-src/commands/implement-ticket.md +1 -1
  16. package/dist/agent-src/commands/knowledge/forget.md +1 -1
  17. package/dist/agent-src/commands/knowledge/ingest.md +1 -1
  18. package/dist/agent-src/commands/knowledge/list.md +1 -1
  19. package/dist/agent-src/commands/memory/load.md +12 -11
  20. package/dist/agent-src/commands/memory/promote.md +30 -0
  21. package/dist/agent-src/commands/memory/propose.md +16 -2
  22. package/dist/agent-src/commands/mission/upgrade.md +1 -1
  23. package/dist/agent-src/commands/module/explore.md +11 -7
  24. package/dist/agent-src/commands/optimize-project.md +243 -0
  25. package/dist/agent-src/commands/optimize.md +5 -0
  26. package/dist/agent-src/commands/pr/create.md +37 -8
  27. package/dist/agent-src/commands/prediction-pool.md +2 -2
  28. package/dist/agent-src/commands/profile/activate.md +3 -3
  29. package/dist/agent-src/commands/profile/deactivate.md +2 -2
  30. package/dist/agent-src/commands/profile/show.md +3 -3
  31. package/dist/agent-src/commands/research/deep.md +5 -0
  32. package/dist/agent-src/commands/research/report.md +2 -1
  33. package/dist/agent-src/commands/roadmap/create.md +88 -10
  34. package/dist/agent-src/commands/roadmap/materialize.md +1 -1
  35. package/dist/agent-src/commands/roadmap/process-full.md +15 -2
  36. package/dist/agent-src/commands/roadmap/process-phase.md +18 -6
  37. package/dist/agent-src/commands/roadmap/process-step.md +4 -0
  38. package/dist/agent-src/commands/roadmap.md +1 -1
  39. package/dist/agent-src/commands/security-audit-config.md +1 -1
  40. package/dist/agent-src/commands/sync-agent-settings.md +1 -1
  41. package/dist/agent-src/commands/sync-gitignore/fix.md +42 -6
  42. package/dist/agent-src/commands/team-knowledge/bootstrap.md +106 -0
  43. package/dist/agent-src/commands/team-knowledge/consolidate.md +105 -0
  44. package/dist/agent-src/commands/team-knowledge.md +64 -0
  45. package/dist/agent-src/contexts/authority/commit-mechanics.md +8 -0
  46. package/dist/agent-src/contexts/authority/destructive-mechanics.md +11 -0
  47. package/dist/agent-src/contexts/authority/scope-mechanics.md +25 -0
  48. package/dist/agent-src/contexts/communication/rules-auto/reply-close-mechanics.md +43 -0
  49. package/dist/agent-src/contexts/contracts/agents-md-anatomy.md +1 -1
  50. package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +2 -2
  51. package/dist/agent-src/contexts/contracts/frugality-charter.md +1 -0
  52. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +14 -4
  53. package/dist/agent-src/contexts/execution/autonomy-mechanics.md +11 -0
  54. package/dist/agent-src/contexts/execution/orchestration-telemetry.md +32 -8
  55. package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +107 -0
  56. package/dist/agent-src/contexts/execution/roadmap-process-loop.md +71 -15
  57. package/dist/agent-src/contexts/execution/subagent-steering.md +41 -1
  58. package/dist/agent-src/contexts/override-system.md +1 -1
  59. package/dist/agent-src/personas/brand-strategist.md +0 -1
  60. package/dist/agent-src/personas/data-integrity.md +66 -0
  61. package/dist/agent-src/personas/design-director.md +0 -1
  62. package/dist/agent-src/personas/performance-engineer.md +66 -0
  63. package/dist/agent-src/personas/production-validator.md +73 -0
  64. package/dist/agent-src/rules/agent-authority.md +3 -4
  65. package/dist/agent-src/rules/analysis-skill-routing.md +3 -5
  66. package/dist/agent-src/rules/architecture.md +2 -4
  67. package/dist/agent-src/rules/artifact-drafting-protocol.md +35 -6
  68. package/dist/agent-src/rules/artifact-engagement-recording.md +2 -4
  69. package/dist/agent-src/rules/ask-when-uncertain.md +10 -14
  70. package/dist/agent-src/rules/augment-edit-discipline.md +3 -5
  71. package/dist/agent-src/rules/autonomous-execution.md +3 -5
  72. package/dist/agent-src/rules/brand-consistency.md +3 -5
  73. package/dist/agent-src/rules/brand-source-of-truth.md +3 -5
  74. package/dist/agent-src/rules/cli-output-handling.md +4 -6
  75. package/dist/agent-src/rules/command-suggestion-policy.md +3 -5
  76. package/dist/agent-src/rules/commit-conventions.md +3 -5
  77. package/dist/agent-src/rules/commit-policy.md +18 -10
  78. package/dist/agent-src/rules/content-quoting-floor.md +88 -0
  79. package/dist/agent-src/rules/context-hygiene.md +3 -5
  80. package/dist/agent-src/rules/copilot-routing.md +4 -6
  81. package/dist/agent-src/rules/decision-revisit-gate.md +120 -0
  82. package/dist/agent-src/rules/delegation-policy.md +10 -6
  83. package/dist/agent-src/rules/design-fidelity.md +3 -5
  84. package/dist/agent-src/rules/devcontainer-routing.md +4 -6
  85. package/dist/agent-src/rules/direct-answers.md +13 -17
  86. package/dist/agent-src/rules/docker-commands.md +3 -5
  87. package/dist/agent-src/rules/domain-adoption-policy.md +3 -5
  88. package/dist/agent-src/rules/domain-safety-disclaimer.md +3 -5
  89. package/dist/agent-src/rules/domain-safety-pii.md +3 -5
  90. package/dist/agent-src/rules/domain-safety-retention.md +3 -5
  91. package/dist/agent-src/rules/downstream-changes.md +3 -4
  92. package/dist/agent-src/rules/engineering-safety-floor.md +3 -5
  93. package/dist/agent-src/rules/external-reference-deep-dive.md +3 -5
  94. package/dist/agent-src/rules/fast-path-marker-visibility.md +3 -5
  95. package/dist/agent-src/rules/finance-safety-floor.md +3 -6
  96. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +3 -5
  97. package/dist/agent-src/rules/git-history-discipline.md +3 -5
  98. package/dist/agent-src/rules/guidelines.md +2 -4
  99. package/dist/agent-src/rules/icon-consistency.md +3 -5
  100. package/dist/agent-src/rules/image-likeness-and-rights.md +3 -5
  101. package/dist/agent-src/rules/improve-before-implement.md +5 -5
  102. package/dist/agent-src/rules/invite-challenge.md +3 -5
  103. package/dist/agent-src/rules/language-and-tone.md +13 -15
  104. package/dist/agent-src/rules/laravel-routing.md +3 -5
  105. package/dist/agent-src/rules/laravel-translations.md +3 -5
  106. package/dist/agent-src/rules/legal-safety-floor.md +3 -5
  107. package/dist/agent-src/rules/lethal-trifecta-guard.md +3 -5
  108. package/dist/agent-src/rules/linked-projects-onboarding-gate.md +4 -7
  109. package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +3 -5
  110. package/dist/agent-src/rules/markdown-safe-codeblocks.md +2 -4
  111. package/dist/agent-src/rules/media-governance-routing.md +3 -5
  112. package/dist/agent-src/rules/media-sync-ground-truth.md +3 -5
  113. package/dist/agent-src/rules/minimal-safe-diff.md +5 -5
  114. package/dist/agent-src/rules/missing-tool-handling.md +3 -5
  115. package/dist/agent-src/rules/model-recommendation.md +4 -6
  116. package/dist/agent-src/rules/no-attribution-footers.md +3 -5
  117. package/dist/agent-src/rules/no-cheap-questions.md +5 -8
  118. package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +3 -6
  119. package/dist/agent-src/rules/no-pr-progress-comments.md +3 -6
  120. package/dist/agent-src/rules/no-roadmap-references.md +3 -5
  121. package/dist/agent-src/rules/non-destructive-by-default.md +11 -13
  122. package/dist/agent-src/rules/notes-first-reasoning.md +3 -5
  123. package/dist/agent-src/rules/onboarding-gate.md +4 -6
  124. package/dist/agent-src/rules/output-discipline.md +3 -5
  125. package/dist/agent-src/rules/package-ci-checks.md +3 -5
  126. package/dist/agent-src/rules/persona-governance.md +2 -4
  127. package/dist/agent-src/rules/php-coding.md +3 -5
  128. package/dist/agent-src/rules/preservation-guard.md +2 -4
  129. package/dist/agent-src/rules/provider-lifecycle-discipline.md +3 -5
  130. package/dist/agent-src/rules/reviewer-awareness.md +5 -6
  131. package/dist/agent-src/rules/roadmap-ci-steps-policy.md +3 -5
  132. package/dist/agent-src/rules/roadmap-progress-sync.md +5 -5
  133. package/dist/agent-src/rules/role-mode-adherence.md +2 -4
  134. package/dist/agent-src/rules/rule-type-governance.md +3 -5
  135. package/dist/agent-src/rules/runtime-safety.md +2 -4
  136. package/dist/agent-src/rules/scope-control.md +10 -11
  137. package/dist/agent-src/rules/security-sensitive-stop.md +4 -5
  138. package/dist/agent-src/rules/size-enforcement.md +2 -4
  139. package/dist/agent-src/rules/skill-improvement-trigger.md +3 -5
  140. package/dist/agent-src/rules/skill-quality.md +3 -5
  141. package/dist/agent-src/rules/slash-command-routing-policy.md +3 -5
  142. package/dist/agent-src/rules/source-confidentiality.md +3 -5
  143. package/dist/agent-src/rules/source-discovery-gate.md +3 -5
  144. package/dist/agent-src/rules/source-of-truth.md +3 -5
  145. package/dist/agent-src/rules/strategy-safety-floor.md +3 -5
  146. package/dist/agent-src/rules/symfony-routing.md +4 -6
  147. package/dist/agent-src/rules/telegraph-speak.md +4 -5
  148. package/dist/agent-src/rules/think-before-action.md +7 -4
  149. package/dist/agent-src/rules/token-budget-discipline.md +29 -5
  150. package/dist/agent-src/rules/token-efficiency.md +3 -5
  151. package/dist/agent-src/rules/token-optimizer-maintenance.md +3 -5
  152. package/dist/agent-src/rules/tool-safety.md +2 -4
  153. package/dist/agent-src/rules/ui-audit-gate.md +3 -6
  154. package/dist/agent-src/rules/untrusted-input-defense.md +3 -5
  155. package/dist/agent-src/rules/upstream-proposal.md +4 -6
  156. package/dist/agent-src/rules/user-interaction.md +7 -5
  157. package/dist/agent-src/rules/user-interrupt-priority.md +17 -8
  158. package/dist/agent-src/rules/verify-before-complete.md +12 -22
  159. package/dist/agent-src/scripts/archive_completed_roadmaps.ts +3 -3
  160. package/dist/agent-src/scripts/update_roadmap_progress.ts +197 -7
  161. package/dist/agent-src/skills/adr-create/SKILL.md +48 -42
  162. package/dist/agent-src/skills/agent-docs-writing/SKILL.md +18 -0
  163. package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
  164. package/dist/agent-src/skills/ai-council/SKILL.md +14 -1
  165. package/dist/agent-src/skills/blameless-post-mortem/SKILL.md +0 -3
  166. package/dist/agent-src/skills/brand/SKILL.md +1 -1
  167. package/dist/agent-src/skills/brand-identity/SKILL.md +3 -3
  168. package/dist/agent-src/skills/brand-strategy/SKILL.md +1 -1
  169. package/dist/agent-src/skills/brand-to-tokens/SKILL.md +3 -3
  170. package/dist/agent-src/skills/canvas-design/SKILL.md +6 -0
  171. package/dist/agent-src/skills/check-refs/SKILL.md +7 -4
  172. package/dist/agent-src/skills/code-review/SKILL.md +1 -0
  173. package/dist/agent-src/skills/complexity-first-planning/SKILL.md +6 -5
  174. package/dist/agent-src/skills/condense-memory/SKILL.md +11 -11
  175. package/dist/agent-src/skills/context-document/SKILL.md +17 -0
  176. package/dist/agent-src/skills/corpus-grounding/SKILL.md +3 -3
  177. package/dist/agent-src/skills/decision-record/SKILL.md +6 -0
  178. package/dist/agent-src/skills/decision-review/SKILL.md +5 -3
  179. package/dist/agent-src/skills/deep-reading-analyst/SKILL.md +6 -1
  180. package/dist/agent-src/skills/design-intelligence/SKILL.md +5 -2
  181. package/dist/agent-src/skills/design-intelligence/references/design-languages.md +1 -1
  182. package/dist/agent-src/skills/design-tokens/SKILL.md +10 -4
  183. package/dist/agent-src/skills/design-variations/SKILL.md +127 -0
  184. package/dist/agent-src/skills/design-variations/evals/triggers.json +17 -0
  185. package/dist/agent-src/skills/emit-tickets/SKILL.md +4 -4
  186. package/dist/agent-src/skills/fe-design/SKILL.md +20 -0
  187. package/dist/agent-src/skills/html-deck/SKILL.md +123 -0
  188. package/dist/agent-src/skills/html-deck/evals/triggers.json +17 -0
  189. package/dist/agent-src/skills/html-deck/templates/deck-shell.html +77 -0
  190. package/dist/agent-src/skills/judge-code-quality/SKILL.md +1 -0
  191. package/dist/agent-src/skills/laravel/SKILL.md +0 -1
  192. package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +46 -0
  193. package/dist/agent-src/skills/lint-skills/SKILL.md +6 -6
  194. package/dist/agent-src/skills/md-language-check/SKILL.md +3 -3
  195. package/dist/agent-src/skills/memory-consolidation/SKILL.md +66 -1
  196. package/dist/agent-src/skills/migration-architect/SKILL.md +1 -0
  197. package/dist/agent-src/skills/module-detect-on-the-fly/SKILL.md +2 -2
  198. package/dist/agent-src/skills/performance-analysis/SKILL.md +2 -0
  199. package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +4 -4
  200. package/dist/agent-src/skills/premortem/SKILL.md +0 -3
  201. package/dist/agent-src/skills/project-analysis-core/SKILL.md +16 -0
  202. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +3 -1
  203. package/dist/agent-src/skills/release-comms/SKILL.md +46 -45
  204. package/dist/agent-src/skills/roadmap-management/SKILL.md +21 -0
  205. package/dist/agent-src/skills/roadmap-writing/SKILL.md +32 -2
  206. package/dist/agent-src/skills/root-cause-frameworks/SKILL.md +0 -3
  207. package/dist/agent-src/skills/security-audit/SKILL.md +1 -0
  208. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +4 -0
  209. package/dist/agent-src/skills/source-discovery/SKILL.md +22 -3
  210. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +33 -14
  211. package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +11 -0
  212. package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-steps.md +8 -0
  213. package/dist/agent-src/skills/systematic-debugging/SKILL.md +29 -0
  214. package/dist/agent-src/skills/threat-modeling/SKILL.md +2 -2
  215. package/dist/agent-src/skills/typography-system/SKILL.md +2 -2
  216. package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +2 -0
  217. package/dist/agent-src/skills/wireframe/SKILL.md +118 -0
  218. package/dist/agent-src/skills/wireframe/evals/triggers.json +17 -0
  219. package/dist/agent-src/templates/agent-settings.md +22 -1
  220. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  221. package/dist/agent-src/templates/command.md +2 -2
  222. package/dist/agent-src/templates/contexts/knowledge-pages.md +116 -0
  223. package/dist/agent-src/templates/hooks/pre-commit-frontmatter +1 -1
  224. package/dist/agent-src/templates/roadmaps.md +70 -2
  225. package/dist/agent-src/templates/rule.md +1 -1
  226. package/dist/agent-src/templates/scripts/README.md +3 -3
  227. package/dist/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +109 -0
  228. package/dist/agent-src/templates/tickets.md +8 -8
  229. package/dist/cli/commands/recordTriggerEval.test.js +1 -1
  230. package/dist/cli/commands/recordTriggerEval.test.js.map +1 -1
  231. package/dist/cli/initRouting.js +4 -2
  232. package/dist/cli/initRouting.js.map +1 -1
  233. package/dist/cli/registry.js +1 -0
  234. package/dist/cli/registry.js.map +1 -1
  235. package/dist/discovery/deprecation-report.md +1 -1
  236. package/dist/discovery/discovery-manifest.json +718 -240
  237. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  238. package/dist/discovery/discovery-manifest.summary.md +8 -8
  239. package/dist/discovery/orphan-report.md +1 -1
  240. package/dist/discovery/packs.json +43 -28
  241. package/dist/discovery/trust-report.md +12 -11
  242. package/dist/discovery/workspaces.json +29 -18
  243. package/dist/install/preflight.js +173 -0
  244. package/dist/install/preflight.js.map +1 -0
  245. package/dist/mcp/registry-manifest.json +4 -4
  246. package/dist/router.json +1 -1
  247. package/dist/server/routes/settings.js +4 -0
  248. package/dist/server/routes/settings.js.map +1 -1
  249. package/dist/server/schemas/settings.js +3 -1
  250. package/dist/server/schemas/settings.js.map +1 -1
  251. package/docs/CLAIMS.md +108 -0
  252. package/docs/MIGRATION.md +3 -3
  253. package/docs/architecture.md +5 -5
  254. package/docs/archive/CHANGELOG-pre-8.0.0.md +301 -0
  255. package/docs/benchmark.md +133 -2
  256. package/docs/benchmark.pinned.yml +31 -0
  257. package/docs/capability-matrix.md +1 -0
  258. package/docs/catalog.md +70 -60
  259. package/docs/command-flows.md +15 -3
  260. package/docs/comparison.yaml +35 -0
  261. package/docs/contracts/agents-layout.md +148 -0
  262. package/docs/contracts/brand-token-consumption.md +5 -0
  263. package/docs/contracts/capability-boundary.md +5 -0
  264. package/docs/contracts/command-category-governance.md +5 -0
  265. package/docs/contracts/command-clusters.md +1 -0
  266. package/docs/contracts/command-surface-tiers.md +1 -1
  267. package/docs/contracts/conformance.md +84 -0
  268. package/docs/contracts/creative-pack-boundary.md +5 -0
  269. package/docs/contracts/discovery-manifest.schema.json +5 -4
  270. package/docs/contracts/file-ownership-matrix.json +4605 -985
  271. package/docs/contracts/governance-enforcement-projection.md +5 -0
  272. package/docs/contracts/gui-wizard.md +1 -1
  273. package/docs/contracts/hook-architecture-v1.md +2 -2
  274. package/docs/contracts/implement-ticket-flow.md +1 -1
  275. package/docs/contracts/kernel-membership.md +13 -0
  276. package/docs/contracts/mcp-tool-inventory.md +23 -23
  277. package/docs/contracts/no-runtime-boundary.md +6 -1
  278. package/docs/contracts/review-lens-schema.md +5 -0
  279. package/docs/contracts/rule-router.md +102 -8
  280. package/docs/contracts/skill-bundled-assets.md +1 -1
  281. package/docs/contracts/skill-dry-run.md +1 -1
  282. package/docs/contracts/subagent-boundary.md +5 -0
  283. package/docs/contracts/ticket-bundle-format.md +9 -4
  284. package/docs/contracts/tier-3-contrib-plugin.md +2 -2
  285. package/docs/contracts/write-engine.md +3 -0
  286. package/docs/customization.md +87 -15
  287. package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +1 -1
  288. package/docs/decisions/ADR-109-subagent-v1-contract.md +246 -0
  289. package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +105 -0
  290. package/docs/decisions/INDEX.md +2 -0
  291. package/docs/distribution/awesome-list-submission.md +46 -0
  292. package/docs/distribution/launch-story-draft.md +58 -0
  293. package/docs/end-to-end-walkthroughs.md +2 -2
  294. package/docs/getting-started.md +2 -2
  295. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +24 -0
  296. package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
  297. package/docs/guidelines/agent-infra/linked-projects-onboarding-gate.md +2 -2
  298. package/docs/guidelines/agent-infra/missing-tool-handling.md +3 -3
  299. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +2 -2
  300. package/docs/guidelines/augment-portability-patterns.md +1 -1
  301. package/docs/guidelines/code-clarity.md +19 -0
  302. package/docs/guidelines/design-antipatterns-triggers.json +2 -1
  303. package/docs/guidelines/design-antipatterns.md +10 -1
  304. package/docs/guidelines/design-modes.md +6 -0
  305. package/docs/guidelines/php/general.md +9 -1
  306. package/docs/guidelines/php/php-coding-patterns.md +7 -0
  307. package/docs/guides/cross-repo-retrieval.md +1 -1
  308. package/docs/guides/frontend-design-corpus-refresh.md +2 -2
  309. package/docs/guides/local-analytics.md +4 -4
  310. package/docs/guides/skill-discovery.md +1 -1
  311. package/docs/guides/skill-preview.md +1 -1
  312. package/docs/hook-payload-capture.md +6 -6
  313. package/docs/install-friction-report.md +66 -0
  314. package/docs/installation.md +1 -1
  315. package/docs/maintainers/optional-media-deps.md +50 -0
  316. package/docs/mcp-server.md +11 -12
  317. package/docs/media/proof-demo.cast +14 -0
  318. package/docs/media/proof-demo.gif +0 -0
  319. package/docs/migration/consumer-template-consumption-model.md +1 -1
  320. package/docs/migration/divergences/bench-stats-float-precision.md +1 -1
  321. package/docs/migration/node-floor.md +1 -1
  322. package/docs/migration/yaml-roundtrip-spike.md +1 -1
  323. package/docs/personas.md +16 -5
  324. package/docs/positioning-evidence.md +86 -0
  325. package/docs/proof.md +86 -0
  326. package/docs/skills-catalog.md +1 -1
  327. package/docs/troubleshooting.md +8 -8
  328. package/docs/wedge/production-validator/README.md +57 -0
  329. package/docs/wedge/production-validator/production-validator.md +56 -0
  330. package/docs/wizard.md +2 -2
  331. package/package.json +1 -1
  332. package/src/config/agent-settings.template.yml +59 -4
  333. package/src/config/agents-paths.yml +254 -0
  334. package/src/config/budgets.yml +16 -0
  335. package/src/config/discovery/packs.yml +1 -0
  336. package/src/config/discovery/unassigned-artefacts.yml +2 -0
  337. package/src/config/gitignore-block.txt +25 -0
  338. package/src/config/host-capabilities.yml +31 -0
  339. package/src/config/profiles/balanced.ini +4 -0
  340. package/src/config/profiles/full.ini +4 -0
  341. package/src/config/profiles/minimal.ini +4 -0
  342. package/src/scripts/_cli/cmd_conformance.ts +716 -0
  343. package/src/scripts/_cli/cmd_doctor.ts +23 -2
  344. package/src/scripts/_cli/cmd_fleet.ts +401 -0
  345. package/src/scripts/_cli/cmd_preflight.ts +159 -0
  346. package/src/scripts/_dispatch.bash +10 -0
  347. package/src/scripts/_lib/knowledge_events.ts +193 -0
  348. package/src/scripts/_lib/subagent_steering.ts +115 -3
  349. package/src/scripts/_lib/text_similarity.ts +75 -0
  350. package/src/scripts/ai-video/test-pipeline.sh +1 -1
  351. package/src/scripts/ai_council/clients.ts +19 -3
  352. package/src/scripts/append_contested.ts +112 -0
  353. package/src/scripts/audit_auto_rules.ts +11 -1
  354. package/src/scripts/audit_mcp_tools.ts +25 -11
  355. package/src/scripts/bench_ab_v2_run.ts +527 -40
  356. package/src/scripts/bench_ab_v2_stats.ts +6 -0
  357. package/src/scripts/bench_matrix.ts +266 -0
  358. package/src/scripts/bootstrap_knowledge.ts +267 -0
  359. package/src/scripts/build_discovery_manifest.ts +42 -2
  360. package/src/scripts/build_proof.ts +214 -0
  361. package/src/scripts/check_always_budget.ts +3 -0
  362. package/src/scripts/check_augment_description_cap.ts +2 -2
  363. package/src/scripts/check_claims.ts +270 -0
  364. package/src/scripts/check_comparison.ts +79 -0
  365. package/src/scripts/check_generated_artefact_headers.ts +109 -0
  366. package/src/scripts/check_generator_output_coverage.ts +142 -0
  367. package/src/scripts/check_gitignore_freshness.ts +127 -0
  368. package/src/scripts/check_knowledge_pages.ts +210 -0
  369. package/src/scripts/check_knowledge_sharing.ts +162 -0
  370. package/src/scripts/check_media_deps.ts +91 -0
  371. package/src/scripts/check_memory_contradiction.ts +280 -0
  372. package/src/scripts/check_memory_similarity.ts +134 -0
  373. package/src/scripts/check_quality_regression.ts +56 -10
  374. package/src/scripts/check_references.ts +3 -1
  375. package/src/scripts/check_release_pr_shape.ts +4 -0
  376. package/src/scripts/check_site_links.ts +135 -0
  377. package/src/scripts/check_skill_gaps.ts +99 -0
  378. package/src/scripts/check_token_quality_golden.ts +197 -11
  379. package/src/scripts/check_tracked_but_ignored.ts +67 -0
  380. package/src/scripts/cluster_near_miss_patterns.ts +0 -0
  381. package/src/scripts/compile_router.ts +30 -3
  382. package/src/scripts/condense.ts +350 -14
  383. package/src/scripts/consolidate_knowledge_events.ts +192 -0
  384. package/src/scripts/degrade_to_pointer.ts +136 -0
  385. package/src/scripts/design_slop_rules.test.ts +15 -0
  386. package/src/scripts/design_slop_rules.ts +28 -0
  387. package/src/scripts/emit_knowledge_event.ts +158 -0
  388. package/src/scripts/export_replay_corpus.ts +187 -0
  389. package/src/scripts/external_sources_denylist.json +7 -2
  390. package/src/scripts/fold_intake.ts +281 -0
  391. package/src/scripts/generate_capability_matrix.ts +9 -1
  392. package/src/scripts/generate_knowledge_index.ts +222 -0
  393. package/src/scripts/hook_manifest.yaml +26 -14
  394. package/src/scripts/hooks/dispatch_hook.ts +18 -0
  395. package/src/scripts/hot_context_hook.ts +372 -0
  396. package/src/scripts/install +47 -0
  397. package/src/scripts/install-hooks.sh +17 -0
  398. package/src/scripts/inventory_meta_layers.ts +11 -0
  399. package/src/scripts/janitor.ts +258 -0
  400. package/src/scripts/lint_agents_layout.ts +74 -15
  401. package/src/scripts/lint_bench_ab.ts +4 -1
  402. package/src/scripts/lint_featured_skills.ts +0 -0
  403. package/src/scripts/lint_framework_leakage_allowlist.json +26 -3
  404. package/src/scripts/lint_knowledge_scale.ts +250 -0
  405. package/src/scripts/lint_legal_pack.ts +67 -0
  406. package/src/scripts/lint_persona_governance.ts +8 -3
  407. package/src/scripts/lint_regression.ts +15 -0
  408. package/src/scripts/lint_roadmap_blockers.ts +202 -0
  409. package/src/scripts/lint_roadmap_complexity.ts +81 -2
  410. package/src/scripts/lint_subagent_determinism.ts +125 -0
  411. package/src/scripts/measure_augment_budget.ts +46 -6
  412. package/src/scripts/measure_patterns.ts +4 -3
  413. package/src/scripts/measure_skill_reduction.ts +6 -6
  414. package/src/scripts/migration_status.ts +6 -2
  415. package/src/scripts/mine_missing_guardrails.ts +189 -0
  416. package/src/scripts/parity/phase_gate.ts +1 -1
  417. package/src/scripts/parity/replay.ts +21 -0
  418. package/src/scripts/project_thin_rules.ts +120 -16
  419. package/src/scripts/release.ts +39 -1
  420. package/src/scripts/render_benchmark_composite.ts +378 -0
  421. package/src/scripts/roadmap_progress_hook.ts +101 -43
  422. package/src/scripts/schemas/skill.schema.json +27 -0
  423. package/src/scripts/schemas/subagent.schema.json +106 -0
  424. package/src/scripts/skill_linter.ts +1 -0
  425. package/src/scripts/smoke/kernel.sh +5 -4
  426. package/src/scripts/surface-tiers.yml +1 -0
  427. package/src/scripts/sync_gitignore.ts +4 -0
  428. package/src/scripts/update_skill_candidates.ts +172 -0
  429. package/src/scripts/validate_frontmatter.ts +1 -0
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Legal-pack output (contract/NDA/DPA review, triage) — never a final legal call; role-conditional header + attorney-review line; EU/DE-only hard refusal; machine-checkable Jurisdiction tag"
4
+ description: "Legal-pack output (contract/NDA/DPA review, triage) — never a final legal call; attorney-review line; EU/DE-only"
5
5
  triggers:
6
6
  - keyword: "NDA"
7
7
  - keyword: "DPA"
@@ -23,10 +23,8 @@ routes_to:
23
23
  - "skill:nda-triage"
24
24
  - "skill:dpa-review"
25
25
  - "skill:legal-intake-triage"
26
- workspaces:
27
- - legal-review-prep
28
- packs:
29
- - legal-review-prep
26
+ workspaces: [legal-review-prep]
27
+ packs: [legal-review-prep]
30
28
  trust:
31
29
  level: advisory
32
30
  human_review_required: true
@@ -2,7 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  alwaysApply: false
5
- description: "Authoring a skill/command/tool that mixes private-data access + untrusted-content ingestion + external comms — break one leg of the lethal trifecta before shipping"
5
+ description: "Skill/command/tool mixing private-data access + untrusted content + external comms — break one leg before shipping"
6
6
  triggers:
7
7
  - path_prefix: "src/skills/"
8
8
  - path_prefix: "src/agent-src/commands/"
@@ -12,10 +12,8 @@ triggers:
12
12
  - keyword: "data exfil"
13
13
  - phrase: "fetch and send"
14
14
  - phrase: "read the file and post"
15
- workspaces:
16
- - engineering
17
- packs:
18
- - engineering-base
15
+ workspaces: [engineering]
16
+ packs: [engineering-base]
19
17
  ---
20
18
 
21
19
  # Lethal-Trifecta Guard
@@ -2,7 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "2b"
4
4
  alwaysApply: false
5
- description: "IDE-attached sibling repo detected — prompt once to opt it into proactive cross-repo awareness, persist local-only, then surface cross-repo impact on relevant changes"
5
+ description: "IDE-attached sibling repo detected — prompt once to opt into cross-repo awareness, persist local-only"
6
6
  triggers:
7
7
  - intent: "work across two projects"
8
8
  - intent: "sibling repository"
@@ -17,11 +17,8 @@ validator_ignore:
17
17
  reason: "Rule names the detector module as the runtime detection entrypoint."
18
18
  routes_to:
19
19
  - "guideline:agent-infra/linked-projects-onboarding-gate"
20
- workspaces:
21
- - agent-config-maintainer
22
- - engineering
23
- packs:
24
- - engineering-base
20
+ workspaces: [agent-config-maintainer, engineering]
21
+ packs: [engineering-base]
25
22
  lifecycle: experimental
26
23
  trust:
27
24
  level: experimental
@@ -35,4 +32,4 @@ install:
35
32
  **Iron Law.** When the IDE has attached a sibling repository to this project and the sibling is not yet recorded in `linked_projects`, prompt the developer **once** to opt it into scope, persist the choice local-only, and thereafter proactively flag cross-repo impact — never bulk-include the sibling's files.
36
33
 
37
34
  Body migrated to `guideline:agent-infra/linked-projects-onboarding-gate` (per the P4 pattern of `road-to-kernel-and-router.md`) — detection command, opt-in flow, persistence shape, behavioral directive, kill-switch. See also the cross-repo guide (`docs/guides/cross-repo-linked-projects.md`) and ADR-032.
38
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
35
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -1,16 +1,14 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "1"
4
- description: "Writing/editing/upstreaming entries in agents/decisions/low-impact-decisions.md — non-bypassable privacy floor for the learning corpus"
4
+ description: "Writing/upstreaming low-impact-decisions corpus entries — non-bypassable privacy floor"
5
5
  triggers:
6
6
  - path_prefix: "agents/decisions/low-impact-decisions"
7
7
  - keyword: "low-impact-decisions"
8
8
  - keyword: "low-impact corpus"
9
9
  - keyword: "learn-low-impact"
10
- workspaces:
11
- - agent-config-maintainer
12
- packs:
13
- - meta
10
+ workspaces: [agent-config-maintainer]
11
+ packs: [meta]
14
12
  ---
15
13
 
16
14
  # Low-Impact Corpus — Privacy Floor
@@ -7,10 +7,8 @@ triggers:
7
7
  - intent: "markdown with code blocks"
8
8
  - keyword: "triple backticks"
9
9
  - file_pattern: "*.md"
10
- workspaces:
11
- - agent-config-maintainer
12
- packs:
13
- - meta
10
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
11
+ packs: [meta]
14
12
  ---
15
13
 
16
14
  # Markdown Safe Codeblocks
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Generating AI video/image/voice — surface project-local media policies (likeness, style, public-figures, voice-cloning, disclosure)"
4
+ description: "Generating AI video/image/voice — surface the project-local media policies (likeness, style, voice-cloning, disclosure)"
5
5
  triggers:
6
6
  - keyword: "/video:"
7
7
  - keyword: "/image:"
@@ -26,10 +26,8 @@ validator_ignore:
26
26
  - type: "substring"
27
27
  pattern: ".agent-src.uncondensed/"
28
28
  reason: "Rule contrasts project-local placement with the .agent-src.uncondensed/rules/ alternative — mentioning the path is the argument."
29
- workspaces:
30
- - agent-config-maintainer
31
- packs:
32
- - meta
29
+ workspaces: [agent-config-maintainer, engineering, gtm]
30
+ packs: [ai-image, ai-video]
33
31
  ---
34
32
 
35
33
  # Media Governance Routing
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Audio-synced video (lip-sync, beat-cuts, music video) — derive timing + singer from the transcribed real audio, never a planning doc; sign off the vocal map before any paid render"
4
+ description: "Audio-synced video — timing + singer come from the transcribed real audio; sign-off before paid renders"
5
5
  triggers:
6
6
  - keyword: "lip-sync"
7
7
  - keyword: "lip sync"
@@ -14,10 +14,8 @@ triggers:
14
14
  - phrase: "sing the"
15
15
  - phrase: "mit den lippen"
16
16
  - phrase: "lippen passend"
17
- workspaces:
18
- - agent-config-maintainer
19
- packs:
20
- - meta
17
+ workspaces: [agent-config-maintainer, engineering, gtm]
18
+ packs: [ai-video]
21
19
  ---
22
20
 
23
21
  # Media Sync — Ground Truth Is the Audio
@@ -2,15 +2,15 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  alwaysApply: false
5
- description: "Writing or reviewing a diff — smallest change that solves the problem; no drive-by edits, opportunistic refactors, or reformatting"
5
+ description: "Writing or reviewing a diff — smallest change that solves the problem; no drive-by edits or reformatting"
6
6
  triggers:
7
7
  - intent: "writing a diff"
8
8
  - intent: "reviewing a diff"
9
9
  - keyword: "drive-by"
10
- workspaces:
11
- - engineering
12
- packs:
13
- - engineering-base
10
+ - keyword: "rewrite"
11
+ - keyword: "fix"
12
+ workspaces: [engineering]
13
+ packs: [engineering-base]
14
14
  ---
15
15
 
16
16
  # Minimal Safe Diff
@@ -8,10 +8,8 @@ triggers:
8
8
  - intent: "install tool"
9
9
  routes_to:
10
10
  - "guideline:agent-infra/missing-tool-handling"
11
- workspaces:
12
- - agent-config-maintainer
13
- packs:
14
- - meta
11
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
12
+ packs: [meta]
15
13
  ---
16
14
 
17
15
  # Missing Tool Handling
@@ -19,4 +17,4 @@ packs:
19
17
  **Iron Law.** A CLI tool the task genuinely needs is not installed (`command not found`, `which X` empty) → STOP and ask with numbered options; never install silently, never silently substitute a brittle workaround.
20
18
 
21
19
  Body migrated to `guideline:agent-infra/missing-tool-handling` (per the P4 pattern of `road-to-kernel-and-router.md`).
22
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
20
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Starting a task, switching type, or invoking a skill/command that declares a model_tier — switch (Claude) or suggest (any agent) the right capability tier"
4
+ description: "Task start, type switch, or skill/command with a model_tier — switch or suggest the right capability tier"
5
5
  triggers:
6
6
  - phrase: "switch task"
7
7
  - phrase: "new task"
@@ -11,10 +11,8 @@ load_context:
11
11
  - ../contexts/model-recommendations.md
12
12
  routes_to:
13
13
  - "guideline:agent-infra/model-recommendation"
14
- workspaces:
15
- - agent-config-maintainer
16
- packs:
17
- - meta
14
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
15
+ packs: [meta]
18
16
  ---
19
17
 
20
18
  # Model Recommendation
@@ -22,4 +20,4 @@ packs:
22
20
  **Iron Law.** When a skill or command carries a `model_tier` (a vendor-neutral capability band), route the turn to **that agent's best model in that band** — automatically where the surface supports a per-turn override, as a single suggestion where it does not. Never recommend another vendor's model. Never double-ask, never front-load the question.
23
21
 
24
22
  Body migrated to `guideline:agent-infra/model-recommendation` (per the P4 pattern of `road-to-kernel-and-router.md`); task→tier heuristics stay in `contexts/model-recommendations.md` (loaded via `load_context`).
25
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
23
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -2,16 +2,14 @@
2
2
  type: "auto"
3
3
  tier: "3"
4
4
  alwaysApply: false
5
- description: "Generating PR/issue/comment/commit bodies — forbids 'Generated with', 'Co-authored by', 'Pull Request opened by' attribution footers"
5
+ description: "PR/issue/comment/commit bodies — no 'Generated with' / 'Co-authored by' / 'opened by' attribution footers"
6
6
  triggers:
7
7
  - intent: "PR body"
8
8
  - intent: "commit message"
9
9
  - intent: "Jira comment"
10
10
  - keyword: "co-authored"
11
- workspaces:
12
- - agent-config-maintainer
13
- packs:
14
- - meta
11
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
12
+ packs: [meta]
15
13
  ---
16
14
 
17
15
  # No Attribution Footers
@@ -3,15 +3,13 @@ type: "always"
3
3
  tier: "3"
4
4
  description: "No cheap questions — never ask what context answers, never offer Iron-Law-violating options, never stage no-trade-off choices; mode-independent (off / auto / on)"
5
5
  alwaysApply: true
6
- workspaces:
7
- - agent-config-maintainer
8
- packs:
9
- - meta
6
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
7
+ packs: [meta]
10
8
  ---
11
9
 
12
10
  # No Cheap Questions
13
11
 
14
- Cheap = context answers it, option breaches an Iron Law, choices differ only in sequencing / format, or one option dominates. Mode-independent; autonomy never lifts the floor.
12
+ Cheap = context answers it, an option breaches an Iron Law, choices differ only in sequencing/format, or one option dominates. Mode-independent; autonomy never lifts the floor.
15
13
 
16
14
  ## The Iron Laws
17
15
 
@@ -69,7 +67,6 @@ Silent, before any numbered-options block. Any "yes" → don't ask:
69
67
  11. Cleanup of gitignored / auto-pruned / TTL-managed artefact? Self-managing — state inline, never offer.
70
68
  12. Numbered option contains a commit-message body, "message preview", or "Vorschlag falls Du committen willst"? Disguised commit ask — `commit-policy` violation, drop it.
71
69
  13. Commit authorized + asking "one commit or multiple?", "how should I split?", "which chunk first?"? Forbidden — `commit-policy § Always split into logical chunks`. Pick the split, state inline, execute.
70
+ 14. Artifact just landed (roadmap / ADR / plan / pitch / ticket) + offering "ready to start Phase 1?", "begin execution?", or a `/roadmap:process-*` menu? Forbidden — `scope-control § Authoring vs. implementation` + `scope-mechanics § Post-artifact hard stop`. Authoring verbs never inherit execution authorization. Emit the hand-back line, stop the turn.
72
71
 
73
- Pick dominant path, state inline assumption, hand back. Genuine ambiguity → [`ask-when-uncertain`](ask-when-uncertain.md).
74
-
75
- In doubt → ask. This rule narrows asking, never widens silence. When asking IS allowed: [`cheap-question-mechanics`](../contexts/execution/cheap-question-mechanics.md).
72
+ Pick the dominant path, state the assumption inline, hand back. Genuine ambiguity → [`ask-when-uncertain`](ask-when-uncertain.md). In doubt → ask: this rule narrows asking, never widens silence. When asking IS allowed: [`cheap-question-mechanics`](../contexts/execution/cheap-question-mechanics.md).
@@ -2,7 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "3"
4
4
  alwaysApply: false
5
- description: "Generating PR/issue/commit titles or PR/issue comments — forbids decorative emojis; allowed in PR/issue descriptions + commit bodies only when matched by an in-artifact legend"
5
+ description: "PR/issue/commit titles and comments — no decorative emojis; bodies only with an in-artifact legend"
6
6
  triggers:
7
7
  - intent: "PR title"
8
8
  - intent: "PR body"
@@ -11,11 +11,8 @@ triggers:
11
11
  - intent: "post PR comment"
12
12
  - keyword: "gh pr create"
13
13
  - keyword: "git commit"
14
- workspaces:
15
- - agent-config-maintainer
16
- - engineering
17
- packs:
18
- - meta
14
+ workspaces: [agent-config-maintainer, engineering]
15
+ packs: [meta]
19
16
  ---
20
17
 
21
18
  # No Decorative Emojis in Git Surfaces
@@ -2,18 +2,15 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  alwaysApply: false
5
- description: "Posting comments on an open PR — refuses unsolicited progress / status / CI-fix narration unless personal.pr_progress_comments is true"
5
+ description: "PR comments — no unsolicited progress/status/CI narration unless personal.pr_progress_comments is true"
6
6
  triggers:
7
7
  - intent: "post PR comment"
8
8
  - intent: "PR status update"
9
9
  - intent: "CI fix progress"
10
10
  - keyword: "gh pr comment"
11
11
  - keyword: "PullRequestComment"
12
- workspaces:
13
- - agent-config-maintainer
14
- - engineering
15
- packs:
16
- - meta
12
+ workspaces: [agent-config-maintainer, engineering]
13
+ packs: [meta]
17
14
  ---
18
15
 
19
16
  # No Unsolicited PR Progress Comments
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "mechanical-already"
4
- description: "Linking transient files (agents/roadmaps/, agents/runtime/council/*/) from a stable artifact — both layers expire; promote findings"
4
+ description: "Linking transient files (agents/roadmaps/, agents/runtime/council/) from stable artifacts — both expire; promote findings"
5
5
  alwaysApply: false
6
6
  triggers:
7
7
  - path_prefix: "agents/roadmaps/"
@@ -16,10 +16,8 @@ validator_ignore:
16
16
  - type: "substring"
17
17
  pattern: ".agent-src.uncondensed/"
18
18
  reason: "Rule contrasts the authoring tree with transient layers."
19
- workspaces:
20
- - agent-config-maintainer
21
- packs:
22
- - meta
19
+ workspaces: [agent-config-maintainer]
20
+ packs: [meta]
23
21
  ---
24
22
 
25
23
  # No Transient References from Stable Artifacts
@@ -5,15 +5,13 @@ description: "Hard Floor: agent asks before prod-trunk commits/merges, deploys,
5
5
  alwaysApply: true
6
6
  load_context:
7
7
  - ../contexts/authority/destructive-mechanics.md
8
- workspaces:
9
- - engineering
10
- packs:
11
- - engineering-base
8
+ workspaces: [engineering]
9
+ packs: [engineering-base]
12
10
  ---
13
11
 
14
12
  # Non-Destructive by Default
15
13
 
16
- Universal safety floor — every mode, every conversation, every turn. Autonomy, "just keep going", roadmap authorizations, standing permissions narrow other rules — **none lift this one**.
14
+ Universal safety floor — every mode, every turn. Autonomy, "just keep going", roadmap authorizations, standing permissions narrow other rules — **none lift this one**.
17
15
 
18
16
  ## The Iron Law
19
17
 
@@ -28,30 +26,30 @@ Triggers below require explicit user confirmation **on this turn** — not from
28
26
  | Trigger | Examples |
29
27
  |---|---|
30
28
  | **Production-branch merge** | `main`, `master`, `prod`, `production`, `release/*`, or any project-marked deployment trunk |
31
- | **Commit on a production branch** | any `git commit` while `HEAD` is on a prod trunk (set above). **Verify branch before every commit** — `main` is opt-in only, never inferred from a prior turn or a merged PR that left the repo on `main` |
29
+ | **Commit on a production branch** | any `git commit` while `HEAD` is on a prod trunk. **Verify branch before every commit** — `main` is opt-in only, never inferred from a prior turn or a merged PR that left HEAD on `main` |
32
30
  | **Deploy / release** | prod `terraform apply` / `kubectl apply`, deploy scripts, release commands, CI-deploying tag pushes |
33
31
  | **Push to remote** | any `git push` (also covered by [`scope-control`](scope-control.md), restated so the floor never weakens) |
34
32
  | **Production data / infra** | prod DB writes / migrations, prod config, secrets rotation, IAM / role / policy, DNS, anything in a `prod`-scoped path or pipeline |
35
- | **Whimsical / unscoped bulk deletion** | `rm -rf <dir>`, `git rm -r`, glob deletions, `DROP TABLE`, `TRUNCATE`, `git reset --hard` past unpushed work — when **not required** by the current task. Task-aligned WIP deletions are allowed (below) |
36
- | **Commit containing bulk deletions or infra changes** | diff removes a directory, deletes ≥5 unrelated files, or touches Terraform / Pulumi / k8s / Ansible / cloud-config — surface the diff and confirm even when [`commit-policy`](commit-policy.md) authorizes |
33
+ | **Whimsical / unscoped bulk deletion** | `rm -rf <dir>`, `git rm -r`, glob deletes, `DROP TABLE`, `TRUNCATE`, `git reset --hard` past unpushed work — when **not required** by the task (task-aligned WIP deletions allowed, below) |
34
+ | **Commit containing bulk deletions or infra changes** | diff removes a directory, deletes ≥5 unrelated files, or touches Terraform/Pulumi/k8s/Ansible/cloud-config — surface the diff + confirm even when [`commit-policy`](commit-policy.md) authorizes |
37
35
 
38
- Standing "just keep going" + next step crosses the floor → STOP, surface what's about to happen (one numbered-options block per [`user-interaction`](user-interaction.md)), wait. Other rules still apply to every other step.
36
+ Standing "just keep going" + next step crosses the floor → STOP, surface it (one numbered-options block per [`user-interaction`](user-interaction.md)), wait.
39
37
 
40
38
  ## Not in scope — deterministic regeneration
41
39
 
42
- Output regenerated from a tracked source (condensation, code-gen, formatter passes, lock-file rebuilds) is reversible from source — **not destructive**. Lives in [`autonomous-execution`](autonomous-execution.md). Per-file diff approval is theater.
40
+ Output regenerated from a tracked source (condensation, code-gen, formatters, lock-files) is reversible — **not destructive** ([`autonomous-execution`](autonomous-execution.md)). Per-file diff approval is theater.
43
41
 
44
42
  ## Bulk deletions during WIP — allowed if task-connected
45
43
 
46
- Deletions inside an **active, user-stated task** are allowed in the working tree, even multiple files / folders — the Hard Floor moves to the **commit** (row 6), not the in-progress edit. Whimsical / drive-by / unnamed-scope deletions still trip the floor on the edit. Allowed / forbidden lists: [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
44
+ Deletions inside an **active, user-stated task** are allowed in the working tree — the Hard Floor moves to the **commit** (row 6). Whimsical / drive-by / unnamed-scope deletions still trip the floor on the edit. Allowed/forbidden lists: [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
47
45
 
48
46
  ## Failure modes
49
47
 
50
- Full catalog (autonomy-as-cover, roadmap-as-authorization, refusing-named-deletions, commit-without-diff-surface, roadmap-step ≠ commit-authorization): [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
48
+ Catalog (autonomy-as-cover, roadmap-as-authorization, refusing-named-deletions, commit-without-diff-surface): [`destructive-mechanics`](../contexts/authority/destructive-mechanics.md).
51
49
 
52
50
  ## Cloud Behavior
53
51
 
54
- Floor applies on every surface — Claude.ai Web, Skills API, any cloud agent. No "cloud override".
52
+ Applies on every surface — web, Skills API, any cloud agent. No "cloud override".
55
53
 
56
54
  ## See also
57
55
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2b"
4
- description: "Reasoning-heavy work (debugging, multi-hypothesis, weighing alternatives) — keep hypotheses/predictions/decisions in session notes, response carries conclusions + evidence only"
4
+ description: "Reasoning-heavy work — hypotheses/predictions/decisions go to session notes; the response carries conclusions + evidence"
5
5
  triggers:
6
6
  - keyword: "debug"
7
7
  - keyword: "investigate"
@@ -13,10 +13,8 @@ load_context:
13
13
  - ../contexts/execution/rdp-gate.md
14
14
  routes_to:
15
15
  - "skill:memory-consolidation"
16
- workspaces:
17
- - agent-config-maintainer
18
- packs:
19
- - meta
16
+ workspaces: [agent-config-maintainer, engineering]
17
+ packs: [meta]
20
18
  ---
21
19
 
22
20
  # Notes-First Reasoning
@@ -1,15 +1,13 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "1"
4
- description: "First turn — if onboarding.onboarded is false in .agent-settings.yml, instruct dev to run `agent-config setup` before any request"
4
+ description: "First turn with onboarding.onboarded false — instruct dev to run `agent-config setup` first"
5
5
  triggers:
6
6
  - phrase: "first turn"
7
7
  - keyword: "onboarding"
8
8
  - path_prefix: ".agent-settings.yml"
9
- workspaces:
10
- - agent-config-maintainer
11
- packs:
12
- - meta
9
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
10
+ packs: [meta]
13
11
  ---
14
12
 
15
13
  # Onboarding Gate
@@ -20,4 +18,4 @@ packs:
20
18
 
21
19
  Cloud surfaces without settings file stay inert: rule does not fire when `.agent-settings.yml` absent → headless / read-only contexts (Cloudflare MCP, doc preview, CI) never see prompt.
22
20
 
23
- Trigger-set above activates routing under `balanced` and `full` profiles.
21
+ Trigger-set above activates routing on demand, independent of the discipline profile (ADR-110).
@@ -1,17 +1,15 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Prohibits placeholder-prose output in generated code and UI — no truncation shorthands; on budget overflow emit a clean PAUSED breakpoint instead"
4
+ description: "No placeholder prose in generated code/UI — no truncation shorthands; on budget overflow emit a clean PAUSED breakpoint"
5
5
  triggers:
6
6
  - intent: "generating code or multi-section output"
7
7
  - keyword: "// rest of component"
8
8
  - keyword: "for brevity"
9
9
  - keyword: "rest follows the same pattern"
10
10
  - phrase: "similar pattern"
11
- workspaces:
12
- - engineering
13
- packs:
14
- - engineering-base
11
+ workspaces: [engineering]
12
+ packs: [engineering-base]
15
13
  ---
16
14
 
17
15
  # Output Discipline
@@ -8,10 +8,8 @@ triggers:
8
8
  - phrase: "before pr"
9
9
  routes_to:
10
10
  - "skill:lint-skills"
11
- workspaces:
12
- - agent-config-maintainer
13
- packs:
14
- - meta
11
+ workspaces: [agent-config-maintainer]
12
+ packs: [meta]
15
13
  ---
16
14
 
17
15
  # Package Ci Checks
@@ -19,4 +17,4 @@ packs:
19
17
  **Iron Law.** Run `task ci` locally and confirm green before pushing or opening a PR in this package.
20
18
 
21
19
  Body migrated to `skill:lint-skills` (per P4 of `road-to-kernel-and-router.md`).
22
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
20
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -23,10 +23,8 @@ validator_ignore:
23
23
  - type: "substring"
24
24
  pattern: ".agent-src.uncondensed/"
25
25
  reason: "Rule documents the persona authoring tree (.agent-src.uncondensed/personas/) as the deprecation-path operand."
26
- workspaces:
27
- - agent-config-maintainer
28
- packs:
29
- - meta
26
+ workspaces: [agent-config-maintainer]
27
+ packs: [meta]
30
28
  ---
31
29
 
32
30
  # Persona Governance
@@ -8,10 +8,8 @@ triggers:
8
8
  - keyword: "ecs"
9
9
  routes_to:
10
10
  - "guideline:php/php-coding-patterns"
11
- workspaces:
12
- - engineering
13
- packs:
14
- - php
11
+ workspaces: [engineering]
12
+ packs: [php]
15
13
  trust:
16
14
  level: professional
17
15
  install:
@@ -24,4 +22,4 @@ install:
24
22
  **Iron Law.** PHP: strict types, named comparisons, early returns, Eloquent conventions — full pattern library in the guideline.
25
23
 
26
24
  Body migrated to `guideline:php/php-coding-patterns` (per P4 of `road-to-kernel-and-router.md`).
27
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
25
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -12,10 +12,8 @@ validator_ignore:
12
12
  - type: "substring"
13
13
  pattern: ".agent-src.uncondensed/"
14
14
  reason: "Rule references the authoring tree as the operand of condensation/preservation."
15
- workspaces:
16
- - agent-config-maintainer
17
- packs:
18
- - meta
15
+ workspaces: [agent-config-maintainer]
16
+ packs: [meta]
19
17
  ---
20
18
 
21
19
  # Preservation Guard
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Editing an AI video/image/audio adapter — declare lifecycle tier (experimental | stable | deprecated | community); never default to non-stable"
4
+ description: "Editing an AI video/image/audio adapter — declare lifecycle tier; never default to non-stable"
5
5
  triggers:
6
6
  - keyword: "/video:"
7
7
  - keyword: "/image:"
@@ -23,10 +23,8 @@ applies_to_user_types:
23
23
  - "creator"
24
24
  - "developer"
25
25
  - "maintainer"
26
- workspaces:
27
- - agent-config-maintainer
28
- packs:
29
- - meta
26
+ workspaces: [agent-config-maintainer, engineering, gtm]
27
+ packs: [ai-image, ai-video]
30
28
  ---
31
29
 
32
30
  # Provider Lifecycle Discipline
@@ -1,18 +1,17 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Suggesting reviewers or flagging risk hotspots — anchor in paths/risk + ownership-map + bug-patterns; medium/high needs primary + secondary"
4
+ description: "Reviewer suggestions / risk hotspots — anchor in paths/risk + ownership-map; medium/high needs primary + secondary"
5
5
  triggers:
6
6
  - keyword: "reviewer"
7
7
  - phrase: "suggest reviewers"
8
8
  - phrase: "risk hotspot"
9
9
  - phrase: "ownership map"
10
+ - phrase: "review this pr"
10
11
  routes_to:
11
12
  - "skill:review-routing"
12
- workspaces:
13
- - agent-config-maintainer
14
- packs:
15
- - meta
13
+ workspaces: [agent-config-maintainer, engineering]
14
+ packs: [meta]
16
15
  ---
17
16
 
18
17
  # Reviewer Awareness
@@ -22,7 +21,7 @@ packs:
22
21
  **Iron Law (routing / risk).** Consult ownership-map and historical-bug-patterns before suggesting reviewers or claiming a change is safe.
23
22
 
24
23
  Body migrated to `skill:review-routing` (per P4 of `road-to-kernel-and-router.md`).
25
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
24
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
26
25
 
27
26
  Consolidates the former review-routing-awareness rule per the
28
27
  package's adr-auto-rule-consolidation decision.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Authoring or executing roadmaps — forbid task ci / make test / npm run check steps when quality.local_auto_run is false; skip inline"
4
+ description: "Roadmap authoring/execution — no full-pipeline CI steps when quality.local_auto_run is false; skip inline"
5
5
  triggers:
6
6
  - path_prefix: "agents/roadmaps/"
7
7
  - path_prefix: "{module_root}/" # resolved via modules.root_paths; Laravel shape: app/Modules/
@@ -24,10 +24,8 @@ validator_ignore:
24
24
  - type: "substring"
25
25
  pattern: ".agent-settings.yml"
26
26
  reason: "Rule reads quality.local_auto_run from .agent-settings.yml; naming the file is the contract."
27
- workspaces:
28
- - agent-config-maintainer
29
- packs:
30
- - meta
27
+ workspaces: [agent-config-maintainer, engineering]
28
+ packs: [meta]
31
29
  ---
32
30
 
33
31
  # Roadmap CI-Steps Policy