@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
@@ -1,18 +1,15 @@
1
1
  ---
2
2
  name: root-cause-frameworks
3
3
  description: "Use when tracing the root cause of a resolved incident or recurring bug — 5-whys chain, fishbone categorisation, contributing-factors split — even if the user says 'why does this keep breaking?'."
4
- source: package
5
4
  domain: quality
6
5
  model_tier: high
7
6
  workspaces:
8
7
  - engineering
9
8
  packs:
10
9
  - analysis-workbench
11
- lifecycle: active
12
10
  trust:
13
11
  level: professional
14
12
  confidence: medium
15
- human_review_required: false
16
13
  install:
17
14
  default: false
18
15
  removable: true
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: medium
3
3
  name: script-writing
4
- description: "Use when adding or editing any script under `scripts/` — `--quiet` flag, `_lib/script_output` helpers, silent Taskfile wiring, Iron-Law carve-outs — even when you just say 'add a check script for X'."
4
+ description: "Use when adding or editing any script under `scripts/` — `--quiet`, `_lib/script_output`, silent Taskfile wiring, Iron-Law carve-outs; fires on 'add a check script for X'."
5
5
  domain: process
6
6
  workspaces:
7
7
  - agent-config-maintainer
@@ -3,6 +3,7 @@ model_tier: high
3
3
  name: security-audit
4
4
  description: "ONLY when user explicitly requests: security audit, vulnerability scan, or penetration test review. NOT for regular feature work."
5
5
  domain: quality
6
+ parallelizable: files
6
7
  workspaces:
7
8
  - engineering
8
9
  packs:
@@ -116,6 +116,10 @@ After creation:
116
116
  2. Copy to `.augment/`
117
117
  3. Mark hash: `./scripts-run src/scripts/condense --mark-done "{relative_path}"`
118
118
  4. Regenerate tools: `./scripts-run src/scripts/condense --generate-tools`
119
+ 5. **If from a knowledge page** (`agents/knowledge/procedures/skill-candidates.md`
120
+ or any `agents/knowledge/` page) — degrade the source to a pointer;
121
+ promotion isn't complete otherwise (double-maintenance risk):
122
+ `./scripts-run src/scripts/degrade_to_pointer --source "<knowledge-path>[#<anchor>]" --artifact "{relative_path}" --date "<YYYY-MM-DD>"`
119
123
 
120
124
  ### Step 5: Decide scope
121
125
 
@@ -38,9 +38,9 @@ discover the real source → Evidence Report (Verified / Assumed / Gaps) →
38
38
  Scaffold the report cheaply so it never gets skipped:
39
39
 
40
40
  ```bash
41
- python3 src/scripts/evidence_report.py git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
42
- python3 src/scripts/evidence_report.py init --task "<task>" # writes the gitignored session report
43
- python3 src/scripts/evidence_report.py add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
41
+ ./scripts-run src/scripts/evidence_report git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
42
+ ./scripts-run src/scripts/evidence_report init --task "<task>" # writes the gitignored session report
43
+ ./scripts-run src/scripts/evidence_report add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
44
44
  ```
45
45
 
46
46
  **Provenance on every item** (`observed_at` / `source` / `version`). Within a
@@ -165,6 +165,25 @@ signal, never silently commit); trust and commit are always human-gated. Full mo
165
165
  the three classes + memory tiers:
166
166
  [`project-intelligence`](../../agent-src/contexts/execution/project-intelligence.md).
167
167
 
168
+ ## Knowledge capture (`api_shape_learned` / `convention_detected` events)
169
+
170
+ A confirmed API/GraphQL shape (§B) or an observed coding convention with
171
+ ≥ 2 supporting locations is worth persisting for the team, distinct
172
+ from the per-session Evidence Report above. Append to the knowledge
173
+ intake — never write a tracked page mid-task:
174
+
175
+ ```bash
176
+ ./scripts-run src/scripts/emit_knowledge_event --type api_shape_learned \
177
+ --endpoint "<path>" --method "<verb>" --request-schema '<json>' --response-schema '<json>'
178
+
179
+ ./scripts-run src/scripts/emit_knowledge_event --type convention_detected \
180
+ --pattern "<pattern>" --evidence "file:line" --sample-size <N> --scope project
181
+ ```
182
+
183
+ `/team-knowledge consolidate` turns accumulated events into
184
+ `agents/knowledge/concepts/` pages as a reviewed batch — see
185
+ [`knowledge-pages`](../../templates/contexts/knowledge-pages.md).
186
+
168
187
  ## Gotchas
