@event4u/agent-config 7.4.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 (469) hide show
  1. package/.claude-plugin/marketplace.json +11 -1
  2. package/AGENTS.md +9 -9
  3. package/CHANGELOG.md +373 -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/review-changes.md +14 -7
  34. package/dist/agent-src/commands/roadmap/create.md +88 -10
  35. package/dist/agent-src/commands/roadmap/materialize.md +1 -1
  36. package/dist/agent-src/commands/roadmap/process-full.md +15 -2
  37. package/dist/agent-src/commands/roadmap/process-phase.md +18 -6
  38. package/dist/agent-src/commands/roadmap/process-step.md +4 -0
  39. package/dist/agent-src/commands/roadmap.md +1 -1
  40. package/dist/agent-src/commands/security-audit-config.md +1 -1
  41. package/dist/agent-src/commands/sync-agent-settings.md +1 -1
  42. package/dist/agent-src/commands/sync-gitignore/fix.md +42 -6
  43. package/dist/agent-src/commands/team-knowledge/bootstrap.md +106 -0
  44. package/dist/agent-src/commands/team-knowledge/consolidate.md +105 -0
  45. package/dist/agent-src/commands/team-knowledge.md +64 -0
  46. package/dist/agent-src/contexts/authority/commit-mechanics.md +8 -0
  47. package/dist/agent-src/contexts/authority/destructive-mechanics.md +11 -0
  48. package/dist/agent-src/contexts/authority/scope-mechanics.md +25 -0
  49. package/dist/agent-src/contexts/communication/rules-auto/reply-close-mechanics.md +43 -0
  50. package/dist/agent-src/contexts/contracts/agents-md-anatomy.md +1 -1
  51. package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +2 -2
  52. package/dist/agent-src/contexts/contracts/frugality-charter.md +1 -0
  53. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +14 -4
  54. package/dist/agent-src/contexts/execution/autonomy-mechanics.md +11 -0
  55. package/dist/agent-src/contexts/execution/orchestration-telemetry.md +32 -8
  56. package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +107 -0
  57. package/dist/agent-src/contexts/execution/roadmap-process-loop.md +71 -15
  58. package/dist/agent-src/contexts/execution/subagent-steering.md +41 -1
  59. package/dist/agent-src/contexts/override-system.md +1 -1
  60. package/dist/agent-src/personas/brand-strategist.md +0 -1
  61. package/dist/agent-src/personas/data-integrity.md +66 -0
  62. package/dist/agent-src/personas/design-director.md +0 -1
  63. package/dist/agent-src/personas/performance-engineer.md +66 -0
  64. package/dist/agent-src/personas/production-validator.md +73 -0
  65. package/dist/agent-src/rules/agent-authority.md +3 -4
  66. package/dist/agent-src/rules/analysis-skill-routing.md +3 -5
  67. package/dist/agent-src/rules/architecture.md +2 -4
  68. package/dist/agent-src/rules/artifact-drafting-protocol.md +35 -6
  69. package/dist/agent-src/rules/artifact-engagement-recording.md +11 -4
  70. package/dist/agent-src/rules/ask-when-uncertain.md +10 -14
  71. package/dist/agent-src/rules/augment-edit-discipline.md +3 -5
  72. package/dist/agent-src/rules/autonomous-execution.md +3 -5
  73. package/dist/agent-src/rules/brand-consistency.md +3 -5
  74. package/dist/agent-src/rules/brand-source-of-truth.md +3 -5
  75. package/dist/agent-src/rules/cli-output-handling.md +4 -6
  76. package/dist/agent-src/rules/command-suggestion-policy.md +3 -5
  77. package/dist/agent-src/rules/commit-conventions.md +3 -5
  78. package/dist/agent-src/rules/commit-policy.md +8 -10
  79. package/dist/agent-src/rules/content-quoting-floor.md +88 -0
  80. package/dist/agent-src/rules/context-hygiene.md +3 -5
  81. package/dist/agent-src/rules/copilot-routing.md +4 -6
  82. package/dist/agent-src/rules/decision-revisit-gate.md +120 -0
  83. package/dist/agent-src/rules/delegation-policy.md +10 -6
  84. package/dist/agent-src/rules/design-fidelity.md +3 -5
  85. package/dist/agent-src/rules/devcontainer-routing.md +4 -6
  86. package/dist/agent-src/rules/direct-answers.md +13 -17
  87. package/dist/agent-src/rules/docker-commands.md +3 -5
  88. package/dist/agent-src/rules/domain-adoption-policy.md +3 -5
  89. package/dist/agent-src/rules/domain-safety-disclaimer.md +3 -5
  90. package/dist/agent-src/rules/domain-safety-pii.md +7 -8
  91. package/dist/agent-src/rules/domain-safety-retention.md +3 -5
  92. package/dist/agent-src/rules/downstream-changes.md +3 -4
  93. package/dist/agent-src/rules/engineering-safety-floor.md +3 -5
  94. package/dist/agent-src/rules/external-reference-deep-dive.md +3 -5
  95. package/dist/agent-src/rules/fast-path-marker-visibility.md +3 -5
  96. package/dist/agent-src/rules/finance-safety-floor.md +3 -6
  97. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +3 -5
  98. package/dist/agent-src/rules/git-history-discipline.md +3 -5
  99. package/dist/agent-src/rules/guidelines.md +2 -4
  100. package/dist/agent-src/rules/icon-consistency.md +4 -5
  101. package/dist/agent-src/rules/image-likeness-and-rights.md +3 -5
  102. package/dist/agent-src/rules/improve-before-implement.md +5 -5
  103. package/dist/agent-src/rules/invite-challenge.md +3 -5
  104. package/dist/agent-src/rules/language-and-tone.md +13 -15
  105. package/dist/agent-src/rules/laravel-routing.md +3 -5
  106. package/dist/agent-src/rules/laravel-translations.md +3 -5
  107. package/dist/agent-src/rules/legal-safety-floor.md +5 -7
  108. package/dist/agent-src/rules/lethal-trifecta-guard.md +3 -5
  109. package/dist/agent-src/rules/linked-projects-onboarding-gate.md +4 -7
  110. package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +3 -5
  111. package/dist/agent-src/rules/markdown-safe-codeblocks.md +2 -4
  112. package/dist/agent-src/rules/media-governance-routing.md +3 -5
  113. package/dist/agent-src/rules/media-sync-ground-truth.md +3 -5
  114. package/dist/agent-src/rules/minimal-safe-diff.md +5 -5
  115. package/dist/agent-src/rules/missing-tool-handling.md +3 -5
  116. package/dist/agent-src/rules/model-recommendation.md +4 -6
  117. package/dist/agent-src/rules/no-attribution-footers.md +3 -5
  118. package/dist/agent-src/rules/no-cheap-questions.md +5 -8
  119. package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +3 -6
  120. package/dist/agent-src/rules/no-pr-progress-comments.md +3 -6
  121. package/dist/agent-src/rules/no-roadmap-references.md +3 -5
  122. package/dist/agent-src/rules/non-destructive-by-default.md +11 -13
  123. package/dist/agent-src/rules/notes-first-reasoning.md +3 -5
  124. package/dist/agent-src/rules/onboarding-gate.md +4 -6
  125. package/dist/agent-src/rules/output-discipline.md +3 -5
  126. package/dist/agent-src/rules/package-ci-checks.md +3 -5
  127. package/dist/agent-src/rules/persona-governance.md +2 -4
  128. package/dist/agent-src/rules/php-coding.md +3 -5
  129. package/dist/agent-src/rules/preservation-guard.md +2 -4
  130. package/dist/agent-src/rules/provider-lifecycle-discipline.md +3 -5
  131. package/dist/agent-src/rules/reviewer-awareness.md +5 -6
  132. package/dist/agent-src/rules/roadmap-ci-steps-policy.md +3 -5
  133. package/dist/agent-src/rules/roadmap-progress-sync.md +5 -5
  134. package/dist/agent-src/rules/role-mode-adherence.md +2 -4
  135. package/dist/agent-src/rules/rule-type-governance.md +3 -5
  136. package/dist/agent-src/rules/runtime-safety.md +2 -4
  137. package/dist/agent-src/rules/scope-control.md +10 -11
  138. package/dist/agent-src/rules/security-sensitive-stop.md +4 -5
  139. package/dist/agent-src/rules/size-enforcement.md +2 -4
  140. package/dist/agent-src/rules/skill-improvement-trigger.md +3 -5
  141. package/dist/agent-src/rules/skill-quality.md +3 -5
  142. package/dist/agent-src/rules/slash-command-routing-policy.md +3 -5
  143. package/dist/agent-src/rules/source-confidentiality.md +3 -5
  144. package/dist/agent-src/rules/source-discovery-gate.md +3 -5
  145. package/dist/agent-src/rules/source-of-truth.md +3 -5
  146. package/dist/agent-src/rules/strategy-safety-floor.md +3 -5
  147. package/dist/agent-src/rules/symfony-routing.md +4 -6
  148. package/dist/agent-src/rules/telegraph-speak.md +4 -5
  149. package/dist/agent-src/rules/think-before-action.md +7 -4
  150. package/dist/agent-src/rules/token-budget-discipline.md +29 -5
  151. package/dist/agent-src/rules/token-efficiency.md +3 -5
  152. package/dist/agent-src/rules/token-optimizer-maintenance.md +3 -5
  153. package/dist/agent-src/rules/tool-safety.md +2 -4
  154. package/dist/agent-src/rules/ui-audit-gate.md +3 -6
  155. package/dist/agent-src/rules/untrusted-input-defense.md +11 -10
  156. package/dist/agent-src/rules/upstream-proposal.md +4 -6
  157. package/dist/agent-src/rules/user-interaction.md +7 -5
  158. package/dist/agent-src/rules/user-interrupt-priority.md +17 -8
  159. package/dist/agent-src/rules/verify-before-complete.md +12 -22
  160. package/dist/agent-src/scripts/archive_completed_roadmaps.ts +3 -3
  161. package/dist/agent-src/scripts/update_roadmap_progress.ts +197 -7
  162. package/dist/agent-src/skills/adr-create/SKILL.md +52 -42
  163. package/dist/agent-src/skills/adversarial-review/SKILL.md +1 -1
  164. package/dist/agent-src/skills/agent-docs-writing/SKILL.md +18 -0
  165. package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
  166. package/dist/agent-src/skills/ai-council/SKILL.md +14 -1
  167. package/dist/agent-src/skills/blade-ui/SKILL.md +4 -0
  168. package/dist/agent-src/skills/blameless-post-mortem/SKILL.md +0 -3
  169. package/dist/agent-src/skills/brand/SKILL.md +1 -1
  170. package/dist/agent-src/skills/brand-identity/SKILL.md +3 -3
  171. package/dist/agent-src/skills/brand-strategy/SKILL.md +1 -1
  172. package/dist/agent-src/skills/brand-to-tokens/SKILL.md +5 -4
  173. package/dist/agent-src/skills/canvas-design/SKILL.md +6 -0
  174. package/dist/agent-src/skills/check-refs/SKILL.md +7 -4
  175. package/dist/agent-src/skills/code-review/SKILL.md +5 -0
  176. package/dist/agent-src/skills/complexity-first-planning/SKILL.md +6 -5
  177. package/dist/agent-src/skills/condense-memory/SKILL.md +11 -11
  178. package/dist/agent-src/skills/context-authoring/SKILL.md +1 -1
  179. package/dist/agent-src/skills/context-document/SKILL.md +17 -0
  180. package/dist/agent-src/skills/corpus-grounding/SKILL.md +3 -3
  181. package/dist/agent-src/skills/decision-record/SKILL.md +6 -0
  182. package/dist/agent-src/skills/decision-review/SKILL.md +5 -3
  183. package/dist/agent-src/skills/deep-reading-analyst/SKILL.md +6 -1
  184. package/dist/agent-src/skills/design-intelligence/SKILL.md +45 -2
  185. package/dist/agent-src/skills/design-intelligence/references/design-languages.md +1 -1
  186. package/dist/agent-src/skills/design-review/SKILL.md +23 -11
  187. package/dist/agent-src/skills/design-system-capture/SKILL.md +41 -0
  188. package/dist/agent-src/skills/design-system-capture/reference/design-system-json.md +62 -0
  189. package/dist/agent-src/skills/design-tokens/SKILL.md +11 -4
  190. package/dist/agent-src/skills/design-variations/SKILL.md +127 -0
  191. package/dist/agent-src/skills/design-variations/evals/triggers.json +17 -0
  192. package/dist/agent-src/skills/emit-tickets/SKILL.md +4 -4
  193. package/dist/agent-src/skills/existing-ui-audit/SKILL.md +6 -0
  194. package/dist/agent-src/skills/fe-design/SKILL.md +20 -0
  195. package/dist/agent-src/skills/flux/SKILL.md +4 -0
  196. package/dist/agent-src/skills/html-deck/SKILL.md +123 -0
  197. package/dist/agent-src/skills/html-deck/evals/triggers.json +17 -0
  198. package/dist/agent-src/skills/html-deck/templates/deck-shell.html +77 -0
  199. package/dist/agent-src/skills/iconography/SKILL.md +1 -0
  200. package/dist/agent-src/skills/image-editing/evals/triggers.json +13 -13
  201. package/dist/agent-src/skills/judge-artifact-completeness/SKILL.md +136 -0
  202. package/dist/agent-src/skills/judge-artifact-completeness/calibration/fixtures.json +149 -0
  203. package/dist/agent-src/skills/judge-artifact-completeness/evals/triggers.json +17 -0
  204. package/dist/agent-src/skills/judge-artifact-completeness/rubrics/architecture-score.json +73 -0
  205. package/dist/agent-src/skills/judge-artifact-completeness/rubrics/pr-review-score.json +65 -0
  206. package/dist/agent-src/skills/judge-artifact-completeness/rubrics/roadmap-score.json +73 -0
  207. package/dist/agent-src/skills/judge-artifact-completeness/rubrics/ticket-quality-score.json +73 -0
  208. package/dist/agent-src/skills/judge-code-quality/SKILL.md +1 -0
  209. package/dist/agent-src/skills/judge-injection-defense/SKILL.md +99 -0
  210. package/dist/agent-src/skills/judge-injection-defense/calibration/fixtures.json +24 -0
  211. package/dist/agent-src/skills/judge-injection-defense/evals/triggers.json +17 -0
  212. package/dist/agent-src/skills/judge-injection-defense/fixtures/behavioral-fixtures.json +63 -0
  213. package/dist/agent-src/skills/judge-injection-defense/fixtures/coverage-report.md +53 -0
  214. package/dist/agent-src/skills/judge-injection-defense/fixtures/perturbation-taxonomy.json +110 -0
  215. package/dist/agent-src/skills/judge-synthesis/SKILL.md +134 -0
  216. package/dist/agent-src/skills/judge-synthesis/evals/triggers.json +17 -0
  217. package/dist/agent-src/skills/laravel/SKILL.md +0 -1
  218. package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +46 -0
  219. package/dist/agent-src/skills/lint-skills/SKILL.md +6 -6
  220. package/dist/agent-src/skills/logo-generation/SKILL.md +1 -1
  221. package/dist/agent-src/skills/markitdown/SKILL.md +1 -1
  222. package/dist/agent-src/skills/md-language-check/SKILL.md +3 -3
  223. package/dist/agent-src/skills/memory-consolidation/SKILL.md +66 -1
  224. package/dist/agent-src/skills/migration-architect/SKILL.md +1 -0
  225. package/dist/agent-src/skills/module-detect-on-the-fly/SKILL.md +2 -2
  226. package/dist/agent-src/skills/performance-analysis/SKILL.md +2 -0
  227. package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +4 -4
  228. package/dist/agent-src/skills/premortem/SKILL.md +0 -3
  229. package/dist/agent-src/skills/project-analysis-core/SKILL.md +16 -0
  230. package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +18 -0
  231. package/dist/agent-src/skills/react-shadcn-ui/reference/registry.md +59 -0
  232. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +3 -1
  233. package/dist/agent-src/skills/refine-ticket/SKILL.md +5 -1
  234. package/dist/agent-src/skills/release-comms/SKILL.md +47 -46
  235. package/dist/agent-src/skills/roadmap-management/SKILL.md +25 -0
  236. package/dist/agent-src/skills/roadmap-writing/SKILL.md +33 -3
  237. package/dist/agent-src/skills/root-cause-frameworks/SKILL.md +0 -3
  238. package/dist/agent-src/skills/script-writing/SKILL.md +1 -1
  239. package/dist/agent-src/skills/security-audit/SKILL.md +1 -0
  240. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +4 -0
  241. package/dist/agent-src/skills/source-discovery/SKILL.md +22 -3
  242. package/dist/agent-src/skills/sql-writing/SKILL.md +1 -1
  243. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +33 -14
  244. package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +11 -0
  245. package/dist/agent-src/skills/subagent-orchestration/prompts/do-in-steps.md +8 -0
  246. package/dist/agent-src/skills/systematic-debugging/SKILL.md +30 -1
  247. package/dist/agent-src/skills/tailwind-engineer/SKILL.md +4 -0
  248. package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
  249. package/dist/agent-src/skills/threat-modeling/SKILL.md +2 -2
  250. package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
  251. package/dist/agent-src/skills/typography-system/SKILL.md +4 -3
  252. package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +2 -0
  253. package/dist/agent-src/skills/wireframe/SKILL.md +118 -0
  254. package/dist/agent-src/skills/wireframe/evals/triggers.json +17 -0
  255. package/dist/agent-src/templates/agent-settings.md +22 -1
  256. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  257. package/dist/agent-src/templates/command.md +2 -2
  258. package/dist/agent-src/templates/contexts/knowledge-pages.md +116 -0
  259. package/dist/agent-src/templates/hooks/pre-commit-frontmatter +1 -1
  260. package/dist/agent-src/templates/roadmaps.md +70 -2
  261. package/dist/agent-src/templates/rule.md +1 -1
  262. package/dist/agent-src/templates/scripts/README.md +3 -3
  263. package/dist/agent-src/templates/scripts/work_engine/_lib/agent_settings.ts +109 -0
  264. package/dist/agent-src/templates/tickets.md +8 -8
  265. package/dist/cli/commands/recordTriggerEval.test.js +1 -1
  266. package/dist/cli/commands/recordTriggerEval.test.js.map +1 -1
  267. package/dist/cli/initRouting.js +4 -2
  268. package/dist/cli/initRouting.js.map +1 -1
  269. package/dist/cli/registry.js +1 -0
  270. package/dist/cli/registry.js.map +1 -1
  271. package/dist/discovery/deprecation-report.md +1 -1
  272. package/dist/discovery/discovery-manifest.json +802 -258
  273. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  274. package/dist/discovery/discovery-manifest.summary.md +8 -8
  275. package/dist/discovery/orphan-report.md +1 -1
  276. package/dist/discovery/packs.json +46 -28
  277. package/dist/discovery/trust-report.md +12 -11
  278. package/dist/discovery/workspaces.json +32 -18
  279. package/dist/install/preflight.js +173 -0
  280. package/dist/install/preflight.js.map +1 -0
  281. package/dist/mcp/registry-manifest.json +4 -4
  282. package/dist/router.json +1 -1
  283. package/dist/server/routes/settings.js +4 -0
  284. package/dist/server/routes/settings.js.map +1 -1
  285. package/dist/server/schemas/settings.js +6 -1
  286. package/dist/server/schemas/settings.js.map +1 -1
  287. package/docs/CLAIMS.md +108 -0
  288. package/docs/MIGRATION.md +3 -3
  289. package/docs/architecture.md +6 -6
  290. package/docs/benchmark.md +133 -2
  291. package/docs/benchmark.pinned.yml +31 -0
  292. package/docs/capability-matrix.md +1 -0
  293. package/docs/catalog.md +92 -74
  294. package/docs/command-flows.md +16 -4
  295. package/docs/comparison.yaml +35 -0
  296. package/docs/contracts/agents-layout.md +148 -0
  297. package/docs/contracts/brand-token-consumption.md +5 -0
  298. package/docs/contracts/capability-boundary.md +5 -0
  299. package/docs/contracts/command-category-governance.md +5 -0
  300. package/docs/contracts/command-clusters.md +1 -0
  301. package/docs/contracts/command-surface-tiers.md +1 -1
  302. package/docs/contracts/conformance.md +84 -0
  303. package/docs/contracts/creative-pack-boundary.md +5 -0
  304. package/docs/contracts/discovery-manifest.schema.json +5 -4
  305. package/docs/contracts/file-ownership-matrix.json +4605 -985
  306. package/docs/contracts/governance-enforcement-projection.md +5 -0
  307. package/docs/contracts/gui-wizard.md +1 -1
  308. package/docs/contracts/hook-architecture-v1.md +2 -2
  309. package/docs/contracts/implement-ticket-flow.md +1 -1
  310. package/docs/contracts/kernel-membership.md +13 -0
  311. package/docs/contracts/mcp-tool-inventory.md +23 -23
  312. package/docs/contracts/no-runtime-boundary.md +6 -1
  313. package/docs/contracts/review-lens-schema.md +5 -0
  314. package/docs/contracts/rule-router.md +102 -8
  315. package/docs/contracts/skill-bundled-assets.md +1 -1
  316. package/docs/contracts/skill-dry-run.md +1 -1
  317. package/docs/contracts/subagent-boundary.md +5 -0
  318. package/docs/contracts/ticket-bundle-format.md +9 -4
  319. package/docs/contracts/tier-3-contrib-plugin.md +2 -2
  320. package/docs/contracts/write-engine.md +3 -0
  321. package/docs/customization.md +87 -15
  322. package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +1 -1
  323. package/docs/decisions/ADR-109-subagent-v1-contract.md +246 -0
  324. package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +105 -0
  325. package/docs/decisions/INDEX.md +2 -0
  326. package/docs/distribution/awesome-list-submission.md +46 -0
  327. package/docs/distribution/launch-story-draft.md +58 -0
  328. package/docs/end-to-end-walkthroughs.md +2 -2
  329. package/docs/getting-started.md +2 -2
  330. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +24 -0
  331. package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
  332. package/docs/guidelines/agent-infra/linked-projects-onboarding-gate.md +2 -2
  333. package/docs/guidelines/agent-infra/missing-tool-handling.md +3 -3
  334. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +2 -2
  335. package/docs/guidelines/augment-portability-patterns.md +1 -1
  336. package/docs/guidelines/code-clarity.md +19 -0
  337. package/docs/guidelines/design-antipatterns-triggers.json +2 -1
  338. package/docs/guidelines/design-antipatterns.md +35 -0
  339. package/docs/guidelines/design-canon.md +62 -0
  340. package/docs/guidelines/design-modes.md +6 -0
  341. package/docs/guidelines/php/general.md +9 -1
  342. package/docs/guidelines/php/php-coding-patterns.md +7 -0
  343. package/docs/guides/cross-repo-retrieval.md +1 -1
  344. package/docs/guides/frontend-design-corpus-refresh.md +2 -2
  345. package/docs/guides/local-analytics.md +4 -4
  346. package/docs/guides/skill-discovery.md +1 -1
  347. package/docs/guides/skill-preview.md +1 -1
  348. package/docs/hook-payload-capture.md +6 -6
  349. package/docs/install-friction-report.md +66 -0
  350. package/docs/installation.md +1 -1
  351. package/docs/maintainers/optional-media-deps.md +50 -0
  352. package/docs/mcp-server.md +11 -12
  353. package/docs/media/proof-demo.cast +14 -0
  354. package/docs/media/proof-demo.gif +0 -0
  355. package/docs/migration/consumer-template-consumption-model.md +1 -1
  356. package/docs/migration/divergences/bench-stats-float-precision.md +1 -1
  357. package/docs/migration/node-floor.md +1 -1
  358. package/docs/migration/yaml-roundtrip-spike.md +1 -1
  359. package/docs/personas.md +16 -5
  360. package/docs/positioning-evidence.md +86 -0
  361. package/docs/proof.md +86 -0
  362. package/docs/skills-catalog.md +1 -1
  363. package/docs/troubleshooting.md +8 -8
  364. package/docs/wedge/production-validator/README.md +57 -0
  365. package/docs/wedge/production-validator/production-validator.md +56 -0
  366. package/docs/wizard.md +2 -2
  367. package/package.json +1 -1
  368. package/src/config/agent-settings.template.yml +71 -4
  369. package/src/config/agents-paths.yml +254 -0
  370. package/src/config/budgets.yml +16 -0
  371. package/src/config/discovery/packs.yml +1 -0
  372. package/src/config/discovery/unassigned-artefacts.yml +2 -0
  373. package/src/config/gitignore-block.txt +25 -0
  374. package/src/config/host-capabilities.yml +31 -0
  375. package/src/config/profiles/balanced.ini +4 -0
  376. package/src/config/profiles/full.ini +4 -0
  377. package/src/config/profiles/minimal.ini +4 -0
  378. package/src/scripts/_cli/cmd_conformance.ts +716 -0
  379. package/src/scripts/_cli/cmd_doctor.ts +23 -2
  380. package/src/scripts/_cli/cmd_fleet.ts +401 -0
  381. package/src/scripts/_cli/cmd_preflight.ts +159 -0
  382. package/src/scripts/_dispatch.bash +10 -0
  383. package/src/scripts/_lib/knowledge_events.ts +193 -0
  384. package/src/scripts/_lib/subagent_steering.ts +115 -3
  385. package/src/scripts/_lib/text_similarity.ts +75 -0
  386. package/src/scripts/ai-video/test-pipeline.sh +1 -1
  387. package/src/scripts/ai_council/clients.ts +19 -3
  388. package/src/scripts/append_contested.ts +112 -0
  389. package/src/scripts/audit_auto_rules.ts +11 -1
  390. package/src/scripts/audit_mcp_tools.ts +25 -11
  391. package/src/scripts/bench_ab_v2_run.ts +527 -40
  392. package/src/scripts/bench_ab_v2_stats.ts +6 -0
  393. package/src/scripts/bench_matrix.ts +266 -0
  394. package/src/scripts/bootstrap_knowledge.ts +267 -0
  395. package/src/scripts/build_discovery_manifest.ts +42 -2
  396. package/src/scripts/build_proof.ts +214 -0
  397. package/src/scripts/check_always_budget.ts +3 -0
  398. package/src/scripts/check_augment_description_cap.ts +2 -2
  399. package/src/scripts/check_claims.ts +270 -0
  400. package/src/scripts/check_comparison.ts +79 -0
  401. package/src/scripts/check_generated_artefact_headers.ts +109 -0
  402. package/src/scripts/check_generator_output_coverage.ts +142 -0
  403. package/src/scripts/check_gitignore_freshness.ts +127 -0
  404. package/src/scripts/check_knowledge_pages.ts +210 -0
  405. package/src/scripts/check_knowledge_sharing.ts +162 -0
  406. package/src/scripts/check_media_deps.ts +91 -0
  407. package/src/scripts/check_memory_contradiction.ts +280 -0
  408. package/src/scripts/check_memory_similarity.ts +134 -0
  409. package/src/scripts/check_quality_regression.ts +56 -10
  410. package/src/scripts/check_references.ts +3 -1
  411. package/src/scripts/check_release_pr_shape.ts +4 -0
  412. package/src/scripts/check_site_links.ts +135 -0
  413. package/src/scripts/check_skill_gaps.ts +99 -0
  414. package/src/scripts/check_token_quality_golden.ts +197 -11
  415. package/src/scripts/check_tracked_but_ignored.ts +67 -0
  416. package/src/scripts/cluster_near_miss_patterns.ts +0 -0
  417. package/src/scripts/compile_router.ts +30 -3
  418. package/src/scripts/condense.ts +350 -14
  419. package/src/scripts/consolidate_knowledge_events.ts +192 -0
  420. package/src/scripts/degrade_to_pointer.ts +136 -0
  421. package/src/scripts/design_slop_rules.test.ts +208 -0
  422. package/src/scripts/design_slop_rules.ts +530 -0
  423. package/src/scripts/emit_knowledge_event.ts +158 -0
  424. package/src/scripts/export_replay_corpus.ts +187 -0
  425. package/src/scripts/external_sources_denylist.json +14 -3
  426. package/src/scripts/fold_intake.ts +281 -0
  427. package/src/scripts/generate_capability_matrix.ts +9 -1
  428. package/src/scripts/generate_knowledge_index.ts +222 -0
  429. package/src/scripts/hook_manifest.yaml +40 -17
  430. package/src/scripts/hooks/design_slop_hook.ts +181 -0
  431. package/src/scripts/hooks/dispatch_hook.ts +18 -0
  432. package/src/scripts/hot_context_hook.ts +372 -0
  433. package/src/scripts/install +47 -0
  434. package/src/scripts/install-hooks.sh +17 -0
  435. package/src/scripts/inventory_meta_layers.ts +11 -0
  436. package/src/scripts/janitor.ts +258 -0
  437. package/src/scripts/lint_agent_security.ts +1 -0
  438. package/src/scripts/lint_agents_layout.ts +74 -15
  439. package/src/scripts/lint_bench_ab.ts +4 -1
  440. package/src/scripts/lint_confusables.ts +197 -0
  441. package/src/scripts/lint_design_slop.ts +245 -0
  442. package/src/scripts/lint_featured_skills.ts +0 -0
  443. package/src/scripts/lint_framework_leakage_allowlist.json +26 -3
  444. package/src/scripts/lint_knowledge_scale.ts +250 -0
  445. package/src/scripts/lint_legal_pack.ts +67 -0
  446. package/src/scripts/lint_persona_governance.ts +8 -3
  447. package/src/scripts/lint_regression.ts +15 -0
  448. package/src/scripts/lint_roadmap_blockers.ts +202 -0
  449. package/src/scripts/lint_roadmap_complexity.ts +81 -2
  450. package/src/scripts/lint_subagent_determinism.ts +125 -0
  451. package/src/scripts/measure_augment_budget.ts +46 -6
  452. package/src/scripts/measure_patterns.ts +4 -3
  453. package/src/scripts/measure_skill_reduction.ts +6 -6
  454. package/src/scripts/migration_status.ts +6 -2
  455. package/src/scripts/mine_missing_guardrails.ts +189 -0
  456. package/src/scripts/parity/phase_gate.ts +1 -1
  457. package/src/scripts/parity/replay.ts +21 -0
  458. package/src/scripts/project_thin_rules.ts +120 -16
  459. package/src/scripts/release.ts +39 -1
  460. package/src/scripts/render_benchmark_composite.ts +378 -0
  461. package/src/scripts/roadmap_progress_hook.ts +101 -43
  462. package/src/scripts/schemas/skill.schema.json +27 -0
  463. package/src/scripts/schemas/subagent.schema.json +106 -0
  464. package/src/scripts/skill_linter.ts +1 -0
  465. package/src/scripts/smoke/kernel.sh +5 -4
  466. package/src/scripts/surface-tiers.yml +1 -0
  467. package/src/scripts/sync_gitignore.ts +4 -0
  468. package/src/scripts/update_skill_candidates.ts +172 -0
  469. package/src/scripts/validate_frontmatter.ts +1 -0
