@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
@@ -15,7 +15,7 @@
15
15
  # ADR-002 (2026-05-06) — kernel-bucket cap raise + per-rule overrides.
16
16
  # Source: docs/decisions/ADR-002-kernel-bucket-overrides.md
17
17
  # Empirical r_actual=0.795 vs r_projected=0.712. The 6 rules below carry
18
- # Iron-Law fences + non-externalisable enumerations; further compression
18
+ # Iron-Law fences + non-externalisable enumerations; further condensation
19
19
  # would force semantic loss. All sit ≤ 4 000-char override ceiling.
20
20
  ask-when-uncertain
21
21
  direct-answers
@@ -10,7 +10,7 @@ keep-beta-until: 2026-08-12
10
10
  > · **Source of truth:** `docs/contracts/rule-classification.md` § 3.1
11
11
  > · **Pilot artifacts:** `docs/contracts/pilot/`
12
12
 
13
- Locks the kernel set and the empirical compression rate `r` derived
13
+ Locks the kernel set and the empirical condensation rate `r` derived
14
14
  from the P1.3 pilot. Phase 2.2 executes against this contract.
15
15
 
16
16
  ## § 1 — Inclusion criteria (kernel-only)
@@ -37,7 +37,7 @@ A rule belongs in the kernel iff it satisfies **all** of:
37
37
  `no-cheap-questions` are first-class kernel members even though
38
38
  they fire during deliberation, not strictly pre-send.)*
39
39
 
40
- All other rules → `compress-and-keep` (auto-tier) or migrate to
40
+ All other rules → `condense-and-keep` (auto-tier) or migrate to
41
41
  skill / guideline per `rule-classification.md`.
42
42
 
43
43
  > **Council amendment (P1.4).** Criterion #3 originally read "must be
@@ -49,12 +49,12 @@ skill / guideline per `rule-classification.md`.
49
49
  > existing 9-rule kernel set. See
50
50
  > `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json`. <!-- council-ref-allowed: contract decision trace -->
51
51
 
52
- ## § 2 — Empirical compression rate (pilot)
52
+ ## § 2 — Empirical condensation rate (pilot)
53
53
 
54
54
  Pilot picks (per P1.3 algorithm: shortest / median / longest of the 9
55
55
  always-rules in `rule-classification.md` § 3.1):
56
56
 
57
- | pilot | original | compressed | r | per-rule cap (2.5k) | Iron-Law SHA |
57
+ | pilot | original | condensed | r | per-rule cap (2.5k) | Iron-Law SHA |
58
58
  |---|---:|---:|---:|---|---|
59
59
  | agent-authority | 1217 | 1020 | 0.838 | OK | match (`e3b0c442…`) |
60
60
  | direct-answers | 3991 | 2841 | 0.712 | +341 over | match (`ef438530…`) |
@@ -65,21 +65,21 @@ always-rules in `rule-classification.md` § 3.1):
65
65
  | mean r (outlier-skewed by lean pilot) | 0.742 |
66
66
  | **median r** (locked for projection) | **0.712** |
67
67
  | max r (already-lean floor) | 0.838 |
68
- | min r (most compressible) | 0.677 |
68
+ | min r (most condensable) | 0.677 |
69
69
 
70
70
  Locked `r = 0.712` (median) for P2.2 projection. Council amendment
71
71
  (P1.4) — the original lock was the **mean** (0.742), but Sonnet 4.5
72
72
  flagged outlier skew: `agent-authority` at 1217 chars pre-pilot was
73
- already near the compression floor (`r = 0.838`), pulling the mean
73
+ already near the condensation floor (`r = 0.838`), pulling the mean
74
74
  above the typical band. Median (0.712) is robust to the lean
75
75
  outlier and sits inside the roadmap-stated 0.6–0.75 band. Risk
76
- asymmetry confirms the choice: under-estimating compressed size
76
+ asymmetry confirms the choice: under-estimating condensed size
77
77
  blows the 25k cap mid-P2.2 (no abort path); over-estimating just
78
78
  yields headroom. GPT-4o concurred. Source:
79
79
  `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json`. <!-- council-ref-allowed: contract decision trace -->
80
80
 
81
81
  **Pilot caveat — already-lean floor.** `agent-authority` (1217 chars
82
- pre-pilot) yielded only `r = 0.838`. Pre-compressed rules give less
82
+ pre-pilot) yielded only `r = 0.838`. Pre-condensed rules give less
83
83
  back; rules > 3k chars give more back. Future kernel additions
84
84
  ≤ 1.5k chars should not assume the median — they may already be at
85
85
  floor.
@@ -117,7 +117,7 @@ absorbs pilot variance for the 6 untested rules.
117
117
 
118
118
  ### § 4.1 — Post-P2.2 locked kernel (empirical, 2026-05-06)
119
119
 
120
- P2.2 applied compression (imperative rewrite, examples → guidelines,
120
+ P2.2 applied condensation (imperative rewrite, examples → guidelines,
121
121
  rationale → contexts) + verified Iron-Law fence preservation.
122
122
  Empirical r=0.795 (vs 0.712 projected). Bucket cap raised 25k → 26k
123
123
  via `docs/decisions/ADR-002-kernel-bucket-overrides.md`. Six rules
@@ -164,7 +164,7 @@ until the next kernel re-measurement.
164
164
 
165
165
  † **agent-authority swap candidate (P1.4 ADR).** Sonnet 4.5 argues
166
166
  this is a routing index (zero Iron Law fences, dispatches to other
167
- kernel rules) and should be `compress-and-keep` (auto-tier-3),
167
+ kernel rules) and should be `condense-and-keep` (auto-tier-3),
168
168
  freeing 867 projected chars. The Council also recommends promoting
