@event4u/agent-config 5.9.0 → 5.10.1

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 (41) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +38 -234
  3. package/README.md +13 -6
  4. package/config/agent-settings.template.yml +17 -0
  5. package/config/gitignore-block.txt +7 -0
  6. package/dist/cli/registry.js +1 -0
  7. package/dist/cli/registry.js.map +1 -1
  8. package/dist/discovery/deprecation-report.md +1 -1
  9. package/dist/discovery/discovery-manifest.json +1 -1
  10. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  11. package/dist/discovery/discovery-manifest.summary.md +1 -1
  12. package/dist/discovery/orphan-report.md +1 -1
  13. package/dist/discovery/packs.json +1 -1
  14. package/dist/discovery/trust-report.md +1 -1
  15. package/dist/discovery/workspaces.json +1 -1
  16. package/dist/mcp/registry-manifest.json +1 -1
  17. package/dist/server/schemas/settings.js +4 -0
  18. package/dist/server/schemas/settings.js.map +1 -1
  19. package/dist/ui/assets/index-DcAWIwwY.js +40 -0
  20. package/dist/ui/assets/index-DcAWIwwY.js.map +1 -0
  21. package/dist/ui/index.html +1 -1
  22. package/docs/archive/CHANGELOG-pre-5.9.0.md +270 -0
  23. package/docs/decisions/ADR-040-execution-model-projection-time-filtering.md +244 -0
  24. package/docs/decisions/INDEX.md +1 -0
  25. package/docs/distribution/registries.md +1 -0
  26. package/docs/profiles.md +8 -0
  27. package/docs/wizard.md +25 -8
  28. package/package.json +1 -1
  29. package/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  30. package/scripts/_cli/cmd_refresh.py +7 -1
  31. package/scripts/_cli/cmd_upgrade.py +31 -1
  32. package/scripts/_dispatch.bash +11 -0
  33. package/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  34. package/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  35. package/scripts/_lib/cli_wrapper.py +64 -0
  36. package/scripts/ai-video/lib/probe-audio.sh +20 -5
  37. package/scripts/hook_manifest.yaml +16 -7
  38. package/scripts/profile_use.py +125 -0
  39. package/scripts/wrapper_freshness_hook.py +86 -0
  40. package/dist/ui/assets/index-5lFqAKL0.js +0 -40
  41. package/dist/ui/assets/index-5lFqAKL0.js.map +0 -1
@@ -5,7 +5,7 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
6
  <meta name="robots" content="noindex" />
7
7
  <title>agent-config</title>
8
- <script type="module" crossorigin src="/assets/index-5lFqAKL0.js"></script>
8
+ <script type="module" crossorigin src="/assets/index-DcAWIwwY.js"></script>
9
9
  <link rel="stylesheet" crossorigin href="/assets/index-BbWWuFrF.css">
10
10
  </head>
11
11
  <body>