@@ -2,8 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "2b"
4
4
  alwaysApply: false
5
- source: "package"
6
- description: "Delegable multi-part work + auto-orchestration enabled — decompose, tier-size each slice, dispatch to subagents instead of doing it all in-session"
5
+ description: "Delegable multi-part work + auto-orchestration on — decompose, tier-size, dispatch to subagents instead of in-session"
7
6
  triggers:
8
7
  - keyword: "delegate"
9
8
  - keyword: "orchestrate"
@@ -12,15 +11,15 @@ triggers:
12
11
  - phrase: "review these"
13
12
  - phrase: "analyze the codebase"
14
13
  - phrase: "for each"
14
+ - keyword: "analyse"
15
+ - keyword: "analyze"
15
16
  load_context:
16
17
  - "../contexts/execution/auto-orchestration-activation.md"
17
18
  - "../contexts/execution/auto-dispatch-classification.md"
18
19
  routes_to:
19
20
  - "skill:subagent-orchestration"
20
- workspaces:
21
- - engineering
22
- packs:
23
- - engineering-base
21
+ workspaces: [engineering]
22
+ packs: [engineering-base]
24
23
  ---
25
24
 
26
25
  # Delegation Policy
@@ -68,6 +67,11 @@ primitive → run in-session (clean no-op).
68
67
  [`verify-budget`](../contexts/execution/verify-budget.md); the cross-model
