@event4u/agent-config 14.10.0 → 14.12.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 (667) hide show
  1. package/.augment-plugin/marketplace.json +3 -3
  2. package/.augment-plugin/plugin.json +1 -1
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/CHANGELOG.md +161 -208
  5. package/README.md +1 -1
  6. package/dist/agent-src/commands/design.md +88 -0
  7. package/dist/agent-src/commands/project/analyze.md +47 -0
  8. package/dist/agent-src/commands/review/changes.md +67 -6
  9. package/dist/agent-src/commands/roadmap/create.md +49 -0
  10. package/dist/agent-src/commands/roadmap/next.md +27 -11
  11. package/dist/agent-src/commands/roadmap/process-full.md +14 -0
  12. package/dist/agent-src/commands/video/from-script.md +60 -3
  13. package/dist/agent-src/commands/video/stitch.md +14 -0
  14. package/dist/agent-src/contexts/communication/rules-auto/guidelines-mechanics.md +1 -0
  15. package/dist/agent-src/contexts/execution/evidence-discipline.md +26 -0
  16. package/dist/agent-src/contexts/execution/roadmap-process-loop.md +154 -2
  17. package/dist/agent-src/rules/active-remediation.md +3 -3
  18. package/dist/agent-src/rules/code-provenance.md +2 -2
  19. package/dist/agent-src/rules/context-hygiene.md +13 -33
  20. package/dist/agent-src/rules/council-availability.md +2 -2
  21. package/dist/agent-src/rules/decision-revisit-gate.md +3 -1
  22. package/dist/agent-src/rules/design-fidelity.md +18 -0
  23. package/dist/agent-src/rules/design-review-after-ui-write.md +2 -2
  24. package/dist/agent-src/rules/evaluator-independence.md +56 -44
  25. package/dist/agent-src/rules/fix-what-you-see.md +9 -1
  26. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +1 -1
  27. package/dist/agent-src/rules/minimal-safe-diff.md +14 -20
  28. package/dist/agent-src/rules/missing-skill-recovery.md +13 -1
  29. package/dist/agent-src/rules/playbook-precedence.md +105 -0
  30. package/dist/agent-src/rules/recurring-criticism.md +3 -1
  31. package/dist/agent-src/rules/roadmap-progress-sync.md +14 -13
  32. package/dist/agent-src/rules/scale-discipline.md +24 -0
  33. package/dist/agent-src/rules/security-sensitive-stop.md +2 -2
  34. package/dist/agent-src/rules/settings-ask-protocol.md +2 -2
  35. package/dist/agent-src/rules/ui-audit-gate.md +27 -15
  36. package/dist/agent-src/rules/untrusted-input-defense.md +2 -2
  37. package/dist/agent-src/skills/accessibility-auditor/SKILL.md +19 -0
  38. package/dist/agent-src/skills/adr-create/SKILL.md +7 -0
  39. package/dist/agent-src/skills/agents-md-thin-root/SKILL.md +33 -0
  40. package/dist/agent-src/skills/ai-council/references/advanced-modes.md +17 -3
  41. package/dist/agent-src/skills/ai-council/references/output-and-synthesis.md +31 -0
  42. package/dist/agent-src/skills/ai-council/references/procedure.md +19 -0
  43. package/dist/agent-src/skills/alerting-doctrine/SKILL.md +225 -0
  44. package/dist/agent-src/skills/authz-review/SKILL.md +0 -1
  45. package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +32 -0
  46. package/dist/agent-src/skills/brand/SKILL.md +3 -0
  47. package/dist/agent-src/skills/brand-asset-generation/SKILL.md +3 -0
  48. package/dist/agent-src/skills/brand-audit/SKILL.md +3 -0
  49. package/dist/agent-src/skills/brand-identity/SKILL.md +3 -0
  50. package/dist/agent-src/skills/brand-strategy/SKILL.md +3 -0
  51. package/dist/agent-src/skills/brand-to-tokens/SKILL.md +3 -0
  52. package/dist/agent-src/skills/check-refs/SKILL.md +3 -0
  53. package/dist/agent-src/skills/code-refactoring/SKILL.md +45 -1
  54. package/dist/agent-src/skills/code-review/SKILL.md +75 -5
  55. package/dist/agent-src/skills/command-routing/SKILL.md +6 -0
  56. package/dist/agent-src/skills/command-writing/SKILL.md +35 -0
  57. package/dist/agent-src/skills/condense-memory/SKILL.md +3 -0
  58. package/dist/agent-src/skills/context-authoring/SKILL.md +1 -1
  59. package/dist/agent-src/skills/conventional-commits-writing/SKILL.md +3 -0
  60. package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +10 -0
  61. package/dist/agent-src/skills/corpus-grounding/SKILL.md +3 -0
  62. package/dist/agent-src/skills/design-intelligence/SKILL.md +3 -0
  63. package/dist/agent-src/skills/design-intelligence/data/landing.csv +36 -35
  64. package/dist/agent-src/skills/design-intelligence/data/stacks/threejs.csv +1 -0
  65. package/dist/agent-src/skills/design-review/SKILL.md +79 -1
  66. package/dist/agent-src/skills/design-review/references/verification-automation.md +41 -0
  67. package/dist/agent-src/skills/design-system-capture/SKILL.md +35 -40
  68. package/dist/agent-src/skills/design-system-capture/references/import-procedure.md +50 -0
  69. package/dist/agent-src/skills/design-tokens/SKILL.md +3 -0
  70. package/dist/agent-src/skills/design-variations/SKILL.md +3 -0
  71. package/dist/agent-src/skills/developer-like-execution/SKILL.md +3 -0
  72. package/dist/agent-src/skills/estimate-ticket/SKILL.md +3 -0
  73. package/dist/agent-src/skills/existing-ui-audit/SKILL.md +28 -4
  74. package/dist/agent-src/skills/fe-design/SKILL.md +74 -41
  75. package/dist/agent-src/skills/fe-design/references/craft-floor.md +52 -0
  76. package/dist/agent-src/skills/fe-design/references/source-led-port.md +36 -0
  77. package/dist/agent-src/skills/file-editor/SKILL.md +5 -0
  78. package/dist/agent-src/skills/finishing-a-development-branch/SKILL.md +2 -2
  79. package/dist/agent-src/skills/git-workflow/SKILL.md +3 -0
  80. package/dist/agent-src/skills/html-deck/SKILL.md +3 -0
  81. package/dist/agent-src/skills/iconography/SKILL.md +3 -0
  82. package/dist/agent-src/skills/image-editing/SKILL.md +3 -0
  83. package/dist/agent-src/skills/image-generation/SKILL.md +3 -0
  84. package/dist/agent-src/skills/image-provider-routing/SKILL.md +3 -0
  85. package/dist/agent-src/skills/incident-commander/SKILL.md +10 -0
  86. package/dist/agent-src/skills/js-library-packaging/SKILL.md +173 -0
  87. package/dist/agent-src/skills/js-library-packaging/scripts/check_package_surface.ts +270 -0
  88. package/dist/agent-src/skills/laravel-migration/SKILL.md +3 -0
  89. package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +3 -0
  90. package/dist/agent-src/skills/lint-skills/SKILL.md +3 -0
  91. package/dist/agent-src/skills/llm-provider-knowledge/SKILL.md +3 -0
  92. package/dist/agent-src/skills/logging-monitoring/SKILL.md +234 -51
  93. package/dist/agent-src/skills/logo-generation/SKILL.md +3 -0
  94. package/dist/agent-src/skills/md-language-check/SKILL.md +3 -0
  95. package/dist/agent-src/skills/monorepo-workspace/SKILL.md +149 -0
  96. package/dist/agent-src/skills/motion-choreographer/SKILL.md +6 -0
  97. package/dist/agent-src/skills/multi-tenancy/SKILL.md +4 -0
  98. package/dist/agent-src/skills/operational-readiness/SKILL.md +184 -0
  99. package/dist/agent-src/skills/override-management/SKILL.md +3 -0
  100. package/dist/agent-src/skills/persona-improvement/SKILL.md +3 -0
  101. package/dist/agent-src/skills/pest-testing/SKILL.md +3 -0
  102. package/dist/agent-src/skills/playbook-authoring/SKILL.md +162 -0
  103. package/dist/agent-src/skills/playwright-testing/SKILL.md +3 -0
  104. package/dist/agent-src/skills/privacy-review/SKILL.md +3 -0
  105. package/dist/agent-src/skills/project-analysis-core/SKILL.md +23 -0
  106. package/dist/agent-src/skills/prompt-engineering-image/SKILL.md +3 -0
  107. package/dist/agent-src/skills/quality-tools/SKILL.md +5 -0
  108. package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +81 -33
  109. package/dist/agent-src/skills/readme-reviewer/SKILL.md +3 -0
  110. package/dist/agent-src/skills/readme-writing/SKILL.md +3 -0
  111. package/dist/agent-src/skills/readme-writing-package/SKILL.md +3 -0
  112. package/dist/agent-src/skills/receiving-code-review/SKILL.md +2 -2
  113. package/dist/agent-src/skills/refine-prompt/SKILL.md +3 -0
  114. package/dist/agent-src/skills/refine-ticket/SKILL.md +3 -0
  115. package/dist/agent-src/skills/requesting-code-review/SKILL.md +2 -2
  116. package/dist/agent-src/skills/review-routing/SKILL.md +2 -2
  117. package/dist/agent-src/skills/roadmap-writing/SKILL.md +23 -41
  118. package/dist/agent-src/skills/roadmap-writing/references/follow-up-roadmap-shape.md +47 -0
  119. package/dist/agent-src/skills/rtk-output-filtering/SKILL.md +22 -6
  120. package/dist/agent-src/skills/runway-cognition/SKILL.md +3 -0
  121. package/dist/agent-src/skills/scene-expander/scene-blueprint.schema.yaml +26 -0
  122. package/dist/agent-src/skills/secrets-management/SKILL.md +4 -0
  123. package/dist/agent-src/skills/server-hardening/SKILL.md +159 -0
  124. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +3 -0
  125. package/dist/agent-src/skills/skill-management/SKILL.md +3 -0
  126. package/dist/agent-src/skills/skill-reviewer/SKILL.md +3 -0
  127. package/dist/agent-src/skills/skill-writing/SKILL.md +6 -0
  128. package/dist/agent-src/skills/skill-writing/references/procedure.md +24 -2
  129. package/dist/agent-src/skills/spreadsheet-authoring/SKILL.md +3 -0
  130. package/dist/agent-src/skills/storybook-workshop/SKILL.md +203 -0
  131. package/dist/agent-src/skills/storybook-workshop/scripts/story_contrast_floor.ts +134 -0
  132. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +1 -1
  133. package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +25 -0
  134. package/dist/agent-src/skills/supply-chain-intake/SKILL.md +12 -0
  135. package/dist/agent-src/skills/systematic-debugging/SKILL.md +1 -1
  136. package/dist/agent-src/skills/terraform/SKILL.md +3 -0
  137. package/dist/agent-src/skills/test-driven-development/SKILL.md +1 -1
  138. package/dist/agent-src/skills/threat-modeling/SKILL.md +0 -3
  139. package/dist/agent-src/skills/token-optimizer/SKILL.md +3 -0
  140. package/dist/agent-src/skills/typography-system/SKILL.md +3 -0
  141. package/dist/agent-src/skills/ui-component-architect/SKILL.md +17 -1
  142. package/dist/agent-src/skills/upstream-contribute/SKILL.md +3 -0
  143. package/dist/agent-src/skills/validate-feature-fit/SKILL.md +3 -0
  144. package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +2 -2
  145. package/dist/agent-src/skills/wireframe/SKILL.md +3 -0
  146. package/dist/agent-src/skills/wireframe/references/story-beat-ledger.schema.json +115 -0
  147. package/dist/agent-src/skills/workspace-link/SKILL.md +131 -0
  148. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  149. package/dist/agent-src/templates/playbook.md +75 -0
  150. package/dist/agent-src/templates/roadmaps.md +37 -0
  151. package/dist/agent-src/templates/scripts/check_playbook_invokes.ts +231 -0
  152. package/dist/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +24 -0
  153. package/dist/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +2 -0
  154. package/dist/agent-src/templates/scripts/work_engine/directives/ui/review.ts +216 -0
  155. package/dist/agent-src/templates/scripts/work_engine/directives/ui/scaffold.ts +159 -0
  156. package/dist/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +73 -4
  157. package/dist/agent-src/templates/scripts/work_engine/stack/detect.ts +325 -40
  158. package/dist/cli/commands/uiAudit.js +221 -0
  159. package/dist/cli/commands/uiRender.js +206 -0
  160. package/dist/cli/main.js +22 -1
  161. package/dist/cli/mcp/content.js +64 -1
  162. package/dist/cli/mcp/dispatch.js +175 -10
  163. package/dist/cli/registry.js +3 -0
  164. package/dist/cli-delegate/{chunk-G23AT6GD.js → chunk-DMSZHXZS.js} +57 -1
  165. package/dist/cli-delegate/{chunk-77GR3VD4.js → chunk-FF7WAFMR.js} +58 -3
  166. package/dist/cli-delegate/{chunk-YM4GZDJG.js → chunk-JCW7ZLHK.js} +10 -0
  167. package/dist/cli-delegate/{chunk-H4VIVD4C.js → chunk-JJA2QEWA.js} +413 -391
  168. package/dist/cli-delegate/{chunk-PLSG6UL5.js → chunk-K4FFODTS.js} +341 -204
  169. package/dist/cli-delegate/{chunk-B2ERU2VA.js → chunk-WOKWX5PL.js} +1 -1
  170. package/dist/cli-delegate/cmd_brand_status.js +8 -6
  171. package/dist/cli-delegate/cmd_conformance.js +3 -3
  172. package/dist/cli-delegate/cmd_doctor.js +3 -3
  173. package/dist/cli-delegate/cmd_export.js +4 -4
  174. package/dist/cli-delegate/cmd_handoff.js +1 -1
  175. package/dist/cli-delegate/cmd_preflight.js +2 -2
  176. package/dist/cli-delegate/cmd_prune.js +4 -4
  177. package/dist/cli-delegate/cmd_session_recycle.js +70 -9
  178. package/dist/cli-delegate/cmd_settings_migrate.js +4 -4
  179. package/dist/cli-delegate/cmd_settings_set.js +1 -1
  180. package/dist/cli-delegate/cmd_sync.js +4 -4
  181. package/dist/cli-delegate/cmd_uninstall.js +4 -4
  182. package/dist/cli-delegate/cmd_validate.js +4 -4
  183. package/dist/discovery/deprecation-report.md +1 -1
  184. package/dist/discovery/discovery-manifest.json +362 -127
  185. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  186. package/dist/discovery/discovery-manifest.summary.md +4 -4
  187. package/dist/discovery/dormancy-report.md +1 -1
  188. package/dist/discovery/orphan-report.md +1 -1
  189. package/dist/discovery/packs.json +18 -8
  190. package/dist/discovery/trust-report.md +3 -3
  191. package/dist/discovery/workspaces.json +16 -6
  192. package/dist/hooks/dispatch.js +2575 -1472
  193. package/dist/install/install.mjs +800 -708
  194. package/dist/mcp/registry-manifest.json +3 -3
  195. package/dist/mcp/server.json +2 -2
  196. package/dist/mcp/server.mjs +1685 -1250
  197. package/dist/router.json +1 -1
  198. package/dist/scripts/_lib/lean_projection_mode.js +40 -0
  199. package/dist/scripts/_lib/scoped_projection.js +84 -0
  200. package/dist/scripts/_lib/ui_surface.js +89 -0
  201. package/dist/scripts/condense.js +6 -10
  202. package/dist/scripts/project_thin_rules.js +40 -2
  203. package/dist/server/schemas/settings.js +6 -0
  204. package/dist/shared/skillRanking.js +159 -0
  205. package/docs/contracts/provider-lifecycle.md +47 -18
  206. package/docs/contracts/settings-classes.md +35 -5
  207. package/docs/guidelines/agent-infra/context-hygiene-mechanics.md +49 -0
  208. package/docs/guidelines/agent-infra/downstream-changes-mechanics.md +91 -0
  209. package/docs/guidelines/agent-infra/evaluator-independence-mechanics.md +92 -0
  210. package/docs/guidelines/agent-infra/minimal-safe-diff-mechanics.md +45 -1
  211. package/docs/guidelines/agent-infra/roadmap-deferred-resolution-provenance.md +54 -0
  212. package/docs/guidelines/code-clarity.md +21 -0
  213. package/docs/guidelines/design-antipatterns.md +4 -2
  214. package/docs/guidelines/design-asset-discipline.md +38 -0
  215. package/docs/guidelines/design-fidelity-mechanics.md +45 -29
  216. package/docs/guidelines/design-handover-extraction.md +35 -5
  217. package/docs/guidelines/design-modes.md +41 -1
  218. package/docs/guidelines/monorepo-antipatterns.md +141 -0
  219. package/docs/guidelines/redundancy-taxonomy.md +180 -0
  220. package/llms.txt +50 -39
  221. package/package.json +6 -2
  222. package/src/agent-src/templates/scripts/check_playbook_invokes.ts +231 -0
  223. package/src/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +24 -0
  224. package/src/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +2 -0
  225. package/src/agent-src/templates/scripts/work_engine/directives/ui/review.ts +216 -0
  226. package/src/agent-src/templates/scripts/work_engine/directives/ui/scaffold.ts +159 -0
  227. package/src/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +73 -4
  228. package/src/agent-src/templates/scripts/work_engine/stack/detect.ts +325 -40
  229. package/src/config/agent-settings.template.yml +44 -0
  230. package/src/config/assurance-capability-registry.json +223 -0
  231. package/src/config/assurance-threshold-budget.json +65 -0
  232. package/src/config/budgets.yml +19 -0
  233. package/src/config/ci-local-parity.yml +29 -0
  234. package/src/config/discovery/prompt-patterns.yml +56 -0
  235. package/src/config/discovery/unassigned-artefacts.yml +2 -0
  236. package/src/config/dispatch-economy-metrics.json +4 -2
  237. package/src/config/estate-count-budget.json +8 -3
  238. package/src/config/evaluator-budgets.json +14 -14
  239. package/src/config/gate-coverage.yml +392 -8
  240. package/src/config/gate-violation-baselines.json +76 -72
  241. package/src/config/hook-latency-budget.json +1 -0
  242. package/src/config/hook-token-budget.json +137 -125
  243. package/src/config/pack-size-budget.json +39 -10
  244. package/src/config/preamble-payload-budget.json +97 -71
  245. package/src/config/quorum-attendance-budget.json +12 -4
  246. package/src/config/routing-coverage-seed.json +29 -0
  247. package/src/config/rule-activation-census.json +7 -3
  248. package/src/config/rule-enforcement-baseline.json +0 -1
  249. package/src/config/rule-stub-ceilings.json +112 -91
  250. package/src/config/suggestion-capture.json +28 -0
  251. package/src/config/surface-matrix.yml +21 -2
  252. package/src/config/web-launch-readiness.json +188 -0
  253. package/src/scripts/_cli/cmd_doctor.ts +15 -16
  254. package/src/scripts/_cli/doctor_install_mode.ts +49 -0
  255. package/src/scripts/_cli/doctor_overrides.ts +154 -0
  256. package/src/scripts/_dispatch.bash +17 -0
  257. package/src/scripts/_lib/as_of.ts +412 -0
  258. package/src/scripts/_lib/exec_evidence.ts +7 -0
  259. package/src/scripts/_lib/gate_baseline.ts +150 -1
  260. package/src/scripts/_lib/hook_settings.ts +33 -0
  261. package/src/scripts/_lib/host_listing_model.ts +192 -0
  262. package/src/scripts/_lib/lean_projection_mode.ts +44 -0
  263. package/src/scripts/_lib/mcp_bridge.ts +199 -0
  264. package/src/scripts/_lib/review_independence.ts +62 -10
  265. package/src/scripts/_lib/rule_injection.ts +239 -0
  266. package/src/scripts/_lib/run_checkpoint.ts +54 -1
  267. package/src/scripts/_lib/scoped_projection.ts +96 -0
  268. package/src/scripts/_lib/session_register.ts +44 -2
  269. package/src/scripts/_lib/skill_catalogue.ts +38 -2
  270. package/src/scripts/_lib/skill_estate.ts +115 -0
  271. package/src/scripts/_lib/transcript_reads.ts +207 -0
  272. package/src/scripts/_lib/ui_authority.ts +343 -0
  273. package/src/scripts/ai-video/adapters/fal.sh +8 -3
  274. package/src/scripts/ai-video/adapters/gemini-veo.sh +10 -0
  275. package/src/scripts/ai-video/adapters/higgsfield.sh +10 -2
  276. package/src/scripts/ai-video/adapters/kling.sh +10 -0
  277. package/src/scripts/ai-video/adapters/sora.sh +10 -0
  278. package/src/scripts/ai-video/lib/calibrate-cost.sh +145 -0
  279. package/src/scripts/ai-video/lib/model-capabilities/README.md +53 -7
  280. package/src/scripts/ai-video/lib/model-capabilities/comfyui.json +15 -3
  281. package/src/scripts/ai-video/lib/model-capabilities/fal.json +36 -6
  282. package/src/scripts/ai-video/lib/model-capabilities/gemini-veo.json +23 -0
  283. package/src/scripts/ai-video/lib/model-capabilities/higgsfield.json +23 -0
  284. package/src/scripts/ai-video/lib/model-capabilities/kling.json +23 -0
  285. package/src/scripts/ai-video/lib/model-capabilities/musetalk.json +8 -2
  286. package/src/scripts/ai-video/lib/model-capabilities/replicate.json +36 -6
  287. package/src/scripts/ai-video/lib/model-capabilities/sora.json +45 -0
  288. package/src/scripts/ai-video/lib/model-capabilities/syncso.json +8 -2
  289. package/src/scripts/ai-video/lib/parse-blueprint.sh +52 -5
  290. package/src/scripts/ai-video/lib/resume-scan.sh +92 -3
  291. package/src/scripts/ai-video/lib/seam-plan.sh +212 -0
  292. package/src/scripts/ai-video/smoke-trace.sh +450 -2
  293. package/src/scripts/ai-video/stitch.sh +191 -10
  294. package/src/scripts/ai-video/test-pipeline.sh +84 -6
  295. package/src/scripts/ai_council/argument_exhaustion.ts +130 -0
  296. package/src/scripts/ai_council/cli_agency_bounds.ts +139 -0
  297. package/src/scripts/ai_council/cli_least_agency_canary.ts +347 -0
  298. package/src/scripts/ai_council/clients.ts +3 -2
  299. package/src/scripts/ai_council/consensus.ts +63 -6
  300. package/src/scripts/ai_council/events_log.ts +46 -1
  301. package/src/scripts/ai_council/orchestrator.ts +103 -108
  302. package/src/scripts/ai_council/orchestrator_results.ts +166 -0
  303. package/src/scripts/ai_council/prompts.ts +12 -5
  304. package/src/scripts/ai_council/quorum.ts +82 -1
  305. package/src/scripts/ai_council/quorum_wiring.ts +82 -5
  306. package/src/scripts/ai_council/stance_tally.ts +22 -0
  307. package/src/scripts/bench_hook_latency.ts +62 -0
  308. package/src/scripts/build_proof.ts +12 -1
  309. package/src/scripts/capture_skill_catalogue.ts +21 -0
  310. package/src/scripts/check_always_budget.ts +2 -1
  311. package/src/scripts/check_augmentignore.ts +2 -1
  312. package/src/scripts/check_beta_review_markers.ts +2 -1
  313. package/src/scripts/check_bundle_path_leakage.ts +162 -7
  314. package/src/scripts/check_command_examples.ts +557 -0
  315. package/src/scripts/check_composite_arming.ts +364 -0
  316. package/src/scripts/check_corpus_staleness.ts +2 -1
  317. package/src/scripts/check_council_pin_staleness.ts +3 -1
  318. package/src/scripts/check_enforcement_coverage.ts +116 -3
  319. package/src/scripts/check_enforcement_denominator.ts +365 -0
  320. package/src/scripts/check_estate_count.ts +122 -3
  321. package/src/scripts/check_gate_coverage.ts +2 -1
  322. package/src/scripts/check_hook_bundle_freshness.ts +13 -1
  323. package/src/scripts/check_knowledge_cards.ts +2 -1
  324. package/src/scripts/check_knowledge_pages.ts +3 -2
  325. package/src/scripts/check_memory.ts +2 -1
  326. package/src/scripts/check_no_automerge_key.ts +287 -0
  327. package/src/scripts/check_pack_conformance_fixture.ts +565 -0
  328. package/src/scripts/check_preamble_payload_budget.ts +30 -3
  329. package/src/scripts/check_proposal.ts +2 -1
  330. package/src/scripts/check_reach_staleness.ts +2 -1
  331. package/src/scripts/check_release_adjacent_health.ts +2 -1
  332. package/src/scripts/check_release_pr_shape.ts +5 -0
  333. package/src/scripts/check_review_schema.ts +34 -1
  334. package/src/scripts/check_roadmap_trackable.ts +48 -3
  335. package/src/scripts/check_routing_coverage.ts +352 -0
  336. package/src/scripts/check_score_contract.ts +505 -0
  337. package/src/scripts/check_skill_admissions.ts +514 -0
  338. package/src/scripts/check_source_size_budget.ts +2 -1
  339. package/src/scripts/check_standing_payload_delta.ts +505 -0
  340. package/src/scripts/check_trigger_evals.ts +2 -1
  341. package/src/scripts/check_web_launch_readiness.ts +705 -0
  342. package/src/scripts/classify_change_risk.ts +281 -0
  343. package/src/scripts/compute_skill_tiers.ts +186 -0
  344. package/src/scripts/condense.ts +8 -13
  345. package/src/scripts/council_attendance_metrics.ts +183 -0
  346. package/src/scripts/council_cli.ts +10 -8
  347. package/src/scripts/council_parse_rate.ts +116 -0
  348. package/src/scripts/derive_playbooks.ts +406 -0
  349. package/src/scripts/description_route_check.ts +494 -0
  350. package/src/scripts/design_slop_rules.ts +56 -2
  351. package/src/scripts/dispatch_r2_reviewer.ts +16 -0
  352. package/src/scripts/frontend_corpus_hash.ts +116 -0
  353. package/src/scripts/grade_target_readiness.ts +478 -0
  354. package/src/scripts/hook_manifest.json +1 -1
  355. package/src/scripts/hook_manifest.yaml +124 -16
  356. package/src/scripts/hooks/concern_registry.ts +6 -0
  357. package/src/scripts/hooks/design_pass_hook.ts +356 -0
  358. package/src/scripts/hooks/rtk_wrap_hook.ts +30 -7
  359. package/src/scripts/hooks/rule_inject_hook.ts +318 -0
  360. package/src/scripts/hooks/suggestion_capture_hook.ts +368 -0
  361. package/src/scripts/hot_context_hook.ts +74 -7
  362. package/src/scripts/install.ts +40 -89
  363. package/src/scripts/lint_adapter_tier.ts +663 -0
  364. package/src/scripts/lint_archived_skills.ts +93 -0
  365. package/src/scripts/lint_budget_ownership.ts +56 -5
  366. package/src/scripts/lint_deterministic_time.ts +470 -0
  367. package/src/scripts/lint_framework_leakage.ts +5 -0
  368. package/src/scripts/lint_handoffs.ts +525 -1
  369. package/src/scripts/lint_judge_prompt_expectation.ts +155 -0
  370. package/src/scripts/lint_marketplace.ts +88 -0
  371. package/src/scripts/lint_media_policy_linkage.ts +140 -1
  372. package/src/scripts/lint_one_off_age.ts +6 -1
  373. package/src/scripts/lint_override_kernel_guard.ts +87 -5
  374. package/src/scripts/lint_roadmap_complexity.ts +56 -0
  375. package/src/scripts/lint_rule_enforcement_declaration.ts +24 -7
  376. package/src/scripts/lint_rule_norm_pin.ts +321 -0
  377. package/src/scripts/lint_skill_trigger_corpus.ts +349 -0
  378. package/src/scripts/lint_spawn_payload.ts +42 -5
  379. package/src/scripts/lint_symptom_intake.ts +2 -1
  380. package/src/scripts/mcp_parity_smoke.ts +30 -4
  381. package/src/scripts/mcp_render.ts +66 -1
  382. package/src/scripts/mcp_tool_fingerprint.ts +241 -0
  383. package/src/scripts/measure_risk_class_drift.ts +140 -0
  384. package/src/scripts/measure_skill_ranker_baseline.ts +212 -0
  385. package/src/scripts/media/lib/adapter-common.sh +211 -1
  386. package/src/scripts/media/lib/adapter-contract.md +74 -6
  387. package/src/scripts/model_rule_injection.ts +907 -0
  388. package/src/scripts/pack_install_smoke.ts +363 -0
  389. package/src/scripts/pr_conflict_census.ts +187 -0
  390. package/src/scripts/project_thin_rules.ts +45 -2
  391. package/src/scripts/release.ts +66 -860
  392. package/src/scripts/release_drill.ts +59 -3
  393. package/src/scripts/release_env.ts +298 -0
  394. package/src/scripts/release_publication.ts +720 -0
  395. package/src/scripts/report_pack_delta.ts +204 -0
  396. package/src/scripts/roadmap_context.ts +778 -0
  397. package/src/scripts/schemas/fidelity-measurement-sheet.schema.json +169 -0
  398. package/src/scripts/schemas/rule.schema.json +24 -2
  399. package/src/scripts/schemas/skill.schema.json +39 -0
  400. package/src/scripts/schemas/ui-authority.schema.json +114 -0
  401. package/src/scripts/select_analysis_mode.ts +112 -0
  402. package/src/scripts/session_register_hook.ts +29 -3
  403. package/src/scripts/sessions_cli.ts +67 -3
  404. package/src/scripts/skill_tools/score_skill_relevance.ts +36 -53
  405. package/src/scripts/sync_pr_branch.ts +40 -1
  406. package/src/scripts/token_sink_report.ts +239 -0
  407. package/src/scripts/trigger_coverage.ts +122 -3
  408. package/src/scripts/update_counts.ts +7 -3
  409. package/src/scripts/validate_frontmatter.ts +66 -0
  410. package/src/server/schemas/settings.ts +10 -0
  411. package/src/shared/skillRanking.ts +183 -0
  412. package/dist/agent-src/skills/accessibility-auditor/evals/evals.json +0 -15
  413. package/dist/agent-src/skills/agent-security-review/evals/triggers.json +0 -52
  414. package/dist/agent-src/skills/ai-code-blindspots/evals/triggers.json +0 -52
  415. package/dist/agent-src/skills/analysis-skill-router/evals/evals.json +0 -13
  416. package/dist/agent-src/skills/brand/evals/triggers.json +0 -17
  417. package/dist/agent-src/skills/brand-asset-generation/evals/triggers.json +0 -17
  418. package/dist/agent-src/skills/brand-audit/evals/triggers.json +0 -17
  419. package/dist/agent-src/skills/brand-identity/evals/triggers.json +0 -17
  420. package/dist/agent-src/skills/brand-strategy/evals/triggers.json +0 -17
  421. package/dist/agent-src/skills/brand-to-tokens/evals/triggers.json +0 -17
  422. package/dist/agent-src/skills/bug-analyzer/evals/evals.json +0 -13
  423. package/dist/agent-src/skills/canvas-design/evals/triggers.json +0 -17
  424. package/dist/agent-src/skills/character-consistency/evals/evals.json +0 -16
  425. package/dist/agent-src/skills/code-intelligence/evals/triggers.json +0 -52
  426. package/dist/agent-src/skills/code-review/evals/evals.json +0 -100
  427. package/dist/agent-src/skills/command-routing/evals/evals.json +0 -14
  428. package/dist/agent-src/skills/complexity-first-planning/evals/triggers.json +0 -17
  429. package/dist/agent-src/skills/contract-review/evals/triggers.json +0 -17
  430. package/dist/agent-src/skills/conventional-commits-writing/evals/evals.json +0 -15
  431. package/dist/agent-src/skills/corpus-grounding/evals/triggers.json +0 -17
  432. package/dist/agent-src/skills/dashboard-design/evals/evals.json +0 -16
  433. package/dist/agent-src/skills/dcf-modeling/evals/domain-truth.json +0 -29
  434. package/dist/agent-src/skills/dcf-modeling/evals/evals.json +0 -20
  435. package/dist/agent-src/skills/decision-record/evals/evals.json +0 -20
  436. package/dist/agent-src/skills/decision-record/evals/triggers.json +0 -87
  437. package/dist/agent-src/skills/design-intelligence/evals/evals.json +0 -14
  438. package/dist/agent-src/skills/design-intelligence/evals/triggers.json +0 -17
  439. package/dist/agent-src/skills/design-system-capture/evals/evals.json +0 -15
  440. package/dist/agent-src/skills/design-tokens/evals/triggers.json +0 -17
  441. package/dist/agent-src/skills/design-variations/evals/triggers.json +0 -17
  442. package/dist/agent-src/skills/developer-like-execution/evals/evals.json +0 -16
  443. package/dist/agent-src/skills/doc-coauthoring/evals/evals.json +0 -16
  444. package/dist/agent-src/skills/doc-coauthoring/evals/triggers.json +0 -17
  445. package/dist/agent-src/skills/docx-authoring/evals/triggers.json +0 -52
  446. package/dist/agent-src/skills/dpa-review/evals/triggers.json +0 -17
  447. package/dist/agent-src/skills/editorial-calendar/evals/domain-truth.json +0 -16
  448. package/dist/agent-src/skills/editorial-calendar/evals/evals.json +0 -16
  449. package/dist/agent-src/skills/eloquent/evals/triggers.json +0 -17
  450. package/dist/agent-src/skills/estimate-ticket/evals/evals.json +0 -16
  451. package/dist/agent-src/skills/estimate-ticket/evals/output-schema.yml +0 -20
  452. package/dist/agent-src/skills/estimate-ticket/evals/triggers.json +0 -19
  453. package/dist/agent-src/skills/evaluate-llm-feature/evals/triggers.json +0 -52
  454. package/dist/agent-src/skills/existing-ui-audit/evals/triggers.json +0 -47
  455. package/dist/agent-src/skills/experiment-loop/evals/output-schema.yml +0 -27
  456. package/dist/agent-src/skills/experiment-loop/evals/triggers.json +0 -17
  457. package/dist/agent-src/skills/fe-design/evals/triggers.json +0 -55
  458. package/dist/agent-src/skills/forecasting/evals/domain-truth.json +0 -29
  459. package/dist/agent-src/skills/forecasting/evals/evals.json +0 -20
  460. package/dist/agent-src/skills/forensics-report/evals/triggers.json +0 -17
  461. package/dist/agent-src/skills/frontend-render-security/evals/triggers.json +0 -52
  462. package/dist/agent-src/skills/fundraising-narrative/evals/domain-truth.json +0 -16
  463. package/dist/agent-src/skills/fundraising-narrative/evals/evals.json +0 -16
  464. package/dist/agent-src/skills/gated-reach/evals/triggers.json +0 -72
  465. package/dist/agent-src/skills/github-ci/evals/evals.json +0 -25
  466. package/dist/agent-src/skills/history-design/evals/triggers.json +0 -17
  467. package/dist/agent-src/skills/html-deck/evals/triggers.json +0 -17
  468. package/dist/agent-src/skills/humanizer/evals/strip_fixtures.json +0 -57
  469. package/dist/agent-src/skills/humanizer/evals/triggers.json +0 -17
  470. package/dist/agent-src/skills/iconography/evals/triggers.json +0 -17
  471. package/dist/agent-src/skills/image-analyser/evals/triggers.json +0 -17
  472. package/dist/agent-src/skills/image-creator/evals/triggers.json +0 -17
  473. package/dist/agent-src/skills/image-editing/evals/triggers.json +0 -17
  474. package/dist/agent-src/skills/image-generation/evals/triggers.json +0 -17
  475. package/dist/agent-src/skills/image-provider-routing/evals/triggers.json +0 -17
  476. package/dist/agent-src/skills/incident-commander/evals/domain-truth.json +0 -16
  477. package/dist/agent-src/skills/incident-commander/evals/evals.json +0 -20
  478. package/dist/agent-src/skills/judge-artifact-completeness/evals/triggers.json +0 -17
  479. package/dist/agent-src/skills/judge-injection-defense/evals/triggers.json +0 -17
  480. package/dist/agent-src/skills/judge-synthesis/evals/triggers.json +0 -17
  481. package/dist/agent-src/skills/launch-readiness/evals/evals.json +0 -21
  482. package/dist/agent-src/skills/learning-tutor/evals/triggers.json +0 -52
  483. package/dist/agent-src/skills/legal-intake-triage/evals/triggers.json +0 -17
  484. package/dist/agent-src/skills/legal-practice-profile/evals/triggers.json +0 -17
  485. package/dist/agent-src/skills/license-compliance-audit/evals/triggers.json +0 -52
  486. package/dist/agent-src/skills/license-compliance-borrow-check/evals/triggers.json +0 -52
  487. package/dist/agent-src/skills/license-compliance-credits/evals/triggers.json +0 -52
  488. package/dist/agent-src/skills/llm-provider-knowledge/evals/triggers.json +0 -20
  489. package/dist/agent-src/skills/logging-monitoring/evals/evals.json +0 -16
  490. package/dist/agent-src/skills/logo-generation/evals/triggers.json +0 -17
  491. package/dist/agent-src/skills/messaging-architecture/evals/domain-truth.json +0 -16
  492. package/dist/agent-src/skills/messaging-architecture/evals/evals.json +0 -16
  493. package/dist/agent-src/skills/nda-triage/evals/triggers.json +0 -17
  494. package/dist/agent-src/skills/pdf-tools/evals/triggers.json +0 -52
  495. package/dist/agent-src/skills/perf-feedback-craft/evals/evals.json +0 -16
  496. package/dist/agent-src/skills/persona-improvement/evals/triggers.json +0 -52
  497. package/dist/agent-src/skills/php-coder/evals/triggers.json +0 -17
  498. package/dist/agent-src/skills/prediction-pool-optimizer/evals/triggers.json +0 -21
  499. package/dist/agent-src/skills/prompt-engineering-image/evals/triggers.json +0 -17
  500. package/dist/agent-src/skills/prompt-engineering-patterns/evals/evals.json +0 -16
  501. package/dist/agent-src/skills/prompt-validator/evals/triggers.json +0 -17
  502. package/dist/agent-src/skills/quality-tools/evals/evals.json +0 -15
  503. package/dist/agent-src/skills/reasoning-orchestrator/evals/triggers.json +0 -17
  504. package/dist/agent-src/skills/refine-prompt/evals/evals.json +0 -16
  505. package/dist/agent-src/skills/refine-ticket/evals/evals.json +0 -16
  506. package/dist/agent-src/skills/refine-ticket/evals/output-schema.yml +0 -16
  507. package/dist/agent-src/skills/refine-ticket/evals/triggers.json +0 -17
  508. package/dist/agent-src/skills/release-comms/evals/evals.json +0 -16
  509. package/dist/agent-src/skills/rice-prioritization/evals/evals.json +0 -20
  510. package/dist/agent-src/skills/runway-cognition/evals/domain-truth.json +0 -29
  511. package/dist/agent-src/skills/runway-cognition/evals/evals.json +0 -20
  512. package/dist/agent-src/skills/scenario-modeling/evals/domain-truth.json +0 -29
  513. package/dist/agent-src/skills/scenario-modeling/evals/evals.json +0 -20
  514. package/dist/agent-src/skills/schema-review/evals/triggers.json +0 -17
  515. package/dist/agent-src/skills/screenshot-hygiene/evals/triggers.json +0 -52
  516. package/dist/agent-src/skills/security-maturity-assessment/evals/triggers.json +0 -52
  517. package/dist/agent-src/skills/skill-writing/evals/triggers.json +0 -17
  518. package/dist/agent-src/skills/spreadsheet-authoring/evals/triggers.json +0 -47
  519. package/dist/agent-src/skills/subagent-orchestration/evals/evals.json +0 -60
  520. package/dist/agent-src/skills/supply-chain-intake/evals/triggers.json +0 -52
  521. package/dist/agent-src/skills/systematic-debugging/evals/evals.json +0 -20
  522. package/dist/agent-src/skills/test-case-discovery/evals/triggers.json +0 -52
  523. package/dist/agent-src/skills/test-driven-development/evals/evals.json +0 -16
  524. package/dist/agent-src/skills/threat-modeling/evals/evals.json +0 -21
  525. package/dist/agent-src/skills/typography-system/evals/evals.json +0 -14
  526. package/dist/agent-src/skills/typography-system/evals/triggers.json +0 -17
  527. package/dist/agent-src/skills/unit-economics-modeling/evals/domain-truth.json +0 -40
  528. package/dist/agent-src/skills/unit-economics-modeling/evals/evals.json +0 -24
  529. package/dist/agent-src/skills/verify-completion-evidence/evals/evals.json +0 -16
  530. package/dist/agent-src/skills/verify-repair-loop/evals/output-schema.yml +0 -20
  531. package/dist/agent-src/skills/verify-repair-loop/evals/triggers.json +0 -17
  532. package/dist/agent-src/skills/vision-articulation/evals/evals.json +0 -16
  533. package/dist/agent-src/skills/voice-and-tone-design/evals/evals.json +0 -16
  534. package/dist/agent-src/skills/wireframe/evals/triggers.json +0 -17
  535. package/dist/agent-src/skills/worktree-lifecycle/evals/evals.json +0 -38
  536. package/dist/agent-src/skills/worktree-lifecycle/evals/triggers.json +0 -52
  537. package/dist/cli/agent-config.js.map +0 -1
  538. package/dist/cli/bash/runBash.js.map +0 -1
  539. package/dist/cli/commands/commands.js.map +0 -1
  540. package/dist/cli/commands/config.js.map +0 -1
  541. package/dist/cli/commands/doctorShell.js.map +0 -1
  542. package/dist/cli/commands/mcpServer.js.map +0 -1
  543. package/dist/cli/commands/packs.js.map +0 -1
  544. package/dist/cli/commands/profiles.js.map +0 -1
  545. package/dist/cli/commands/recordTriggerEval.js.map +0 -1
  546. package/dist/cli/commands/rtkDetect.js.map +0 -1
  547. package/dist/cli/commands/settings.js.map +0 -1
  548. package/dist/cli/commands/uiServe.js.map +0 -1
  549. package/dist/cli/commands/versions.js.map +0 -1
  550. package/dist/cli/commands/workspaces.js.map +0 -1
  551. package/dist/cli/configRoot.js.map +0 -1
  552. package/dist/cli/discovery/loadManifest.js.map +0 -1
  553. package/dist/cli/firstRunNotice.js.map +0 -1
  554. package/dist/cli/help.js.map +0 -1
  555. package/dist/cli/initRouting.js.map +0 -1
  556. package/dist/cli/log/logger.js.map +0 -1
  557. package/dist/cli/main.js.map +0 -1
  558. package/dist/cli/mcp/content.js.map +0 -1
  559. package/dist/cli/mcp/dispatch.js.map +0 -1
  560. package/dist/cli/mcp/stdio.js.map +0 -1
  561. package/dist/cli/paths.js.map +0 -1
  562. package/dist/cli/python/knowledge_ingest.js.map +0 -1
  563. package/dist/cli/python/workspace_analytics.js.map +0 -1
  564. package/dist/cli/python/workspace_crypto.js.map +0 -1
  565. package/dist/cli/python/workspace_documents.js.map +0 -1
  566. package/dist/cli/python/workspace_drive.js.map +0 -1
  567. package/dist/cli/python/workspace_drive_health.js.map +0 -1
  568. package/dist/cli/python/workspace_explain.js.map +0 -1
  569. package/dist/cli/python/workspace_hosts.js.map +0 -1
  570. package/dist/cli/python/workspace_inbox.js.map +0 -1
  571. package/dist/cli/python/workspace_render.js.map +0 -1
  572. package/dist/cli/python/workspace_roles.js.map +0 -1
  573. package/dist/cli/python/workspace_secrets.js.map +0 -1
  574. package/dist/cli/python/workspace_sessions.js.map +0 -1
  575. package/dist/cli/python/workspace_skills.js.map +0 -1
  576. package/dist/cli/registry.js.map +0 -1
  577. package/dist/install/agentSwitchDetection.js.map +0 -1
  578. package/dist/install/agentSwitchProfile.js.map +0 -1
  579. package/dist/install/atomic.js.map +0 -1
  580. package/dist/install/claudePathsPlan.js.map +0 -1
  581. package/dist/install/conflict.js.map +0 -1
  582. package/dist/install/detect.js.map +0 -1
  583. package/dist/install/emit_host_rules_cli.js.map +0 -1
  584. package/dist/install/globalRuleLayers.js.map +0 -1
  585. package/dist/install/hostLayerFingerprint.js.map +0 -1
  586. package/dist/install/partitionEligibility.js.map +0 -1
  587. package/dist/install/paths.js.map +0 -1
  588. package/dist/install/plan.js.map +0 -1
  589. package/dist/install/preflight.js.map +0 -1
  590. package/dist/install/rtkDetection.js.map +0 -1
  591. package/dist/install/ruleInScope.js.map +0 -1
  592. package/dist/install/ruleLayerPartition.js.map +0 -1
  593. package/dist/install/rule_scope.js.map +0 -1
  594. package/dist/install/rule_scope_cli.js.map +0 -1
  595. package/dist/install/selectedTools.js.map +0 -1
  596. package/dist/install/toolDetection.js.map +0 -1
  597. package/dist/install/txlog.js.map +0 -1
  598. package/dist/install/types.js.map +0 -1
  599. package/dist/install/wizard-plan.js.map +0 -1
  600. package/dist/install/wizardDismissals.js.map +0 -1
  601. package/dist/scripts/_lib/agent_settings.js.map +0 -1
  602. package/dist/scripts/_lib/agent_src.js.map +0 -1
  603. package/dist/scripts/_lib/claude_builtin_names.js.map +0 -1
  604. package/dist/scripts/_lib/claude_plugin.js.map +0 -1
  605. package/dist/scripts/_lib/claude_settings_hooks.js.map +0 -1
  606. package/dist/scripts/_lib/compile_time_toggles.js.map +0 -1
  607. package/dist/scripts/_lib/environment_detector.js.map +0 -1
  608. package/dist/scripts/_lib/host_launch.js.map +0 -1
  609. package/dist/scripts/_lib/install_layout.js.map +0 -1
  610. package/dist/scripts/_lib/installed_lock.js.map +0 -1
  611. package/dist/scripts/_lib/model_tier.js.map +0 -1
  612. package/dist/scripts/_lib/prune_empty_dirs.js.map +0 -1
  613. package/dist/scripts/_lib/scoped_projection.js.map +0 -1
  614. package/dist/scripts/_lib/script_output.js.map +0 -1
  615. package/dist/scripts/_lib/spawn_env.js.map +0 -1
  616. package/dist/scripts/_lib/surface_tiers.js.map +0 -1
  617. package/dist/scripts/_lib/token_count.js.map +0 -1
  618. package/dist/scripts/_lib/trigger_eval_floors.js.map +0 -1
  619. package/dist/scripts/_lib/user_global_paths.js.map +0 -1
  620. package/dist/scripts/ai_council/modes.js.map +0 -1
  621. package/dist/scripts/ai_council/transport_resolver.js.map +0 -1
  622. package/dist/scripts/condense.js.map +0 -1
  623. package/dist/scripts/project_thin_rules.js.map +0 -1
  624. package/dist/server/app.js.map +0 -1
  625. package/dist/server/io/atomicMultiWrite.js.map +0 -1
  626. package/dist/server/io/atomicWrite.js.map +0 -1
  627. package/dist/server/io/sharedWriteCheck.js.map +0 -1
  628. package/dist/server/io/substituteTemplate.js.map +0 -1
  629. package/dist/server/io/yamlIO.js.map +0 -1
  630. package/dist/server/nicknameResolver.js.map +0 -1
  631. package/dist/server/port.js.map +0 -1
  632. package/dist/server/routes/discovery.js.map +0 -1
  633. package/dist/server/routes/install.js.map +0 -1
  634. package/dist/server/routes/ping.js.map +0 -1
  635. package/dist/server/routes/schema.js.map +0 -1
  636. package/dist/server/routes/settings.js.map +0 -1
  637. package/dist/server/routes/settingsChanges.js.map +0 -1
  638. package/dist/server/routes/userMd.js.map +0 -1
  639. package/dist/server/routes/wizard.js.map +0 -1
  640. package/dist/server/routes/workspace.js.map +0 -1
  641. package/dist/server/schemas/settings.js.map +0 -1
  642. package/dist/server/serverInfo.js.map +0 -1
  643. package/dist/server/token.js.map +0 -1
  644. package/dist/server/writeRoot.js.map +0 -1
  645. package/dist/shared/capabilities.js.map +0 -1
  646. package/dist/shared/interactiveContext.js.map +0 -1
  647. package/dist/shared/nicknamePrefill.js.map +0 -1
  648. package/dist/shared/settingsAsks.js.map +0 -1
  649. package/dist/shared/settingsCarveOut.js.map +0 -1
  650. package/dist/shared/settingsClasses.js.map +0 -1
  651. package/dist/shared/settingsConsent.js.map +0 -1
  652. package/dist/shared/settingsSurface.js.map +0 -1
  653. package/dist/shared/userMd/formAdapter.js.map +0 -1
  654. package/dist/shared/userMd/schema.js.map +0 -1
  655. package/dist/shared/userMd/utils.js.map +0 -1
  656. package/dist/ui/assets/index-Cxgy63kz.js.map +0 -1
  657. package/src/scripts/_lib/adr_frontmatter.test.ts +0 -365
  658. package/src/scripts/_lib/adversarial_council_gate.test.ts +0 -112
  659. package/src/scripts/_lib/adversarial_reconcile.test.ts +0 -197
  660. package/src/scripts/_lib/auto_dispatch.corpus.test.ts +0 -150
  661. package/src/scripts/_lib/secret_detector.test.ts +0 -108
  662. package/src/scripts/_lib/secret_detector_adversarial.test.ts +0 -116
  663. package/src/scripts/_lib/untrusted_content.test.ts +0 -175
  664. package/src/scripts/check_secret_leak.test.ts +0 -90
  665. package/src/scripts/design_slop_rules.test.ts +0 -239
  666. package/src/scripts/self_review_gate.test.ts +0 -296
  667. package/src/shared/capabilities.test.ts +0 -43
