@event4u/agent-config 9.8.0 → 9.9.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 (817) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +278 -298
  3. package/CONTRIBUTING.md +23 -7
  4. package/MIGRATION.md +20 -0
  5. package/README.md +55 -9
  6. package/dist/agent-src/commands/agents/audit.md +1 -1
  7. package/dist/agent-src/commands/agents/optimize.md +2 -2
  8. package/dist/agent-src/commands/agents/user.md +1 -1
  9. package/dist/agent-src/commands/agents.md +1 -1
  10. package/dist/agent-src/commands/check-current-md.md +3 -3
  11. package/dist/agent-src/commands/fix/portability.md +2 -2
  12. package/dist/agent-src/commands/fix/pr-comments-loop.md +136 -0
  13. package/dist/agent-src/commands/fix/refs.md +2 -2
  14. package/dist/agent-src/commands/fix/route.md +4 -3
  15. package/dist/agent-src/commands/fix.md +9 -6
  16. package/dist/agent-src/commands/ghostwriter.md +1 -1
  17. package/dist/agent-src/commands/image.md +1 -1
  18. package/dist/agent-src/commands/optimize/augmentignore.md +1 -1
  19. package/dist/agent-src/commands/optimize/skills.md +2 -2
  20. package/dist/agent-src/commands/post-as.md +1 -1
  21. package/dist/agent-src/commands/research.md +1 -1
  22. package/dist/agent-src/commands/roadmap/ai-council.md +1 -1
  23. package/dist/agent-src/commands/security-audit-config.md +1 -1
  24. package/dist/agent-src/commands/team/delegate.md +4 -0
  25. package/dist/agent-src/commands/video.md +1 -1
  26. package/dist/agent-src/contexts/authority/kernel-rule-edits.md +1 -1
  27. package/dist/agent-src/contexts/contracts/emergency-triage-block.md +2 -2
  28. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +48 -2
  29. package/dist/agent-src/contexts/execution/orchestration-telemetry.md +10 -0
  30. package/dist/agent-src/contexts/execution/subagent-modes-detail.md +109 -8
  31. package/dist/agent-src/contexts/execution/subagent-response-contract.md +20 -0
  32. package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +53 -3
  33. package/dist/agent-src/rules/code-provenance.md +112 -0
  34. package/dist/agent-src/rules/external-code-graph-interop.md +4 -4
  35. package/dist/agent-src/rules/history-discipline.md +80 -0
  36. package/dist/agent-src/rules/no-roadmap-references.md +1 -1
  37. package/dist/agent-src/rules/php-coding.md +1 -0
  38. package/dist/agent-src/rules/reviewer-awareness.md +1 -0
  39. package/dist/agent-src/rules/roadmap-ci-steps-policy.md +1 -0
  40. package/dist/agent-src/rules/roadmap-progress-sync.md +7 -0
  41. package/dist/agent-src/rules/scale-discipline.md +92 -0
  42. package/dist/agent-src/rules/security-sensitive-stop.md +10 -0
  43. package/dist/agent-src/rules/session-canary.md +77 -0
  44. package/dist/agent-src/rules/token-optimizer-maintenance.md +1 -1
  45. package/dist/agent-src/rules/tool-safety.md +3 -1
  46. package/dist/agent-src/rules/untrusted-input-defense.md +10 -0
  47. package/dist/agent-src/skills/agent-security-review/SKILL.md +1 -1
  48. package/dist/agent-src/skills/code-intelligence/SKILL.md +17 -14
  49. package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
  50. package/dist/agent-src/skills/corpus-grounding/SKILL.md +0 -3
  51. package/dist/agent-src/skills/description-assist/SKILL.md +1 -1
  52. package/dist/agent-src/skills/design-review/SKILL.md +5 -6
  53. package/dist/agent-src/skills/design-tokens/SKILL.md +0 -1
  54. package/dist/agent-src/skills/history-design/SKILL.md +101 -0
  55. package/dist/agent-src/skills/history-design/evals/triggers.json +17 -0
  56. package/dist/agent-src/skills/humanizer/SKILL.md +3 -3
  57. package/dist/agent-src/skills/image-editing/SKILL.md +1 -1
  58. package/dist/agent-src/skills/image-generation/SKILL.md +2 -1
  59. package/dist/agent-src/skills/image-provider-routing/SKILL.md +2 -2
  60. package/dist/agent-src/skills/launch-readiness/SKILL.md +1 -1
  61. package/dist/agent-src/skills/license-compliance-audit/SKILL.md +161 -0
  62. package/dist/agent-src/skills/license-compliance-audit/evals/triggers.json +52 -0
  63. package/dist/agent-src/skills/license-compliance-borrow-check/SKILL.md +145 -0
  64. package/dist/agent-src/skills/license-compliance-borrow-check/evals/triggers.json +52 -0
  65. package/dist/agent-src/skills/license-compliance-credits/SKILL.md +97 -0
  66. package/dist/agent-src/skills/license-compliance-credits/evals/triggers.json +52 -0
  67. package/dist/agent-src/skills/md-language-check/SKILL.md +1 -1
  68. package/dist/agent-src/skills/override-management/SKILL.md +1 -1
  69. package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +7 -7
  70. package/dist/agent-src/skills/project-analysis-core/SKILL.md +1 -1
  71. package/dist/agent-src/skills/prompt-engineering-image/SKILL.md +3 -2
  72. package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +2 -2
  73. package/dist/agent-src/skills/recursive-verification/SKILL.md +6 -0
  74. package/dist/agent-src/skills/refine-ticket/SKILL.md +3 -3
  75. package/dist/agent-src/skills/roadmap-writing/SKILL.md +4 -0
  76. package/dist/agent-src/skills/rtk-output-filtering/SKILL.md +31 -12
  77. package/dist/agent-src/skills/rule-refactor/SKILL.md +3 -3
  78. package/dist/agent-src/skills/schema-review/SKILL.md +92 -0
  79. package/dist/agent-src/skills/schema-review/evals/triggers.json +17 -0
  80. package/dist/agent-src/skills/secrets-management/SKILL.md +3 -4
  81. package/dist/agent-src/skills/security-audit/SKILL.md +1 -1
  82. package/dist/agent-src/skills/security-maturity-assessment/SKILL.md +1 -1
  83. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +3 -3
  84. package/dist/agent-src/skills/skill-writing/SKILL.md +2 -2
  85. package/dist/agent-src/skills/source-discovery/SKILL.md +5 -5
  86. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +45 -85
  87. package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +5 -4
  88. package/dist/agent-src/skills/systematic-debugging/SKILL.md +2 -2
  89. package/dist/agent-src/skills/tailwind-engineer/SKILL.md +2 -3
  90. package/dist/agent-src/skills/token-optimizer/SKILL.md +4 -4
  91. package/dist/agent-src/skills/verify-repair-loop/SKILL.md +1 -1
  92. package/dist/agent-src/skills/worktree-lifecycle/SKILL.md +2 -3
  93. package/dist/agent-src/templates/AGENTS.md +1 -1
  94. package/dist/agent-src/templates/agents/.gitattributes.fragment +25 -6
  95. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  96. package/dist/agent-src/templates/command.md +3 -3
  97. package/dist/agent-src/templates/persona.md +2 -2
  98. package/dist/agent-src/templates/rule.md +2 -2
  99. package/dist/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
  100. package/dist/agent-src/templates/scripts/telemetry_record.ts +33 -1
  101. package/dist/cli/commands/doctorShell.js +20 -0
  102. package/dist/cli/commands/doctorShell.js.map +1 -1
  103. package/dist/cli/commands/rtkDetect.js +58 -0
  104. package/dist/cli/commands/rtkDetect.js.map +1 -0
  105. package/dist/cli/firstRunNotice.js +70 -0
  106. package/dist/cli/firstRunNotice.js.map +1 -0
  107. package/dist/cli/main.js +35 -3
  108. package/dist/cli/main.js.map +1 -1
  109. package/dist/cli/registry.js +7 -1
  110. package/dist/cli/registry.js.map +1 -1
  111. package/dist/discovery/deprecation-report.md +1 -1
  112. package/dist/discovery/discovery-manifest.json +362 -78
  113. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  114. package/dist/discovery/discovery-manifest.summary.md +6 -4
  115. package/dist/discovery/orphan-report.md +1 -1
  116. package/dist/discovery/packs.json +90 -8
  117. package/dist/discovery/trust-report.md +11 -11
  118. package/dist/discovery/workspaces.json +31 -7
  119. package/dist/hooks/dispatch.js +19475 -0
  120. package/dist/install/agentSwitchDetection.js +75 -0
  121. package/dist/install/agentSwitchDetection.js.map +1 -0
  122. package/dist/install/agentSwitchProfile.js +117 -0
  123. package/dist/install/agentSwitchProfile.js.map +1 -0
  124. package/dist/install/atomic.js +1 -1
  125. package/dist/install/detect.js +1 -1
  126. package/dist/install/install.mjs +775 -486
  127. package/dist/install/rtkDetection.js +213 -0
  128. package/dist/install/rtkDetection.js.map +1 -0
  129. package/dist/install/rule_scope.js +2 -1
  130. package/dist/install/rule_scope.js.map +1 -1
  131. package/dist/install/types.js +2 -2
  132. package/dist/install/wizard-plan.js +1 -1
  133. package/dist/install/wizardDismissals.js +58 -0
  134. package/dist/install/wizardDismissals.js.map +1 -0
  135. package/dist/mcp/awesome-mcp-servers.row.md +1 -1
  136. package/dist/mcp/mcp-cloudflare-catalogue.json +1 -1
  137. package/dist/mcp/registry-manifest.json +15 -4
  138. package/dist/mcp/server.json +20 -0
  139. package/dist/mcp/server.mjs +44292 -0
  140. package/dist/router.json +1 -1
  141. package/dist/scripts/condense.js +14 -7
  142. package/dist/scripts/condense.js.map +1 -1
  143. package/dist/server/app.js +4 -2
  144. package/dist/server/app.js.map +1 -1
  145. package/dist/server/io/sharedWriteCheck.js +101 -0
  146. package/dist/server/io/sharedWriteCheck.js.map +1 -0
  147. package/dist/server/routes/ping.js +14 -0
  148. package/dist/server/routes/ping.js.map +1 -1
  149. package/dist/server/routes/settings.js +21 -4
  150. package/dist/server/routes/settings.js.map +1 -1
  151. package/dist/server/routes/userMd.js +21 -4
  152. package/dist/server/routes/userMd.js.map +1 -1
  153. package/dist/server/routes/wizard.js +68 -25
  154. package/dist/server/routes/wizard.js.map +1 -1
  155. package/dist/server/schemas/settings.js +4 -2
  156. package/dist/server/schemas/settings.js.map +1 -1
  157. package/dist/ui/assets/index-BpSQt5vm.js +40 -0
  158. package/dist/ui/assets/index-BpSQt5vm.js.map +1 -0
  159. package/dist/ui/assets/index-jSfMW8_t.css +1 -0
  160. package/dist/ui/index.html +2 -2
  161. package/docs/MIGRATION.md +16 -0
  162. package/docs/guidelines/component-oriented-and-oop-development.md +4 -2
  163. package/package.json +21 -11
  164. package/src/agent-src/templates/AGENTS.md +1 -1
  165. package/src/agent-src/templates/scripts/telemetry/engagement.ts +77 -0
  166. package/src/agent-src/templates/scripts/telemetry_record.ts +33 -1
  167. package/src/config/agent-settings.template.yml +52 -14
  168. package/src/config/discovery/packs.yml +22 -0
  169. package/src/config/discovery/workspaces.yml +1 -1
  170. package/src/config/evaluator-budgets.json +47 -0
  171. package/src/config/hook-latency-budget.json +20 -0
  172. package/src/install/agentSwitchDetection.ts +90 -0
  173. package/src/install/agentSwitchProfile.ts +131 -0
  174. package/src/install/atomic.ts +1 -1
  175. package/src/install/detect.ts +1 -1
  176. package/src/install/rtkDetection.ts +274 -0
  177. package/src/install/rule_scope.ts +9 -2
  178. package/src/install/types.ts +2 -2
  179. package/src/install/wizard-plan.ts +1 -1
  180. package/src/install/wizardDismissals.ts +60 -0
  181. package/src/scripts/_cli/cmd_doctor.ts +62 -1
  182. package/src/scripts/_cli/cmd_memory_get.ts +197 -0
  183. package/src/scripts/_cli/cmd_refresh.ts +30 -0
  184. package/src/scripts/_dispatch.bash +81 -0
  185. package/src/scripts/_lib/auto_dispatch.corpus.test.ts +64 -1
  186. package/src/scripts/_lib/auto_dispatch.ts +76 -0
  187. package/src/scripts/_lib/detect_target_license.ts +714 -0
  188. package/src/scripts/_lib/fixtures/secret-detector/negatives.txt +5 -0
  189. package/src/scripts/_lib/fixtures/secret-detector/positives.txt +4 -0
  190. package/src/scripts/_lib/install_drift.ts +194 -0
  191. package/src/scripts/_lib/memory_fts_index.ts +390 -0
  192. package/src/scripts/_lib/orchestration_record.ts +91 -2
  193. package/src/scripts/_lib/persistence/adapter_raw_sql.ts +443 -0
  194. package/src/scripts/_lib/persistence/detect_audit_coverage.ts +423 -0
  195. package/src/scripts/_lib/persistence/detect_bounded_reads.ts +154 -0
  196. package/src/scripts/_lib/persistence/detect_index_parity.ts +576 -0
  197. package/src/scripts/_lib/persistence/detect_n1_eloquent.ts +226 -0
  198. package/src/scripts/_lib/persistence/detect_offload.ts +441 -0
  199. package/src/scripts/_lib/persistence/detect_prisma_growth.ts +74 -0
  200. package/src/scripts/_lib/persistence/offload_catalog.ts +73 -0
  201. package/src/scripts/_lib/persistence/types.ts +109 -0
  202. package/src/scripts/_lib/rtk_allowlist.ts +44 -0
  203. package/src/scripts/_lib/secret_detector.test.ts +5 -0
  204. package/src/scripts/_lib/secret_detector.ts +9 -0
  205. package/src/scripts/_lib/secret_detector_adversarial.test.ts +116 -0
  206. package/src/scripts/_lib/spawn_env.ts +7 -0
  207. package/src/scripts/_lib/sqlite_guard.ts +191 -0
  208. package/src/scripts/_lib/subagent_spawn.ts +53 -0
  209. package/src/scripts/_lib/worker_budget.ts +107 -0
  210. package/src/scripts/ai_council/blind_review.ts +0 -0
  211. package/src/scripts/ai_council/config.ts +12 -6
  212. package/src/scripts/ai_council/orchestrator.ts +73 -3
  213. package/src/scripts/ai_team/review_gate.ts +8 -10
  214. package/src/scripts/ai_team/team_dispatch.ts +48 -0
  215. package/src/scripts/audit_initial_context.ts +1 -1
  216. package/src/scripts/bench_cross_source_eval.ts +400 -0
  217. package/src/scripts/bench_honesty_score.ts +1093 -0
  218. package/src/scripts/bench_hook_latency.ts +218 -0
  219. package/src/scripts/build_mcp_catalog.ts +275 -0
  220. package/src/scripts/build_mcp_registry_manifest.ts +46 -0
  221. package/src/scripts/build_proof.ts +45 -0
  222. package/src/scripts/chat_history.ts +8 -5
  223. package/src/scripts/check_backstop_debt.ts +23 -13
  224. package/src/scripts/check_bundle_path_leakage.ts +343 -0
  225. package/src/scripts/check_evaluator_budgets.ts +99 -0
  226. package/src/scripts/check_knowledge_sharing.ts +12 -1
  227. package/src/scripts/check_no_external_sources.ts +2 -2
  228. package/src/scripts/check_source_pointer_freshness.ts +28 -3
  229. package/src/scripts/code_graph/build.ts +0 -0
  230. package/src/scripts/code_graph/cli.ts +181 -9
  231. package/src/scripts/code_graph/detect.ts +52 -0
  232. package/src/scripts/code_graph/intent.ts +45 -0
  233. package/src/scripts/code_graph/query.ts +143 -29
  234. package/src/scripts/code_graph/sqlite_store.ts +174 -0
  235. package/src/scripts/condense.ts +14 -6
  236. package/src/scripts/context_hygiene_hook.ts +8 -5
  237. package/src/scripts/council_cli.ts +126 -12
  238. package/src/scripts/detect_target_license.ts +203 -0
  239. package/src/scripts/evaluator_umbrella.sh +145 -0
  240. package/src/scripts/external_sources_denylist.json +5 -3
  241. package/src/scripts/first_run_gate_hook.ts +9 -5
  242. package/src/scripts/hermetic-install.sh +3 -3
  243. package/src/scripts/hook_manifest.yaml +55 -16
  244. package/src/scripts/hooks/block_kernel_rule_writes.ts +212 -0
  245. package/src/scripts/hooks/block_no_verify.ts +9 -9
  246. package/src/scripts/hooks/code_graph_nudge_hook.ts +11 -4
  247. package/src/scripts/hooks/concern_registry.ts +75 -0
  248. package/src/scripts/hooks/design_slop_hook.ts +8 -5
  249. package/src/scripts/hooks/dispatch_entry.ts +37 -0
  250. package/src/scripts/hooks/dispatch_hook.ts +176 -3
  251. package/src/scripts/hooks/hook_stdin.ts +42 -0
  252. package/src/scripts/hooks/rtk_wrap_hook.ts +26 -12
  253. package/src/scripts/hot_context_hook.ts +7 -6
  254. package/src/scripts/injection_scan_hook.ts +9 -1
  255. package/src/scripts/install +6 -6
  256. package/src/scripts/install-hooks.sh +4 -4
  257. package/src/scripts/install.sh +5 -4
  258. package/src/scripts/install.ts +264 -23
  259. package/src/scripts/learning_sidecar.ts +0 -0
  260. package/src/scripts/lint_budget_ownership.ts +89 -0
  261. package/src/scripts/lint_command_routing.ts +35 -5
  262. package/src/scripts/lint_command_verbs.ts +42 -9
  263. package/src/scripts/lint_consumer_internal_refs.ts +211 -0
  264. package/src/scripts/lint_discovery_vocabulary.ts +2 -0
  265. package/src/scripts/lint_documented_commands.ts +670 -0
  266. package/src/scripts/lint_framework_leakage.ts +17 -3
  267. package/src/scripts/lint_framework_leakage_allowlist.json +32 -0
  268. package/src/scripts/lint_governed_writes.ts +335 -0
  269. package/src/scripts/lint_hidden_unicode.ts +6 -0
  270. package/src/scripts/lint_mcp_registry_manifest.ts +26 -1
  271. package/src/scripts/lint_memory_tripwire.ts +186 -0
  272. package/src/scripts/lint_override_kernel_guard.ts +74 -26
  273. package/src/scripts/lint_persistence.ts +171 -0
  274. package/src/scripts/lint_pre_migration_refs.ts +106 -0
  275. package/src/scripts/lint_provenance.ts +547 -0
  276. package/src/scripts/lint_provenance_vocabulary.ts +437 -0
  277. package/src/scripts/lint_spawn_payload.ts +283 -0
  278. package/src/scripts/lint_store_boundary.ts +152 -0
  279. package/src/scripts/lint_versioned_cache.ts +7 -1
  280. package/src/scripts/mcp_server/__main__.ts +7 -2
  281. package/src/scripts/mcp_server/catalog.ts +23 -1
  282. package/src/scripts/mcp_server/consumer_tool_catalog.json +563 -193
  283. package/src/scripts/mcp_server/prompts.ts +6 -0
  284. package/src/scripts/mcp_server/tool_catalog_source.ts +332 -0
  285. package/src/scripts/mcp_server/tools.ts +56 -5
  286. package/src/scripts/mcp_telemetry_query.ts +2 -33
  287. package/src/scripts/mcp_telemetry_store.ts +64 -34
  288. package/src/scripts/memory_learn_hook.ts +126 -0
  289. package/src/scripts/memory_lookup.ts +0 -0
  290. package/src/scripts/memory_replay_24.ts +312 -0
  291. package/src/scripts/memory_report.ts +16 -3
  292. package/src/scripts/memory_signal.ts +48 -0
  293. package/src/scripts/memory_status.ts +6 -0
  294. package/src/scripts/minimal_safe_diff_hook.ts +8 -5
  295. package/src/scripts/onboarding_gate_hook.ts +8 -5
  296. package/src/scripts/orchestration_record.ts +16 -0
  297. package/src/scripts/pr_url_reminder_hook.ts +8 -1
  298. package/src/scripts/prepack-check.mjs +17 -0
  299. package/src/scripts/prepack_lifecycle_check.d.mts +8 -0
  300. package/src/scripts/prepack_lifecycle_check.mjs +82 -0
  301. package/src/scripts/profile_staleness_hook.ts +8 -7
  302. package/src/scripts/report_install_drift.ts +109 -0
  303. package/src/scripts/roadmap_progress_hook.ts +8 -5
  304. package/src/scripts/schemas/license-policy.schema.json +89 -0
  305. package/src/scripts/schemas/provenance-borrow.schema.json +46 -0
  306. package/src/scripts/schemas/rule.schema.json +10 -0
  307. package/src/scripts/self_review_gate.test.ts +173 -1
  308. package/src/scripts/self_review_gate.ts +155 -15
  309. package/src/scripts/session_canary_hook.ts +182 -0
  310. package/src/scripts/smoke_quickstart.ts +2 -2
  311. package/src/scripts/surface_probe_hook.ts +8 -7
  312. package/src/scripts/sync_gitattributes.ts +310 -0
  313. package/src/scripts/team_review_gate_hook.ts +13 -16
  314. package/src/scripts/verify_before_complete_hook.ts +8 -5
  315. package/src/scripts/wrapper_freshness_hook.ts +8 -7
  316. package/src/server/schemas/settings.ts +8 -2
  317. package/dist/ui/assets/index-BPFMZWUs.css +0 -1
  318. package/dist/ui/assets/index-CrmZ34Rg.js +0 -40
  319. package/dist/ui/assets/index-CrmZ34Rg.js.map +0 -1
  320. package/docs/CLAIMS.md +0 -286
  321. package/docs/DISTRIBUTION_CHECKLIST.md +0 -170
  322. package/docs/RELEASE_STORY_TEMPLATE.md +0 -37
  323. package/docs/SKILL_CENSUS.md +0 -352
  324. package/docs/adrs/cost/0001-hard-stop-hook.md +0 -114
  325. package/docs/adrs/cost/README.md +0 -9
  326. package/docs/adrs/memory/0001-consumer-side-snapshot.md +0 -119
  327. package/docs/adrs/memory/README.md +0 -10
  328. package/docs/adrs/router/0001-three-tier-routing.md +0 -119
  329. package/docs/adrs/router/README.md +0 -9
  330. package/docs/adrs/schema/0001-json-schema-frontmatter.md +0 -102
  331. package/docs/adrs/schema/README.md +0 -9
  332. package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +0 -99
  333. package/docs/adrs/smoke/README.md +0 -9
  334. package/docs/adrs/telegraph/0001-default-off-until-bench.md +0 -93
  335. package/docs/adrs/telegraph/README.md +0 -9
  336. package/docs/announcements/2026-05-non-dev-launch.md +0 -79
  337. package/docs/announcements/2026-07-honest-cost-sweep-launch.md +0 -84
  338. package/docs/anti-reskin-gate.md +0 -60
  339. package/docs/architecture/augment-projection.md +0 -70
  340. package/docs/architecture/claude-bundle.md +0 -77
  341. package/docs/architecture/current-onboard-baseline.md +0 -126
  342. package/docs/architecture/current-safety-behavior.md +0 -137
  343. package/docs/architecture/multi-tool-projection.md +0 -125
  344. package/docs/architecture/setup-vs-settings-shared-surface.md +0 -114
  345. package/docs/architecture/source-projection.md +0 -85
  346. package/docs/architecture.md +0 -390
  347. package/docs/archive/CHANGELOG-6.0.0-overview.md +0 -953
  348. package/docs/archive/CHANGELOG-7.0.0.md +0 -419
  349. package/docs/archive/CHANGELOG-pre-2.11.0.md +0 -141
  350. package/docs/archive/CHANGELOG-pre-2.15.0.md +0 -244
  351. package/docs/archive/CHANGELOG-pre-2.16.0.md +0 -48
  352. package/docs/archive/CHANGELOG-pre-2.17.0.md +0 -63
  353. package/docs/archive/CHANGELOG-pre-2.2.0.md +0 -2138
  354. package/docs/archive/CHANGELOG-pre-2.20.0.md +0 -159
  355. package/docs/archive/CHANGELOG-pre-2.25.0.md +0 -191
  356. package/docs/archive/CHANGELOG-pre-2.7.0.md +0 -185
  357. package/docs/archive/CHANGELOG-pre-3.0.0.md +0 -130
  358. package/docs/archive/CHANGELOG-pre-3.1.0.md +0 -167
  359. package/docs/archive/CHANGELOG-pre-3.2.0.md +0 -268
  360. package/docs/archive/CHANGELOG-pre-4.0.0.md +0 -80
  361. package/docs/archive/CHANGELOG-pre-4.5.0.md +0 -289
  362. package/docs/archive/CHANGELOG-pre-5.4.0.md +0 -260
  363. package/docs/archive/CHANGELOG-pre-5.9.0.md +0 -270
  364. package/docs/archive/CHANGELOG-pre-6.0.0.md +0 -473
  365. package/docs/archive/CHANGELOG-pre-7.0.0.md +0 -126
  366. package/docs/archive/CHANGELOG-pre-8.0.0.md +0 -301
  367. package/docs/archive/CHANGELOG-pre-8.1.0.md +0 -316
  368. package/docs/archive/CHANGELOG-pre-8.12.0.md +0 -304
  369. package/docs/archive/CHANGELOG-pre-8.9.0.md +0 -306
  370. package/docs/archive/CHANGELOG-pre-9.2.0.md +0 -276
  371. package/docs/artefact-census.md +0 -71
  372. package/docs/benchmark.md +0 -785
  373. package/docs/benchmark.pinned.yml +0 -31
  374. package/docs/benchmarks.md +0 -85
  375. package/docs/capability-matrix.md +0 -33
  376. package/docs/case-studies/_template.md +0 -60
  377. package/docs/case-studies/frontend-design-positioning.md +0 -86
  378. package/docs/catalog.md +0 -726
  379. package/docs/command-flows.md +0 -272
  380. package/docs/command-naming-audit.md +0 -60
  381. package/docs/comparison.yaml +0 -87
  382. package/docs/contracts/CHANGELOG-conventions.md +0 -149
  383. package/docs/contracts/STABILITY.md +0 -188
  384. package/docs/contracts/adoption-signal-floor.md +0 -127
  385. package/docs/contracts/adr-architectural-consensus-mechanism.md +0 -68
  386. package/docs/contracts/adr-chat-history-split.md +0 -140
  387. package/docs/contracts/adr-command-suggestion.md +0 -144
  388. package/docs/contracts/adr-forecast-construction-shape.md +0 -90
  389. package/docs/contracts/adr-gtm-context-spine.md +0 -116
  390. package/docs/contracts/adr-implement-ticket-runtime.md +0 -121
  391. package/docs/contracts/adr-install-user-type-axis.md +0 -107
  392. package/docs/contracts/adr-layout.md +0 -107
  393. package/docs/contracts/adr-level-6-productization.md +0 -145
  394. package/docs/contracts/adr-mcp-runtime.md +0 -128
  395. package/docs/contracts/adr-product-ui-track.md +0 -381
  396. package/docs/contracts/adr-prompt-driven-execution.md +0 -186
  397. package/docs/contracts/adr-settings-sync-engine.md +0 -128
  398. package/docs/contracts/adr-user-types-axis.md +0 -127
  399. package/docs/contracts/adr-wing4-context-spine.md +0 -126
  400. package/docs/contracts/agent-user-schema.md +0 -170
  401. package/docs/contracts/agents-layout.md +0 -148
  402. package/docs/contracts/agents-md-tech-stack.md +0 -75
  403. package/docs/contracts/ai-council-config.md +0 -829
  404. package/docs/contracts/ai-team-config.md +0 -224
  405. package/docs/contracts/analysis-memory-loop.md +0 -149
  406. package/docs/contracts/at-rest-encryption.md +0 -191
  407. package/docs/contracts/audit-log-v1.md +0 -150
  408. package/docs/contracts/auto-orchestration-v1.md +0 -70
  409. package/docs/contracts/benchmark-ab-contract.md +0 -106
  410. package/docs/contracts/benchmark-corpus-spec.md +0 -125
  411. package/docs/contracts/benchmark-report-schema.md +0 -113
  412. package/docs/contracts/branch-protection-policy.md +0 -139
  413. package/docs/contracts/brand-token-consumption.md +0 -74
  414. package/docs/contracts/capability-boundary.md +0 -69
  415. package/docs/contracts/capability-packs.md +0 -217
  416. package/docs/contracts/ci-cost-budget.md +0 -111
  417. package/docs/contracts/ci-green-floor.md +0 -141
  418. package/docs/contracts/command-category-governance.md +0 -84
  419. package/docs/contracts/command-clusters.md +0 -399
  420. package/docs/contracts/command-surface-tiers.md +0 -176
  421. package/docs/contracts/command-taxonomy.md +0 -137
  422. package/docs/contracts/condensation-default-kill-criterion.md +0 -116
  423. package/docs/contracts/config-presets.md +0 -144
  424. package/docs/contracts/conformance.md +0 -84
  425. package/docs/contracts/consumer-bridge.md +0 -73
  426. package/docs/contracts/context-paths.md +0 -101
  427. package/docs/contracts/context-spine.md +0 -179
  428. package/docs/contracts/cost-dashboard.md +0 -143
  429. package/docs/contracts/cost-enforcement.md +0 -134
  430. package/docs/contracts/cost-profile-defaults.md +0 -110
  431. package/docs/contracts/cost-summary-schema.md +0 -107
  432. package/docs/contracts/creative-pack-boundary.md +0 -63
  433. package/docs/contracts/cross-repo-retrieval.md +0 -64
  434. package/docs/contracts/cross-wing-handoff.md +0 -134
  435. package/docs/contracts/daily-workspace.md +0 -147
  436. package/docs/contracts/decision-engine-gates.md +0 -120
  437. package/docs/contracts/decision-trace-v1.md +0 -177
  438. package/docs/contracts/design-artifact-lifecycle.md +0 -93
  439. package/docs/contracts/design-artifact-verification.md +0 -153
  440. package/docs/contracts/discovery-manifest.md +0 -209
  441. package/docs/contracts/discovery-manifest.schema.json +0 -254
  442. package/docs/contracts/evidence-based-pruning.md +0 -102
  443. package/docs/contracts/explain-modes.md +0 -187
  444. package/docs/contracts/explain-trace.schema.json +0 -144
  445. package/docs/contracts/file-ownership-matrix.json +0 -13941
  446. package/docs/contracts/file-ownership-matrix.md +0 -135
  447. package/docs/contracts/frontmatter-contract.md +0 -140
  448. package/docs/contracts/ghostwriter-schema.md +0 -337
  449. package/docs/contracts/governance-enforcement-projection.md +0 -159
  450. package/docs/contracts/gui-wizard.md +0 -350
  451. package/docs/contracts/harness-expectations.md +0 -128
  452. package/docs/contracts/hook-architecture-v1.md +0 -325
  453. package/docs/contracts/host-agent-protocol.md +0 -110
  454. package/docs/contracts/implement-ticket-flow.md +0 -625
  455. package/docs/contracts/init-telemetry.md +0 -132
  456. package/docs/contracts/injected-block-authenticity-model.md +0 -66
  457. package/docs/contracts/install-layout.md +0 -249
  458. package/docs/contracts/install-scopes.md +0 -82
  459. package/docs/contracts/installed-tools-lockfile.md +0 -144
  460. package/docs/contracts/installer-agent-mode.md +0 -137
  461. package/docs/contracts/iron-law-overrides.txt +0 -26
  462. package/docs/contracts/kernel-membership.md +0 -339
  463. package/docs/contracts/linear-ai-rules-inclusion.md +0 -143
  464. package/docs/contracts/linear-ai-three-layers.md +0 -130
  465. package/docs/contracts/linter-structural-model.md +0 -181
  466. package/docs/contracts/load-context-budget-model.md +0 -259
  467. package/docs/contracts/load-context-schema.md +0 -220
  468. package/docs/contracts/local-analytics.md +0 -160
  469. package/docs/contracts/local-knowledge-ingestion.md +0 -96
  470. package/docs/contracts/local-server-api.md +0 -134
  471. package/docs/contracts/local-server-ports.md +0 -53
  472. package/docs/contracts/low-impact-corpus-format.md +0 -95
  473. package/docs/contracts/mcp-beta-criteria.md +0 -130
  474. package/docs/contracts/mcp-cloud-scope.md +0 -355
  475. package/docs/contracts/mcp-discovery-phase-notice.md +0 -60
  476. package/docs/contracts/mcp-phase-1-scope.md +0 -272
  477. package/docs/contracts/mcp-registry-manifest.schema.json +0 -129
  478. package/docs/contracts/mcp-tool-inventory.md +0 -64
  479. package/docs/contracts/mcp-tool-stub-envelope.md +0 -78
  480. package/docs/contracts/measurement-baseline.md +0 -103
  481. package/docs/contracts/memory-visibility-v1.md +0 -160
  482. package/docs/contracts/mental-models.md +0 -336
  483. package/docs/contracts/migrate-command.md +0 -233
  484. package/docs/contracts/multi-tool-projection-fidelity.md +0 -134
  485. package/docs/contracts/namespace.md +0 -125
  486. package/docs/contracts/no-runtime-boundary.md +0 -61
  487. package/docs/contracts/one-off-script-lifecycle.md +0 -110
  488. package/docs/contracts/orchestration-dsl-v1.md +0 -153
  489. package/docs/contracts/package-self-orientation.md +0 -163
  490. package/docs/contracts/pilot/agent-authority.md +0 -24
  491. package/docs/contracts/pilot/direct-answers.md +0 -70
  492. package/docs/contracts/pilot/language-and-tone.md +0 -63
  493. package/docs/contracts/plain-language-surface.md +0 -117
  494. package/docs/contracts/prelaunch-diagnostics.md +0 -151
  495. package/docs/contracts/profile-system.md +0 -167
  496. package/docs/contracts/reasoning-discipline-protocol.md +0 -83
  497. package/docs/contracts/release-pr-gating.md +0 -151
  498. package/docs/contracts/release-sizing.md +0 -107
  499. package/docs/contracts/release-trunk-sync.md +0 -105
  500. package/docs/contracts/review-lens-schema.md +0 -64
  501. package/docs/contracts/roadmap-complexity-standard.md +0 -138
  502. package/docs/contracts/role-experience.md +0 -125
  503. package/docs/contracts/router-blending.md +0 -71
  504. package/docs/contracts/rule-classification.md +0 -171
  505. package/docs/contracts/rule-interactions.md +0 -132
  506. package/docs/contracts/rule-interactions.yml +0 -260
  507. package/docs/contracts/rule-priority-hierarchy.md +0 -88
  508. package/docs/contracts/rule-router.md +0 -287
  509. package/docs/contracts/safety-model.md +0 -129
  510. package/docs/contracts/session-profile-overlay.md +0 -157
  511. package/docs/contracts/settings-api.md +0 -264
  512. package/docs/contracts/settings-gui-agent-mode.schema.json +0 -128
  513. package/docs/contracts/settings-sync-yaml-subset.md +0 -139
  514. package/docs/contracts/skill-bundled-assets.md +0 -62
  515. package/docs/contracts/skill-discovery.md +0 -80
  516. package/docs/contracts/skill-distribution-channels.md +0 -66
  517. package/docs/contracts/skill-domains.md +0 -144
  518. package/docs/contracts/skill-dry-run.md +0 -47
  519. package/docs/contracts/skill-family-map.yml +0 -915
  520. package/docs/contracts/smoke-contracts.md +0 -144
  521. package/docs/contracts/subagent-boundary.md +0 -74
  522. package/docs/contracts/surface-agent-contracts.md +0 -153
  523. package/docs/contracts/surface-matrix.md +0 -108
  524. package/docs/contracts/surface-tiers.md +0 -81
  525. package/docs/contracts/telegraph-telemetry.md +0 -83
  526. package/docs/contracts/ticket-bundle-format.md +0 -233
  527. package/docs/contracts/tier-3-contrib-plugin.md +0 -137
  528. package/docs/contracts/trust-and-safety.md +0 -144
  529. package/docs/contracts/ui-stack-extension.md +0 -237
  530. package/docs/contracts/ui-track-flow.md +0 -329
  531. package/docs/contracts/universal-skills.md +0 -91
  532. package/docs/contracts/user-type-schema.md +0 -146
  533. package/docs/contracts/value-dashboard-spec.md +0 -378
  534. package/docs/contracts/value-report-schema.md +0 -168
  535. package/docs/contracts/workflow-packs.md +0 -121
  536. package/docs/contracts/workspace-boundary.md +0 -84
  537. package/docs/contracts/workspace-documents.md +0 -144
  538. package/docs/contracts/write-engine.md +0 -182
  539. package/docs/cookbook.md +0 -152
  540. package/docs/customization.md +0 -696
  541. package/docs/decisions/ADR-001-kernel-swap-deferred.md +0 -109
  542. package/docs/decisions/ADR-002-kernel-bucket-overrides.md +0 -135
  543. package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +0 -137
  544. package/docs/decisions/ADR-004-rule-governance-pruning.md +0 -240
  545. package/docs/decisions/ADR-005-subagent-worktrees.md +0 -120
  546. package/docs/decisions/ADR-006-skill-tools-python-pilot.md +0 -114
  547. package/docs/decisions/ADR-007-agent-discovery-scopes.md +0 -371
  548. package/docs/decisions/ADR-008-installed-tools-manifest.md +0 -160
  549. package/docs/decisions/ADR-009-event4u-namespace.md +0 -188
  550. package/docs/decisions/ADR-010-profile-pack-preset-boundary.md +0 -168
  551. package/docs/decisions/ADR-011-domain-pack-readiness.md +0 -213
  552. package/docs/decisions/ADR-012-typescript-cli-shell.md +0 -162
  553. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +0 -342
  554. package/docs/decisions/ADR-014-gui-framework-choice.md +0 -136
  555. package/docs/decisions/ADR-015-discovery-manifest-contract.md +0 -146
  556. package/docs/decisions/ADR-016-installer-architecture.md +0 -191
  557. package/docs/decisions/ADR-017-monorepo-physical-layout.md +0 -261
  558. package/docs/decisions/ADR-018-trust-and-safety-layer.md +0 -159
  559. package/docs/decisions/ADR-019-router-json-dist-location.md +0 -124
  560. package/docs/decisions/ADR-020-global-only-consumer-scope.md +0 -213
  561. package/docs/decisions/ADR-021-deployment-shape.md +0 -153
  562. package/docs/decisions/ADR-022-daily-workspace-decomposition.md +0 -140
  563. package/docs/decisions/ADR-023-host-agent-protocol.md +0 -129
  564. package/docs/decisions/ADR-024-workspace-v0-feature-floor.md +0 -126
  565. package/docs/decisions/ADR-025-workspace-chrome.md +0 -119
  566. package/docs/decisions/ADR-026-explain-mode-translation.md +0 -117
  567. package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +0 -129
  568. package/docs/decisions/ADR-028-root-layout.md +0 -147
  569. package/docs/decisions/ADR-029-multi-workspace-deferred.md +0 -122
  570. package/docs/decisions/ADR-030-claude-code-command-projection.md +0 -147
  571. package/docs/decisions/ADR-031-validation-severity-tiers-and-projection-roundtrip.md +0 -97
  572. package/docs/decisions/ADR-032-linked-projects-scope.md +0 -122
  573. package/docs/decisions/ADR-033-distribution-identity-npm-primary.md +0 -81
  574. package/docs/decisions/ADR-034-per-skill-model-recommendation-transport.md +0 -63
  575. package/docs/decisions/ADR-035-model-capability-tiers.md +0 -104
  576. package/docs/decisions/ADR-036-global-install-browser-wizard-handoff.md +0 -106
  577. package/docs/decisions/ADR-037-cost-profile-untangle.md +0 -117
  578. package/docs/decisions/ADR-038-canonical-settings-path.md +0 -96
  579. package/docs/decisions/ADR-039-claude-skills-untracked.md +0 -139
  580. package/docs/decisions/ADR-040-execution-model-projection-time-filtering.md +0 -244
  581. package/docs/decisions/ADR-041-controlled-command-verbs.md +0 -133
  582. package/docs/decisions/ADR-042-runtime-resolver-decision-gate.md +0 -113
  583. package/docs/decisions/ADR-043-monorepo-collapse-to-src-domains.md +0 -128
  584. package/docs/decisions/ADR-044-command-naming-scheme-hyphenated.md +0 -250
  585. package/docs/decisions/ADR-045-src-source-layout-and-profiles-as-views.md +0 -111
  586. package/docs/decisions/ADR-046-thin-command-principle.md +0 -93
  587. package/docs/decisions/ADR-047-framework-neutral-stack-adaptive-commands.md +0 -94
  588. package/docs/decisions/ADR-048-command-justification-rule.md +0 -106
  589. package/docs/decisions/ADR-049-configuration-trust-boundary.md +0 -132
  590. package/docs/decisions/ADR-050-workspace-vs-package-root-boundary.md +0 -121
  591. package/docs/decisions/ADR-051-uncondensed-source-container-relocation.md +0 -114
  592. package/docs/decisions/ADR-052-packages-removal-and-pack-home-migration.md +0 -86
  593. package/docs/decisions/ADR-053-agents-namespace-dual-role-resolution.md +0 -132
  594. package/docs/decisions/ADR-054-rule-adherence-decay-triggered-restate.md +0 -143
  595. package/docs/decisions/ADR-055-flow-layer-data-model.md +0 -235
  596. package/docs/decisions/ADR-056-unvalidated-video-adapters-disposition.md +0 -124
  597. package/docs/decisions/ADR-057-consolidation-evidence-gate-outcomes.md +0 -135
  598. package/docs/decisions/ADR-058-condensed-output-relocation-to-dist.md +0 -94
  599. package/docs/decisions/ADR-059-render-resume-filesystem-as-state.md +0 -161
  600. package/docs/decisions/ADR-060-comfyui-sandbox-model.md +0 -154
  601. package/docs/decisions/ADR-061-corpus-grounding-layer.md +0 -230
  602. package/docs/decisions/ADR-062-encrypt-at-rest-store-architecture.md +0 -121
  603. package/docs/decisions/ADR-063-append-jsonl-encryption-deferred.md +0 -83
  604. package/docs/decisions/ADR-064-append-jsonl-per-record-encryption.md +0 -113
  605. package/docs/decisions/ADR-065-tier3-inbox-handoff-v0.md +0 -86
  606. package/docs/decisions/ADR-066-skill-body-prerendering.md +0 -93
  607. package/docs/decisions/ADR-067-glama-registry-listing.md +0 -259
  608. package/docs/decisions/ADR-068-host-tier-detection.md +0 -90
  609. package/docs/decisions/ADR-069-prompt-renderer.md +0 -97
  610. package/docs/decisions/ADR-070-tier1-drive-loop.md +0 -94
  611. package/docs/decisions/ADR-071-launch-drive-integration.md +0 -95
  612. package/docs/decisions/ADR-072-codex-gemini-drive-configs.md +0 -90
  613. package/docs/decisions/ADR-073-drive-health-kill-switch.md +0 -81
  614. package/docs/decisions/ADR-074-drive-kill-switch-auto-recovery.md +0 -84
  615. package/docs/decisions/ADR-075-workspace-gui-drive.md +0 -83
  616. package/docs/decisions/ADR-076-workspace-multi-turn.md +0 -92
  617. package/docs/decisions/ADR-077-workspace-followup-gui.md +0 -70
  618. package/docs/decisions/ADR-078-drive-health-panel.md +0 -70
  619. package/docs/decisions/ADR-079-workspace-host-picker.md +0 -81
  620. package/docs/decisions/ADR-080-host-session-expired-410.md +0 -92
  621. package/docs/decisions/ADR-081-drive-health-reset-and-410-affordance.md +0 -71
  622. package/docs/decisions/ADR-082-410-one-click-relaunch.md +0 -58
  623. package/docs/decisions/ADR-083-session-thread-and-arbitrary-continuation.md +0 -85
  624. package/docs/decisions/ADR-084-drive-health-refresh-on-drive.md +0 -52
  625. package/docs/decisions/ADR-085-mcp-stdio-end-user-distribution-shape.md +0 -158
  626. package/docs/decisions/ADR-086-read-only-cross-agent-mcp-discovery-helper.md +0 -171
  627. package/docs/decisions/ADR-087-installer-e2e-test-strategy.md +0 -111
  628. package/docs/decisions/ADR-088-no-external-runtime-federation.md +0 -144
  629. package/docs/decisions/ADR-089-lean-local-plugin-install.md +0 -111
  630. package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +0 -95
  631. package/docs/decisions/ADR-091-split-meta-capability-packs.md +0 -113
  632. package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +0 -117
  633. package/docs/decisions/ADR-093-ai-council-config-user-global.md +0 -117
  634. package/docs/decisions/ADR-094-agent-memory-layer-removal.md +0 -94
  635. package/docs/decisions/ADR-095-workspace-boundary-contract.md +0 -108
  636. package/docs/decisions/ADR-096-analysis-workbench.md +0 -110
  637. package/docs/decisions/ADR-097-mission-recipe-privilege-boundary.md +0 -121
  638. package/docs/decisions/ADR-098-evidence-first-structure-discovery.md +0 -154
  639. package/docs/decisions/ADR-099-file-first-pattern-library.md +0 -87
  640. package/docs/decisions/ADR-100-global-knowledge-card-sharing.md +0 -140
  641. package/docs/decisions/ADR-101-ticket-bundle-emission.md +0 -109
  642. package/docs/decisions/ADR-102-ticket-handoff-paste-and-mcp.md +0 -72
  643. package/docs/decisions/ADR-103-global-knowledge-default-off-until-measured.md +0 -92
  644. package/docs/decisions/ADR-104-ai-council-config-global-only.md +0 -119
  645. package/docs/decisions/ADR-105-automatic-subagent-orchestration.md +0 -108
  646. package/docs/decisions/ADR-106-recursive-verification-benchmark-gate.md +0 -126
  647. package/docs/decisions/ADR-107-legal-domain-pack-adoption.md +0 -70
  648. package/docs/decisions/ADR-108-open-source-forever-no-commercial-tier.md +0 -46
  649. package/docs/decisions/ADR-109-subagent-v1-contract.md +0 -248
  650. package/docs/decisions/ADR-110-discipline-profile-resolution-locus.md +0 -112
  651. package/docs/decisions/ADR-111-canonical-glama-listing.md +0 -97
  652. package/docs/decisions/ADR-112-stdio-lite-stays-read-only.md +0 -92
  653. package/docs/decisions/ADR-113-ci-native-release-label-trigger.md +0 -209
  654. package/docs/decisions/ADR-114-commit-policy-iron-law-override.md +0 -85
  655. package/docs/decisions/ADR-115-command-cluster-consolidation-phase-4.md +0 -91
  656. package/docs/decisions/ADR-116-memory-tripwire-activation-path.md +0 -144
  657. package/docs/decisions/ADR-117-subagents-auto-default-on.md +0 -89
  658. package/docs/decisions/ADR-118-loop-engineering-boundaries.md +0 -162
  659. package/docs/decisions/ADR-119-global-knowledge-default-on.md +0 -104
  660. package/docs/decisions/ADR-120-council-chairman-mode.md +0 -70
  661. package/docs/decisions/ADR-121-knowledge-sensitivity-classes.md +0 -90
  662. package/docs/decisions/ADR-122-adversarial-verification-council.md +0 -166
  663. package/docs/decisions/ADR-123-runtime-security-scope-and-spawn-hardening.md +0 -142
  664. package/docs/decisions/ADR-124-embedded-engine-doctrine.md +0 -255
  665. package/docs/decisions/ADR-125-doc-screenshot-anonymization.md +0 -131
  666. package/docs/decisions/ADR-126-internet-reach-operator-tooling.md +0 -254
  667. package/docs/decisions/ADR-127-enforcement-claims-must-resolve.md +0 -150
  668. package/docs/decisions/ADR-128-executable-evidence-and-measured-escalation.md +0 -201
  669. package/docs/decisions/ADR-200-python-to-typescript-migration.md +0 -203
  670. package/docs/decisions/ADR-rule-kernel-and-router.md +0 -133
  671. package/docs/decisions/INDEX.md +0 -157
  672. package/docs/decisions/engine-reclassification-2026-07.md +0 -104
  673. package/docs/deploy/connector-setup.md +0 -129
  674. package/docs/deploy/env-vars.md +0 -70
  675. package/docs/deploy/policy-cookbook.md +0 -130
  676. package/docs/deploy/quickstart.md +0 -112
  677. package/docs/deploy/small-team-recipe.md +0 -148
  678. package/docs/deploy/team-deployment-posture.md +0 -111
  679. package/docs/design/adversarial-council-eval.md +0 -106
  680. package/docs/design/council-vs-solo-baseline.md +0 -92
  681. package/docs/design/cross-model-parity-eval.md +0 -82
  682. package/docs/design/length-neutral-judge-rerun.md +0 -92
  683. package/docs/design/utilization-window-criteria.md +0 -51
  684. package/docs/development.md +0 -230
  685. package/docs/distribution/awesome-list-submission.md +0 -46
  686. package/docs/distribution/consumer-matrix.md +0 -96
  687. package/docs/distribution/launch-story-draft.md +0 -58
  688. package/docs/distribution/mcp-submission-checklist.md +0 -95
  689. package/docs/distribution/public-install-smoke.md +0 -68
  690. package/docs/distribution/registries.md +0 -126
  691. package/docs/distribution/registry-submissions.md +0 -85
  692. package/docs/distribution/telemetry-privacy.md +0 -128
  693. package/docs/distribution/telemetry-schema.md +0 -174
  694. package/docs/distribution/topics-equivalents-decay-policy.md +0 -51
  695. package/docs/end-to-end-walkthroughs.md +0 -165
  696. package/docs/enforcement-by-host.md +0 -51
  697. package/docs/examples/agent-user.example.md +0 -22
  698. package/docs/experiences/agency.md +0 -49
  699. package/docs/experiences/content_creator.md +0 -49
  700. package/docs/experiences/developer.md +0 -49
  701. package/docs/experiences/finance.md +0 -50
  702. package/docs/experiences/founder.md +0 -49
  703. package/docs/experiences/ops.md +0 -49
  704. package/docs/featured-commands.md +0 -27
  705. package/docs/featured-skills.md +0 -95
  706. package/docs/flows.md +0 -67
  707. package/docs/getting-started-by-role.md +0 -190
  708. package/docs/getting-started-laravel.md +0 -72
  709. package/docs/getting-started-local-stdio.md +0 -77
  710. package/docs/getting-started.md +0 -254
  711. package/docs/github-topics.md +0 -93
  712. package/docs/governance-advantage.md +0 -72
  713. package/docs/governance.md +0 -96
  714. package/docs/guides/cross-repo-linked-projects.md +0 -93
  715. package/docs/guides/cross-repo-retrieval.md +0 -61
  716. package/docs/guides/frontend-design-corpus-refresh.md +0 -83
  717. package/docs/guides/gated-platform-reads.md +0 -221
  718. package/docs/guides/local-analytics.md +0 -125
  719. package/docs/guides/local-knowledge.md +0 -127
  720. package/docs/guides/skill-discovery.md +0 -71
  721. package/docs/guides/skill-preview.md +0 -71
  722. package/docs/hook-payload-capture.md +0 -221
  723. package/docs/install-friction-report.md +0 -66
  724. package/docs/installation.md +0 -959
  725. package/docs/maintainers/branch-protection.md +0 -105
  726. package/docs/maintainers/dev-mode.md +0 -106
  727. package/docs/maintainers/optional-media-deps.md +0 -50
  728. package/docs/maintainers/system-map.md +0 -85
  729. package/docs/mcp-registries.md +0 -94
  730. package/docs/mcp-server.md +0 -175
  731. package/docs/mcp.md +0 -147
  732. package/docs/media/proof-demo.cast +0 -14
  733. package/docs/media/proof-demo.gif +0 -0
  734. package/docs/migration/consumer-template-consumption-model.md +0 -145
  735. package/docs/migration/divergences/README.md +0 -55
  736. package/docs/migration/divergences/_template.md +0 -50
  737. package/docs/migration/divergences/bench-stats-float-precision.md +0 -72
  738. package/docs/migration/divergences/mcp-telemetry-node-sqlite.md +0 -61
  739. package/docs/migration/divergences/pack-mcp-content-gzip-body.md +0 -53
  740. package/docs/migration/divergences/src-scripts-build_cloud_bundle.md +0 -63
  741. package/docs/migration/divergences/src-scripts-check_memory.md +0 -91
  742. package/docs/migration/divergences/src-scripts-inventory_abstraction_budget.md +0 -65
  743. package/docs/migration/divergences/src-scripts-lint_marketplace.md +0 -57
  744. package/docs/migration/divergences/src-scripts-lint_mcp_registry_manifest.md +0 -70
  745. package/docs/migration/divergences/src-scripts-spotcheck_thin_root.md +0 -60
  746. package/docs/migration/divergences/src-scripts-validate_agent_settings.md +0 -58
  747. package/docs/migration/node-floor.md +0 -86
  748. package/docs/migration/v1-to-v2.md +0 -156
  749. package/docs/migration/yaml-roundtrip-spike.md +0 -163
  750. package/docs/migrations/commands-1.15.0.md +0 -117
  751. package/docs/parity/bench-external.json +0 -58
  752. package/docs/parity/bench.json +0 -41
  753. package/docs/parity/command-frontmatter.md +0 -60
  754. package/docs/parity/external-runtime.md +0 -46
  755. package/docs/personas.md +0 -178
  756. package/docs/positioning-evidence.md +0 -86
  757. package/docs/profiles.md +0 -108
  758. package/docs/proof.md +0 -252
  759. package/docs/quality.md +0 -98
  760. package/docs/readme-split-plan.md +0 -102
  761. package/docs/recruits/_template.md +0 -81
  762. package/docs/release-runbook.md +0 -141
  763. package/docs/role-experiences.md +0 -19
  764. package/docs/safety.md +0 -30
  765. package/docs/second-brain-scope.md +0 -116
  766. package/docs/self-review-gate.md +0 -65
  767. package/docs/setup/enterprise-and-offline.md +0 -201
  768. package/docs/setup/mcp-client-config.md +0 -358
  769. package/docs/setup/mcp-cloud-endpoints.md +0 -116
  770. package/docs/setup/mcp-cloud-registry-listing.md +0 -99
  771. package/docs/setup/mcp-cloud-setup.md +0 -183
  772. package/docs/setup/mcp-r2-bootstrap.md +0 -82
  773. package/docs/setup/mcp-server-docker.md +0 -101
  774. package/docs/setup/per-ide/aider.md +0 -48
  775. package/docs/setup/per-ide/antigravity.md +0 -68
  776. package/docs/setup/per-ide/augment.md +0 -89
  777. package/docs/setup/per-ide/claude-code.md +0 -97
  778. package/docs/setup/per-ide/claude-desktop.md +0 -207
  779. package/docs/setup/per-ide/cline.md +0 -43
  780. package/docs/setup/per-ide/codebuddy.md +0 -63
  781. package/docs/setup/per-ide/codex.md +0 -46
  782. package/docs/setup/per-ide/continue.md +0 -68
  783. package/docs/setup/per-ide/copilot.md +0 -80
  784. package/docs/setup/per-ide/cursor.md +0 -125
  785. package/docs/setup/per-ide/droid.md +0 -65
  786. package/docs/setup/per-ide/gemini-cli.md +0 -45
  787. package/docs/setup/per-ide/jetbrains.md +0 -76
  788. package/docs/setup/per-ide/kilocode.md +0 -66
  789. package/docs/setup/per-ide/kiro.md +0 -72
  790. package/docs/setup/per-ide/opencode.md +0 -62
  791. package/docs/setup/per-ide/qoder.md +0 -63
  792. package/docs/setup/per-ide/roocode.md +0 -68
  793. package/docs/setup/per-ide/trae.md +0 -63
  794. package/docs/setup/per-ide/warp.md +0 -63
  795. package/docs/setup/per-ide/windsurf.md +0 -109
  796. package/docs/setup/per-ide/zed.md +0 -73
  797. package/docs/showcase.md +0 -209
  798. package/docs/skill-duplication-findings.md +0 -91
  799. package/docs/skills-catalog.md +0 -265
  800. package/docs/skills-taxonomy.md +0 -90
  801. package/docs/spawn-site-policy.md +0 -72
  802. package/docs/succession.md +0 -80
  803. package/docs/threat-model.md +0 -30
  804. package/docs/troubleshooting.md +0 -155
  805. package/docs/ui-track-mental-model.md +0 -121
  806. package/docs/us-vs-the-category.md +0 -38
  807. package/docs/value.md +0 -86
  808. package/docs/walkthroughs/assets/workspace-role-grid.png +0 -0
  809. package/docs/walkthroughs/assets/workspace-session-started.png +0 -0
  810. package/docs/walkthroughs/assets/workspace-task-picker.png +0 -0
  811. package/docs/walkthroughs/daily-workspace-a11y.md +0 -87
  812. package/docs/walkthroughs/daily-workspace.md +0 -127
  813. package/docs/wedge/production-validator/README.md +0 -81
  814. package/docs/wedge/production-validator/first-run-check.sh +0 -42
  815. package/docs/wedge/production-validator/production-validator.md +0 -83
  816. package/docs/wizard.md +0 -173
  817. package/src/scripts/postinstall_gui.ts +0 -129
