@event4u/agent-config 3.2.0 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (607) 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 +6 -6
  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 -16
  143. package/CHANGELOG.md +204 -2
  144. package/CONTRIBUTING.md +31 -12
  145. package/README.md +18 -10
  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/apply.js +238 -0
  164. package/dist/install/apply.js.map +1 -0
  165. package/dist/install/atomic.js +92 -0
  166. package/dist/install/atomic.js.map +1 -0
  167. package/dist/install/bridges/augment.js +20 -0
  168. package/dist/install/bridges/augment.js.map +1 -0
  169. package/dist/install/bridges/claude.js +44 -0
  170. package/dist/install/bridges/claude.js.map +1 -0
  171. package/dist/install/bridges/cline.js +69 -0
  172. package/dist/install/bridges/cline.js.map +1 -0
  173. package/dist/install/bridges/copilot.js +28 -0
  174. package/dist/install/bridges/copilot.js.map +1 -0
  175. package/dist/install/bridges/cursor.js +34 -0
  176. package/dist/install/bridges/cursor.js.map +1 -0
  177. package/dist/install/bridges/gemini.js +39 -0
  178. package/dist/install/bridges/gemini.js.map +1 -0
  179. package/dist/install/bridges/index.js +88 -0
  180. package/dist/install/bridges/index.js.map +1 -0
  181. package/dist/install/bridges/marker-content.js +153 -0
  182. package/dist/install/bridges/marker-content.js.map +1 -0
  183. package/dist/install/bridges/markers.js +42 -0
  184. package/dist/install/bridges/markers.js.map +1 -0
  185. package/dist/install/bridges/types.js +31 -0
  186. package/dist/install/bridges/types.js.map +1 -0
  187. package/dist/install/bridges/vscode.js +26 -0
  188. package/dist/install/bridges/vscode.js.map +1 -0
  189. package/dist/install/bridges/windsurf.js +35 -0
  190. package/dist/install/bridges/windsurf.js.map +1 -0
  191. package/dist/install/conflict.js +196 -0
  192. package/dist/install/conflict.js.map +1 -0
  193. package/dist/install/detect.js +218 -0
  194. package/dist/install/detect.js.map +1 -0
  195. package/dist/install/paths.js +82 -0
  196. package/dist/install/paths.js.map +1 -0
  197. package/dist/install/plan.js +157 -0
  198. package/dist/install/plan.js.map +1 -0
  199. package/dist/install/txlog.js +140 -0
  200. package/dist/install/txlog.js.map +1 -0
  201. package/dist/install/types.js +19 -0
  202. package/dist/install/types.js.map +1 -0
  203. package/dist/install/wizard-plan.js +184 -0
  204. package/dist/install/wizard-plan.js.map +1 -0
  205. package/dist/mcp/registry-manifest.json +4 -4
  206. package/dist/router.json +67 -19
  207. package/dist/server/app.js +6 -0
  208. package/dist/server/app.js.map +1 -1
  209. package/dist/server/routes/install.js +547 -0
  210. package/dist/server/routes/install.js.map +1 -0
  211. package/dist/server/routes/wizard.js +301 -6
  212. package/dist/server/routes/wizard.js.map +1 -1
  213. package/dist/server/routes/workspace.js +396 -0
  214. package/dist/server/routes/workspace.js.map +1 -0
  215. package/dist/server/schemas/settings.js +4 -3
  216. package/dist/server/schemas/settings.js.map +1 -1
  217. package/dist/ui/assets/index-BXZILUxe.css +1 -0
  218. package/dist/ui/assets/index-DLEuEW1V.js +35 -0
  219. package/dist/ui/assets/index-DLEuEW1V.js.map +1 -0
  220. package/dist/ui/index.html +2 -2
  221. package/docs/MIGRATION.md +1 -1
  222. package/docs/adrs/cost/0001-hard-stop-hook.md +1 -1
  223. package/docs/adrs/router/0001-three-tier-routing.md +4 -4
  224. package/docs/adrs/schema/0001-json-schema-frontmatter.md +1 -1
  225. package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +4 -4
  226. package/docs/adrs/{caveman → telegraph}/0001-default-off-until-bench.md +9 -9
  227. package/docs/adrs/telegraph/README.md +9 -0
  228. package/docs/architecture/augment-projection.md +4 -4
  229. package/docs/architecture/claude-bundle.md +1 -1
  230. package/docs/architecture/current-onboard-baseline.md +3 -3
  231. package/docs/architecture/multi-tool-projection.md +10 -10
  232. package/docs/architecture/source-projection.md +27 -27
  233. package/docs/architecture.md +19 -15
  234. package/docs/archive/CHANGELOG-pre-2.11.0.md +2 -2
  235. package/docs/archive/CHANGELOG-pre-2.15.0.md +3 -3
  236. package/docs/archive/CHANGELOG-pre-2.16.0.md +1 -1
  237. package/docs/archive/CHANGELOG-pre-2.2.0.md +70 -70
  238. package/docs/archive/CHANGELOG-pre-2.20.0.md +2 -2
  239. package/docs/archive/CHANGELOG-pre-2.25.0.md +15 -15
  240. package/docs/archive/CHANGELOG-pre-3.0.0.md +4 -4
  241. package/docs/archive/CHANGELOG-pre-3.1.0.md +2 -2
  242. package/docs/archive/CHANGELOG-pre-3.2.0.md +3 -3
  243. package/docs/benchmark.md +65 -0
  244. package/docs/benchmarks.md +18 -18
  245. package/docs/catalog.md +17 -15
  246. package/docs/contracts/CHANGELOG-conventions.md +2 -2
  247. package/docs/contracts/STABILITY.md +2 -2
  248. package/docs/contracts/adoption-signal-floor.md +110 -0
  249. package/docs/contracts/adr-chat-history-split.md +4 -4
  250. package/docs/contracts/adr-command-suggestion.md +4 -4
  251. package/docs/contracts/adr-gtm-context-spine.md +1 -1
  252. package/docs/contracts/adr-implement-ticket-runtime.md +4 -4
  253. package/docs/contracts/adr-install-user-type-axis.md +1 -1
  254. package/docs/contracts/adr-layout.md +2 -2
  255. package/docs/contracts/adr-mcp-runtime.md +1 -1
  256. package/docs/contracts/adr-product-ui-track.md +10 -10
  257. package/docs/contracts/adr-user-types-axis.md +3 -3
  258. package/docs/contracts/adr-wing4-context-spine.md +1 -1
  259. package/docs/contracts/agent-memory-contract.md +3 -3
  260. package/docs/contracts/agents-md-tech-stack.md +2 -2
  261. package/docs/contracts/ai-council-config.md +2 -2
  262. package/docs/contracts/at-rest-encryption.md +4 -0
  263. package/docs/contracts/audit-log-v1.md +1 -1
  264. package/docs/contracts/benchmark-ab-contract.md +101 -0
  265. package/docs/contracts/benchmark-corpus-spec.md +4 -4
  266. package/docs/contracts/benchmark-report-schema.md +5 -5
  267. package/docs/contracts/branch-protection-policy.md +98 -0
  268. package/docs/contracts/ci-cost-budget.md +106 -0
  269. package/docs/contracts/ci-green-floor.md +141 -0
  270. package/docs/contracts/command-clusters.md +6 -6
  271. package/docs/contracts/command-surface-tiers.md +2 -2
  272. package/docs/contracts/command-taxonomy.md +2 -2
  273. package/docs/contracts/{compression-default-kill-criterion.md → condensation-default-kill-criterion.md} +29 -29
  274. package/docs/contracts/config-presets.md +1 -1
  275. package/docs/contracts/context-paths.md +3 -3
  276. package/docs/contracts/context-spine.md +1 -1
  277. package/docs/contracts/cost-enforcement.md +1 -1
  278. package/docs/contracts/cost-summary-schema.md +12 -12
  279. package/docs/contracts/cross-wing-handoff.md +4 -4
  280. package/docs/contracts/daily-workspace.md +4 -0
  281. package/docs/contracts/decision-trace-v1.md +2 -2
  282. package/docs/contracts/discovery-manifest.md +4 -4
  283. package/docs/contracts/explain-modes.md +4 -0
  284. package/docs/contracts/file-ownership-matrix.json +3493 -3318
  285. package/docs/contracts/file-ownership-matrix.md +3 -3
  286. package/docs/contracts/frontmatter-contract.md +4 -4
  287. package/docs/contracts/ghostwriter-schema.md +3 -3
  288. package/docs/contracts/gui-wizard.md +1 -1
  289. package/docs/contracts/harness-expectations.md +123 -0
  290. package/docs/contracts/host-agent-protocol.md +4 -0
  291. package/docs/contracts/implement-ticket-flow.md +9 -9
  292. package/docs/contracts/install-scopes.md +77 -0
  293. package/docs/contracts/iron-law-overrides.txt +1 -1
  294. package/docs/contracts/kernel-membership.md +26 -26
  295. package/docs/contracts/linear-ai-rules-inclusion.md +1 -1
  296. package/docs/contracts/linter-structural-model.md +2 -2
  297. package/docs/contracts/load-context-budget-model.md +4 -4
  298. package/docs/contracts/load-context-schema.md +13 -13
  299. package/docs/contracts/local-analytics.md +4 -0
  300. package/docs/contracts/local-knowledge-ingestion.md +1 -1
  301. package/docs/contracts/mcp-beta-criteria.md +1 -1
  302. package/docs/contracts/mcp-cloud-scope.md +6 -6
  303. package/docs/contracts/mcp-phase-1-scope.md +3 -3
  304. package/docs/contracts/mcp-registry-manifest.schema.json +1 -1
  305. package/docs/contracts/mcp-tool-inventory.md +1 -1
  306. package/docs/contracts/mcp-tool-stub-envelope.md +1 -1
  307. package/docs/contracts/measurement-baseline.md +11 -11
  308. package/docs/contracts/mental-models.md +30 -30
  309. package/docs/contracts/multi-tool-projection-fidelity.md +4 -4
  310. package/docs/contracts/namespace.md +4 -4
  311. package/docs/contracts/orchestration-dsl-v1.md +7 -7
  312. package/docs/contracts/package-self-orientation.md +12 -12
  313. package/docs/contracts/persona-schema.md +6 -6
  314. package/docs/contracts/pilot/language-and-tone.md +1 -1
  315. package/docs/contracts/plain-language-surface.md +117 -0
  316. package/docs/contracts/profile-system.md +3 -3
  317. package/docs/contracts/release-pr-gating.md +103 -0
  318. package/docs/contracts/role-experience.md +3 -3
  319. package/docs/contracts/rule-classification.md +13 -13
  320. package/docs/contracts/rule-interactions.md +4 -4
  321. package/docs/contracts/rule-interactions.yml +30 -30
  322. package/docs/contracts/rule-priority-hierarchy.md +13 -13
  323. package/docs/contracts/rule-router.md +2 -2
  324. package/docs/contracts/safety-model.md +1 -1
  325. package/docs/contracts/skill-distribution-channels.md +61 -0
  326. package/docs/contracts/skill-domains.md +2 -2
  327. package/docs/contracts/smoke-contracts.md +5 -5
  328. package/docs/contracts/telegraph-telemetry.md +83 -0
  329. package/docs/contracts/trust-and-safety.md +5 -5
  330. package/docs/contracts/ui-stack-extension.md +7 -7
  331. package/docs/contracts/ui-track-flow.md +9 -9
  332. package/docs/contracts/user-type-schema.md +4 -4
  333. package/docs/contracts/workflow-packs.md +4 -4
  334. package/docs/contracts/workspace-documents.md +4 -0
  335. package/docs/customization.md +28 -8
  336. package/docs/decisions/ADR-001-kernel-swap-deferred.md +6 -6
  337. package/docs/decisions/ADR-002-kernel-bucket-overrides.md +11 -11
  338. package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +2 -2
  339. package/docs/decisions/ADR-004-rule-governance-pruning.md +4 -4
  340. package/docs/decisions/ADR-005-subagent-worktrees.md +7 -7
  341. package/docs/decisions/ADR-011-domain-pack-readiness.md +6 -6
  342. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +3 -3
  343. package/docs/decisions/ADR-015-discovery-manifest-contract.md +3 -3
  344. package/docs/decisions/ADR-017-monorepo-physical-layout.md +10 -10
  345. package/docs/decisions/ADR-018-trust-and-safety-layer.md +6 -6
  346. package/docs/decisions/ADR-019-router-json-dist-location.md +2 -2
  347. package/docs/decisions/ADR-020-global-only-consumer-scope.md +2 -2
  348. package/docs/decisions/ADR-021-deployment-shape.md +1 -1
  349. package/docs/decisions/ADR-022-daily-workspace-decomposition.md +1 -1
  350. package/docs/decisions/ADR-027-changelog-machine-vs-manual.md +129 -0
  351. package/docs/decisions/ADR-028-root-layout.md +147 -0
  352. package/docs/decisions/ADR-029-multi-workspace-deferred.md +122 -0
  353. package/docs/decisions/ADR-rule-kernel-and-router.md +5 -5
  354. package/docs/decisions/INDEX.md +8 -0
  355. package/docs/deploy/team-deployment-posture.md +20 -0
  356. package/docs/development.md +17 -17
  357. package/docs/distribution/registries.md +32 -0
  358. package/docs/distribution/registry-submissions.md +85 -0
  359. package/docs/distribution/telemetry-schema.md +1 -1
  360. package/docs/getting-started-by-role.md +45 -3
  361. package/docs/getting-started.md +2 -2
  362. package/docs/guidelines/agent-infra/5w2h-analysis.md +3 -3
  363. package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +1 -1
  364. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +3 -3
  365. package/docs/guidelines/agent-infra/carve-out-predicates.md +3 -3
  366. package/docs/guidelines/agent-infra/critical-thinking.md +4 -4
  367. package/docs/guidelines/agent-infra/direct-answers-demos.md +1 -1
  368. package/docs/guidelines/agent-infra/first-principles.md +2 -2
  369. package/docs/guidelines/agent-infra/inversion-thinking.md +5 -5
  370. package/docs/guidelines/agent-infra/layered-settings.md +56 -2
  371. package/docs/guidelines/agent-infra/mental-models.md +3 -3
  372. package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +2 -2
  373. package/docs/guidelines/agent-infra/rule-type-governance.md +1 -1
  374. package/docs/guidelines/agent-infra/scqa-framework.md +5 -5
  375. package/docs/guidelines/agent-infra/self-improvement-pipeline.md +2 -2
  376. package/docs/guidelines/agent-infra/six-hats.md +3 -3
  377. package/docs/guidelines/agent-infra/skill-quality-checklist.md +5 -5
  378. package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
  379. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +1 -1
  380. package/docs/guidelines/augment-portability-patterns.md +4 -4
  381. package/docs/guidelines/cross-role-handoff.md +2 -2
  382. package/docs/guidelines/php/php-coding-patterns.md +1 -1
  383. package/docs/guidelines/prompt-templates.md +6 -6
  384. package/docs/maintainers/dev-mode.md +1 -1
  385. package/docs/mcp-server.md +1 -1
  386. package/docs/mcp.md +1 -1
  387. package/docs/parity/bench-ruflo.json +3 -3
  388. package/docs/parity/bench.json +3 -3
  389. package/docs/parity/ruflo.md +3 -3
  390. package/docs/profiles.md +11 -11
  391. package/docs/quality.md +11 -11
  392. package/docs/safety.md +3 -3
  393. package/docs/setup/mcp-client-config.md +2 -2
  394. package/docs/setup/mcp-cloud-endpoints.md +1 -1
  395. package/docs/setup/mcp-cloud-setup.md +2 -2
  396. package/docs/setup/mcp-r2-bootstrap.md +2 -2
  397. package/docs/setup/mcp-server-docker.md +3 -3
  398. package/docs/setup/per-ide/windsurf.md +1 -1
  399. package/docs/skills-catalog.md +8 -7
  400. package/docs/troubleshooting.md +1 -1
  401. package/docs/walkthroughs/daily-workspace-a11y.md +87 -0
  402. package/llms.txt +7 -6
  403. package/package.json +1 -1
  404. package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  405. package/scripts/_archive/README.md +2 -2
  406. package/scripts/_archive/_backfill_skill_domains.py +3 -3
  407. package/scripts/_archive/_bootstrap_tier_frontmatter.py +3 -3
  408. package/scripts/_archive/_p43_bodies.py +10 -10
  409. package/scripts/_archive/{_p43_compress.py → _p43_condense.py} +5 -5
  410. package/scripts/_archive/_p4_migrate.py +7 -7
  411. package/scripts/_archive/_phase2_shim_helper.py +1 -1
  412. package/scripts/_archive/_pilot_council_question.py +5 -5
  413. package/scripts/_cli/explain_last/inputs.py +1 -1
  414. package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  415. package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  416. package/scripts/_lib/agent_settings.py +195 -1
  417. package/scripts/_lib/agent_src.py +19 -19
  418. package/scripts/_lib/bench_ab_cache.py +162 -0
  419. package/scripts/_lib/bench_ab_scoring.py +209 -0
  420. package/scripts/_lib/bench_cost.py +2 -2
  421. package/scripts/_lib/bench_report.py +2 -2
  422. package/scripts/_lib/{bench_caveman.py → bench_telegraph.py} +21 -21
  423. package/scripts/_lib/{bench_caveman_report.py → bench_telegraph_report.py} +22 -22
  424. package/scripts/_lib/claude_desktop_bundler.py +5 -5
  425. package/scripts/_lib/module_detection.py +223 -0
  426. package/scripts/_lib/scope_guard.sh +162 -0
  427. package/scripts/_phase4_bucket.py +3 -3
  428. package/scripts/_pilot_measure.py +4 -4
  429. package/scripts/_tmp_scan_framework_leakage.py +1 -1
  430. package/scripts/adoption_report.py +195 -0
  431. package/scripts/adoption_snapshot.py +219 -0
  432. package/scripts/adoption_status.py +166 -0
  433. package/scripts/ai-video/lib/parse-blueprint.sh +1 -1
  434. package/scripts/ai_council/advisors.py +5 -5
  435. package/scripts/ai_council/compile_corpus.py +1 -1
  436. package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +3 -3
  437. package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +2 -2
  438. package/scripts/ai_council/one_off_archive/2026-05/_one_off_inject_quiet_flag.py +1 -1
  439. package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_v2.sh +1 -1
  440. package/scripts/ai_council/one_off_archive/2026-05/_one_off_measure_verbosity.sh +1 -1
  441. package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +3 -3
  442. package/scripts/ai_council/one_off_archive/2026-05/_one_off_per_task.sh +1 -1
  443. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +1 -1
  444. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +6 -6
  445. package/scripts/ai_council/one_off_archive/2026-05/_one_off_rebalancing_audit.py +1 -1
  446. package/scripts/ai_council/one_off_archive/2026-05/_one_off_tier_retrofit.py +6 -6
  447. package/scripts/annotate_discovery.py +13 -13
  448. package/scripts/apply_modules_config.py +290 -0
  449. package/scripts/audit_adr_coverage.py +2 -2
  450. package/scripts/audit_auto_rules.py +2 -2
  451. package/scripts/audit_cloud_compatibility.py +3 -3
  452. package/scripts/audit_command_surface.py +9 -9
  453. package/scripts/audit_likelihood.py +2 -2
  454. package/scripts/audit_mcp_tools.py +1 -1
  455. package/scripts/audit_user_type_axis.py +2 -2
  456. package/scripts/bench_ab_cache_dispatch.py +68 -0
  457. package/scripts/bench_ab_clone.py +170 -0
  458. package/scripts/bench_ab_diff.py +227 -0
  459. package/scripts/bench_ab_integrity.py +143 -0
  460. package/scripts/bench_ab_run.py +235 -0
  461. package/scripts/bench_ab_task_runner.py +369 -0
  462. package/scripts/bench_ab_tracka_run.py +202 -0
  463. package/scripts/bench_baseline_ready.py +3 -3
  464. package/scripts/{bench_compress_memory.py → bench_condense_memory.py} +16 -16
  465. package/scripts/bench_drift_check.py +2 -2
  466. package/scripts/bench_per_tool.py +2 -2
  467. package/scripts/bench_run.py +36 -36
  468. package/scripts/bench_runner.py +2 -2
  469. package/scripts/bootstrap.sh +99 -0
  470. package/scripts/build_cloud_bundle.py +6 -6
  471. package/scripts/build_discovery_manifest.py +7 -7
  472. package/scripts/build_linear_digest.py +3 -3
  473. package/scripts/build_mcp_registry_manifest.py +2 -2
  474. package/scripts/build_rule_trigger_matrix.py +8 -8
  475. package/scripts/chat_history.py +5 -5
  476. package/scripts/check_always_budget.py +11 -5
  477. package/scripts/check_augment_description_cap.py +3 -3
  478. package/scripts/check_cluster_patterns.py +2 -2
  479. package/scripts/check_command_count_messaging.py +3 -3
  480. package/scripts/{check_compression.py → check_condensation.py} +34 -34
  481. package/scripts/{check_compressed_paths.py → check_condensed_paths.py} +8 -8
  482. package/scripts/check_context_paths.py +7 -7
  483. package/scripts/check_council_layout.py +2 -2
  484. package/scripts/check_council_references.py +9 -9
  485. package/scripts/check_iron_law_prominence.py +2 -2
  486. package/scripts/check_kernel_rule_bundle.py +2 -2
  487. package/scripts/check_module_management_neutral.py +149 -0
  488. package/scripts/check_no_roadmap_refs.py +9 -9
  489. package/scripts/check_portability.py +3 -3
  490. package/scripts/check_public_catalog_links.py +4 -4
  491. package/scripts/check_references.py +7 -6
  492. package/scripts/check_release_pr_shape.py +112 -0
  493. package/scripts/check_reply_consistency.py +3 -3
  494. package/scripts/check_safety_floor_untouched.py +1 -1
  495. package/scripts/check_template_pin_drift.py +5 -5
  496. package/scripts/check_token_optimizer_freshness.py +3 -3
  497. package/scripts/ci_status.py +301 -0
  498. package/scripts/ci_time_ratio.py +1 -1
  499. package/scripts/cleanup_other_scope.sh +146 -0
  500. package/scripts/compile_router.py +10 -10
  501. package/scripts/{compress.py → condense.py} +64 -64
  502. package/scripts/condense.sh +18 -0
  503. package/scripts/{compress_memory.py → condense_memory.py} +33 -33
  504. package/scripts/config/presets.py +2 -2
  505. package/scripts/config/profiles.py +1 -1
  506. package/scripts/cost_by_conversation.py +3 -3
  507. package/scripts/cost_summary.py +7 -7
  508. package/scripts/count_token_optimizer_usage.sh +1 -1
  509. package/scripts/gen_discovery_baseline.py +5 -5
  510. package/scripts/generate_index.py +6 -6
  511. package/scripts/generate_ownership_matrix.py +10 -10
  512. package/scripts/generate_pack_manifests.py +1 -1
  513. package/scripts/ghostwriter_fixture_allowlist.txt +1 -1
  514. package/scripts/install +3 -3
  515. package/scripts/install-hooks.sh +6 -6
  516. package/scripts/install.py +76 -11
  517. package/scripts/install.sh +187 -1
  518. package/scripts/inventory_frontmatter.py +2 -2
  519. package/scripts/iron_law_sha.py +3 -3
  520. package/scripts/lint_agents_layout.py +14 -7
  521. package/scripts/lint_agents_md.py +4 -4
  522. package/scripts/lint_archived_skills.py +3 -3
  523. package/scripts/lint_artefact_frontmatter.py +2 -2
  524. package/scripts/lint_bench_ab.py +172 -0
  525. package/scripts/lint_bench_corpus.py +1 -1
  526. package/scripts/lint_command_tiers.py +5 -5
  527. package/scripts/lint_context_spine_usage.py +1 -1
  528. package/scripts/lint_framework_leakage.py +7 -7
  529. package/scripts/lint_framework_leakage_allowlist.json +144 -84
  530. package/scripts/lint_ghostwriter_source.py +3 -3
  531. package/scripts/lint_handoffs.py +1 -1
  532. package/scripts/lint_load_context.py +11 -11
  533. package/scripts/lint_media_policy_linkage.py +5 -5
  534. package/scripts/lint_namespace.py +1 -1
  535. package/scripts/lint_no_new_atomic_commands.py +2 -2
  536. package/scripts/lint_orchestration_dsl.py +1 -1
  537. package/scripts/lint_pack_boundaries.py +2 -2
  538. package/scripts/lint_persona_governance.py +4 -4
  539. package/scripts/lint_role_experiences.py +237 -0
  540. package/scripts/lint_rule_interactions.py +2 -2
  541. package/scripts/lint_rule_tiers.py +1 -1
  542. package/scripts/lint_trust_coherence.py +2 -2
  543. package/scripts/mcp_registry_submit.sh +187 -0
  544. package/scripts/mcp_server/__init__.py +1 -1
  545. package/scripts/mcp_server/catalog.py +1 -1
  546. package/scripts/mcp_server/consumer_tool_catalog.json +1 -1
  547. package/scripts/mcp_server/tools.py +2 -2
  548. package/scripts/measure_frugality_savings.py +10 -10
  549. package/scripts/measure_patterns.py +1 -1
  550. package/scripts/measure_projection_bytes.py +5 -5
  551. package/scripts/measure_rule_budget.py +3 -3
  552. package/scripts/measure_skill_reduction.py +1 -1
  553. package/scripts/memory_lookup.py +1 -1
  554. package/scripts/memory_status.py +2 -2
  555. package/scripts/migrate_command_suggestions.py +3 -3
  556. package/scripts/mine_session.py +1 -1
  557. package/scripts/move_artefact.py +3 -3
  558. package/scripts/new_skill.py +2 -2
  559. package/scripts/pack_mcp_content.py +14 -14
  560. package/scripts/plan_physical_move.py +6 -6
  561. package/scripts/print_required_checks.py +196 -0
  562. package/scripts/probe_skill_registration.py +413 -0
  563. package/scripts/propose_modules_config.py +145 -0
  564. package/scripts/prototype_lint_contradictions.py +1 -1
  565. package/scripts/recruit_preflight.sh +152 -0
  566. package/scripts/refine_ticket_detect.py +3 -3
  567. package/scripts/release.py +20 -0
  568. package/scripts/render_benchmark_md.py +308 -0
  569. package/scripts/roadmap_progress_hook.py +1 -1
  570. package/scripts/run_skill_evals.py +2 -2
  571. package/scripts/runtime_registry.py +4 -4
  572. package/scripts/schemas/command.schema.json +4 -4
  573. package/scripts/schemas/rule.schema.json +5 -5
  574. package/scripts/schemas/skill.schema.json +3 -3
  575. package/scripts/schemas/user-type.schema.json +1 -1
  576. package/scripts/score_skill_selection.py +1 -1
  577. package/scripts/skill_collision_clusters.py +2 -2
  578. package/scripts/skill_linter.py +81 -81
  579. package/scripts/skill_overlap.py +5 -5
  580. package/scripts/skill_tools/audit_persona_coverage.py +2 -2
  581. package/scripts/skill_tools/audit_user_type_coverage.py +2 -2
  582. package/scripts/skill_tools/run_block_d_eval.py +1 -1
  583. package/scripts/skill_tools/score_skill_relevance.py +1 -1
  584. package/scripts/skill_tools/suggest_skill_for_task.py +1 -1
  585. package/scripts/skill_trigger_eval.py +5 -5
  586. package/scripts/smoke/kernel.sh +7 -1
  587. package/scripts/smoke/router.sh +5 -5
  588. package/scripts/smoke/skills.sh +1 -1
  589. package/scripts/smoke_quickstart.py +1 -1
  590. package/scripts/snapshot_agent_outputs.py +3 -3
  591. package/scripts/spotcheck_thin_root.py +1 -1
  592. package/scripts/{caveman_stats.py → telegraph_stats.py} +18 -18
  593. package/scripts/update_counts.py +1 -1
  594. package/scripts/validate_decision_engine.py +1 -1
  595. package/scripts/validate_frontmatter.py +1 -1
  596. package/scripts/validate_safe_paths.py +3 -3
  597. package/scripts/{validate_caveman_carveouts.py → validate_telegraph_carveouts.py} +7 -7
  598. package/scripts/verify_roadmap_closure.py +6 -6
  599. package/templates/consumer-settings/ONBOARDING.md +41 -0
  600. package/.agent-src/commands/install-via-agent.md +0 -129
  601. package/.agent-src/skills/compress-memory/SKILL.md +0 -131
  602. package/dist/ui/assets/index-D-DY1ywI.js +0 -35
  603. package/dist/ui/assets/index-D-DY1ywI.js.map +0 -1
  604. package/dist/ui/assets/index-Dqfhmg-d.css +0 -1
  605. package/docs/adrs/caveman/README.md +0 -9
  606. package/docs/contracts/caveman-telemetry.md +0 -83
  607. package/scripts/compress.sh +0 -18
