@event4u/agent-config 1.16.0 → 1.18.0

package/.agent-src/skills/test-performance/SKILL.md

@@ -148,7 +148,6 @@ Replace dynamic `getPdo()` probing with explicit config:
 
 ## Related project docs
 
-- `agents/roadmaps/test-performance-refactor.md` — active roadmap for this project
 - `agents/docs/seeders.md` — seeder conventions (if exists)
 
 ## Output format

package/.agent-src/skills/traefik/SKILL.md

@@ -18,11 +18,11 @@ Use this skill when:
 
 ### 0. Understand current setup
 
-Before changing routing:
+Before changing any routing configuration:
 
-1. Check existing proxy — `docker ps | grep traefik`
-2. Review docker-compose for existing labels and network config
-3. Check `/etc/hosts` or dnsmasq for existing domain mappings
+1. **Check existing proxy setup** — is Traefik already running? Check `docker ps | grep traefik`.
+2. **Review docker-compose** — read `docker-compose.yml` for existing labels and network config.
+3. **Check DNS/hosts** — review `/etc/hosts` or dnsmasq for existing domain mappings.
 
 ### Architecture
 

package/.agent-src/skills/verify-completion-evidence/SKILL.md

@@ -11,9 +11,9 @@ source: package
 * Just before claiming a task, feature, fix, or refactor is complete
 * Just before proposing `/commit`, `/create-pr`, or pushing
 * Before answering "is it ready?", "can I merge?", "does it work?"
-* After a sequence of edits, when next step is reporting to the user
-* Whenever "should work", "looks good", "probably fine" is about to
-  appear in a reply
+* After a sequence of edits, when next step would be reporting to the user
+* Whenever the wording "should work", "looks good", "probably fine" is
+  about to appear in a reply
 
 Do NOT use when:
 
@@ -40,11 +40,11 @@ runs are stale the moment another edit lands.
 
 ### 1. Identify the claim you are about to make
 
-Examples: *"all tests pass"*, *"ready for PR"*, *"refactor is done"*,
-*"bug is fixed"*.
+Examples: *"all tests pass"*, *"this is ready for PR"*, *"the refactor
+is done"*, *"the bug is fixed"*.
 
-Each claim maps to a specific verification command. Write the mapping
-before running anything:
+Each claim maps to a specific verification command. Write down the
+mapping before running anything:
 
 | Claim | Evidence command |
 |---|---|
@@ -58,11 +58,11 @@ before running anything:
 
 ### 2. Run the command fresh
 
-* Run against current working tree, not a cached summary.
-* PHP projects inside Docker: run inside the container (see
+* Run against the current working tree, not a cached summary.
+* For PHP projects inside Docker: run inside the container (see
   [`docker`](../docker/SKILL.md) and [`tests-execute`](../tests-execute/SKILL.md)).
 * Use targeted runs during iteration (`--filter=`, `--testNamePattern`).
-  Run full suite only in the final verification pass.
+  Run the full suite only in the final verification pass.
 
 ### 3. Read the full output
 
@@ -87,20 +87,20 @@ errors on `app/Services/`."* — not *"everything looks good"*.
 
 ## The end-of-work sequence (PHP projects)
 
-When all code changes are done and ready to report completion:
+When all code changes are done and you are ready to report completion:
 
-1. **Targeted tests** — test(s) covering the changed code pass
+1. **Targeted tests** — the test(s) covering the changed code pass
 2. **Full test suite** — only after targeted pass is green
 3. **PHPStan** → **Rector --dry-run** → **ECS** → **PHPStan** (second pass
-   catches issues Rector / ECS introduced)
+   catches issues Rector / ECS may have introduced)
 4. Fix any output from steps 1–3 and restart the sequence
 5. Only then: claim completion or suggest `/commit`, push, or PR
 
-Do not run the full quality pipeline between intermediate edits — burns
-time and tokens. Use it once, at the end.
+Do not run the full quality pipeline between intermediate edits — it
+burns time and tokens. Use it once, at the end.
 
-See [`quality-tools`](../quality-tools/SKILL.md) for exact commands per
-tool.
+See [`quality-tools`](../quality-tools/SKILL.md) for the exact commands
+per tool.
 
 ## Minimum evidence per task type
 
@@ -124,7 +124,7 @@ is sound", "compiles" (unless compilation itself is the contract).
 When reporting completion to the user:
 
 1. **What was changed** — one line summary per changed file / component
-2. **Verification run** — exact command and its exit code
+2. **Verification run** — the exact command and its exit code
 3. **Result** — numeric breakdown (tests passed/failed/skipped, errors,
    warnings)
 4. **Caveats** — anything the output flagged but you chose to accept
@@ -132,14 +132,16 @@ When reporting completion to the user:
 
 ## Gotchas
 
