@event4u/agent-config 3.3.0 → 4.2.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 (561) hide show
  1. package/.agent-src/README.md +2 -2
  2. package/.agent-src/commands/agent-handoff.md +31 -2
  3. package/.agent-src/commands/agent-status.md +5 -5
  4. package/.agent-src/commands/agents/audit.md +8 -8
  5. package/.agent-src/commands/agents/init.md +25 -1
  6. package/.agent-src/commands/agents/optimize.md +3 -3
  7. package/.agent-src/commands/agents/user.md +1 -1
  8. package/.agent-src/commands/agents.md +1 -1
  9. package/.agent-src/commands/analyze-reference-repo.md +1 -1
  10. package/.agent-src/commands/check-current-md.md +8 -8
  11. package/.agent-src/commands/{compress.md → condense.md} +55 -55
  12. package/.agent-src/commands/context/create.md +7 -4
  13. package/.agent-src/commands/context/refactor.md +3 -1
  14. package/.agent-src/commands/feature/dev.md +1 -1
  15. package/.agent-src/commands/feature/explore.md +1 -1
  16. package/.agent-src/commands/feature/plan.md +10 -8
  17. package/.agent-src/commands/feature/refactor.md +3 -1
  18. package/.agent-src/commands/feature/roadmap.md +7 -4
  19. package/.agent-src/commands/fix/portability.md +3 -3
  20. package/.agent-src/commands/fix/refs.md +4 -4
  21. package/.agent-src/commands/ghostwriter.md +2 -2
  22. package/.agent-src/commands/memory/learn-low-impact.md +3 -3
  23. package/.agent-src/commands/module/explore.md +34 -8
  24. package/.agent-src/commands/optimize/agents-dir.md +9 -7
  25. package/.agent-src/commands/optimize/augmentignore.md +2 -2
  26. package/.agent-src/commands/optimize/skills.md +9 -9
  27. package/.agent-src/commands/post-as.md +1 -1
  28. package/.agent-src/commands/project-analyze.md +2 -2
  29. package/.agent-src/commands/project-health.md +3 -2
  30. package/.agent-src/commands/research/deep.md +1 -1
  31. package/.agent-src/commands/research/report.md +1 -1
  32. package/.agent-src/commands/research.md +1 -1
  33. package/.agent-src/commands/roadmap/ai-council.md +1 -1
  34. package/.agent-src/commands/roadmap/create.md +9 -4
  35. package/.agent-src/commands/rule-compliance-audit.md +1 -1
  36. package/.agent-src/commands/upstream-contribute.md +14 -14
  37. package/.agent-src/commands/video/from-script.md +1 -1
  38. package/.agent-src/commands/video/scene.md +1 -1
  39. package/.agent-src/commands/video/stitch.md +1 -1
  40. package/.agent-src/commands/video/storyboard.md +1 -1
  41. package/.agent-src/commands/video.md +1 -1
  42. package/.agent-src/contexts/augment-infrastructure.md +1 -1
  43. package/.agent-src/contexts/authority/commit-mechanics.md +15 -0
  44. package/.agent-src/contexts/authority/kernel-rule-edits.md +3 -3
  45. package/.agent-src/contexts/authority/scope-mechanics.md +1 -1
  46. package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +28 -28
  47. package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +4 -4
  48. package/.agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
  49. package/.agent-src/contexts/contracts/artifact-engagement-flow.md +6 -6
  50. package/.agent-src/contexts/contracts/command-suggestion-flow.md +3 -3
  51. package/.agent-src/contexts/contracts/emergency-triage-block.md +4 -4
  52. package/.agent-src/contexts/contracts/frugality-charter.md +3 -3
  53. package/.agent-src/contexts/documentation-hierarchy.md +14 -7
  54. package/.agent-src/contexts/execution/autonomy-examples.md +1 -1
  55. package/.agent-src/contexts/execution/cheap-question-mechanics.md +39 -2
  56. package/.agent-src/contexts/execution/roadmap-process-loop.md +28 -5
  57. package/.agent-src/contexts/override-system.md +5 -5
  58. package/.agent-src/ghostwriter/fictional-fixture-v1.md +1 -1
  59. package/.agent-src/personas/advisors/first-principles.md +1 -1
  60. package/.agent-src/personas/hollywood-director.md +1 -1
  61. package/.agent-src/rules/architecture.md +5 -1
  62. package/.agent-src/rules/augment-edit-discipline.md +5 -5
  63. package/.agent-src/rules/augment-source-of-truth.md +15 -15
  64. package/.agent-src/rules/commit-conventions.md +1 -1
  65. package/.agent-src/rules/commit-policy.md +10 -0
  66. package/.agent-src/rules/domain-adoption-policy.md +3 -3
  67. package/.agent-src/rules/fast-path-marker-visibility.md +3 -3
  68. package/.agent-src/rules/finance-safety-floor.md +1 -1
  69. package/.agent-src/rules/framework-neutrality-in-generic-skills.md +8 -8
  70. package/.agent-src/rules/git-history-discipline.md +1 -1
  71. package/.agent-src/rules/improve-before-implement.md +2 -2
  72. package/.agent-src/rules/language-and-tone.md +2 -2
  73. package/.agent-src/rules/media-governance-routing.md +5 -5
  74. package/.agent-src/rules/no-attribution-footers.md +1 -0
  75. package/.agent-src/rules/no-cheap-questions.md +3 -0
  76. package/.agent-src/rules/no-decorative-emojis-in-git-surfaces.md +111 -0
  77. package/.agent-src/rules/no-pr-progress-comments.md +118 -0
  78. package/.agent-src/rules/no-roadmap-references.md +3 -3
  79. package/.agent-src/rules/non-destructive-by-default.md +1 -1
  80. package/.agent-src/rules/persona-governance.md +3 -3
  81. package/.agent-src/rules/preservation-guard.md +15 -15
  82. package/.agent-src/rules/roadmap-ci-steps-policy.md +7 -3
  83. package/.agent-src/rules/rule-type-governance.md +1 -1
  84. package/.agent-src/rules/skill-quality.md +1 -1
  85. package/.agent-src/rules/{caveman-speak.md → telegraph-speak.md} +15 -15
  86. package/.agent-src/rules/token-optimizer-maintenance.md +6 -6
  87. package/.agent-src/skills/agent-docs-writing/SKILL.md +17 -11
  88. package/.agent-src/skills/agents-md-thin-root/SKILL.md +9 -9
  89. package/.agent-src/skills/check-refs/SKILL.md +2 -2
  90. package/.agent-src/skills/code-refactoring/SKILL.md +2 -2
  91. package/.agent-src/skills/command-writing/SKILL.md +19 -19
  92. package/.agent-src/skills/comp-banding/SKILL.md +1 -1
  93. package/.agent-src/skills/condense-memory/SKILL.md +131 -0
  94. package/.agent-src/skills/context-authoring/SKILL.md +2 -2
  95. package/.agent-src/skills/context-document/SKILL.md +5 -3
  96. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +3 -3
  97. package/.agent-src/skills/description-assist/SKILL.md +2 -2
  98. package/.agent-src/skills/git-workflow/SKILL.md +1 -1
  99. package/.agent-src/skills/guideline-writing/SKILL.md +5 -5
  100. package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +4 -4
  101. package/.agent-src/skills/lint-skills/SKILL.md +3 -3
  102. package/.agent-src/skills/md-language-check/SKILL.md +2 -2
  103. package/.agent-src/skills/module-detect-on-the-fly/SKILL.md +138 -0
  104. package/.agent-src/skills/module-management/SKILL.md +166 -94
  105. package/.agent-src/skills/override-management/SKILL.md +1 -1
  106. package/.agent-src/skills/persona-writing/SKILL.md +5 -5
  107. package/.agent-src/skills/positioning-strategy/SKILL.md +1 -1
  108. package/.agent-src/skills/project-docs/SKILL.md +6 -4
  109. package/.agent-src/skills/readme-reviewer/SKILL.md +2 -2
  110. package/.agent-src/skills/roadmap-management/SKILL.md +13 -1
  111. package/.agent-src/skills/roadmap-writing/SKILL.md +4 -2
  112. package/.agent-src/skills/rule-refactor/SKILL.md +5 -5
  113. package/.agent-src/skills/rule-writing/SKILL.md +18 -18
  114. package/.agent-src/skills/script-writing/SKILL.md +1 -1
  115. package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +6 -6
  116. package/.agent-src/skills/skill-management/SKILL.md +21 -21
  117. package/.agent-src/skills/skill-reviewer/SKILL.md +2 -2
  118. package/.agent-src/skills/skill-writing/SKILL.md +8 -8
  119. package/.agent-src/skills/skill-writing/evals/triggers.json +1 -1
  120. package/.agent-src/skills/token-optimizer/SKILL.md +4 -4
  121. package/.agent-src/skills/unit-economics-modeling/SKILL.md +1 -1
  122. package/.agent-src/skills/upstream-contribute/SKILL.md +17 -17
  123. package/.agent-src/templates/AGENTS.md +1 -0
  124. package/.agent-src/templates/agent-settings.md +24 -13
  125. package/.agent-src/templates/agents/agent-project-settings.example.yml +61 -2
  126. package/.agent-src/templates/command.md +5 -5
  127. package/.agent-src/templates/contexts.md +1 -1
  128. package/.agent-src/templates/copilot-instructions.md +8 -8
  129. package/.agent-src/templates/features.md +1 -1
  130. package/.agent-src/templates/hooks/pre-commit-frontmatter +2 -2
  131. package/.agent-src/templates/hooks/pre-commit-roadmap-progress +3 -3
  132. package/.agent-src/templates/persona.md +2 -2
  133. package/.agent-src/templates/roadmaps.md +1 -1
  134. package/.agent-src/templates/rule.md +13 -13
  135. package/.agent-src/templates/scripts/memory_lookup.py +1 -1
  136. package/.agent-src/templates/scripts/memory_status.py +2 -2
  137. package/.agent-src/templates/scripts/work_engine/_lib/agent_settings.py +195 -1
  138. package/.agent-src/templates/scripts/work_engine/orchestration.py +1 -1
  139. package/.agent-src/templates/skill-archive-note.md +5 -5
  140. package/.agent-src/templates/skill.md +1 -1
  141. package/.claude-plugin/marketplace.json +4 -4
  142. package/AGENTS.md +16 -17
  143. package/CHANGELOG.md +216 -3
  144. package/CONTRIBUTING.md +31 -12
  145. package/README.md +21 -12
  146. package/config/agent-settings.template.yml +22 -2
  147. package/config/discovery/unassigned-artefacts.yml +24 -24
  148. package/config/profiles/full.ini +1 -1
  149. package/dist/cli/agent-config.js +52 -3
  150. package/dist/cli/agent-config.js.map +1 -1
  151. package/dist/cli/commands/uiServe.js +9 -0
  152. package/dist/cli/commands/uiServe.js.map +1 -1
  153. package/dist/cli/registry.js +2 -1
  154. package/dist/cli/registry.js.map +1 -1
  155. package/dist/discovery/deprecation-report.md +1 -1
  156. package/dist/discovery/discovery-manifest.json +649 -606
  157. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  158. package/dist/discovery/discovery-manifest.summary.md +4 -4
  159. package/dist/discovery/orphan-report.md +1 -1
  160. package/dist/discovery/packs.json +439 -437
  161. package/dist/discovery/trust-report.md +5 -5
  162. package/dist/discovery/workspaces.json +450 -448
  163. package/dist/install/atomic.js +92 -0
  164. package/dist/install/atomic.js.map +1 -0
  165. package/dist/install/conflict.js +196 -0
  166. package/dist/install/conflict.js.map +1 -0
  167. package/dist/install/detect.js +218 -0
  168. package/dist/install/detect.js.map +1 -0
  169. package/dist/install/paths.js +82 -0
  170. package/dist/install/paths.js.map +1 -0
  171. package/dist/install/plan.js +157 -0
  172. package/dist/install/plan.js.map +1 -0
  173. package/dist/install/txlog.js +140 -0
  174. package/dist/install/txlog.js.map +1 -0
  175. package/dist/install/types.js +19 -0
  176. package/dist/install/types.js.map +1 -0
  177. package/dist/install/wizard-plan.js +184 -0
  178. package/dist/install/wizard-plan.js.map +1 -0
  179. package/dist/mcp/registry-manifest.json +4 -4
  180. package/dist/router.json +67 -19
  181. package/dist/server/app.js +6 -0
  182. package/dist/server/app.js.map +1 -1
  183. package/dist/server/routes/install.js +358 -0
  184. package/dist/server/routes/install.js.map +1 -0
  185. package/dist/server/routes/wizard.js +468 -32
  186. package/dist/server/routes/wizard.js.map +1 -1
  187. package/dist/server/routes/workspace.js +396 -0
  188. package/dist/server/routes/workspace.js.map +1 -0
  189. package/dist/server/schemas/settings.js +5 -3
  190. package/dist/server/schemas/settings.js.map +1 -1
  191. package/dist/ui/assets/index-BDAhhpDV.js +40 -0
  192. package/dist/ui/assets/index-BDAhhpDV.js.map +1 -0
  193. package/dist/ui/assets/index-BXZILUxe.css +1 -0
  194. package/dist/ui/index.html +2 -2
  195. package/docs/MIGRATION.md +1 -1
  196. package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
  197. package/docs/adrs/router/0001-three-tier-routing.md +4 -4
  198. package/docs/adrs/schema/0001-json-schema-frontmatter.md +1 -1
  199. package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +4 -4
  200. package/docs/adrs/{caveman → telegraph}/0001-default-off-until-bench.md +9 -9
  201. package/docs/adrs/telegraph/README.md +9 -0
  202. package/docs/architecture/augment-projection.md +4 -4
  203. package/docs/architecture/claude-bundle.md +1 -1
  204. package/docs/architecture/current-onboard-baseline.md +3 -3
  205. package/docs/architecture/multi-tool-projection.md +10 -10
  206. package/docs/architecture/source-projection.md +27 -27
  207. package/docs/architecture.md +19 -15
  208. package/docs/archive/CHANGELOG-pre-2.11.0.md +2 -2
  209. package/docs/archive/CHANGELOG-pre-2.15.0.md +3 -3
  210. package/docs/archive/CHANGELOG-pre-2.16.0.md +1 -1
  211. package/docs/archive/CHANGELOG-pre-2.2.0.md +70 -70
  212. package/docs/archive/CHANGELOG-pre-2.20.0.md +2 -2
  213. package/docs/archive/CHANGELOG-pre-2.25.0.md +15 -15
  214. package/docs/archive/CHANGELOG-pre-3.0.0.md +4 -4
  215. package/docs/archive/CHANGELOG-pre-3.1.0.md +2 -2
  216. package/docs/archive/CHANGELOG-pre-3.2.0.md +3 -3
  217. package/docs/benchmark.md +65 -0
  218. package/docs/benchmarks.md +16 -16
  219. package/docs/catalog.md +17 -15
  220. package/docs/contracts/CHANGELOG-conventions.md +1 -1
  221. package/docs/contracts/STABILITY.md +2 -2
  222. package/docs/contracts/adoption-signal-floor.md +110 -0
  223. package/docs/contracts/adr-chat-history-split.md +4 -4
  224. package/docs/contracts/adr-command-suggestion.md +4 -4
  225. package/docs/contracts/adr-gtm-context-spine.md +1 -1
  226. package/docs/contracts/adr-implement-ticket-runtime.md +4 -4
  227. package/docs/contracts/adr-install-user-type-axis.md +1 -1
  228. package/docs/contracts/adr-layout.md +2 -2
  229. package/docs/contracts/adr-product-ui-track.md +10 -10
  230. package/docs/contracts/adr-user-types-axis.md +3 -3
  231. package/docs/contracts/adr-wing4-context-spine.md +1 -1
  232. package/docs/contracts/agent-memory-contract.md +3 -3
  233. package/docs/contracts/agents-md-tech-stack.md +2 -2
  234. package/docs/contracts/ai-council-config.md +2 -2
  235. package/docs/contracts/at-rest-encryption.md +4 -0
  236. package/docs/contracts/audit-log-v1.md +1 -1
  237. package/docs/contracts/benchmark-ab-contract.md +101 -0
  238. package/docs/contracts/benchmark-corpus-spec.md +1 -1
  239. package/docs/contracts/branch-protection-policy.md +98 -0
  240. package/docs/contracts/ci-cost-budget.md +106 -0
  241. package/docs/contracts/ci-green-floor.md +141 -0
  242. package/docs/contracts/command-clusters.md +6 -6
  243. package/docs/contracts/command-surface-tiers.md +2 -2
  244. package/docs/contracts/command-taxonomy.md +2 -2
  245. package/docs/contracts/{compression-default-kill-criterion.md → condensation-default-kill-criterion.md} +29 -29
  246. package/docs/contracts/config-presets.md +1 -1
  247. package/docs/contracts/context-paths.md +3 -3
  248. package/docs/contracts/context-spine.md +1 -1
  249. package/docs/contracts/cost-summary-schema.md +12 -12
  250. package/docs/contracts/cross-wing-handoff.md +4 -4
  251. package/docs/contracts/daily-workspace.md +4 -0
  252. package/docs/contracts/decision-trace-v1.md +2 -2
  253. package/docs/contracts/discovery-manifest.md +4 -4
  254. package/docs/contracts/explain-modes.md +4 -0
  255. package/docs/contracts/file-ownership-matrix.json +3493 -3318
  256. package/docs/contracts/file-ownership-matrix.md +3 -3
  257. package/docs/contracts/frontmatter-contract.md +4 -4
  258. package/docs/contracts/ghostwriter-schema.md +3 -3
  259. package/docs/contracts/gui-wizard.md +110 -97
  260. package/docs/contracts/harness-expectations.md +123 -0
  261. package/docs/contracts/host-agent-protocol.md +4 -0
  262. package/docs/contracts/implement-ticket-flow.md +9 -9
  263. package/docs/contracts/install-scopes.md +77 -0
  264. package/docs/contracts/iron-law-overrides.txt +1 -1
  265. package/docs/contracts/kernel-membership.md +26 -26
  266. package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
  267. package/docs/contracts/linter-structural-model.md +2 -2
  268. package/docs/contracts/load-context-budget-model.md +4 -4
  269. package/docs/contracts/load-context-schema.md +13 -13
  270. package/docs/contracts/local-analytics.md +4 -0
  271. package/docs/contracts/local-knowledge-ingestion.md +1 -1
  272. package/docs/contracts/mcp-cloud-scope.md +2 -2
  273. package/docs/contracts/mcp-phase-1-scope.md +3 -3
  274. package/docs/contracts/measurement-baseline.md +5 -5
  275. package/docs/contracts/mental-models.md +30 -30
  276. package/docs/contracts/multi-tool-projection-fidelity.md +4 -4
  277. package/docs/contracts/namespace.md +4 -4
  278. package/docs/contracts/orchestration-dsl-v1.md +7 -7
  279. package/docs/contracts/package-self-orientation.md +12 -12
  280. package/docs/contracts/persona-schema.md +6 -6
  281. package/docs/contracts/pilot/language-and-tone.md +1 -1
  282. package/docs/contracts/plain-language-surface.md +117 -0
  283. package/docs/contracts/profile-system.md +3 -3
  284. package/docs/contracts/release-pr-gating.md +103 -0
  285. package/docs/contracts/role-experience.md +3 -3
  286. package/docs/contracts/rule-classification.md +13 -13
  287. package/docs/contracts/rule-interactions.md +4 -4
  288. package/docs/contracts/rule-interactions.yml +30 -30
  289. package/docs/contracts/rule-priority-hierarchy.md +13 -13
  290. package/docs/contracts/rule-router.md +2 -2
  291. package/docs/contracts/safety-model.md +1 -1
  292. package/docs/contracts/skill-distribution-channels.md +61 -0
  293. package/docs/contracts/skill-domains.md +2 -2
  294. package/docs/contracts/smoke-contracts.md +5 -5
  295. package/docs/contracts/telegraph-telemetry.md +83 -0
  296. package/docs/contracts/trust-and-safety.md +5 -5
  297. package/docs/contracts/ui-stack-extension.md +7 -7
  298. package/docs/contracts/ui-track-flow.md +9 -9
  299. package/docs/contracts/user-type-schema.md +4 -4
  300. package/docs/contracts/workflow-packs.md +4 -4
  301. package/docs/contracts/workspace-documents.md +4 -0
  302. package/docs/customization.md +28 -8
  303. package/docs/decisions/ADR-001-kernel-swap-deferred.md +6 -6
  304. package/docs/decisions/ADR-002-kernel-bucket-overrides.md +11 -11
  305. package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +2 -2
  306. package/docs/decisions/ADR-004-rule-governance-pruning.md +4 -4
  307. package/docs/decisions/ADR-005-subagent-worktrees.md +7 -7
  308. package/docs/decisions/ADR-011-domain-pack-readiness.md +6 -6
  309. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +3 -3
  310. package/docs/decisions/ADR-015-discovery-manifest-contract.md +3 -3
  311. package/docs/decisions/ADR-017-monorepo-physical-layout.md +10 -10
  312. package/docs/decisions/ADR-018-trust-and-safety-layer.md +6 -6
  313. package/docs/decisions/ADR-019-router-json-dist-location.md +2 -2
  314. package/docs/decisions/ADR-020-global-only-consumer-scope.md +2 -2
  315. package/docs/decisions/ADR-021-deployment-shape.md +3 -3
  316. package/docs/decisions/ADR-022-daily-workspace-decomposition.md +1 -1
  317. package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +2 -2
  318. package/docs/decisions/ADR-028-root-layout.md +7 -7
  319. package/docs/decisions/ADR-029-multi-workspace-deferred.md +2 -2
  320. package/docs/decisions/ADR-rule-kernel-and-router.md +5 -5
  321. package/docs/deploy/connector-setup.md +2 -2
  322. package/docs/deploy/policy-cookbook.md +2 -2
  323. package/docs/deploy/team-deployment-posture.md +20 -0
  324. package/docs/development.md +17 -17
  325. package/docs/distribution/registries.md +32 -0
  326. package/docs/distribution/registry-submissions.md +85 -0
  327. package/docs/distribution/telemetry-schema.md +1 -1
  328. package/docs/getting-started-by-role.md +45 -3
  329. package/docs/getting-started.md +2 -2
  330. package/docs/guidelines/agent-infra/5w2h-analysis.md +3 -3
  331. package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
  332. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +3 -3
  333. package/docs/guidelines/agent-infra/carve-out-predicates.md +3 -3
  334. package/docs/guidelines/agent-infra/critical-thinking.md +4 -4
  335. package/docs/guidelines/agent-infra/direct-answers-demos.md +1 -1
  336. package/docs/guidelines/agent-infra/first-principles.md +2 -2
  337. package/docs/guidelines/agent-infra/inversion-thinking.md +5 -5
  338. package/docs/guidelines/agent-infra/layered-settings.md +56 -2
  339. package/docs/guidelines/agent-infra/mental-models.md +3 -3
  340. package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +2 -2
  341. package/docs/guidelines/agent-infra/rule-type-governance.md +1 -1
  342. package/docs/guidelines/agent-infra/scqa-framework.md +5 -5
  343. package/docs/guidelines/agent-infra/self-improvement-pipeline.md +2 -2
  344. package/docs/guidelines/agent-infra/six-hats.md +3 -3
  345. package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
  346. package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
  347. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +1 -1
  348. package/docs/guidelines/augment-portability-patterns.md +4 -4
  349. package/docs/guidelines/cross-role-handoff.md +2 -2
  350. package/docs/guidelines/php/php-coding-patterns.md +1 -1
  351. package/docs/guidelines/prompt-templates.md +6 -6
  352. package/docs/maintainers/dev-mode.md +1 -1
  353. package/docs/mcp.md +1 -1
  354. package/docs/parity/bench.json +3 -3
  355. package/docs/parity/ruflo.md +2 -2
  356. package/docs/profiles.md +11 -11
  357. package/docs/quality.md +11 -11
  358. package/docs/safety.md +3 -3
  359. package/docs/setup/mcp-client-config.md +1 -1
  360. package/docs/setup/mcp-r2-bootstrap.md +1 -1
  361. package/docs/setup/mcp-server-docker.md +3 -3
  362. package/docs/setup/per-ide/windsurf.md +1 -1
  363. package/docs/skills-catalog.md +8 -7
  364. package/docs/troubleshooting.md +1 -1
  365. package/docs/walkthroughs/daily-workspace-a11y.md +87 -0
  366. package/llms.txt +7 -6
  367. package/package.json +1 -1
  368. package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  369. package/scripts/_archive/README.md +2 -2
  370. package/scripts/_archive/_backfill_skill_domains.py +3 -3
  371. package/scripts/_archive/_bootstrap_tier_frontmatter.py +3 -3
  372. package/scripts/_archive/_p43_bodies.py +10 -10
  373. package/scripts/_archive/{_p43_compress.py → _p43_condense.py} +5 -5
  374. package/scripts/_archive/_p4_migrate.py +7 -7
  375. package/scripts/_archive/_phase2_shim_helper.py +1 -1
  376. package/scripts/_archive/_pilot_council_question.py +5 -5
  377. package/scripts/_cli/explain_last/inputs.py +1 -1
  378. package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  379. package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  380. package/scripts/_lib/agent_settings.py +195 -1
  381. package/scripts/_lib/agent_src.py +19 -19
  382. package/scripts/_lib/bench_ab_cache.py +162 -0
  383. package/scripts/_lib/bench_ab_scoring.py +209 -0
  384. package/scripts/_lib/{bench_caveman.py → bench_telegraph.py} +21 -21
  385. package/scripts/_lib/{bench_caveman_report.py → bench_telegraph_report.py} +21 -21
  386. package/scripts/_lib/claude_desktop_bundler.py +5 -5
  387. package/scripts/_lib/module_detection.py +223 -0
  388. package/scripts/_lib/scope_guard.sh +162 -0
  389. package/scripts/_phase4_bucket.py +3 -3
  390. package/scripts/_pilot_measure.py +4 -4
  391. package/scripts/_tmp_scan_framework_leakage.py +1 -1
  392. package/scripts/adoption_report.py +195 -0
  393. package/scripts/adoption_snapshot.py +219 -0
  394. package/scripts/adoption_status.py +166 -0
  395. package/scripts/ai-video/lib/parse-blueprint.sh +1 -1
  396. package/scripts/ai_council/advisors.py +5 -5
  397. package/scripts/ai_council/compile_corpus.py +1 -1
  398. package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +3 -3
  399. package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +2 -2
  400. package/scripts/ai_council/one_off_archive/2026-05/_one_off_inject_quiet_flag.py +1 -1
  401. package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_v2.sh +1 -1
  402. package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_verbosity.sh +1 -1
  403. package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +3 -3
  404. package/scripts/ai_council/one_off_archive/2026-05/_one_off_per_task.sh +1 -1
  405. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +1 -1
  406. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +6 -6
  407. package/scripts/ai_council/one_off_archive/2026-05/_one_off_rebalancing_audit.py +1 -1
  408. package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +6 -6
  409. package/scripts/annotate_discovery.py +13 -13
  410. package/scripts/apply_modules_config.py +290 -0
  411. package/scripts/audit_adr_coverage.py +2 -2
  412. package/scripts/audit_auto_rules.py +2 -2
  413. package/scripts/audit_cloud_compatibility.py +3 -3
  414. package/scripts/audit_command_surface.py +9 -9
  415. package/scripts/audit_likelihood.py +2 -2
  416. package/scripts/audit_user_type_axis.py +2 -2
  417. package/scripts/bench_ab_cache_dispatch.py +68 -0
  418. package/scripts/bench_ab_clone.py +170 -0
  419. package/scripts/bench_ab_diff.py +227 -0
  420. package/scripts/bench_ab_integrity.py +143 -0
  421. package/scripts/bench_ab_run.py +235 -0
  422. package/scripts/bench_ab_task_runner.py +369 -0
  423. package/scripts/bench_ab_tracka_run.py +202 -0
  424. package/scripts/{bench_compress_memory.py → bench_condense_memory.py} +16 -16
  425. package/scripts/bench_run.py +33 -33
  426. package/scripts/bench_runner.py +2 -2
  427. package/scripts/bootstrap.sh +99 -0
  428. package/scripts/build_cloud_bundle.py +6 -6
  429. package/scripts/build_discovery_manifest.py +7 -7
  430. package/scripts/build_linear_digest.py +3 -3
  431. package/scripts/build_rule_trigger_matrix.py +8 -8
  432. package/scripts/chat_history.py +5 -5
  433. package/scripts/check_always_budget.py +11 -5
  434. package/scripts/check_augment_description_cap.py +3 -3
  435. package/scripts/check_cluster_patterns.py +2 -2
  436. package/scripts/check_command_count_messaging.py +3 -3
  437. package/scripts/{check_compression.py → check_condensation.py} +34 -34
  438. package/scripts/{check_compressed_paths.py → check_condensed_paths.py} +8 -8
  439. package/scripts/check_context_paths.py +7 -7
  440. package/scripts/check_council_layout.py +2 -2
  441. package/scripts/check_council_references.py +9 -9
  442. package/scripts/check_iron_law_prominence.py +2 -2
  443. package/scripts/check_kernel_rule_bundle.py +2 -2
  444. package/scripts/check_module_management_neutral.py +149 -0
  445. package/scripts/check_no_roadmap_refs.py +9 -9
  446. package/scripts/check_portability.py +3 -3
  447. package/scripts/check_public_catalog_links.py +4 -4
  448. package/scripts/check_references.py +7 -6
  449. package/scripts/check_release_pr_shape.py +112 -0
  450. package/scripts/check_reply_consistency.py +3 -3
  451. package/scripts/check_safety_floor_untouched.py +1 -1
  452. package/scripts/check_template_pin_drift.py +5 -5
  453. package/scripts/check_token_optimizer_freshness.py +3 -3
  454. package/scripts/ci_status.py +301 -0
  455. package/scripts/ci_time_ratio.py +1 -1
  456. package/scripts/cleanup_other_scope.sh +146 -0
  457. package/scripts/compile_router.py +10 -10
  458. package/scripts/{compress.py → condense.py} +64 -64
  459. package/scripts/condense.sh +18 -0
  460. package/scripts/{compress_memory.py → condense_memory.py} +33 -33
  461. package/scripts/config/presets.py +2 -2
  462. package/scripts/config/profiles.py +1 -1
  463. package/scripts/cost_by_conversation.py +3 -3
  464. package/scripts/cost_summary.py +7 -7
  465. package/scripts/count_token_optimizer_usage.sh +1 -1
  466. package/scripts/gen_discovery_baseline.py +5 -5
  467. package/scripts/generate_index.py +6 -6
  468. package/scripts/generate_ownership_matrix.py +10 -10
  469. package/scripts/generate_pack_manifests.py +1 -1
  470. package/scripts/ghostwriter_fixture_allowlist.txt +1 -1
  471. package/scripts/install +3 -3
  472. package/scripts/install-hooks.sh +6 -6
  473. package/scripts/install.py +273 -45
  474. package/scripts/install.sh +187 -1
  475. package/scripts/inventory_frontmatter.py +2 -2
  476. package/scripts/iron_law_sha.py +3 -3
  477. package/scripts/lint_agents_layout.py +14 -7
  478. package/scripts/lint_agents_md.py +4 -4
  479. package/scripts/lint_archived_skills.py +3 -3
  480. package/scripts/lint_artefact_frontmatter.py +2 -2
  481. package/scripts/lint_bench_ab.py +172 -0
  482. package/scripts/lint_bench_corpus.py +1 -1
  483. package/scripts/lint_command_tiers.py +5 -5
  484. package/scripts/lint_context_spine_usage.py +1 -1
  485. package/scripts/lint_framework_leakage.py +7 -7
  486. package/scripts/lint_framework_leakage_allowlist.json +152 -84
  487. package/scripts/lint_ghostwriter_source.py +3 -3
  488. package/scripts/lint_handoffs.py +1 -1
  489. package/scripts/lint_load_context.py +11 -11
  490. package/scripts/lint_media_policy_linkage.py +5 -5
  491. package/scripts/lint_namespace.py +1 -1
  492. package/scripts/lint_no_new_atomic_commands.py +2 -2
  493. package/scripts/lint_orchestration_dsl.py +1 -1
  494. package/scripts/lint_pack_boundaries.py +2 -2
  495. package/scripts/lint_persona_governance.py +4 -4
  496. package/scripts/lint_role_experiences.py +237 -0
  497. package/scripts/lint_rule_interactions.py +2 -2
  498. package/scripts/lint_rule_tiers.py +1 -1
  499. package/scripts/lint_trust_coherence.py +2 -2
  500. package/scripts/mcp_registry_submit.sh +187 -0
  501. package/scripts/mcp_server/tools.py +1 -1
  502. package/scripts/measure_frugality_savings.py +10 -10
  503. package/scripts/measure_patterns.py +1 -1
  504. package/scripts/measure_projection_bytes.py +5 -5
  505. package/scripts/measure_rule_budget.py +3 -3
  506. package/scripts/measure_skill_reduction.py +1 -1
  507. package/scripts/memory_lookup.py +1 -1
  508. package/scripts/memory_status.py +2 -2
  509. package/scripts/migrate_command_suggestions.py +3 -3
  510. package/scripts/mine_session.py +1 -1
  511. package/scripts/move_artefact.py +3 -3
  512. package/scripts/new_skill.py +2 -2
  513. package/scripts/pack_mcp_content.py +9 -9
  514. package/scripts/plan_physical_move.py +6 -6
  515. package/scripts/print_required_checks.py +196 -0
  516. package/scripts/probe_skill_registration.py +413 -0
  517. package/scripts/propose_modules_config.py +145 -0
  518. package/scripts/prototype_lint_contradictions.py +1 -1
  519. package/scripts/recruit_preflight.sh +152 -0
  520. package/scripts/refine_ticket_detect.py +3 -3
  521. package/scripts/release.py +20 -0
  522. package/scripts/render_benchmark_md.py +308 -0
  523. package/scripts/roadmap_progress_hook.py +1 -1
  524. package/scripts/run_skill_evals.py +2 -2
  525. package/scripts/runtime_registry.py +4 -4
  526. package/scripts/schemas/command.schema.json +4 -4
  527. package/scripts/schemas/rule.schema.json +5 -5
  528. package/scripts/schemas/skill.schema.json +3 -3
  529. package/scripts/schemas/user-type.schema.json +1 -1
  530. package/scripts/score_skill_selection.py +1 -1
  531. package/scripts/skill_collision_clusters.py +2 -2
  532. package/scripts/skill_linter.py +81 -81
  533. package/scripts/skill_overlap.py +5 -5
  534. package/scripts/skill_tools/audit_persona_coverage.py +2 -2
  535. package/scripts/skill_tools/audit_user_type_coverage.py +2 -2
  536. package/scripts/skill_tools/run_block_d_eval.py +1 -1
  537. package/scripts/skill_tools/score_skill_relevance.py +1 -1
  538. package/scripts/skill_tools/suggest_skill_for_task.py +1 -1
  539. package/scripts/skill_trigger_eval.py +3 -3
  540. package/scripts/smoke/kernel.sh +7 -1
  541. package/scripts/smoke/router.sh +5 -5
  542. package/scripts/smoke/skills.sh +1 -1
  543. package/scripts/smoke_quickstart.py +1 -1
  544. package/scripts/snapshot_agent_outputs.py +3 -3
  545. package/scripts/spotcheck_thin_root.py +1 -1
  546. package/scripts/{caveman_stats.py → telegraph_stats.py} +18 -18
  547. package/scripts/update_counts.py +1 -1
  548. package/scripts/validate_decision_engine.py +1 -1
  549. package/scripts/validate_frontmatter.py +1 -1
  550. package/scripts/validate_safe_paths.py +3 -3
  551. package/scripts/{validate_caveman_carveouts.py → validate_telegraph_carveouts.py} +7 -7
  552. package/scripts/verify_roadmap_closure.py +6 -6
  553. package/templates/consumer-settings/ONBOARDING.md +41 -0
  554. package/.agent-src/commands/install-via-agent.md +0 -129
  555. package/.agent-src/skills/compress-memory/SKILL.md +0 -131
  556. package/dist/ui/assets/index-D-DY1ywI.js +0 -35
  557. package/dist/ui/assets/index-D-DY1ywI.js.map +0 -1
  558. package/dist/ui/assets/index-Dqfhmg-d.css +0 -1
  559. package/docs/adrs/caveman/README.md +0 -9
  560. package/docs/contracts/caveman-telemetry.md +0 -83
  561. package/scripts/compress.sh +0 -18