169
188
 
170
189
  - A card's positive structure is **never** "Verified" on the card alone — it is
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: medium
3
3
  name: sql-writing
4
- description: "Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement` — even when the user just pastes a query and asks 'why is this slow' without naming SQL."
4
+ description: "Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement`; fires even on a pasted query asking 'why is this slow'."
5
5
  domain: engineering
6
6
  workspaces:
7
7
  - engineering
@@ -307,22 +307,41 @@ prefer the cheaper one (`do-and-judge` < `do-and-judge-two-stage` <
307
307
 
308
308
  ### 4. Dispatch
309
309
 
310
- Hand off to the matching command:
311
-
312
- * `do-and-judge` → [`/do-and-judge`](../../commands/do-and-judge.md)
313
- * `do-in-steps` → [`/do-in-steps`](../../commands/do-in-steps.md)
314
- * `judge` (standalone) → [`/judge`](../../commands/judge.md)
315
-
316
- Modes without a dedicated command (`do-in-parallel`,
317
- `do-competitively`, `judge-with-debate`) are orchestrated inline via
318
- the skill — describe the dispatch explicitly in chat so the user can
319
- follow it.
310
+ Use the matching dispatch prompt and orchestrate inline via this skill.
311
+ Describe each dispatch step explicitly in chat so the user can follow it.
312
+
313
+ * `do-and-judge` → [`prompts/do-and-judge.md`](prompts/do-and-judge.md)
314
+ * `do-and-judge-two-stage` → [`prompts/do-and-judge-two-stage.md`](prompts/do-and-judge-two-stage.md)
315
+ * `do-in-steps` → [`prompts/do-in-steps.md`](prompts/do-in-steps.md)
316
+ * `do-in-parallel` → [`prompts/do-in-parallel.md`](prompts/do-in-parallel.md)
317
+ * `do-competitively` → [`prompts/do-competitively.md`](prompts/do-competitively.md)
318
+ * `judge-with-debate` → [`prompts/judge-with-debate.md`](prompts/judge-with-debate.md)
319
+ * `do-in-worktrees` → [`prompts/do-in-worktrees.md`](prompts/do-in-worktrees.md)
320
+ * Standalone judge → judge prompt in [`prompts/do-and-judge.md`](prompts/do-and-judge.md)
320
321
 
321
322
  ### 5. Report
322
323
 
323
324
  Follow the output format below. Never merge a diff without reporting
324
325
  the judge verdict.
325
326
 
327
+ ### 6. Emit telemetry
328
+
329
+ After every auto-dispatched run, write one telemetry line to
330
+ `agents/runtime/state/audit/YYYY-MM.jsonl` (current UTC month — use
331
+ `new Date().toISOString().slice(0, 7)` for the filename). Standard
332
+ audit-log-v1 object with `input_kind: "orchestration"` and an
333
+ `orchestration` sub-object per
334
+ [`orchestration-telemetry.md`](../../agent-src/contexts/execution/orchestration-telemetry.md).
335
+
336
+ Minimal emit (fill what is observable; `token_delta_provenance: "estimated"` if
337
+ host usage metadata is unavailable):
338
+
339
+ ```json
340
+ {"schema_version":1,"id":"<ulid>","ts":"<iso>","work_id":"<work_id>","phase":"implement","outcome":"success","confidence_band":"high","risk_class":"low","input_kind":"orchestration","type":"phase","orchestration":{"task_size_estimate":<int>,"spawn_count":<int>,"tiers":[...],"token_delta":<int>,"token_delta_provenance":"estimated","wall_clock_ms":<int>,"outcome":"DONE","verify_mode":"deterministic"}}
341
+ ```
342
+
343
+ Skip emit when `subagents.enabled: false` or `spawn_count == 0` (in-session run).
344
+
326
345
  ## Gotcha
327
346
 
328
347
  * **Identical model both sides** — same blind spots. The Iron Law
@@ -358,10 +377,10 @@ the judge verdict.
358
377
 
359
378
  | Task | Skill / command |
360
379
  |--------------------------------------|--------------------------------------|
361
- | Configuration reference | [`subagent-configuration`](../../contexts/subagent-configuration.md) |
362
- | Do-and-judge loop | [`/do-and-judge`](../../commands/do-and-judge.md) |
363
- | Stepwise plan with judge gates | [`/do-in-steps`](../../commands/do-in-steps.md) |
364
- | Standalone judge on an existing diff | [`/judge`](../../commands/judge.md) |
380
+ | Configuration reference | [`subagent-configuration`](../../agent-src/contexts/execution/subagent-configuration.md) |
381
+ | Do-and-judge loop | Inline — see [`prompts/do-and-judge.md`](prompts/do-and-judge.md) |
382
+ | Stepwise plan with judge gates | Inline — see [`prompts/do-in-steps.md`](prompts/do-in-steps.md) |
383
+ | Standalone judge on an existing diff | Inline — see judge prompt in [`prompts/do-and-judge.md`](prompts/do-and-judge.md) |
365
384
  | External / networked second opinion | [`ai-council`](../ai-council/SKILL.md) |
366
385
  | Verifying completeness | [`verify-before-complete`](../verify-before-complete/SKILL.md) |
367
386
  | What a subagent owns vs never owns | [`subagent-boundary`](../../../docs/contracts/subagent-boundary.md) |
@@ -22,6 +22,17 @@ Every prompt cites the status taxonomy in
22
22
  ends with the **return-envelope** instruction so the subagent's reply
23
23
  validates against `tests/test_subagent_status_schema.py`.
24
24
 
25
+ ## Prompt-cache discipline
26
+
27
+ When dispatching sibling subagents (e.g. `do-in-parallel` with N independent
28
+ slices), **reuse a stable system-prompt prefix** across all siblings. Keep
29
+ task-invariant text (role declaration, constraints, status enum, return-envelope
30
+ instruction) in the prefix; put only the slice-specific `TASK:` and
31
+ `CONTEXT FILES:` in the variable section. This maximises host-side prompt-cache
32
+ hits (Anthropic `cache_control: ephemeral`) across the cohort — the prefix is
33
+ cached after the first sibling and served from cache for the rest, cutting
34
+ input-token cost proportionally to cohort size.
35
+
25
36
  ## Loading
26
37
 
27
38
  `tests/test_subagent_prompt_loading.py` asserts that every mode named
@@ -60,3 +60,11 @@ already mitigated, DONE. Otherwise DONE_WITH_CONCERNS.
60
60
  A step that returns BLOCKED stops the chain. The orchestrator does not
61
61
  "jump ahead" or re-order — it surfaces the BLOCKED envelope to the user
62
62
  and waits.
63
+
64
+ ## Dependency gate
65
+
66
+ Every step after the first declares its parent (the preceding step). A
67
+ step MUST NOT dispatch before its parent's return passed the judge —
68
+ deterministic reference: `sliceDispatchAllowed()` in
69
+ `src/scripts/_lib/subagent_steering.ts`, contract in
70
+ [`subagent-steering § Ordered-slice dependency gate`](../../../contexts/execution/subagent-steering.md).
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: high
3
3
  name: systematic-debugging
4
- description: "Use when hitting a bug, test failure, crash, or unexpected behavior — enforces reproduce → isolate → hypothesize → verify before any fix — even when the user just says 'this is broken' or 'quick fix'."
4
+ description: "Use on a bug, test failure, crash, or unexpected behavior — enforce reproduce → isolate → hypothesize → verify before any fix; fires even on 'this is broken' / 'quick fix'."
5
5
  domain: discovery
6
6
  council_depth: deep
7
7
  workspaces:
@@ -258,6 +258,35 @@ When reporting debug findings to the user:
258
258
  5. **Fix** — the minimal change
259
259
  6. **Regression test** — the test that catches this bug returning
260
260
 
261
+ ## Knowledge capture (`mistake_made` event)
262
+
263
+ Root cause traces to a `agents/knowledge/` page followed while
264
+ implementing (documented convention wrong, API-shape page stale,
265
+ procedure incomplete) → append a `mistake_made` event to the
266
+ knowledge intake — never rewrite the page mid-task (see
267
+ [`knowledge-pages`](../../templates/contexts/knowledge-pages.md)):
268
+
269
+ ```bash
270
+ ./scripts-run src/scripts/emit_knowledge_event \
271
+ --type mistake_made \
272
+ --error-category "<one or two words>" \
273
+ --context-source "<agents/knowledge/... path, or 'null' if no page was followed>" \
274
+ --correction "<what the fix actually was>" \
275
+ --recurrence-key "<stable slug for this class of mistake>"
276
+ ```
277
+
278
+ Verify the append landed: check the command's exit code (0 =
279
+ appended), then `grep <recurrenceKey> agents/knowledge/intake/events-*.jsonl`
280
+ finds the new line.
281
+
282
+ **Live contradiction exception.** Followed page DEMONSTRABLY wrong
283
+ right now (observed ≠ documented, not a one-off) → hybrid immediate-fix
284
+ case instead — surface the correction, ask before continuing (see
285
+ [`knowledge-pages`](../../templates/contexts/knowledge-pages.md) §
286
+ Contested entries). Approved → isolated fix commit. Declined →
287
+ `./scripts-run src/scripts/append_contested` on that page, then still
288
+ emit the `context_stale` event above for the consolidation pass.
289
+
261
290
  ## Gotchas