169
169
  `autonomous-execution` (5631 → 4009 projected) into kernel as a
170
170
  mode-independent Band-4 authority. Net effect: 23071 − 867 + 4009 =
@@ -191,10 +191,10 @@ Both Council members concurred — the original 1.5k figure forced 8 of
191
191
  The 2.5k cap fits 7 of 9 rules without ADR; only the two largest
192
192
  remain as legitimate Iron-Law-density exceptions.
193
193
 
194
- Rules that land **above the 2.5k per-rule cap** even after compression
194
+ Rules that land **above the 2.5k per-rule cap** even after condensation
195
195
  and Iron-Law preservation:
196
196
 
197
- | rule | post-compression chars | over-cap (2.5k) | reason cap cannot be hit |
197
+ | rule | post-condensation chars | over-cap (2.5k) | reason cap cannot be hit |
198
198
  |---|---:|---:|---|
199
199
  | direct-answers | 2842 | +342 | Three Iron-Law fences (≈ 470 chars) + severity-tiered claim table required for invented-facts gate |
200
200
  | language-and-tone | 3786 | +1286 | Iron-Law fence + exhaustive user-visible-prose catalog + pre-send gate are co-load-bearing |
@@ -204,12 +204,12 @@ and Iron-Law preservation:
204
204
  ADR (see § 5.2).
205
205
 
206
206
  Per roadmap § "Iron-Law over budget = ADR exception, not auto-
207
- compress" — these surface as `iron-law-override` exceptions for P2.1
207
+ condense" — these surface as `iron-law-override` exceptions for P2.1
208
208
  to gate behind ADRs in `docs/decisions/`.
209
209
 
210
210
  The remaining 6 always-rules project to 1669–2916 chars post-
211
- compression — all under the 2.5k cap with no ADR needed. P2.2
212
- measures the real post-compression sizes; if any breach the cap, an
211
+ condensation — all under the 2.5k cap with no ADR needed. P2.2
212
+ measures the real post-condensation sizes; if any breach the cap, an
213
213
  ADR lands per-rule.
214
214
 
215
215
  ### § 5.2 — Kernel-set swap ADR (agent-authority ↔ autonomous-execution)
@@ -236,19 +236,19 @@ clearing the way for the swap under a fresh ADR.
236
236
 
237
237
  ## § 6 — Abort criteria for P2.2
238
238
 
239
- **Council amendment (P1.4).** Sonnet 4.5 flagged that P2.2 compresses
239
+ **Council amendment (P1.4).** Sonnet 4.5 flagged that P2.2 condenses
240
240
  in place with no defined abort path. The following triggers force
241
241
  revert + re-projection rather than mid-phase scramble:
242
242
 
243
243
  - **Iron-Law drift.** Any kernel rule loses Iron-Law SHA equivalence
244
- after compression (whitespace-normalised, case-folded fence-block
245
- content). Single occurrence aborts the rule's compression.
246
- - **Bucket overflow.** Kernel sum post-compression > 27 500 chars
244
+ after condensation (whitespace-normalised, case-folded fence-block
245
+ content). Single occurrence aborts the rule's condensation.
246
+ - **Bucket overflow.** Kernel sum post-condensation > 27 500 chars
247
247
  (10 % over hard cap). Aborts the entire P2.2 phase.
248
- - **Single-rule runaway.** Any kernel rule post-compression
249
- > 4 000 chars. Aborts that rule's compression; flag for ADR.
248
+ - **Single-rule runaway.** Any kernel rule post-condensation
249
+ > 4 000 chars. Aborts that rule's condensation; flag for ADR.
250
250
  - **Empirical r drift.** Median of measured r across the first 4