@@ -66,7 +66,7 @@ ide
66
66
  cost_profile
67
67
  personal.bot_icon
68
68
  personal.autonomy
69
- caveman.speak_scope
69
+ telegraph.speak_scope
70
70
  ```
71
71
 
72
72
  **Merge order** (lowest → highest precedence; every layer optional):
@@ -179,7 +179,7 @@ is recovered on the next server boot.
179
179
  | `chat_history.enabled` | `true` | Persistent JSONL log at `agents/runtime/.agent-chat-history` for crash recovery. |
180
180
  | `chat_history.frequency` | per profile | Logging granularity: `per_turn`, `per_phase`, or `per_tool` (see matrix below). |
181
181
  | `chat_history.max_size_kb` | per profile | Max file size before overflow handling (see matrix below). |
182
- | `chat_history.on_overflow` | per profile | `rotate` drops oldest, `compress` marks for summarization (see matrix below). |
182
+ | `chat_history.on_overflow` | per profile | `rotate` drops oldest, `condense` marks for summarization (see matrix below). |
183
183
  | `onboarding.onboarded` | `false` | Whether the setup wizard has run. The `onboarding-gate` rule prompts for `agent-config setup` while this is `false`. |
184
184
  | `ai_council.enabled` | `false` | Master switch for the `/council` command. Even when enabled, every consultation asks before spending tokens. |
185
185
  | `ai_council.members.<provider>.enabled` | `false` | Per-provider opt-in (`anthropic`, `openai`). Tokens live in `~/.event4u/agent-config/<provider>.key` (mode 0600), never in this file. Legacy `~/.config/agent-config/<provider>.key` is read as a fallback. |
@@ -226,7 +226,7 @@ to `false` in `.agent-settings.yml` to silence post-task analysis without
226
226
  changing the profile.
227
227
 
228
228
  The authoritative matrix of all matrix-controlled settings lives in
229
- [`.agent-src.uncompressed/templates/agent-settings.md`](../.agent-src.uncompressed/templates/agent-settings.md).
229
+ [`.agent-src.uncondensed/templates/agent-settings.md`](../.agent-src.uncondensed/templates/agent-settings.md).
230
230
 
231
231
  ### Chat-history defaults per profile
232
232
 
@@ -240,13 +240,13 @@ behavior — the per-profile table is just the initial default.
240
240
  | `chat_history.enabled` | `true` | `true` | `true` |
241
241
  | `chat_history.frequency` | `per_turn` | `per_phase` | `per_tool` |
242
242
  | `chat_history.max_size_kb` | `128` | `256` | `512` |
243
- | `chat_history.on_overflow` | `rotate` | `rotate` | `compress` |
243
+ | `chat_history.on_overflow` | `rotate` | `rotate` | `condense` |
244
244
 
245
245
  `custom` ignores these defaults — set every value explicitly.
246
246
 
247
247
  ### Verbosity
248
248
 
249
- The `verbosity:` block and `caveman.speak_scope` control how much narration
249
+ The `verbosity:` block and `telegraph.speak_scope` control how much narration
250
250
  the agent emits around routine actions. Defaults are tuned for token
251
251
  frugality — flip values to `true` (or higher tier) to restore legacy verbose
252
252
  output. Iron-Law gates (`commit-policy`, `scope-control` git-ops,
@@ -261,10 +261,10 @@ output. Iron-Law gates (`commit-policy`, `scope-control` git-ops,
261
261
  | `verbosity.intent_announcements` | `true`, `false` | `false` | Intent announcements ("Let me check…", "Now I will…", "Found it") in skill bodies. `false` = act and emit the result. |
262
262
  | `verbosity.script_output` | `silent`, `minimal`, `verbose` | `minimal` | Stdout chatter from `scripts/*.py`, `scripts/*.sh`, and `.augment/scripts/`. `silent` = stderr only; `minimal` = one summary line per script; `verbose` = pre-Phase-10 per-step prints. Iron-Law surfaces (release confirms, install secrets prompts, error markers) ignore this key. |
263
263
  | `verbosity.taskfile_command_echo` | `true`, `false` | `false` | Suppress the `task: [name] cmd...` echo Taskfile prints before each task body. `true` = echoes preserved (legacy behaviour); `false` = `silent: true` is set on every Phase-10 safe task. |
264
- | `caveman.speak_scope` | `off`, `prose_only`, `aggressive` | `prose_only` | How widely caveman-speak grammar applies in chat. `off` = no caveman; `prose_only` = caveman in body prose, numbered options + Iron-Law-literal blocks stay full prose; `aggressive` = caveman everywhere except Iron-Law literals. |
264
+ | `telegraph.speak_scope` | `off`, `prose_only`, `aggressive` | `prose_only` | How widely telegraph-speak grammar applies in chat. `off` = no telegraph; `prose_only` = telegraph in body prose, numbered options + Iron-Law-literal blocks stay full prose; `aggressive` = telegraph everywhere except Iron-Law literals. |
265
265
 
266
266
  The cross-rule index for these defaults lives in
267
- [`.agent-src.uncompressed/contexts/contracts/frugality-charter.md`](../.agent-src.uncompressed/contexts/contracts/frugality-charter.md).
267
+ [`.agent-src.uncondensed/contexts/contracts/frugality-charter.md`](../.agent-src.uncondensed/contexts/contracts/frugality-charter.md).
268
268
  Writer skills (`skill-writing`, `rule-writing`, `command-writing`,
269
269
  `guideline-writing`, `roadmap-writing`, `persona-writing`,
270
270
  `agent-docs-writing`, `context-authoring`, `conventional-commits-writing`,
@@ -394,7 +394,7 @@ tarball and is the source of truth consumed by:
394
394
  > When you read "the Laravel pack", picture a filter over the shared
395
395
  > artefact tree — not a separate npm package. The day ADR-011's
396
396
  > extraction trigger flips, the same scan output drives the split;
397
- > until then, every artefact lives under `.agent-src.uncompressed/`.
397
+ > until then, every artefact lives under `.agent-src.uncondensed/`.
398
398
 
399
399
  Alongside the JSON manifest, the scanner writes
400
400
  `dist/discovery/discovery-manifest.json.sha256` — a sidecar hash that
@@ -502,6 +502,26 @@ in `.agent-settings.yml`; the command then exits 0 with a one-line
502
502
  notice instead of producing a trace. Exit codes: `0` rendered or
503
503
  disabled · `1` no recent run found · `2` invocation error.
504
504
 
505
+ ## Troubleshooting
506
+
507
+ ### A skill appears twice in my AI tool
508
+
509
+ Most common cause: cross-scope drift between a user-global install (e.g.
510
+ `~/.claude/skills/`) and a project-local install (e.g. `./.claude/skills/`).
511
+ Run the probe to confirm:
512
+
513
+ ```bash
514
+ task probe:skills
515
+ # or directly: python3 scripts/probe_skill_registration.py
516
+ ```
517
+
518
+ The probe lists every registration across all six tools and flags
519
+ `DUPLICATE` (same skill in ≥ 2 sources) and `DRIFT` (same skill, different
520
+ descriptions or versions — the actual 2026-05-25 failure mode). To clean a
521
+ stale install at the other scope: `bash scripts/cleanup_other_scope.sh --confirm`.
522
+ Background: [`docs/contracts/skill-distribution-channels.md`](contracts/skill-distribution-channels.md)
523
+ + [`docs/contracts/install-scopes.md`](contracts/install-scopes.md).
524
+
505
525
  ---
506
526
 
507
527
  ← [Back to README](../README.md)
@@ -37,7 +37,7 @@ landed in `kernel-membership.md` § 5.2:
37
37
  **Variant (a) — status quo through P2.2 + P3.1.**
38
38
 
39
39
  - Keep `agent-authority` in the kernel.
40
- - Keep `autonomous-execution` in `compress-and-keep` (auto-tier) per
40
+ - Keep `autonomous-execution` in `condense-and-keep` (auto-tier) per
41
41
  `docs/contracts/rule-classification.md` § 3.2.
42
42
  - Re-evaluate the swap as a P3.2 ADR after the router schema and
43
43
  compiler ship.
@@ -47,7 +47,7 @@ landed in `kernel-membership.md` § 5.2:
47
47
  ### Accepted
48
48
 
49
49
  - 25k hard cap stays intact (no governance erosion via cap-raise).
50
- - 2 Iron-Law-override ADRs land in P2.2 if post-compression
50
+ - 2 Iron-Law-override ADRs land in P2.2 if post-condensation
51
51
  measurement confirms overage (`direct-answers`, `language-and-tone`).
52
52
  - The 9-rule set carried into P2.2 is the locked § 4 list.
53
53
 
@@ -78,7 +78,7 @@ precedence at build time. At that point:
78
78
  (`docs/guidelines/agent-authority.md`) as documentation of the
79
79
  band model.
80
80
  - `autonomous-execution` can be promoted into the kernel under a
81
- new ADR (ADR-N) that replaces this one, *if* its post-compression
81
+ new ADR (ADR-N) that replaces this one, *if* its post-condensation
82
82
  size fits the cap with no further demotion.
83
83
 
84
84
  This deferral is **not** indefinite: P3.2 ships the router compiler;
@@ -90,7 +90,7 @@ migrations) so the migration plan reflects the final kernel set.
90
90
  - **Variant (b) — swap + raise cap to 27k.** Rejected. Raising the
91
91
  hard cap mid-roadmap weakens the original 25k contract that the
92
92
  whole roadmap is built around. If 27k turns out to be the real
93
- ceiling, that is a separate ADR after compression measurement
93
+ ceiling, that is a separate ADR after condensation measurement
94
94
  proves the band, not a pre-emptive concession.
95
95
  - **Variant (c) — swap + demote `verify-before-complete`.**
96
96
  Rejected. `verify-before-complete` carries criterion #1 (Iron
@@ -105,5 +105,5 @@ migrations) so the migration plan reflects the final kernel set.
105
105
  - `docs/contracts/kernel-membership.md` § 4, § 5.2
106
106
  - `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json` <!-- council-ref-allowed: ADR decision trace -->
107
107
  - `agents/roadmaps/road-to-kernel-and-router.md` § Decisions, § Phase 2
108
- - `.agent-src.uncompressed/rules/agent-authority.md` (subject)
109
- - `.agent-src.uncompressed/rules/autonomous-execution.md` (proposed promotion)
108
+ - `.agent-src.uncondensed/rules/agent-authority.md` (subject)
109
+ - `.agent-src.uncondensed/rules/autonomous-execution.md` (proposed promotion)
@@ -1,7 +1,7 @@
1
1
  # ADR-002 — Kernel-Bucket Cap Raise (25k → 26k) and Per-Rule Iron-Law Overrides
2
2
 
3
3
  - **Status:** Accepted (2026-05-06)
4
- - **Phase:** Road to Rule Kernel and Router · P2.2 (Heavy Compression)
4
+ - **Phase:** Road to Rule Kernel and Router · P2.2 (Heavy Condensation)
5
5
  - **Supersedes:** none — extends the Council R2 amendments locked in
6
6
  `docs/contracts/kernel-membership.md` § 5.1 (median r=0.712, per-rule cap 2.5k,
7
7
  kernel-bucket 25k).
@@ -10,27 +10,27 @@
10
10
 
11
11
  ## Context
12
12
 
13
- P1.3 projected the post-compression kernel bucket at **23 071 chars** using
13
+ P1.3 projected the post-condensation kernel bucket at **23 071 chars** using
14
14
  the median pilot ratio r=0.712 (3 pilots: agent-authority, direct-answers,
15
15
  language-and-tone). Pilot rules were **short to medium** (1.0k–2.5k baseline).
16
16
 
17
- P2.2 applied the same compression discipline to the remaining 6 kernel rules
17
+ P2.2 applied the same condensation discipline to the remaining 6 kernel rules
18
18
  (ask-when-uncertain, commit-policy, no-cheap-questions,
19
19
  non-destructive-by-default, scope-control, plus the verify-before-complete
20
20
  auto-tier rule kept by ADR-001). Iron-Law SHA preservation verified for
21
21
  all 8 rules with Iron-Law fences (`scripts/iron_law_sha.py`).
22
22
 
23
- **Empirical post-compression measurements (2026-05-06):**
23
+ **Empirical post-condensation measurements (2026-05-06):**
24
24
 
25
25
  | metric | projected | actual |
26
26
  |---|---:|---:|
27
27
  | kernel bucket sum | 23 071 | **25 590** |
28
- | compression ratio r (kernel-wide) | 0.712 (median pilot) | **0.795** |
28
+ | condensation ratio r (kernel-wide) | 0.712 (median pilot) | **0.795** |
29
29
  | rules > 2.5k cap | 2 (pilots) | 6 |
30
30
  | rules > 4.0k ceiling | 0 | 0 |
31
31
 
32
32
  The actual ratio (0.795) is worse than the pilot median (0.712) because
33
- **longer rules compress less efficiently than short ones**: each Iron-Law
33
+ **longer rules condense less efficiently than short ones**: each Iron-Law
34
34
  rule has a fixed payload of frontmatter, Iron-Law fence, exception
35
35
  enumeration, see-also list — shrinkage is bounded by what cannot leave
36
36
  the rule without breaking the rule's contract. The 5 longest source rules
@@ -61,7 +61,7 @@ enumeration + pre-send self-check + decline/fence semantics).
61
61
  | `direct-answers` | 2 841 | +341 | ✓ |
62
62
 
63
63
  3. **Cap stays sticky.** Future kernel additions or rule-body growth must
64
- either (a) compress within the 26k bucket, (b) externalise to a
64
+ either (a) condense within the 26k bucket, (b) externalise to a
65
65
  `contexts/authority/*` companion, or (c) require a follow-up ADR.
66
66
 
67
67
  ## Rationale
@@ -92,23 +92,23 @@ place.
92
92
  The `commit-policy` rule was trimmed below 2.5k (2 354 chars) by removing
93
93
  a redundant cross-reference line, demonstrating that aggressive trimming
94
94
  is possible where the rule does not carry an enumeration. The 6 overrides
95
- are the rules where further compression would force semantic loss.
95
+ are the rules where further condensation would force semantic loss.
96
96
 
97
97
  ## Consequences
98
98
 
99
99
  - **Pro:** Iron-Law fidelity preserved — every fence still byte-identical
100
100
  to baseline (verified by `iron_law_sha.py --all-kernel`).
101
- - **Pro:** Empirical compression r=0.795 documented; future kernel work
101
+ - **Pro:** Empirical condensation r=0.795 documented; future kernel work
102
102
  uses this as the realistic ratio (not 0.712, which was a pilot-skewed
103
103
  optimum).
104
104
  - **Pro:** Override ceiling (4 000) untouched — no rule grows
105
105
  unboundedly; the 4k cap remains the next checkpoint.
106
106
  - **Con:** 25 590 / 26 000 = 98.4 % bucket utilisation. Adding any
107
- 10th kernel rule would require either compression of an existing rule
107
+ 10th kernel rule would require either condensation of an existing rule
108
108
  or a further cap raise.
109
109
  - **Con:** ratio 0.795 means future "always" promotions cost more than
110
110
  Phase 1 estimated. Phase 4 token-budget measurements should treat
111
- 0.795 as the reference compression rate.
111
+ 0.795 as the reference condensation rate.
112
112
 
113
113
  ## Rollback
114
114
 
@@ -120,7 +120,7 @@ ceiling.
120
120
 
121
121
  - [`docs/contracts/command-clusters.md`](../contracts/command-clusters.md)
122
122
  — locked cluster set + sub-command naming contract.
123
- - [`.agent-src.uncompressed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md`](../../.agent-src.uncompressed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md)
123
+ - [`.agent-src.uncondensed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md`](../../.agent-src.uncondensed/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md)
124
124
  — runtime routing semantics and the colon-canonical rule.
125
- - [`.agent-src.uncompressed/contexts/execution/roadmap-process-loop.md`](../../.agent-src.uncompressed/contexts/execution/roadmap-process-loop.md)
125
+ - [`.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md`](../../.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md)
126
126
  — the shared mechanics that motivated the cluster shape.
@@ -234,7 +234,7 @@ documentation rewrite for marginal additional savings.
234
234
  (Phase 5.4 R3 raw debate)
235
235
  - `docs/decisions/ADR-rule-kernel-and-router.md` (kernel-membership
236
236
  contract — Phase 5 changes leave kernel untouched per Lever C lock)
237
- - `.agent-src.uncompressed/rules/guidelines.md` (deprecated subject)
238
- - `.agent-src.uncompressed/rules/size-enforcement.md` (merged subject)
239
- - `.agent-src.uncompressed/rules/package-ci-checks.md` (demoted subject)
240
- - `.agent-src.uncompressed/rules/analysis-skill-routing.md` (demoted subject)
237
+ - `.agent-src.uncondensed/rules/guidelines.md` (deprecated subject)
238
+ - `.agent-src.uncondensed/rules/size-enforcement.md` (merged subject)
239
+ - `.agent-src.uncondensed/rules/package-ci-checks.md` (demoted subject)
240
+ - `.agent-src.uncondensed/rules/analysis-skill-routing.md` (demoted subject)
@@ -21,7 +21,7 @@ and specialist review lenses. Step A7 derives from council iter-1
21
21
  verdict **CC-OQ1 (a)** — adopt the AgentHub pattern from
22
22
  `claude-skills` (per-candidate git-worktree isolation) into the
23
23
  existing `subagent-orchestration` skill **without** weakening the
24
- [`non-destructive-by-default`](../../.agent-src.uncompressed/rules/non-destructive-by-default.md)
24
+ [`non-destructive-by-default`](../../.agent-src.uncondensed/rules/non-destructive-by-default.md)
25
25
  Hard Floor.
26
26
 
27
27
  The AgentHub pattern in its native form is appealing: spawn N
@@ -49,13 +49,13 @@ variant** under three Hard-Floor-derived rules:
49
49
  branch into the integration branch. The user invokes the merge
50
50
  explicitly (e.g. `/finishing-a-development-branch`), or the
51
51
  orchestrator hands back with a numbered-options block per
52
- [`user-interaction`](../../.agent-src.uncompressed/rules/user-interaction.md).
52
+ [`user-interaction`](../../.agent-src.uncondensed/rules/user-interaction.md).
53
53
  2. **Ranked presentation.** Judge ranks candidates 1..N with a
54
54
  one-line justification per rank. The judge does **not** apply
55
55
  anything; ranking is the only output.
56
56
  3. **Loser worktrees stay.** The orchestrator does not delete
57
57
  losing worktrees automatically. Cleanup happens via
58
- [`finishing-a-development-branch`](../../.agent-src.uncompressed/skills/finishing-a-development-branch/SKILL.md)
58
+ [`finishing-a-development-branch`](../../.agent-src.uncondensed/skills/finishing-a-development-branch/SKILL.md)
59
59
  on user request, after harvesting any salvageable partial idea.
60
60
 
61
61
  Mode 7's chained-handoff variant is unchanged. The two variants
@@ -114,7 +114,7 @@ Both conditions must hold. Either alone is insufficient.
114
114
 
115
115
  - `agents/roadmaps/road-to-better-skills-and-profiles.md` § A7
116
116
  (council iter-1 CC-OQ1 verdict (a))
117
- - `.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md` § Mode 7
118
- - `.agent-src.uncompressed/skills/using-git-worktrees/SKILL.md` (mechanics layer)
119
- - `.agent-src.uncompressed/rules/non-destructive-by-default.md` § Hard Floor catalog
120
- - `.agent-src.uncompressed/skills/finishing-a-development-branch/SKILL.md` (cleanup path)
117
+ - `.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md` § Mode 7
118
+ - `.agent-src.uncondensed/skills/using-git-worktrees/SKILL.md` (mechanics layer)
119
+ - `.agent-src.uncondensed/rules/non-destructive-by-default.md` § Hard Floor catalog
120
+ - `.agent-src.uncondensed/skills/finishing-a-development-branch/SKILL.md` (cleanup path)
@@ -76,17 +76,17 @@ this — they are a single execution surface.
76
76
 
77
77
  ## Consequences
78
78
 
79
- ### (i) What stays under `.agent-src.uncompressed/` today
79
+ ### (i) What stays under `.agent-src.uncondensed/` today
80
80
 
81
81
  The complete video capability stays in the existing flat layout —
82
82
  no path changes, no symlink relocation, no namespace prefix:
83
83
 
84
- - `.agent-src.uncompressed/skills/{character-consistency,motion-choreographer,pixar-storyteller,scene-expander,video-director}/`
85
- - `.agent-src.uncompressed/personas/{ai-video-technical-director,hollywood-director}.md`
84
+ - `.agent-src.uncondensed/skills/{character-consistency,motion-choreographer,pixar-storyteller,scene-expander,video-director}/`
85
+ - `.agent-src.uncondensed/personas/{ai-video-technical-director,hollywood-director}.md`
86
86
  (the third video persona, `pixar-storyboard-artist`, was folded
87
87
  into `skills/pixar-storyteller/` per the persona-cap council pass
88
88
  recorded in `persona-governance`)
89
- - `.agent-src.uncompressed/commands/video/{from-script,scene,storyboard,stitch}.md`
89
+ - `.agent-src.uncondensed/commands/video/{from-script,scene,storyboard,stitch}.md`
90
90
  - `scripts/ai-video/` (the 5 adapter scripts + `lib/`)
91
91
  - `agents/settings/policies/media/` (Phase 2 output — already structured as
92
92
  a project-local policy directory, *not* a pack)
@@ -146,8 +146,8 @@ for ambiguity:
146
146
 
147
147
  - The five video adapters (`gemini-veo`, `kling`, `openai-images`,
148
148
  `higgsfield`, `sora`) — stay in `scripts/ai-video/`.
149
- - The two remaining video personas — stay in `.agent-src.uncompressed/personas/`.
150
- - The `/video:*` command cluster — stays in `.agent-src.uncompressed/commands/video/`.
149
+ - The two remaining video personas — stay in `.agent-src.uncondensed/personas/`.
150
+ - The `/video:*` command cluster — stays in `.agent-src.uncondensed/commands/video/`.
151
151
  - The `media-governance-routing` rule + `agents/settings/policies/media/`
152
152
  policy files — stay where Phase 2 placed them.
153
153
  - The provider-lifecycle contract + the `provider-lifecycle-discipline`
@@ -142,7 +142,7 @@ matching `config/discovery/packs.yml` row in the same PR.
142
142
  are accepted; the scanner emits `unassigned[]` warnings; CI logs but
143
143
  does not fail.
144
144
  - **Phase 4**: every artefact under
145
- `.agent-src.uncompressed/{skills,rules,commands,templates}` either
145
+ `.agent-src.uncondensed/{skills,rules,commands,templates}` either
146
146
  declares the new keys, or sits in `config/discovery/unassigned-artefacts.yml`
147
147
  with a one-line reason.
148
148
  - **Phase 4+**: CI flips strict; missing annotation is a fail.
@@ -150,7 +150,7 @@ matching `config/discovery/packs.yml` row in the same PR.
150
150
  ### Trust-root allow-list (security-engineer council fold-in)
151
151
 
152
152
  The scanner honours frontmatter only on files under the trusted roots:
153
- `.augment/`, `.claude/`, `.agent-src.uncompressed/`, `.agent-src/`.
153
+ `.augment/`, `.claude/`, `.agent-src.uncondensed/`, `.agent-src/`.
154
154
  Files under `agents/`, `tmp/`, or any consumer-writable path **cannot**
155
155
  claim ownership of a workspace or pack. Phase 2 enforces.
156
156
 
@@ -201,7 +201,7 @@ discovery-driven action.
201
201
 
202
202
  The five required keys (`workspaces`, `packs`, `lifecycle`, `trust`,
203
203
  `install`) are now **strictly enforced** across every artefact under
204
- `.agent-src.uncompressed/{skills,rules,commands,templates}` by
204
+ `.agent-src.uncondensed/{skills,rules,commands,templates}` by
205
205
  [`scripts/lint_artefact_frontmatter.py`](../../scripts/lint_artefact_frontmatter.py),
206
206
  wired into `task lint-artefact-frontmatter`, `task ci`, and the opt-in
207
207
  combined pre-commit hook (`./agent-config hooks:install`). The migration
@@ -66,10 +66,10 @@ install-axis without a current consumer. Re-evaluate in Phase 5.
66
66
 
67
67
  ### Source-of-truth tree
68
68
 
69
- The generator walks `.agent-src.uncompressed/`, **not** `.agent-src/`.
70
- The Phase-2 roadmap text §Phase 2 says "the compressed canonical tree"
69
+ The generator walks `.agent-src.uncondensed/`, **not** `.agent-src/`.
70
+ The Phase-2 roadmap text §Phase 2 says "the condensed canonical tree"
71
71
  — that is a documentation slip. `augment-source-of-truth` rule states
72
- that uncompressed is canonical; the compressed tree is a build output
72
+ that uncondensed is canonical; the condensed tree is a build output
73
73
  and may be regenerated. Manifest pipelines that read build outputs are
74
74
  fragile to bootstrap order.
75
75
 
@@ -36,7 +36,7 @@ TypeScript installer **without** moving a single file. The on-disk
36
36
  source tree is still flat:
37
37
 
38
38
  ```text
39
- .agent-src.uncompressed/
39
+ .agent-src.uncondensed/
40
40
  rules/ # 72 entries
41
41
  skills/ # 218 entries
42
42
  commands/ # 129 entries
@@ -64,11 +64,11 @@ refs, cross-pack drift, hand-edited paths) all bite hardest here.
64
64
  packages/
65
65
  core/
66
66
  installer/ # TS CLI (already there post-Phase 3)
67
- .agent-src.uncompressed/ # rules + kernel skills + scaffolds
68
- pack-php/.agent-src.uncompressed/
69
- pack-laravel/.agent-src.uncompressed/
67
+ .agent-src.uncondensed/ # rules + kernel skills + scaffolds
68
+ pack-php/.agent-src.uncondensed/
69
+ pack-laravel/.agent-src.uncondensed/
70
70
 
71
- pack-ai-video/.agent-src.uncompressed/
71
+ pack-ai-video/.agent-src.uncondensed/
72
72
  ```
73
73
 
74
74
  No flag day: every commit between "before" and "after" the move builds
@@ -98,7 +98,7 @@ Implemented in [`scripts/plan_physical_move.py`](../../scripts/plan_physical_mov
98
98
  6. **Quarantined scaffolds** (the 26 entries in
99
99
  [`config/discovery/unassigned-artefacts.yml`](../../config/discovery/unassigned-artefacts.yml))
100
100
  → `packages/core/` with `unassigned scaffold:` reason recorded in the
101
- move plan. The top-level `.agent-src.uncompressed/README.md` was added
101
+ move plan. The top-level `.agent-src.uncondensed/README.md` was added
102
102
  here during dry-run.
103
103
  7. **`primary pack: meta`** → `packages/core/` (package-internal
104
104
  scaffolding, not a real pack).
@@ -135,7 +135,7 @@ installer behaviour change.
135
135
  - Metadata-to-disk parity: a consumer can now `cd packages/pack-laravel`
136
136
  and see exactly what `pack.laravel` ships, no manifest indirection.
137
137
  - Phase 5 (trust) lands cleanly inside `packages/core/installer/` and
138
- reads per-pack metadata from `packages/pack-*/.agent-src.uncompressed/`.
138
+ reads per-pack metadata from `packages/pack-*/.agent-src.uncondensed/`.
139
139
  - Phase 6 (browser wizard) maps packs 1:1 to its left-nav.
140
140
  - Cross-pack drift is now lintable (`task lint-pack-boundaries` in
141
141
  Phase 4.4 of the roadmap).
@@ -172,11 +172,11 @@ installer behaviour change.
172
172
  Four blocking items and two refinements raised by the council; each
173
173
  resolved before `--apply` runs.
174
174
 
175
- ### B1 — Final source location of `.agent-src.uncompressed/`
175
+ ### B1 — Final source location of `.agent-src.uncondensed/`
176
176
 
177
177
  The council asked whether the source tree nests inside `packages/core/`
178
178
  (current design) or becomes a peer `pack-core/`. **Decision: keep
179
- `packages/core/.agent-src.uncompressed/`.** Three reasons:
179
+ `packages/core/.agent-src.uncondensed/`.** Three reasons:
180
180
 
181
181
  1. `packages/core/` is the engine + installer + kernel rules +
182
182
  scaffolding (templates, profiles, presets, contexts, user-types).
@@ -199,7 +199,7 @@ similarity) on every moved file. Verification script enforces this.
199
199
 
200
200
  ### B3 — Consumer-facing output contract
201
201
 
202
- `task sync` writes `.agent-src/` (compressed) and `.augment/` (overlay)
202
+ `task sync` writes `.agent-src/` (condensed) and `.augment/` (overlay)
203
203
  at repo root — **unchanged** location and structure. The byte-identity
204
204
  contract covers exactly these two trees plus the discovery manifest.
205
205
  What changes:
@@ -16,7 +16,7 @@ type: prospective
16
16
  **Accepted** · 2026-05-21 · external AI Council pass on the Phase 5
17
17
  roadmap (`claude-sonnet-4-5` + `gpt-4o`, `design` lens). Council
18
18
  confirmed the closed-enum trust ladder, the per-pack safety-floor
19
- rule, and the compressor-injected HRR banner; refinement folded into
19
+ rule, and the condenseor-injected HRR banner; refinement folded into
20
20
  the lint script and the installer's confirm copy.
21
21
 
22
22
  Session: [`agents/runtime/council/responses/phase-5-trust-safety.json`](../../agents/runtime/council/responses/phase-5-trust-safety.json) <!-- council-ref-allowed: ADR decision-trace -->
@@ -25,7 +25,7 @@ Companion artefacts:
25
25
  - Contract: [`docs/contracts/trust-and-safety.md`](../contracts/trust-and-safety.md)
26
26
  - Roadmap: [`agents/roadmaps/monorepo-phase-5-trust-safety-layer.md`](../../agents/roadmaps/monorepo-phase-5-trust-safety-layer.md)
27
27
  - Lint: [`scripts/lint_trust_coherence.py`](../../scripts/lint_trust_coherence.py) + [`tests/test_lint_trust_coherence.py`](../../tests/test_lint_trust_coherence.py)
28
- - Compressor: [`scripts/compress.py`](../../scripts/compress.py) (`_inject_hrr_banner`)
28
+ - Condenseor: [`scripts/condense.py`](../../scripts/condense.py) (`_inject_hrr_banner`)
29
29
  - Installer: [`packages/core/installer/src/trust-escalation.ts`](../../packages/core/installer/src/trust-escalation.ts)
30
30
 
31
31
  ## Context
@@ -44,7 +44,7 @@ After Phase 4 we had the **metadata** end-to-end but **no enforcement**:
44
44
  - Installer treated all packs identically — no surface for advisory
45
45
  content, no confirm step before opting into legally-flavoured
46
46
  finance / strategy material.
47
- - Compressor preserved frontmatter but did not propagate the
47
+ - Condenseor preserved frontmatter but did not propagate the
48
48
  `human_review_required` signal into the compiled artefact, so the
49
49
  runtime had no parser-stable hook to gate output on.
50
50
  - Domain-specific safety floors (finance, founder-strategy,
@@ -70,10 +70,10 @@ Ship a four-piece trust & safety layer:
70
70
  1. **Closed-enum trust ladder.** `core` · `professional` · `advisory`
71
71
  · `restricted` · `experimental`. Authoritative table and meaning
72
72
  live in [`trust-and-safety § 1`](../contracts/trust-and-safety.md#-1--trust-levels).
73
- 2. **HRR banner injection.** The compressor scans frontmatter and
73
+ 2. **HRR banner injection.** The condenseor scans frontmatter and
74
74
  prepends `<!-- agent-config:human-review-banner -->\n> HUMAN REVIEW