262
291
 
263
292
  * Reading half a stack trace and jumping to a fix — the actual cause is
@@ -152,6 +152,10 @@ Risks: <arbitrary values, !important, dark-mode gaps>
152
152
  flow) when the brief allows; cite the design brief's `aesthetic:`
153
153
  line if `fe-design`'s aesthetic-direction section produced one.
154
154
 
155
+ ## Taste Dials
156
+
157
+ `DESIGN.md` `## Taste Dials` → honour: Variance → layout-family spread + asymmetry; Motion → animation budget + reduced-motion posture; Density → spacing scale + info-per-viewport. Absent → follow brief's inferred dials.
158
+
155
159
  ## Do NOT
156
160
 
157
161
  - Do NOT add `!important` to win a specificity fight; restructure
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: medium
3
3
  name: testing-anti-patterns
4
- description: "Use BEFORE writing or changing tests, adding mocks, or putting test-only methods on production classes — five Iron Laws and gates against mocking-the-mock, production pollution, silent partial mocks."
4
+ description: "Use BEFORE writing/changing tests, adding mocks, or test-only methods on production classes — Iron Laws against mocking-the-mock, production pollution, silent partial mocks."
5
5
  domain: quality
6
6
  workspaces:
7
7
  - engineering
@@ -16,8 +16,8 @@ packs:
16
16
 
