@event4u/agent-config 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (378) hide show
  1. package/.claude-plugin/marketplace.json +5 -5
  2. package/CHANGELOG.md +167 -440
  3. package/README.md +3 -3
  4. package/dist/agent-src/commands/agent-handoff.md +5 -4
  5. package/dist/agent-src/commands/agent-status.md +1 -0
  6. package/dist/agent-src/commands/agents/audit.md +1 -0
  7. package/dist/agent-src/commands/agents/init.md +3 -0
  8. package/dist/agent-src/commands/agents/optimize.md +1 -0
  9. package/dist/agent-src/commands/agents/user/accept.md +1 -0
  10. package/dist/agent-src/commands/agents/user/init.md +1 -0
  11. package/dist/agent-src/commands/agents/user/review.md +1 -0
  12. package/dist/agent-src/commands/agents/user/show.md +1 -0
  13. package/dist/agent-src/commands/agents/user/update.md +1 -0
  14. package/dist/agent-src/commands/agents/user.md +1 -0
  15. package/dist/agent-src/commands/agents.md +1 -0
  16. package/dist/agent-src/commands/analytics/prune.md +3 -2
  17. package/dist/agent-src/commands/analytics/show.md +3 -2
  18. package/dist/agent-src/commands/analytics.md +3 -2
  19. package/dist/agent-src/commands/analyze-reference-repo.md +1 -0
  20. package/dist/agent-src/commands/bug-fix.md +1 -0
  21. package/dist/agent-src/commands/bug-investigate.md +1 -0
  22. package/dist/agent-src/commands/challenge-me/vision.md +3 -2
  23. package/dist/agent-src/commands/challenge-me/with-docs.md +3 -2
  24. package/dist/agent-src/commands/challenge-me.md +3 -2
  25. package/dist/agent-src/commands/chat-history/import.md +9 -9
  26. package/dist/agent-src/commands/chat-history.md +32 -30
  27. package/dist/agent-src/commands/check-current-md.md +1 -0
  28. package/dist/agent-src/commands/commit/in-chunks.md +1 -0
  29. package/dist/agent-src/commands/commit.md +1 -0
  30. package/dist/agent-src/commands/condense.md +1 -0
  31. package/dist/agent-src/commands/context/create.md +1 -0
  32. package/dist/agent-src/commands/context/refactor.md +1 -0
  33. package/dist/agent-src/commands/context.md +1 -0
  34. package/dist/agent-src/commands/cost-report.md +5 -4
  35. package/dist/agent-src/commands/council/analysis.md +3 -2
  36. package/dist/agent-src/commands/council/debate.md +5 -4
  37. package/dist/agent-src/commands/council/default.md +3 -2
  38. package/dist/agent-src/commands/council/design.md +3 -2
  39. package/dist/agent-src/commands/council/optimize.md +3 -2
  40. package/dist/agent-src/commands/council/pr.md +3 -2
  41. package/dist/agent-src/commands/council.md +4 -3
  42. package/dist/agent-src/commands/e2e-heal.md +1 -0
  43. package/dist/agent-src/commands/e2e-plan.md +1 -0
  44. package/dist/agent-src/commands/estimate-ticket.md +1 -0
  45. package/dist/agent-src/commands/feature/dev.md +1 -0
  46. package/dist/agent-src/commands/feature/explore.md +1 -0
  47. package/dist/agent-src/commands/feature/plan.md +6 -6
  48. package/dist/agent-src/commands/feature/refactor.md +1 -0
  49. package/dist/agent-src/commands/feature/roadmap.md +1 -0
  50. package/dist/agent-src/commands/feature.md +1 -0
  51. package/dist/agent-src/commands/fix/ci.md +1 -0
  52. package/dist/agent-src/commands/fix/portability.md +1 -0
  53. package/dist/agent-src/commands/fix/pr-comments.md +147 -15
  54. package/dist/agent-src/commands/fix/refs.md +1 -0
  55. package/dist/agent-src/commands/fix/seeder.md +1 -0
  56. package/dist/agent-src/commands/fix.md +8 -8
  57. package/dist/agent-src/commands/ghostwriter/delete.md +1 -0
  58. package/dist/agent-src/commands/ghostwriter/fetch.md +1 -0
  59. package/dist/agent-src/commands/ghostwriter/list.md +1 -0
  60. package/dist/agent-src/commands/ghostwriter/show.md +1 -0
  61. package/dist/agent-src/commands/ghostwriter/write.md +1 -0
  62. package/dist/agent-src/commands/ghostwriter.md +1 -0
  63. package/dist/agent-src/commands/grill-me.md +3 -2
  64. package/dist/agent-src/commands/image/analyse.md +1 -0
  65. package/dist/agent-src/commands/image/create.md +1 -0
  66. package/dist/agent-src/commands/image/verify.md +1 -0
  67. package/dist/agent-src/commands/image.md +1 -0
  68. package/dist/agent-src/commands/implement-ticket.md +1 -0
  69. package/dist/agent-src/commands/jira-ticket.md +1 -0
  70. package/dist/agent-src/commands/judge/on-diff.md +1 -0
  71. package/dist/agent-src/commands/judge/solo.md +1 -0
  72. package/dist/agent-src/commands/judge/steps.md +1 -0
  73. package/dist/agent-src/commands/judge.md +1 -0
  74. package/dist/agent-src/commands/knowledge/cross-repo.md +1 -0
  75. package/dist/agent-src/commands/knowledge/forget.md +1 -0
  76. package/dist/agent-src/commands/knowledge/ingest.md +1 -0
  77. package/dist/agent-src/commands/knowledge/list.md +1 -0
  78. package/dist/agent-src/commands/knowledge.md +1 -0
  79. package/dist/agent-src/commands/memory/add.md +8 -6
  80. package/dist/agent-src/commands/memory/learn-low-impact.md +3 -2
  81. package/dist/agent-src/commands/memory/load.md +7 -7
  82. package/dist/agent-src/commands/memory/mine-session.md +39 -12
  83. package/dist/agent-src/commands/memory/promote.md +3 -2
  84. package/dist/agent-src/commands/memory/propose.md +7 -6
  85. package/dist/agent-src/commands/memory.md +3 -2
  86. package/dist/agent-src/commands/mode.md +1 -0
  87. package/dist/agent-src/commands/module/create.md +1 -0
  88. package/dist/agent-src/commands/module/explore.md +1 -0
  89. package/dist/agent-src/commands/module.md +1 -0
  90. package/dist/agent-src/commands/optimize/agents-dir.md +1 -0
  91. package/dist/agent-src/commands/optimize/augmentignore.md +1 -0
  92. package/dist/agent-src/commands/optimize/rtk.md +1 -0
  93. package/dist/agent-src/commands/optimize/skills.md +1 -0
  94. package/dist/agent-src/commands/optimize-prompt.md +1 -0
  95. package/dist/agent-src/commands/optimize.md +1 -0
  96. package/dist/agent-src/commands/orchestrate.md +1 -0
  97. package/dist/agent-src/commands/override/create.md +1 -0
  98. package/dist/agent-src/commands/override/manage.md +1 -0
  99. package/dist/agent-src/commands/override.md +1 -0
  100. package/dist/agent-src/commands/package-reset.md +1 -0
  101. package/dist/agent-src/commands/package-test.md +1 -0
  102. package/dist/agent-src/commands/post-as/ghostwriter.md +1 -0
  103. package/dist/agent-src/commands/post-as/me.md +1 -0
  104. package/dist/agent-src/commands/post-as.md +1 -0
  105. package/dist/agent-src/commands/pr/create/description-only.md +1 -0
  106. package/dist/agent-src/commands/pr/create.md +25 -0
  107. package/dist/agent-src/commands/prediction-pool.md +1 -0
  108. package/dist/agent-src/commands/prepare-for-review.md +1 -0
  109. package/dist/agent-src/commands/profile/activate.md +1 -0
  110. package/dist/agent-src/commands/profile/deactivate.md +1 -0
  111. package/dist/agent-src/commands/profile/show.md +1 -0
  112. package/dist/agent-src/commands/profile.md +1 -0
  113. package/dist/agent-src/commands/project-analyze.md +1 -0
  114. package/dist/agent-src/commands/project-health.md +1 -0
  115. package/dist/agent-src/commands/quality-fix.md +1 -0
  116. package/dist/agent-src/commands/refine-ticket.md +1 -0
  117. package/dist/agent-src/commands/research/deep.md +1 -0
  118. package/dist/agent-src/commands/research/report.md +1 -0
  119. package/dist/agent-src/commands/research.md +1 -0
  120. package/dist/agent-src/commands/review-changes.md +1 -0
  121. package/dist/agent-src/commands/review-routing.md +1 -0
  122. package/dist/agent-src/commands/roadmap/ai-council.md +1 -0
  123. package/dist/agent-src/commands/roadmap/create.md +1 -0
  124. package/dist/agent-src/commands/roadmap/process-full.md +1 -0
  125. package/dist/agent-src/commands/roadmap/process-phase.md +1 -0
  126. package/dist/agent-src/commands/roadmap/process-step.md +1 -0
  127. package/dist/agent-src/commands/roadmap.md +1 -0
  128. package/dist/agent-src/commands/rule-compliance-audit.md +1 -0
  129. package/dist/agent-src/commands/security-audit-config.md +84 -0
  130. package/dist/agent-src/commands/set-cost-profile.md +1 -0
  131. package/dist/agent-src/commands/skill/preview.md +1 -0
  132. package/dist/agent-src/commands/skill.md +1 -0
  133. package/dist/agent-src/commands/skills/discover.md +1 -0
  134. package/dist/agent-src/commands/skills.md +1 -0
  135. package/dist/agent-src/commands/sync-agent-settings.md +1 -0
  136. package/dist/agent-src/commands/sync-gitignore/fix.md +1 -0
  137. package/dist/agent-src/commands/sync-gitignore.md +1 -0
  138. package/dist/agent-src/commands/tests/create.md +1 -0
  139. package/dist/agent-src/commands/tests/execute.md +1 -0
  140. package/dist/agent-src/commands/tests.md +1 -0
  141. package/dist/agent-src/commands/threat-model.md +1 -0
  142. package/dist/agent-src/commands/update-form-request-messages.md +1 -0
  143. package/dist/agent-src/commands/upstream-contribute.md +1 -0
  144. package/dist/agent-src/commands/video/from-script.md +1 -0
  145. package/dist/agent-src/commands/video/from-song.md +1 -0
  146. package/dist/agent-src/commands/video/scene.md +1 -0
  147. package/dist/agent-src/commands/video/stitch.md +1 -0
  148. package/dist/agent-src/commands/video/storyboard.md +1 -0
  149. package/dist/agent-src/commands/video.md +1 -0
  150. package/dist/agent-src/commands/work.md +1 -0
  151. package/dist/agent-src/contexts/augment-infrastructure.md +1 -1
  152. package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +1 -1
  153. package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +2 -2
  154. package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +6 -6
  155. package/dist/agent-src/contexts/contracts/consumer-agents-md-guide.md +2 -2
  156. package/dist/agent-src/contexts/execution/rdp-gate.md +75 -0
  157. package/dist/agent-src/contexts/subagent-configuration.md +1 -0
  158. package/dist/agent-src/personas/advisors/contrarian.md +1 -1
  159. package/dist/agent-src/personas/advisors/executor.md +1 -1
  160. package/dist/agent-src/personas/advisors/expansionist.md +1 -1
  161. package/dist/agent-src/personas/advisors/first-principles.md +1 -1
  162. package/dist/agent-src/personas/advisors/outsider.md +1 -1
  163. package/dist/agent-src/rules/autonomous-execution.md +12 -0
  164. package/dist/agent-src/rules/external-reference-deep-dive.md +1 -1
  165. package/dist/agent-src/rules/git-history-discipline.md +47 -1
  166. package/dist/agent-src/rules/improve-before-implement.md +12 -0
  167. package/dist/agent-src/rules/lethal-trifecta-guard.md +80 -0
  168. package/dist/agent-src/rules/no-pr-progress-comments.md +3 -4
  169. package/dist/agent-src/rules/notes-first-reasoning.md +71 -0
  170. package/dist/agent-src/rules/roadmap-progress-sync.md +48 -31
  171. package/dist/agent-src/rules/security-sensitive-stop.md +14 -1
  172. package/dist/agent-src/rules/source-confidentiality.md +97 -0
  173. package/dist/agent-src/rules/think-before-action.md +9 -1
  174. package/dist/agent-src/rules/untrusted-input-defense.md +76 -0
  175. package/dist/agent-src/scripts/archive_completed_roadmaps.py +171 -0
  176. package/dist/agent-src/skills/adversarial-review/SKILL.md +14 -0
  177. package/dist/agent-src/skills/agent-security-review/SKILL.md +113 -0
  178. package/dist/agent-src/skills/agent-security-review/evals/triggers.json +51 -0
  179. package/dist/agent-src/skills/ai-council/SKILL.md +3 -3
  180. package/dist/agent-src/skills/async-python-patterns/SKILL.md +1 -1
  181. package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +12 -11
  182. package/dist/agent-src/skills/command-routing/SKILL.md +1 -1
  183. package/dist/agent-src/skills/complexity-first-planning/SKILL.md +96 -0
  184. package/dist/agent-src/skills/complexity-first-planning/evals/triggers.json +16 -0
  185. package/dist/agent-src/skills/copilot-config/SKILL.md +3 -4
  186. package/dist/agent-src/skills/defense-in-depth/SKILL.md +1 -1
  187. package/dist/agent-src/skills/developer-like-execution/SKILL.md +5 -4
  188. package/dist/agent-src/skills/error-handling-patterns/SKILL.md +1 -1
  189. package/dist/agent-src/skills/feature-planning/SKILL.md +2 -2
  190. package/dist/agent-src/skills/mcp-builder/SKILL.md +1 -1
  191. package/dist/agent-src/skills/memory-consolidation/SKILL.md +63 -17
  192. package/dist/agent-src/skills/prompt-engineering-patterns/SKILL.md +1 -1
  193. package/dist/agent-src/skills/readme-writing-package/SKILL.md +1 -1
  194. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +119 -0
  195. package/dist/agent-src/skills/reasoning-orchestrator/evals/triggers.json +16 -0
  196. package/dist/agent-src/skills/receiving-code-review/SKILL.md +6 -6
  197. package/dist/agent-src/skills/refine-prompt/SKILL.md +1 -1
  198. package/dist/agent-src/skills/refine-ticket/SKILL.md +1 -1
  199. package/dist/agent-src/skills/repomix-packer/SKILL.md +1 -1
  200. package/dist/agent-src/skills/secrets-management/SKILL.md +1 -1
  201. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +10 -3
  202. package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
  203. package/dist/agent-src/skills/testing-anti-patterns/process-anti-patterns.md +1 -1
  204. package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
  205. package/dist/agent-src/templates/agents/.gitattributes.fragment +0 -1
  206. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +4 -4
  207. package/dist/agent-src/templates/scripts/check_memory.py +1 -2
  208. package/dist/agent-src/templates/scripts/check_memory_proposal.py +1 -1
  209. package/dist/agent-src/templates/scripts/memory_lookup.py +148 -289
  210. package/dist/agent-src/templates/scripts/memory_report.py +132 -2
  211. package/dist/agent-src/templates/scripts/memory_signal.py +7 -9
  212. package/dist/agent-src/templates/scripts/memory_status.py +25 -206
  213. package/dist/agent-src/templates/scripts/work_engine/directives/backend/memory.py +6 -6
  214. package/dist/agent-src/templates/scripts/work_engine/directives/ui/_passthrough.py +3 -3
  215. package/dist/agent-src/templates/scripts/work_engine/scoring/memory_visibility.py +0 -1
  216. package/dist/cli/agent-config.js +31 -300
  217. package/dist/cli/agent-config.js.map +1 -1
  218. package/dist/cli/commands/commands.js +10 -5
  219. package/dist/cli/commands/commands.js.map +1 -1
  220. package/dist/cli/discovery/loadManifest.js.map +1 -1
  221. package/dist/cli/main.js +309 -0
  222. package/dist/cli/main.js.map +1 -0
  223. package/dist/discovery/deprecation-report.md +1 -1
  224. package/dist/discovery/discovery-manifest.json +645 -342
  225. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  226. package/dist/discovery/discovery-manifest.summary.md +8 -5
  227. package/dist/discovery/orphan-report.md +1 -1
  228. package/dist/discovery/packs.json +149 -37
  229. package/dist/discovery/trust-report.md +3 -3
  230. package/dist/discovery/workspaces.json +61 -36
  231. package/dist/mcp/registry-manifest.json +4 -4
  232. package/dist/router.json +1 -1
  233. package/dist/server/routes/wizard.js +4 -3
  234. package/dist/server/routes/wizard.js.map +1 -1
  235. package/dist/server/schemas/settings.js +18 -0
  236. package/dist/server/schemas/settings.js.map +1 -1
  237. package/docs/MIGRATION.md +1 -1
  238. package/docs/adrs/cost/0001-hard-stop-hook.md +5 -5
  239. package/docs/adrs/memory/0001-consumer-side-snapshot.md +15 -7
  240. package/docs/adrs/memory/README.md +6 -5
  241. package/docs/adrs/router/0001-three-tier-routing.md +2 -2
  242. package/docs/adrs/schema/0001-json-schema-frontmatter.md +2 -2
  243. package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +5 -5
  244. package/docs/adrs/telegraph/0001-default-off-until-bench.md +3 -3
  245. package/docs/architecture.md +9 -9
  246. package/docs/archive/CHANGELOG-pre-2.2.0.md +30 -30
  247. package/docs/archive/CHANGELOG-pre-2.25.0.md +1 -1
  248. package/docs/archive/CHANGELOG-pre-4.5.0.md +1 -1
  249. package/docs/archive/CHANGELOG-pre-6.0.0.md +473 -0
  250. package/docs/benchmark.md +54 -53
  251. package/docs/benchmarks.md +2 -2
  252. package/docs/case-studies/{frontend-design-vs-ui-ux-pro-max.md → frontend-design-positioning.md} +4 -4
  253. package/docs/catalog.md +20 -13
  254. package/docs/command-flows.md +90 -92
  255. package/docs/contracts/adr-layout.md +2 -3
  256. package/docs/contracts/adr-level-6-productization.md +1 -1
  257. package/docs/contracts/ai-council-config.md +42 -7
  258. package/docs/contracts/command-clusters.md +1 -1
  259. package/docs/contracts/cost-enforcement.md +1 -1
  260. package/docs/contracts/cost-summary-schema.md +1 -1
  261. package/docs/contracts/daily-workspace.md +1 -0
  262. package/docs/contracts/discovery-manifest.schema.json +4 -2
  263. package/docs/contracts/explain-modes.md +1 -1
  264. package/docs/contracts/implement-ticket-flow.md +6 -7
  265. package/docs/contracts/mcp-tool-inventory.md +10 -10
  266. package/docs/contracts/measurement-baseline.md +1 -1
  267. package/docs/contracts/memory-visibility-v1.md +1 -5
  268. package/docs/contracts/namespace.md +1 -1
  269. package/docs/contracts/persona-schema.md +1 -1
  270. package/docs/contracts/rule-interactions.md +1 -1
  271. package/docs/contracts/smoke-contracts.md +1 -1
  272. package/docs/contracts/universal-skills.md +0 -1
  273. package/docs/contracts/workspace-boundary.md +84 -0
  274. package/docs/customization.md +3 -3
  275. package/docs/decisions/ADR-009-event4u-namespace.md +1 -1
  276. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +1 -1
  277. package/docs/decisions/ADR-026-explain-mode-translation.md +1 -1
  278. package/docs/decisions/ADR-088-no-external-runtime-federation.md +26 -27
  279. package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +95 -0
  280. package/docs/decisions/ADR-091-split-meta-capability-packs.md +113 -0
  281. package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +93 -0
  282. package/docs/decisions/ADR-093-ai-council-config-user-global.md +111 -0
  283. package/docs/decisions/ADR-094-agent-memory-layer-removal.md +94 -0
  284. package/docs/decisions/ADR-095-workspace-boundary-contract.md +108 -0
  285. package/docs/decisions/INDEX.md +6 -0
  286. package/docs/development.md +5 -7
  287. package/docs/getting-started.md +4 -4
  288. package/docs/guidelines/agent-infra/5w2h-analysis.md +1 -1
  289. package/docs/guidelines/agent-infra/comparison-matrix.md +1 -1
  290. package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
  291. package/docs/guidelines/agent-infra/critical-thinking.md +1 -1
  292. package/docs/guidelines/agent-infra/engineering-memory-data-format.md +1 -5
  293. package/docs/guidelines/agent-infra/first-principles.md +1 -1
  294. package/docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md +164 -0
  295. package/docs/guidelines/agent-infra/inversion-thinking.md +1 -1
  296. package/docs/guidelines/agent-infra/ios-simulator-guide.md +9 -14
  297. package/docs/guidelines/agent-infra/mcp-request-signing.md +19 -22
  298. package/docs/guidelines/agent-infra/memory-access.md +25 -31
  299. package/docs/guidelines/agent-infra/mental-models.md +1 -1
  300. package/docs/guidelines/agent-infra/model-recommendation.md +29 -0
  301. package/docs/guidelines/agent-infra/scqa-framework.md +3 -3
  302. package/docs/guidelines/agent-infra/security-lint-containment.md +81 -0
  303. package/docs/guidelines/agent-infra/six-hats.md +1 -1
  304. package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
  305. package/docs/guidelines/agent-infra/untrusted-input-spotlighting.md +72 -0
  306. package/docs/installation.md +1 -1
  307. package/docs/mcp.md +2 -2
  308. package/docs/parity/{bench-ruflo.json → bench-external.json} +10 -10
  309. package/docs/parity/{ruflo.md → external-runtime.md} +9 -9
  310. package/docs/quality.md +3 -3
  311. package/docs/safety.md +3 -3
  312. package/docs/skills-catalog.md +4 -1
  313. package/llms.txt +3 -0
  314. package/package.json +1 -1
  315. package/src/config/agent-settings.template.yml +65 -3
  316. package/src/config/discovery/packs.yml +29 -0
  317. package/src/config/discovery/workspaces.yml +3 -1
  318. package/src/config/gitignore-block.txt +6 -0
  319. package/src/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  320. package/src/scripts/_cli/cmd_doctor.py +99 -13
  321. package/src/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  322. package/src/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  323. package/src/scripts/_lib/bench_ab_scoring_v2.py +227 -0
  324. package/src/scripts/_lib/global_deploy_inventory.py +39 -9
  325. package/src/scripts/_lib/link_crypto.py +206 -0
  326. package/src/scripts/_lib/security_lint.py +228 -0
  327. package/src/scripts/ai_council/clients.py +2 -2
  328. package/src/scripts/ai_council/config.py +55 -0
  329. package/src/scripts/audit_adr_coverage.py +0 -2
  330. package/src/scripts/audit_command_surface.py +18 -5
  331. package/src/scripts/audit_mcp_tools.py +2 -2
  332. package/src/scripts/audit_skill_descriptions.py +2 -2
  333. package/src/scripts/bench_ab_clone.py +62 -12
  334. package/src/scripts/bench_ab_task_runner.py +475 -30
  335. package/src/scripts/bench_ab_v2_run.py +247 -0
  336. package/src/scripts/bench_ab_v2_stats.py +347 -0
  337. package/src/scripts/bench_run.py +1 -1
  338. package/src/scripts/build_discovery_manifest.py +10 -0
  339. package/src/scripts/check_bite_sized_granularity.py +1 -2
  340. package/src/scripts/check_memory.py +49 -63
  341. package/src/scripts/check_memory_proposal.py +1 -1
  342. package/src/scripts/check_no_external_sources.py +101 -0
  343. package/src/scripts/check_references.py +2 -0
  344. package/src/scripts/cost_by_conversation.py +1 -1
  345. package/src/scripts/council_cli.py +28 -14
  346. package/src/scripts/external_sources_denylist.json +91 -0
  347. package/src/scripts/hook_manifest.yaml +14 -6
  348. package/src/scripts/injection_scan_hook.py +145 -0
  349. package/src/scripts/install-hooks.sh +11 -0
  350. package/src/scripts/install.py +88 -13
  351. package/src/scripts/lint_agent_security.py +112 -0
  352. package/src/scripts/lint_bench_ab.py +5 -4
  353. package/src/scripts/lint_command_tiers.py +63 -22
  354. package/src/scripts/lint_discovery_vocabulary.py +2 -0
  355. package/src/scripts/lint_empty_roadmaps.py +80 -0
  356. package/src/scripts/lint_hidden_unicode.py +132 -0
  357. package/src/scripts/lint_instruction_smuggling.py +107 -0
  358. package/src/scripts/lint_marketplace.py +1 -1
  359. package/src/scripts/lint_mcp_config_security.py +124 -0
  360. package/src/scripts/lint_skill_frontmatter_safety.py +144 -0
  361. package/src/scripts/lint_workspace_boundary.py +122 -0
  362. package/src/scripts/mcp_server/consumer_tool_catalog.json +2 -3
  363. package/src/scripts/mcp_server/tools.py +8 -32
  364. package/src/scripts/memory_lookup.py +27 -296
  365. package/src/scripts/memory_report.py +1 -23
  366. package/src/scripts/memory_signal.py +6 -53
  367. package/src/scripts/memory_status.py +25 -206
  368. package/src/scripts/mine_session.py +118 -41
  369. package/src/scripts/pack_dependency_allowlist.json +2 -2
  370. package/src/scripts/render_benchmark_md.py +141 -52
  371. package/src/scripts/schemas/command.schema.json +6 -1
  372. package/src/scripts/security_audit_config.py +153 -0
  373. package/dist/agent-src/commands/chat-history/learn.md +0 -184
  374. package/dist/agent-src/commands/chat-history/show.md +0 -113
  375. package/dist/agent-src/commands/fix/pr-bot-comments.md +0 -157
  376. package/dist/agent-src/commands/fix/pr-developer-comments.md +0 -163
  377. package/dist/agent-src/templates/agents/memory/architecture-decisions.example.yml +0 -95
  378. package/docs/contracts/agent-memory-contract.md +0 -159
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: roadmap-process-full
4
4
  pack: product-basic
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: roadmap
7
8
  sub: process-full