@@ -12,6 +12,13 @@ trust:
12
12
  install:
13
13
  default: false
14
14
  removable: true
15
+ scope:
16
+ write:
17
+ - pattern: "components/ui/**"
18
+ access: "create"
19
+ - pattern: "components.json"
20
+ access: "write"
21
+ verification_command: "npx shadcn@latest add <component> --dry-run"
15
22
  execution:
16
23
  type: assisted
17
24
  handler: shell
@@ -47,7 +54,14 @@ block above:
47
54
 
48
55
  ## Compatibility
49
56
 
50
- - **Tested against:** `shadcn@2.1`, Tailwind CSS `3.x`, React `18+`.
57
+ - **Tested against:** `shadcn@4`, Tailwind CSS `4.x`, React `19`, primitives from
58
+ `@base-ui/react@1`, `components.json` style `base-nova` — every major read out
59
+ of `tests/fixtures/stack/shadcn-current/package.json`, the verbatim output of
60
+ `npx shadcn@latest init -d --template vite` on 2026-08-24. No version on this
61
+ line may be stated from prose; move it only by re-running that scaffold and
62
+ re-committing the fixture.
63
+ - Tailwind `3.x` and Radix primitives stay supported through the **v3 branch**
64
+ under § Gotcha — the CLI moved on, existing projects did not.
51
65
  - The audit step (`directives/ui/audit.ts`) reads the line above and