17
17
 
18
18
  > **Grounded corpus (Tier-1 consultation):** ground surface → threats →
19
- > controls before enumerating from memory — `python3
20
- > <skills-root>/corpus-grounding/scripts/ground.py ground --manifest
19
+ > controls before enumerating from memory — `./scripts-run
20
+ > <skills-root>/corpus-grounding/scripts/ground ground --manifest
21
21
  > <skills-root>/threat-modeling/data/manifest.json "<surface description>"`
22
22
  > returns surface class, ATT&CK/CWE-cited threats, required controls, and
23
23
  > negative tests, with confidence + evidence-gap. Propose grounded
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: medium
3
3
  name: token-optimizer
4
- description: "Use BEFORE any verbose CLI run, large file read, doc conversion, or near-context handoff — single decision tree keyed by intent that cites the canonical token-saving asset. Consult before the action."
4
+ description: "Use BEFORE any verbose CLI run, large file read, doc conversion, or near-context handoff — decision tree keyed by intent citing the canonical token-saving asset."
5
5
  domain: process
6
6
  execution:
7
7
  type: assisted
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: inherit
3
3
  name: typography-system
4
- description: "Derive a type system from a style constraint — query curated font pairings, set scale/line-height/weights, emit DTCG tokens via design-tokens. Use when choosing fonts or building a typographic scale."
4
+ description: "Derive a type system from a style constraint — font pairings, scale/line-height/weights, DTCG tokens via design-tokens. Use to choose fonts or build a typographic scale."
5
5
  domain: product
6
6
  personas: []
7
7
  workspaces:
@@ -54,7 +54,7 @@ degrades gracefully: with no brand layer, only stage 1 runs.
54
54
  `fontSize`, `fontWeight`, `lineHeight`.
55
55
  5. **Verify** — confirm both chosen fonts exist on Google Fonts (check the
56
56
  `Google Fonts URL` column in the CSV); run
57
- `python3 <skills-root>/design-tokens/scripts/tokens.py validate --dir src/`
57
+ `./scripts-run <skills-root>/design-tokens/scripts/tokens validate --dir src/`
58
58
  to confirm no hardcoded font-size or font-family values remain outside the
59
59
  token file; exit code 0 is the evidence.
60
60
 
@@ -72,7 +72,7 @@ style, not the other way around.
72
72
  evidence gap):
73
73
 
74
74
  ```bash
