@event4u/agent-config 7.5.0 → 8.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (428) hide show
  1. package/.claude-plugin/marketplace.json +8 -1
  2. package/AGENTS.md +9 -9
  3. package/CHANGELOG.md +325 -0
  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 +8 -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/benchmark.md +133 -2
  255. package/docs/benchmark.pinned.yml +31 -0
  256. package/docs/capability-matrix.md +1 -0
  257. package/docs/catalog.md +70 -60
  258. package/docs/command-flows.md +15 -3
  259. package/docs/comparison.yaml +35 -0
  260. package/docs/contracts/agents-layout.md +148 -0
  261. package/docs/contracts/brand-token-consumption.md +5 -0
  262. package/docs/contracts/capability-boundary.md +5 -0
  263. package/docs/contracts/command-category-governance.md +5 -0
  264. package/docs/contracts/command-clusters.md +1 -0
  265. package/docs/contracts/command-surface-tiers.md +1 -1
  266. package/docs/contracts/conformance.md +84 -0
  267. package/docs/contracts/creative-pack-boundary.md +5 -0
  268. package/docs/contracts/discovery-manifest.schema.json +5 -4
  269. package/docs/contracts/file-ownership-matrix.json +4605 -985
  270. package/docs/contracts/governance-enforcement-projection.md +5 -0
  271. package/docs/contracts/gui-wizard.md +1 -1
  272. package/docs/contracts/hook-architecture-v1.md +2 -2
  273. package/docs/contracts/implement-ticket-flow.md +1 -1
  274. package/docs/contracts/kernel-membership.md +13 -0
  275. package/docs/contracts/mcp-tool-inventory.md +23 -23
  276. package/docs/contracts/no-runtime-boundary.md +6 -1
  277. package/docs/contracts/review-lens-schema.md +5 -0
  278. package/docs/contracts/rule-router.md +102 -8
  279. package/docs/contracts/skill-bundled-assets.md +1 -1
  280. package/docs/contracts/skill-dry-run.md +1 -1
  281. package/docs/contracts/subagent-boundary.md +5 -0
  282. package/docs/contracts/ticket-bundle-format.md +9 -4
  283. package/docs/contracts/tier-3-contrib-plugin.md +2 -2
  284. package/docs/contracts/write-engine.md +3 -0
  285. package/docs/customization.md +87 -15
  286. package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +1 -1
  287. package/docs/decisions/ADR-109-subagent-v1-contract.md +246 -0
  288. package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +105 -0
  289. package/docs/decisions/INDEX.md +2 -0
  290. package/docs/distribution/awesome-list-submission.md +46 -0
  291. package/docs/distribution/launch-story-draft.md +58 -0
  292. package/docs/end-to-end-walkthroughs.md +2 -2
  293. package/docs/getting-started.md +2 -2
  294. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +24 -0
  295. package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
  296. package/docs/guidelines/agent-infra/linked-projects-onboarding-gate.md +2 -2
  297. package/docs/guidelines/agent-infra/missing-tool-handling.md +3 -3
  298. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +2 -2
  299. package/docs/guidelines/augment-portability-patterns.md +1 -1
  300. package/docs/guidelines/code-clarity.md +19 -0
  301. package/docs/guidelines/design-antipatterns-triggers.json +2 -1
  302. package/docs/guidelines/design-antipatterns.md +10 -1
  303. package/docs/guidelines/design-modes.md +6 -0
  304. package/docs/guidelines/php/general.md +9 -1
  305. package/docs/guidelines/php/php-coding-patterns.md +7 -0
  306. package/docs/guides/cross-repo-retrieval.md +1 -1
  307. package/docs/guides/frontend-design-corpus-refresh.md +2 -2
  308. package/docs/guides/local-analytics.md +4 -4
  309. package/docs/guides/skill-discovery.md +1 -1
  310. package/docs/guides/skill-preview.md +1 -1
  311. package/docs/hook-payload-capture.md +6 -6
  312. package/docs/install-friction-report.md +66 -0
  313. package/docs/installation.md +1 -1
  314. package/docs/maintainers/optional-media-deps.md +50 -0
  315. package/docs/mcp-server.md +11 -12
  316. package/docs/media/proof-demo.cast +14 -0
  317. package/docs/media/proof-demo.gif +0 -0
  318. package/docs/migration/consumer-template-consumption-model.md +1 -1
  319. package/docs/migration/divergences/bench-stats-float-precision.md +1 -1
  320. package/docs/migration/node-floor.md +1 -1
  321. package/docs/migration/yaml-roundtrip-spike.md +1 -1
  322. package/docs/personas.md +16 -5
  323. package/docs/positioning-evidence.md +86 -0
  324. package/docs/proof.md +86 -0
  325. package/docs/skills-catalog.md +1 -1
  326. package/docs/troubleshooting.md +8 -8
  327. package/docs/wedge/production-validator/README.md +57 -0
  328. package/docs/wedge/production-validator/production-validator.md +56 -0
  329. package/docs/wizard.md +2 -2
  330. package/package.json +1 -1
  331. package/src/config/agent-settings.template.yml +59 -4
  332. package/src/config/agents-paths.yml +254 -0
  333. package/src/config/budgets.yml +16 -0
  334. package/src/config/discovery/packs.yml +1 -0
  335. package/src/config/discovery/unassigned-artefacts.yml +2 -0
  336. package/src/config/gitignore-block.txt +25 -0
  337. package/src/config/host-capabilities.yml +31 -0
  338. package/src/config/profiles/balanced.ini +4 -0
  339. package/src/config/profiles/full.ini +4 -0
  340. package/src/config/profiles/minimal.ini +4 -0
  341. package/src/scripts/_cli/cmd_conformance.ts +716 -0
  342. package/src/scripts/_cli/cmd_doctor.ts +23 -2
  343. package/src/scripts/_cli/cmd_fleet.ts +401 -0
  344. package/src/scripts/_cli/cmd_preflight.ts +159 -0
  345. package/src/scripts/_dispatch.bash +10 -0
  346. package/src/scripts/_lib/knowledge_events.ts +193 -0
  347. package/src/scripts/_lib/subagent_steering.ts +115 -3
  348. package/src/scripts/_lib/text_similarity.ts +75 -0
  349. package/src/scripts/ai-video/test-pipeline.sh +1 -1
  350. package/src/scripts/ai_council/clients.ts +19 -3
  351. package/src/scripts/append_contested.ts +112 -0
  352. package/src/scripts/audit_auto_rules.ts +11 -1
  353. package/src/scripts/audit_mcp_tools.ts +25 -11
  354. package/src/scripts/bench_ab_v2_run.ts +527 -40
  355. package/src/scripts/bench_ab_v2_stats.ts +6 -0
  356. package/src/scripts/bench_matrix.ts +266 -0
  357. package/src/scripts/bootstrap_knowledge.ts +267 -0
  358. package/src/scripts/build_discovery_manifest.ts +42 -2
  359. package/src/scripts/build_proof.ts +214 -0
  360. package/src/scripts/check_always_budget.ts +3 -0
  361. package/src/scripts/check_augment_description_cap.ts +2 -2
  362. package/src/scripts/check_claims.ts +270 -0
  363. package/src/scripts/check_comparison.ts +79 -0
  364. package/src/scripts/check_generated_artefact_headers.ts +109 -0
  365. package/src/scripts/check_generator_output_coverage.ts +142 -0
  366. package/src/scripts/check_gitignore_freshness.ts +127 -0
  367. package/src/scripts/check_knowledge_pages.ts +210 -0
  368. package/src/scripts/check_knowledge_sharing.ts +162 -0
  369. package/src/scripts/check_media_deps.ts +91 -0
  370. package/src/scripts/check_memory_contradiction.ts +280 -0
  371. package/src/scripts/check_memory_similarity.ts +134 -0
  372. package/src/scripts/check_quality_regression.ts +56 -10
  373. package/src/scripts/check_references.ts +3 -1
  374. package/src/scripts/check_release_pr_shape.ts +4 -0
  375. package/src/scripts/check_site_links.ts +135 -0
  376. package/src/scripts/check_skill_gaps.ts +99 -0
  377. package/src/scripts/check_token_quality_golden.ts +197 -11
  378. package/src/scripts/check_tracked_but_ignored.ts +67 -0
  379. package/src/scripts/cluster_near_miss_patterns.ts +0 -0
  380. package/src/scripts/compile_router.ts +30 -3
  381. package/src/scripts/condense.ts +350 -14
  382. package/src/scripts/consolidate_knowledge_events.ts +192 -0
  383. package/src/scripts/degrade_to_pointer.ts +136 -0
  384. package/src/scripts/design_slop_rules.test.ts +15 -0
  385. package/src/scripts/design_slop_rules.ts +28 -0
  386. package/src/scripts/emit_knowledge_event.ts +158 -0
  387. package/src/scripts/export_replay_corpus.ts +187 -0
  388. package/src/scripts/external_sources_denylist.json +7 -2
  389. package/src/scripts/fold_intake.ts +281 -0
  390. package/src/scripts/generate_capability_matrix.ts +9 -1
  391. package/src/scripts/generate_knowledge_index.ts +222 -0
  392. package/src/scripts/hook_manifest.yaml +26 -14
  393. package/src/scripts/hooks/dispatch_hook.ts +18 -0
  394. package/src/scripts/hot_context_hook.ts +372 -0
  395. package/src/scripts/install +47 -0
  396. package/src/scripts/install-hooks.sh +17 -0
  397. package/src/scripts/inventory_meta_layers.ts +11 -0
  398. package/src/scripts/janitor.ts +258 -0
  399. package/src/scripts/lint_agents_layout.ts +74 -15
  400. package/src/scripts/lint_bench_ab.ts +4 -1
  401. package/src/scripts/lint_featured_skills.ts +0 -0
  402. package/src/scripts/lint_framework_leakage_allowlist.json +26 -3
  403. package/src/scripts/lint_knowledge_scale.ts +250 -0
  404. package/src/scripts/lint_legal_pack.ts +67 -0
  405. package/src/scripts/lint_persona_governance.ts +8 -3
  406. package/src/scripts/lint_regression.ts +15 -0
  407. package/src/scripts/lint_roadmap_blockers.ts +202 -0
  408. package/src/scripts/lint_roadmap_complexity.ts +81 -2
  409. package/src/scripts/lint_subagent_determinism.ts +125 -0
  410. package/src/scripts/measure_augment_budget.ts +46 -6
  411. package/src/scripts/measure_patterns.ts +4 -3
  412. package/src/scripts/measure_skill_reduction.ts +6 -6
  413. package/src/scripts/migration_status.ts +6 -2
  414. package/src/scripts/mine_missing_guardrails.ts +189 -0
  415. package/src/scripts/parity/phase_gate.ts +1 -1
  416. package/src/scripts/parity/replay.ts +21 -0
  417. package/src/scripts/project_thin_rules.ts +120 -16
  418. package/src/scripts/release.ts +39 -1
  419. package/src/scripts/render_benchmark_composite.ts +378 -0
  420. package/src/scripts/roadmap_progress_hook.ts +101 -43
  421. package/src/scripts/schemas/skill.schema.json +27 -0
  422. package/src/scripts/schemas/subagent.schema.json +106 -0
  423. package/src/scripts/skill_linter.ts +1 -0
  424. package/src/scripts/smoke/kernel.sh +5 -4
  425. package/src/scripts/surface-tiers.yml +1 -0
  426. package/src/scripts/sync_gitignore.ts +4 -0
  427. package/src/scripts/update_skill_candidates.ts +172 -0
  428. package/src/scripts/validate_frontmatter.ts +1 -0