-* "No output" from a linter is not proof it ran — check exit code and
-  analyzed-file count.
+* A "no output" result from a linter is not proof it ran — check the
+  exit code and the analyzed-file count.
 * Silencing a warning with `@phpstan-ignore-next-line` or `// @ts-expect-error`
   without a reason code passes the linter but defers the real problem.
-* Running tests with `--stop-on-failure` then reporting "passed" — only
-  ran until the first failure; the green streak after is unexamined.
+* Running tests with `--stop-on-failure` then reporting "passed" — it
+  only ran until the first failure; the green streak after it is
+  unexamined.
 * Cached static-analysis results (`--cache` directories) can report
-  clean after you broke something; clear the cache for large changes.
+  clean after you have broken something; clear the cache when the
+  change is large.
 * Running the test suite on the wrong branch (forgot to switch or
   rebase) — verify `git status` and `git log -1` before the final gate.
 * A previously green PHPStan run in the same conversation is stale as
@@ -165,13 +167,13 @@ When reporting completion to the user:
 * Do NOT suppress warnings or skip tests to pass the gate
 * Do NOT report only the last line of output — read the whole thing
 * Do NOT run the full quality pipeline between intermediate edits —
-  run once at the end
+  run it once at the end
 
 ## When to hand over to another skill
 
 * Exact PHPStan / Rector / ECS commands → [`quality-tools`](../quality-tools/SKILL.md)
 * Running tests inside Docker → [`tests-execute`](../tests-execute/SKILL.md)
-* Writing the regression test the gate requires →
+* Writing the regression test that the gate requires →
   [`test-driven-development`](../test-driven-development/SKILL.md)
 * Diagnosing why the gate failed → [`systematic-debugging`](../systematic-debugging/SKILL.md)
 * Committing once the gate is green → [`git-workflow`](../git-workflow/SKILL.md)
@@ -180,7 +182,7 @@ When reporting completion to the user:
 
 Before sending a completion message:
 
-* [ ] Every claim maps to a command run in this turn
+* [ ] Every claim in the message maps to a command run in this turn
 * [ ] Exit code of each command is read and matches the claim
 * [ ] Output is quoted with numeric counts, not paraphrased
 * [ ] No warnings or skips are hidden

package/.agent-src/templates/roadmaps.md