@@ -100,8 +100,8 @@ Do NOT use when:
100
100
  [`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
101
101
  before the polish step (Visual V1–V7, Layout L1–L8 are the React-component
102
102
  slop tells); the objective quality floors (WCAG contrast, focus-visible,
103
- reduced-motion) are CI-enforced by
104
- [`lint_design_quality`](../../../src/scripts/lint_design_quality.ts).
103
+ reduced-motion) are validated via `accessibility-auditor`'s checklist —
104
+ cite its verdict rather than eyeballing.
105
105
 
106
106
  ## Covered primitives
107
107
 
@@ -41,6 +41,12 @@ Land a verified result by running a depth-bounded
41
41
  the only compute knob, every level budgeted, and the loop default-off
42
42
  until a benchmark gate authorises it per host.
43
43
 
44
+ > **Disposition (2026-07-28, honest null — TERMINAL).** Recursive-verification
45
+ > benchmark resolved as published null (no measured lift over single-pass
46
+ > verification; see `docs/benchmark.md`). `verification.recursive` stays
47
+ > default-off bound to that null; removal at next major unless external
48
+ > evidence appears first. NOT sold as a quality-lift mechanism.
49
+
44
50
  ## The Iron Law
45
51
 
46
52
  ```
@@ -182,9 +182,9 @@ naming (e.g. `feat/` vs `fix/` vs `refactor/` prefix), and
182
182
  risks instead of inventing terms.
183
183
 
184
184
  The match lists and `require_count` thresholds are owned by
185
- `detection-map.yml` — edit the map, not this skill. Tests:
186
- [`tests/scripts/refine_ticket_detect.test.ts`](../../../tests/scripts/refine_ticket_detect.test.ts)
187
- (DE + EN fixtures, repo-aware + graceful-degrade coverage).
185
+ `detection-map.yml` — edit the map, not this skill (DE + EN fixtures,
186
+ repo-aware + graceful-degrade coverage are regression-locked in this
187
+ package's own test suite).
188
188
 
189
189
  ### 3. Orchestrate
190
190
 
@@ -301,6 +301,10 @@ to every roadmap you author.
301
301
  behind the scope? `## Provenance` block with `ENC1:` link? inlined
302
302
  council convergence? anti-dump acceptance criterion? (Internally
303
303
  originated → these must be **absent**, not empty.)
304
+ 8. *Inbox-sourced only:* roadmap consumed an `agents/tmp/` file as input →
305
+ file moved to `agents/tmp.old/<name>` in the SAME reply, Source line
306
+ pointing at the `tmp.old/` path? (Per `agents-layout § User Inbox
307
+ Workflow`. Move only the named input file(s); never sweep the inbox.)
304
308
 
305
309
  ## Do NOT
306
310
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  model_tier: medium
3
3
  name: rtk-output-filtering
4
- description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns."
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
6
  execution:
7
7
  type: assisted
@@ -23,9 +23,17 @@ packs:
23
23
 
24
24
  ## What
25
25
 
26
- High-performance CLI proxy that reduces LLM token consumption by 60-90%
27
- on common dev commands through intelligent output filtering (whitespace, boilerplate,
26
+ High-performance CLI proxy that reduces LLM token consumption on common dev
27
+ commands through intelligent output filtering (whitespace, boilerplate,
28
28
  comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
29
+ **Third-party Apache-2.0 tool** (rtk-ai upstream — an external project, not part of this package).
30
+
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`.
29
37
 
30
38
  **Docs:** https://www.mintlify.com/rtk-ai/rtk
31
39
  **Repo:** https://github.com/rtk-ai/rtk
@@ -34,9 +42,9 @@ comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
34
42
 
35
43
  Wrap any CLI command with `rtk`:
36
44
  ```bash
37
- rtk git status # 80-92% savings
38
- rtk git log # compact log output
39
- rtk cargo test # 90% savings — only failures shown
45
+ rtk git status # verbose status → compact (measured ~55% here)
46
+ rtk git log # compact log output (measured ~55% here)
47
+ rtk cargo test # upstream: only failures shown
40
48
  rtk npm test # same for JS/TS
41
49
  rtk docker compose ps # compact container status
42
50
  ```
@@ -70,12 +78,23 @@ outside onboarding, follow the Installation section below and set
70
78
 
71
79
  ## Installation (on-demand)
72
80
 
73
- Invoked by `/onboard` when rtk is not on `PATH`, or on explicit user
74
- request. Never fire unsolicited.
75
-
76
- 1. Ask which installer to use (macOS → Homebrew; otherwise Cargo).
77
- 2. Run the installer. On success:
78
- 1. `rtk --version` to verify.
81
+ Invoked when rtk is not on `PATH` and the user explicitly asks to install
82
+ it. Never fire unsolicited.
83
+
84
+ 1. Offer the verified per-OS install path (same map as
85
+ `src/install/rtkDetection.ts` / `docs/contracts/rtk-detection.md`):
86
+ - macOS → `brew install rtk` (official homebrew-core formula)
87
+ - Linux → `curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh`
88
+ (installs to `~/.local/bin`)
89
+ - Windows → `winget install rtk-ai.rtk` (plus the documented ripgrep
90
+ dependency: `winget install BurntSushi.ripgrep.MSVC`); winget-less
91
+ images use the upstream `rtk-x86_64-pc-windows-msvc.zip` release.
92
+ **NEVER `cargo install rtk`** — the bare crates.io `rtk` crate is the
93
+ unrelated Rust Type Kit, not Rust Token Killer.
94
+ 2. Run the installer only on explicit confirmation. On success:
95
+ 1. `rtk gain` to verify IDENTITY (the savings dashboard prints "RTK
96
+ Token Savings" only on Rust Token Killer — `rtk --version` cannot
97
+ distinguish the two same-name tools).
79
98
  2. `rtk init --global` to enable auto-rewrite hooks.
80
99
  3. Apply **Post-Install Setup** below (telemetry, tee, audit logging).
81
100
  4. Generate project-local filters (see Post-Install Setup).
@@ -80,13 +80,13 @@ For each approved verdict:
80
80
 
81
81
  * **merge** → rewrite the surviving rule to cover both domains;
82
82
  delete the absorbed one; update any `routes_to:` references.
83
- * **delete** → remove the file from `.agent-src.uncondensed/rules/`
83
+ * **delete** → remove the file from `src/rules/`
84
84
  and the corresponding `dist/agent-src/rules/` projection.
85
85
  * **move-to-context** → extract the body into
86
- `.agent-src.uncondensed/contexts/<area>/<name>.md`, replace the
86
+ `src/agent-src/contexts/<area>/<name>.md`, replace the
87
87
  rule body with the obligation + a `load_context:` pointer.
88
88
  * **promote-to-skill** → create
89
- `.agent-src.uncondensed/skills/<name>/SKILL.md`, replace the rule
89
+ `src/skills/<name>/SKILL.md`, replace the rule
90
90
  with an auto-trigger stub that routes to it (or delete the rule
91
91
  entirely if the skill's own trigger suffices).
92
92
 
@@ -0,0 +1,92 @@
1
+ ---
2
+ model_tier: medium
3
+ name: schema-review
4
+ description: "Use when reviewing a migration diff or schema change for scale hazards — indexes, unsafe migrations, unbounded growth, N+1. Triggers on 'review this migration', 'will this scale'."
5
+ domain: engineering
6
+ workspaces:
7
+ - engineering
8
+ packs:
9
+ - scale-discipline
10
+ trust:
11
+ level: professional
12
+ install:
13
+ default: false
14
+ removable: true
15
+ ---
16
+
17
+ # schema-review
18
+
19
+ ## When to use
20
+
21
+ - A migration diff, new migration file, or schema change is under review
22
+ and the question is scale-shaped: indexes, reversibility, growth,
23
+ query patterns against the new columns.
24
+ - The user asks "will this scale", "review this migration", "check the
25
+ schema", or a PR touches `migrations/`, `schema.prisma`, or raw `.sql`
26
+ migration files.
27
+ - NOT for runtime performance analysis of live traffic (no APM here —
28
+ route to `performance-analysis`) and NOT for authoring a new migration
29
+ from scratch (route to `laravel-migration` or the stack-native tool,
30
+ then come back with the diff).
31
+
32
+ ## Procedure
33
+
34
+ 1. **Detect the stack surface** in the diff: Laravel migrations
35
+ (`database/migrations/*.php`), Prisma (`schema.prisma` +
36
+ `prisma/migrations/**/migration.sql`), raw SQL (`*.sql`). One diff can
37
+ carry several.
38
+ 2. **Run the deterministic linter** on the touched files plus the query
39
+ surface that references the changed tables:
40
+
41
+ ```bash
42
+ npx tsx node_modules/@event4u/agent-config/src/scripts/lint_persistence.ts -- --dir <path> [--stack eloquent|prisma|raw-sql] --format json
43
+ ```
44
+
45
+ The linter emits `gate` findings (pattern-detected: F1 N+1, F2
46
+ index-parity, F3 unbounded reads, F6 migration-safety, F7
47
+ growth-budget, F8 audit-coverage, F9 sync-in-handler, F11 non-durable
48
+ async) and `advice` findings (heuristics — never treat as blockers).
49
+ 3. **Walk the gap table** — for every `gate` finding decide: fix, or
50
+ waiver with a reason (`// no-index: <reason>`, `// sync-required:
51
+ <reason>`, `-- no-retention: <reason>`, …). An empty waiver reason is
52
+ itself a finding.
53
+ 4. **Check the R-A6/R-A7 invariants by hand** where the linter is blind:
54
+ reversibility of data transformations, retention policy for any new
55
+ append-only table (the `-- retention: <policy>` line), backfill plan
56
+ for new NOT NULL columns on large tables.
57
+ 5. **Report waiver density neutrally** — count waivers per rule; state
58
+ both readings (informed exceptions vs rule misfit) and let the human
59
+ decide. Density alone is never a verdict.
60
+
61
+ ## Output
62
+
63
+ The review MUST contain:
64
+
65
+ 1. **Gap table** — one row per finding: `rule · file:line · finding ·
66
+ proposed action (fix | waiver | accepted)`, gate findings first,
67
+ advice findings clearly marked as advice.
68
+ 2. **Waiver-density line** — `N waivers across M findings` with the
69
+ two-reading note (informed exceptions vs rule misfit).
70
+ 3. A one-line verdict: ready / needs fixes / needs human schema decision
71
+ — never a bare "looks good" without the table.
72
+
73
+ ## Gotcha
74
+
75
+ - The linter proves **pattern presence**, not instance-level correctness
76
+ — a flagged `Http::` call in a controller may be legitimately sync
77
+ (then it gets a `// sync-required:` waiver with a reason), and a clean
78
+ run does not prove the schema scales. Say what was checked, not more.
79
+ - Prisma's `@relation` fields are indexed implicitly on some connectors
80
+ and not on others — when the linter reports a missing FK index on a
81
+ Prisma model, verify the connector before calling it a defect.
82
+
83
+ ## Do NOT
84
+
85
+ - Do NOT gate a review on `advice`-tier findings (F4 denormalization,
86
+ F10 event-decoupling heuristics) — they are review inputs, not
87
+ blockers.
88
+ - Do NOT strip or rewrite existing waivers — surface stale-looking ones
89
+ and ask.
90
+ - Do NOT invent index recommendations for columns the query surface
91
+ never filters or orders by — index parity cuts both ways; unused
92
+ indexes cost write throughput.
@@ -0,0 +1,17 @@
1
+ {
2
+ "skill": "schema-review",
3
+ "last_eval": "2026-07-27",
4
+ "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers DE+EN phrasings for reviewing a migration/schema diff for scale hazards. Should-not-trigger covers near-miss neighbours: authoring a migration (laravel-migration), live-traffic performance (performance-analysis), audit-tier selection (history-design), generic code review.",
5
+ "queries": [
6
+ { "q": "review this migration for missing indexes before I merge", "trigger": true },
7
+ { "q": "will this schema change scale to 100k rows?", "trigger": true },
8
+ { "q": "prüfe meine Migration auf Skalierungsprobleme", "trigger": true },
9
+ { "q": "check the new schema.prisma diff for unsafe changes", "trigger": true },
10
+ { "q": "does this ALTER TABLE need CONCURRENTLY and a default?", "trigger": true },
11
+ { "q": "create a migration that adds a status column to orders", "trigger": false },
12
+ { "q": "the dashboard endpoint is slow in production, profile it", "trigger": false },
13
+ { "q": "which audit log mechanism should we use for tenants?", "trigger": false },
14
+ { "q": "review my pull request for code quality", "trigger": false },
15
+ { "q": "wie lege ich einen Index in MySQL an?", "trigger": false }
16
+ ]
17
+ }
@@ -104,14 +104,13 @@ Telemetry / APM → strip from request/response captures; allowlist headers.
104
104
  The scanning gates (Step 4) are the CI/pre-commit nets. The **earliest** gate is
105
105
  the agent itself: before it writes a credential into a tracked file or stages a
106
106
  commit, the [`secret-vcs-guard`](../../rules/secret-vcs-guard.md) rule runs the
107
- `secret_detector` library (`src/scripts/_lib/secret_detector.ts`) and, on a hit,
107
+ `secret_detector` library and, on a hit,
108
108
  STOPS → shows the match (`file:line` · kind · masked · why) → asks via numbered
109
109
  options → offers the tiered alternative below. It never silently commits and
110
110
  never silently strips. VCS-agnostic: the same detector runs against the diff for
111
111
  git, SVN, and Mercurial (SVN/hg native hooks are server-side, a stronger but
112
- later net). The deterministic CI backstop is `check_secret_leak`
113
- (`src/scripts/check_secret_leak.ts`) — the agent gate is one layer, not the whole
114
- defense.
112
+ later net). The deterministic CI backstop is `check_secret_leak` — the agent
113
+ gate is one layer, not the whole defense.
115
114
 
116
115
  **False positives — audited allowlist, never a global mute.** Suppress a
117
116
  confirmed non-secret with an inline `# secret-allow` marker on the line, or a
@@ -148,7 +148,7 @@ After findings, add **Rejected candidates** section: one line per look-dangerous
148
148
  ## Gotcha
149
149
 
150
150
  - Don't report theoretical vulnerabilities without a concrete attack vector — false positives erode trust.
151
- - The model tends to flag framework-handled security as issues (e.g., Laravel's CSRF is already handled).
151
+ - The model tends to flag framework-handled security as issues (e.g., Laravel's CSRF or Rails' `protect_from_forgery` is already handled).
152
152
  - Always check if a finding is already mitigated by middleware or configuration before reporting it.
153
153
 
154
154
  ## Do NOT
@@ -55,7 +55,7 @@ Do NOT use when:
55
55
 
56
56
  1. **Scope** — name the module/paths under assessment; list entry points (routes, jobs, commands, webhooks). Scorecard without stated scope is not reproducible.
57
57
  2. **Assess each category** — inspect the code the category names. Every rating cites evidence:
58
- - Positive evidence: `file:line` of the control (`app/Http/Requests/…:12`).
58
+ - Positive evidence: `file:line` of the control (`app/Http/Requests/…:12`, `src/guards/auth.guard.ts:12`).
59
59
  - Absence evidence: the searches run that came back empty (name the grep patterns) — "not found" beats "probably missing".
60
60
  - Multi-tenant N/A: single-tenant systems rate category 8 `N/A`; drops out of the roll-up.
61
61
  3. **Roll up deterministically** — overall rating is computed, not vibed:
@@ -115,8 +115,8 @@ Decide what to create:
115
115
  > the exact wording is recoverable, and verify against it rather than trusting
116
116
  > the summary.
117
117
 
118
- - **New rule** → create in `.agent-src.uncondensed/rules/`, follow rule conventions
119
- - **New skill** → use `skill-writing` skill, create in `.agent-src.uncondensed/skills/`
118
+ - **New rule** → create in `src/rules/`, follow rule conventions
119
+ - **New skill** → use `skill-writing` skill, create in `src/skills/`
120
120
  - **Update existing** → use `skill-management` skill
121
121
 
122
122
  After creation:
@@ -175,7 +175,7 @@ Ask the user:
175
175
  - Do NOT skip the promotion gate — it prevents skill/rule bloat
176
176
  - Do NOT create both a rule AND a skill for the same learning
177
177
  - Do NOT auto-push without user permission
178
- - Do NOT create project-specific content in `.agent-src.uncondensed/`
178
+ - Do NOT create project-specific content in `src/`
179
179
  - Do NOT run this pipeline for trivial learnings
180
180
 
181
181
  ## References
@@ -189,7 +189,7 @@ approval-gated propose / pick loop with at most two rounds.
189
189
  ### 1c. Propose a trigger-eval stub (new skills only)
190
190
 
191
191
  When creating a new skill, propose a stub
192
- `.agent-src.uncondensed/skills/{name}/evals/triggers.json` before writing
192
+ `src/skills/{name}/evals/triggers.json` before writing
193
193
  the body. Draw the queries from Phase A of the drafting protocol (the
194
194
  user's "should trigger" and "must not trigger" answers).
195
195
 
@@ -531,7 +531,7 @@ content).
531
531
 
532
532
  ## Do NOT
533
533
 
534
- * Write documentation-style, pointer-only, or too-broad skills ("Laravel skill")
534
+ * Write documentation-style, pointer-only, or too-broad skills ("Laravel skill", "Django skill")
535
535
  * Skip Procedure or use vague validation
536
536
  * Exceed size limits (see `docs/guidelines/agent-infra/size-and-scope.md`)
537
537
  * Duplicate rules
@@ -38,9 +38,9 @@ discover the real source → Evidence Report (Verified / Assumed / Gaps) →
38
38
  Scaffold the report cheaply so it never gets skipped:
39
39
 
40
40
  ```bash
41
- ./scripts-run src/scripts/evidence_report git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
42
- ./scripts-run src/scripts/evidence_report init --task "<task>" # writes the gitignored session report
43
- ./scripts-run src/scripts/evidence_report add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
41
+ npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts git-state # fail-fast: abort if a rebase/merge/cherry-pick is in progress
42
+ npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts init --task "<task>" # writes the gitignored session report
43
+ npx tsx node_modules/@event4u/agent-config/src/scripts/evidence_report.ts add --bucket verified --claim "users.email is unique" --source "db/schema/users.sql:23"
44
44
  ```
45
45
 
46
46
  **Provenance on every item** (`observed_at` / `source` / `version`). Within a
@@ -175,10 +175,10 @@ the per-session Evidence Report above. Append to the knowledge intake —
175
175
  never write a tracked page mid-task:
176
176
 
177
177
  ```bash
178
- ./scripts-run src/scripts/emit_knowledge_event --type api_shape_learned \
178
+ npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts --type api_shape_learned \
179
179
  --endpoint "<path>" --method "<verb>" --request-schema '<json>' --response-schema '<json>'
180
180
 
181
- ./scripts-run src/scripts/emit_knowledge_event --type convention_detected \
181
+ npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts --type convention_detected \
182
182
  --pattern "<pattern>" --evidence "file:line" --sample-size <N> --scope project
183
183
  ```
184
184
 
@@ -111,6 +111,15 @@ Rules:
111
111
  or `none`) so the gate's value is measurable inside the ADR-117
112
112
  prove-or-drop window.
113
113
 
114
+ ## Severity-conditioned team composition — conditions pattern
115
+
116
+ Incident-style severity tiers (Critical / High / Medium / Low) refine
117
+ composition and activation **within** the form the static gate already
118
+ picked — severity never overrides the form gate, the Iron Law, or any
119
+ safety floor. Guidance, not a new object class (persona-catalog
120
+ disposition). Severity→composition table + escalation rule →
121
+ [`subagent-modes-detail` § Severity-conditioned team composition](../../agent-src/contexts/execution/subagent-modes-detail.md).
122
+
114
123
  ## The nine modes
115
124
 
116
125
  Each mode has a decision row: when to use, when not, and the expected
@@ -124,42 +133,23 @@ glossary) lives in
124
133
  [`subagent-topologies`](../../agent-src/contexts/execution/subagent-topologies.md) —
125
134
  pull it for capacity planning; it is metadata, not runtime-enforced.
126
135
 
136
+ Per-mode decision rows (when to use / when not / model pairing) and the
137
+ mode-2 stage-routing contract live in
138
+ [`subagent-modes-detail` § Modes 1–6](../../agent-src/contexts/execution/subagent-modes-detail.md) —
139
+ pull them at dispatch time.
140
+
127
141
  ### 1. do-and-judge
128
142
 
129
143
  Implementer produces a diff; judge reviews; loop applies, revises, or
130
144
  hands off. Hard ceiling: **two revision cycles**, then stop and hand
131
145
  back to the user.
132
146
 
133
- | When to use | When not | Model pairing |
134
- |---|---|---|
135
- | Single-change task with non-trivial risk | Tiny fix, or spike/exploration | implementer = session; judge = one tier up |
136
-
137
147
  ### 2. do-and-judge-two-stage
138
148
 
139
- Implementer produces a diff; **two judges run sequentially** — first a
140
- spec-compliance reviewer (does the diff satisfy the stated spec /
141
- acceptance criteria?), then a code-quality reviewer (is the diff well-
142
- written for the codebase it lands in?). The orchestrator only proceeds
143
- to stage two if stage one returns `DONE` or `DONE_WITH_CONCERNS`. A
144
- stage-one `BLOCKED` shortcuts the loop — there is no point quality-
145
- reviewing a diff that does not satisfy the spec.
146
-
147
- | When to use | When not | Model pairing |
148
- |---|---|---|
149
- | Spec is contested or AC are detailed; diff size makes one judge prone to missing one axis (correctness vs craft) | Spec is one sentence, or the diff is one line (collapse to mode 1) | implementer = session; spec-judge = one tier up; quality-judge = same tier as spec-judge, fresh context |
150
-
151
- **Why two stages, not one judge with both rubrics:** combining the
152
- rubrics in one prompt reliably regresses one of them — the judge "spends
153
- attention" on whichever rubric appears last. Splitting the prompts
154
- forces each judge to commit fully to its rubric.
155
-
156
- **Stage-routing rule:**
157
- - Stage-1 returns `DONE` → run stage-2.
158
- - Stage-1 returns `DONE_WITH_CONCERNS` → run stage-2; concerns carry
159
- forward to the final envelope.
160
- - Stage-1 returns `NEEDS_CONTEXT` → pause; stage-2 does not run.
161
- - Stage-1 returns `BLOCKED` → final verdict is `BLOCKED`; stage-2
162
- does not run (saves cost).
149
+ Implementer produces a diff; **two judges run sequentially** — spec
150
+ compliance first, code quality second. Stage-one `BLOCKED` shortcuts the
151
+ loop (no point quality-reviewing a diff that misses the spec). Stage
152
+ routing + why-two-stages rationale → modes-detail § Mode 2.
163
153
 
164
154
  ### 3. do-in-steps
165
155
 
@@ -167,40 +157,24 @@ Plan is split into N steps; judge runs **between** steps. A step that
167
157
  fails judgment is revised before the next step starts. Used for
168
158
  multi-file changes where a mid-plan mistake would cascade.
169
159
 
170
- | When to use | When not | Model pairing |
171
- |---|---|---|
172
- | Multi-step plan with ordered dependencies | Single-step change, or when steps are independent (use `do-in-parallel`) | implementer = session; judge = one tier up |
173
-
174
160
  ### 4. do-in-parallel
175
161
 
176
162
  Independent slices run concurrently. No judge per slice — judge runs
177
163
  once on the aggregated result. Parallelism capped by
178
164
  `subagents.max_parallel` in `.agent-settings.yml`.
179
165
 
180
- | When to use | When not | Model pairing |
181
- |---|---|---|
182
- | Independent slices (different files, non-overlapping) | Any slice touches shared state | implementer = session; judge = one tier up, run once |
183
-
184
166
  ### 5. do-competitively
185
167
 
186
168
  Multiple implementers produce candidate diffs for the **same** slice.
187
169
  Judge picks the winner and rejects the losers. Expensive — use only
188
170
  when the solution space is genuinely broad.
189
171
 
190
- | When to use | When not | Model pairing |
191
- |---|---|---|
192
- | Broad solution space (algorithm choice, API shape) | Well-defined problem with one good answer | implementers = same tier (≥2 instances); judge = one tier up |
193
-
194
172
  ### 6. judge-with-debate
195
173
 
196
174
  Two judges each produce a verdict; a meta-judge reconciles
197
175
  disagreements. Used for high-stakes changes (security, data
198
176
  migration, public API) where a single judge is too easy to fool.
199
177
 
200
- | When to use | When not | Model pairing |
201
- |---|---|---|
202
- | Security, data integrity, public API change | Routine internal refactor | judges = same tier (2x); meta-judge = one tier up |
203
-
204
178
  Mode 6 = **go/no-go** (strict-er verdict wins); for defect-FINDING coverage (the
205
179
  *union* of what diverse models catch) use Mode 9.
206
180
 
@@ -238,34 +212,25 @@ opt-in high-risk changes only; registered claim + high-risk tier need
238
212
  cross-*vendor* skeptics. Invariants, skeptic prompt, reconciliation, prove-or-drop
239
213
  gate → [`subagent-modes-detail`](../../agent-src/contexts/execution/subagent-modes-detail.md) § Mode 9
240
214
  + [`prompts/adversarial-verification-council.md`](prompts/adversarial-verification-council.md)
215
+
216
+ > **Disposition (2026-07-28, honest null).** Adversarial-council
217
+ > finding-coverage benchmark resolved as published null (`docs/benchmark.md`)
218
+ > — mode NOT sold as defect-detection capability. Stays default-off bound to
219
+ > that null; removal at next major unless external evidence (consumer-filed
220
+ > case where the panel surfaced a real defect the single verifier missed)
221
+ > appears first. Remaining honest value: perspective diversity + decision
222
+ > documentation, nothing more.
241
223
  (ADR-122).
242
224
 
243
225
  ## Status taxonomy — every subagent return uses one envelope
244
226
 
245
227
  Every implementer or judge return must conform to
246
- [`schemas/subagent-status.json`](schemas/subagent-status.json). Four
247
- statuses, no free-form alternatives:
248
-
249
- | Status | Meaning | Required keys (beyond `status`, `summary`) |
250
- |---|---|---|
251
- | `DONE` | Work shipped, all gates green. | `evidence[]` |
252
- | `DONE_WITH_CONCERNS` | Work shipped but caller must act on concerns. | `evidence[]`, `concerns[]` |
253
- | `NEEDS_CONTEXT` | Paused; caller can unblock by answering. | `blocking_question` |
254
- | `BLOCKED` | No path forward exists. | `blocking_reason` |
255
-
256
- **Why a fixed taxonomy:** orchestrators (`/do-and-judge`, `/do-in-steps`)
257
- route on status. Free-form "kind of done" returns force the orchestrator
258
- to interpret prose, which silently regresses the two-revision ceiling and
259
- the judge-rejected-do-not-apply rule. The schema makes routing mechanical.
260
-
261
- **Tests:** `tests/test_subagent_status_schema.py` exercises all four
262
- statuses plus rejection cases (missing required keys, unknown status,
263
- extra fields, conditional-key violations).
264
-
265
- **Distinguishing `NEEDS_CONTEXT` from `BLOCKED`:** `NEEDS_CONTEXT` means
266
- *"you, the caller, can fix this by telling me X"*. `BLOCKED` means
267
- *"no input from you unblocks this — escalate or rescope"*. If a subagent
268
- is unsure, it picks `BLOCKED` and the caller can downgrade.
228
+ [`schemas/subagent-status.json`](schemas/subagent-status.json). Exactly
229
+ four statuses — `DONE` · `DONE_WITH_CONCERNS` · `NEEDS_CONTEXT` ·
230
+ `BLOCKED` — no free-form alternatives; orchestrators route on status
231
+ mechanically. Meaning/required-keys table, why-fixed rationale, and the
232
+ `NEEDS_CONTEXT`-vs-`BLOCKED` distinction →
233
+ [`subagent-modes-detail` § Status taxonomy](../../agent-src/contexts/execution/subagent-modes-detail.md).
269
234
 
270
235
  ## Dispatch prompts — externalized
271
236
 
@@ -273,9 +238,12 @@ Each mode's literal dispatch template lives under
273
238
  [`prompts/{mode}.md`](prompts/README.md). The orchestrator loads the
274
239
  matching prompt at dispatch time and substitutes `{{placeholders}}`.
275
240
  Edits to a prompt do not bloat this skill against the 400-line sunset
276
- trigger; `tests/test_subagent_prompt_loading.py` confirms each of the
277
- nine modes resolves to a loadable prompt that cites all four taxonomy
278
- statuses.
241
+ trigger. Eight prompt files cover modes 1–7 and 9 (the standalone judge
242
+ reuses [`prompts/do-and-judge.md`](prompts/do-and-judge.md); mode 8's
243
+ live-app rubric lives in
244
+ [`subagent-modes-detail` § Mode 8](../../agent-src/contexts/execution/subagent-modes-detail.md));
245
+ each prompt cites all four taxonomy statuses — see
246
+ [`prompts/README.md`](prompts/README.md).
279
247
 
280
248
  ## Procedure
281
249
 
@@ -339,21 +307,13 @@ the judge verdict.
339
307
 
340
308
  ### 6. Emit telemetry
341
309
 
342
- After every auto-dispatched run, write one telemetry line to
343
- `agents/runtime/state/audit/YYYY-MM.jsonl` (current UTC month — use
344
- `new Date().toISOString().slice(0, 7)` to compute the filename).
345
- The line is a standard audit-log-v1 object with `input_kind:
346
- "orchestration"` and an `orchestration` sub-object per
347
- [`orchestration-telemetry.md`](../../agent-src/contexts/execution/orchestration-telemetry.md).
348
-
349
- Minimal emit (fill what is observable; `token_delta_provenance: "estimated"` if
350
- host usage metadata is unavailable):
351
-
352
- ```json
353
- {"schema_version":1,"id":"<ulid>","ts":"<iso>","work_id":"<work_id>","phase":"implement","outcome":"success","confidence_band":"high","risk_class":"low","input_kind":"orchestration","type":"phase","orchestration":{"task_size_estimate":<int>,"spawn_count":<int>,"tiers":[...],"token_delta":<int>,"token_delta_provenance":"estimated","wall_clock_ms":<int>,"outcome":"DONE","verify_mode":"deterministic"}}
354
- ```
355
-
356
- Skip emit when `subagents.enabled: false` or `spawn_count == 0` (in-session run).
310
+ After every auto-dispatched run, write one audit-log-v1 line
311
+ (`input_kind: "orchestration"`) via the `orchestration_record` recorder —
312
+ never hand-author the JSON. Line shape, field semantics, recorder
313
+ invocation, and `token_delta` sourcing priority →
314
+ [`orchestration-telemetry` § Emit procedure](../../agent-src/contexts/execution/orchestration-telemetry.md).
315
+ Skip emit when `subagents.enabled: false` or `spawn_count == 0`
316
+ (in-session run).
357
317
 
358
318
  ## Gotcha
359
319
 
@@ -21,7 +21,7 @@ skill above the 400-line sunset trigger.
21
21
  Every prompt cites the status taxonomy in
22
22
  [`../schemas/subagent-status.json`](../schemas/subagent-status.json) and
23
23
  ends with the **return-envelope** instruction so the subagent's reply
24
- validates against `tests/test_subagent_status_schema.py`.
24
+ validates against that schema.
25
25
 
26
26
  ## Prompt-cache discipline
27
27
 
@@ -47,6 +47,7 @@ dispatch. Verify a cohort is actually reading, not re-writing, by checking
47
47
 
48
48
  ## Loading
49
49
 
50
- `tests/test_subagent_prompt_loading.py` asserts that every mode named
51
- in `SKILL.md` § *The nine modes* has a loadable prompt file under this
52
- directory and that each prompt mentions all four status enum values.
50
+ Every dispatchable mode named in `SKILL.md` § *The nine modes* maps to a
51
+ prompt file in the table above (mode 8 is gated/experimental — its
52
+ live-app rubric lives in the `subagent-modes-detail` context, not here);
53
+ each prompt mentions all four status enum values.
@@ -275,7 +275,7 @@ knowledge intake — never rewrite the page mid-task (see
275
275
  [`knowledge-pages`](../../templates/contexts/knowledge-pages.md)):
276
276
 
277
277
  ```bash
278
- ./scripts-run src/scripts/emit_knowledge_event \
278
+ npx tsx node_modules/@event4u/agent-config/src/scripts/emit_knowledge_event.ts \
279
279
  --type mistake_made \
280
280
  --error-category "<one or two words>" \
281
281
  --context-source "<agents/knowledge/... path, or 'null' if no page was followed>" \
@@ -292,7 +292,7 @@ right now (observed ≠ documented, not a one-off) → hybrid immediate-fix
292
292
  case instead — surface the correction, ask before continuing (see
293
293
  [`knowledge-pages`](../../templates/contexts/knowledge-pages.md) §
294
294
  Contested entries). Approved → isolated fix commit. Declined →
295
- `./scripts-run src/scripts/append_contested` on that page, then still
295
+ `npx tsx node_modules/@event4u/agent-config/src/scripts/append_contested.ts` on that page, then still
296
296
  emit the `context_stale` event above for the consolidation pass.
297
297
 
298
298
  ## Gotchas
@@ -134,9 +134,8 @@ Risks: <arbitrary values, !important, dark-mode gaps>
134
134
  [`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
135
135
  (C1 gradients, T7 fonts, L1/L2 layout, V1 side-stripe). Pull the catalog
136
136
  for the full list; the objective subset (contrast, font-size floor,
137
- reduced-motion) is CI-enforced by
138
- [`lint_design_quality`](../../../src/scripts/lint_design_quality.ts) for
139
- consumer projects.
137
+ reduced-motion) is validated via `accessibility-auditor`'s checklist —
138
+ cite its verdict rather than eyeballing.
140
139
  - **Anti-AI-slop: gradients.** Unless audit-pinned or brief-explicit,
141
140
  avoid the default purple-to-blue / cyan-to-pink gradients on white —
142
141
  they read as auto-generated (catalog C1/C2). Reach for a single accent