52
66
  compares it with `state.ui_audit.shadcn_inventory.version`; a major
53
67
  mismatch triggers a soft halt before this skill runs.
@@ -56,8 +70,8 @@ block above:
56
70
 
57
71
  Use when `state.stack.frontend == "react-shadcn"` and `directives/ui/apply.ts`,
58
72
  `review.ts`, or `polish.ts` dispatches to this skill, or when a React project
59
- clearly uses shadcn/ui (presence of `components.json`, `@radix-ui/*`
60
- dependencies, a `components/ui/` folder of generated primitives).
73
+ clearly uses shadcn/ui (presence of `components.json`, a `@base-ui/react` or
74
+ `@radix-ui/*` dependency, a `components/ui/` folder of generated primitives).
61
75
 
62
76
  Do NOT use when:
63
77
  - Project is Blade + Livewire + Flux (use `flux` / `livewire` / `blade-ui`).
@@ -75,13 +89,23 @@ Do NOT use when:
75
89
  writes `state.ui_audit.shadcn_inventory` with the detected version —
76
90
  when it diverges by a major, audit emits a soft halt before this
77
91
  skill runs.
78
- - shadcn/ui composes Radix primitives. Accessibility is built in via Radix
79
- but only when you use the wrapper components correctly (`asChild`,
92
+ - shadcn/ui composes a primitive vendor — `@base-ui/react` in a CLI-4 scaffold,
93
+ `@radix-ui/*` in older projects. Accessibility is built in either way, but
94
+ only when the wrapper components are used correctly (`asChild`,
80
95
  `<DialogTrigger>` instead of a bare `<button>`).
81
- - Tailwind tokens come from `tailwind.config.{js,ts}` (`theme.extend.colors`)
82
- and CSS custom properties on `:root` and `.dark` (`--background`,
83
- `--foreground`, `--primary`, `--ring`, …). Audit writes them into
84
- `state.ui_audit.design_tokens`. Use those tokens; do not hardcode values.
96
+ - **Tailwind tokens: branch on the `css` axis, never guess.** `detect_stack()`
97
+ emits `axes.css` as `tailwind-v4` or `tailwind-v3`
98
+ (`work_engine/stack/detect.ts:521-524`); `existing-ui-audit` reads tokens on
99
+ the same key.
100
+ - `tailwind-v4` — **no config file exists.** Tokens live in the `@theme` block
101
+ of the entry CSS named by `components.json` → `tailwind.css`, and that file's
102
+ `"tailwind": {"config": ""}` — an empty `config` string — IS the v4 marker.
103
+ Never write `tailwind.config.{js,ts}` in a v4 project.
104
+ - `tailwind-v3` — tokens come from `tailwind.config.{js,ts}`
105
+ (`theme.extend.colors`).
106
+ - Either branch — CSS custom properties on `:root` and `.dark`
107
+ (`--background`, `--foreground`, `--primary`, `--ring`, …). Audit writes them
108
+ into `state.ui_audit.design_tokens`. Use those tokens; never hardcode values.
85
109
  - Dark mode is class-based (`<html class="dark">`). Every color must come
86
110
  from `bg-background`, `text-foreground`, etc. — never raw `bg-white`.
87
111
  - Every interactive primitive must declare a focus-visible state via
@@ -164,6 +188,40 @@ registries / install-with-natural-language over MCP; configure per the
164
188
  dependency. Decision note: **CLI path = default + universal; MCP path = opt-in
165
189
  when the user has it configured; registry-JSON literacy underpins both.**
166
190
 
191
+ ## Publish a registry — the library as a source others install from
192
+
193
+ The sections above **consume** a registry. This one **publishes** one: a component library in
194
+ this repository can expose its own components the same way, so a consumer installs them with
195
+ the tool they already use instead of copying files.
196
+
197
+ 1. **Author `registry.json`** at the library root — the index — and one
198
+ `registry-item.json` per exposed component, each naming its files, its
199
+ `registryDependencies`, and its `cssVars` when it carries token requirements.
200
+ 2. **Build** to `public/r` with the registry build command. **The installer gate applies
201
+ here exactly as it does to `add`**: propose it, run `--dry-run` first, and let the user
202
+ confirm. A build writes files, so nothing about it being "our own" registry lifts the
203
+ gate.
204
+ 3. **The consumer adds a `registries` map entry** pointing at the published index; from then
205
+ on `@ns/item` resolves through it.
206
+
207
+ **Two registry item types are FORBIDDEN**, deprecated in v4: `registry:build` and
208
+ `registry:mcp`. Use **`registry:base`** and **`registry:font`** instead. Writing either
209
+ deprecated type produces an item the current CLI does not understand, and the failure surfaces
210
+ at the consumer rather than at authoring time.
211
+
212
+ **`dependencies` in a registry item never names `react` or `react-dom`.** They are peers of
213
+ the consuming app, and a registry item that installs its own copy reproduces the "invalid hook
214
+ call" failure one layer up — see
215
+ [`js-library-packaging`](../js-library-packaging/SKILL.md). `check_package_surface` enforces
216
+ this over a registry file.
217
+
218
+ > **Provenance.** The registry-publishing shape and the deprecated-type list come from an
219
+ > external plugin reference's component-CLI skill, read at a pinned revision. The source is
220
+ > deliberately not named here, per
221
+ > [`source-confidentiality`](../../rules/source-confidentiality.md): a shipped artifact does
222
+ > not carry derivation attribution to a named external project. The identifier and revision
223
+ > stay with the maintainer-side record.
224
+
167
225
  ## Procedure: render a shadcn/ui component for the design brief
168
226
 
169
227
  ### Step 0: Inspect
@@ -202,12 +260,12 @@ when the user has it configured; registry-JSON literacy underpins both.**
202
260
  `bg-primary text-primary-foreground`, `text-muted-foreground`. No
203
261
  `bg-white` / `text-black` / hardcoded `#fff`.
204
262
  2. Spacing / radius from theme tokens (`rounded-lg` mapped to `--radius`
205
- in `tailwind.config.{js,ts}`). Polish refactors hardcoded values
206
- when a token equivalent exists.
263
+ — in the `@theme` block on `tailwind-v4`, in `tailwind.config.{js,ts}` on
264
+ `tailwind-v3`). Polish refactors hardcoded values when a token exists.
207
265
  3. Dark mode: never branch on a `dark` prop; rely on the `.dark` class