8
9
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: roadmap-process-phase
4
4
  pack: product-basic
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: roadmap
7
8
  sub: process-phase
8
9
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: roadmap-process-step
4
4
  pack: product-basic
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: roadmap
7
8
  sub: process-step
8
9
  skills: [agent-docs-writing, ai-council, roadmap-management]
@@ -7,6 +7,7 @@ intent: "Roadmap dispatcher — create, process-step, process-phase, process-ful
7
7
  routes_to: [roadmap-create, roadmap-process-step, roadmap-process-phase, roadmap-process-full]
8
8
  replaces: []
9
9
  tier: 1
10
+ visibility: advanced
10
11
  description: Roadmap orchestrator — routes to create (authoring) and process-step / process-phase / process-full (autonomous execution).
11
12
  cluster: roadmap
12
13
  type: orchestrator
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: rule-compliance-audit
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  skills: [rule-compliance-audit]
7
8
  description: Audit rule trigger quality, simulate activation, detect overlaps, and find never-activating rules
8
9
  suggestion:
@@ -0,0 +1,84 @@
1
+ ---
2
+ model_tier: high
3
+ name: security-audit-config
4
+ pack: engineering-base
5
+ tier: 2
6
+ visibility: internal
7
+ skills: [judge-security-auditor, threat-modeling, security-audit]
8
+ description: Audit an assembled agent config (CLAUDE.md, .cursor/rules, settings, MCP, hooks, skills) for prompt-injection / supply-chain risk — A–F score per category, mapped to OWASP Agentic Top 10
9
+ council_depth: deep
10
+ suggestion:
11
+ eligible: true
12
+ trigger_description: "audit my agent config, is my CLAUDE.md / MCP setup safe, scan for prompt injection in my rules"
13
+ trigger_context: "a repo with agent config files (CLAUDE.md, .cursor/rules, .mcp.json, .claude/settings.json)"
14
+ workspaces:
15
+ - agent-config-maintainer
16
+ packs:
17
+ - meta
18
+ ---
19
+
20
+ # security-audit-config
21
+
22
+ ## Instructions
23
+
24
+ Audit a consumer's **assembled** agent config for the prompt-injection +
25
+ supply-chain risks behind the "rules-file backdoor" and MCP tool-poisoning
26
+ classes; report an A–F score per category mapped to the OWASP Top 10 for
27
+ Agentic Applications. Consumer-facing counterpart to the suite's own
28
+ `lint_agent_security` self-audit gate.
29
+
30
+ ### 1. Run the static audit
31
+
32
+ ```bash
33
+ python3 src/scripts/security_audit_config.py --root <repo> --json
34
+ ```
35
+
36
+ (omit `--root` to audit the current repo). Reuses the Phase-1 detection library
37
+ under the containment convention
38
+ ([`security-lint-containment`](../docs/guidelines/agent-infra/security-lint-containment.md)),
39
+ so doc/example files don't tank the score. Scans instruction files (`CLAUDE.md`,
40
+ `AGENTS.md`, `.cursor/rules`, `.github/copilot-instructions.md`, `.clinerules`,
41
+ `.windsurfrules`), MCP configs (`.mcp.json`, `.cursor/mcp.json`,
42
+ `claude_desktop_config.json`), settings/hooks (`.claude/settings.json`),
43
+ installed skills.
44
+
45
+ ### 2. Present the score
46
+
47
+ Surface the overall grade + five category grades (Secrets · Permissions · Hooks
48
+ · MCP · Agents/Rules), each with its OWASP-ASI tag, then the findings worth
49
+ acting on (HIGH first). Lead with the worst category.
50
+
51
+ ### 3. Optional deep pass
52
+
53
+ When asked for depth, or any category scores **D/F**, escalate:
54
+
55
+ - Dispatch [`judge-security-auditor`](../skills/judge-security-auditor/SKILL.md)
56
+ over the flagged files for a diff-level verdict.
57
+ - For a red/blue/auditor review of the whole config, hand off to the
58
+ `agent-security-review` skill (`council_depth: deep`).
59
+
60
+ ### 4. Recommend, do not auto-fix
61
+
62
+ Output is **decision support**, not a gate — detection is probabilistic.
63
+ Recommend the fix per finding (secret → `${env:VAR}`, pin an MCP server, remove
64
+ `bypassPermissions`, strip hidden Unicode), but never rewrite the consumer's
65
+ config without confirmation (per [`scope-control`](../../../src/rules/scope-control.md)).
66
+
67
+ ## Output format
68
+
69
+ ```
70
+ Agent-config security audit — <repo>
71
+ Overall: B (84/100)
72
+
73
+ C Secrets 75/100 · ASI04 Supply Chain
74
+ [HIGH] .mcp.json:3: inline secret value — use ${env:VAR}
75
+ F Agents/Rules 50/100 · ASI01 Goal Hijack
76
+ [HIGH] CLAUDE.md:1: role-takeover phrase in prose
77
+ ...
78
+ ```
79
+
80
+ ## See also
81
+
82
+ - [`lint_agent_security`](../../../src/scripts/lint_agent_security.py) — the self-audit (our own corpus) sibling.
83
+ - [`untrusted-input-defense`](../../rules/untrusted-input-defense.md), [`lethal-trifecta-guard`](../../rules/lethal-trifecta-guard.md) — the always-on prevention rules.
84
+ - [`/threat-model`](../threat-model/command.md), [`judge-security-auditor`](../skills/judge-security-auditor/SKILL.md) — deep-pass dispatch.
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: set-cost-profile
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  description: Change the rule_loading_tier in .agent-settings.yml — shows each profile's meaning and applies the selection
7
8
  skills: [file-editor]