75
- python3 <skills-root>/corpus-grounding/scripts/ground.py search \
75
+ ./scripts-run <skills-root>/corpus-grounding/scripts/ground search \
76
76
  --manifest <skills-root>/brand/data/manifest.json \
77
77
  "<archetype + sector>" --domain typography --json
78
78
  ```
@@ -127,6 +127,7 @@ brand already registers fonts, use them and skip the filter.
127
127
 
128
128
  ## See also
129
129
 
130
+ - [`design-canon.md`](../../../docs/guidelines/design-canon.md) — named-systems + typography-craft (foundry/theory) grounding index; pull to escape the AI-default fonts.
130
131
  - [`design-tokens`](../design-tokens/SKILL.md) — toolchain that generates CSS
131
132
  vars and the Tailwind snippet from `tokens.json`.
132
133
  - [`design-intelligence`](../design-intelligence/SKILL.md) — idiom corpus that
@@ -2,6 +2,8 @@
2
2
  model_tier: medium
3
3
  name: verify-completion-evidence
4
4
  description: "Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs."
5
+ personas:
6
+ - production-validator
5
7
  domain: quality
6
8
  workspaces:
7
9
  - engineering
@@ -0,0 +1,118 @@
1
+ ---
2
+ model_tier: inherit
3
+ name: wireframe
4
+ description: "Explore a flow or layout with 3+ disposable lo-fi greyscale wireframes on a named axis, before any hi-fi work. Use when the user wants to sketch directions or explore structure."
5
+ domain: product
6
+ personas: []
7
+ workspaces:
8
+ - engineering
9
+ packs:
10
+ - frontend-design
11
+ trust:
12
+ level: professional
13
+ install:
14
+ removable: true
15
+ execution:
16
+ type: manual
17
+ ---
18
+
19
+ # Wireframe
20
+
21
+ Produce low-fidelity wireframes or storyboards to explore a flow, layout, or
22
+ information hierarchy before committing to hi-fi design. Wireframes are
23
+ **disposable** — their value is the breadth of options and the decision they
24
+ produce, not the fidelity of any one artifact.
25
+
26
+ ## When to use
27
+
28
+ - The user wants to "explore options", "sketch something out", "see a few
29
+ directions" for a screen, flow, navigation pattern, or hierarchy.
30
+ - The design problem is open enough that hi-fi work would be wasted — the
31
+ structure question is not yet settled.
32
+
33
+ **When NOT to use:** styled, production-viable alternatives on a settled
34
+ structure → [`design-variations`](../design-variations/SKILL.md) (hi-fi,
35
+ branded, recommendation-bearing). A single refined implementation →
36
+ [`fe-design`](../fe-design/SKILL.md) + stack executor.
37
+
38
+ ## Procedure
39
+
40
+ 1. **Confirm the goal.** What is explored (screen / multi-screen flow /
41
+ navigation / hierarchy / interaction model), the imagined user's goal,
42
+ constraints (mobile/desktop, non-negotiable elements), the count
43
+ (3 minimum, 5–6 ceiling), and the **axis of variation**. If the axis is
44
+ open, propose 2–3 (e.g. single-page form vs multi-step wizard vs
45
+ progressive disclosure) and ask which to explore.
46
+ 2. **Hold the lo-fi conventions** so the output reads as wireframe, not as
47
+ broken hi-fi:
48
+ - greyscale only — black, white, 2–3 grays; no brand color;
49
+ - system sans-serif — no type personality yet;
50
+ - labeled boxes for content areas ("headline", "image", "feature card");
51
+ - striped placeholders with monospace size labels for imagery (the
52
+ honest-placeholder pattern in
53
+ [`fe-design § Craft details`](../fe-design/SKILL.md));
54
+ - short label-style skeleton copy ("Headline goes here / one sentence on
55
+ the value prop") — never Lorem ipsum (per `output-discipline`), never
56
+ final copy.
57
+ 3. **Sketch ≥3 variations** on the named axis — layout (centered / split /
58
+ grid), information density, flow structure (single page / multi-step /
59
+ progressive disclosure), CTA placement, navigation pattern. Write each
60
+ variation's distinguishing structure down BEFORE sketching it — left
61
+ unspecified, variations converge on near-identical layouts. Order
62
+ by-the-book → off-distribution; at least one genuinely novel bet.
63
+ 4. **Annotate** — 2–4 numbered callouts per variation naming what is
64
+ interesting and its trade-off ("fastest path, but heavy first
65
+ impression"), placed next to the variation, not in a separate doc.
66
+ 5. **Capture the decision** after the user picks: chosen variation (or
67
+ hybrid), what attracted them, what they explicitly rejected, new
68
+ constraints surfaced. This capture is the brief for the hi-fi follow-up.
69
+ 6. **Hand off** — [`design-variations`](../design-variations/SKILL.md) for
70
+ styled options on the chosen structure, or
71
+ [`design-intelligence`](../design-intelligence/SKILL.md) +
72
+ [`fe-design`](../fe-design/SKILL.md) for a single hi-fi direction. In an
73
+ existing codebase the hi-fi step still passes `existing-ui-audit` per the
74
+ `ui-audit-gate` rule.
75
+
76
+ ## Output format
77
+
78
+ 1. **One file** (HTML or annotated markdown/SVG canvas) with ≥3 greyscale
79
+ variations side-by-side — flows as small storyboards (3–5 screens each);
80
+ no brand color, no styled typography, no real imagery.
81
+ 2. **Per-variation annotations** — 2–4 callouts naming the structural bet and
82
+ its trade-off, inline next to the variation.
83
+ 3. **Decision-capture block** (after user pick) — chosen direction,
84
+ attractions, explicit rejections, new constraints; framed as the hi-fi
85
+ brief.
86
+ 4. **No recommendation ranking** — wireframes surface trade-offs; the pick
87
+ belongs to the user (contrast: `design-variations` closes with a
88
+ recommendation).
89
+
90
+ ## Do NOT
91
+
92
+ - Do NOT apply brand color, brand type, or real imagery — that pulls focus to
93
+ aesthetics before structure is settled.
94
+ - Do NOT polish — wireframes are disposable thinking artifacts.
95
+ - Do NOT write final copy or Lorem ipsum — label-style skeleton copy only.
96
+ - Do NOT let variations converge — write each variation's structure down
97
+ before sketching.
98
+ - Do NOT skip decision capture — an exploration round without a recorded
99
+ decision has to be re-litigated in the hi-fi round.
100
+ - Do NOT embed system internals (paths, skill/tool names) in the artifact —
101
+ Q13 in [`design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md).
102
+
103
+ ## Gotcha
104
+
105
+ - This is the one context where rough, hand-drawn-feeling shapes (rectangles,
106
+ lines, simple icons) are acceptable — everything sits at the same low
107
+ fidelity, so nothing reads as a failed asset (the V4/imagery antipatterns
108
+ apply to hi-fi, not here).
109
+ - The wireframe file tends to get promoted into hi-fi by incremental edits —
110
+ don't. Start the hi-fi artifact fresh from the decision capture; the
111
+ wireframe's greyscale skeleton hard-codes non-decisions.
112
+
113
+ ## See also
114
+
115
+ - [`design-variations`](../design-variations/SKILL.md) — hi-fi options on the chosen structure.
116
+ - [`design-intelligence`](../design-intelligence/SKILL.md) — grounded direction selection for the hi-fi follow-up.
117
+ - [`fe-design`](../fe-design/SKILL.md) — production heuristics + honest-placeholder pattern.
118
+ - [`existing-ui-audit`](../existing-ui-audit/SKILL.md) — mandatory pre-step once hi-fi work lands in a codebase.
@@ -0,0 +1,17 @@
1
+ {
2
+ "skill": "wireframe",
3
+ "last_eval": "2026-07-06",
4
+ "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers lo-fi structure/flow exploration. Should-not-trigger covers near-miss neighbors: design-variations (hi-fi options), fe-design (single implementation), design-review (review existing), design-intelligence (direction selection).",
5
+ "queries": [
6
+ {"q": "sketch a few rough directions for the onboarding flow", "trigger": true},
7
+ {"q": "wireframe the sign-up: single page vs multi-step wizard", "trigger": true},
8
+ {"q": "explore some layout ideas for the dashboard before we style it", "trigger": true},
9
+ {"q": "I'm not sure about the information hierarchy — sketch some low-fi options", "trigger": true},
10
+ {"q": "storyboard three ways the checkout flow could work", "trigger": true},
11
+ {"q": "show me 3 styled design options for the hero section", "trigger": false, "note": "hi-fi options → design-variations"},
12
+ {"q": "build the settings page component", "trigger": false, "note": "single implementation → fe-design / stack executor"},
13
+ {"q": "review this mockup for problems", "trigger": false, "note": "review of existing design → design-review"},
14
+ {"q": "pick a visual direction and font pairing for the app", "trigger": false, "note": "direction selection → design-intelligence / typography-system"},
15
+ {"q": "generate a moodboard image of the landing page", "trigger": false, "note": "image generation → image-provider-routing"}
16
+ ]
17
+ }
@@ -43,7 +43,28 @@ made by the user directly or by the agent on request, following the
43
43
  # This file is git-ignored. Each developer has their own settings.