69
68
  judge Iron Law and the N=3 budget ([`autonomous-execution`](autonomous-execution.md))
70
69
  are never lifted.
70
+ 5. **Respect the failure-type stop and the ordering gate** — two consecutive
71
+ verification-failed returns from one subagent type stop that type for the
72
+ session (an application of the N=3 budget, no new mechanism); an ordered
73
+ slice never dispatches before its declared parent's return is verified.
74
+ Both per [`subagent-steering`](../contexts/execution/subagent-steering.md).
71
75
 
72
76
  ## Scope — does NOT
73
77
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "A provided prototype / mockup / design system is the run's spec — build it 1:1; never swap fonts, controls, components, or layout without confirmation. Strictness: design.fidelity_mode."
4
+ description: "A provided prototype/mockup/design system is the spec — build 1:1; never swap fonts, controls, or layout unconfirmed"
5
5
  triggers:
6
6
  - keyword: "prototype"
7
7
  - keyword: "mockup"
@@ -17,10 +17,8 @@ applies_to_user_types:
17
17
  - "creator"
18
18
  - "developer"
19
19
  - "maintainer"
20
- workspaces:
21
- - engineering
22
- packs:
23
- - engineering-base
20
+ workspaces: [engineering]
21
+ packs: [frontend-design]
24
22
  ---