75
75
  REQUIRED · trust: <level> · owner: <domain>` to any artefact with
76
- `trust.human_review_required: true`. Idempotent on re-compression.
76
+ `trust.human_review_required: true`. Idempotent on re-condensation.
77
77
  3. **Per-pack safety-floor rules.** `core` ships
78
78
  `engineering-safety-floor.md`; `pack-finance-basic` ships
79
79
  `finance-safety-floor.md`; `pack-founder-strategy` ships
@@ -97,7 +97,7 @@ Ship a four-piece trust & safety layer:
97
97
  ### Good
98
98
 
99
99
  - **Single source of trust truth.** The frontmatter field is the
100
- one input; the installer, compressor, lint, and runtime all read
100
+ one input; the installer, condenseor, lint, and runtime all read
101
101
  it. No parallel registry, no duplicated copy.
102
102
  - **Banner is parser-stable.** The HTML-comment marker survives every
103
103
  downstream surface (Augment, Claude, Cursor, Windsurf) because it is
@@ -101,8 +101,8 @@ Rationale:
101
101
  `docs/contracts/explain-trace.schema.json`,
102
102
  `docs/adrs/router/0001-three-tier-routing.md`,
103
103
  `docs/adrs/smoke/0001-per-tier-smoke-scripts.md`.
104
- - **Source rules.** Uncompressed rule sources referencing the path
105
- (`caveman-speak.md`, `git-history-discipline.md`) updated and
104
+ - **Source rules.** Uncondensed rule sources referencing the path
105
+ (`telegraph-speak.md`, `git-history-discipline.md`) updated and
106
106
  re-projected.
107
107
 
108
108
  ## Reversal cost
@@ -25,7 +25,7 @@ Companion artefacts:
25
25
  - Wizard contract: [`docs/contracts/gui-wizard.md`](../contracts/gui-wizard.md)
26
26
  - Predecessor ADR: [`ADR-007`](ADR-007-agent-discovery-scopes.md) — scope precedence, global-default amendment
27
27
  - Perms entry-gate: [`scripts/lint_global_paths.py`](../../scripts/lint_global_paths.py)
28
- - Payload schema: [`schemas/wizard-apply-payload.schema.json`](../../schemas/wizard-apply-payload.schema.json)
28
+ - Payload schema: [`internal/schemas/wizard-apply-payload.schema.json`](../../internal/schemas/wizard-apply-payload.schema.json)
29
29
 
30
30
  ## Context
31
31
 
@@ -65,7 +65,7 @@ fanning out from there.
65
65
 
66
66
  The single project-local exception is `agents/overrides/`, which
67
67
  remains the canonical place to override or extend a shared skill /
68
- rule / command per [override-management](../../.agent-src.uncompressed/skills/override-management/SKILL.md).
68
+ rule / command per [override-management](../../.agent-src.uncondensed/skills/override-management/SKILL.md).
69
69
 
70
70
  The maintainer-side dev experience is preserved by the
71
71
  `AGENT_CONFIG_DEV_MODE=1` environment gate documented in
@@ -25,7 +25,7 @@ Companion artefacts:
25
25
  - Roadmap: [`agents/roadmaps/road-to-internal-ai-os-deployment.md`](../../agents/roadmaps/road-to-internal-ai-os-deployment.md)
26
26
  - Artefacts: [`packages/core/deploy/`](../../packages/core/deploy/)
27
27
  - Env contract: [`docs/deploy/env-vars.md`](../deploy/env-vars.md)
28
- - Council question (drafted, not invoked — no keys): [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/council-question-deployment-shape.md)
28
+ - Council question (drafted, not invoked — no keys): [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/old/council-question-deployment-shape.md)
29
29
  - Predecessor ADR: [`ADR-016`](ADR-016-installer-architecture.md) — installer architecture (agent-mode protocol the GUI server wraps).
30
30
 
31
31
  ## Context
@@ -64,7 +64,7 @@ their own chart using this Compose as the reference until v2 ships.
64
64
  The GUI server (`packages/core/installer/src/gui/server.ts`) is the
65
65
  only long-running process. The Python install supervisor is spawned
66
66
  per-install, not a sidecar. The Compose image stays Node-only to keep
67
- the budget under 600 MB compressed and the surface area minimal.
67
+ the budget under 600 MB condensed and the surface area minimal.
68
68
 
69
69
  If Phase 2+ needs a separate identity-broker process, it lands in a
70
70
  separate service in the same Compose; the agent-config container stays
@@ -141,7 +141,7 @@ orchestrator-agnostic.
141
141
  ## Open questions (council-deferred)
142
142
 
143
143
  The accompanying council question file
144
- [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/council-question-deployment-shape.md)
144
+ [`agents/tmp/council-question-deployment-shape.md`](../../agents/tmp/old/council-question-deployment-shape.md)
145
145
  has not yet been run (no provider keys configured). A maintainer with
146
146
  keys should run it and either ratify or supersede this ADR.
147
147
 
@@ -31,7 +31,7 @@ Companion artefacts:
31
31
 
32
32
  - Roadmap: [`agents/roadmaps/road-to-employee-product-and-external-proof.md`](../../agents/roadmaps/road-to-employee-product-and-external-proof.md)
33
33
  - Council question: [`agents/decisions/open-questions/daily-workspace-shape.md`](../../agents/decisions/open-questions/daily-workspace-shape.md)
34
- - Council verdict: `agents/runtime/council/responses/daily-workspace-shape.json` (gitignored)
34
+ - Council verdict: `agents/runtime/council/responses/daily-workspace-shape.json` (gitignored) <!-- council-ref-allowed: ADR decision trace -->
35
35
  - Predecessor ADRs: [`ADR-014`](ADR-014-gui-framework-choice.md) (installer chrome), [`ADR-016`](ADR-016-installer-architecture.md) (installer architecture), [`ADR-020`](ADR-020-global-only-consumer-scope.md) (consumer scope).
36
36
 
37
37
  ## Context
@@ -57,7 +57,7 @@ of narrative + bullets in the current convention):
57
57
  |---|---:|---:|---:|
58
58
  | **Token budget per release** | ~2.8k (141 lines × ~80 chars) | ~1.1k (38 commits × ~120 chars) | ~2.6k (same as current; bullets generated, paragraph hand-written) |
59
59
  | **Maintainer minutes per release** | 5–15 (write narrative; auto-split runs in `task release`) | 0 direct + ~30/month policing commit messages | 5–10 (paragraph only) |
60
- | **Information density per line** | high — narrative compresses 5–10 bullets of context | low — every infrastructure commit becomes a line | high — same as current |
60
+ | **Information density per line** | high — narrative condenses 5–10 bullets of context | low — every infrastructure commit becomes a line | high — same as current |
61
61
  | **Parseability for downstream agents** | high — `### Features` / `### Fixes` / `### BREAKING` are semantic anchors | medium — same headings, but no narrative anchor to disambiguate scope churn | high |