44
44
  # Run scripts/install to create this file, then /onboard for first-run setup.
45
45
 
46
- # --- Cost profile ---
46
+ # --- Discipline profile (successor knob, opt-in until the evidence gates pass) ---
47
+ #
48
+ # The ONE runtime knob for the discipline-rule tier (ADR-110; council
49
+ # verdicts 2026-07-07). Measured on claude-haiku-4-5, docs/benchmark.md
50
+ # § Cost-factor sweep:
51
+ #
52
+ # off = kernel only (~1x tokens) — for hosts with a MEASURED null
53
+ # lift (src/config/host-capabilities.yml).
54
+ # essential = kernel + the lift-carrying rules (~3.3x, keeps the weak-host
55
+ # discipline lift; the full load's residual is not significant).
56
+ # full = every rule tier (~11.7x). EXPERIMENTAL opt-in only.
57
+ # auto = resolve per session against host-capabilities.yml
58
+ # (measured-null model -> off, otherwise -> essential).
59
+ #
60
+ # When set, this key WINS over the legacy rule_loading_tier below
61
+ # (mapping when absent: minimal->off, balanced->essential, full->full).
62
+ # The installer fills it per preset (minimal->off, balanced->essential,
63
+ # full->full — behaviour-preserving); `auto` is the evidence-gated flip
64
+ # target (roadmap Phase 4).
65
+ discipline_profile: essential
66
+
67
+ # --- Cost profile (legacy knob — superseded by discipline_profile) ---
47
68
  #