25
23
 
26
24
  # Design Fidelity
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "3"
4
- description: "Wiring DevContainers/Codespaces — devcontainer.json, images, VS Code features, port forwarding — route to the devcontainer skill"
4
+ description: "Wiring DevContainers/Codespaces (devcontainer.json, features, ports) — route to the devcontainer skill"
5
5
  triggers:
6
6
  - keyword: "devcontainer"
7
7
  - keyword: "codespaces"
@@ -9,10 +9,8 @@ triggers:
9
9
  - phrase: "devcontainer.json"
10
10
  routes_to:
11
11
  - "skill:devcontainer"
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
  # Devcontainer Routing
@@ -20,4 +18,4 @@ packs:
20
18
  **Iron Law.** Wiring the dev environment itself (DevContainers, Codespaces, `devcontainer.json`, VS Code features) → load the `devcontainer` skill, not `copilot-config` (which tunes the Copilot AI on top).
21
19
 
22
20
  Body migrated to `skill:devcontainer`. Disambiguates the devcontainer ↔ copilot-config cluster head per [`adr-architectural-consensus-mechanism`](../docs/contracts/adr-architectural-consensus-mechanism.md).
23
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
21
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -3,10 +3,8 @@ type: "always"
3
3
  tier: "3"
4
4
  description: "Always — direct, unembellished answers. No flattery, no invented facts (verify load-bearing claims, otherwise ask). Emojis only as functional markers. Brevity is the default."
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
  # Direct Answers