8
9
  suggestion:
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: skill-preview
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: skill
7
8
  sub: preview
8
9
  description: Non-destructive preview of a skill — its declared steps, execution type, allowed tools, and file/command targets — before you run it. Read-only, no execution.
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: skill
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  description: Single-skill orchestrator — routes to preview. Non-destructive "what will this skill do?" before you run it.
7
8
  cluster: skill
8
9
  type: orchestrator
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: skills-discover
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: skills
7
8
  sub: discover
8
9
  description: Recommend skills for a role — ranked by four explained classes (most-useful-for-role, related-to-current-task, recently-adopted, popular-in-role). Local-only; every result carries a why.
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: skills
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  description: Skill discovery orchestrator — routes to discover. Local, explained skill recommendations over the catalog + role shortlists + optional local analytics.
7
8
  cluster: skills
8
9
  type: orchestrator
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: sync-agent-settings
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  skills: [sync-agent-settings]
7
8
  description: Sync `.agent-settings.yml` against the current template + profile — adds new sections/keys, preserves user values, shows a diff before writing
8
9
  suggestion:
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: sync-gitignore-fix
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: sync-gitignore
7
8
  sub: fix
8
9
  skills: [sync-gitignore]
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: sync-gitignore
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: sync-gitignore
7
8
  skills: [sync-gitignore]