208
266
  on the root and semantic tokens.
209
267
  4. Every interactive primitive: keyboard trigger present (Enter/Space
210
- on buttons, Esc on dialogs — Radix free), visible focus ring,
268
+ on buttons, Esc on dialogs — free from the primitive vendor), focus ring,
211
269
  `aria-label` from `state.ui_design.a11y` when icon-only.
212
270
 
213
271
  ### Step 3: State coverage
@@ -277,27 +335,17 @@ current state on the next polish round.
277
335
 
278
336
  When `DESIGN.md` declares `## Taste Dials`, honour them: Variance → layout-family spread + asymmetry tolerance; Motion → animation budget + reduced-motion posture; Density → spacing scale + information-per-viewport. Absent → follow the design brief's inferred dials.
279
337
 
280
- ## Component workshop (Storybook) — when the library is large enough
281
-
282
- The generic "isolate + document reusable components" principle lives in
283
- [`fe-design`](../fe-design/SKILL.md) § Component Architecture; this is the React
284
- carve-out for the tool-specific part.
285
-
286
- - **When it pays off** — a real, growing shared-component library (roughly: more
287
- than a handful of reused primitives, multiple consumers, ongoing UI work).
288
- Storybook makes each component discoverable, reviewable in isolation, and
289
- reused instead of re-invented. **Skip it** for a small surface of one-off
290
- components — the setup + maintenance is not worth it yet.
291
- - **Story per reusable primitive, not per screen** — a story covers a component
292
- and its states (default / loading / empty / error / dark), mirroring the
293
- Step 3 state-coverage matrix. Screens are composed, not story-fied.
294
- - **Reuse the token layer** — stories render under the same semantic tokens +
295
- `.dark` class; never hardcode a preview theme (same token discipline as Step 2).
296
- - **A11y in-workshop** — run the a11y addon so the isolation catches contrast /
297
- role / focus issues before the component reaches a screen.
298
- - Do NOT let stories drift from the component API — a story that props-drills
299
- values the component no longer accepts is stale documentation; keep them beside
300
- the component and update them in the same change.
338
+ ## Component workshop (Storybook) — pointer
339
+
340
+ The workshop discipline (one concept per story, `@summary` on every export, stories run as
341
+ tests, the `!manifest` tag, the opt-in MCP channel) lives in
342
+ [`storybook-workshop`](../storybook-workshop/SKILL.md). It is stack-agnostic and was lifted
343
+ out of here rather than duplicated beside it.
344
+
345
+ What stays React-specific and therefore stays here: the state-coverage matrix in Step 3 that
346
+ the story set is derived from, the token discipline of Step 2 that stories render under, and
347
+ the `(rule, selector, severity)` a11y shape in § Review pass that the workshop's validate
348
+ step writes into.
301
349
 