@@ -22,7 +20,7 @@ ANSWER THE SUBSTANCE. SHIP THE TRUTH.
22
20
 
23
21
  - No subjective judgment on user code unless evaluation was asked.
24
22
  - "Good catch" / "you're right" only when literally true.
25
- - Mistakes — one-sentence acknowledge, switch behavior, no apology theatre.
23
+ - Mistakes — acknowledge in one sentence, switch behavior, no apology theatre.
26
24
 
27
25
  ## Iron Law 2 — No Invented Facts (severity-tiered)
28
26
 
@@ -34,7 +32,7 @@ WHEN VERIFICATION IS NOT WORTH THE COST → ASK.
34
32
 
35
33
  Severity tiers (High = load-bearing · Medium = project-shape · Low = idioms), per-tier verification actions, and "just guess" override: [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md).
36
34
 
37
- **Live-state facts — never from memory.** Git/PR **merge, branch, sync, and existence** state is High-severity and decays silently: a branch may already be merged, a PR already closed, `main` already ahead, a worktree already updated. NEVER assert "merged / not merged / pending / still open / already in `main` / out of scope" — or any branch/sync/existence claim — from memory, a roadmap note, an earlier turn, or a recalled memory. Run the live check FIRST (`git log --first-parent origin/main`, `git branch -r --contains <ref>`, `gh pr view <n> --json state,mergedAt,baseRefName`); a state question is self-answering (per [`git-workflow`](../skills/git-workflow/SKILL.md)). Same for any external system whose state can change behind you (CI run, deploy, remote queue).
35
+ **Live-state facts — never from memory.** Git/PR merge/branch/sync/existence state is High-severity and decays silently (branch already merged, PR already closed, `main` already ahead). NEVER assert "merged / not merged / pending / still open / already in `main` / out of scope" — or any branch/sync/existence claim — from memory, a roadmap note, an earlier turn, or a recalled memory. Run the live check FIRST (`git log --first-parent origin/main`, `git branch -r --contains <ref>`, `gh pr view <n> --json state,mergedAt,baseRefName`); a state question is self-answering (per [`git-workflow`](../skills/git-workflow/SKILL.md)). Same for any external system that changes behind you (CI run, deploy, remote queue).
38
36
 
39
37
  ## Iron Law 3 — Brevity by Default
40
38
 
@@ -43,24 +41,22 @@ THE SHORTEST REPLY THAT FULLY ANSWERS THE QUESTION IS THE RIGHT REPLY.
43
41
  LONG ANSWERS ARE A FAILURE MODE, NOT A SIGN OF EFFORT.