8
9
  description: Sync the `event4u/agent-config` block in the consumer project's .gitignore — adds missing entries, preserves user-added lines, shows a diff before writing
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: tests-create
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: tests
7
8
  sub: create
8
9
  skills: [pest-testing, quality-tools]
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: tests-execute
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: tests
7
8
  sub: execute
8
9
  skills: [pest-testing, quality-tools]
@@ -4,6 +4,7 @@ name: tests
4
4
  disable-model-invocation: true
5
5
  pack: engineering-base
6
6
  tier: 2
7
+ visibility: internal
7
8
  description: Tests orchestrator — routes to create, execute
8
9
  cluster: tests
9
10
  type: orchestrator
@@ -3,6 +3,7 @@ model_tier: high
3
3
  name: threat-model
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  skills: [threat-modeling, authz-review, security-sensitive-stop]
7
8
  description: Run a pre-implementation threat model on a proposed change — enumerates abuse cases, trust boundaries, and authorization gaps before the first line of code is written
8
9
  council_depth: deep
@@ -3,6 +3,7 @@ model_tier: medium
3
3
  name: update-form-request-messages
4
4
  pack: engineering-base
5
5
  tier: 2
6
+ visibility: internal
6
7
  framework: laravel
7
8
  skills: [laravel-validation]