@@ -64,6 +64,10 @@ Check `AGENTS.md` or `Makefile` / `Taskfile.yml` for the exact commands.
 Copy the structure below into a new file:
 
 ```markdown
+---
+complexity: lightweight
+---
+
 # Roadmap: {Short descriptive title}
 
 > {One sentence: What is the expected outcome?}

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "1.16.0"
+    "version": "1.18.0"
   },
   "plugins": [
     {
@@ -19,6 +19,7 @@
         "./.claude/skills/agent-docs-writing",
         "./.claude/skills/agent-handoff",
         "./.claude/skills/agent-status",
+        "./.claude/skills/agents",
         "./.claude/skills/agents-audit",
         "./.claude/skills/agents-cleanup",
         "./.claude/skills/agents-prepare",
@@ -41,6 +42,7 @@
         "./.claude/skills/chat-history-checkpoint",
         "./.claude/skills/chat-history-clear",
         "./.claude/skills/chat-history-resume",
+        "./.claude/skills/chat-history-show",
         "./.claude/skills/check-current-md",
         "./.claude/skills/check-refs",
         "./.claude/skills/code-refactoring",
@@ -51,21 +53,24 @@
         "./.claude/skills/commit-in-chunks",
         "./.claude/skills/composer-packages",
         "./.claude/skills/compress",
+        "./.claude/skills/context",
         "./.claude/skills/context-authoring",
         "./.claude/skills/context-create",
         "./.claude/skills/context-document",
         "./.claude/skills/context-refactor",
         "./.claude/skills/conventional-commits-writing",
+        "./.claude/skills/copilot-agents",
         "./.claude/skills/copilot-agents-init",
         "./.claude/skills/copilot-agents-optimization",
         "./.claude/skills/copilot-agents-optimize",
         "./.claude/skills/copilot-config",
         "./.claude/skills/council",
+        "./.claude/skills/council-default",
         "./.claude/skills/council-design",
         "./.claude/skills/council-optimize",
         "./.claude/skills/council-pr",
         "./.claude/skills/create-pr",
-        "./.claude/skills/create-pr-description",
+        "./.claude/skills/create-pr-description-only",
         "./.claude/skills/dashboard-design",
         "./.claude/skills/data-flow-mapper",
         "./.claude/skills/database",
@@ -74,8 +79,6 @@
         "./.claude/skills/design-review",
         "./.claude/skills/devcontainer",
         "./.claude/skills/developer-like-execution",
-        "./.claude/skills/do-and-judge",
-        "./.claude/skills/do-in-steps",
         "./.claude/skills/docker",
         "./.claude/skills/dto-creator",
         "./.claude/skills/e2e-heal",
@@ -96,10 +99,10 @@
         "./.claude/skills/fix",
         "./.claude/skills/fix-ci",
         "./.claude/skills/fix-portability",
-        "./.claude/skills/fix-pr-bot-comments",
-        "./.claude/skills/fix-pr-comments",
-        "./.claude/skills/fix-pr-developer-comments",
-        "./.claude/skills/fix-references",
+        "./.claude/skills/fix-pr",
+        "./.claude/skills/fix-pr-bots",
+        "./.claude/skills/fix-pr-developers",
+        "./.claude/skills/fix-refs",
         "./.claude/skills/fix-seeder",
         "./.claude/skills/flux",
         "./.claude/skills/git-workflow",
@@ -113,7 +116,10 @@
         "./.claude/skills/judge",
         "./.claude/skills/judge-bug-hunter",
         "./.claude/skills/judge-code-quality",
+        "./.claude/skills/judge-on-diff",
         "./.claude/skills/judge-security-auditor",
+        "./.claude/skills/judge-solo",
+        "./.claude/skills/judge-steps",
         "./.claude/skills/judge-test-coverage",
         "./.claude/skills/laravel",
         "./.claude/skills/laravel-horizon",
@@ -131,12 +137,15 @@
         "./.claude/skills/logging-monitoring",
         "./.claude/skills/mcp",
         "./.claude/skills/md-language-check",
+        "./.claude/skills/memory",
         "./.claude/skills/memory-add",
-        "./.claude/skills/memory-full",
+        "./.claude/skills/memory-load",
         "./.claude/skills/memory-promote",
+        "./.claude/skills/memory-propose",
         "./.claude/skills/merge-conflicts",
         "./.claude/skills/migration-creator",
         "./.claude/skills/mode",
+        "./.claude/skills/module",
         "./.claude/skills/module-create",
         "./.claude/skills/module-explore",
         "./.claude/skills/module-management",
@@ -146,8 +155,9 @@
         "./.claude/skills/optimize",
         "./.claude/skills/optimize-agents",
         "./.claude/skills/optimize-augmentignore",
-        "./.claude/skills/optimize-rtk-filters",
+        "./.claude/skills/optimize-rtk",
         "./.claude/skills/optimize-skills",
+        "./.claude/skills/override",
         "./.claude/skills/override-create",
         "./.claude/skills/override-manage",
         "./.claude/skills/override-management",
@@ -173,7 +183,6 @@
         "./.claude/skills/project-analyzer",
         "./.claude/skills/project-docs",
         "./.claude/skills/project-health",
-        "./.claude/skills/propose-memory",
         "./.claude/skills/quality-fix",
         "./.claude/skills/quality-tools",
         "./.claude/skills/react-shadcn-ui",
@@ -186,6 +195,7 @@
         "./.claude/skills/requesting-code-review",
         "./.claude/skills/review-changes",
         "./.claude/skills/review-routing",
+        "./.claude/skills/roadmap",
         "./.claude/skills/roadmap-create",
         "./.claude/skills/roadmap-execute",
         "./.claude/skills/roadmap-management",
@@ -211,6 +221,7 @@
         "./.claude/skills/terragrunt",
         "./.claude/skills/test-driven-development",
         "./.claude/skills/test-performance",
+        "./.claude/skills/tests",
         "./.claude/skills/tests-create",
         "./.claude/skills/tests-execute",
         "./.claude/skills/threat-model",

package/AGENTS.md

@@ -103,8 +103,8 @@ and
 ```
 .agent-src.uncompressed/      ← edit here
   skills/       (129 skills)
-  rules/        (57 rules)
-  commands/     (84 files — 69 active + 15 deprecation shims)
+  rules/        (58 rules)
+  commands/     (95 commands)
   personas/     (7 personas)
   templates/    (AGENTS.md, copilot-instructions.md, skill.md, …)
   contexts/

package/CHANGELOG.md