@@ -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
@@ -9,10 +9,8 @@ triggers:
9
9
  - command: "/roadmap:process-full"
10
10
  routes_to:
11
11
  - "guideline:agent-infra/roadmap-progress-mechanics"
12
- workspaces:
13
- - agent-config-maintainer
14
- packs:
15
- - meta
12
+ workspaces: [agent-config-maintainer, engineering]
13
+ packs: [meta]
16
14
  ---
17
15
 
18
16
  # Roadmap Progress Sync
@@ -54,6 +52,8 @@ The `command:` triggers in this rule's frontmatter ensure it loads the moment on
54
52
 
55
53
  **Dashboard regen cadence — opt-in batching.** The checkbox flip is non-batchable. The **subprocess regen** (`./agent-config roadmap:progress`) is batchable per `roadmap.dashboard_regen_cadence` in `.agent-settings.yml` (`per_step` default · `every_5_steps` · `phase_boundary`). Run end, phase boundary, and any file-shape touch (rename / phase add / archive — Iron Law 1) always force an immediate regen regardless of cadence.
56
54
 
55
+ **Blockers follow same cadence as checkboxes.** Clearing a `## Blockers` entry (per [`templates/roadmaps.md` rule 20](../templates/roadmaps.md)) flips its `Status: resolved`, regenerates dashboard in same reply — Iron Law 1's "same response" obligation applies to blocker resolution exactly as it applies to a checkbox flip.
56
+
57
57
  ## Iron Law 3 — no silent archive with unresolved deferred items