@@ -0,0 +1,270 @@
1
+ # Changelog Archive — pre-5.9.0
2
+
3
+ > Frozen snapshot of `event4u/agent-config` changelog entries
4
+ > released before `5.9.0`, split out of the main
5
+ > [`CHANGELOG.md`](../../CHANGELOG.md) by `scripts/release.py`
6
+ > once the active era's body crossed the drift cap enforced by
7
+ > `tests/test_changelog_eras.py`.
8
+ >
9
+ > **Read-only.** New entries land in `CHANGELOG.md`. Entries
10
+ > here are not amended — git tags remain the canonical source
11
+ > for what shipped.
12
+ >
13
+ > Entry shape follows
14
+ > [`../contracts/CHANGELOG-conventions.md`](../contracts/CHANGELOG-conventions.md).
15
+
16
+ ## [5.9.0](https://github.com/event4u-app/agent-config/compare/5.8.0...5.9.0) (2026-06-02)
17
+
18
+ ### Features
19
+
20
+ * **doctor:** runnable global-only report without a project lockfile ([4c4f20b](https://github.com/event4u-app/agent-config/commit/4c4f20b82eb472ff6b6d84ebac889832ce1329f0))
21
+ * **ci:** release-published drift gate (catch npm lagging main) ([7f4e125](https://github.com/event4u-app/agent-config/commit/7f4e125dd48d0233d33ce8cbb219731a0b501497))
22
+
23
+ ### Bug Fixes
24
+
25
+ * **release:** anchor --resume to package.json, auto-delete merged branch ([f2db736](https://github.com/event4u-app/agent-config/commit/f2db736c7259845fe204af1ffd293e7f5341a58d))
26
+
27
+ ### Chores
28
+
29
+ * **roadmap:** close + archive doctor-global-only-readiness ([3d3aaf7](https://github.com/event4u-app/agent-config/commit/3d3aaf739464b9e6613175f352b09a153bdbec90))
30
+
31
+ Tests: 5480 (+25 since 5.8.0)
32
+
33
+ ## [5.8.0](https://github.com/event4u-app/agent-config/compare/5.7.0...5.8.0) (2026-06-02)
34
+
35
+ ### Features
36
+
37
+ * **profile:** /profile command cluster + overlay contract ([1b7720a](https://github.com/event4u-app/agent-config/commit/1b7720a3ead769056cf7499f7d4951e77fc07823))
38
+ * **profile:** session-profile overlay engine + staleness hook ([cca6ac1](https://github.com/event4u-app/agent-config/commit/cca6ac112d1479e807621c9c846279d949aecc99))
39
+ * **scripts:** add warn-only coverage-diff forcing-function ([dc45926](https://github.com/event4u-app/agent-config/commit/dc4592639f052457099e7ad1857b20b867657ce9))
40
+ * **scripts:** add packages/core path resolver + gate path-integrity check ([c7eddab](https://github.com/event4u-app/agent-config/commit/c7eddabe74c9c34d18f1c545b60b1738cffa4b6c))
41
+ * **dev:** add install:use-dev / install:use-release global switch tasks ([e8a1e23](https://github.com/event4u-app/agent-config/commit/e8a1e23ec85ff0d7c358218130ae8ebe8e95c075))
42
+ * **install:** refuse project-scope self-install into the source repo ([2ad502b](https://github.com/event4u-app/agent-config/commit/2ad502be83236b2c2fa653a10670e518fb80ace7))
43
+ * **pack-fun:** wire EV-grid + P(win) helpers into prediction-pool-optimizer ([001eb1d](https://github.com/event4u-app/agent-config/commit/001eb1de4ba2ceb58a02382f449a59da9334b895))
44
+ * **pack-fun:** add score_ev + pool_winsim helpers for prediction-pool ([06d296b](https://github.com/event4u-app/agent-config/commit/06d296b4355048d82ca969fb5c369cd73dc8d44e))
45
+ * **settings:** install/sync write canonical agents/settings/ + migrate root (ADR-038) ([b4b589e](https://github.com/event4u-app/agent-config/commit/b4b589e77fde1c6d8c07ad2f32b1824bfbfea893))
46
+ * **settings:** canonical settings path → agents/settings/.agent-settings.yml (resolver + readers) ([dc8c96a](https://github.com/event4u-app/agent-config/commit/dc8c96a5f9ca5f56c6e68e8f8771bf62a580afd2))
47
+ * **pack-fun:** answer every pool question + multi-book consensus odds in prediction-pool-optimizer ([8f0e124](https://github.com/event4u-app/agent-config/commit/8f0e1241c1962ef3fe1b818bee4b2db735d099da))
48
+
49
+ ### Bug Fixes
50
+
51
+ * **hooks:** resolve roadmap-progress regenerator from the package root for global-only consumers ([8539403](https://github.com/event4u-app/agent-config/commit/853940322166cf47d3e055487f6eb884950a3396))
52
+ * **templates:** bump agent_config_version pin to 5.7.0 ([e2a5ae2](https://github.com/event4u-app/agent-config/commit/e2a5ae277c4c3b24d9f1ed42172f8d24f2eae21c))
53
+ * **check-refs:** ref-ignore gitignored .agent-settings.yml in new roadmap ([73a7deb](https://github.com/event4u-app/agent-config/commit/73a7deb56ed9b2da570c5214816f1f4b639c4da1))
54
+ * **templates:** bump agent_config_version pin to 5.7.0 ([411060d](https://github.com/event4u-app/agent-config/commit/411060d15ab1d2720f13af5482a7dc535dfb4fac))
55
+ * **check-refs:** add content-class allowlist to end the reword treadmill ([f6a3b7f](https://github.com/event4u-app/agent-config/commit/f6a3b7f2904c53f6ceb84d6339a1bb7cf75ea8e5))
56
+
57
+ ### Documentation
58
+
59
+ * **roadmap:** close road-to-self-update Phase 5; spawn doctor global-only follow-up ([307aa87](https://github.com/event4u-app/agent-config/commit/307aa87f75270124f298dba80369061c3367a42c))
60
+ * **profile:** document session profiles + sync command counts ([afa7db1](https://github.com/event4u-app/agent-config/commit/afa7db16b5e55c849eaabcc314051c55685881e7))
61
+ * **adr:** record session-profile overlay decisions (ADR-010 addendum + host audit) ([90838b9](https://github.com/event4u-app/agent-config/commit/90838b9e21f18d5e1f62c7c29550ea1fb7a8cd9f))
62
+ * **adr:** record ADR-039 — .claude/skills/ untracked ([ae00011](https://github.com/event4u-app/agent-config/commit/ae00011a9786632808c8f74f86d68062c12b7b49))
63
+ * **roadmap:** add follow-up for untracking .claude/skills/ ([14855f8](https://github.com/event4u-app/agent-config/commit/14855f8da5c2465cb3391f5659558fe3a22c006d))
64
+ * **roadmap:** complete + archive linter-debt-and-meta-subtraction ([3f1c742](https://github.com/event4u-app/agent-config/commit/3f1c74207f33025b0aaa2f48d421bec396610222))
65
+
66
+ ### Tests
67
+
68
+ * **profile:** make surface tests independent of the gitignored manifest ([db35420](https://github.com/event4u-app/agent-config/commit/db35420df35d41e83c9d4b02b04f0af24a0fbd76))
69
+ * **profile:** contract tests for the session-profile overlay ([1def905](https://github.com/event4u-app/agent-config/commit/1def9056a1a7bd9a42ecfa7fd53fab6f18c20f87))
70
+ * backfill regression tests for check_skill_requires, settings enum, wizard zero-terminal ([f581f9d](https://github.com/event4u-app/agent-config/commit/f581f9d985b296b7643536e99a7530f46b2afa8e))
71
+ * **settings:** one-liner entrypoint smoke asserts canonical settings path ([21eaf06](https://github.com/event4u-app/agent-config/commit/21eaf062ad230ac09590db9f088f4316f384e4f0))
72
+ * **settings:** update install assertions to canonical agents/settings/ path ([ad2c432](https://github.com/event4u-app/agent-config/commit/ad2c4324ff7ea8eceb1056d96e0810aa4de86835))
73
+
74
+ ### CI
75
+
76
+ * wire check-gate-paths and check-test-coverage-diff into the pipeline ([d971efb](https://github.com/event4u-app/agent-config/commit/d971efbe1416d4d12ad76724b9bb9504f2bed698))
77
+ * **skill-lint:** drop .claude/** from workflow trigger paths ([b640079](https://github.com/event4u-app/agent-config/commit/b6400794debdf34ca113f67bcb661042dadf7f3b))
78
+
79
+ ### Chores
80
+
81
+ * **index:** regenerate index + catalog for the profile command cluster ([92ccc91](https://github.com/event4u-app/agent-config/commit/92ccc91157c2781014acba03fdd3ad24c8c05393))
82
+ * **model-tier:** route routine commands and skills to the medium tier ([b0cbd55](https://github.com/event4u-app/agent-config/commit/b0cbd5523652dbeeeb5f5d3fd4e2fbb0ed1c5ed7))
83
+ * **roadmap:** close + archive road-to-session-profile-activation ([d647404](https://github.com/event4u-app/agent-config/commit/d64740461bb61fbaf80eb5f5bcc800fc770e3df0))
84
+ * **roadmap:** close + archive road-to-test-and-gate-integrity ([16f7f8b](https://github.com/event4u-app/agent-config/commit/16f7f8b896d060519cc1624178d38b9691af4bee))
85
+ * **roadmap:** close + archive road-to-claude-skills-untrack ([4010ca7](https://github.com/event4u-app/agent-config/commit/4010ca788621f409395b37b5d48cb2146919d0a2))
86
+ * **claude:** move marketplace skill sources out of .claude/skills ([c0e2d89](https://github.com/event4u-app/agent-config/commit/c0e2d8972b41cc85b44757d7c3b4df8f2b3d3551))
87
+ * **claude:** untrack generated rules/personas/user-types projections ([d03424b](https://github.com/event4u-app/agent-config/commit/d03424b2e43cae9978c7d0fc9a938fe0f1b6e2a8))
88
+ * add a new roadmap for test-and-gate-integrity ([486e7dd](https://github.com/event4u-app/agent-config/commit/486e7ddf07d79ec2a295b726a546567381037356))
89
+ * **meta:** remove dead one-shot roadmap-audit scripts (KC3) ([e0b40a2](https://github.com/event4u-app/agent-config/commit/e0b40a20519e89166db3ab06e70f15e601441dd5))
90
+
91
+ Tests: 5455 (+80 since 5.7.0)
92
+
93
+ ## [5.7.0](https://github.com/event4u-app/agent-config/compare/5.6.1...5.7.0) (2026-06-01)
94
+
95
+ ### Features
96
+
97
+ * **settings:** enum-validate value-bearing settings keys in CI ([b6c56d0](https://github.com/event4u-app/agent-config/commit/b6c56d088b1b8cfa549374e864bb3dcc203972fb))
98
+ * **value:** honest eager-vs-thin cost ladder in the value dashboard ([9a806c4](https://github.com/event4u-app/agent-config/commit/9a806c466e171f8a83e743990bc9350192745da5))
99
+ * **fun:** add /tippspiel command + tippspiel-optimizer skill in new pack-fun ([4c8fc65](https://github.com/event4u-app/agent-config/commit/4c8fc65473556ce3635a6fdcad67096c0c15886f))
100
+ * **skills:** add skill-composition graph + co-availability gate (roadmap 3.4) ([6db3afa](https://github.com/event4u-app/agent-config/commit/6db3afa8738331c2e85fb1f75dceb9943b2a2599))
101
+
102
+ ### Bug Fixes
103
+
104
+ * **install:** hand off global install to the browser wizard with zero terminal prompts ([0fc46e3](https://github.com/event4u-app/agent-config/commit/0fc46e3e29220bcebfe6c97316309502ee2b7ee4))
105
+ * **wizard:** disambiguate the rule-loading / budget / model step ([122244c](https://github.com/event4u-app/agent-config/commit/122244c859b0c9da61e60a58fa220fb6c8f699d1))
106
+ * **cost-report:** recommend the model tier before rule loading ([2545c27](https://github.com/event4u-app/agent-config/commit/2545c277e5cc930a1e493dbf78e3ef3fe11933aa))
107
+ * **condense:** quote frontmatter descriptions in cursor/windsurf rules ([c69c9bb](https://github.com/event4u-app/agent-config/commit/c69c9bbb56bce9c01284db90936fd7b432278ffb))
108
+ * **install:** always overwrite our own deployed files, drop foreign-file gate ([25b593d](https://github.com/event4u-app/agent-config/commit/25b593d96da87e61f29844db088b01a346d07d81))
109
+ * **ci:** mirror memory.cadence into the source loader + TS settings schema ([2a74eff](https://github.com/event4u-app/agent-config/commit/2a74eff244c76830745c9d1e319d6abd5fe1d80b))
110
+ * **memory:** give the visibility-line cadence its own memory.cadence key ([e792390](https://github.com/event4u-app/agent-config/commit/e792390f59b01190769cba1f369bb574c83847bd))
111
+ * **rules:** trim non-destructive description to the 190-char schema cap ([b2a489e](https://github.com/event4u-app/agent-config/commit/b2a489ecf9fcbadf5232417f2503fddbab657fdb))
112
+ * **rules:** make production-branch commits a Hard-Floor opt-in (kernel) ([31f49a9](https://github.com/event4u-app/agent-config/commit/31f49a9af7fc0fb495556e8570e0adbfcb031416))
113
+ * **discovery:** register 'fun' in discovery-manifest schema enum ([7b91f12](https://github.com/event4u-app/agent-config/commit/7b91f12fa4e1e805a121a0fd7c9adb2760f5f122))
114
+
115
+ ### Documentation
116
+
117
+ * **install:** record ADR-036 + roadmap Phase 6 for the browser-wizard handoff ([f3cc886](https://github.com/event4u-app/agent-config/commit/f3cc886618526b1c705a2a25c1ee98eb4063a188))
118
+ * **roadmap:** close + archive cost_profile untangle (phases 0-7; 4 items cancelled-with-follow-up) ([296b0da](https://github.com/event4u-app/agent-config/commit/296b0da47fc0ceed399438e4c5cb5801df0ea1b7))
119
+ * record cost_profile untangle (ADR-036 + BREAKING_CHANGES + disambiguation) ([efa658a](https://github.com/event4u-app/agent-config/commit/efa658acaef31bb1d1a9ddb565b5093b03f7d62e))
120
+ * **roadmap:** add cost_profile untangle roadmap ([708033c](https://github.com/event4u-app/agent-config/commit/708033cb5649c1d9583ea42a397795cf198b3493))
121
+
122
+ ### Refactoring
123
+
124
+ * **settings:** rename cost_profile to rule_loading_tier across the suite ([21a31cb](https://github.com/event4u-app/agent-config/commit/21a31cb9746996324e9a49d82ad87084fb605c87))
125
+ * **fun:** English command name + expanded triggers ([62c960e](https://github.com/event4u-app/agent-config/commit/62c960eac79cdbc2883ac4727fe05d651f9497b8))
126
+
127
+ ### Chores
128
+
129
+ * update agent work ([7ed0cbb](https://github.com/event4u-app/agent-config/commit/7ed0cbbe45e33757f8fa59048d6f9212110da8c1))
130
+ * sync agent-project-settings example pin to package.json (5.6.1) ([194a040](https://github.com/event4u-app/agent-config/commit/194a040628b21c2f61b1096f956f350eed131ec6))
131
+ * regenerate index + catalog after rename ([1c6dc68](https://github.com/event4u-app/agent-config/commit/1c6dc68416570f47bf8578d60c508f0acd185993))
132
+ * regenerate derived trees after merging main ([1f0ad58](https://github.com/event4u-app/agent-config/commit/1f0ad582d9a757acafd470d1fdd32adc362a2a49))
133
+ * regenerate derived trees for the prediction-pool rename ([bb3225f](https://github.com/event4u-app/agent-config/commit/bb3225fa91e78bfa640d33d501175b586cbd7de7))
134
+ * regenerate derived trees for pack-fun ([4125ba5](https://github.com/event4u-app/agent-config/commit/4125ba583cadd25ec29c23999287fc42fcc3d991))
135
+ * update condensation hashes after requires_skills frontmatter ([baf60e5](https://github.com/event4u-app/agent-config/commit/baf60e58328051176a519628dd56f879a5c4dd86))
136
+ * **roadmap:** re-examine lean-buildout disposition — 3.4 built, rest confirmed ([d88b633](https://github.com/event4u-app/agent-config/commit/d88b6332181013dc1757c317453519cadee3f63a))
137
+ * **roadmap:** close + archive lean-buildout roadmap (council-resolved) ([303ca6b](https://github.com/event4u-app/agent-config/commit/303ca6b6346298601fb789d08d003e023ab26ac4))
138
+
139
+ Tests: 5375 (+0 since 5.6.1)
140
+
141
+ ## [5.6.1](https://github.com/event4u-app/agent-config/compare/5.6.0...5.6.1) (2026-06-01)
142
+
143
+ ### Bug Fixes
144
+
145
+ * **mcp:** send bearer auth in post-deploy smoke probe ([9d12489](https://github.com/event4u-app/agent-config/commit/9d124894b03e5e962e8014171f965ce9367de58d))
146
+ * correct gzip kwarg in pack_mcp_content (condenselevel -> compresslevel) ([6d27677](https://github.com/event4u-app/agent-config/commit/6d2767736d6d20327a5853875fd4e9cb172babcc))
147
+
148
+ Tests: 5375 (+0 since 5.6.0)
149
+
150
+ ## [5.6.0](https://github.com/event4u-app/agent-config/compare/5.5.0...5.6.0) (2026-05-31)
151
+
152
+ ### Features
153
+
154
+ * **ai-video:** add /image command cluster (analyse/create/verify) ([9d53c81](https://github.com/event4u-app/agent-config/commit/9d53c81e3aed3549c4135a641e306a32fa224a68))
155
+ * **ai-video:** add image-analyser + image-creator character-fidelity skills ([b76a4db](https://github.com/event4u-app/agent-config/commit/b76a4db19d537ad5443f2c920c4701a49d08e584))
156
+ * **ai-video:** extend from-song + song-to-script + adapters; add media-sync-ground-truth rule ([dab9f0f](https://github.com/event4u-app/agent-config/commit/dab9f0f41e0d4b93eef423541269d54408bf36f4))
157
+ * **kernel:** kernel-budget soak — trim commit-policy + scope-control, fences byte-identical (Phase 1) ([b0547f0](https://github.com/event4u-app/agent-config/commit/b0547f0207df6e057e2ff97283391ddad88fd2e3))
158
+ * **schema:** tighten description caps + warning window (Phase 2.1); record 3.2 as obviated ([c65d3ae](https://github.com/event4u-app/agent-config/commit/c65d3ae8b569eb3507b83c31967231e64a31a742))
159
+ * **projection:** thin rule-layer projection behind a flag — measured -35,845 GPT tok (Phase 3.1) ([d786363](https://github.com/event4u-app/agent-config/commit/d7863635ee342ab61210ed14b95eeb1fface9582))
160
+ * **value:** drop the € comparison from the value dashboard — tokens only ([33f6fc8](https://github.com/event4u-app/agent-config/commit/33f6fc81e934ca426e5a4c82c37f41624228a636))
161
+ * **bench:** drop the monetary cost comparison — report tokens only ([1a2d3ad](https://github.com/event4u-app/agent-config/commit/1a2d3ad6a177122f0249bb903b3d7d74d62676e1))
162
+ * **audit:** unified audit:tokens analyzer + budget CI gate (Phase 0B.2/0B.4/1.3/1.4) ([c27061f](https://github.com/event4u-app/agent-config/commit/c27061fd47be600d79a5b0a8484a4061f9cdadfd))
163
+ * **safety:** trigger-coverage MUST-LOAD floor + thin-projection kill-switch (Phase 2) ([b210e0b](https://github.com/event4u-app/agent-config/commit/b210e0b9f402e26c813d6fd45e85fdad42876c1d))
164
+ * **budget:** add real-tokenizer measurement alongside chars (Phase 0B.1) ([1602d7f](https://github.com/event4u-app/agent-config/commit/1602d7f2f41a3d6b1069ad675583262542c970cf))
165
+
166
+ ### Bug Fixes
167
+
168
+ * **ai-video:** add workspaces + packs to media-sync-ground-truth rule ([cebe846](https://github.com/event4u-app/agent-config/commit/cebe8465d5cc1b07c8426b91ab52c0fb07e79f5b))
169
+ * sync command count to 145 in README badge + browse lines ([7a881e2](https://github.com/event4u-app/agent-config/commit/7a881e243fe73faad725050d684af682445c4eda))
170
+ * **kernel:** restore 2nd 'Iron Law' mention in commit-policy (obligation-baseline regression from #310) ([693c287](https://github.com/event4u-app/agent-config/commit/693c28791cbe124942835c3b309ca72921ee13f5))
171
+ * **tools:** repoint audit_auto_rules + audit_command_surface to packages/core (Phase 2.3) ([fae234c](https://github.com/event4u-app/agent-config/commit/fae234cfda21372adb493b259a47e8a9a00a0036))
172
+ * **schema:** rule description cap 160 -> 190 (smoke gate treats over-cap as FAIL) ([72f05e0](https://github.com/event4u-app/agent-config/commit/72f05e02cca4e196e514d8f4f573ac9890f52583))
173
+ * **kernel:** repoint iron_law_sha to packages/core layout (Iron-Law SHA gate was broken) ([aab5755](https://github.com/event4u-app/agent-config/commit/aab57558f7047fc21d0107dbab5aa3b49ebe4e2f))
174
+ * **schema:** add lean_projection.mode to the settings schema (template-parity gate) ([51ed03e](https://github.com/event4u-app/agent-config/commit/51ed03ec9e74d4573b7da43a6b45804535986690))
175
+ * **bench:** repoint bench_runner SKILLS_DIR to .agent-src for packages/core layout ([e183527](https://github.com/event4u-app/agent-config/commit/e183527c0efa4e3fe7dfb6a9df2c1e21534925a8))
176
+
177
+ ### Performance
178
+
179
+ * **projection:** minimal thin entries — measured saving 35,845 -> 45,182 GPT tok (77%) ([b1aabe0](https://github.com/event4u-app/agent-config/commit/b1aabe05a9e68aa87a8396f3276530d480582dbe))
180
+
181
+ ### Documentation
182
+
183
+ * **roadmap:** honest dispositions for remaining build-out items ([68e8bb5](https://github.com/event4u-app/agent-config/commit/68e8bb5ab3ec95c516707d9b8e0f2bfd6f7c5ec9))
184
+ * **roadmap:** land Phase 0+2 of road-to-lean-initial-context; spawn build-out follow-up ([8b0bec2](https://github.com/event4u-app/agent-config/commit/8b0bec2efab7128fa4c45d186e3feea4ebd632f8))
185
+
186
+ ### Chores
187
+
188
+ * update reports ([eb52977](https://github.com/event4u-app/agent-config/commit/eb52977cf398f6691e55fc063ba9f1b4f63f03b9))
189
+ * regenerate index + catalog for image skills + /image cluster ([f71f024](https://github.com/event4u-app/agent-config/commit/f71f024dba491ff36c071d9fd25d372e39b0c9c2))
190
+ * regenerate derived (router, marketplace, manifests, counts, command-surface) ([2fcc321](https://github.com/event4u-app/agent-config/commit/2fcc3214451bec3114dee0d55d7f03c0f3392ca0))
191
+ * archive road-to-character-image-fidelity (complete) ([ef16067](https://github.com/event4u-app/agent-config/commit/ef16067c0636a0c8279922bbb160531efb477ddb))
192
+ * track linter-debt roadmap + command-surface report (unrelated to lean-context) ([a52a604](https://github.com/event4u-app/agent-config/commit/a52a6048a55805e5a25b9dc68fd1e98091ba0fec))
193
+ * **router:** regenerate stale dist/router.json from source ([af782fe](https://github.com/event4u-app/agent-config/commit/af782fe179d7ba573ec916e48ac0b9e3752cf6f5))
194
+
195
+ Tests: 5375 (+39 since 5.5.0)
196
+
197
+ ## [5.5.0](https://github.com/event4u-app/agent-config/compare/5.4.1...5.5.0) (2026-05-31)
198
+
199
+ ### Features
200
+
201
+ * /skill:preview — non-destructive skill dry-run ([03ce5fc](https://github.com/event4u-app/agent-config/commit/03ce5fc757f9b42226083627ad7380dd0d895ef7))
202
+ * cross-repo retrieval + linked-projects:list (ADR-032 Option A) ([894e2e8](https://github.com/event4u-app/agent-config/commit/894e2e88c2a7e6744eb45a90907c634953aec0ec))
203
+ * /skills:discover — local, explained skill recommender ([d887c56](https://github.com/event4u-app/agent-config/commit/d887c561514b019f2ae1a3eca068087f4ffee351))
204
+ * meta-layer concept-surface audit tool + zero-cut evidence ([b4a7f3e](https://github.com/event4u-app/agent-config/commit/b4a7f3e5e87ab0c5aa4a820784fba09d8306284a))
205
+ * **video:** add /video:from-song music-video command + register in cluster ([05752df](https://github.com/event4u-app/agent-config/commit/05752dfd0837759923bf02f3731fecfb81dec9e7))
206
+ * **ai-video:** add probe-audio.sh hybrid audio segmentation ([41b4f8d](https://github.com/event4u-app/agent-config/commit/41b4f8dd57d1352df49bdc31bc81ea8e7e04f550))
207
+
208
+ ### Bug Fixes
209
+
210
+ * classify command-cluster files as commands, not skills ([0fd25da](https://github.com/event4u-app/agent-config/commit/0fd25dad8f75cfb7021512e2905b23b24fea88c1))
211
+ * **ai-video:** portability + regenerate stale derived for from-song ([9d728b8](https://github.com/event4u-app/agent-config/commit/9d728b88687a6c27dfa647dd233fb4412f7e8d5a))
212
+
213
+ ### Documentation
214
+
215
+ * reword execution-type mentions to dodge check-refs false positive ([dc84ed0](https://github.com/event4u-app/agent-config/commit/dc84ed01d3aa6845a1e15674ed1ec3ff3bbfb9ce))
216
+ * add discoverable BREAKING_CHANGES.md + major-bump rationale ([385b8a2](https://github.com/event4u-app/agent-config/commit/385b8a225b764cfe09a7e31640184140de4e07d9))
217
+ * **roadmap:** avoid check-refs false-positive on pack name ([bd02ef0](https://github.com/event4u-app/agent-config/commit/bd02ef0b07d27653dbec4971b984d1d12b75ac5e))
218
+ * **roadmap:** /video:from-song implementation roadmap + dashboard ([e4899c2](https://github.com/event4u-app/agent-config/commit/e4899c2c4f57b77bc62aa9187d4aa768ea6885f6))
219
+
220
+ ### Tests
221
+
222
+ * **ai-video:** cover probe-audio segmentation + from-song registration ([9a58807](https://github.com/event4u-app/agent-config/commit/9a588071de1601337e6e65dc9b940b0a36dcfd42))
223
+
224
+ ### Chores
225
+
226
+ * archive road-to-leaner-core-and-discovery (all phases complete) ([6b6b191](https://github.com/event4u-app/agent-config/commit/6b6b191f3b9ff328b9b7f3d6aa6eaf718e471934))
227
+ * regenerate core pack manifest with skill/skill:preview commands ([9bd88c9](https://github.com/event4u-app/agent-config/commit/9bd88c9b7b18bdd16ef2c77066aa485d96fc2b2f))
228
+ * register skills/skill/knowledge clusters + regen outputs ([1156566](https://github.com/event4u-app/agent-config/commit/1156566ad82647c596e47483d57b3fcb71f9a275))
229
+ * bump command count 135 -> 136 in README badge + browse lines ([82c27c3](https://github.com/event4u-app/agent-config/commit/82c27c3383f53d29735784bae5fb86a151c19e39))
230
+ * **ai-video:** regenerate manifests, counts, condensation hashes ([fe4dc28](https://github.com/event4u-app/agent-config/commit/fe4dc280437f209b31190a5117848feb92290015))
231
+
232
+ Tests: 5336 (+65 since 5.4.1)
233
+
234
+ ## [5.4.1](https://github.com/event4u-app/agent-config/compare/5.4.0...5.4.1) (2026-05-30)
235
+
236
+ ### Documentation
237
+
238
+ * **roadmap:** add road-to-leaner-core-and-discovery ([abf7074](https://github.com/event4u-app/agent-config/commit/abf7074913247a13c6c79b5be8c2ef49aba44aa4))
239
+
240
+ ### Tests
241
+
242
+ * **condense:** assert new PATH-fallback hook command shape ([3e72789](https://github.com/event4u-app/agent-config/commit/3e727898e4ca4f66a3a7d414e48067950f6845e3))
243
+
244
+ Tests: 5271 (+22 since 5.4.0)
245
+
246
+ ## [5.4.0](https://github.com/event4u-app/agent-config/compare/5.3.0...5.4.0) (2026-05-30)
247
+
248
+ ### Features
249
+
250
+ * **backfill:** migrate 354 tags to model_tier + rename coverage gate ([e9fc491](https://github.com/event4u-app/agent-config/commit/e9fc49137bc360a25cad675a18f655be9f6fab94))
251
+ * **schema:** replace recommended_model with vendor-neutral model_tier ([f6fc281](https://github.com/event4u-app/agent-config/commit/f6fc281c1e9adf6a51327433375d8e7d8d3e0a96))
252
+ * **rule:** make model-recommendation tier-aware, suggestion-only off-Claude ([31d70b9](https://github.com/event4u-app/agent-config/commit/31d70b9bfbdd283742d546e6484400b595ec0174))
253
+ * **generator:** map model_tier → native Claude model (single owned mapping) ([029c0d0](https://github.com/event4u-app/agent-config/commit/029c0d0f4c6cb2cb6b17f8c63652ef2cfe24a99e))
254
+ * **backfill:** tag every skill + command with recommended_model + coverage gate ([acf7553](https://github.com/event4u-app/agent-config/commit/acf7553c8c975584228cfa32fb7320e1c095e174))
255
+ * **rule:** rewrite model-recommendation to act on recommended_model ([46b7acd](https://github.com/event4u-app/agent-config/commit/46b7acd9e180979e454416acf939ca554075fd55))
256
+ * **generator:** project recommended_model to native Claude model: key ([4f6d213](https://github.com/event4u-app/agent-config/commit/4f6d213a263f360ad0c63b64bbbd9a53ea4a36ea))
257
+ * **schema:** add recommended_model frontmatter field for skills + commands ([2fa81a3](https://github.com/event4u-app/agent-config/commit/2fa81a38fb4fd0b52e23ca537374b4d0277da5d6))
258
+
259
+ ### Documentation
260
+
261
+ * **roadmap:** close + archive model-capability-tiers roadmap with evidence ([c52ba67](https://github.com/event4u-app/agent-config/commit/c52ba676c406cb7127470a01f13a12db56d9a7c1))
262
+ * **adr:** ADR-035 — vendor-neutral model capability tiers (supersedes ADR-034) ([efe656b](https://github.com/event4u-app/agent-config/commit/efe656b3d7d83dac910fc3e890bdfa8d9fd0a53b))
263
+ * **roadmap:** close + archive per-skill-model-autoswitch roadmap with evidence ([5150b64](https://github.com/event4u-app/agent-config/commit/5150b640b205141557196e40d70f7c23a0b2530c))
264
+ * **adr:** ADR-034 — per-skill model recommendation transport (Option A) ([9c18179](https://github.com/event4u-app/agent-config/commit/9c181790f7257841b4bf7aac6bf40d3c0adb6357))
265
+
266
+ ### Chores
267
+
268
+ * update readme ([47cba5b](https://github.com/event4u-app/agent-config/commit/47cba5b5d7222b1c1b925041c30b82c06b815a10))
269
+
270
+ Tests: 5249 (+13 since 5.3.0)
@@ -0,0 +1,244 @@
1
+ ---
2
+ adr: 040
3
+ status: accepted
4
+ date: 2026-06-02
5
+ decision: execution-model-projection-time-filtering
6
+ supersedes: —
7
+ superseded_by: —
8
+ phase: v6.0.0 · experience-first rebuild
9
+ type: forward-looking
10
+ ---
11
+
12
+ # ADR-040 — Pack-scoped surfacing is projection-time filtering, not a runtime resolver
13
+
14
+ ## Status
15
+
16
+ **Accepted** · 2026-06-02. Authored as Phase 0 / Step 1 of
17
+ [`road-to-6.0.0-a-positioning-and-validation`](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md),
18
+ the de-risking front of the experience-first rebuild. It makes the single
19
+ architectural decision the rest of the rebuild
20
+ ([`road-to-6.0.0-b-pack-scoped-projection`](../../agents/roadmaps/road-to-6.0.0-b-pack-scoped-projection.md))
21
+ hinges on, **before** any migration code is written. Builds on
22
+ [`ADR-010`](ADR-010-profile-pack-preset-boundary.md) (profile / pack / preset
23
+ boundary), [`ADR-020`](ADR-020-global-only-consumer-scope.md) (global-only
24
+ consumer scope), and [`ADR-016`](ADR-016-installer-architecture.md) (installer
25
+ architecture).
26
+
27
+ ## Context
28
+
29
+ The external 5.7.0 product review (`agents/tmp/feedback-6.0.0-part1.*`) and the
30
+ first draft of the rebuild plan both described pack-scoped surfacing as a
31
+ **"runtime resolver"** that decides "at runtime" which skills/commands a host
32
+ tool sees. For a package whose entire job is to **project files** into each
33
+ tool's native config tree (`.claude/`, `.cursor/`, `.augment/`, …), that framing
34
+ is architecturally incoherent:
35
+
36
+ - `agent-config` ships no agent loop, no LLM dispatcher, no daemon, and no
37
+ request interception. The host tool (Claude Code, Augment, Cursor, Cline,
38
+ Windsurf, Gemini CLI, Copilot) owns the runtime; the package is a **content
39
+ layer** (README "What `agent-config` is — and what it isn't").
40
+ - The only mechanism the package controls is **what gets written where** during
41
+ release (`scripts/build_discovery_manifest.py`) and install / sync
42
+ (`scripts/install.py` projection of `.agent-src/` into each tool tree).
43
+ - A literal runtime resolver would require a long-lived process between the host
44
+ tool and the filesystem — exactly the "agent runtime" the package explicitly
45
+ is **not** (and which `README.md` lists as out of scope).
46
+
47
+ The AI council (claude-sonnet-4-5 + gpt-4o, 2 rounds + peer-review, 2026-06-02)
48
+ named this the "single most damaging ambiguity" in the rebuild and converged on
49
+ decoding "runtime resolver" as **projection-time filtering**.
50
+
51
+ Today the projection writes the **full** artefact set regardless of the active
52
+ profile or packs. Profiles (`ADR-010`, six seed profiles) and packs (surface
53
+ caps: commands ≤12, skills ≤15, personas ≤4) already exist as **selection
54
+ metadata**, but nothing yet filters the projected output by them. That gap is
55
+ what 6.0.0-B closes — and this ADR fixes the mechanism it must use.
56
+
57
+ ## Decision
58
+
59
+ **Pack-scoped surfacing is implemented as projection-time filtering. There is no
60
+ runtime resolver in 6.0.0.**
61
+
62
+ Concretely, answering the four questions the roadmap requires:
63
+
64
+ ### Where the filtering runs
65
+
66
+ In the **Node build / install projection** and in an explicit
67
+ **`agent-config use --profile=<id>`** switch. The projector
68
+ (`scripts/install.py` + the discovery/manifest layer) becomes
69
+ profile-and-pack-aware: it writes only the active profile + enabled packs'
70
+ artefacts into the tool trees. The filter is a **build-time set operation** over
71
+ the trusted source (`.agent-src/` → projected tree), not a request-time hook.
72
+
73
+ ### How it integrates with host tools
74
+
75
+ **Zero integration.** Host tools keep reading the static files in their native
76
+ config directories exactly as they do today. They never learn that a profile
77
+ exists. The behavioural change is entirely upstream of the host tool: a
78
+ narrower set of files lands in `.claude/`/`.cursor/`/`.augment/`. No plugin API,
79
+ no hook, no interception, no protocol change on the host side.
80
+
81
+ ### When projection happens
82
+
83
+ At two moments, both explicit and user-initiated:
84
+
85
+ 1. **Install / sync** — `agent-config init`, `upgrade`, `refresh`, `sync` write
86
+ the projected set for the currently-selected profile + packs.
87
+ 2. **Profile / pack switch** — `agent-config use --profile=<id>` (wired in
88
+ 6.0.0-A / Step 8) re-runs the projection for the new selection and rewrites
89
+ the tool trees.
90
+
91
+ There is **no** mid-session, per-request, or background re-projection. The set a
92
+ host tool reads is fixed between explicit switches.
93
+
94
+ ### What `agent-config use` does in 6.0.0-A (no behavioural change)
95
+
96
+ The AI council (2026-06-02) flagged a sequencing trap: `use --profile=<id>` is
97
+ wired in 6.0.0-A (Step 8), but filtering does not land until 6.0.0-B. To avoid a
98
+ silent no-op that "succeeds but does nothing", the contract for 6.0.0-A is
99
+ explicit:
100
+
101
+ - `use --profile=<id>` **writes** `profile:` into `.agent-settings.yml` and
102
+ re-runs the projection — but the projection still writes the **legacy-all**
103
+ (full) set, because filtering ships later. It is **not** a silent no-op: it
104
+ changes persisted selection state and prints what it set, plus a one-line note
105
+ that surface-narrowing activates in 6.0.0-B.
106
+ - It MUST reject an unknown profile id (validate against the six seed profiles)
107
+ rather than write garbage.
108
+ - It does **not** change which artefacts a host tool sees in 6.0.0-A. The
109
+ "no projection-behaviour change" acceptance criterion holds: `use` moves the
110
+ *setting*, not the *set*.
111
+
112
+ ### Staleness and re-projection hygiene
113
+
114
+ The projected set is a snapshot taken at the last explicit projection
115
+ (install / sync / `use`). If upstream packs change (a surface cap moves, a pack
116
+ is deprecated) **after** projection, the tool trees are stale until the next
117
+ explicit `sync` / `use`. This is **accepted, not auto-corrected**: there is no
118
+ background watcher. `agent-config validate` already performs drift detection on
119
+ the manifest and is the surface that flags a stale projection; `sync` re-applies
120
+ the current selection. Auto-detection beyond `validate` is out of scope.
121
+
122
+ ### Switching back / undo
123
+
124
+ The per-user undo for a profile switch is another explicit `use`:
125
+ `agent-config use --profile=<previous-id>` re-projects the prior selection. The
126
+ switch persists the *new* selection in `.agent-settings.yml`; the previous value
127
+ is recoverable from VCS / settings history. A dedicated `--rollback` flag is not
128
+ required in 6.0.0-A (the setting is the single source of truth and re-projection
129
+ is idempotent), but is noted as a possible 6.0.0-B affordance if field use shows
130
+ it is needed. (This per-user undo is distinct from the *release-level*
131
+ rollback criteria for the 6.1.0 default-flip — see the validation-gate note.)
132
+
133
+ ### How a user sees the active selection
134
+
135
+ The active profile lives in `.agent-settings.yml` (`profile:`), and
136
+ `agent-config validate` / the Settings GUI surface it. `use` echoes the
137
+ resulting selection on every switch. No new per-tool-tree state file is
138
+ introduced — `.agent-settings.yml` stays the single source of truth for "which
139
+ experience is active".
140
+
141
+ ### Trust boundary
142
+
143
+ The **projector writes**; **host tools read**. The projector
144
+ (`scripts/install.py` and friends, run under the global install per `ADR-020`)
145
+ is the only writer of `.claude/`/`.cursor/`/`.augment/`. Host tools treat those
146
+ trees as read-only inputs. The trusted root remains `.agent-src.uncondensed/` →
147
+ `.agent-src/`; the projection is a deterministic, re-runnable function of
148
+ (trusted source, active profile, enabled packs). This preserves the existing
149
+ trust model (`ADR-018`) — no new write surface, no new privileged process.
150
+
151
+ ### Runtime resolver is scoped OUT of 6.0.0 (conditional)
152
+
153
+ A **true** runtime resolver — mid-session pack switching, the host tool querying
154
+ a live process for "which skills apply right now" — is explicitly **out of scope
155
+ for all of 6.0.0**. It is recorded as a **conditional** later possibility, gated
156
+ on evidence that users actually want mid-session switching (telemetry or
157
+ recruit-session signal). If it ever ships, it is a separate ADR and lives at the
158
+ tail of [`road-to-6.0.0-c-governance-and-evals`](../../agents/roadmaps/road-to-6.0.0-c-governance-and-evals.md)
159
+ or later — never silently as part of the projection work.
160
+
161
+ ### Supersedes the README "skill-resolver out of scope" line
162
+
163
+ `README.md` ("What `agent-config` is — and what it isn't") lists **"Opinionated
164
+ skill-resolver algorithm"** in the *Out of scope* column. That line predates the
165
+ profile/pack axis. The AI council (2026-06-02) converged that the line must be
166
+ **refined, not blanket-removed** — there are two distinct things, and only one
167
+ moves:
168
+
169
+ - **Out of scope (unchanged):** an *opinionated, automatic* resolver that ranks
170
+ or curates skills *for* the user without their choice (ML-based curation,
171
+ relevance scoring, "the algorithm decides"). The package still does not do
172
+ this.
173
+ - **In scope (the refinement):** *user-driven* projection-time **filtering** —
174
+ the user picks a profile + packs, and the projector writes that subset. This
175
+ is a deterministic set operation governed by an explicit user choice, not an
176
+ opinionated runtime ranking.
177
+
178
+ So this ADR supersedes the *reading* of that line that says "we will never
179
+ select a subset of skills", while preserving the rejection of an automatic
180
+ resolver. The README NOT-table is updated in Phase 1 to draw exactly this
181
+ distinction (and a *runtime* resolver remains out of scope per above).
182
+
183
+ ## Consequences
184
+
185
+ **Positive**
186
+
187
+ - The rebuild has one unambiguous mechanism to build against. 6.0.0-B
188
+ enhances the projector; it does not invent a daemon.
189
+ - No host-tool integration work, no protocol negotiation, no new runtime
190
+ process — the cheapest possible implementation of "focused command set".
191
+ - Deterministic and testable: the projected set is a pure function of
192
+ (source, profile, packs); existing determinism checks
193
+ (`check_discovery_determinism.py`) extend naturally.
194
+ - The trust boundary (`ADR-018`, `ADR-020`) is unchanged — no new attack
195
+ surface.
196
+
197
+ **Negative / costs**
198
+
199
+ - Switching profiles requires an explicit `agent-config use` + re-projection;
200
+ it is not instantaneous mid-session. Accepted: the council judged mid-session
201
+ switching an unvalidated want.
202
+ - The projector gains profile/pack-awareness complexity (the set filter, the
203
+ legacy-all default, the staged rollout flag). Contained to the build layer.
204
+ - Users who expected a "smart resolver" may be underwhelmed; mitigated by honest
205
+ positioning (Phase 1) that frames **explicit switching as a feature**
206
+ (predictable, inspectable, reproducible) rather than a limitation, and by the
207
+ conditional runtime-resolver escape hatch.
208
+
209
+ **Neutral**
210
+
211
+ - 6.0.0-A ships **no** projection-behaviour change — only this decision, the
212
+ positioning rewrite, and the `use` seam. The behavioural flip is 6.0.0-B,
213
+ staged and opt-in (legacy-all default) per the validation-gate note
214
+ ([Phase 0 / Step 2](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md)).
215
+
216
+ ## Alternatives considered
217
+
218
+ 1. **Literal runtime resolver (rejected).** A long-lived process between host
219
+ tool and filesystem. Incoherent for a content-layer package; would make
220
+ `agent-config` an agent runtime it explicitly is not; requires per-host
221
+ integration the package has no surface for. Rejected as architecturally
222
+ wrong, not merely expensive.
223
+ 2. **Host-tool plugin/hook that filters at read time (rejected).** Push the
224
+ filter into each tool via its plugin API. Multiplies per-tool integration
225
+ cost across 7+ tools, couples the package to every tool's plugin lifecycle,
226
+ and breaks tools without a plugin surface. Rejected.
227
+ 3. **Ship full set, document "ignore what you don't need" (rejected).** The
228
+ status quo. Fails the core perception problem the rebuild exists to fix
229
+ ("520 artefacts, where do I start?"). Rejected — it is the problem.
230
+ 4. **Projection-time filtering (accepted).** Filter the projected set by profile
231
+ + packs in the build/install layer; host tools read a pre-filtered static
232
+ set. Cheapest, deterministic, zero host integration, preserves the trust
233
+ boundary.
234
+
235
+ ## References
236
+
237
+ - [`road-to-6.0.0-a-positioning-and-validation`](../../agents/roadmaps/road-to-6.0.0-a-positioning-and-validation.md) — this roadmap (Phase 0 / Step 1).
238
+ - [`road-to-6.0.0-b-pack-scoped-projection`](../../agents/roadmaps/road-to-6.0.0-b-pack-scoped-projection.md) — consumes this decision.
239
+ - [`ADR-010`](ADR-010-profile-pack-preset-boundary.md) — profile / pack / preset boundary.
240
+ - [`ADR-016`](ADR-016-installer-architecture.md) — installer architecture (the projector).
241
+ - [`ADR-018`](ADR-018-trust-and-safety-layer.md) — trust boundary this ADR preserves.
242
+ - [`ADR-020`](ADR-020-global-only-consumer-scope.md) — global-only consumer scope (where the projector runs).
243
+ - [`profile-system`](../contracts/profile-system.md) — the six seed profiles and pack surface caps.
244
+ - `README.md` § "What `agent-config` is — and what it isn't" — the superseded "skill-resolver out of scope" line.
@@ -43,6 +43,7 @@ _Auto-generated by `scripts/adr/regenerate_index.py`. Do not edit._
43
43
  | [ADR-037](ADR-037-cost-profile-untangle.md) | Cost Profile Untangle | accepted | 2026-06-01 | — |
44
44
  | [ADR-038](ADR-038-canonical-settings-path.md) | Canonical Settings Path | — | — | — |
45
45
  | [ADR-039](ADR-039-claude-skills-untracked.md) | Claude Skills Untracked | accepted | 2026-06-01 | — |
46
+ | [ADR-040](ADR-040-execution-model-projection-time-filtering.md) | Execution Model Projection Time Filtering | accepted | 2026-06-02 | — |
46
47
 
47
48
  ## Unnumbered (legacy)
48
49
 
@@ -40,6 +40,7 @@ No bespoke `BREAKING_CHANGES.md` is maintained — the changelog is the authorit
40
40
  | 1 | `punkpeye/awesome-mcp-servers` | <https://github.com/punkpeye/awesome-mcp-servers> | One-line entry under the agent-tooling section, links to `README.md` hero anchor | ⬜ open | — |
41
41
  | 2 | `mcp.so` | <https://mcp.so/> | Submit via the directory form; same one-line shape | ⬜ open | — |
42
42
  | 3 | `mcpservers.org` | <https://mcpservers.org/> | Submit via the directory form; same one-line shape (verify URL current at submission time) | ⬜ open | — |
43
+ | 4 | `glama.ai` | <https://glama.ai/> | Submit via the Glama claim flow; same one-line shape — repo `https://github.com/event4u-app/agent-config`, tags `agent-governance`, `mcp`, `skills` | ⬜ open (human-owner: maintainer submits via the Glama claim flow) | — |
43
44
 
44
45
  ## Submission template
45
46
 
package/docs/profiles.md CHANGED
@@ -9,6 +9,14 @@ and the exact commands and skills wired into the profile YAML at
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.
11
11
 
12
+ **Switching experience.** `agent-config setup` writes `profile.id` on first run
13
+ (it is the wizard's first question). To switch later, run
14
+ `agent-config use --profile=<id>` (one of `developer` · `content_creator` ·
15
+ `founder` · `agency` · `finance` · `ops`). In 6.0.0-A this records the choice
16
+ only; pack-scoped surfacing (projection-time filtering,
17
+ [`ADR-040`](decisions/ADR-040-execution-model-projection-time-filtering.md))
18
+ activates in 6.0.0-B behind a staged, opt-in rollout.
19
+
12
20
  <a id="profile-developer"></a>
13
21
  ## 👩‍💻 `developer` — IC engineer
14
22
 
package/docs/wizard.md CHANGED
@@ -27,17 +27,34 @@ agent-config settings
27
27
  Both commands share the same SPA and the same backend; the URL hash
28
28
  selects which surface renders.
29
29
 
30
- ## The seven steps
30
+ ## The steps
31
+
32
+ The **first substantive question is "which experience?"** — profile selection
33
+ leads the flow (the cost / rule tier is a secondary knob further down).
31
34
 
32
35
  | # | Title | What it asks |
33
36
  |---|---|---|
34
- | 1 | Identity | `personal.user_name`, `personal.ide` |
35
- | 2 | Personality | `personal.minimal_output`, `personal.play_by_play`, `personal.open_edited_files` |
36
- | 3 | Cost profile | `rule_loading_tier` (minimal · balanced · full) |
37
- | 4 | Roadmap quality | `roadmap.quality_floor`, `roadmap.run_tests_inline` |
38
- | 5 | Memory | `memory.enabled`, MCP server presence |
39
- | 6 | `.agent-user.md` | Optional long-form persona / preferences |
40
- | 7 | Review | Read-only diff of every change, plus a `Finish` button |
37
+ | 1 | Welcome | `personal.user_name`, language |
38
+ | 2 | Experience | `profile.id` which experience (developer · content_creator · founder · agency · finance · ops) |
39
+ | 3 | Identity | `personal.ide`, `personal.open_edited_files` |
40
+ | 4 | Personality | `personal.autonomy`, `personal.minimal_output`, `personal.play_by_play` |
41
+ | 5 | Cost & rules | `rule_loading_tier`, `cost.budgets`, `model.auto_switch` (secondary to the experience choice) |
42
+ | 6 | Roadmap & quality | `roadmap.quality_cadence`, `roadmap.dashboard_regen_cadence`, `quality.*` |
43
+ | 7 | Memory | `memory.review_threshold`, redaction patterns |
44
+ | 8 | `.agent-user.yml` | Optional long-form persona / preferences |
45
+ | 9 | Review | Read-only diff of every change, plus a `Finish` button |
46
+
47
+ > **Experience selection is perception-only in 6.0.0-A.** It writes `profile.id`
48
+ > to `.agent-settings.yml` and selects the README entry-path / persona
49
+ > pre-selection — it does **not** yet narrow what gets projected into the tool
50
+ > trees. Pack-scoped surfacing (projection-time filtering,
51
+ > [`ADR-040`](decisions/ADR-040-execution-model-projection-time-filtering.md))
52
+ > ships in 6.0.0-B behind a staged, opt-in rollout. Switch experiences any time
53
+ > with `agent-config use --profile=<id>`.
54
+
55
+ The extended install flow (`agent-config setup` on a fresh global install)
56
+ inserts the **AI tools → roles → packs** lead between Experience and Identity;
57
+ the canonical settings steps above stay in the same order.
41
58
 
42
59
  Each step posts its partial state to `POST /api/v1/wizard/state` on
43
60
  transition, so closing the browser mid-flight is safe — re-opening
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@event4u/agent-config",
3
- "version": "5.9.0",
3
+ "version": "5.10.1",
4
4
  "description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
5
5
  "license": "MIT",
6
6
  "private": false,