@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
@@ -6,11 +6,11 @@ lens at a time. Adopted under the **Reference-Guideline Sunset Policy**
6
6
  (see frontmatter `upstream` / `refresh_trigger` keys) and cross-referenced
7
7
  from:
8
8
 
9
- - [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
9
+ - [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
10
10
  — L3 Deep analysis depth.
11
- - [`refine-prompt`](../../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
11
+ - [`refine-prompt`](../../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
12
12
  — multi-lens prompt refinement.
13
- - [`judge-bug-hunter`](../../../.agent-src.uncompressed/skills/judge-bug-hunter/SKILL.md)
13
+ - [`judge-bug-hunter`](../../../.agent-src.uncondensed/skills/judge-bug-hunter/SKILL.md)
14
14
  — diff review through more than the bug-hunter lens.
15
15
 
16
16
  > **Core principle:** "To a man with only a hammer, every problem looks
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Any touch to agents/roadmaps/ — create/rename/delete/move, edit checkboxes ([x]/[~]/[-]), add/rename/remove phases — must regenerate dashboard and archive if 0 open items, same response
4
4
 
5
- _Origin: migrated from `.agent-src.uncompressed/rules/roadmap-progress-sync.md` per P4.2 of `road-to-kernel-and-router.md`._
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/roadmap-progress-sync.md` per P4.2 of `road-to-kernel-and-router.md`._
6
6
 
7
7
  <!-- cloud_safe: degrade -->
8
8
  <!-- Authoring discipline applies in cloud; local script + regen are no-ops there. -->
@@ -147,7 +147,7 @@ dashboard, commit if commit policy allows.
147
147
  A reply that lands a verified step without flipping its checkbox is a rule violation.
148
148
 
149
149
  **Deterministic flip-guard.** The autonomous loop carries a per-step
150
- guard at [`roadmap-process-loop § 5b`](../../.agent-src.uncompressed/contexts/execution/roadmap-process-loop.md#5b-flip-guard--deterministic):
150
+ guard at [`roadmap-process-loop § 5b`](../../.agent-src.uncondensed/contexts/execution/roadmap-process-loop.md#5b-flip-guard--deterministic):
151
151
  after the atomic flip, the loop runs
152
152
  `git diff --name-only -- agents/roadmaps/<file>.md` and halts loudly
153
153
  when the diff is empty. The `command:` triggers on
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Creating or editing rules, or auditing rule types — decides when a rule should be always vs auto
4
4
 
5
- _Origin: migrated from `.agent-src.uncompressed/rules/rule-type-governance.md` per P4.2 of `road-to-kernel-and-router.md`._
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/rule-type-governance.md` per P4.2 of `road-to-kernel-and-router.md`._
6
6
 
7
7
  # rule-type-governance
8
8
 
@@ -17,16 +17,16 @@ refresh trigger.
17
17
 
18
18
  Cross-referenced from:
19
19
 
20
- - [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
20
+ - [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
21
21
  — Step 2B structural decomposition (always run, all depths).
22
- - [`agent-docs-writing`](../../../.agent-src.uncompressed/skills/agent-docs-writing/SKILL.md)
22
+ - [`agent-docs-writing`](../../../.agent-src.uncondensed/skills/agent-docs-writing/SKILL.md)
23
23
  — narrative structure for module docs and AGENTS.md.
24
- - [`requesting-code-review`](../../../.agent-src.uncompressed/skills/requesting-code-review/SKILL.md)
24
+ - [`requesting-code-review`](../../../.agent-src.uncondensed/skills/requesting-code-review/SKILL.md)
25
25
  — PR description structure (S = current state, C = pain point,
26
26
  Q = scope, A = the diff).
27
- - [`refine-prompt`](../../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
27
+ - [`refine-prompt`](../../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
28
28
  — reconstruct a free-form prompt into S-C-Q-A acceptance criteria.
29
- - [`refine-ticket`](../../../.agent-src.uncompressed/skills/refine-ticket/SKILL.md)
29
+ - [`refine-ticket`](../../../.agent-src.uncondensed/skills/refine-ticket/SKILL.md)
30
30
  — Jira / Linear ticket clarification through the four-element lens.
31
31
 
32
32
  > **The 4 elements:** S (Situation) · C (Complication) · Q (Question)
@@ -92,7 +92,7 @@ blocks — it does not hand a half-filled doc to the next stage.
92
92
  proposal doc as the PR body. Standard package CI runs.
93
93
  Frontmatter `stage: upstream` and `upstream_pr_url` set.
94
94
  - **Guardrails:** no `upstream-contribute` invocation ever edits
95
- `.agent-src.uncompressed/` in the consumer repo. Writes happen
95
+ `.agent-src.uncondensed/` in the consumer repo. Writes happen
96
96
  in the fork / PR branch of the package repo only.
97
97
 
98
98
  ## Stage ownership
@@ -122,7 +122,7 @@ unreviewed upstream changes is not.
122
122
  need the evidence in one place.
123
123
  - **Do NOT** promote a learning with one piece of evidence. Two
124
124
  independent sources is the minimum; the gate enforces it.
125
- - **Do NOT** edit `.agent-src.uncompressed/` directly in a consumer
125
+ - **Do NOT** edit `.agent-src.uncondensed/` directly in a consumer
126
126
  project "just to try it out". Drafts live in `agents/proposals/`.
127
127
  - **Do NOT** treat a `block` verdict as a personal rejection. The
128
128
  gate checks structural shape, not author intent.
@@ -7,12 +7,12 @@ separate thinking modes and avoid the cross-talk that derails group
7
7
  decisions. Adopted under the **Reference-Guideline Sunset Policy** and
8
8
  cross-referenced from:
9
9
 
10
- - [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
10
+ - [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
11
11
  — L2 Standard analysis depth (multi-perspective sweep).
12
- - [`ai-council`](../../../.agent-src.uncompressed/skills/ai-council/SKILL.md)
12
+ - [`ai-council`](../../../.agent-src.uncondensed/skills/ai-council/SKILL.md)
13
13
  — multi-model consultation pattern; Six Hats is the per-perspective
14
14
  decomposition the council voices use when adjudicating a decision.
15
- - [`/council`](../../../.agent-src.uncompressed/commands/council.md)
15
+ - [`/council`](../../../.agent-src.uncondensed/commands/council.md)
16
16
  — internal council orchestrator routing to per-hat persona prompts.
17
17
 
18
18
  > **Core principle:** "Wear one hat at a time." — separating thinking
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Creating, editing, or reviewing skills — minimum quality standard, every skill must be executable, validated, and self-contained
4
4
 
5
- _Origin: migrated from `.agent-src.uncompressed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
6
6
 
7
7
  # Skill Quality
8
8
 
@@ -50,14 +50,14 @@ If a skill is not executable without opening a guideline, it is broken.
50
50
  **Litmus test:** Cover all guideline references in the Procedure. Is it still executable?
51
51
  If not → the skill needs more own steps, decisions, and validation — not more guideline links.
52
52
 
53
- ## Merge & Compression Preservation
53
+ ## Merge & Condensation Preservation
54
54
 
55
- When merging or compressing skills, the result MUST preserve the
55
+ When merging or condensing skills, the result MUST preserve the
56
56
  strongest validation, strongest examples, all anti-patterns, all
57
57
  decision criteria, and trigger quality. Full preservation invariants
58
- and "merge is invalid if …" / "compression may remove …" lists in
58
+ and "merge is invalid if …" / "condensation may remove …" lists in
59
59
  [`contexts/communication/rules-auto/skill-quality-mechanics.md`](../contexts/communication/rules-auto/skill-quality-mechanics.md)
60
- § Merge Preservation and § Compression Preservation.
60
+ § Merge Preservation and § Condensation Preservation.
61
61
 
62
62
  ## Refactor Safety
63
63
 
@@ -7,7 +7,7 @@ feedback loops, leverage points, and cross-domain archetypes that
7
7
  reveal where intervention has the highest impact. Adopted under the
8
8
  **Reference-Guideline Sunset Policy** and cross-referenced from:
9
9
 
10
- - [`deep-reading-analyst`](../../../.agent-src.uncompressed/skills/deep-reading-analyst/SKILL.md)
10
+ - [`deep-reading-analyst`](../../../.agent-src.uncondensed/skills/deep-reading-analyst/SKILL.md)
11
11
  — L3 Deep analysis depth.
12
12
  - [`mental-models`](mental-models.md) — Munger's lattice; systems
13
13
  thinking is one of the strongest engineering / biology lenses.
@@ -13,7 +13,7 @@ prose_delta:
13
13
  > Wrong / right / why demos for the `verify-before-complete` Iron
14
14
  > Law (no completion claim without fresh evidence in this message).
15
15
  > Linked from
16
- > [`verify-before-complete`](../../.agent-src.uncompressed/rules/verify-before-complete.md)
16
+ > [`verify-before-complete`](../../.agent-src.uncondensed/rules/verify-before-complete.md)
17
17
  > § Examples. Outcome baseline at
18
18
  > [`tests/golden/outcomes/verify_before_complete.json`](../../tests/golden/outcomes/verify_before_complete.json).
19
19
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Editing or creating files inside .augment/ directory — skills, rules, commands, templates, contexts must be project-agnostic
4
4
 
5
- _Origin: migrated from `.agent-src.uncompressed/rules/augment-portability.md` per P4.2 of `road-to-kernel-and-router.md`._
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/augment-portability.md` per P4.2 of `road-to-kernel-and-router.md`._
6
6
 
7
7
  # Package Portability
8
8
 
@@ -39,8 +39,8 @@ content into any of them pollutes downstream projects or misleads agents.
39
39
  Skills, rules, commands, guidelines, personas, and context docs run in
40
40
  **consumer projects**, which may not have Task installed. **Never**
41
41
  reference a `task <something>` invocation inside any artefact file
42
- under `.agent-src.uncompressed/{skills,rules,commands,guidelines,personas,contexts}/`
43
- (and therefore also not in the compressed mirror under `.agent-src/`).
42
+ under `.agent-src.uncondensed/{skills,rules,commands,guidelines,personas,contexts}/`
43
+ (and therefore also not in the condensed mirror under `.agent-src/`).
44
44
  Use direct script invocations instead.
45
45
 
46
46
  ## Consumer CLI — `./agent-config`
@@ -61,7 +61,7 @@ invocation.
61
61
 
62
62
  ## Enforcement
63
63
 
64
- `scripts/check_portability.py` scans `.augment/`, `.agent-src.uncompressed/`,
64
+ `scripts/check_portability.py` scans `.augment/`, `.agent-src.uncondensed/`,
65
65
  and the package repo's root `AGENTS.md` + `.github/copilot-instructions.md`
66
66
  for forbidden identifiers, for any `task <name>` invocation inside
67
67
  artefact files, and for direct script invocations that bypass the
@@ -93,7 +93,7 @@ Council Q3 (2026-05-05) locks the disambiguation between L4
93
93
  shipping — becomes **input to L4**. The escalation is one-way:
94
94
  L4 produces the dissent log that decides whether C8's verdict
95
95
  is overridden, with the override recorded in
96
- [`decision-record`](../../.agent-src.uncompressed/skills/decision-record/SKILL.md).
96
+ [`decision-record`](../../.agent-src.uncondensed/skills/decision-record/SKILL.md).
97
97
 
98
98
  The boundary keeps the two skills sharp — neither absorbs the other —
99
99
  and gives the agent a deterministic rule for which one to load when
@@ -123,5 +123,5 @@ No cluster collision, no tier mismatch, no untyped drift.
123
123
  - [`docs/contracts/context-spine.md`](../contracts/context-spine.md)
124
124
  — orthogonal context-slot mechanism, often used together with a
125
125
  handoff (e.g. delegate reads `team` slot the initiator opted in to).
126
- - `.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md` § mode 6
126
+ - `.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md` § mode 6
127
127
  — when the chain runs in fresh worktrees.
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Writing or reviewing PHP code — strict types, naming, comparisons, early returns, Eloquent conventions
4
4
 
5
- _Origin: migrated from `.agent-src.uncompressed/rules/php-coding.md` per P4.2 of `road-to-kernel-and-router.md`._
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/php-coding.md` per P4.2 of `road-to-kernel-and-router.md`._
6
6
 
7
7
  # PHP Coding Rules
8
8
 
@@ -1,8 +1,8 @@
1
1
  # Prompt Templates
2
2
 
3
- Reference catalogue of prompt structures the [`prompt-optimizer`](../../.agent-src.uncompressed/skills/prompt-optimizer/SKILL.md)
3
+ Reference catalogue of prompt structures the [`prompt-optimizer`](../../.agent-src.uncondensed/skills/prompt-optimizer/SKILL.md)
4
4
  skill picks from during the **Develop** step of the 4-D methodology.
5
- Cited by the [`refine-prompt`](../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md)
5
+ Cited by the [`refine-prompt`](../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md)
6
6
  skill in `mini` mode for stack-aware shaping.
7
7
 
8
8
  Templates are tools, not dogma. Pick by request type, not by upstream
@@ -108,7 +108,7 @@ warrants either reaction. The stance slot makes the honest-when-warranted
108
108
  contract explicit.
109
109
 
110
110
  **Package equivalents** — inside this agent-config, the
111
- [`adversarial-review`](../../.agent-src.uncompressed/skills/adversarial-review/SKILL.md)
111
+ [`adversarial-review`](../../.agent-src.uncondensed/skills/adversarial-review/SKILL.md)
112
112
  skill implements the same stance via an Attack-Defend-Revise loop and is
113
113
  the right tool when the user submits finished work for a critical take.
114
114
  This template is for **end-users prompting their own LLM** (ChatGPT,
@@ -160,7 +160,7 @@ membership.
160
160
 
161
161
  ## See also
162
162
 
163
- - [`prompt-optimizer`](../../.agent-src.uncompressed/skills/prompt-optimizer/SKILL.md) — engine-outbound; cites this catalogue in its Develop step
164
- - [`refine-prompt`](../../.agent-src.uncompressed/skills/refine-prompt/SKILL.md) — engine-inbound; uses templates in `mini` mode for stack-aware shaping
165
- - [`prompt-engineering-patterns`](../../.agent-src.uncompressed/skills/prompt-engineering-patterns/SKILL.md) — production-LLM prompt patterns (sibling skill, not a catalogue)
163
+ - [`prompt-optimizer`](../../.agent-src.uncondensed/skills/prompt-optimizer/SKILL.md) — engine-outbound; cites this catalogue in its Develop step
164
+ - [`refine-prompt`](../../.agent-src.uncondensed/skills/refine-prompt/SKILL.md) — engine-inbound; uses templates in `mini` mode for stack-aware shaping
165
+ - [`prompt-engineering-patterns`](../../.agent-src.uncondensed/skills/prompt-engineering-patterns/SKILL.md) — production-LLM prompt patterns (sibling skill, not a catalogue)
166
166
  - AI Council session: `agents/runtime/council/responses/prompt-master-mini.json` (2026-05-17) <!-- council-ref-allowed: ADR decision trace -->
@@ -73,7 +73,7 @@ the flag is set outside the package repo.
73
73
  - **Audit-visible.** Every install run logs whether the flag was set
74
74
  at the top of the transaction log.
75
75
  - **No silent fallback.** If `scripts/install.py` detects the
76
- package repo signature (presence of `.agent-src.uncompressed/` plus
76
+ package repo signature (presence of `.agent-src.uncondensed/` plus
77
77
  `dist/router.json`) and the flag is **not** set, the install
78
78
  refuses with a one-line error pointing here.
79
79
  - **Not for consumers.** Setting the flag in a consumer project is
package/docs/mcp.md CHANGED
@@ -138,7 +138,7 @@ secret tool you already use into the process environment before you run
138
138
 
139
139
  ## Related
140
140
 
141
- - [`.agent-src.uncompressed/skills/mcp/SKILL.md`](../.agent-src.uncompressed/skills/mcp/SKILL.md) — MCP server
141
+ - [`.agent-src.uncondensed/skills/mcp/SKILL.md`](../.agent-src.uncondensed/skills/mcp/SKILL.md) — MCP server
142
142
  selection and usage patterns.
143
143
  - [`agents/roadmaps/archive/road-to-mcp.md`](../agents/roadmaps/archive/road-to-mcp.md) — archived roadmap that produced this feature.
144
144
  - Reference substitution implementation: [`kdcllc/agents_config`](https://github.com/kdcllc/agents_config/blob/master/app/agents_config/base.py).
@@ -27,8 +27,8 @@
27
27
  "projection_fidelity_windsurf": "not_applicable"
28
28
  },
29
29
  "decisions_pending": {
30
- "compression_default": {
31
- "kill_criterion": "docs/contracts/compression-default-kill-criterion.md",
30
+ "condensation_default": {
31
+ "kill_criterion": "docs/contracts/condensation-default-kill-criterion.md",
32
32
  "verdict": "deferred_until_baseline_closes",
33
33
  "decision_owner": "step-4 closeout phase"
34
34
  }
@@ -36,6 +36,6 @@
36
36
  "downstream_consumers": [
37
37
  "agents/roadmaps/step-99-north-star-restructure.md#G1",
38
38
  "agents/roadmaps/step-2-skill-inventory-rationalization.md#G0",
39
- "docs/contracts/compression-default-kill-criterion.md"
39
+ "docs/contracts/condensation-default-kill-criterion.md"
40
40
  ]
41
41
  }
@@ -28,9 +28,9 @@ soak in [`bench.json`](bench.json) flips from `warmup` to `baseline_ready`
28
28
  | 3 | **50/75/90/100 % budget ladder with hard stop** | `[x] covered by` | [`scripts/cost/budget.mjs`](../../scripts/cost/budget.mjs) — exit codes 0/1/2/3 per tier; opt-in fail-closed via `cost.enforcement` setting. Fixtures: `tests/fixtures/cost/budget/{under-50,at-100,over-100}/`. Step-11 Phase 2. |
29
29
  | 4 | **Measured-vs-claimed disclaimer** — every percentage tagged "claimed upstream" | `[x] covered by` | One-line `**Measured-vs-claimed disclaimer:**` header block on all 9 active roadmaps in `agents/roadmaps/`. Verified 2026-05-16. Step-11 Phase 5 Step 4. |
30
30
  | 5 | **Smoke test as contract** — `bash scripts/smoke.sh` with declared baseline | `[x] covered by` | Four per-tier smoke scripts: [`scripts/smoke/kernel.sh`](../../scripts/smoke/kernel.sh), [`router.sh`](../../scripts/smoke/router.sh), [`schema.sh`](../../scripts/smoke/schema.sh), [`skills.sh`](../../scripts/smoke/skills.sh). Declared baselines in [`docs/contracts/smoke-contracts.md`](../contracts/smoke-contracts.md). CI gate: [`.github/workflows/smoke.yml`](../../.github/workflows/smoke.yml). Step-11 Phase 3. |
31
- | 6 | **Per-plugin ADR directory** — `docs/adrs/0001-*.md` co-located with subsystem | `[x] covered by` | Six bootstrap ADRs under [`docs/adrs/{cost,memory,router,schema,smoke,caveman}/`](../adrs/). Coverage gate: [`scripts/audit_adr_coverage.py`](../../scripts/audit_adr_coverage.py) (`task lint-adr-coverage`). Contract: [`docs/contracts/adr-layout.md`](../contracts/adr-layout.md). Step-11 Phase 4. |
31
+ | 6 | **Per-plugin ADR directory** — `docs/adrs/0001-*.md` co-located with subsystem | `[x] covered by` | Six bootstrap ADRs under [`docs/adrs/{cost,memory,router,schema,smoke,telegraph}/`](../adrs/). Coverage gate: [`scripts/audit_adr_coverage.py`](../../scripts/audit_adr_coverage.py) (`task lint-adr-coverage`). Contract: [`docs/contracts/adr-layout.md`](../contracts/adr-layout.md). Step-11 Phase 4. |
32
32
  | 7 | **Namespace contract** — `<stem>-<intent>` kebab-case, reserved-names list | `[x] covered by` | [`scripts/lint_namespace.py`](../../scripts/lint_namespace.py) enforces shape + length floors + reserved-names + skill-dir-matches-name across 430 names · 0 issues. Contract: [`docs/contracts/namespace.md`](../contracts/namespace.md). CI gate: `task lint-namespace`. Step-11 Phase 5 Step 1. |
33
- | 8 | **Topology choices in swarm** — `hierarchical / mesh / star / adaptive` with anti-drift defaults | `[x] covered by` | [`.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md`](../../.agent-src.uncompressed/skills/subagent-orchestration/SKILL.md) `Topology hints` subsection — 7-row table mapping each mode to topology + Ruflo anti-drift default (`hierarchical, 6–8 agents, raft consensus`). Step-11 Phase 5 Step 2. |
33
+ | 8 | **Topology choices in swarm** — `hierarchical / mesh / star / adaptive` with anti-drift defaults | `[x] covered by` | [`.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md`](../../.agent-src.uncondensed/skills/subagent-orchestration/SKILL.md) `Topology hints` subsection — 7-row table mapping each mode to topology + Ruflo anti-drift default (`hierarchical, 6–8 agents, raft consensus`). Step-11 Phase 5 Step 2. |
34
34
  | 9 | **MCP-tool count + source-line refs** — every tool with `<file>:<line>` citation | `[x] covered by` | [`docs/contracts/mcp-tool-inventory.md`](../contracts/mcp-tool-inventory.md) — 20 tools (9 stdio-implemented · 11 discovery stubs) each with catalog `<file>:<line>` + handler `<file>:<line>`. Generator: [`scripts/audit_mcp_tools.py`](../../scripts/audit_mcp_tools.py). CI drift gate: `task lint-mcp-inventory`. Step-11 Phase 5 Step 3. |
35
35
 
36
36
  ## Open `[!]` rows
package/docs/profiles.md CHANGED
@@ -4,7 +4,7 @@ Each block below is the first-screen for one shipped profile. The
4
4
  `profile.id` written by `agent-config setup` selects the anchor; the block names
5
5
  the audience, the first three things the agent does for that role,
6
6
  and the exact commands and skills wired into the profile YAML at
7
- [`.agent-src.uncompressed/profiles/<id>.yml`](../.agent-src.uncompressed/profiles/).
7
+ [`.agent-src.uncondensed/profiles/<id>.yml`](../.agent-src.uncondensed/profiles/).
8
8
 
9
9
  The summary table at the top of [`README.md`](../README.md) is the
10
10
  one-page index; the prose below is the deep version.
@@ -18,7 +18,7 @@ and verifies; `/work` is the free-form sibling; `/review-changes`
18
18
  dispatches five judges (bug, security, tests, quality, architecture)
19
19
  on the local diff. Stack-aware skills cover Laravel · Symfony ·
20
20
  Next.js · React · Node. **Preset default: `balanced`.**
21
- [Profile YAML](../.agent-src.uncompressed/profiles/developer.yml) ·
21
+ [Profile YAML](../.agent-src.uncondensed/profiles/developer.yml) ·
22
22
  [Role guide](getting-started-by-role.md#developer-the-original-audience).
23
23
 
24
24
  <a id="profile-content_creator"></a>
@@ -35,7 +35,7 @@ motion+audio prompt → provider render → stitched clip), with
35
35
  `character-consistency` locking identity tokens across scenes and
36
36
  `AIV_DRYRUN=true` as the cost-safety default.
37
37
  **Preset default: `balanced`.**
38
- [Profile YAML](../.agent-src.uncompressed/profiles/content_creator.yml) ·
38
+ [Profile YAML](../.agent-src.uncondensed/profiles/content_creator.yml) ·
39
39
  [Role guide](getting-started-by-role.md#creator-writer-marketer-indie-content-shop).
40
40
 
41
41
  <a id="profile-founder"></a>
@@ -47,7 +47,7 @@ into a copyable pitch; `/council` polls external AIs for a neutral
47
47
  second opinion; `rice-prioritization` ranks the backlog;
48
48
  `vision-articulation` and `fundraising-narrative` shape the
49
49
  internal-vs-external story. **Preset default: `fast`.**
50
- [Profile YAML](../.agent-src.uncompressed/profiles/founder.yml) ·
50
+ [Profile YAML](../.agent-src.uncondensed/profiles/founder.yml) ·
51
51
  [Role guide](getting-started-by-role.md#founder-early-stage-operator-wearing-every-hat).
52
52
 
53
53
  <a id="profile-agency"></a>
@@ -59,7 +59,7 @@ provenance. `/refine-ticket` rewrites the ticket and surfaces top-5
59
59
  risks; `estimate-ticket` sizes and splits; `decision-record` anchors
60
60
  the trade-off in an ADR before code starts. **Preset default:
61
61
  `strict`.**
62
- [Profile YAML](../.agent-src.uncompressed/profiles/agency.yml) ·
62
+ [Profile YAML](../.agent-src.uncondensed/profiles/agency.yml) ·
63
63
  [Role guide](getting-started-by-role.md#consultant-advisory-freelance-fractional).
64
64
 
65
65
  <a id="profile-finance"></a>
@@ -70,7 +70,7 @@ walks the WACC / terminal-value / 5-year-hold reasoning; `forecasting`
70
70
  reconciles top-down vs bottom-up; `scenario-modeling` produces the
71
71
  base / upside / downside cuts; `runway-cognition` frames the
72
72
  fundraise-vs-cut-vs-grow decision. **Preset default: `strict`.**
73
- [Profile YAML](../.agent-src.uncompressed/profiles/finance.yml) ·
73
+ [Profile YAML](../.agent-src.uncondensed/profiles/finance.yml) ·
74
74
  [Role guide](getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance).
75
75
 
76
76
  <a id="profile-ops"></a>
@@ -82,15 +82,15 @@ breaks, build the dashboard that catches it next time.
82
82
  the first line of code; `incident-commander` frames severity and
83
83
  post-mortem; `dashboard-design` chooses the right RED / USE / Golden
84
84
  Signal panel. **Preset default: `strict`.**
85
- [Profile YAML](../.agent-src.uncompressed/profiles/ops.yml) ·
85
+ [Profile YAML](../.agent-src.uncondensed/profiles/ops.yml) ·
86
86
  [Role guide](getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance).
87
87
 
88
88
  > **Universal AI Agent OS, not "for developers only".** The same
89
89
  > orchestration core also drives non-software trades. Worked-example
90
- > user types ship for [galabau](../.agent-src.uncompressed/user-types/galabau-field-crew.md),
91
- > [metalworking](../.agent-src.uncompressed/user-types/metalworking-shop.md),
92
- > [truck driving](../.agent-src.uncompressed/user-types/truck-driver.md) —
93
- > with a [scaffold](../.agent-src.uncompressed/user-types/_template/) for
90
+ > user types ship for [galabau](../.agent-src.uncondensed/user-types/galabau-field-crew.md),
91
+ > [metalworking](../.agent-src.uncondensed/user-types/metalworking-shop.md),
92
+ > [truck driving](../.agent-src.uncondensed/user-types/truck-driver.md) —
93
+ > with a [scaffold](../.agent-src.uncondensed/user-types/_template/) for
94
94
  > contributing your own.
95
95
 
96
96
  → [Public catalog](catalog.md) (all rules, skills, commands, guidelines) · [Skills only](skills-catalog.md) · [llms.txt](../llms.txt)
package/docs/quality.md CHANGED
@@ -10,8 +10,8 @@ task ci
10
10
 
11
11
  This runs, in order:
12
12
 
13
- 1. **Sync check** — `.agent-src/` matches `.agent-src.uncompressed/` (non-`.md` files)
14
- 2. **Compression hashes** — Compressed `.md` hashes match source
13
+ 1. **Sync check** — `.agent-src/` matches `.agent-src.uncondensed/` (non-`.md` files)
14
+ 2. **Condensation hashes** — Condensed `.md` hashes match source
15
15
  3. **Reference check** — No broken cross-references between files
16
16
  4. **Portability check** — No project-specific paths in shared files
17
17
  5. **Schema validation** — Frontmatter of every skill/rule/command/persona matches its JSON-Schema contract
@@ -29,7 +29,7 @@ The linter (`scripts/skill_linter.py`) validates:
29
29
  - **Required structure** — YAML frontmatter, description, triggers
30
30
  - **Frontmatter schema** — Each artefact type has a JSON-Schema in `scripts/schemas/`; violations surface as `schema_<rule>` errors (see [frontmatter contract](../agents/reference/docs/frontmatter-contract.md))
31
31
  - **Anti-patterns** — Procedural rules in behavior rules, overlong skills, scope creep
32
- - **Compression quality** — Key sections preserved after compression
32
+ - **Condensation quality** — Key sections preserved after condensation
33
33
 
34
34
  Schema validation also runs standalone via `task validate-schema` — fast
35
35
  fail before the full linter.
@@ -50,32 +50,32 @@ fail before the full linter.
50
50
 
51
51
  ---
52
52
 
53
- ## Compression System
53
+ ## Condensation System
54
54
 
55
- Content flows from verbose (`.agent-src.uncompressed/`) to compressed (`.agent-src/`),
55
+ Content flows from verbose (`.agent-src.uncondensed/`) to condensed (`.agent-src/`),
56
56
  which is then projected into `.augment/` for Augment Code.
57
57
 
58
58
  ### Rules
59
59
 
60
- - Source of truth is **always** `.agent-src.uncompressed/`
60
+ - Source of truth is **always** `.agent-src.uncondensed/`
61
61
  - Never edit `.agent-src/` or `.augment/` directly
62
- - The `/compress` command produces token-efficient output
63
- - Compression hashes track which files have been compressed
62
+ - The `/condense` command produces token-efficient output
63
+ - Condensation hashes track which files have been condensed
64
64
 
65
65
  ### Verification
66
66
 
67
67
  ```bash
68
68
  task sync-check # Non-.md files in sync?
69
69
  task sync-check-hashes # .md hashes current?
70
- task check-compression # Compression quality OK?
71
- task lint-skills-pairs # Source vs compressed comparison
70
+ task check-condensation # Condensation quality OK?
71
+ task lint-skills-pairs # Source vs condensed comparison
72
72
  ```
73
73
 
74
74
  ### Fixing
75
75
 
76
76
  ```bash
77
77
  task sync # Copy non-.md files
78
- task sync-mark-all-done # Mark all hashes as current (after manual compress)
78
+ task sync-mark-all-done # Mark all hashes as current (after manual condense)
79
79
  task consistency-fix # Regenerate ALL derived outputs
80
80
  ```
81
81
 
package/docs/safety.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Data governance & domain safety
2
2
 
3
- `agent-config` ships **12 domain-safety rules** (`.agent-src.uncompressed/rules/domain-safety-*.md`) that act as a per-domain output floor — PII redaction, disclaimer requirements, and retention guidance. Rules fire automatically via the router when their triggers match.
3
+ `agent-config` ships **12 domain-safety rules** (`.agent-src.uncondensed/rules/domain-safety-*.md`) that act as a per-domain output floor — PII redaction, disclaimer requirements, and retention guidance. Rules fire automatically via the router when their triggers match.
4
4
 
5
5
  ## Surface → rule(s) → floor
6
6
 
@@ -21,8 +21,8 @@
21
21
 
22
22
  ## Related skills
23
23
 
24
- - [`privacy-review`](../.agent-src.uncompressed/skills/privacy-review/SKILL.md) — end-to-end data-flow review for a regulatory regime (GDPR / CCPA / HIPAA).
25
- - [`data-handling-judgment`](../.agent-src.uncompressed/skills/data-handling-judgment/SKILL.md) — classification, retention, cross-border transfer, DSR workflow.
24
+ - [`privacy-review`](../.agent-src.uncondensed/skills/privacy-review/SKILL.md) — end-to-end data-flow review for a regulatory regime (GDPR / CCPA / HIPAA).
25
+ - [`data-handling-judgment`](../.agent-src.uncondensed/skills/data-handling-judgment/SKILL.md) — classification, retention, cross-border transfer, DSR workflow.
26
26
 
27
27
  ## See also
28
28
 
@@ -33,7 +33,7 @@ look for MCP server config inside `.agent-settings.yml`.
33
33
  | File | Where | Who reads it | Purpose |
34
34
  |---|---|---|---|
35
35
  | MCP client config (this page) | client-specific path per section above | the MCP client at startup | which MCP servers to talk to (name + URL / command) |
36
- | `.agent-settings.yml` | consumer project root (`<repo>/.agent-settings.yml`) | the agent at runtime (Claude / Cursor / …) | per-developer preferences: `name`, `ide`, `cost_profile`, `personal.autonomy`, `pipelines.skill_improvement`, `caveman.speak_scope`, … |
36
+ | `.agent-settings.yml` | consumer project root (`<repo>/.agent-settings.yml`) | the agent at runtime (Claude / Cursor / …) | per-developer preferences: `name`, `ide`, `cost_profile`, `personal.autonomy`, `pipelines.skill_improvement`, `telegraph.speak_scope`, … |
37
37
 
38
38
  The Worker is **stateless** and **project-agnostic** — it serves the
39
39
  same skill / rule / command catalog to every client. Personalization
@@ -20,7 +20,7 @@ agent-config-mcp/
20
20
  ├─ releases/
21
21
  │ ├─ v<X.Y.Z>-<sha>/
22
22
  │ │ ├─ content.json.gz # gzipped content blob (R2 archival copy)
23
- │ │ └─ manifest.json # uncompressed manifest sidecar
23
+ │ │ └─ manifest.json # uncondensed manifest sidecar
24
24
  │ └─ latest.txt # one-line: v<X.Y.Z>-<sha>
25
25
  └─ (no other prefixes)
26
26
  ```
@@ -1,6 +1,6 @@
1
1
  # MCP server — Docker (stdio bundle)
2
2
 
3
- Phase-6 F3 ships `docker/mcp-server/Dockerfile`: a stdio-only image of
3
+ Phase-6 F3 ships `internal/docker/mcp-server/Dockerfile`: a stdio-only image of
4
4
  the agent-config MCP server, pinned to the same `mcp` + `PyYAML`
5
5
  versions the test suite runs against. No HTTP / SSE transport — that
6
6
  lives in [`road-to-mcp-distribution.md`](../../agents/roadmaps/road-to-mcp-distribution.md)
@@ -8,11 +8,11 @@ under its own A0 amendment.
8
8
 
9
9
  ## Build
10
10
 
11
- Build context is the **repo root**, not `docker/mcp-server/` — the
11
+ Build context is the **repo root**, not `internal/docker/mcp-server/` — the
12
12
  `COPY` lines reference paths relative to the project root.
13
13
 
14
14
  ```bash
15
- docker build -f docker/mcp-server/Dockerfile -t agent-config-mcp:local .
15
+ docker build -f internal/docker/mcp-server/Dockerfile -t agent-config-mcp:local .
16
16
  ```
17
17
 
18
18
  Tag conventions:
@@ -99,7 +99,7 @@ should match `ls .windsurf/workflows/`.
99
99
  | Rules not picked up | Windsurf < 1.0 — upgrade or rely on `.windsurfrules`. |
100
100
  | Workflow not in Cascade panel | Reload window after `task generate-tools`. |
101
101
  | Global workflows missing | Check `~/.codeium/windsurf/global_workflows/` exists. |
102
- | Frontmatter parse error | Re-run `python3 scripts/compress.py --generate-tools`. |
102
+ | Frontmatter parse error | Re-run `python3 scripts/condense.py --generate-tools`. |
103
103
 
104
104
  ## Cross-references
105
105
 
@@ -1,6 +1,6 @@
1
1
  # Skills Catalog
2
2
 
3
- All **218 skills** available in this package, in alphabetical order.
3
+ All **219 skills** available in this package, in alphabetical order.
4
4
  Click a skill name to open its SKILL.md and read the full guidance.
5
5
 
6
6
  > **Regenerate:** `python3 scripts/generate_catalog.py`
@@ -36,12 +36,12 @@ Click a skill name to open its SKILL.md and read the full guidance.
36
36
  | [`code-refactoring`](../.agent-src/skills/code-refactoring/SKILL.md) | Use when the user says 'refactor this', 'rename class', or 'move method'. Safely refactors code in any language — finds all callers, updates downstream dependencies, verifies via quality tools. |
37
37
  | [`code-review`](../.agent-src/skills/code-review/SKILL.md) | Use when the user says "review this", "check my code", or wants feedback on changes. Reviews for correctness, quality, security, and coding standards. |
38
38
  | [`command-routing`](../.agent-src/skills/command-routing/SKILL.md) | Use when the user invokes a slash command like /create-pr, /commit, /fix-ci, or pastes command file content — routes to the right command with context inference and GitHub API patterns. |
39
- | [`command-writing`](../.agent-src/skills/command-writing/SKILL.md) | Use when creating or editing a slash command in .agent-src.uncompressed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'. |
39
+ | [`command-writing`](../.agent-src/skills/command-writing/SKILL.md) | Use when creating or editing a slash command in .agent-src.uncondensed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'. |
40
40
  | [`comp-banding`](../.agent-src/skills/comp-banding/SKILL.md) | Use when designing levels, comp bands, equity-vs-cash, geo adjustments, or raise vs promotion vs market correction. Triggers on 'set our comp bands', 'is this raise market'. |
41
41
  | [`competitive-moat-analysis`](../.agent-src/skills/competitive-moat-analysis/SKILL.md) | Use when mapping competitors, naming defensibility, and finding white-space — moat reasoning, where-to-play, where-not-to-play. Triggers on 'who are we competing with', 'what's our moat'. |
42
42
  | [`competitive-positioning`](../.agent-src/skills/competitive-positioning/SKILL.md) | Use when comparing this package to a peer / competitor — ours-vs-theirs verdict table, axis selection, adoption queue. Triggers on 'how do we compare to X', 'should we adopt their pattern'. |
43
43
  | [`composer-packages`](../.agent-src/skills/composer-packages/SKILL.md) | Use when building or maintaining a Composer library — versioning, Laravel integration, autoloading, publishing to private registries — even when the user says 'release a new version'. |
44
- | [`compress-memory`](../.agent-src/skills/compress-memory/SKILL.md) | Use when shrinking always-loaded memory files (AGENTS.md, CLAUDE.md, .cursorrules) via caveman grammar — refuses sensitive paths, round-trips via .original.md backup. |
44
+ | [`condense-memory`](../.agent-src/skills/condense-memory/SKILL.md) | Use when shrinking always-loaded memory files (AGENTS.md, CLAUDE.md, .cursorrules) via telegraph grammar — refuses sensitive paths, round-trips via .original.md backup. |
45
45
  | [`content-funnel-design`](../.agent-src/skills/content-funnel-design/SKILL.md) | Use when mapping funnel-stage to content shape — conversion-pathway, content-as-system, leverage-point selection. Triggers on 'design our content funnel', 'why does mid-funnel leak'. |
46
46
  | [`context-authoring`](../.agent-src/skills/context-authoring/SKILL.md) | Use when filling in knowledge-layer context files — auth-model, tenant-boundaries, data-sensitivity, deployment-order, observability — interactive walkthrough that turns templates into reviewer fuel. |
47
47
  | [`context-document`](../.agent-src/skills/context-document/SKILL.md) | Use when the user says "create context", "document this area", or wants a structured snapshot of a codebase area for agent orientation. |
@@ -126,7 +126,8 @@ Click a skill name to open its SKILL.md and read the full guidance.
126
126
  | [`messaging-architecture`](../.agent-src/skills/messaging-architecture/SKILL.md) | Use when shaping the primary message, supporting proofs, and audience-by-message matrix from a locked positioning frame — before any copy or launch beat. Triggers on 'tighten the message stack'. |
127
127
  | [`migration-architect`](../.agent-src/skills/migration-architect/SKILL.md) | Use when shaping a non-trivial migration — rollout phases, dual-write windows, cutover sequencing, deprecation cycles — hands off to the framework-specific migration skill for DDL once locked. |
128
128
  | [`mobile-e2e-strategy`](../.agent-src/skills/mobile-e2e-strategy/SKILL.md) | Use when picking a mobile E2E framework — Detox / Appium / Maestro / XCUITest / Espresso — or planning iOS Simulator / Android Emulator coverage in CI for RN, Expo, or native apps. |
129
- | [`module-management`](../.agent-src/skills/module-management/SKILL.md) | Use when the user says "create module", "explore module", or works within app/Modules/. Understands module structure, auto-loading, route registration, and namespace conventions. |
129
+ | [`module-detect-on-the-fly`](../.agent-src/skills/module-detect-on-the-fly/SKILL.md) | Use when editing a file under a module-shaped path (`Modules/*`, `packages/*`, `apps/*`, `internal/*`) while `modules.enabled` is `false` asks the user once whether to enable the config. |
130
+ | [`module-management`](../.agent-src/skills/module-management/SKILL.md) | Use when working within any module under `modules.root_paths` from `.agent-project-settings.yml` — Laravel HMVC, Symfony DDD-lite, Node monorepo, Python src/, Go internal/, or a custom path. |
130
131
  | [`motion-choreographer`](../.agent-src/skills/motion-choreographer/SKILL.md) | Use when turning a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync. Triggers 'motion prompt for Veo/Kling/Sora'. |
131
132
  | [`multi-tenancy`](../.agent-src/skills/multi-tenancy/SKILL.md) | Use when working with the multi-tenant architecture — customer DB switching, FQDN routing, tenant isolation, or cross-tenant operations. |
132
133
  | [`nextjs-patterns`](../.agent-src/skills/nextjs-patterns/SKILL.md) | Writes Next.js App Router code — Server Components, Server Actions, RSC boundaries, route handlers, caching, and streaming — matching framework conventions and project architecture. |
@@ -140,7 +141,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
140
141
  | [`perf-feedback-craft`](../.agent-src/skills/perf-feedback-craft/SKILL.md) | Use when shaping feedback — situation-behavior-impact, growth-vs-corrective split, cadence design, ladder-of-inference checks. Triggers on 'how do I give this feedback', 'perf review shape'. |
141
142
  | [`performance`](../.agent-src/skills/performance/SKILL.md) | Use when optimizing application performance — caching strategies, eager loading, query optimization, Redis patterns, or background job design. |
142
143
  | [`performance-analysis`](../.agent-src/skills/performance-analysis/SKILL.md) | ONLY when user explicitly requests: performance audit, bottleneck analysis, or N+1 query detection. NOT for regular feature work. |
143
- | [`persona-writing`](../.agent-src/skills/persona-writing/SKILL.md) | Use when creating or editing a persona in .agent-src.uncompressed/personas/ — voice / focus / unique questions / output expectations — even when the user just says 'add a reviewer voice for X'. |
144
+ | [`persona-writing`](../.agent-src/skills/persona-writing/SKILL.md) | Use when creating or editing a persona in .agent-src.uncondensed/personas/ — voice / focus / unique questions / output expectations — even when the user just says 'add a reviewer voice for X'. |
144
145
  | [`pest-testing`](../.agent-src/skills/pest-testing/SKILL.md) | Use when writing, generating, or improving Pest tests for Laravel — clear intent, good coverage, maintainable structure, and alignment with project testing conventions. |
145
146
  | [`php-coder`](../.agent-src/skills/php-coder/SKILL.md) | Writes or edits PHP code — controllers, classes, type hints, SOLID refactors, modern idioms — even without naming PHP. NOT for writing tests (use pest-testing) or explaining PHP concepts. |
146
147
  | [`php-debugging`](../.agent-src/skills/php-debugging/SKILL.md) | Use when debugging PHP with Xdebug — breakpoints, step-through, dual-container setup, IDE configuration, header-based routing — even when the user just says 'why does this blow up on request X'. |
@@ -184,7 +185,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
184
185
  | [`roadmap-writing`](../.agent-src/skills/roadmap-writing/SKILL.md) | Use when authoring or rewriting a roadmap in agents/roadmaps/ — phase prose, goal sentence, acceptance criteria, council notes — even when the user just says 'write a plan for X' or 'draft a roadmap'. |
185
186
  | [`rtk-output-filtering`](../.agent-src/skills/rtk-output-filtering/SKILL.md) | Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns. |
186
187
  | [`rule-refactor`](../.agent-src/skills/rule-refactor/SKILL.md) | Use when the rule set is over the Augment budget, when a new rule would breach it, or when asked to audit / merge / prune rules — runs the audit pipeline and proposes a verdict per rule. |
187
- | [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) | Use when creating or editing a rule in .agent-src.uncompressed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'. |
188
+ | [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) | Use when creating or editing a rule in .agent-src.uncondensed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'. |
188
189
  | [`runway-cognition`](../.agent-src/skills/runway-cognition/SKILL.md) | Use when reasoning about cash runway — burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions. Triggers on 'how long do we have', 'should we raise', 'cut or grow'. |
189
190
  | [`scenario-modeling`](../.agent-src/skills/scenario-modeling/SKILL.md) | Use when constructing base / upside / downside scenarios — three-statement modeling, sensitivity analysis, optionality reasoning. Triggers on 'model the scenarios', 'what if growth halves'. |
190
191
  | [`scene-expander`](../.agent-src/skills/scene-expander/SKILL.md) | Use when expanding a one-line idea into the 12-block Cinematic Scene Blueprint — provider-agnostic, includes optional dialogue + ambient. Triggers 'expand this scene', 'blueprint for X'. |
@@ -195,7 +196,7 @@ Click a skill name to open its SKILL.md and read the full guidance.
195
196
  | [`sentry-integration`](../.agent-src/skills/sentry-integration/SKILL.md) | Use when the user shares a Sentry URL, says "check Sentry", or wants to investigate production errors. Uses Sentry MCP tools for deep analysis. |
196
197
  | [`sequential-thinking`](../.agent-src/skills/sequential-thinking/SKILL.md) | ONLY when user explicitly requests: step-by-step reasoning, structured problem decomposition, or iterative analysis. NOT for regular coding tasks. |
197
198
  | [`skill-improvement-pipeline`](../.agent-src/skills/skill-improvement-pipeline/SKILL.md) | ONLY when user explicitly requests: run the skill improvement pipeline after a learning was detected. Orchestrates capture, classify, create, validate, and apply. |
198
- | [`skill-management`](../.agent-src/skills/skill-management/SKILL.md) | Use when compressing, decompressing, refactoring, or improving existing skills. Covers the full skill lifecycle from verbose → sharp → maintained. |
199
+ | [`skill-management`](../.agent-src/skills/skill-management/SKILL.md) | Use when condensing, decondenseing, refactoring, or improving existing skills. Covers the full skill lifecycle from verbose → sharp → maintained. |
199
200
  | [`skill-reviewer`](../.agent-src/skills/skill-reviewer/SKILL.md) | Use when reviewing, auditing, or optimizing skills — validates against the 7 Skill Killers checklist and produces fix recommendations. |
200
201
  | [`skill-writing`](../.agent-src/skills/skill-writing/SKILL.md) | Use when deciding 'should this be a skill or a rule?', creating/improving/reviewing agent skills, SKILL.md frontmatter, or procedure sections — even without saying 'skill-writing'. |
201
202
  | [`sql-writing`](../.agent-src/skills/sql-writing/SKILL.md) | Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement` — even when the user just pastes a query and asks 'why is this slow' without naming SQL. |
@@ -121,7 +121,7 @@ The bridge installer is Python-based and needs Python 3.8+ on PATH.
121
121
  or from the Microsoft Store; ensure "Add python.exe to PATH" is
122
122
  checked.
123
123
 
124
- The portability check, compression pipeline, and test suite also depend
124
+ The portability check, condensation pipeline, and test suite also depend
125
125
  on Python 3 — it is required for contributors, not just consumers.
126
126
 
127
127
  ---