58
58
 
59
59
  ```
@@ -138,4 +138,4 @@ Before sending any reply that landed roadmap work:
138
138
  Any "no" at step 2 → reply is incomplete. Do not send. A skipped step 3 regen is fine when cadence permits — checkbox truth lives in the markdown file. Skipping the deferred-resolution gate at step 4 is **never** acceptable; it is the canonical "lost-information" failure mode this rule exists to prevent.
139
139
 
140
140
  Long-form mechanics (failure-mode catalog, Copilot fallback, `[~]` vs `[ ]` semantics, hook + CI defence-in-depth) live in `guideline:agent-infra/roadmap-progress-mechanics`.
141
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
141
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -7,10 +7,8 @@ triggers:
7
7
  - keyword: "active_role"
8
8
  - keyword: "role-mode"
9
9
  - intent: "mode marker"
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
  # Role Mode Adherence
@@ -6,10 +6,8 @@ triggers:
6
6
  - path_prefix: ".agent-src.uncondensed/rules/"
7
7
  routes_to:
8
8
  - "guideline:agent-infra/rule-type-governance"
9
- workspaces:
10
- - agent-config-maintainer
11
- packs:
12
- - meta
9
+ workspaces: [agent-config-maintainer]
10
+ packs: [meta]
13
11
  ---
14
12
 
15
13
  # Rule Type Governance
@@ -17,4 +15,4 @@ packs:
17
15
  **Iron Law.** Choose `always` vs `auto` per the governance table; over-broad `always` rules degrade the kernel budget.
18
16
 
19
17
  Body migrated to `guideline:agent-infra/rule-type-governance` (per P4 of `road-to-kernel-and-router.md`).
20
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
18
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -7,10 +7,8 @@ triggers:
7
7
  - keyword: "automated"
8
8
  - keyword: "assisted"
9
9
  - keyword: "handler"
10
- workspaces:
11
- - agent-config-maintainer
12
- packs:
13
- - meta
10
+ workspaces: [agent-config-maintainer, engineering]
11
+ packs: [meta]
14
12
  ---
15
13
 
16
14
  # Runtime Safety
@@ -6,10 +6,8 @@ alwaysApply: true
6
6
  load_context:
7
7
  - ../contexts/authority/scope-mechanics.md
8
8
  - ../contexts/authority/kernel-rule-edits.md
9
- workspaces:
10
- - engineering
11
- packs:
12
- - engineering-base
9
+ workspaces: [engineering]
10
+ packs: [engineering-base]
13
11
  ---
14
12
 
15
13
  # Scope Control
@@ -33,30 +31,31 @@ The user decides the git shape. Never improvise. Commit specifics: canonical [`c
33
31
  - NEVER push a tag or create a release without permission.