251
- compressed rules deviates > 0.10 from the locked 0.712 (i.e.,
251
+ condensed rules deviates > 0.10 from the locked 0.712 (i.e.,
252
252
  measured median outside [0.612, 0.812]). P2.2 pauses, re-locks r,
253
253
  re-runs § 3 projection.
254
254
 
@@ -266,10 +266,10 @@ with the trigger-relaxed parameter, lock new value, re-attempt.
266
266
 
267
267
  ## § 8 — What this contract does NOT do
268
268
 
269
- - It does **not** edit any source rule. P2.2 ships compression to
270
- `.agent-src.uncompressed/rules/`.
269
+ - It does **not** edit any source rule. P2.2 ships condensation to
270
+ `.agent-src.uncondensed/rules/`.
271
271
  - It does **not** lock per-rule `chars` (only the bucket sum). Per-
272
- rule values are projections; P2.2 measures real post-compression.
272
+ rule values are projections; P2.2 measures real post-condensation.
273
273
  - It does **not** decide kernel additions. Adding a rule to the
274
274
  kernel requires an ADR per roadmap § "Sequencing-drift time-box"
275
275
  and re-runs P1.3 with the new candidate.
@@ -288,4 +288,4 @@ with the trigger-relaxed parameter, lock new value, re-attempt.
288
288
  | 2026-05-06 | `agents/runtime/council/sessions/20260506T044821Z-phase1-cross-check.json` | Council R1 (truncated at 1024 tokens) | <!-- council-ref-allowed: contract decision trace -->
289
289
  | 2026-05-06 | `agents/runtime/council/sessions/20260506T044941Z-phase1-cross-check-r2.json` | Council R2 (3500 tokens) — locks median r, splits criterion #3, adds criterion #5, raises per-rule cap to 2.5k, defines abort criteria | <!-- council-ref-allowed: contract decision trace -->
290
290
  | 2026-05-06 | this file | kernel set locked: 9 rules, projected 23 071 chars (median r = 0.712) |
291
- | 2026-05-06 | P2.2 compression + `scripts/iron_law_sha.py --all-kernel` | empirical: 25 590 chars (r_actual = 0.795 across kernel; longer rules compress less than the pilot median) — see `docs/decisions/ADR-002-kernel-bucket-overrides.md` (KERNEL_HARD raised 25k → 26k, 6 per-rule overrides ≤ 4k ceiling, all Iron-Law SHAs preserved) |
291
+ | 2026-05-06 | P2.2 condensation + `scripts/iron_law_sha.py --all-kernel` | empirical: 25 590 chars (r_actual = 0.795 across kernel; longer rules condense less than the pilot median) — see `docs/decisions/ADR-002-kernel-bucket-overrides.md` (KERNEL_HARD raised 25k → 26k, 6 per-rule overrides ≤ 4k ceiling, all Iron-Law SHAs preserved) |
@@ -130,7 +130,7 @@ persistence on cloud platforms; the rule is a no-op.
130
130
  partitions workspace / team / personal. Step 3 only needs to
131
131
  document the three-layer rationale for the README.
132
132
  - Re-classify on every audit run; if a rule is added to
133
- `.agent-src.uncompressed/rules/`, this document MUST gain a row.
133
+ `.agent-src.uncondensed/rules/`, this document MUST gain a row.
134
134
 
135
135
  ## Source of tier data
136
136
 
@@ -88,7 +88,7 @@ procedure → no warning under the new model. ✓ roadmap success criterion.
88
88
  success criterion.
89
89
 
90
90
  Of 13 commands ≥ 1000 words, only **2** lack a delegation signal —
91
- both are candidates for Phase 4.1 review (`compress.md`,
91
+ both are candidates for Phase 4.1 review (`condense.md`,
92
92
  `project-analyze.md`; the latter has density 0.86, exempt under the
93
93
  density-AND-delegation gate).
94
94
 
@@ -115,7 +115,7 @@ Calibration sweep on the 2026-05-08 corpus (310 artifacts):
115
115
  Pass rate: 186 → 209 (`pass`); 124 → 101 (`pass_with_warnings`); 0
116
116
  errors. Each remaining warning is a genuine structural defect:
117
117
 
118
- - `compress.md` (1569 words, density 0.58, no delegation signal) —
118
+ - `condense.md` (1569 words, density 0.58, no delegation signal) —
119
119
  inlined logic in a non-orchestrator command.
120
120
  - `artifact-drafting-protocol.md` rule (65 lines, density 0.37, no
121
121
  Iron-Law block) — prose-dominant long rule.
@@ -44,10 +44,10 @@ Where:
44
44
  (per [`load-context-schema.md`](load-context-schema.md)).
45
45
  - `transitive_closure` walks `load_context:` declarations on
46
46
  context files **up to depth 2** — see § Nesting cap below.
47
- - `RawSize` is the byte size of the compressed file
47
+ - `RawSize` is the byte size of the condensed file
48
48
  (`.agent-src/...`), measured by `os.path.getsize()`. The
49
- uncompressed source paths in frontmatter are mapped to their
50
- compressed counterparts before sizing.
49
+ uncondensed source paths in frontmatter are mapped to their
50
+ condensed counterparts before sizing.
51
51
  - A context loaded by N always-rules counts **N times** (once per
52
52
  loading rule). Rationale: the always-budget protects context-window
53
53
  utilization at activation time; if rule A and rule B both fire on
@@ -138,7 +138,7 @@ the full `RawSize(X)` under Model (b). No `chars(X) / N` discount.
138
138
  has no measurable upside.
139
139
  - Phase 4c (shared-context discount) becomes a no-op under 3a.
140
140
  Phase 4 leverage shifts to 4a (demote), 4b (merge), and 4d
141
- (hard-compress) — see `road-to-context-layer-maturity` Phase 4
141
+ (hard-condense) — see `road-to-context-layer-maturity` Phase 4
142
142
  inputs gate.
143
143
 
144
144
  **Reopener:** if a future inventory shows ≥ 3 shared-context loaders
@@ -33,10 +33,10 @@ load_context_eager: # opt-in eager — auto-loaded on rule fire
33
33
  ---
34
34
  ```
35
35
 
36
- > **Logical names only.** The `.agent-src.uncompressed/` prefix is
36
+ > **Logical names only.** The `.agent-src.uncondensed/` prefix is
37
37
  > rejected by the schema regex (`scripts/schemas/rule.schema.json`) and
38
- > by `scripts/lint_load_context.py`. The compress-time rewriter
39
- > (`scripts/compress.py::_rewrite_paths`) resolves logical names to the
38
+ > by `scripts/lint_load_context.py`. The condense-time rewriter
39
+ > (`scripts/condense.py::_rewrite_paths`) resolves logical names to the
40
40
  > deployment-correct relative path (e.g. `../contexts/<area>/<file>.md`
41
41
  > for a rule at `rules/<name>.md`). The full migration history lives
42
42
  > in the archived path-fixes roadmap under `agents/roadmaps/archive/`.
@@ -53,16 +53,16 @@ opt-in and budget-gated.
53
53
  ## Path rules
54
54
 
55
55
  - Logical names rooted at the source. The rewriter resolves them at
56
- compress time.
56
+ condense time.
57
57
  - Paths MUST end in `.md`.
58
58
  - Allowed roots:
59
59
  - `contexts/<area>/<file>.md` — canonical logical name (resolves
60
- against `.agent-src.uncompressed/`).
60
+ against `.agent-src.uncondensed/`).
61
61
  - `agents/settings/contexts/<file>.md` — project-local material (consumer
62
62
  repo only).
63
- - `.agent-src/contexts/<file>.md` — compressed mirror; tolerated
63
+ - `.agent-src/contexts/<file>.md` — condensed mirror; tolerated
64
64
  defensively, not authored.
65
- - The `.agent-src.uncompressed/` prefix is **rejected** by the schema
65
+ - The `.agent-src.uncondensed/` prefix is **rejected** by the schema
66
66
  regex and by `lint_load_context.py` with a remediation hint pointing
67
67
  at the canonical logical name.
68
68
  - A rule MAY reference contexts under either tree, but a package-shipped
@@ -144,10 +144,10 @@ definition it is not loaded into every turn.
144
144
 
145
145
  ## Public-vs-internal leak
146
146
 
147
- A rule shipped to consumers (`.agent-src.uncompressed/rules/`) may
147
+ A rule shipped to consumers (`.agent-src.uncondensed/rules/`) may
148
148
  declare `load_context:` entries pointing at:
149
149
 
150
- - `.agent-src.uncompressed/contexts/` — public, OK.
150
+ - `.agent-src.uncondensed/contexts/` — public, OK.
151
151
  - `agents/settings/contexts/` — package-internal, **lint warning** (the entry
152
152
  will not exist in consumer projects).
153
153
 
@@ -163,7 +163,7 @@ defined across both `load_context:` and `load_context_eager:` edges.
163
163
 
164
164
  ### Real consumer — `autonomous-execution`
165
165
 
166
- `.agent-src.uncompressed/rules/autonomous-execution.md` is the first
166
+ `.agent-src.uncondensed/rules/autonomous-execution.md` is the first
167
167
  production rule to declare `load_context:`. Its frontmatter:
168
168
 
169
169
  ```yaml
@@ -173,9 +173,9 @@ description: "Deciding whether to ask the user or just act on a workflow step
173
173
  alwaysApply: false
174
174
  source: package
175
175
  load_context:
176
- - .agent-src.uncompressed/contexts/execution/autonomy-detection.md
177
- - .agent-src.uncompressed/contexts/execution/autonomy-mechanics.md
178
- - .agent-src.uncompressed/contexts/execution/autonomy-examples.md
176
+ - .agent-src.uncondensed/contexts/execution/autonomy-detection.md
177
+ - .agent-src.uncondensed/contexts/execution/autonomy-mechanics.md
178
+ - .agent-src.uncondensed/contexts/execution/autonomy-examples.md
179
179
  ---
180
180
  ```
181
181
 
@@ -1,3 +1,7 @@
1
+ ---
2
+ stability: experimental
3
+ ---
4
+
1
5
  # Local Analytics Contract
2
6
 
3
7
  > **Status** · v0 / design · 2026-05-24. Phase 7 of the
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  stability: beta
3
- keep-beta-until: 2026-08-24
3
+ keep-beta-until: 2026-08-23
4
4
  ---
5
5
 
6
6
  # Local knowledge ingestion contract
@@ -45,7 +45,7 @@ prose-only.
45
45
  `list_*`, `read_resource_body`) that touch the content blob only.
46
46
  - **What it never does:** execute Python scripts, shell out, spawn
47
47
  runtimes, touch consumer FS, write to R2, mutate consumer state,
48
- call upstream LLM APIs, or read `.agent-src.uncompressed/`.
48
+ call upstream LLM APIs, or read `.agent-src.uncondensed/`.
49
49
  - **Owner code path:** `internal/workers/mcp/` (TypeScript, Cloudflare Worker).
50
50
  This contract is the normative spec.
51
51
  - **Auth model:** `public` (default) or `bearer-auth` (operator opt-in)
@@ -120,7 +120,7 @@ prose-only.
120
120
  shape `releases/v<X.Y.Z>-<sha>/` (immutable per release). The blob
121
121
  bundles `.agent-src/skills/<name>/SKILL.md`,
122
122
  `.agent-src/commands/**/*.md`, and `docs/guidelines/` (the same
123
- projection the local kernel reads). Never reads `.agent-src.uncompressed/`.
123
+ projection the local kernel reads). Never reads `.agent-src.uncondensed/`.
124
124
  - **Identity surface:** `serverInfo.version` reads from a Worker-
125
125
  bundled constant, `_meta.packageVersion` reads from a
126
126
  `wrangler.toml` env var, `_meta.skillSetSignature` reads from a
@@ -26,8 +26,8 @@ phase with its own design-call gate.
26
26
  - Transport: **stdio**. No SSE, no HTTP, no WebSocket.
27
27
  - MCP primitives: **`prompts/list`** + **`prompts/get`** — read-only.
28
28
  - Source data: **`.agent-src/skills/<name>/SKILL.md`** and
29
- **`.agent-src/commands/**/*.md`** (compressed projections, never the
30
- uncompressed source-of-truth tree).
29
+ **`.agent-src/commands/**/*.md`** (condensed projections, never the
30
+ uncondensed source-of-truth tree).
31
31
  - Loaded set (Phase 2): every well-formed skill + command under
32
32
  `.agent-src/` (Phase 1 hand-picked set retained as a smoke fixture
33
33
  in `prompts.py::PHASE_1_SKILLS`).
@@ -154,7 +154,7 @@ change invalidates it.
154
154
 
155
155
  ### F3 — Stdio Docker bundle
156
156
 
157
- `docker/mcp-server/Dockerfile` ships a stdio-only image. The contract:
157
+ `internal/docker/mcp-server/Dockerfile` ships a stdio-only image. The contract:
158
158
 
159
159
  - **No HTTP / SSE listener** in the image. Stdio is the only wire.
160
160
  - The image embeds `scripts/mcp_server/`, the two tool dependencies
@@ -5,7 +5,7 @@ stability: stable
5
5
  # Measurement baseline — contract
6
6
 
7
7
  > **Status:** locked 2026-05-16 · **Owner:** `step-4-measurement-and-benchmark.md`
8
- > · **Cited by:** every P2 enforcement roadmap (skill rationalization G0, north-star G1, compression default decision).
8
+ > · **Cited by:** every P2 enforcement roadmap (skill rationalization G0, north-star G1, condensation default decision).
9
9
 
10
10
  Single source of truth for what `task bench` measures, what counts as
11
11
  drift, and what unblocks enforcement. Read this before pinning a number
@@ -36,7 +36,7 @@ timestamped, never overwritten, content-addressed by run.
36
36
 
37
37
  Total 26 prompts ≥ Acceptance Criteria floor of 25. Mid-window edits
38
38
  to either YAML restart the 60-day clock per
39
- [`compression-default-kill-criterion.md`](compression-default-kill-criterion.md) § 2.
39
+ [`condensation-default-kill-criterion.md`](condensation-default-kill-criterion.md) § 2.
40
40
 
41
41
  ## What counts as drift
42
42
 
@@ -77,14 +77,14 @@ on the 30-report floor.
77
77
  Downstream consumers:
78
78
 
79
79
  - ``step-99-north-star-restructure.md` § Acceptance G1` — reads this exit code.
80
- - [`compression-default-kill-criterion.md` § 3](compression-default-kill-criterion.md) — reads the decision table after baseline closes.
80
+ - [`condensation-default-kill-criterion.md` § 3](condensation-default-kill-criterion.md) — reads the decision table after baseline closes.
81
81
  - ``step-2-skill-inventory-rationalization.md` § G0` — usage-data soak floor.
82
82
 
83
83
  ## What the closeout writes
84
84
 
85
85
  On baseline closure, the step-4 closeout writes the numeric verdict to
86
86
  [`docs/parity/bench.json`](../parity/bench.json) — frozen snapshot with
87
- the 30+ reports averaged, drift verdict, and the compression-default
87
+ the 30+ reports averaged, drift verdict, and the condensation-default
88
88
  decision per the kill-criterion table. That file is the artefact every
89
89
  P2 roadmap reads — not the live `internal/bench/reports/` directory.
90
90
 
@@ -98,5 +98,5 @@ P2 roadmap reads — not the live `internal/bench/reports/` directory.
98
98
 
99
99
  - [`benchmark-report-schema.md`](benchmark-report-schema.md) · per-report JSON schema
100
100
  - [`benchmark-corpus-spec.md`](benchmark-corpus-spec.md) · corpus YAML schema
101
- - [`compression-default-kill-criterion.md`](compression-default-kill-criterion.md) · decision table read by step-4 closeout
101
+ - [`condensation-default-kill-criterion.md`](condensation-default-kill-criterion.md) · decision table read by step-4 closeout
102
102
  - `step-4-measurement-and-benchmark.md` · the owning roadmap
@@ -37,7 +37,7 @@ decisions. The expensive part is identifying which "principle" is
37
37
  actually load-bearing vs. inherited belief; the cheap part is the
38
38
  re-derivation. Use when an inherited approach feels stale and you
39
39
  suspect the real constraint moved.
40
- *Cited by:* `.agent-src.uncompressed/skills/improve-before-implement/`
40
+ *Cited by:* `.agent-src.uncondensed/skills/improve-before-implement/`
41
41
  (challenges weak requirements before code is written).
42
42
 
43
43
  ### 2. Jobs-to-be-Done (JTBD)
@@ -47,7 +47,7 @@ the job is the situation × motivation × expected outcome, not the
47
47
  demographic. The unit of analysis is the **switch event** — what
48
48
  caused them to fire the previous solution. JTBD reframes feature
49
49
  requests as evidence of an unmet job, not feature gaps.
50
- *Cited by:* `.agent-src.uncompressed/skills/po-discovery/`
50
+ *Cited by:* `.agent-src.uncondensed/skills/po-discovery/`
51
51
  (reframes fuzzy product asks via job-shape).
52
52
 
53
53
  ### 3. Pareto principle (80/20)
@@ -56,7 +56,7 @@ Roughly 80% of effects come from 20% of causes. The lift is in
56
56
  **identifying** the 20% — which user segment, which test failure,
57
57
  which N+1 query — not in re-stating the ratio. Anti-pattern: using
58
58
  80/20 as permission to ignore the long tail without measuring it.
59
- *Cited by:* `.agent-src.uncompressed/skills/performance-analysis/`
59
+ *Cited by:* `.agent-src.uncondensed/skills/performance-analysis/`
60
60
  (N+1 detection prioritizes the 20% of queries causing 80% of latency).
61
61
 
62
62
  ### 4. Second-order thinking
@@ -66,7 +66,7 @@ what looks best now; second-order weighs the consequences of the
66
66
  consequences. Most "obvious" decisions die at second-order — the
67
67
  optimization that ships now creates the maintenance debt that kills
68
68
  velocity in 6 months.
69
- *Cited by:* `.agent-src.uncompressed/skills/adversarial-review/`
69
+ *Cited by:* `.agent-src.uncondensed/skills/adversarial-review/`
70
70
  (stress-tests a plan by walking past the immediate verdict).
71
71
 
72
72
  ### 5. Opportunity cost
@@ -76,7 +76,7 @@ not pick**, not the dollar / time spent. A 2-week feature is not
76
76
  "2 weeks expensive" — it is the highest-value 2-week feature you
77
77
  chose not to ship instead. Naming the alternative makes the cost
78
78
  legible; pretending there isn't one is the failure mode.
79
- *Cited by:* `.agent-src.uncompressed/skills/rice-prioritization/`
79
+ *Cited by:* `.agent-src.uncondensed/skills/rice-prioritization/`
80
80
  (scores compete for capacity; non-shipped items are the cost basis).
81
81
 
82
82
  ### 6. Theory of constraints
@@ -86,7 +86,7 @@ Improving any non-constraint resource is local optimization with
86
86
  zero system effect — usually negative, since it loads the actual
87
87
  constraint harder. The discipline: identify, exploit, subordinate,
88
88
  elevate, then find the next constraint.
89
- *Cited by:* `.agent-src.uncompressed/skills/funnel-analysis/`
89
+ *Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
90
90
  (identifies the single funnel stage that bounds conversion throughput).
91
91
 
92
92
  ### 7. MVP (Minimum Viable Product)
@@ -97,7 +97,7 @@ junior-grade product. The trap is shipping an MVP that cannot
97
97
  distinguish "user behavior validates the hypothesis" from "user
98
98
  behavior was driven by something else"; that is just a small
99
99
  product.
100
- *Cited by:* `.agent-src.uncompressed/skills/po-discovery/`
100
+ *Cited by:* `.agent-src.uncondensed/skills/po-discovery/`
101
101
  (scopes a discovery slice that produces a learning, not a feature).
102
102
 
103
103
  ### 8. Build-Measure-Learn
@@ -107,7 +107,7 @@ to persevere or pivot. The skill is in **shortening the loop** —
107
107
  weeks beat months because months let teams rationalize a failed
108
108
  hypothesis. The loop is the artefact; any individual cycle is just
109
109
  one iteration.
110
- *Cited by:* `.agent-src.uncompressed/skills/test-driven-development/`
110
+ *Cited by:* `.agent-src.uncondensed/skills/test-driven-development/`
111
111
  (the build-measure-learn loop applied to one function at a time).
112
112
 
113
113
  ### 9. Hypothesis-driven development
@@ -116,7 +116,7 @@ State the hypothesis as a falsifiable sentence with a metric and a
116
116
  threshold **before** writing the code. "If we do X, metric Y will
117
117
  move by Z." Without the threshold, the team will declare any
118
118
  movement victory. With it, the team learns from the misses.
119
- *Cited by:* `.agent-src.uncompressed/skills/project-analysis-hypothesis-driven/`
119
+ *Cited by:* `.agent-src.uncondensed/skills/project-analysis-hypothesis-driven/`
120
120
  (competing hypotheses + validation loops + evidence-based conclusions).
121
121
 
122
122
  ### 10. Reversible vs. irreversible decisions
@@ -126,7 +126,7 @@ plus speed. The bias under uncertainty: shipping a reversible
126
126
  decision early is almost always cheaper than the meeting required
127
127
  to decide. The skill is recognizing irreversibility — usually data
128
128
  shape, public API surface, or hiring.
129
- *Cited by:* `.agent-src.uncompressed/skills/decision-record/`
129
+ *Cited by:* `.agent-src.uncondensed/skills/decision-record/`
130
130
  (records the reversal-criteria so the irreversibility verdict is auditable).
131
131
 
132
132
  ### 11. DX as first-class concern
@@ -136,7 +136,7 @@ a polish task. Slow tests, fragile local setup, and surprising tool
136
136
  output compound — every developer pays the tax every day. Treat DX
137
137
  issues like user-facing bugs, with severity and SLA. The compounding
138
138
  math makes "fix it later" almost always wrong.
139
- *Cited by:* `.agent-src.uncompressed/skills/test-performance/`
139
+ *Cited by:* `.agent-src.uncondensed/skills/test-performance/`
140
140
  (test-suite latency is a developer-facing metric, optimized as such).
141
141
 
142
142
  ### 12. Conway's Law
@@ -145,7 +145,7 @@ The systems an organization builds mirror its communication structure.
145
145
  Re-orgs propagate to architecture; architecture changes that fight the
146
146
  org chart fail. The lever is bidirectional: pick the architecture you
147
147
  want, then engineer the communication paths that produce it.
148
- *Cited by:* `.agent-src.uncompressed/skills/api-design/`
148
+ *Cited by:* `.agent-src.uncondensed/skills/api-design/`
149
149
  (bounded-context choices follow team boundaries, not the other way around).
150
150
 
151
151
  ### 13. Occam's Razor
@@ -155,7 +155,7 @@ that introduces the fewest new entities. In debugging, the boring
155
155
  explanation (typo, off-by-one, stale cache) is usually correct. The
156
156
  trap is **assuming** instead of **falsifying** — Occam suggests
157
157
  order of investigation, not a verdict.
158
- *Cited by:* `.agent-src.uncompressed/skills/systematic-debugging/`
158
+ *Cited by:* `.agent-src.uncondensed/skills/systematic-debugging/`
159
159
  (reproduce → isolate → hypothesize, simplest hypothesis first).
160
160
 
161
161
  ### 14. Meadows leverage points
@@ -165,7 +165,7 @@ system are paradigm shifts, then goals, then rules — far above
165
165
  parameter tweaks. Most "improvement" effort fights parameters
166
166
  (numbers, delays) at the bottom of the ranking. Climb the ranking
167
167
  before optimizing.
168
- *Cited by:* `.agent-src.uncompressed/skills/architecture-review-lens/`
168
+ *Cited by:* `.agent-src.uncondensed/skills/architecture-review-lens/`
169
169
  (boundary / dependency-direction issues are higher-leverage than tweaks).
170
170
 
171
171
  ### 15. Signal vs. noise
@@ -175,7 +175,7 @@ A change of size N is meaningful only if N exceeds the noise floor
175
175
  for that metric × that horizon. The discipline: estimate the noise
176
176
  band first, then evaluate the change. Without the noise band, every
177
177
  movement looks like a trend.
178
- *Cited by:* `.agent-src.uncompressed/skills/funnel-analysis/`
178
+ *Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
179
179
  (stage-to-stage drop is read against the typical week-on-week noise).
180
180
 
181
181
  ### 16. Leading vs. lagging indicators
@@ -185,7 +185,7 @@ late. Leading indicators (activation events, repeat-use, support
185
185
  volume) are noisy and early. Operating on lagging alone means the
186
186
  team learns about problems after they cost money. Pair them: lagging
187
187
  is the score, leading is the steering wheel.
188
- *Cited by:* `.agent-src.uncompressed/skills/dashboard-design/`
188
+ *Cited by:* `.agent-src.uncondensed/skills/dashboard-design/`
189
189
  (RED / USE / Golden Signals split leading from lagging explicitly).
190
190
 
191
191
  ### 17. Churn as health metric
@@ -195,7 +195,7 @@ delivers ongoing value. A flat retention tail means the product
195
195
  works for the survivors; a sliding tail means the underlying job is
196
196
  not getting done. Churn is upstream of CAC payback — fix it first,
197
197
  then scale.
198
- *Cited by:* `.agent-src.uncompressed/skills/funnel-analysis/`
198
+ *Cited by:* `.agent-src.uncondensed/skills/funnel-analysis/`
199
199
  (retention bend distinguishes activation problems from product-fit).
200
200
 
201
201
  ### 18. Pull vs. push systems
@@ -205,7 +205,7 @@ start work when upstream capacity is free. Push optimizes individual
205
205
  utilization, pull optimizes flow. Most software teams claim pull and
206
206
  operate push (queues filling up, sprints overcommitted, WIP
207
207
  unmanaged). The fix is WIP limits, not motivation.
208
- *Cited by:* `.agent-src.uncompressed/skills/laravel-horizon/`
208
+ *Cited by:* `.agent-src.uncondensed/skills/laravel-horizon/`
209
209
  (queue-balance strategies are pull-vs-push policy in concrete form).
210
210
 
211
211
  ### 19. Shift-left
@@ -215,7 +215,7 @@ lifecycle — to the developer's machine, the PR, the design — where
215
215
  the cost of fixing is order-of-magnitude lower. The trade-off:
216
216
  shift-left adds friction at the front; the math holds when defect
217
217
  escape rate drops faster than the friction cost.
218
- *Cited by:* `.agent-src.uncompressed/skills/threat-modeling/`
218
+ *Cited by:* `.agent-src.uncondensed/skills/threat-modeling/`
219
219
  (threats enumerated before implementation, not after pen-test).
220
220
 
221
221
  ### 20. Latency vs. throughput
@@ -225,7 +225,7 @@ not implementation-detail. Batch processing trades latency for
225
225
  throughput; real-time pipelines trade throughput for latency. The
226
226
  mistake is optimizing without naming which one matters for the user
227
227
  job at hand.
228
- *Cited by:* `.agent-src.uncompressed/skills/database/`
228
+ *Cited by:* `.agent-src.uncondensed/skills/database/`
229
229
  (index strategy and query batching surface the trade-off explicitly).
230
230
 
231
231
  ### 21. Trust boundaries
@@ -235,7 +235,7 @@ trusted: client → server, tenant A → tenant B, free tier → paid
235
235
  tier, public endpoint → internal service. Threats enter at boundary
236
236
  crossings; defense lives at the crossing, not deeper. Drawing the
237
237
  boundary correctly is half the security work.
238
- *Cited by:* `.agent-src.uncompressed/skills/threat-modeling/`
238
+ *Cited by:* `.agent-src.uncondensed/skills/threat-modeling/`
239
239
  (produces trust boundaries + abuse cases mapped to files).
240
240
 
241
241
  ### 22. Defense in depth
@@ -245,7 +245,7 @@ rules, environment hardening, and instrumentation so a bypass at
245
245
  one layer is caught at the next. The trap is mistaking redundancy
246
246
  for security theatre — each layer must have an independent failure
247
247
  mode, not a copy of the previous one.
248
- *Cited by:* `.agent-src.uncompressed/skills/defense-in-depth/`
248
+ *Cited by:* `.agent-src.uncondensed/skills/defense-in-depth/`
249
249
  (turns local fix into structural one across four guard layers).
250
250
 
251
251
  ### 23. Blast radius
@@ -255,7 +255,7 @@ consumer, queue worker, API client, migration, and test that the
255
255
  change touches. The radius is the work; the diff is the artefact.
256
256
  Underestimating radius is the failure mode that breaks production
257
257
  when the change "looked small".
258
- *Cited by:* `.agent-src.uncompressed/skills/blast-radius-analyzer/`
258
+ *Cited by:* `.agent-src.uncondensed/skills/blast-radius-analyzer/`
259
259
  (file:line citation per dependency, BEFORE the edit).
260
260
 
261
261
  ### 24. Iron triangle (scope / time / quality)
@@ -264,7 +264,7 @@ Scope, time, and quality are coupled — fix two, the third moves.
264
264
  Pretending to fix all three is how teams ship at low quality and
265
265
  call it on-time. The honest move is naming which two are fixed and
266
266
  which one absorbs the variance, BEFORE the work starts.
267
- *Cited by:* `.agent-src.uncompressed/skills/refine-ticket/`
267
+ *Cited by:* `.agent-src.uncondensed/skills/refine-ticket/`
268
268
  (AC sharpening forces explicit scope decisions before estimation).
269
269
 
270
270
  ### 25. Definition of Done
@@ -274,7 +274,7 @@ work — tests, docs, deployment, comms. Without one, every team
274
274
  member ships their personal threshold and disputes downstream. The
275
275
  discipline is making it visible, agreed, and consistently applied —
276
276
  not the specific items on it.
277
- *Cited by:* `.agent-src.uncompressed/skills/verify-completion-evidence/`
277
+ *Cited by:* `.agent-src.uncondensed/skills/verify-completion-evidence/`
278
278
  (fresh evidence is required before any "done" claim).
279
279
 
280
280
  ### 26. Postmortem-driven learning
@@ -284,7 +284,7 @@ the team that hides the incident. Blameless postmortems separate
284
284
  contribution from blame, surface systemic causes, and produce
285
285
  mitigations that reduce future incident rate — not just the count
286
286
  of one-off fixes.
287
- *Cited by:* `.agent-src.uncompressed/skills/incident-commander/`
287
+ *Cited by:* `.agent-src.uncondensed/skills/incident-commander/`
288
288
  (severity framing + comms cadence + post-mortem skeleton).
289
289
 
290
290
  ### 27. Tech debt as interest
@@ -294,7 +294,7 @@ payment (the ongoing tax on velocity). Carrying the debt is the
294
294
  right call when the principal is repayable and the interest is
295
295
  small; the failure is treating ongoing high-interest debt as a
296
296
  fixed cost. Track it like a balance sheet.
297
- *Cited by:* `.agent-src.uncompressed/skills/tech-debt-tracker/`
297
+ *Cited by:* `.agent-src.uncondensed/skills/tech-debt-tracker/`
298
298
  (interest-vs-principal framing, prioritisation by carrying cost).
299
299
 
300
300
  ### 28. Mise en place
@@ -304,7 +304,7 @@ before the cooking step starts. Switching between prep and cook is
304
304
  where errors enter. In software, the analogue is staged commits,
305
305
  prepared test fixtures, and decisions locked before implementation.
306
306
  The discipline is the savings, not the metaphor.
307
- *Cited by:* `.agent-src.uncompressed/skills/existing-ui-audit/`
307
+ *Cited by:* `.agent-src.uncondensed/skills/existing-ui-audit/`
308
308
  (inventory before any non-trivial UI edit, hard gate).
309
309
 
310
310
  ### 29. Premortem
@@ -314,7 +314,7 @@ risks the team already knows but has not voiced. The trick is the
314
314
  past-tense framing; "what could go wrong" surfaces less than "it
315
315
  failed, what happened". Cheap; high signal-to-noise; the residual
316
316
  output is a risk register the team actually defends.
317
- *Cited by:* `.agent-src.uncompressed/skills/risk-officer/`
317
+ *Cited by:* `.agent-src.uncondensed/skills/risk-officer/`
318
318
  (blast-radius framing, mitigations, residual-risk verdict pre-commit).
319
319
 
320
320
  ### 30. Inversion
@@ -324,7 +324,7 @@ guarantee failure at X?" — then avoid that. Inversion exposes the
324
324
  non-obvious failure modes that direct planning misses, especially
325
325
  in security, ops, and people problems where the failure surface is
326
326
  larger than the success surface.
327
- *Cited by:* `.agent-src.uncompressed/skills/adversarial-review/`
327
+ *Cited by:* `.agent-src.uncondensed/skills/adversarial-review/`
328
328
  (devil's-advocate stress-test poking holes in a plan).
329
329
 
330
330
  ## Adding or removing a model