62
62
  | **Hands-off failure mode** | era over-cap → auto-split fires | commit-message drift pollutes the log → no recovery without rewriting commits | narrative drift → degrades to release-please equivalent |
63
63
 
@@ -123,7 +123,7 @@ entries over a flat commit dump.
123
123
 
124
124
  - [`docs/contracts/CHANGELOG-conventions.md`](../contracts/CHANGELOG-conventions.md) — convention being confirmed.
125
125
  - [`agents/roadmaps/archive/road-to-changelog-era-auto-split.md`](../../agents/roadmaps/archive/road-to-changelog-era-auto-split.md) — closes Phase 4.
126
- - [`agents/runtime/council/responses/changelog-era-split-2026-05-25.json`](../../agents/runtime/council/responses/changelog-era-split-2026-05-25.json) — the originating council synthesis.
126
+ - [`agents/runtime/council/responses/changelog-era-split-2026-05-25.json`](../../agents/runtime/council/responses/changelog-era-split-2026-05-25.json) — the originating council synthesis. <!-- council-ref-allowed: ADR decision trace -->
127
127
  - `scripts/_lib/changelog_eras.py` — shared cap + splitter (Tier 2 output).
128
128
  - `scripts/release.py:818` — `plan.changelog_body` → GitHub Release notes wire.