302
350
  ## Security constraints
303
351
 
@@ -3,6 +3,9 @@ model_tier: high
3
3
  name: readme-reviewer
4
4
  description: "Use when reviewing a README for accuracy, usability, and alignment with the actual repository. Detects invented content, broken setup steps, and structural issues."
5
5
  domain: quality
6
+ scope:
7
+ write: []
8
+ verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
6
9
  execution:
7
10
  type: assisted
8
11
  handler: internal
@@ -3,6 +3,9 @@ model_tier: medium
3
3
  name: readme-writing
4
4
  description: "Use when creating, rewriting, or significantly improving a README based on the actual repository structure, commands, and intended audience."
5
5
  domain: process
6
+ scope:
7
+ write: []
8
+ verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
6
9
  execution:
7
10
  type: assisted
8
11
  handler: internal
@@ -3,6 +3,9 @@ model_tier: medium
3
3
  name: readme-writing-package
4
4
  description: "Use when creating or rewriting a README for a reusable package or library. Focus on installability, minimal usage example, compatibility, and developer onboarding."
5
5
  domain: process
6
+ scope:
7
+ write: []
8
+ verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
6
9
  execution:
7
10
  type: assisted
8
11
  handler: internal
@@ -122,7 +122,7 @@ For each comment classified as blocking/important:
122
122
 