44
42
  ```
45
43
 
46
- - Skip restating the question; skip "Let me…" intent announcements.
47
- - Skip explaining tool use — the call result speaks.
48
- - Skip post-hoc summary unless rechecking a decision.
49
- - Multi-step → bullets. One-true-answer → one sentence.
44
+ - Skip restating the question; skip "Let me…" announcements.
45
+ - Skip explaining tool use — the result speaks.
46
+ - Simple replies skip summary; **work replies** (multi-step change, roadmap/branch progress, created/updated PR) close with ONE end-summary, and a PR created this turn puts its raw URL as the **literal last line**.
47
+ - Multi-step → bullets; one-true-answer → one sentence.
50
48
 
51
- Never overrides `user-interaction` (numbered options stay) or command-mandated steps.
49
+ Never overrides `user-interaction` (numbered options) or command steps. Reply-close detail → [`reply-close-mechanics`](../contexts/communication/rules-auto/reply-close-mechanics.md).
52
50
 
53
- **Narration carve-out:** restore narration only when both `personal.play_by_play` AND `verbosity.intent_announcements` are `true` in `.agent-settings.yml`.
51
+ **Narration carve-out:** only when both `personal.play_by_play` AND `verbosity.intent_announcements` are `true`.
54
52
 
55
53
  ## Emoji Scope — functional markers only
56
54
 
57
- **Whitelist:** mode markers (`role-mode-adherence`); CLI status `❌` / `✅` / `⚠️`; roadmap checkboxes `[x]` / `[~]` / `[-]`.
58
- **Blacklist:** opening flair (✨, 🚀, 🎉, 💡, 🔥, 👍); empathy (❤️, 🤗, 😊); section dividers; reaction emojis. Unsure → blacklist.
55
+ **Whitelist:** mode markers (`role-mode-adherence`); CLI status `❌`/`✅`/`⚠️`; roadmap checkboxes `[x]`/`[~]`/`[-]`.
56
+ **Blacklist:** opening flair (✨🚀🎉💡🔥👍), empathy (❤️🤗😊), section dividers, reaction emojis. Unsure → blacklist.
59
57
 
60
58
  ## Failure modes & examples
61
59
 
62
- Trigger phrases + correction pattern: [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md).
63
- Pattern Memory (wrong / right / why): [`direct-answers-demos`](../docs/guidelines/agent-infra/direct-answers-demos.md).
64
- Outcome baseline: [`tests/golden/outcomes/direct_answers.json`](../../tests/golden/outcomes/direct_answers.json).
60
+ Triggers + corrections: [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md). Wrong/right/why: [`direct-answers-demos`](../docs/guidelines/agent-infra/direct-answers-demos.md). Baseline: [`tests/golden/outcomes/direct_answers.json`](../../tests/golden/outcomes/direct_answers.json).
65
61
 
66
62
  Cross-rule index: [`frugality-charter`](../contexts/contracts/frugality-charter.md).
@@ -9,10 +9,8 @@ triggers:
9
9
  - phrase: "inside the container"
10
10
  routes_to:
11
11
  - "skill:docker"
12
- workspaces:
13
- - engineering
14
- packs:
15
- - engineering-base
12
+ workspaces: [engineering]
13
+ packs: [engineering-base]
16
14
  ---
17
15
 
18
16
  # Docker Commands
@@ -20,4 +18,4 @@ packs:
20
18
  **Iron Law.** Run PHP / artisan / composer / phpstan / rector / ecs / phpunit inside the project container, never on the host.
21
19
 
22
20
  Body migrated to `skill:docker` (per P4 of `road-to-kernel-and-router.md`).
23
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
21
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).
@@ -2,7 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "2b"
4
4
  alwaysApply: false
5
- description: "Adopting a new domain track (mobile, ML, blockchain, IoT) — gates import on demand, ownership, CI fit, Sunset compat BEFORE harvest"
5
+ description: "Adopting a new domain track (mobile, ML, IoT…) — demand/owner/CI gates BEFORE harvest"
6
6
  triggers:
7
7
  - intent: "adopt new domain"
8
8
  - intent: "harvest new domain track"
@@ -15,10 +15,8 @@ validator_ignore:
15
15
  - type: "substring"
16
16
  pattern: ".agent-src.uncondensed/"
17
17
  reason: "Rule names the authoring tree as the gated-entry location for new domain plates."
18
- workspaces:
19
- - agent-config-maintainer
20
- packs:
21
- - meta
18
+ workspaces: [agent-config-maintainer]
19
+ packs: [meta]
22
20
  ---
23
21
 
24
22
  # Domain Adoption Policy
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Advisory content (legal, medical, financial, consulting) — require matching 'not X advice' disclaimer; refuse diagnosis/dosage outright"
4
+ description: "Advisory content (legal, medical, financial, consulting) — matching 'not X advice' disclaimer; refuse diagnosis/dosage"
5
5
  triggers:
6
6
  - keyword: "legal brief"
7
7
  - keyword: "contract redline"
@@ -37,10 +37,8 @@ applies_to_user_types:
37
37
  - "founder"
38
38
  - "consultant"
39
39
  - "creator"
40
- workspaces:
41
- - agent-config-maintainer
42
- packs:
43
- - meta
40
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
41
+ packs: [meta]
44
42
  ---
45
43
 
46
44
  # Domain Safety — Advisory Disclaimer
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Drafts, logs, exports touching real customer/candidate data — redact direct IDs, use placeholders, flag re-identification on quasi-IDs"
4
+ description: "Drafts/logs/exports with real customer/candidate data — redact direct IDs, placeholders, flag quasi-ID re-identification"
5
5
  triggers:
6
6
  - keyword: "support macro"
7
7
  - keyword: "ticket response"
@@ -40,10 +40,8 @@ routes_to:
40
40
  - "skill:secrets-management"
41
41
  applies_to_user_types:
42
42
  - "all"
43
- workspaces:
44
- - agent-config-maintainer
45
- packs:
46
- - meta
43
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
44
+ packs: [meta]
47
45
  ---
48
46
 
49
47
  # Domain Safety — PII Redaction
@@ -93,9 +91,10 @@ EVER REACHES THE LOG STREAM. ALLOWLISTED STRUCTURED FIELDS ONLY.
93
91
  Required patterns:
94
92
 
95
93
  1. **Allowlisted structured fields only.** Log `user_id`, `tenant_id`, `request_id`, `event_type` — never `user` or `request` blobs.
96
- 2. **Logger-level redaction.** Configure the logger to scrub `email`, `phone`, `name`, `address`, `token`, `password`, `card_number`, `iban` keys recursively from any payload.
97
- 3. **No raw exception payloads.** Exceptions captured by Sentry / Bugsnag must scrub the request body via the SDK's `before_send` hook.
98
- 4. **No log-and-forget for auth flows.** Login / password-reset / token-mint logs never include the credential itself, only the actor + outcome.
94
+ 2. **PII-exclusion-by-construction (preferred over redaction).** Make the log/event **type physically incapable** of holding free-form content — struct of allowlisted scalars, no `payload`/`body`/`extra: any`. A type that cannot carry a phone number has no scrubber to fail; redaction (next) is the fallback when a content field is unavoidable.
95
+ 3. **Logger-level redaction.** Configure the logger to scrub `email`, `phone`, `name`, `address`, `token`, `password`, `card_number`, `iban` keys recursively from any payload.
96
+ 4. **No raw exception payloads.** Exceptions captured by Sentry / Bugsnag must scrub the request body via the SDK's `before_send` hook.
97
+ 5. **No log-and-forget for auth flows.** Login / password-reset / token-mint logs never include the credential itself, only the actor + outcome.
99
98
 
100
99
  Refuse to write `logger.info("User logged in: $request->all()")` or `Log::info($user)` — show allowlisted version instead. Tokens + API keys + webhook secrets follow the same rule under `skill:secrets-management`.
101
100
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Data retention (finance, support/CRM) — name jurisdiction gap, default to longest floor, honor DSR/audit holds, never delete under inquiry"
4
+ description: "Data retention — jurisdiction gap, longest floor, honor DSR/audit holds; never delete under inquiry"
5
5
  triggers:
6
6
  - keyword: "retention policy"
7
7
  - keyword: "data retention"
@@ -25,10 +25,8 @@ applies_to_user_types:
25
25
  - "ops"
26
26
  - "support"
27
27
  - "gtm"
28
- workspaces:
29
- - agent-config-maintainer
30
- packs:
31
- - meta
28
+ workspaces: [agent-config-maintainer, construction, engineering, finance, founder, gtm, legal-review-prep, ops, product, small-business]
29
+ packs: [meta]
32
30
  ---
33
31
 
34
32
  # Domain Safety — Data Retention
@@ -8,10 +8,9 @@ triggers:
8
8
  - keyword: "callers"
9
9
  - keyword: "imports"
10
10
  - keyword: "downstream"
11
- workspaces:
12
- - engineering
13
- packs:
14
- - engineering-base
11
+ - phrase: "api changed"
12
+ workspaces: [engineering]
13
+ packs: [engineering-base]
15
14
  ---
16
15
 
17
16
  # Downstream Changes
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Engineering output touching production, infra, security, data, or external systems — surface blast radius, name rollback path, never autonomous on Hard-Floor triggers"
4
+ description: "Production/infra/security/external-system output — blast radius + rollback; Hard-Floor never autonomous"
5
5
  triggers:
6
6
  - keyword: "production"
7
7
  - keyword: "deploy"
@@ -24,10 +24,8 @@ triggers:
24
24
  routes_to:
25
25
  - "skill:launch-readiness"
26
26
  - "skill:threat-modeling"
27
- workspaces:
28
- - engineering
29
- packs:
30
- - engineering-base
27
+ workspaces: [engineering]
28
+ packs: [engineering-base]
31
29
  ---
32
30
 
33
31
  # Engineering Safety Floor
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2b"
4
- description: "User names external repo/file/URL/artifact as reference — fetch the actual tree and inspect, never summarize from README or metadata"
4
+ description: "User names an external repo/file/URL as reference — fetch the actual tree and inspect; never summarize from README"
5
5
  alwaysApply: false
6
6
  triggers:
7
7
  - intent: "look at how X does it"
@@ -14,10 +14,8 @@ triggers:
14
14
  - keyword: "github.com/"
15
15
  - keyword: "source of truth"
16
16
  - phrase: "reference repo"
17
- workspaces:
18
- - agent-config-maintainer
19
- packs:
20
- - meta
17
+ workspaces: [agent-config-maintainer, engineering]
18
+ packs: [meta]
21
19
  ---
22
20
 
23
21
  # external-reference-deep-dive
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "1"
4
- description: "Low-impact council fast-path dispatch — host MUST surface transparency marker verbatim in reply opening; never paraphrase"
4
+ description: "Low-impact council fast-path — surface the transparency marker verbatim as the reply opener"
5
5
  triggers:
6
6
  - keyword: "low-impact council"
7
7
  - keyword: "fast-path"
@@ -12,10 +12,8 @@ validator_ignore:
12
12
  - type: "substring"
13
13
  pattern: ".agent-src.uncondensed/"
14
14
  reason: "Condenseor injects a back-pointer to the uncondensed source for full failure-modes detail."
15
- workspaces:
16
- - agent-config-maintainer
17
- packs:
18
- - meta
15
+ workspaces: [agent-config-maintainer, engineering]
16
+ packs: [meta]
19
17
  ---
20
18
 
21
19
  # Fast-Path Marker Visibility
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Finance-pack output (runway, valuation, DCF, scenario, unit economics, forecasting) — never issue final invest/raise call; mandatory disclosure footer; sensitivity + counter-case required"
4
+ description: "Finance-pack output (runway, valuation, DCF, scenarios, unit economics) — never a final invest/raise call; disclosure footer"
5
5
  triggers:
6
6
  - keyword: "runway"
7
7
  - keyword: "burn"
@@ -29,11 +29,8 @@ routes_to:
29
29
  - "skill:scenario-modeling"
30
30
  - "skill:unit-economics-modeling"
31
31
  - "skill:forecasting"
32
- workspaces:
33
- - finance
34
- packs:
35
- - finance-basic
36
- - finance-advanced
32
+ workspaces: [finance]
33
+ packs: [finance-basic, finance-advanced]
37
34
  trust:
38
35
  level: advisory
39
36
  human_review_required: true
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Editing a generic skill/rule/command — block single-stack mandates; use language-agnostic procedures with carve-out pointers"
4
+ description: "Editing a generic skill/rule/command — no single-stack mandates; carve-out pointers instead"
5
5
  triggers:
6
6
  - path_prefix: ".agent-src.uncondensed/skills/"
7
7
  - path_prefix: ".agent-src.uncondensed/rules/"
@@ -28,10 +28,8 @@ validator_ignore:
28
28
  - type: "substring"
29
29
  pattern: "scripts/lint_framework_leakage"
30
30
  reason: "Rule cites the enforcing linter script by name in body and enforcement section."
31
- workspaces:
32
- - agent-config-maintainer
33
- packs:
34
- - meta
31
+ workspaces: [agent-config-maintainer]
32
+ packs: [meta]
35
33
  ---
36
34
 
37
35
  # framework-neutrality-in-generic-skills
@@ -2,7 +2,7 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  alwaysApply: false
5
- description: "Git history ops — never rebase/squash/amend without request; never drop/exclude/force-over commits you didn't author (parallel / shared-PR work); once pushed, re-push same turn"
5
+ description: "Git history — no unasked rebase/squash/amend; never drop foreign commits; pushed rewrite → re-push same turn"
6
6
  triggers:
7
7
  - intent: "rebase the branch"
8
8
  - intent: "squash commits"
@@ -26,10 +26,8 @@ triggers:
26
26
  - phrase: "commits I did not create"
27
27
  routes_to:
28
28
  - "skill:git-workflow"
29
- workspaces:
30
- - engineering
31
- packs:
32
- - engineering-base
29
+ workspaces: [engineering]
30
+ packs: [engineering-base]
33
31
  ---
34
32
 
35
33
  # Git History Discipline
@@ -9,10 +9,8 @@ triggers:
9
9
  - intent: "writing code"
10
10
  - intent: "reviewing code"
11
11
  - keyword: "convention"
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
  # Guidelines
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "One icon system per project unless the brand defines otherwise — flag mixed icon sets in a UI (the 'every AI UI is default Lucide' anti-pattern)."
4
+ description: "One icon system per project unless the brand says otherwise — flag mixed icon sets (default-Lucide anti-pattern)"
5
5
  triggers:
6
6
  - keyword: "icon"
7
7
  - keyword: "iconography"
@@ -13,10 +13,8 @@ applies_to_user_types:
13
13
  - "creator"
14
14
  - "developer"
15
15
  - "maintainer"
16
- workspaces:
17
- - engineering
18
- packs:
19
- - frontend-design
16
+ workspaces: [engineering]
17
+ packs: [frontend-design]
20
18
  ---
21
19
 
22
20
  # Icon Consistency
@@ -49,5 +47,6 @@ Any of the trigger keywords appear in a UI-building context: new component, new
49
47
 
50
48
  ## See also
51
49
 
50
+ - [`design-canon.md`](../docs/guidelines/design-canon.md) § Icon systems — when a named design system is in play, prefer its icon set over a fresh Iconify pick.
52
51
  - [`iconography`](../skills/iconography/SKILL.md) — full icon-system selection, audit, and migration workflow.
53
52
  - [`ui-audit-gate`](ui-audit-gate.md) — broader UI consistency gate; runs before any new component lands.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2a"
4
- description: "Rights gate for AI image generation — real-person likenesses, trademarked brand marks, and named living artists' styles require explicit rights/consent check before generation."
4
+ description: "AI image rights gate — real-person likeness, trademarked marks, named artists' styles need explicit rights/consent"
5
5
  triggers:
6
6
  - keyword: "/image:"
7
7
  - keyword: "image generation"
@@ -15,10 +15,8 @@ applies_to_user_types:
15
15
  - "creator"
16
16
  - "developer"
17
17
  - "maintainer"
18
- workspaces:
19
- - agent-config-maintainer
20
- packs:
21
- - meta
18
+ workspaces: [agent-config-maintainer, engineering, gtm]
19
+ packs: [ai-image]
22
20
  ---
23
21
 
24
22
  # Image Likeness and Rights
@@ -1,21 +1,21 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2b"
4
- description: "Before implementing features or architectural changes — validate request against existing code, challenge weak requirements, suggest improvements"
4
+ description: "Before features or architectural changes — validate against existing code, challenge weak requirements"
5
5
  alwaysApply: false
6
6
  council_depth: deep
7
7
  triggers:
8
8
  - intent: "implement feature"
9
9
  - intent: "architectural change"
10
10
  - keyword: "refactor"
11
+ - keyword: "implement"
12
+ - keyword: "migration"
11
13
  validator_ignore:
12
14
  - type: "substring"
13
15
  pattern: ".agent-src.uncondensed/"
14
16
  reason: "Rule cites the authoring tree when describing where examples live."
15
- workspaces:
16
- - engineering
17
- packs:
18
- - engineering-base
17
+ workspaces: [engineering]
18
+ packs: [engineering-base]
19
19
  ---
20
20
 
21
21
  # Improve Before Implement
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: "auto"
3
3
  tier: "2b"
4
- description: "Before executing a complex plan or non-trivial design — ask 'am I solving the right problem?' and pause for user confirmation"
4
+ description: "Before executing a complex plan — ask 'am I solving the right problem?' and pause for confirmation"
5
5
  alwaysApply: false
6
6
  council_depth: deep
7
7
  triggers:
@@ -13,10 +13,8 @@ triggers:
13
13
  - keyword: "design"
14
14
  - keyword: "architecture"
15
15
  - keyword: "approach"
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
  # invite-challenge
@@ -7,10 +7,8 @@ validator_ignore:
7
7
  - type: "substring"
8
8
  pattern: ".agent-src.uncondensed/"
9
9
  reason: "Rule scopes the .md-English mandate to the authoring tree."
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
  # Language and Tone
@@ -27,31 +25,31 @@ NO "SWITCH MID-PARAGRAPH". NO "LAST 20 TURNS WERE ENGLISH".
27
25
  NO "INTER-TOOL COMMENT IS JUST A NOTE" EXCEPTION.
28
26
  ```