48
69
  # Master switch that controls which rule tiers load each session.
49
70
  # See `docs/customization.md` for the authoritative description and
@@ -39,7 +39,7 @@ schema_version: 1
39
39
  # CI guard: a release bump of `package.json` must update this value
40
40
  # in lockstep — see scripts/check_template_pin_drift.py (road-to-
41
41
  # portable-runtime-and-update-check P3.3).
42
- agent_config_version: "5.10.1"
42
+ agent_config_version: "8.0.0"
43
43
 
44
44
  # --- Project identity ---
45
45
  project:
@@ -8,7 +8,7 @@
8
8
  2. Copy the template below
9
9
  3. Replace all `{placeholders}` with actual content
10
10
  4. Remove all `<!-- comments -->` when done
11
- 5. Run: `python3 scripts/skill_linter.py .agent-src.uncondensed/commands/{command-name}.md`
11
+ 5. Run: `./scripts-run src/scripts/skill_linter src/agent-src/commands/{command-name}.md`
12
12
  6. Sync: `task sync` (regenerates `dist/agent-src/` and `.augment/`)
13
13
  7. Generate Claude symlink: `task generate-tools` (or manually create symlink)
14
14
 
@@ -99,7 +99,7 @@ Before considering a command complete:
99
99
  - [ ] **Steps**: numbered sub-headings (`### 1.`, `### 2.`, ...)
100
100
  - [ ] **Source of truth**: works on `.agent-src.uncondensed/`, not `dist/agent-src/` or `.augment/`
101
101
  - [ ] **No auto-apply**: presents findings, asks before destructive changes
102
- - [ ] **Linter passes**: `python3 scripts/skill_linter.py` reports 0 FAIL
102
+ - [ ] **Linter passes**: `./scripts-run src/scripts/skill_linter` reports 0 FAIL
103
103
  - [ ] **English only**: all content in English
104
104
  - [ ] **Synced**: `dist/agent-src/commands/` has the same file
105
105
  - [ ] **Claude symlink**: `.claude/skills/{name}/SKILL.md` → `../../../dist/agent-src/commands/{name}.md`