123
123
  Run the relevant tests and linters **between** each group — do not
124
124
  batch four changes and then run tests once. See
125
- [`verify-before-complete`](../verify-before-complete/SKILL.md).
125
+ [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md).
126
126
 
127
127
  ## Output format
128
128
 
@@ -181,7 +181,7 @@ When reporting back to the user after handling review:
181
181
  * Executing the fixes across many comments → [`fix-pr-comments`](../../commands/fix-pr-comments.md)
182
182
  (handles both bot + human reviewers in one pass)
183
183
  * Running the full verification gate before pushing replies →
184
- [`verify-before-complete`](../verify-before-complete/SKILL.md)
184
+ [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md)
185
185
  * Writing the commit message that references the review →
186
186
  [`conventional-commits-writing`](../conventional-commits-writing/SKILL.md)
187
187
  * Digging into *why* the reviewer's scenario actually fails →
@@ -7,6 +7,9 @@ personas:
7
7
  - senior-engineer
8
8
  - ai-agent
9
9
  domain: product
10
+ scope:
11
+ write: []
12
+ verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
10
13
  execution:
11
14
  type: assisted
12
15
  handler: internal
@@ -10,6 +10,9 @@ personas:
10
10
  - critical-challenger
11
11
  - ai-agent
12
12
  domain: product