8
9
  description: "Sync the messages() method of a FormRequest class — add missing entries, link them to language keys, and clean up stale ones."
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: upstream-contribute
4
4
  pack: meta
5
5
  tier: 2
6
+ visibility: internal
6
7
  skills: [upstream-contribute, skill-writing, learning-to-rule-or-skill]
7
8
  description: Contribute a learning, skill, rule, or fix from a consumer project back to the shared agent-config package
8
9
  suggestion:
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video-from-script
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  sub: from-script
8
9
  description: Drive a script end-to-end through the AI video pipeline — scenes → blueprint → image → operator pick → motion → video → stitch. Preview default; --mode commit spends behind the cost gate.
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video-from-song
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  sub: from-song
8
9
  description: Music-video from a song + reference images — accept or derive a timed scene script, optional character-lock, render, stitch, mux song as master track. Preview default; --mode commit gates the spend.
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video-scene
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  sub: scene
8
9
  description: Render a single scene from a one-line idea — scene-expander → blueprint → image → operator pick → motion → video. Preview mode default (no spend); --mode commit renders live behind the cost gate.
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video-stitch
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  sub: stitch
8
9
  description: Re-stitch existing clips in `<project>/scenes/*/` after operator edits — no re-render. ffmpeg concat driven by manifest.json.
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video-storyboard
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  sub: storyboard
8
9
  description: Image-only storyboard — script → scenes → blueprint → image render → contact-sheet PNG via ffmpeg montage. No video calls.