129
129
  - `tests/test_changelog_eras.py`, `tests/test_changelog_split.py` — gate + splitter coverage.
@@ -15,7 +15,7 @@ review_date: 2027-05-25
15
15
  ## Status
16
16
 
17
17
  **Accepted** · 2026-05-25. Encodes the AI Council verdict from
18
- [`root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md)
18
+ [`root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) <!-- council-ref-allowed: ADR decision trace -->
19
19
  and opens
20
20
  [`road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) (archived; complete).
21
21
  Time-boxed: review on **2027-05-25** or earlier if any trigger below fires.
@@ -48,7 +48,7 @@ conditional follow-up gated by evidence the package does not yet have.
48
48
  Re-audit of `bench/`, `evals/`, `workers/`, `user-types/` against the
49
49
  installer / projector / CI:
50
50
 
51
- | Dir | `scripts/install.py` | `scripts/compress.py` projection | `.github/workflows/*` | Verdict |
51
+ | Dir | `scripts/install.py` | `scripts/condense.py` projection | `.github/workflows/*` | Verdict |
52
52
  |---|---|---|---|---|
53
53
  | `bench/` | — | — | `bench-drift.yml` (path filter) | **movable** |
54
54
  | `evals/` | — | — | — | **movable** |
@@ -91,7 +91,7 @@ Four audits must complete and pass before Phase 3 opens:
91
91
  `scripts/`, `templates/`, `config/`, `schemas/` references.
92
92
  2. **Symlink-mobility test** — verify Cursor / Claude / Windsurf
93
93
  honor symlinked projections (`.cursor/` → `./projections/.cursor/`).
94
- 3. **Hash-sequencing audit** — confirm `.compression-hashes.json`
94
+ 3. **Hash-sequencing audit** — confirm `.condensation-hashes.json`
95
95
  uses paths that survive `.agent-src/` relocation (or document the
96
96
  regeneration migration).
97
97
  4. **CI-path audit** — every hardcoded path in
@@ -131,17 +131,17 @@ blocker.
131
131
  |---|---|
132
132
  | Move everything into `./src/` (original request) | `./src/` is the TS app per ADR-012/016. Collision. |
133
133
  | Option 2 — `./tooling/` umbrella with `templates/` / `config/` / `schemas/` | Council: cost underestimated (duplicate-then-deprecate + 2-month window + major bump); installer paths in those dirs are unaudited. |
134
- | Option 3 — full category-coded migration | Council hard-reject: projection mobility unproven; compression-hash sequencing risk; unshippable without symlink test. |
134
+ | Option 3 — full category-coded migration | Council hard-reject: projection mobility unproven; condensation-hash sequencing risk; unshippable without symlink test. |
135
135
  | Option 4 — `MAP.md` documentation | Council: adds 51st entry; documentation-as-apology; AGENTS.md already serves this role. |
136
136
  | Skip Phase 1, jump to multi-workspace prototype | Loses the cheap visible win; Phase 2 audits unfunded; risks scope creep into Phase 3. |
137
137
 
138
138
  ## References
139
139
 
140
- - [`agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md`](../../agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md) — council brief.
141
- - [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) — full synthesis.
140
+ - [`agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md`](../../agents/runtime/council/questions/root-cleanup-organizing-principle-2026-05-25.md) — council brief. <!-- council-ref-allowed: ADR decision trace -->
141
+ - [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) — full synthesis. <!-- council-ref-allowed: ADR decision trace -->
142
142
  - [`agents/roadmaps/archive/road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) — execution roadmap (archived; Phase 1 ✅, Phase 2 ✅, Phase 3 closed).
143
143
  - [`agents/evidence/audits/2026-05-root-layout-phase2/`](../../agents/evidence/audits/2026-05-root-layout-phase2/) — Phase 2 audit verdict bundle.
144
144
  - [`ADR-029`](ADR-029-multi-workspace-deferred.md) — Phase 3 close-out (multi-workspace deferred indefinitely).
145
145
  - [`ADR-012`](ADR-012-typescript-cli-shell.md), [`ADR-016`](ADR-016-installer-architecture.md) — `./src/` is the TS app.
146
146
  - [`ADR-019`](ADR-019-router-json-dist-location.md) — `router.json` lives in `./dist/`.
147
- - `scripts/install.py:52` (`USER_TYPES_DIR`), `scripts/compress.py:1106` (`AUGMENT_SYMLINK_DIRS`) — evidence pinning `user-types/` to root.
147
+ - `scripts/install.py:52` (`USER_TYPES_DIR`), `scripts/condense.py:1106` (`AUGMENT_SYMLINK_DIRS`) — evidence pinning `user-types/` to root.
@@ -118,5 +118,5 @@ Phase 3 becomes eligible when **all** of these hold:
118
118
  full audit bundle (4 verdict files + README).
119
119
  - [`agents/roadmaps/archive/road-to-root-layout-cleanup.md`](../../agents/roadmaps/archive/road-to-root-layout-cleanup.md) —
120
120
  execution roadmap, archived (Phase 1 ✅, Phase 2 ✅, Phase 3 closed via this ADR).
121
- - [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md)
122
- original council synthesis that proposed the multi-workspace shape.
121
+ - [`agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md`](../../agents/runtime/council/sessions/root-cleanup-organizing-principle-2026-05-25.synthesis.md) <!-- council-ref-allowed: ADR decision trace -->
122
+ original council synthesis that proposed the multi-workspace shape.