34
32
  - NEVER pin versions, release targets, deprecation dates, or git tags in roadmaps / plans / tickets — they plan **work**, not releases. Detail: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
35
33
  - Task seems to need a separate branch / PR → STOP and **brief before asking** ([`scope-mechanics`](../contexts/authority/scope-mechanics.md)).
36
- - BEFORE the first commit on related work, **inventory** existing branches and open PRs. Plausible base beyond the current branch → STOP and ask with numbered options — never improvise. Commands + 4-option template + diverging-stack failure mode: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
34
+ - BEFORE the first commit on related work, **inventory** existing branches + open PRs; plausible other base → STOP, ask with numbered options. Commands + 4-option template: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
37
35
 
38
- "Explicit permission" = said **this turn or in a standing instruction not yet revoked**. Permission for a different operation does not carry over.
36
+ "Explicit permission" = said **this turn or in an unrevoked standing instruction**. Permission for one operation never carries to another.
39
37
 
40
38
  ## Authoring vs. implementation
41
39
 
42
40
  ```
43
41
  "CREATE / DRAFT" AUTHORIZES THE ARTIFACT, NOT ITS EXECUTION.
44
42
  NEW TASK NEVER INHERITS PRIOR AUTONOMY.
43
+ ARTIFACT SAVED → HARD STOP. NEVER AUTO-OFFER EXECUTION.
45
44
  ```
46
45
 
47
- `create / draft / write / erstelle …` → artifact only. Execution verbs flip scope; mixed → ask. Detail: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
46
+ `create / draft / write / erstelle …` → artifact only. Execution verbs flip scope; mixed → ask. The moment the artifact lands (roadmap, ADR, plan, pitch, ticket), the turn ends — never auto-offer execution; execution needs an explicit execution verb (`implement`, `build`, `start`, `arbeite ab`) on a later turn. Detail + anti-patterns: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
48
47
 