@@ -3,6 +3,7 @@ model_tier: inherit
3
3
  name: video
4
4
  pack: ai-video
5
5
  tier: 2
6
+ visibility: internal
6
7
  cluster: video
7
8
  description: Video-creation orchestrator — Hollywood-level AI video pipeline. Routes to from-script, from-song, scene, storyboard, stitch.
8
9
  type: orchestrator
@@ -6,6 +6,7 @@ intent: "Pick up the next sensible task and execute it autonomously"
6
6
  routes_to: [refine-prompt, command-routing]
7
7
  replaces: []
8
8
  tier: 0
9
+ visibility: visible
9
10
  skills: [refine-prompt, command-routing]
10
11
  description: Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, confidence-band gated, no auto-git.
11
12
  suggestion:
@@ -105,7 +105,7 @@ Commands organized by workflow:
105
105
  | **Modules** | `module-create`, `module-explore` |
106
106
  | **Roadmaps** | `roadmap:create`, `roadmap:process-step`, `roadmap:process-phase`, `roadmap:process-full` |
107
107
  | **Quality** | `quality-fix`, `review-changes`, `prepare-for-review`, `update-form-request-messages`, `fix-seeder` |
108
- | **CI/PR** | `fix-ci`, `create-pr`, `create-pr-description`, `fix-pr-comments`, `fix-pr-bot-comments`, `fix-pr-developer-comments` |
108
+ | **CI/PR** | `fix-ci`, `create-pr`, `create-pr-description`, `fix-pr-comments` |
109
109
  | **Testing** | `tests-create`, `tests-execute` |
110
110
  | **E2E** | `e2e-plan`, `e2e-heal` |
111
111
  | **Agents** | `agents-prepare`, `agents-audit`, `agents-cleanup`, `copilot-agents-optimize`, `agent-handoff`, `agent-status`, `optimize-agents`, `optimize-augmentignore`, `optimize-skills`, `optimize-rtk-filters` |
@@ -25,7 +25,7 @@ Make descriptions "pushy" — explicit about when to fire:
25
25
  adjectives, drop the second example phrasing, or collapse a list — do
26
26
  **not** drop the trigger vocabulary or the `even if ...` tail.
27
27
 