13
+ scope:
14
+ write: []
15
+ verification_reason: "execution.handler is internal, so this skill spawns no subprocess — writes happen through the agent's declared allowed_tools. No command can prove a scope the skill never executes."
13
16
  execution:
14
17
  type: assisted
15
18
  handler: internal
@@ -60,7 +60,7 @@ Before asking anyone else:
60
60
  * Check for secrets in diff — API keys, connection strings, tokens
61
61
  * Check file-system side effects — generated files, lockfile churn,
62
62
  IDE configs, `.env` changes
63
- * Run the linter + tests (see [`verify-before-complete`](../verify-before-complete/SKILL.md))
63
+ * Run the linter + tests (see [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md))
64
64
  * If you find issues → fix them, do **not** ship them and hope the
65
65
  reviewer flags them
66
66
 
@@ -192,7 +192,7 @@ When handing the review request to the reviewer (PR body, Slack, email):
192
192
  * Actually opening the PR → [`create-pr`](../../commands/create-pr.md)
193
193
  * Writing the commits themselves → [`commit`](../../commands/commit.md),
194
194
  [`conventional-commits-writing`](../conventional-commits-writing/SKILL.md)
195
- * Verifying readiness → [`verify-before-complete`](../verify-before-complete/SKILL.md)
195
+ * Verifying readiness → [`verify-completion-evidence`](../verify-completion-evidence/SKILL.md)
196
196
  * Processing the feedback when it arrives → [`receiving-code-review`](../receiving-code-review/SKILL.md)
197
197
 
198
198
  ## Validation checklist
@@ -31,7 +31,7 @@ Do NOT use when:
31
31
  - The diff is low-risk and no ownership map exists — fall back to the
32
32
  common role vocabulary below.
33
33
  - A full PR description is requested — route to
34
- [`create-pr-description`](../create-pr:description-only/SKILL.md) and let
34
+ [`/pr:create:description-only`](../../domains/git/pr/create/description-only/command.md) and let
35
35
  it call this skill for the routing block.
36
36
  - A threat model is wanted — route to
37
37
  [`threat-modeling`](../threat-modeling/SKILL.md).
@@ -210,6 +210,6 @@ Data source: <"ownership-map.yml + historical-bug-patterns.yml"
210
210
 
211
211
  - [`reviewer-awareness`](../../rules/reviewer-awareness.md) — the rule that routes here: anchor reviewer choice in paths and risk, never seniority
212
212
  - [`review-routing-data-format`](../../../docs/guidelines/agent-infra/review-routing-data-format.md)
213
- - [`create-pr-description`](../create-pr:description-only/SKILL.md)
213
+ - [`/pr:create:description-only`](../../domains/git/pr/create/description-only/command.md)
214
214
  - [`judge-test-coverage`](../judge-test-coverage/SKILL.md) — consumes
215
215
  the `required_test` entries from matched patterns.
@@ -51,8 +51,18 @@ dashboard-sync axis stays in `roadmap-management`.
51
51
  Authoring or materially rewriting a roadmap must go through
52
52
  Understand → Research → Draft per the
53
53
  [`artifact-drafting-protocol`](../../rules/artifact-drafting-protocol.md)
54
- rule. Inspect existing roadmaps under `agents/roadmaps/` for overlap
55
- or supersession before opening a new one. **Gate C first** — "write a
54
+ rule. **Run the probe, do not eyeball the directory:**
55
+
56
+ ```bash
57
+ agent-config roadmap:context
58
+ ```
59
+
60
+ It reports sibling roadmaps on the same topic across all four roadmap
61
+ directories, inbox notes, and open PRs on the cited paths — the semantic axis a
62
+ filename scan cannot see. Each hit becomes one `relates:` row
63
+ (`extends` / `supersedes` / `depends` / `disjoint`, template rule 18); zero hits
64
+ becomes `relates: []` carrying the probe's `scanned:` line as its
65
+ justification. **Gate C first** — "write a
56
66
  plan/roadmap" is a gated surface, so run
57
67
  [`plan-confidence-gate`](../../contexts/execution/plan-confidence-gate.md)
58
68
  before drafting (95%-conditions, marker, interview-or-degrade, C→R1 handoff).
@@ -218,45 +228,12 @@ preferred.
218
228
 
219
229
  When a parent roadmap closes with `[~]` items, the
220
230
  [`roadmap-management`](../roadmap-management/SKILL.md) skill spawns a