@@ -318,6 +318,130 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [1.18.0](https://github.com/event4u-app/agent-config/compare/1.17.0...1.18.0) (2026-05-04)
+
+### Features
+
+* **rules:** mandate hardening tier classification on new and edited rules ([42ff7c1](https://github.com/event4u-app/agent-config/commit/42ff7c1765e931a3e5e487ef83d01ca597a65800))
+* **hooks:** wire Tier 1 hooks on Claude Code for hardening parity ([55ede24](https://github.com/event4u-app/agent-config/commit/55ede24e65b5ab7e827fa3a40b04fe9dab091392))
+* **rules:** enforce placement for agent-authored roadmaps ([1624ede](https://github.com/event4u-app/agent-config/commit/1624ede571bcdd28adb7d8dd4868a92b9dbde646))
+* roadmap complexity standard with shape and tier linters ([bd1bac6](https://github.com/event4u-app/agent-config/commit/bd1bac650013e449e7318c60586b7648dbcc144e))
+* **hardening:** tier-1 hooks for onboarding-gate and context-hygiene ([5d107cd](https://github.com/event4u-app/agent-config/commit/5d107cd6fa1352d609491df12604ae0ddb7d7113))
+* **always-budget:** hard-compress direct-answers and no-cheap-questions ([2cb9b0b](https://github.com/event4u-app/agent-config/commit/2cb9b0be7b3e6486c3689fec75e7672507ca97cb))
+* outcome baselines and pattern-memory demos for foundational rules ([f43ede7](https://github.com/event4u-app/agent-config/commit/f43ede70a59cb7460557e6d76b041562056e78ee))
+
+### Bug Fixes
+
+* **check-refs:** treat .augment/state/*.json as runtime-only paths ([3d4c766](https://github.com/event4u-app/agent-config/commit/3d4c76695af38e764facc8630a97e553f5aac67f))
+* **rules:** sync compressed rules with hardening callouts ([89bd072](https://github.com/event4u-app/agent-config/commit/89bd07267d04d6346a1f36df92759c9208777a9a))
+
+### Documentation
+
+* **contexts,contracts:** unlink stable artifacts from archived roadmaps ([af4e5c2](https://github.com/event4u-app/agent-config/commit/af4e5c2de6dfb0d2143f48213e04d41c9354deca))
+* **contexts:** lock Tier 2 nudge surface, Tier 3 dispositions, platform parity ([10685a7](https://github.com/event4u-app/agent-config/commit/10685a7f3fceec1b93365cef3531a5e81f55396f))
+* **roadmaps:** relocate budget-v2-matrix to contexts as durable rationale ([33b903a](https://github.com/event4u-app/agent-config/commit/33b903a36feeacffddedde11ff9b1bc3bd5173e3))
+
+### Refactoring
+
+* **state:** move hook runtime state from .augment/state/ to agents/state/ ([ef5265e](https://github.com/event4u-app/agent-config/commit/ef5265e1ead67b089c4438efcbd4e94f120c6d3e))
+
+### Chores
+
+* **plugin:** restructure marketplace.json to registry shape ([f3e6f24](https://github.com/event4u-app/agent-config/commit/f3e6f2425fefef2cc5fc338d27e8628ab45a4d41))
+* **council:** archive Budget-v2 audit one-off ([00bf46e](https://github.com/event4u-app/agent-config/commit/00bf46e680e3a66bdbddac35e1ec3a08a8aa11f4))
+* **roadmaps:** archive hardening and context-layer-maturity tracks ([21dec26](https://github.com/event4u-app/agent-config/commit/21dec26b7a6455ab95df6704773426e3dd35574f))
+* regenerate dashboards, hashes, and roadmap progress ([06c50a9](https://github.com/event4u-app/agent-config/commit/06c50a9653bf4250a557ba2fe5a39b8609b3df30))
+* archive ai_council one-off scripts and add location guard ([63e6dbd](https://github.com/event4u-app/agent-config/commit/63e6dbdc49749e97621bcaeaa49f81beb5ffc98c))
+
+## [1.17.0](https://github.com/event4u-app/agent-config/compare/1.16.0...1.17.0) (2026-05-04)
+
+### Features
+
+* **commands:** nest commit/create-pr/feature sub-commands under colon namespace ([ceef48b](https://github.com/event4u-app/agent-config/commit/ceef48bd5b5ff550bc560e722516037a4f45e895))
+* **rules:** add no-roadmap-references rule + CI linter ([a2882a8](https://github.com/event4u-app/agent-config/commit/a2882a8a424b6bee8829426f19e531931e9c77c2))
+* **hooks:** add roadmap-progress-sync pilot hook ([48484f2](https://github.com/event4u-app/agent-config/commit/48484f28cf1ca8857c54d65e7965f62aed552ea2))
+* **budget:** add concentration gate + trend logging ([06f3855](https://github.com/event4u-app/agent-config/commit/06f385518e8326bc4528a7bf7ebfc0c639ddd89a))
+* **council:** add /council cluster dispatcher ([e7aa0c6](https://github.com/event4u-app/agent-config/commit/e7aa0c6970db634b484046f5899165e8fd3ac8a2))
+* **rules:** slim 12 auto-rules — extract mechanics to load_context (Phase 2B) ([9d211c6](https://github.com/event4u-app/agent-config/commit/9d211c68824dde0e7c21592a3079f76deae8cd96))
+* **commands:** Phase 1 — command cluster Phase 2 dispatchers + shims ([2e9d8e0](https://github.com/event4u-app/agent-config/commit/2e9d8e0fcb85f1b34d528a3f3e991e6cd5ba1388))
+* **followups:** land Phase 1 — load_context: rollout regression test + 1.15 archive verification (F2, F12) ([4ce552a](https://github.com/event4u-app/agent-config/commit/4ce552a8181668ee4c7ac20d669ce179dbdd4ab6))
+* **followups:** land Phase 0b.2 budget headroom recovery (F10) ([62838b3](https://github.com/event4u-app/agent-config/commit/62838b3df6fe7493876594ed84c908241cc286c7))
+* **structural:** lock Phase 0.4 2A.4 contract after council acceptance ([70a13d3](https://github.com/event4u-app/agent-config/commit/70a13d3a17bbea11a7b55af3bd8c16f130d954f2))
+* **structural:** land Phase 0.5 3a-spike scoring protocol + persona-voice rubric ([0fac3eb](https://github.com/event4u-app/agent-config/commit/0fac3ebafa00855d69dc9ca4cbade1a8b3797244))
+* **structural:** land Phase 0.4 2A.4 worked example ([e1412d3](https://github.com/event4u-app/agent-config/commit/e1412d345eb5432e4443b3e077bc1693d2cf3855))
+* **structural:** land Phase 0.3 Phase 6 -> 2B decoupling proof ([67b1024](https://github.com/event4u-app/agent-config/commit/67b1024560552547d79019c3566c1dec0299a948))
+* **structural:** land Phase 0.2 load_context: budget accounting model ([32cfcd4](https://github.com/event4u-app/agent-config/commit/32cfcd41d23998a705128c78f2c0a2bcdf341c87))
+* **structural:** land Phase 0.1 file-ownership matrix schema + generator ([d1dfb02](https://github.com/event4u-app/agent-config/commit/d1dfb024d4ef31aab88bfd749a6e5e5167ac5d75))
+* **structural:** land Phase 0.6 context-file path conventions ([e9c72f4](https://github.com/event4u-app/agent-config/commit/e9c72f4bde948c38bde6e5e740852c29582df91c))
+
+### Bug Fixes
+
+* **refs:** repair 4 broken cross-references ([7b0f014](https://github.com/event4u-app/agent-config/commit/7b0f014db19af0e9d68979a3ff9d12555f1ee6f5))
+* **sync:** prevent recursive _user prefixing and heal legacy corruption ([0cb0845](https://github.com/event4u-app/agent-config/commit/0cb0845320e14584348505fa0540315091ba7ef9))
+* **ci:** install pyyaml in consistency workflow ([bbad5d0](https://github.com/event4u-app/agent-config/commit/bbad5d06009a3f204051ca3b01102827162fe2f3))
+* **check-refs:** skip references into SKIP_DIRS (gitignored audit trails) ([cd6fcce](https://github.com/event4u-app/agent-config/commit/cd6fcce5411c35baaf228dc3fe0a4202acab6eca))
+* **roadmaps:** mark example/spike/coupling docs as status: draft ([d84dcf4](https://github.com/event4u-app/agent-config/commit/d84dcf44a9f777d87ef273b700ef66389216157d))
+* **compress:** carry load_context into compressed slash-command-routing-policy ([8332fb0](https://github.com/event4u-app/agent-config/commit/8332fb06a4c61ec65e9e21a6a123ea10484477de))
+
+### Documentation
+
+* repoint cross-references to nested command paths ([fbfb048](https://github.com/event4u-app/agent-config/commit/fbfb0481113aa065779ace75cbd0914eaf002d7c))
+* **roadmap:** add Phase 0a closeout hygiene to rule-hardening ([d68c4f2](https://github.com/event4u-app/agent-config/commit/d68c4f22d09ed9c3b567e996834c0148ffd17492))
+* sync command-count messaging in README/AGENTS/getting-started ([c683e9a](https://github.com/event4u-app/agent-config/commit/c683e9a4bc93294940a8f07402f88510796d91d8))
+* **roadmap:** rule-hardening v2 — council-reviewed revisions ([4d9e225](https://github.com/event4u-app/agent-config/commit/4d9e225108b9c647157eb1f6df9b55c13665588e))
+* **roadmaps:** add context-layer-maturity v2 and rule-hardening ([620961b](https://github.com/event4u-app/agent-config/commit/620961b3f469ddf0ac40ee491c3b65cab0e1000a))
+* **phase6:** chat-history-* trigger overlap audit — Path B (orthogonal) ([62ffad2](https://github.com/event4u-app/agent-config/commit/62ffad234c50ab9930115813e6801a2a8e976199))
+* **phase3:** consolidation audit — DO NOT CONSOLIDATE verdict ([03dc6aa](https://github.com/event4u-app/agent-config/commit/03dc6aad88aee2ebd85bd1d95f402742fcce05d1))
+* **readme:** trim Requirements section to clear lint-readme overload threshold ([30bf18d](https://github.com/event4u-app/agent-config/commit/30bf18da26ce69fe8bf1d688309ad375a082de6b))
+* **counts:** sync command-count messaging after Phase 1 clusters ([8902f49](https://github.com/event4u-app/agent-config/commit/8902f49f3239274828d13ce61a2b28a415dda3f5))
+* **roadmap:** drop slow-rollout protocol; lock single-PR execution (v3.2) ([35885b0](https://github.com/event4u-app/agent-config/commit/35885b01ee3c1510b2e30ad9a3bd40b686efefdf))
+* **followups:** land Phase 2 — README onboarding anchor + host-agent terminology (F1, F3, F4) ([cd12f97](https://github.com/event4u-app/agent-config/commit/cd12f9717c6b6e34efa01e55046d9f0ba0276286))
+* **roadmap:** close out 1.16 followups Phase 0a (F9 + F14 = no-op) ([6171f80](https://github.com/event4u-app/agent-config/commit/6171f805729d45084fee80704be9ec6908f1c84e))
+* **ai-council:** add experimental banner per F11 ([17308e1](https://github.com/event4u-app/agent-config/commit/17308e124fa436fac47f42649a5d1abcdb20f503))
+* **roadmap:** add 1.16.0 follow-ups roadmap v1.1 ([e402e1d](https://github.com/event4u-app/agent-config/commit/e402e1d599d1797a04a70b9fb538fa0bae913645))
+* **roadmap:** add structural-optimization roadmap v3.1 ([547f802](https://github.com/event4u-app/agent-config/commit/547f8024671e1f79570b2a5d69218f93ef1a346c))
+
+### Refactoring
+
+* **commands:** nest cluster commands into subdirectories ([5fd0df3](https://github.com/event4u-app/agent-config/commit/5fd0df387f0f2182e029fc3f40e5bce3fc4ed598))
+* **refs:** purge roadmap-file links from stable artifacts ([b5a1429](https://github.com/event4u-app/agent-config/commit/b5a1429e3f6a7fa754e816d9ddb1c4b0a6034735))
+* **rules:** amortize shared brevity examples to guideline ([ee581f6](https://github.com/event4u-app/agent-config/commit/ee581f69cc1106ec485dfb7f3ac07ffc2e2886cb))
+
+### Tests
+
+* **followups:** land Phase 0b.1 failure-mode coverage (F13) ([9560667](https://github.com/event4u-app/agent-config/commit/9560667a328f746316828ab44f0a7ba1fe8c254c))
+
+### Chores
+
+* **generated:** regenerate compressed dispatchers + hash registry ([552ddfe](https://github.com/event4u-app/agent-config/commit/552ddfeef4837b9681fc3ee72a1a01cf6c230d1a))
+* **commands:** drop ## Migration sections from cluster dispatchers ([02a03e7](https://github.com/event4u-app/agent-config/commit/02a03e7b7fbcc62c1203b7fedef38f0685e85321))
+* **generated:** regenerate compressed sources, tool projections, marketplace, ownership matrix ([f1dddd2](https://github.com/event4u-app/agent-config/commit/f1dddd2499625382b7f7902268bdd468426ce515))
+* **test:** align command-suggester golden + count gate to colon naming ([e1aad41](https://github.com/event4u-app/agent-config/commit/e1aad41624b877e4cb066d6e5075326de79f3693))
+* **generated:** regenerate file-ownership-matrix after command nesting ([12dc0f3](https://github.com/event4u-app/agent-config/commit/12dc0f3b266d6cdec6a53c918fc86098103d0373))
+* **generated:** regenerate compressed sources, tool projections,                    marketplace, and ownership matrix ([6724878](https://github.com/event4u-app/agent-config/commit/67248786c7589a63c2dabc80b683ace602611ddf))
+* **tooling:** teach scripts to walk nested command directories ([fe5913e](https://github.com/event4u-app/agent-config/commit/fe5913ef2ab6766a042d5e9470e0871d80804ddd))
+* **generated:** regenerate counts, hashes, windsurfrules ([5613b48](https://github.com/event4u-app/agent-config/commit/5613b4858da531a23aa27e23a2bda561152d3809))
+* **roadmaps:** archive 4 closed phase-evidence reports ([d5995c3](https://github.com/event4u-app/agent-config/commit/d5995c31febb3dad31df95d72970de1e1bcf3181))
+* **generated:** regenerate file-ownership-matrix ([75ff69f](https://github.com/event4u-app/agent-config/commit/75ff69fdb45952e00320918d597ea2db239a7f0b))
+* **generated:** regenerate windsurfrules + counts + claude council-default ([02ad3e1](https://github.com/event4u-app/agent-config/commit/02ad3e1079f797f8a72c33f800f1d395499b951e))
+* add ai council scripts ([4cf513c](https://github.com/event4u-app/agent-config/commit/4cf513c90649292324579444f586becd78cfad96))
+* **roadmap:** close & archive road-to-structural-optimization ([3bfef51](https://github.com/event4u-app/agent-config/commit/3bfef5118cdb66db5809fddb3688bb22d3aa8aff))
+* **compression:** refresh compression hashes ([20717d7](https://github.com/event4u-app/agent-config/commit/20717d798c86dd99f17d4c851ea0a8754e249333))
+* regenerate ownership matrix after Phase 2B rule slimming ([17ac19c](https://github.com/event4u-app/agent-config/commit/17ac19cf1938c7fca945b4500c6232cfa4549f2c))
+* **structural:** regenerate file-ownership-matrix after Phase 1 clusters ([29aabb1](https://github.com/event4u-app/agent-config/commit/29aabb11351f9fe648644b508eb6d24a5870b160))
+* **sync:** regenerate agents/index.md + docs/catalog.md after Phase 1 clusters ([f07987a](https://github.com/event4u-app/agent-config/commit/f07987ac12aaa77cbc4c7584ac00607e5a438318))
+* **sync:** regenerate compressed outputs + tool projections for Phase 1 clusters ([99466c0](https://github.com/event4u-app/agent-config/commit/99466c0a77116c7ed70db38fd957d061ad18e307))
+* **sync:** compress contexts/judges/persona-voice-rubric.md into .agent-src/ ([4060d01](https://github.com/event4u-app/agent-config/commit/4060d01af0680c2a913295166b978b605b1453db))
+* **roadmap:** archive road-to-1-16-followups (100% done) + regen dashboard ([f78a9ad](https://github.com/event4u-app/agent-config/commit/f78a9ada649c01c03aa4e866e20bb32b547cd9d0))
+* **roadmap:** regenerate progress dashboard after 1.16 followups Phase 1+2 ([780db39](https://github.com/event4u-app/agent-config/commit/780db39b68230b68c51f158d8cc8b78e7937a40c))
+* **ai-council:** add multi-provider council scripts and openai sdk ([3c2360d](https://github.com/event4u-app/agent-config/commit/3c2360d137069287b7e2547a6132d36ebed09978))
+* add task command, to install chatgpt key ([1acea8b](https://github.com/event4u-app/agent-config/commit/1acea8b6dc329c70079cec42d5a98886c913acfd))
+
+### Other
+
+* **commands:** update cross-references to colon-namespaced sub-commands ([13caa6d](https://github.com/event4u-app/agent-config/commit/13caa6d9c116012f726947fa50a281ca34ce16c2))
+* fix_: thinking drift ([1d2d158](https://github.com/event4u-app/agent-config/commit/1d2d15833e6b9764e7c734e66b25cecdf1dc12ab))
+
 ## [1.16.0](https://github.com/event4u-app/agent-config/compare/1.15.0...1.16.0) (2026-05-03)
 
 ### Features
@@ -552,7 +676,7 @@ our recommendation order, not its support status.
 * **linear:** Phase 3 — Linear AI rules digest builder + three-layer split ([3dcbf0a](https://github.com/event4u-app/agent-config/commit/3dcbf0af3c2dca70ef70f18af70a3568516f0147))
 * **rules:** add commit-policy as canonical no-commit-no-ask rule ([fd208ea](https://github.com/event4u-app/agent-config/commit/fd208ea1c0f95aaa58d930c99ff0e51dd27600ed))
 * **rules:** add autonomous-execution rule with intent-based opt-in ([fbff529](https://github.com/event4u-app/agent-config/commit/fbff5299b32606b7f13f06c856a4d4556c908fcb))
-* **commands:** add /commit-in-chunks for autonomous commit splitting ([b53fa7b](https://github.com/event4u-app/agent-config/commit/b53fa7b277a107af8acc6076baf8c985f0fbb901))
+* **commands:** add /commit:in-chunks for autonomous commit splitting ([b53fa7b](https://github.com/event4u-app/agent-config/commit/b53fa7b277a107af8acc6076baf8c985f0fbb901))
 * **cloud:** mark T3-H artifacts cloud-safe (4 noop + 4 degrade) ([0eb7eb3](https://github.com/event4u-app/agent-config/commit/0eb7eb3cdbf590e3ef87f372c3fd09d85aa5cfd5))
 * **cloud:** cloud-safe marker detection + variant rendering ([67bf28b](https://github.com/event4u-app/agent-config/commit/67bf28b8f85384333f5d26807ad92e6d0b456288))
 * **cloud:** cloud-bundle builder with T3-H gating + tests ([f749edc](https://github.com/event4u-app/agent-config/commit/f749edc8c0f16cded153eb24580c4b262a6065ae))

package/README.md

@@ -7,11 +7,21 @@ Give your AI agents an audit-disciplined orchestration contract — testing, Git
 > Your agent picks up the project's stack, runs tests, prepares PRs, fixes CI — and follows your team's coding standards while doing it. Stack-aware skill sets ship for PHP (Laravel · Symfony · Zend/Laminas), JavaScript (Next.js · React · Node), and cross-stack concerns (API · testing · security · observability).
 
 <p align="center">
-  <strong>129 Skills</strong> · <strong>57 Rules</strong> · <strong>69 Commands</strong> · <strong>47 Guidelines</strong> · <strong>8 AI Tools</strong>
+  <strong>129 Skills</strong> · <strong>58 Rules</strong> · <strong>95 Commands</strong> · <strong>51 Guidelines</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
 
+## Start here
+
+New to agent-config? 60 seconds, three links:
+
+1. **[Install](#quickstart)** — `composer require` or `npm install`, then run the installer.
+2. **[First command](#2-minute-demo-implement-ticket)** — `/implement-ticket` or `/work` walkthrough.
+3. **[Where the rules live](#documentation)** — `.augment/`, `.claude/`, `.cursor/`, and friends.
+
+---
+
 ## Quickstart
 
 Two minutes from `composer require` to a better-behaved agent.
@@ -322,7 +332,7 @@ Nothing runs automatically without your control. [Configure modes →](docs/cust
 | [`/jira-ticket`](.agent-src/commands/jira-ticket.md) | Read ticket from branch, implement feature |
 | [`/compress`](.agent-src/commands/compress.md) | Compress skills for token efficiency |
 
-→ [Browse all 69 active commands](.agent-src/commands/) &nbsp;<sub>(84 files total — 15 are deprecation shims that redirect to clustered commands)</sub>
+→ [Browse all 95 active commands](.agent-src/commands/)
 
 ---
 
@@ -347,7 +357,7 @@ Every developer gets the same behavior. No per-user setup needed.
 native slash-commands)
 
 > **What this means in practice:** Augment Code and Claude Code get the full
-> package (rules + 129 skills + 69 native commands). Cursor, Cline, Windsurf,
+> package (rules + 129 skills + 95 native commands). Cursor, Cline, Windsurf,
 > Gemini CLI, and GitHub Copilot only get the **rules** natively; skills and
 > commands are available to them as documentation the agent can read, not as
 > first-class features.
@@ -479,20 +489,11 @@ task lint-skills   # Lint skills, rules, commands
   orchestrator skips bridges and completes the payload sync.
 - **Composer or npm** — to pull the package itself.
 
-**Platform support:**
-
-| Platform | Status |
-|---|---|
-| macOS 12.3+ | ✅ Supported |
-| Linux (modern distros) | ✅ Supported |
-| Windows (WSL2) | ✅ Supported |
-| Windows (Git Bash) | ⚠️ Works; symlinks need Developer Mode |
-| Windows (native PowerShell/cmd) | ❌ Not supported |
-
-**For contributors only** (rebuilding `.augment/` locally):
-
-- [Task](https://taskfile.dev/) — runs the CI pipeline (`task ci`).
+**Platform support:** macOS 12.3+, Linux (modern distros), and Windows
+(WSL2) are fully supported. Git Bash works but symlinks require
+Developer Mode; native PowerShell / cmd is not supported. Contributors
+rebuilding `.augment/` locally also need [Task](https://taskfile.dev/).
 
 ## License
 
-[MIT](LICENSE) — you can use, fork, and redistribute this freely.
+[MIT](LICENSE).

package/docs/architecture.md

@@ -19,9 +19,7 @@ Stability tiers follow [`docs/contracts/STABILITY.md`](contracts/STABILITY.md):
 - **experimental** = scaffold or pilot status; breaks allowed in any release.
 
 > The previous "observability, feedback, lifecycle" layers were removed in
-> 1.5 — they were scaffolds without production consumers. See the
-> [`archive/road-to-9.md`](../agents/roadmaps/archive/road-to-9.md) roadmap,
-> phase 4, for the rationale.
+> 1.5 — they were scaffolds without production consumers.
 
 ## Content pipeline
 
@@ -65,9 +63,9 @@ fails on any source-side violation, without producing artifacts.
 | Layer | Count | Purpose |
 |---|---|---|
 | **Skills** | 129 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
-| **Rules** | 57 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
-| **Commands** | 84 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
-| **Guidelines** | 47 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
+| **Rules** | 58 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
+| **Commands** | 95 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
+| **Guidelines** | 51 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
 | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
 | **Contexts** | 5 | Shared knowledge about the system itself |