28
- Source: [`skills/skill-creator` in `anthropics/skills`](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md).
28
+ Source: [`skills/skill-creator` in `an external reference`](https://github.com/an external reference/blob/main/skills/skill-creator/SKILL.md).
29
29
 
30
30
  **Litmus test:** Read the description cold, without the skill's body. If you
31
31
  cannot name at least two phrasings a user would realistically type that should
@@ -4,7 +4,7 @@ Lookup table for the `slash-command-routing-policy` rule. Lists the
4
4
  locked clusters and their sub-commands so the rule itself can stay at
5
5
  its current LOC while still reflecting the full surface. Source of
6
6
  truth for the cluster names is
7
- [`docs/contracts/command-clusters.md`](../../../../../docs/contracts/command-clusters.md);
7
+ [`docs/contracts/command-clusters.md`](../../../../../../docs/contracts/command-clusters.md);
8
8
  this file mirrors that contract for runtime lookup. Linter:
9
9
  `scripts/check_cluster_patterns.py` (verifies dispatcher shape).
10
10
 
@@ -12,7 +12,7 @@ this file mirrors that contract for runtime lookup. Linter:
12
12
 
13
13
  | Cluster | Phase | Sub-commands | Replaces |
14
14
  |---|:-:|---|-------------------------------------------------------------------------------------------------------------------------------------------------|
15
- | `/fix` | 1 | `ci` · `pr-comments` · `pr-bot-comments` · `pr-developer-comments` · `portability` · `refs` · `seeder` | `/fix-ci` · `/fix-pr-comments` · `/fix-pr-bot-comments` · `/fix-pr-developer-comments` · `/fix-portability` · `/fix-references` · `/fix-seeder` |
15
+ | `/fix` | 1 | `ci` · `pr-comments` · `portability` · `refs` · `seeder` | `/fix-ci` · `/fix-pr-comments` · `/fix-portability` · `/fix-references` · `/fix-seeder` |
16
16
  | `/optimize` | 1 | `agents` · `augmentignore` · `rtk` · `skills` | `/optimize-agents` · `/optimize-augmentignore` · `/optimize-rtk-filters` · `/optimize-skills` |
17
17
  | `/feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` | `/feature-explore` · `/feature-plan` · `/feature-refactor` · `/feature-roadmap` |
18
18
  | `/chat-history` | 2 | `show` | `/chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only` |
@@ -42,12 +42,12 @@ behavior. Cannot → read more.
42
42
 
43
43
  ## Consult memory before editing
44
44
 
45
- Prior decisions and invariants live in the memory layer. Via
46
- [`memory-access`](../../../../../docs/guidelines/agent-infra/memory-access.md),
47
- call `retrieve(types=["architecture-decisions", "domain-invariants"], keys=<touched paths>, limit=3)`.
48
- A matching `architecture-decision` explains *why* the current shape
49
- exists; a matching `domain-invariant` is a hard constraint. Cite the
50
- `id` if a match influences the plan.
45
+ Invariants live in the memory layer; architectural rationale lives in ADRs.
46
+ Via [`memory-access`](../../../../../docs/guidelines/agent-infra/memory-access.md),
47
+ call `retrieve(types=["domain-invariants"], keys=<touched paths>, limit=3)` —
48
+ a matching `domain-invariant` is a hard constraint. For *why* the current
49
+ shape exists, check the ADR index `docs/decisions/INDEX.md`. Cite the `id` /
50
+ ADR number if a match influences the plan.
51
51
 
52
52
  ## Verify with real tools
53
53
 
@@ -38,10 +38,10 @@ covers). Default: leave AGENTS.md thin and put detail under `agents/`.
38
38
  ```markdown
39
39
  ## Development Setup
40
40
 
41
- ​```bash
41
+ ```bash
42
42
  {{dev_start_command}} # make start / docker compose up / npm run dev / php artisan serve
43
43
  {{dev_test_command}} # make test / docker compose exec app bash / npm test / php artisan test
44
- ​```
44
+ ```
45
45
 
46
46
  ### Environment files
47
47
 
@@ -0,0 +1,75 @@
1
+ # RDP Gate — Table-Free Cost Gate
2
+
3
+ Shared mechanic for the **Reasoning Discipline Protocol**. Loaded by the RDP
4
+ artifacts (the `notes-first-reasoning` rule, the `reasoning-orchestrator` skill,
5
+ and the Phase-5 extensions of `think-before-action` / `improve-before-implement` /
6
+ `adversarial-review` / `subagent-orchestration` / `autonomous-execution`) when
7
+ deciding **whether to engage the discipline at all**. Design rationale +
8
+ sourcing: `docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md`
9
+ and roadmap decisions L1/L10/L17.
10
+
11
+ ## The one rule
12
+
13
+ ```
14
+ RDP NEVER ENGAGES BY DEFAULT ON EVERY TURN.
15
+ IT ENGAGES ONLY WHERE IT PAYS — DECIDED BY TABLE-FREE SIGNALS.
16
+ NO RUNTIME MODEL -> BAND TABLE EXISTS (ADR-035).
17
+ ```
18
+
19
+ `model_tier` (ADR-035, `lite|medium|high`) is the **skill's** needed model band,
20
+ **not** the host's reasoning strength. RDP must never reuse it for gating, never
21
+ maintain a model list, and never ship heavy/light content variants (two variants
22
+ *are* a hidden band table).
23
+
24
+ ## Three signals (all table-free)
25
+
26
+ 1. **User settings** — read the `reasoning:` block in `.agent-settings.yml`:
27
+ - `enabled: false` → the whole layer is inert. Stop here.
28
+ - per-component switch off (e.g. `components.verifier_default: false`) → that
29
+ component never fires.
30
+ - `auto_gate: false` → skip signal 3 (self-assessment); gate on signal 2 only.
31
+ 2. **Task signal** (knowable per turn, no model lookup):
32
+ - **Skip** RDP when the task is trivial / short / fully-specified (rename,
33
+ typo, format, one-line edit, list files, bump a version).
34
+ - **Engage** when the task is complex / ambiguous / multi-component /
35
+ long-horizon / stateful / irreversible.
36
+ 3. **Host reasoning strength** (agent self-assessment — introspection, no
37
+ maintained list; same pattern as `provider-lifecycle-discipline` and
38
+ `media-governance-routing`):
39
+ - A **strong-reasoning** host applies the discipline **lightly / as a
40
+ suggestion** (it self-coordinates; heavy scaffolding wastes tokens and can
41
+ degrade it — see the dossier's `reasoning_extraction` + over-prescription
42
+ evidence).
43
+ - A **standard** host applies it **fully**.
44
+
45
+ ## One constraint-light scaffold + expand on request (L1)
46
+
47
+ Every RDP artifact ships **one** constraint-light version. There is no heavy
48
+ variant. A standard host that needs more **asks for it at turn time** ("give me
49
+ the explicit alternative-enumeration" / "spell out the file-size bounds") rather
50
+ than selecting a pre-written heavy file. This keeps the surface DRY, table-free,
51
+ and vendor-neutral.
52
+
53
+ ## Verifier has its own gate (L12)
54
+
55
+ The fresh-context verifier subagent is the most expensive primitive (a full extra
56
+ inference pass). On top of the three signals above it fires **only** when the task
57
+ shows **≥ 2 of**: branching/conditional logic · ≥ 3 explicit must/must-not
58
+ constraints · stateful operations · irreversibility flag — **and** the estimated
59
+ work is **≥ ~1k tokens**. Token length alone is never the trigger.
60
+
61
+ ## What this gate does NOT touch
62
+
63
+ - **No frontmatter field.** The gate is read at runtime; RDP artifacts need no
64
+ new schema key, so there is **no projection/condensation change** and nothing
65
+ new compiles into `dist/router.json`.
66
+ - **No kernel change.** RDP artifacts are tier-2 (router-loaded on match); the
67
+ always-on kernel stays the same size.
68
+ - **No model list.** If a new model ships tomorrow, nothing here goes stale.
69
+
70
+ ## How an RDP artifact cites this
71
+
72
+ Open with a one-line gate check, e.g.: *"Engage per `contexts/execution/rdp-gate.md`
73
+ (settings + task-signal + host self-assessment); skip on trivial tasks and apply
74
+ lightly on a strong-reasoning host."* Then the artifact's own body assumes it has
75
+ already been cleared to engage.
@@ -59,4 +59,5 @@ The commands read `.agent-settings.yml` fresh on each run.
59
59
 
60
60
  - [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md) — the skill
61
61
  - [`model-recommendations`](model-recommendations.md) — tier definitions
62
+ - `guideline:agent-infra/model-recommendation` § Orchestrator → subagent model routing — per-subtask model right-sizing (downgrade easy work, keep strong model for hard)
62
63
  - [`/do-and-judge`](../commands/do-and-judge.md), [`/do-in-steps`](../commands/do-in-steps.md), [`/judge`](../commands/judge.md) — commands that read these keys
@@ -90,6 +90,6 @@ straw man.
90
90
  ---
91
91
 
92
92
  *This persona is consumed by the AI Council advisor system
93
- (replace-mode). When activated via `agents/settings/.ai-council.yml`'s
93
+ (replace-mode). When activated via `~/.event4u/agent-config/settings/.ai-council.yml`'s
94
94
  `advisors:` block, the entire file body below the frontmatter becomes
95
95
  the system prompt for the targeted member.*
@@ -94,6 +94,6 @@ can start on.
94
94
  ---
95
95
 
96
96
  *This persona is consumed by the AI Council advisor system
97
- (replace-mode). When activated via `agents/settings/.ai-council.yml`'s
97
+ (replace-mode). When activated via `~/.event4u/agent-config/settings/.ai-council.yml`'s
98
98
  `advisors:` block, the entire file body below the frontmatter becomes
99
99
  the system prompt for the targeted member.*
@@ -93,6 +93,6 @@ the proposal as written can survive its own success.
93
93
  ---
94
94
 
95
95
  *This persona is consumed by the AI Council advisor system
96
- (replace-mode). When activated via `agents/settings/.ai-council.yml`'s
96
+ (replace-mode). When activated via `~/.event4u/agent-config/settings/.ai-council.yml`'s
97
97
  `advisors:` block, the entire file body below the frontmatter becomes
98
98
  the system prompt for the targeted member.*
@@ -93,6 +93,6 @@ inherit an accidental complexity from convention.
93
93
  ---
94
94
 
95
95
  *This persona is consumed by the AI Council advisor system
96
- (replace-mode). When activated via `agents/settings/.ai-council.yml`'s
96
+ (replace-mode). When activated via `~/.event4u/agent-config/settings/.ai-council.yml`'s
97
97
  `advisors:` block, the entire file body below the frontmatter becomes
98
98
  the system prompt for the targeted member.*
@@ -97,6 +97,6 @@ synthesis stage can use to see the proposal from outside.
97
97
  ---
98
98
 
99
99
  *This persona is consumed by the AI Council advisor system
100
- (replace-mode). When activated via `agents/settings/.ai-council.yml`'s
100
+ (replace-mode). When activated via `~/.event4u/agent-config/settings/.ai-council.yml`'s
101
101
  `advisors:` block, the entire file body below the frontmatter becomes
102
102
  the system prompt for the targeted member.*
@@ -90,6 +90,18 @@ Crossing the 20-entry threshold counts as the 3rd validation-target failure for
90
90
 
91
91
  When validating a single target, run the **specific** check, not a meta-task that fans out to dozens of sub-tasks. Use the failing tool's direct entry point (the specific script invocation, the specific runner target, the single-test filter for the project's test runner) rather than the full CI meta-pipeline. Full-pipeline runs are appropriate at phase boundaries, not as a per-iteration probe.
92
92
 
93
+ Concrete tool mapping — verify with the narrowest tool that proves the target green: a single `curl` / Playwright spec / browser run for HTTP behavior, the project's test runner with a `--filter` for one test, a debugger / `xdebug` step-through for one frame. Never substitute a meta-pipeline for a tool that pinpoints the failure.
94
+
95
+ ## Adaptive effort & stop (RDP)
96
+
97
+ Scale effort to task difficulty, and stop when marginal evidence drops — coupled
98
+ to the N=3 budget above, never replacing it. On a host with a native effort knob
99
+ (e.g. an `effort` parameter), the right move is to **set it high** for hard tasks
100
+ rather than scaffold; the scaffold here is for a standard host **without** such a
101
+ knob. The per-dimension uncertainty score (see
102
+ [`notes-first-reasoning`](notes-first-reasoning.md)) feeds this decision. Engage
103
+ per [`rdp-gate`](../contexts/execution/rdp-gate.md).
104
+
93
105
  ## See also
94
106
 
95
107
  - [`user-interrupt-priority`](user-interrupt-priority.md) — STOP-ASK-RESUME on new tasks; overrides autonomy
@@ -58,7 +58,7 @@ Triggered when the user points to an external artifact (repo URL, `owner/repo`,
58
58
  | **Repeat-the-guess after pushback** | User says "really look" → agent re-paraphrases the same surface read. Burns trust. | On any pushback that names the source again, restart from a tree listing, not from prior notes. |
59
59
  | **Cross-tool path inference from a single example** | One config file ≠ a convention. | Inspect ≥2 unrelated tool integrations before claiming a pattern is the project's universal anchor strategy. |
60
60
 
61
- **Case-zero anchor.** May 2026 — `nextlevelbuilder/ui-ux-pro-max-skill` was named as the source of truth for 23 AI-tool anchors. Three rounds of "we have no content for these tools" were reported from README inference. The actual `tool-configs/*.json` files in the reference repo gave the exact directory layout per tool in one fetch. Cost: ~2 hours of user frustration. Lesson: when an external source is named, the first action is `GET /repos/{o}/{r}/contents/{interesting-subtree}` — not paraphrase.
61
+ **Case-zero anchor.** May 2026 — an external reference suite was named as the source of truth for 23 AI-tool anchors. Three rounds of "we have no content for these tools" were reported from README inference. The actual `tool-configs/*.json` files in the reference repo gave the exact directory layout per tool in one fetch. Cost: ~2 hours of user frustration. Lesson: when an external source is named, the first action is `GET /repos/{o}/{r}/contents/{interesting-subtree}` — not paraphrase.
62
62
 
63
63
  ## Escape hatch
64
64