29
27
 
30
- Trigger = user's last **chat message**. Not turn count, open file, roadmap, ticket, codebase, tool output, prior reply, or files just edited. Short German (`3`, `weiter`, `mach das`) after many English turns flips the reply to German.
28
+ Trigger = user's last **chat message** — never turn count, open file, roadmap, ticket, codebase, tool output, prior reply, or just-edited files. Short German (`3`, `weiter`, `mach das`) after many English turns → reply in German.
31
29
 
32
30
  ## User-visible prose — every token mirrors
33
31
 
34
- Opening / closing line, **inter-tool commentary** (`Found it`, `Let me check`, `OK`, `Alright`, `Here's`, `So`), section headings, table headers and cells, bullet text, blockquote text, status lines, the `Recommendation:` / `Empfehlung:` label under numbered-options blocks ([`user-interaction`](user-interaction.md) Iron Law 1). Wrong label = violation.
32
+ Mirrors: opening/closing line, **inter-tool commentary** (`Found it`, `Let me check`, `OK`, `Alright`, `Here's`, `So`), headings, table headers + cells, bullets, blockquotes, status lines, the `Recommendation:` / `Empfehlung:` label under numbered-options blocks ([`user-interaction`](user-interaction.md) Iron Law 1). Wrong label = violation.
35
33
 