221
- follow-up. Authors and reviewers must know the shape so they can
222
- recognise it:
223
-
224
- ```markdown
225
- ---
226
- complexity: lightweight
227
- status: draft # optional — draft hides from dashboard
228
- parent_roadmap: <parent-slug> # back-link to the archived source
229
- ---
230
-
231
- # Roadmap: Follow-up to <parent-title>
232
-
233
- > <One sentence: carried-over outcome.>
234
-
235
- ## Context
236
-
237
- This roadmap collects items deferred from
238
- [`agents/roadmaps/archive/<parent-slug>.md`](../archive/<parent-slug>.md).
239
- { … original phases preserved verbatim … }
240
-
241
- <!-- For option 2 (ready + blocked), add this as a body note, NOT in frontmatter: -->
242
- > Blocked until <condition>. Execution starts when the condition clears.
243
- ```
244
-
245
- Two states the author picks between (mirrors the Iron Law 3
246
- numbered-options block in [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md)):
247
-
248
- - **`status: draft`** → hidden from `agents/roadmaps-progress.md`
249
- until flipped. Use for items the user wants captured but not
250
- surfaced to the active backlog yet.
251
- - **`status: ready` (default; omit the key)** plus body
252
- `> Blocked until …` note → visible in the dashboard, execution
253
- gated by the documented condition. The blocking is a body
254
- convention, not enforced by the dashboard generator — readers
255
- honor the note.
256
-
257
- The follow-up roadmap is **not** authored from scratch — the
258
- deferred steps are copied verbatim (with their phase context). This
259
- preserves the plan exactly as the author originally wrote it.
231
+ follow-up. Authors and reviewers must know the shape so they can recognise it:
232
+ the frontmatter template, the two states the author picks between
233
+ (`status: draft`, hidden from the dashboard, vs the default `status: ready`
234
+ plus a body `> Blocked until …` note), and the rule that deferred steps are
235
+ copied verbatim rather than re-authored →
236
+ [`references/follow-up-roadmap-shape.md`](references/follow-up-roadmap-shape.md).
260
237
 
261
238
  ### 8. Source-derived & capability-adoption roadmaps (conditional)
262
239
 
@@ -311,6 +288,11 @@ to every roadmap you author.
311
288
  3. Are checkboxes present in every non-intro phase?
312
289
  4. Are exit criteria decidable, or vibe-based ("looks good")?
313
290
  5. Is content duplicated from another roadmap (supersession instead)?
291
+ 5b. Does the frontmatter carry a `relates:` block — one row per probe hit with
292
+ an `extends`/`supersedes`/`depends`/`disjoint` relation, or an explicit
293
+ `relates: []` whose note carries the probe's `scanned:` line? A `relates:`
294
+ list written by reflex is worse than none: the empty case must be genuinely
295
+ empty, not unexamined.
314
296
  6. Any human-gate steps or sign-off phases (§ 4c violation) —
315
297
  agent-verifiable check or structured blocker instead?
316
298
  7. *Source-derived/adoption only (§ 8):* is there a `KEEP`/`FOLD`/`CUT`
@@ -0,0 +1,47 @@
1
+ # roadmap-writing — follow-up roadmap shape
2
+
3
+ > Mode body of the [`roadmap-writing`](../SKILL.md) skill (router-head
4
+ > retrofit, 2026-08-23 — SKILL.md reached the K6 400-line cap). Content moved
5
+ > VERBATIM from SKILL.md § 7; load this file when § 7 routes here.
6
+
7
+ When a parent roadmap closes with `[~]` items, the
8
+ [`roadmap-management`](../../roadmap-management/SKILL.md) skill spawns a
9
+ follow-up. Authors and reviewers must know the shape so they can
10
+ recognise it:
11
+
12
+ ```markdown
13
+ ---
14
+ complexity: lightweight
15
+ status: draft # optional — draft hides from dashboard
16
+ parent_roadmap: <parent-slug> # back-link to the archived source
17
+ ---
18
+
19
+ # Roadmap: Follow-up to <parent-title>
20
+
21
+ > <One sentence: carried-over outcome.>
22
+
23
+ ## Context
24
+
25
+ This roadmap collects items deferred from
26
+ [`agents/roadmaps/archive/<parent-slug>.md`](../archive/<parent-slug>.md).
27
+ { … original phases preserved verbatim … }
28
+
29
+ <!-- For option 2 (ready + blocked), add this as a body note, NOT in frontmatter: -->
30
+ > Blocked until <condition>. Execution starts when the condition clears.
31
+ ```
32
+
33
+ Two states the author picks between (mirrors the Iron Law 3
34
+ numbered-options block in [`roadmap-progress-sync`](../../../rules/roadmap-progress-sync.md)):
35
+
36
+ - **`status: draft`** → hidden from `agents/roadmaps-progress.md`
37
+ until flipped. Use for items the user wants captured but not
38
+ surfaced to the active backlog yet.
39
+ - **`status: ready` (default; omit the key)** plus body
40
+ `> Blocked until …` note → visible in the dashboard, execution
41
+ gated by the documented condition. The blocking is a body
42
+ convention, not enforced by the dashboard generator — readers
43
+ honor the note.
44
+
45
+ The follow-up roadmap is **not** authored from scratch — the
46
+ deferred steps are copied verbatim (with their phase context). This
47
+ preserves the plan exactly as the author originally wrote it.
@@ -3,6 +3,9 @@ model_tier: medium
3
3
  name: rtk-output-filtering
4
4
  description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer, third-party Apache-2.0; upstream reports 60-90% token savings). Covers installation, configuration, and usage patterns."
5
5
  domain: process
6
+ scope:
7
+ write: []
8
+ verification_reason: "this skill wraps another command's stdout; it has no output path of its own. Absence of a write is not something a command can prove."
6
9
  execution:
7
10
  type: assisted
8
11
  handler: shell
@@ -28,12 +31,25 @@ commands through intelligent output filtering (whitespace, boilerplate,
28
31
  comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
29
32
  **Third-party Apache-2.0 tool** (rtk-ai upstream — an external project, not part of this package).
30
33
 
31
- **Savings, honestly stated:** upstream reports 60-90% (their estimate —
32
- "actual savings vary"). agent-config's own scoped spot-measurement
33
- (2026-07-28, one repo, one macOS machine, 8-command corpus) landed at
34
- **33% overall, 0-57% per command** — verbose commands (`git status`,
35
- `git log`, `ls -la`) save ~55%, already-compact output (`--oneline`,
36
- `--stat`) passes through at ~0%. See `internal/bench/rtk-savings/RESULTS.md`.
34
+ **Savings — STALE, and scoped. Do not quote the number without this label.**
35
+ Upstream reports 60-90% (their estimate — "actual savings vary").
36
+ agent-config's own figure is **33% overall, 0-57% per command**, and it is a
37
+ **single spot-measurement from 2026-07-28: one repo, one macOS machine, an
38
+ 8-command corpus.** It has **not** been superseded by a wider run, and the
39
+ widened re-bench is **deferred** — `road-to-terminal-token-economy` steps
40
+ 3.2-3.4. **The reason changed on 2026-08-23 and the label is updated with it:** the
41
+ original deferral was ordering (Phase 2 had not chosen the wrapper mechanism, so a
42
+ re-bench would measure the wrong subject). Phase 2 has now chosen — the existing
43
+ warn-only nudge — so that objection is discharged. What defers it now is the
44
+ re-bench's own registered design, which requires **at least two machines**, and only
45
+ one is reachable. A one-machine re-bench would reproduce exactly the narrowness the
46
+ widening exists to fix. AI council 2026-08-23, 2/2 convergent, on both readings.
47
+
48
+ Treat it as an order of magnitude for *that* corpus, never as this package's
49
+ general claim. Verbose commands (`git status`, `git log`, `ls -la`) save ~55%;
50
+ already-compact output (`--oneline`, `--stat`) passes through at ~0%, which is
51
+ why an overall percentage is meaningless without the corpus that produced it.
52
+ See `internal/bench/rtk-savings/RESULTS.md`.
37
53
 
38
54
  **Docs:** https://www.mintlify.com/rtk-ai/rtk
39
55
  **Repo:** https://github.com/rtk-ai/rtk
@@ -15,6 +15,9 @@ trust:
15
15
  level: professional
16
16
  install:
17
17
  removable: true
18
+ triggers:
19
+ - phrase: "cash runway"
20
+ - phrase: "burn rate"
18
21
  ---
19
22
 
20
23
  # runway-cognition
@@ -82,6 +82,31 @@ blocks:
82
82
  target: negative
83
83
  description: "Clichés to reject, load-bearing top-first."
84
84
 
85
+ # Chain directives — NOT one of the 12 blocks.
86
+ #
87
+ # A block above describes the shot. A chain directive describes how this scene
88
+ # JOINS ITS NEIGHBOUR, which is a property of the assembly, not of the prompt —
89
+ # so it is listed separately and the blueprint stays a 12-block IR everywhere
90
+ # else in the tree. `parse-blueprint.sh` accepts the label like any other and
91
+ # emits the value at the top level; the chain itself is read by
92
+ # `scripts/ai-video/lib/seam-plan.sh`, which this file's parser never sees.
93
+ chain_directives:
94
+ CONTINUITY:
95
+ required: false
96
+ target: continuity
97
+ default: cut
98
+ values: [cut, handoff, connector]
99
+ description: >
100
+ How this scene joins the PREVIOUS one. `cut` is a hard cut and is the
101
+ value assumed when the label is absent, so every blueprint written before
102
+ this directive existed keeps its exact meaning. `handoff` means this
103
+ scene's ref_images[0] is the extracted last frame of the previous scene's
104
+ RENDERED clip rather than its own still, which forces the two clips to
105
+ render sequentially. `connector` is a handoff plus one extra bridging
106
+ clip, and needs a probed `end_frame: true` on both adjacent models.
107
+ An unknown value is a parse error naming the value — never a silent
108
+ downgrade to `cut`.
109
+
85
110
  # Adapter-contract JSON shape produced by parse-blueprint.sh
86
111
  output_shape: |
87
112
  {
@@ -102,6 +127,7 @@ output_shape: |
102
127
  },
103
128
  "duration": 5.0,
104
129
  "negative": ["...", "..."],
130
+ "continuity": "cut" | "handoff" | "connector",
105
131
  "requires": {
106
132
  "audio_native": true | false
107
133
  }
@@ -11,6 +11,10 @@ workspaces:
11
11
  - engineering
12
12
  packs:
13
13
  - engineering-base
14
+ triggers:
15
+ - phrase: "secret rotation"
16
+ - phrase: "secrets store"
17
+ - phrase: "secret scanning"
14
18
  ---
15
19
 
16
20
  # secrets-management