49
48
  ## Production, infrastructure, bulk-destructive — Hard Floor
50
49
 
51
- A subset is **never** autonomous, regardless of standing autonomy. Canonical: [`non-destructive-by-default`](non-destructive-by-default.md). Triggers (prod-branch merges, deploys, prod data / infra, bulk-destructive) + this-turn-only clarification: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
50
+ A subset is **never** autonomous. Canonical: [`non-destructive-by-default`](non-destructive-by-default.md); triggers + this-turn-only clarification: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
52
51
 
53
52
  ## Kernel-rule edits — slow-rollout guarantee
54
53
 
55
- Own PR, ≥ 24 h between merges. Autonomous mandate does not lift — soak guarantee. CI / labels / scope: [`kernel-rule-edits`](../contexts/authority/kernel-rule-edits.md).
54
+ Own PR, ≥ 24 h between merges; autonomous mandate does not lift (soak guarantee). CI/labels/scope: [`kernel-rule-edits`](../contexts/authority/kernel-rule-edits.md).
56
55
 
57
56
  ## Decline = silence — no re-asking on the same task
58
57
 
59
- After the user **declines** a proposal (branch switch, PR creation, tag/release, separate worktree, version pinning), do **not** raise it again on the same task. Decline stands until reopened. Timing: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
58
+ After the user **declines** a proposal (branch switch, PR, tag/release, worktree, version pinning), do **not** raise it again on the same task — decline stands until reopened. Timing: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
60
59
 
61
60
  ## Fenced step — user-set review gates
62
61
 
@@ -65,4 +64,4 @@ USER FENCED OFF EXECUTION → DELIVER + HAND BACK.
65
64
  NO "READY TO IMPLEMENT?" / "PHASE 1?" RE-ASK.
66
65
  ```
67
66
 
68
- Fence (*"plan only"*, *"review first"*, German equivalents) stands until reopened — like `Decline = silence`. Follow-ups cover the deliverable, not its execution. Failure modes + bypass: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
67
+ Fence (*"plan only"*, *"review first"*, DE equivalents) stands until reopened. Follow-ups cover the deliverable, not its execution. Failure modes + bypass: [`scope-mechanics`](../contexts/authority/scope-mechanics.md).
@@ -2,21 +2,20 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  alwaysApply: false
5
- description: "Security-sensitive paths — auth, billing, tenants, secrets, uploads, webhooks, public endpoints — threat-model BEFORE editing"
5
+ description: "Security-sensitive paths (auth, billing, tenants, secrets, uploads, webhooks) — threat-model BEFORE editing"
6
6
  triggers:
7
7
  - keyword: "auth"
8
8
  - keyword: "billing"
9
9
  - keyword: "tenant"
10
10
  - keyword: "secret"
11
11
  - keyword: "webhook"
12
+ - keyword: "password"
12
13
  validator_ignore:
13
14
  - type: "substring"
14
15
  pattern: "../../docs/"
15
16
  reason: "See-also routes to docs/threat-model.md — the canonical attack-surface doc lives there by design."
16
- workspaces:
17
- - engineering
18
- packs:
19
- - engineering-base
17
+ workspaces: [engineering]
18
+ packs: [engineering-base]
20
19
  ---
21
20
 
22
21
  # Security-Sensitive Stop Rule
@@ -8,10 +8,8 @@ triggers:
8
8
  - intent: "create skill"
9
9
  - intent: "create command"
10
10
  - intent: "create guideline"
11
- workspaces:
12
- - agent-config-maintainer
13
- packs:
14
- - meta
11
+ workspaces: [agent-config-maintainer]
12
+ packs: [meta]
15
13
  ---
16
14
 
17
15
  # size-enforcement
@@ -8,10 +8,8 @@ triggers:
8
8
  - keyword: "pipeline"
9
9
  routes_to:
10
10
  - "skill:skill-improvement-pipeline"
11
- workspaces:
12
- - agent-config-maintainer
13
- packs:
14
- - meta
11
+ workspaces: [agent-config-maintainer, engineering]
12
+ packs: [meta]
15
13
  ---
16
14
 
17
15
  # Skill Improvement Trigger
@@ -19,4 +17,4 @@ packs:
19
17
  **Iron Law.** After a meaningful task, trigger the post-task learning capture if `pipelines.skill_improvement` is enabled.
20
18
 
21
19
  Body migrated to `skill:skill-improvement-pipeline` (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).