36
- Stays in source language: code blocks, command output, file contents, quoted tool output, frontmatter keys, file paths, identifier names, log lines.
34
+ Stays source-language: code blocks, command output, file contents, quoted tool output, frontmatter keys, file paths, identifiers, log lines.
37
35
 
38
36
  ## Pre-send gate — MANDATORY
39
37
 
40
- 1. **Detect** — language of user's last chat message. Mixed → dominant; tie → German.
41
- 2. **Scan** — every user-visible token per catalog above.
42
- 3. **Rewrite** — wrong-language token → rewrite the whole reply.
43
- 4. **Confirm** — first sentence in target language; recommendation label matches; no wrong-language filler-phrase opener. Blocklist: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
38
+ 1. **Detect** — language of last chat message. Mixed → dominant; tie → German.
39
+ 2. **Scan** — every user-visible token per catalog.
40
+ 3. **Rewrite** — one wrong-language token → rewrite whole reply.
41
+ 4. **Confirm** — first sentence in target language; recommendation label matches; no wrong-language filler opener. Blocklist: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
44
42
 
45
43
  ## Spelled out
46
44
 
47
45
  - German → informal "Du" (never "Sie"); capitalized at sentence start, lowercase otherwise.
48
- - Code blocks / command output / file contents / quoted tool output stay native; only surrounding prose mirrors.
46
+ - Code blocks / command output / file contents / quoted tool output stay native; surrounding prose mirrors.
49
47
  - Numbered options — `.md` source English; rendered reply translated at runtime.
50
- - Code comments in English. `.md` files in English (see below). Translate existing German `.md` files when touched.
48
+ - Code comments English. `.md` files English (below). Translate existing German `.md` files when touched.
51
49
 
52
50
  ## Slip handling
53
51
 
54
- Acknowledge **once** in the correct language ("Entschuldigung" / "Sorry"). Switch on the same reply. No re-explain in wrong language; no "from now on" promise.
52
+ Acknowledge **once**, correct language ("Entschuldigung" / "Sorry"), switch in the same reply. No wrong-language re-explain; no "from now on" promise.
55
53
 
56
54
  Examples + CLI spacing rules + wrong-vs-correct: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
57
55
 
@@ -59,6 +57,6 @@ Examples + CLI spacing rules + wrong-vs-correct: [`language-and-tone-examples`](
59
57
 
60
58
  All `.md` text under `src/`, `docs/`, `.augment/`, `dist/agent-src/`, `.agent-src.uncondensed/`, `agents/` — prose AND examples, **including generated output** (fix the generator's source strings, never hand-edit the generated page). Agent translates at runtime.
61
59
 
62
- Genuinely-required German uses a sanctioned escape only: a labeled `DE: … · EN: …` anchor (German *prose*), or a per-line `<!-- md-language-check: ignore -->` marker (one quoted trigger example / verbatim provenance quote — never scattered through a generated file).
60
+ Genuinely-required German → one of the two sanctioned escapes (labeled `DE: … · EN: …` anchor, or per-line `<!-- md-language-check: ignore -->` marker) — canonical mechanics in the guideline below.
63
61
 
64
62
  Generated-output rule, escape mechanics, pre-save detection heuristic: [`language-and-tone-examples`](../docs/guidelines/agent-infra/language-and-tone-examples.md).
@@ -9,10 +9,8 @@ triggers:
9
9
  - keyword: "FormRequest"
10
10
  routes_to:
11
11
  - "skill:laravel"
12
- workspaces:
13
- - engineering
14
- packs:
15
- - laravel
12
+ workspaces: [engineering]
13
+ packs: [laravel]
16
14
  trust:
17
15
  level: professional
18
16
  install:
@@ -25,4 +23,4 @@ install:
25
23
  **Iron Law.** Laravel-flavoured PHP (Eloquent, Artisan, FormRequest, jobs, events, policies) → load the `laravel` skill, not `symfony-workflow` and not `php-coder`.
26
24
 
27
25
  Body migrated to `skill:laravel`. Disambiguates the laravel ↔ symfony-workflow cluster head per [`adr-architectural-consensus-mechanism`](../docs/contracts/adr-architectural-consensus-mechanism.md).
28
- Trigger-set above activates this routing under the `balanced` and `full` profiles.
26
+ Trigger-set above activates this routing on demand, independent of the discipline profile (ADR-110).