@@ -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
@@ -7,7 +7,7 @@ mcp_scope: lite
7
7
 
8
8
  > **Status:** Active · governs the `experimental → beta` promotion for
9
9
  > the MCP surface (`scripts/mcp_server/` local stdio kernel + the
10
- > hosted `workers/mcp/` bridge). Owned by Phase 3 of the
10
+ > hosted `internal/workers/mcp/` bridge). Owned by Phase 3 of the
11
11
  > `road-to-surface-discipline` roadmap (see `agents/roadmaps/`).
12
12
  > Companion contract:
13
13
  > [`mcp-phase-1-scope.md`](mcp-phase-1-scope.md) (local) ·
@@ -5,7 +5,7 @@ mcp_scope: lite
5
5
 
6
6
  # MCP Server — Cloud Scope (A0-cloud Hard Contract)
7
7
 
8
- > **Status:** Active · covers `workers/mcp/` (TypeScript Cloudflare
8
+ > **Status:** Active · covers `internal/workers/mcp/` (TypeScript Cloudflare
9
9
  > Worker bridge), MVP-1 surface. Extends — does **not** supersede —
10
10
  > [`mcp-phase-1-scope.md`](mcp-phase-1-scope.md), which retains
11
11
  > exclusive ownership of `scripts/mcp_server/` (local stdio).
@@ -15,7 +15,7 @@ mcp_scope: lite
15
15
  ## Purpose
16
16
 
17
17
  Locks the **execution-safety boundary** for the hosted MCP Worker. Any
18
- code under `workers/mcp/` must satisfy this contract verbatim. The
18
+ code under `internal/workers/mcp/` must satisfy this contract verbatim. The
19
19
  local stdio kernel and the hosted Worker are two distinct surfaces; a
20
20
  deviation in one is **not** authorized by a precedent in the other.
21
21
 
@@ -45,8 +45,8 @@ 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/`.
49
- - **Owner code path:** `workers/mcp/` (TypeScript, Cloudflare Worker).
48
+ call upstream LLM APIs, or read `.agent-src.uncondensed/`.
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)
52
52
  per `## Auth surface`. HMAC and CF Access are declared but deferred.
@@ -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
@@ -194,7 +194,7 @@ runtime mode switch.
194
194
  returns HTTP `401` with a JSON-RPC error envelope (code `-32001`,
195
195
  message `"Unauthorized"`) and the RFC 6750
196
196
  `WWW-Authenticate: Bearer realm="agent-config-mcp"` header.
197
- Implementation: `workers/mcp/src/index.ts` § auth gate (the
197
+ Implementation: `internal/workers/mcp/src/index.ts` § auth gate (the
198
198
  `if (requiredToken) { … }` block).
199
199
  - **Liveness carve-out:** the `GET /` liveness probe is
200
200
  unauthenticated by design — health checks and `curl` smoke tests
@@ -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
@@ -52,7 +52,7 @@
52
52
  "tools_count": {
53
53
  "type": "integer",
54
54
  "minimum": 0,
55
- "description": "Sourced from workers/mcp/content.json#/tool_catalog/tools. Hard-sourced — no fallback. R3 (discovery roadmap) is a hard prerequisite per the AI-Council external review."
55
+ "description": "Sourced from internal/workers/mcp/content.json#/tool_catalog/tools. Hard-sourced — no fallback. R3 (discovery roadmap) is a hard prerequisite per the AI-Council external review."
56
56
  },
57
57
  "install_hint_stdio": { "type": "string", "minLength": 1 }
58
58
  }
@@ -47,7 +47,7 @@ keep-beta-until: 2026-08-14
47
47
  ## Glossary
48
48
 
49
49
  - **Side-effect** — `ro` (read-only) · `fs-write` (filesystem write) · `shell` (spawns processes).
50
- - **Transports** — `stdio` (`scripts/mcp_server/`) · `worker` (`workers/mcp/`). A tool may live on both.
50
+ - **Transports** — `stdio` (`scripts/mcp_server/`) · `worker` (`internal/workers/mcp/`). A tool may live on both.
51
51
  - **Stub** — catalog-listed for discovery; returns the `not_implemented` envelope from
52
52
  [`mcp-tool-stub-envelope.md`](mcp-tool-stub-envelope.md) until promoted.
53
53
 
@@ -20,7 +20,7 @@ a 500.
20
20
  ## Source of truth
21
21
 
22
22
  `scripts/mcp_server/consumer_tool_catalog.json` (schema_version 1).
23
- Both the stdio server and the Cloud Worker bundle (`workers/mcp/`,
23
+ Both the stdio server and the Cloud Worker bundle (`internal/workers/mcp/`,
24
24
  packed by `scripts/pack_mcp_content.py`) read from this file. The
25
25
  manifest returned by `tools/list` is byte-identical apart from
26
26
  per-tool `implemented_on` metadata.
@@ -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
@@ -24,7 +24,7 @@ Four axes, all numeric, all reproducible from the same input:
24
24
 
25
25
  Schemas: [`benchmark-report-schema.md`](benchmark-report-schema.md) ·
26
26
  [`benchmark-corpus-spec.md`](benchmark-corpus-spec.md). Reports land at
27
- `bench/reports/<utc-stamp>-<corpus>[-projection].{json,md}` —
27
+ `internal/bench/reports/<utc-stamp>-<corpus>[-projection].{json,md}` —
28
28
  timestamped, never overwritten, content-addressed by run.
29
29
 
30
30
  ## Corpora — frozen for the soak window
@@ -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
 
@@ -67,30 +67,30 @@ NO ANECDOTE, NO INDIVIDUAL REPORT, NO ROADMAP-SIDE OVERRIDE.
67
67
  [`scripts/bench_baseline_ready.py`](../../scripts/bench_baseline_ready.py)
68
68
  returns exit 0 iff both:
69
69
 
70
- 1. **Wall-clock soak:** `today − bench/baseline-start.txt ≥ --min-days` (default 60)
71
- 2. **Report density:** `bench/reports/*-<corpus>.json` count ≥ `--min-reports` (default 30)
70
+ 1. **Wall-clock soak:** `today − internal/bench/baseline-start.txt ≥ --min-days` (default 60)
71
+ 2. **Report density:** `internal/bench/reports/*-<corpus>.json` count ≥ `--min-reports` (default 30)
72
72
 
73
- Soak start anchored at [`bench/baseline-start.txt`](../../bench/baseline-start.txt)
73
+ Soak start anchored at [`internal/bench/baseline-start.txt`](../../bench/baseline-start.txt)
74
74
  = **2026-05-16**. Earliest possible flip: **2026-07-15**, contingent
75
75
  on the 30-report floor.
76
76
 
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
- P2 roadmap reads — not the live `bench/reports/` directory.
89
+ P2 roadmap reads — not the live `internal/bench/reports/` directory.
90
90
 
91
91
  ## Carve-outs
92
92
 
93
- - **Pricing freshness:** [`bench/pricing.yaml`](../../bench/pricing.yaml) rows must carry `sourced_on: YYYY-MM-DD`. Stale prices = stale numbers = no trust (ruflo "measured-vs-claimed" pattern).
93
+ - **Pricing freshness:** [`internal/bench/pricing.yaml`](../../bench/pricing.yaml) rows must carry `sourced_on: YYYY-MM-DD`. Stale prices = stale numbers = no trust (ruflo "measured-vs-claimed" pattern).
94
94
  - **Subjective grading excluded:** quality scoring is mechanical via `quality_assertion`. No vibes.
95
95
  - **Cursor / Cline / Windsurf:** rules-only surfaces, no SKILL.md projection. `bench:projection` reports them as `not_applicable` — the gap is acknowledged, not silently dropped.
96
96
 
@@ -98,5 +98,5 @@ P2 roadmap reads — not the live `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
@@ -8,11 +8,11 @@ keep-beta-until: 2026-08-13
8
8
  **Status:** beta · **Phase 4 of the `step-1-v2-feedback-followup`
9
9
  roadmap** (under `agents/roadmaps/`).
10
10
 
11
- Names the **per-tool guarantees** the projection pipeline (`scripts/compress.py --sync` + `scripts/compress.py --generate-tools`) actually delivers. Byte-equivalence is not behaviour-fidelity — each consumer tool has its own frontmatter grammar, its own activation model, and its own surface for skills / rules / commands.
11
+ Names the **per-tool guarantees** the projection pipeline (`scripts/condense.py --sync` + `scripts/condense.py --generate-tools`) actually delivers. Byte-equivalence is not behaviour-fidelity — each consumer tool has its own frontmatter grammar, its own activation model, and its own surface for skills / rules / commands.
12
12
 
13
13
  ## Source of truth
14
14
 
15
- Every projection starts from `.agent-src/` (compressed) which is generated from `.agent-src.uncompressed/`. The projection layer **never** writes to source; it only reads.
15
+ Every projection starts from `.agent-src/` (condensed) which is generated from `.agent-src.uncondensed/`. The projection layer **never** writes to source; it only reads.
16
16
 
17
17
  ## Per-tool projection map
18
18
 
@@ -96,7 +96,7 @@ These are **architectural facts**, not regressions. They are documented so insta
96
96
  2. **Windsurf single-file (`.windsurfrules`) strips per-rule frontmatter.** Legacy compatibility surface. The new `.windsurf/rules/*.md` per-rule files preserve the full frontmatter — consumers should prefer those.
97
97
  3. **Skills do not project to Cursor / Windsurf / Cline / Gemini / Copilot.** These tools have no native skill loader. Skill content reaches consumers indirectly via rule bodies and the `AGENTS.md` catalogue.
98
98
  4. **Augment historically did not load symlinked rules.** Default is to **copy** rules into `.augment/rules/`. Opt into symlinks via `augment.rules_use_symlinks: true` in `.agent-settings.yml`.
99
- 5. **`task generate-tools` does not refresh `.augment/rules/`.** Only `task sync` (== `scripts/compress.py --sync`) copies rules into the Augment tree. Investigators who edit a rule, run only `generate-tools`, and then `ls .augment/rules/` will see stale state.
99
+ 5. **`task generate-tools` does not refresh `.augment/rules/`.** Only `task sync` (== `scripts/condense.py --sync`) copies rules into the Augment tree. Investigators who edit a rule, run only `generate-tools`, and then `ls .augment/rules/` will see stale state.
100
100
 
101
101
  ## Acceptance criteria for this contract
102
102
 
@@ -108,7 +108,7 @@ These are **architectural facts**, not regressions. They are documented so insta
108
108
 
109
109
  ## Related
110
110
 
111
- - [`source-projection`](../architecture/source-projection.md) — pipeline A (source compression)
111
+ - [`source-projection`](../architecture/source-projection.md) — pipeline A (source condensation)
112
112
  - [`augment-projection`](../architecture/augment-projection.md) — pipeline B (Augment-specific)
113
113
  - [`multi-tool-projection`](../architecture/multi-tool-projection.md) — pipeline C (the per-tool emitters)
114
114
  - [`rule-router`](rule-router.md) — the `triggers:` / `routes_to:` grammar this contract pins
@@ -59,10 +59,10 @@ skipped by the linter.
59
59
 
60
60
  | Type | Source path | Naming nuance |
61
61
  |---|---|---|
62
- | Skill | `.agent-src.uncompressed/skills/<name>/SKILL.md` | Directory name == frontmatter `name`. |
63
- | Rule | `.agent-src.uncompressed/rules/<name>.md` | Filename stem == frontmatter `id` (when present). |
64
- | Command | `.agent-src.uncompressed/commands/<name>.md` or `<group>/<verb>.md` | Slash-command invocation `<name>` or `<group>:<verb>`. |
65
- | Persona | `.agent-src.uncompressed/personas/<name>.md` | Cited from skill frontmatter `personas:` list. |
62
+ | Skill | `.agent-src.uncondensed/skills/<name>/SKILL.md` | Directory name == frontmatter `name`. |
63
+ | Rule | `.agent-src.uncondensed/rules/<name>.md` | Filename stem == frontmatter `id` (when present). |
64
+ | Command | `.agent-src.uncondensed/commands/<name>.md` or `<group>/<verb>.md` | Slash-command invocation `<name>` or `<group>:<verb>`. |
65
+ | Persona | `.agent-src.uncondensed/personas/<name>.md` | Cited from skill frontmatter `personas:` list. |
66
66
 
67
67
  Sub-namespacing (`commit/in-chunks.md` → `/commit:in-chunks`) uses
68
68
  the same charset rules per segment; the joining colon is implicit.
@@ -13,7 +13,7 @@ that re-runs the same step sequence with the same inputs.
13
13
  **Scope.** Defines the file location, top-level shape, step kinds,
14
14
  input / output wiring, and the linter contract. Does **not** define
15
15
  the runtime semantics of each step kind — those live in the
16
- [`/orchestrate`](../../.agent-src.uncompressed/commands/orchestrate.md)
16
+ [`/orchestrate`](../../.agent-src.uncondensed/commands/orchestrate.md)
17
17
  command and the `work_engine` directive modules it delegates to.
18
18
 
19
19
  Last refreshed: 2026-05-11.
@@ -95,10 +95,10 @@ outputs:
95
95
 
96
96
  | `kind` | `ref` resolves to | Runtime |
97
97
  |---|---|---|
98
- | `skill` | `.agent-src.uncompressed/skills/<ref>/SKILL.md` | Dispatched via `work_engine` directive matching the skill's domain. |
99
- | `command` | `.agent-src.uncompressed/commands/<ref>.md` | Same dispatch path the slash-command takes when typed by the user. |
100
- | `persona` | `.agent-src.uncompressed/personas/<ref>.md` | Sets `roles.active_role` for the next dependent step; does not produce its own output. |
101
- | `subagent` | `subagent-orchestration` mode name | Spawned per [`subagent-orchestration`](../../.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md). |
98
+ | `skill` | `.agent-src.uncondensed/skills/<ref>/SKILL.md` | Dispatched via `work_engine` directive matching the skill's domain. |
99
+ | `command` | `.agent-src.uncondensed/commands/<ref>.md` | Same dispatch path the slash-command takes when typed by the user. |
100
+ | `persona` | `.agent-src.uncondensed/personas/<ref>.md` | Sets `roles.active_role` for the next dependent step; does not produce its own output. |
101
+ | `subagent` | `subagent-orchestration` mode name | Spawned per [`subagent-orchestration`](../../.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md). |
102
102
 
103
103
  ## Interpolation
104
104
 
@@ -147,7 +147,7 @@ majors.
147
147
 
148
148
  ## Cross-references
149
149
 
150
- - Command surface: [`/orchestrate`](../../.agent-src.uncompressed/commands/orchestrate.md).
150
+ - Command surface: [`/orchestrate`](../../.agent-src.uncondensed/commands/orchestrate.md).
151
151
  - Linter: [`lint_orchestration_dsl.py`](../../scripts/lint_orchestration_dsl.py).
152
152
  - Runtime dispatcher precedent: [`implement-ticket-flow.md`](implement-ticket-flow.md).
153
- - Subagent runtime: [`subagent-orchestration`](../../.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md).
153
+ - Subagent runtime: [`subagent-orchestration`](../../.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md).