@event4u/agent-config 1.20.0 → 1.22.0

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

@@ -0,0 +1,129 @@
+# Rule Template
+
+> Template for creating new rules in `.agent-src.uncompressed/rules/{rule-name}.md`.
+> Rules ship to `.agent-src/rules/` (compressed) and `.augment/rules/` (projected).
+> Schema: `scripts/schemas/rule.schema.json`.
+
+## Instructions
+
+1. Pick a kebab-case `{rule-name}` matching the file stem.
+2. Copy the template below into `.agent-src.uncompressed/rules/{rule-name}.md`.
+3. Replace placeholders, drop sections that don't apply.
+4. Run `task lint-skills` and `python3 scripts/lint_load_context.py`.
+5. Compress: `bash scripts/compress.sh --changed` then follow the agent flow.
+
+## Path conventions — load-bearing
+
+Two different fields, two different rules. Mixing them up will either
+break linting or produce paths that resolve to nothing in the
+consumer's `.augment/`.
+
+### `load_context:` / `load_context_eager:` — logical names
+
+Use **logical names** rooted at the source — never the
+`.agent-src.uncompressed/` prefix. The compress-time rewriter
+(`scripts/compress.py::_rewrite_paths`) resolves logical names to
+deployment-correct relative paths; the schema regex
+(`scripts/schemas/rule.schema.json`) and `scripts/lint_load_context.py`
+both reject the legacy prefix.
+
+| Write this (logical) | Forbidden (legacy) |
+|---|---|
+| `contexts/execution/verification-mechanics.md` | `.agent-src.uncompressed/contexts/execution/verification-mechanics.md` |
+| `contexts/authority/commit-mechanics.md` | `.agent-src.uncompressed/contexts/authority/commit-mechanics.md` |
+| `agents/contexts/local.md` (project-local) | `.agent-src.uncompressed/contexts/...` for project-only material |
+
+### `triggers[].path_prefix:` — literal match pattern, not a file path
+
+`path_prefix:` is a **literal match pattern** the host evaluates against
+the file the agent is editing — it is **not** a file reference and is
+**not rewritten**. Rules that fire when the agent edits source-of-truth
+files legitimately keep the `.agent-src.uncompressed/` prefix (see
+`skill-quality`, `docs-sync`, `rule-type-governance`,
+`augment-portability`). Rules that fire on consumer-project paths use
+`agents/`, `lang/`, `.augment/`, etc.
+
+| Use case | Example `path_prefix:` |
+|---|---|
+| Fires when editing source-of-truth artifacts | `.agent-src.uncompressed/skills/` |
+| Fires when editing consumer project files | `agents/`, `lang/`, `app/`, `src/` |
+| Fires when editing the projected layer | `.augment/` |
+
+### Body links — `../../docs/...` is fine in source
+
+Source files keep verbatim `../../docs/guidelines/...` and
+`../../docs/contracts/...` links so they work in any markdown viewer.
+The rewriter rewrites them to depth-aware single-up form at compress
+time and is idempotent. Do not pre-rewrite in source.
+
+### Why "logical, depth-aware, idempotent"
+
+A rule at `rules/{name}.md` resolves `contexts/{area}/{file}.md` to
+`../contexts/{area}/{file}.md` in the compressed output; a nested
+file at `commands/{cluster}/{sub}.md` resolves to
+`../../contexts/{area}/{file}.md`. Re-running the rewriter does not
+double-prefix. The full decision history lives in the archived
+path-fixes roadmap under `agents/roadmaps/archive/`.
+
+## Template
+
+````markdown
+---
+type: "always"
+tier: "kernel"
+description: "{One-line trigger sentence — what fires this rule}"
+source: package
+# council_depth: deep   # uncomment for rules that gate architecture/refactor/bug-diagnose flows
+load_context:
+  - contexts/{area}/{file}.md
+triggers:
+  - path_prefix: "{project-relative path or .augment/...}"
+  - keyword: "{trigger-keyword}"
+routes_to:
+  - "skill:{target-skill}"
+---
+
+# {Rule Title}
+
+**Iron Law.** {The single non-negotiable behavior the rule enforces.}
+
+## When this fires
+
+{1–3 bullets on the trigger surface — what the agent is doing when this rule applies.}
+
+## What to do
+
+{Numbered procedure or short directive list. Reference skills / guidelines
+for full detail; rules are pointers, not playbooks.}
+
+## What NOT to do
+
+- {Anti-pattern 1}
+- {Anti-pattern 2}
+
+## See also
+
+- [`{related-rule}`](./{related-rule}.md)
+- [`{guideline-ref}`](docs/guidelines/{group}/{name}.md) — full pattern catalog
+````
+
+## Field reference
+
+| Field | Required | Notes |
+|---|---|---|
+| `type` | yes | `always` or `auto`. Always-rules load every turn; auto-rules require trigger match. |
+| `tier` | yes | `kernel` (Iron Law floor), `tier-1` (default), `tier-2` (full profile only). Legacy values still accepted. |
+| `description` | yes | One sentence, ≤ 500 chars. Trigger-clarity wins over poetry. |
+| `source` | yes | `package` (this repo) or `project` (consumer override). |
+| `load_context` | no | Lazy context list — logical names only. Budget enforced by `lint_load_context.py`. |
+| `load_context_eager` | no | Eager context list — counts against per-rule char budget. |
+| `triggers` | no | Required on non-kernel rules per `rule-router.md`. |
+| `routes_to` | no | `skill:`, `guideline:`, `command:`, `contract:` targets. Forbidden on kernel rules. |
+| `alwaysApply` | no | Cursor/Cline sidecar — by convention `true` for `type: always`. |
+| `council_depth` | no | Only `deep` is accepted; **omit the key for default depth** (`standard` is the implicit default and is rejected by the schema — every frontmatter byte counts). Set `deep` when this rule gates AI Council on architecture, refactoring, or bug-diagnosis flows. Host translates to `--depth deep` on the council CLI. See `.augment/skills/ai-council/SKILL.md`. |
+
+## Size budget
+
+- Kernel rules: ≤ 4 000 chars (Iron-Law overrides documented in `docs/contracts/iron-law-overrides.txt`).
+- Non-kernel rules: ≤ 2 500 chars.
+- Enforced by `task lint-rule-budget`.

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

@@ -41,6 +41,23 @@ status: active
   See guidelines/agent-infra/runtime-layer.md for details.
 -->
 
+<!-- COUNCIL DEPTH (optional — delete this comment when done):
+  Add `council_depth: deep` to the frontmatter when this skill triggers
+  AI Council on architecture, refactoring, or bug-diagnosis artefacts.
+  The host translates `deep` into `--depth deep` on the council CLI,
+  raising the round floor to `max(ai_council.deep_min_rounds,
+  ai_council.min_rounds)`.
+
+  Only `deep` is accepted. **Omit the key for default depth** —
+  `standard` is the implicit default and is rejected by the schema
+  (every frontmatter byte counts against the context window).
+
+  Example:
+    council_depth: deep
+
+  See .augment/skills/ai-council/SKILL.md.
+-->
+
 <!-- DESCRIPTION RULES (delete this comment when done):
   - Start with "Use when..." — this is a TRIGGER, not a summary
   - Include 2-3 phrases users actually say: "create a DTO", "add column", "fix tests"

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.20.0"
+    "version": "1.22.0"
   },
   "plugins": [
     {
@@ -42,6 +42,9 @@
         "./.claude/skills/chat-history-import",
         "./.claude/skills/chat-history-learn",
         "./.claude/skills/chat-history-show",
+        "./.claude/skills/challenge-me",
+        "./.claude/skills/challenge-me-vision",
+        "./.claude/skills/challenge-me-with-docs",
         "./.claude/skills/check-current-md",
         "./.claude/skills/check-refs",
         "./.claude/skills/code-refactoring",
@@ -109,6 +112,7 @@
         "./.claude/skills/git-workflow",
         "./.claude/skills/github-ci",
         "./.claude/skills/grafana",
+        "./.claude/skills/grill-me",
         "./.claude/skills/guideline-writing",
         "./.claude/skills/implement-ticket",
         "./.claude/skills/jira-integration",
@@ -157,6 +161,7 @@
         "./.claude/skills/optimize",
         "./.claude/skills/optimize-agents",
         "./.claude/skills/optimize-augmentignore",
+        "./.claude/skills/optimize-prompt",
         "./.claude/skills/optimize-rtk",
         "./.claude/skills/optimize-skills",
         "./.claude/skills/override",
@@ -185,6 +190,7 @@
         "./.claude/skills/project-analyzer",
         "./.claude/skills/project-docs",
         "./.claude/skills/project-health",
+        "./.claude/skills/prompt-optimizer",
         "./.claude/skills/quality-fix",
         "./.claude/skills/quality-tools",
         "./.claude/skills/react-shadcn-ui",
@@ -199,9 +205,12 @@
         "./.claude/skills/review-routing",
         "./.claude/skills/rice-prioritization",
         "./.claude/skills/roadmap",
+        "./.claude/skills/roadmap-ai-council",
         "./.claude/skills/roadmap-create",
-        "./.claude/skills/roadmap-execute",
         "./.claude/skills/roadmap-management",
+        "./.claude/skills/roadmap-process-full",
+        "./.claude/skills/roadmap-process-phase",
+        "./.claude/skills/roadmap-process-step",
         "./.claude/skills/rtk-output-filtering",
         "./.claude/skills/rule-compliance-audit",
         "./.claude/skills/rule-writing",
@@ -229,6 +238,7 @@
         "./.claude/skills/tests-execute",
         "./.claude/skills/threat-model",
         "./.claude/skills/threat-modeling",
+        "./.claude/skills/token-optimizer",
         "./.claude/skills/traefik",
         "./.claude/skills/unit-economics-modeling",
         "./.claude/skills/universal-project-analysis",

package/AGENTS.md

@@ -111,7 +111,7 @@ want to measure which skills/rules/commands the agent actually applies set
 `telemetry.artifact_engagement.enabled: true` in `.agent-settings.yml`. The
 log is local-only JSONL (no upload, no cross-project share) and is bound
 by the redaction floor described in
-[`docs/contracts/artifact-engagement-flow.md`](docs/contracts/artifact-engagement-flow.md) (beta).
+[`contexts/contracts/artifact-engagement-flow.md`](.agent-src.uncompressed/contexts/contracts/artifact-engagement-flow.md) (beta).
 The recording rule lives at
 [`.agent-src/rules/artifact-engagement-recording.md`](.agent-src/rules/artifact-engagement-recording.md).
 
@@ -125,7 +125,7 @@ picks every time. Engine: `scripts/command_suggester/`. Rule:
 Locked eligibility table, scoring contract, and hardening list:
 [`docs/contracts/adr-command-suggestion.md`](docs/contracts/adr-command-suggestion.md)
 and
-[`docs/contracts/command-suggestion-flow.md`](docs/contracts/command-suggestion-flow.md) (beta).
+[`contexts/contracts/command-suggestion-flow.md`](.agent-src.uncompressed/contexts/contracts/command-suggestion-flow.md) (beta).
 
 ## Key rules for agents editing this repo
 
@@ -139,19 +139,46 @@ and
 | Keep `.agent-src/` / `agents/` cross-refs in sync on add/rename/delete | [`docs-sync`](.agent-src/rules/docs-sync.md) |
 | Creating a new skill/rule/command/guideline runs Understand → Research → Draft | [`artifact-drafting-protocol`](.agent-src/rules/artifact-drafting-protocol.md) |
 
+## Kernel + Router
+
+The rule set runs on a **Kernel + Router** model (locked 2026-05-06,
+see [`docs/decisions/ADR-rule-kernel-and-router.md`](docs/decisions/ADR-rule-kernel-and-router.md)):
+
+- **Kernel** = 9 always-loaded Iron-Law rules, ≤ 26k chars
+  (`agent-authority`, `ask-when-uncertain`, `commit-policy`,
+  `direct-answers`, `language-and-tone`, `no-cheap-questions`,
+  `non-destructive-by-default`, `scope-control`, `verify-before-complete`).
+  Locked set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-membership.md) (beta).
+- **Router** = frontmatter `tier:` + `triggers:` + `routes_to:` keys
+  on every rule. `scripts/compile_router.py` builds `router.json`
+  deterministically. Contract: [`docs/contracts/rule-router.md`](docs/contracts/rule-router.md) (beta).
+- **Cost profiles** gate which tiers load:
+  `minimal` = kernel only · `balanced` = kernel + tier-1 (default) ·
+  `full` = kernel + tier-1 + tier-2.
+
+Hard caps enforced by `task lint-rule-budget`: kernel-bucket ≤ 26k chars,
+per-rule ≤ 2.5k chars (Iron-Law overrides up to 4.0k via ADR in
+[`docs/decisions/`](docs/decisions/) and
+[`docs/contracts/iron-law-overrides.txt`](docs/contracts/iron-law-overrides.txt)).
+Daily snapshots: `python3 scripts/measure_rule_budget.py --trend-append`
+appends to `agents/.rule-budget-history.jsonl`.
+
 ## Repository layout
 
 ```
 .agent-src.uncompressed/      ← edit here
-  skills/       (134 skills)
-  rules/        (56 rules)
-  commands/     (94 commands)
+  skills/       (136 skills)
+  rules/        (59 rules)
+  commands/     (102 commands)
   personas/     (7 personas)
   templates/    (AGENTS.md, copilot-instructions.md, skill.md, …)
   contexts/
 
 docs/guidelines/            (47 guidelines — reference material, not packaged)
+docs/contracts/             (kernel-membership, rule-router, rule-classification, …)
+docs/decisions/             (ADRs — kernel overrides, scope decisions)
 .agent-src/                 ← compressed output shipped in the package
+.agent-src/router.json      ← compiled router manifest (consumed at runtime)
 .augment/                   ← local projection for Augment Code (gitignored)
 scripts/                    ← install.sh, install.py, compress.py, linters
 tests/                      ← pytest (324 tests) + test_install.sh

package/CHANGELOG.md

@@ -318,6 +318,110 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [1.22.0](https://github.com/event4u-app/agent-config/compare/1.21.0...1.22.0) (2026-05-07)
+
+### Features
+
+* **commands:** add /grill-me alias for /challenge-me + expand triggers ([d2be4ee](https://github.com/event4u-app/agent-config/commit/d2be4ee1a97d2ca2374c6543e0fd908eca0a0f1a))
+* **challenge-me:** add !roadmap and !ai triggers ([7bfbd69](https://github.com/event4u-app/agent-config/commit/7bfbd6943852d781ca7ad29e51750de24d3ef413))
+* **create-pr:** default to skipping description preview to save tokens ([80e77ae](https://github.com/event4u-app/agent-config/commit/80e77aed76a13c26fac8316bc5d58a3533dbbe44))
+* **council:** add critical-evaluation stance for council findings ([7e2524b](https://github.com/event4u-app/agent-config/commit/7e2524b75fd84ca4b6afb6deae0b8777e8b81ac7))
+* **council:** add /roadmap:ai-council deep-tier sub-command ([c5933e4](https://github.com/event4u-app/agent-config/commit/c5933e4b2301a0f9d1c116d2843ed4953bd92163))
+* replace /roadmap-execute with autonomous /roadmap:process-* cluster ([9d4ffd0](https://github.com/event4u-app/agent-config/commit/9d4ffd0815fb7923b337bfd0b3847d9bc5a01e54))
+* **council:** mark architecture/refactor/bug-diagnose artefacts as deep ([6f903c1](https://github.com/event4u-app/agent-config/commit/6f903c194e4bc54512e93a32e1876e84d0292401))
+* **council:** add deep reasoning depth tier with schema enforcement ([f4efd7a](https://github.com/event4u-app/agent-config/commit/f4efd7a11b9d57e93153e6e4605c968565c8924d))
+* **linter:** require suggestion block on commands ([231df91](https://github.com/event4u-app/agent-config/commit/231df918b2d15ea9cc2fa8fe12bae4c2482990df))
+* add --siblings council mode and refine convener wording ([9075647](https://github.com/event4u-app/agent-config/commit/9075647ba520efb5f10ab7612970111e9f9d16e9))
+* add PRD template to technical-specification ([f9ee749](https://github.com/event4u-app/agent-config/commit/f9ee7496434f9342d6b46b95dce14c4703d07d96))
+* add 6-phase loop checklist to systematic-debugging ([29c9e94](https://github.com/event4u-app/agent-config/commit/29c9e9419c9d08dd93c4fc7364e51b93bc771131))
+* add invite-challenge rule for pre-execution goal restatement ([e96da5f](https://github.com/event4u-app/agent-config/commit/e96da5fdf124da3582e454fc625fe32a27ada634))
+* add /challenge-me cluster with vision and with-docs sub-commands ([74481ef](https://github.com/event4u-app/agent-config/commit/74481ef7e7850d3e015ff0f9853be6ea618ac1d9))
+
+### Documentation
+
+* **roadmap:** drop council-response file links per no-council-references ([d792100](https://github.com/event4u-app/agent-config/commit/d792100ef6b2727cca1338c89fefc4c591513265))
+* **readme:** bump hero command count from 100 to 102 ([3212db4](https://github.com/event4u-app/agent-config/commit/3212db48fb1d62a70f9e87cf9307ee73059b7e4e))
+* **roadmap:** integrate R5 council verdict for caveman-insurance ([38b26e2](https://github.com/event4u-app/agent-config/commit/38b26e2f00504a7c6c821c356964cb0cabefd905))
+* **roadmap:** incorporate R4 verdict + structural findings into caveman integration ([c50f39b](https://github.com/event4u-app/agent-config/commit/c50f39bc9b08c8d59c4cf547aeec7fffbff38bc0))
+* **roadmap:** convert caveman integration Phase 2 to hard cutover ([fb459be](https://github.com/event4u-app/agent-config/commit/fb459be70a093eea1814a38a3b1fec9cf9261363))
+* **harvest:** add Superpowers harvest roadmap, hardened by council R2 ([e559259](https://github.com/event4u-app/agent-config/commit/e559259f789014603067e87141d9feb815b480ab))
+* **harvest:** analyze obra/superpowers v5.1.0 for adoption candidates ([e89e0ee](https://github.com/event4u-app/agent-config/commit/e89e0eeadc4b76517b181c559422e88df5c8122a))
+* **council:** document council_depth frontmatter convention in templates ([ba56412](https://github.com/event4u-app/agent-config/commit/ba56412c76204bbe49366bbceb62e4d31c994fc2))
+
+### Chores
+
+* **sync:** re-sync compressed mirror with create-pr preview-gate + agent-settings preview_description ([ceab79e](https://github.com/event4u-app/agent-config/commit/ceab79e23be2c1d4ba504b80426d1b91ffdaadd1))
+* bump artefact counts and refresh compression hashes ([2801342](https://github.com/event4u-app/agent-config/commit/28013424668177fc23df45cc56390faba6fd010e))
+* regenerate tool-dir symlinks for challenge-me and invite-challenge ([b3b0ada](https://github.com/event4u-app/agent-config/commit/b3b0ada9ce108b220289c9f044b3f3d0209f0a12))
+* bump artefact counts and refresh compression hashes ([4147de3](https://github.com/event4u-app/agent-config/commit/4147de3b4da24494128a847be194ac901e506df9))
+* sync compressed projection for challenge-me cluster ([9165762](https://github.com/event4u-app/agent-config/commit/91657620e6d822fbe28923e3b008e218f13e5cea))
+
+## [1.21.0](https://github.com/event4u-app/agent-config/compare/1.20.0...1.21.0) (2026-05-06)
+
+### Features
+
+* **linter:** add council-reference guard with pragma suppressions ([734b7ae](https://github.com/event4u-app/agent-config/commit/734b7ae61d53c17fadb78f6f68bb54e3fe7cdde8))
+* **linter:** density-gated size warnings (council Option 2) ([281b9aa](https://github.com/event4u-app/agent-config/commit/281b9aa6f52640a93cf55c7b13678fbd2ea85077))
+* **skills:** add prompt-optimizer skill and /optimize-prompt command ([4f99e50](https://github.com/event4u-app/agent-config/commit/4f99e50ae46b19eab3eed2629bb94ac5d017151e))
+* **path-fixes:** finalize Phase 5-7 — checker, smoke, copilot review, contracts move ([3c5fc5d](https://github.com/event4u-app/agent-config/commit/3c5fc5d100ea7c542a48778e4e0669f551fad946))
+* **install:** rules_use_symlinks toggle for both compress.py and install.sh ([927adc3](https://github.com/event4u-app/agent-config/commit/927adc35002588eef4d24825c313e6a9511d6ca1))
+* **ai-council:** default rounds via ai_council.min_rounds (default 2) ([26da301](https://github.com/event4u-app/agent-config/commit/26da30125a0b5a2c74c9c48cf6a2f8e2e5d021dd))
+* **ai-council:** isolate council artefacts as gitignored, auto-pruned scratch ([ab0e245](https://github.com/event4u-app/agent-config/commit/ab0e245734c8560f6d93df927b8af6d105c1d8dc))
+* **rules:** enforce logical-name path conventions for load_context ([fd12ff6](https://github.com/event4u-app/agent-config/commit/fd12ff6b37cec7d2be8ea88d3ec055333fea13e2))
+* **rules:** land kernel + router architecture ([d4fe80e](https://github.com/event4u-app/agent-config/commit/d4fe80e1ce2a956eb86df328de32e3252515553f))
+* **linter:** validate router frontmatter schema (P3.3) ([124e4d7](https://github.com/event4u-app/agent-config/commit/124e4d7387c4f6b90dba5a60179580af5ba5ed45))
+* **router:** compile router.json + wire into CI (P3.2) ([a050a5c](https://github.com/event4u-app/agent-config/commit/a050a5c7b1ba4900be8d7439eadf5cd2953f15d1))
+* **router:** add rule-router schema contract (P3.1) ([e7b1088](https://github.com/event4u-app/agent-config/commit/e7b108809d2fc1f26b4f8f4254044c6019b75a90))
+* **kernel:** add Iron-Law SHA tooling + raise bucket cap to 26k (ADR-002) ([2f8b867](https://github.com/event4u-app/agent-config/commit/2f8b867bb1c306d8c03a754f68f8c82a53013689))
+* **kernel:** land P2.1 — kernel-budget enforcement + ADR-001 ([dd7d50a](https://github.com/event4u-app/agent-config/commit/dd7d50aeb81ca53c430d84d1c0ba36a93008c7f8))
+* **scripts:** add rule-budget measurement + Phase-1 pilot tooling ([396a85f](https://github.com/event4u-app/agent-config/commit/396a85fef25578871566c6c463f57e23b7f95ef2))
+
+### Bug Fixes
+
+* **commands:** add cluster: optimize to optimize-prompt frontmatter ([bdc3907](https://github.com/event4u-app/agent-config/commit/bdc390772086fa4c13dba1142eb2b82ab133f5a7))
+* **compress:** protect rule examples with inline-code backticks ([c5ea62b](https://github.com/event4u-app/agent-config/commit/c5ea62ba8937d52651544b8509b955498e109579))
+* **schema:** accept rewritten ../contexts/ paths in load_context ([8101320](https://github.com/event4u-app/agent-config/commit/8101320c9a014e02bddfa60fb433b09bd3646b0a))
+* **linter:** support validator_ignore frontmatter + dual-location contracts ([031bd7d](https://github.com/event4u-app/agent-config/commit/031bd7df79deb35a53b8f1d49384056cfcea7711))
+* **templates:** compressed mirror of templates/rule.md + placeholder fix for check-refs ([c182723](https://github.com/event4u-app/agent-config/commit/c18272386d1c5f31efdd14f6d2cca8b8d8b876c8))
+* **skills:** portability — script paths in rule-writing, lower-case agent-config in copilot-agents-optimization ([7e5a86f](https://github.com/event4u-app/agent-config/commit/7e5a86f5dda9a095e3d887c19df718555f7f347c))
+* **tests:** align load_context tests with logical-name path format ([924e52e](https://github.com/event4u-app/agent-config/commit/924e52ed4005d2fb8d22167899058ed9eeb61449))
+* **commit-mechanics:** trim four-exceptions block to fit 6k extended-size cap ([0b6391f](https://github.com/event4u-app/agent-config/commit/0b6391f08d23af71f8945a7e685c7a979e229d61))
+* **contexts:** restore obligation-keyword baseline after P2.2 rule compression ([8996bcd](https://github.com/event4u-app/agent-config/commit/8996bcd83621670f175f93d73ee1c577695d3b34))
+* **linear-digest:** update language-and-tone strip-section title after P2.2 rename ([9643a82](https://github.com/event4u-app/agent-config/commit/9643a82c15a9904ceefcc6a9f1b90a4ef2225b47))
+
+### Documentation
+
+* **roadmap:** add road-to-structural-linter-reform (council Option 3) ([ac62e56](https://github.com/event4u-app/agent-config/commit/ac62e563f17f697401c8d9045847b3c12ec1c927))
+* update package docs for kernel + router model ([8fef804](https://github.com/event4u-app/agent-config/commit/8fef804aa00ce578ee2b1a96c7002081f07bc538))
+* **kernel:** land Phase 1 classification + kernel set + Council R2 amendments ([a179487](https://github.com/event4u-app/agent-config/commit/a179487dd6fef2b548cd1b886a1e7d54a4c00a39))
+
+### Refactoring
+
+* compression logic ([6701f9f](https://github.com/event4u-app/agent-config/commit/6701f9f12568ddc409ccad62a7690d64ba885122))
+* **chat-history:** import emits summary + resume offer instead of verbatim entries ([dfafd9c](https://github.com/event4u-app/agent-config/commit/dfafd9cd62d740a7137f6a6e648acfb377f46b1b))
+* **kernel:** compress 8 kernel rules per P2.2 playbook + lock kernel (P2.3) ([4e771da](https://github.com/event4u-app/agent-config/commit/4e771da5c4ceea2e6d2e8935098f1cd231c80c30))
+
+### Chores
+
+* **router:** add routes_to to no-council-references rule ([fb50540](https://github.com/event4u-app/agent-config/commit/fb505404c9b03cb9fa597ac36793eb3f552585f7))
+* **roadmaps:** archive completed agent-memory roadmaps ([a35b680](https://github.com/event4u-app/agent-config/commit/a35b6803ff545ce2e9098a55cfa8ecb1fbcf624d))
+* **ownership:** regenerate matrix after road-to-structural-linter-reform ([174dd24](https://github.com/event4u-app/agent-config/commit/174dd24989f112eab89c628807acbbb0e10b6aae))
+* **ci:** regenerate index, catalog, roadmap complexity fix ([d61dc9c](https://github.com/event4u-app/agent-config/commit/d61dc9ce96f2ccdab8efd11281bf00d80ed755ef))
+* **docs:** bump getting-started command count from 94 to 95 ([6751897](https://github.com/event4u-app/agent-config/commit/6751897cdf2744683731fc9230183a38834e9b9c))
+* **sync:** regenerate agents/index.md + docs/catalog.md after prompt-optimizer ([cfe2367](https://github.com/event4u-app/agent-config/commit/cfe236759671792a9b49ff10f664fbed10edc4c4))
+* **readme:** bump command count from 94 to 95 after prompt-optimizer addition ([62a59a4](https://github.com/event4u-app/agent-config/commit/62a59a427986ff428d1c1e729d311914ce3be0e5))
+* **sync:** regenerate .windsurfrules after caveman arrow update ([509ba00](https://github.com/event4u-app/agent-config/commit/509ba0061500a47129c77da5bae1f8384636a09c))
+* **compression:** apply caveman abbreviation and arrow rules to mirror ([34e5b1f](https://github.com/event4u-app/agent-config/commit/34e5b1f85da99de94ea8b5f932011583c844a0c8))
+* **sync:** regenerate compressed mirror + ownership matrix after Phase 5-7 ([b421e8e](https://github.com/event4u-app/agent-config/commit/b421e8e3aae6c1ee739bbdd35ed4f44cd78eed85))
+* **roadmap:** archive road-to-path-fixes after Phase 7 closure ([651fd3e](https://github.com/event4u-app/agent-config/commit/651fd3e6586e552dab6368be1853141b2b2fb0ff))
+* **portability:** replace 'Galawork'/'galawork' with 'Consumer'/'consumer' ([bac0433](https://github.com/event4u-app/agent-config/commit/bac0433c13e007910564e6b21b82ca6e6dcccdf9))
+* regenerate router, index, catalog, windsurf rules, tool symlinks ([93685bb](https://github.com/event4u-app/agent-config/commit/93685bb0fbe7c9f671f3a49672e693a8e4a44b85))
+* **commands:** sync compressed mirror of chat-history/import.md to summary+resume ([0063941](https://github.com/event4u-app/agent-config/commit/0063941c69d011a8935ddbcc7ea1266cd4d2c692))
+* **roadmaps:** add road-to-path-fixes and refresh progress ([34f9c23](https://github.com/event4u-app/agent-config/commit/34f9c23ccf67f79758e7dd293c66bc4c443ccc29))
+* **roadmaps:** close kernel-router, package-opt, token-opt plates ([445ef25](https://github.com/event4u-app/agent-config/commit/445ef2574772358ca278ce2d334a08431e82ed68))
+* **roadmap:** close Phase 3 (Router contract) in kernel-and-router ([30b834f](https://github.com/event4u-app/agent-config/commit/30b834fceb9c1198ffae5f0d35d1c84e5bd44c24))
+* **ownership:** regenerate file-ownership matrix after P2.2 kernel compression ([0e82da1](https://github.com/event4u-app/agent-config/commit/0e82da18399cd1e9ecff57769116d7a3317c2949))
+
 ## [1.20.0](https://github.com/event4u-app/agent-config/compare/1.19.0...1.20.0) (2026-05-06)
 
 ### Features
@@ -1298,7 +1402,7 @@ our recommendation order, not its support status.
 
 * add iron rule for skill independence ([b060730](https://github.com/event4u-app/agent-config/commit/b060730e98b15b6bc498ad68a111035fab72907f))
 * address Copilot PR review feedback ([11b4d20](https://github.com/event4u-app/agent-config/commit/11b4d2060084d1739bfc9e6550fc78c4a4a0bcb7))
-* address galawork-api PR [#1466](https://github.com/event4u-app/agent-config/issues/1466) bot feedback ([c5f8e18](https://github.com/event4u-app/agent-config/commit/c5f8e18a6c429e2f8f0224e1d9130233107ce65e))
+* address consumer-api PR [#1466](https://github.com/event4u-app/agent-config/issues/1466) bot feedback ([c5f8e18](https://github.com/event4u-app/agent-config/commit/c5f8e18a6c429e2f8f0224e1d9130233107ce65e))
 * **check-refs:** resolve .augment/X as alias for .agent-src/X ([ff3b094](https://github.com/event4u-app/agent-config/commit/ff3b09479a7fa266606467d862f8de9277ef1fc4))
 * **check-refs:** skip forward refs in unchecked TODO items ([1458a18](https://github.com/event4u-app/agent-config/commit/1458a181eb5bbe3189777b87bd9ad210b8cc00c5))
 * **check-refs:** validate paths inside memory YAML + exempt consumer dirs ([ec4e8aa](https://github.com/event4u-app/agent-config/commit/ec4e8aae2a0f8e7c489442441b8cfa7f9242be2f))
@@ -1474,8 +1578,8 @@ our recommendation order, not its support status.
   for scope questions; Issues remain for bugs and feature requests.
 
 ### Removed
-- Hardcoded `galawork` references removed from installer and portability
-  checker. No public release ever shipped the legacy `# galawork/agent-config`
+- Hardcoded `consumer` references removed from installer and portability
+  checker. No public release ever shipped the legacy `# consumer/agent-config`
   gitignore marker, so the in-place migration path was also removed.
 
 ## [1.3.3] — 2026-04-17

package/README.md

@@ -7,7 +7,7 @@ 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>134 Skills</strong> · <strong>56 Rules</strong> · <strong>94 Commands</strong> · <strong>51 Guidelines</strong> · <strong>8 AI Tools</strong>
+  <strong>136 Skills</strong> · <strong>59 Rules</strong> · <strong>102 Commands</strong> · <strong>56 Guidelines</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
@@ -55,15 +55,11 @@ bash vendor/event4u/agent-config/scripts/install
 bash node_modules/@event4u/agent-config/scripts/install --profile=balanced
 ```
 
-**To install the package:** no Task, no Make, no build tools required.
-`scripts/install` orchestrates two stages: a bash payload sync and a
-Python bridge generator. **Python 3** (stdlib only, pre-installed on
-macOS 12.3+ and all major Linux distros) is required for the bridge
-stage; without it the orchestrator warns, runs the payload sync, and
-continues. The package makes rules, skills, and commands available
-project-locally for all supported AI tools. Task is required for
-*contributors* who want to rebuild the compressed content locally — see
-[CONTRIBUTING.md](CONTRIBUTING.md).
+**To install:** no Task / Make / build tools — `scripts/install` runs a
+bash payload sync plus a Python 3 bridge generator (stdlib only, default
+on macOS 12.3+ / major Linux distros). Python missing → orchestrator
+warns and continues payload-only. Task is needed only for *contributors*
+rebuilding compressed content — see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 **Verify hook coverage** after installing — every supported platform
 (Augment, Claude Code, Cowork, Cursor, Cline, Windsurf, Gemini CLI,
@@ -270,15 +266,20 @@ session is explicitly not.
 
 ## You don't need everything
 
-Start with **Rules + Skills**. Everything else is optional.
+`cost_profile` is the master switch for **rule-tier loading**. The kernel
+(always-loaded Iron-Law floor, ≤ 26k chars across 9 rules) ships in every
+profile; tier-1 and tier-2 rules are gated by profile and resolved at
+session start from `router.json`.
 
-| Mode | What's active | Runtime process overhead |
-|---|---|---|
-| **Minimal** (default) | Rules, Skills, Commands | None |
-| **Balanced** | + Runtime Dispatcher for skills that declare a shell command | Low |
-| **Full** | + Tool Adapters (GitHub / Jira read-only, opt-in) | Moderate |
+| Profile | Rule tiers loaded | Token footprint | Best for |
+|---|---|---|---|
+| **`minimal`** | kernel only (no router, no auto-rules) | lowest | Cost-sensitive sessions; trivial Q&A; CI runs |
+| **`balanced`** (default) | kernel + tier-1 auto-rules | medium | Day-to-day work — current behaviour superset |
+| **`full`** | kernel + tier-1 + tier-2 (everything) | highest | Agent-config development; full rule fidelity |
 
-Nothing runs automatically without your control. [Configure modes →](docs/customization.md)
+Architecture: [`docs/contracts/rule-router.md`](docs/contracts/rule-router.md) (beta) ·
+kernel set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-membership.md) (beta) ·
+[Configure profiles →](docs/customization.md)
 
 > **Stability tiers** — [`STABILITY.md`](docs/contracts/STABILITY.md) for
 > the full matrix. Runtime Dispatcher: **stable** (`php` / `node` handlers
@@ -342,7 +343,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 94 active commands](.agent-src/commands/)
+→ [Browse all 95 active commands](.agent-src/commands/)
 
 ---
 
@@ -367,7 +368,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 + 134 skills + 94 native commands). Cursor, Cline, Windsurf,
+> package (rules + 136 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.
@@ -449,7 +450,7 @@ telemetry:
 
 Reports: `./agent-config telemetry:report`. Full contract,
 privacy/redaction floor, and quartile semantics:
-[`docs/contracts/artifact-engagement-flow.md`](docs/contracts/artifact-engagement-flow.md) (beta).
+[`contexts/contracts/artifact-engagement-flow.md`](.agent-src.uncompressed/contexts/contracts/artifact-engagement-flow.md) (beta).
 
 ### Context-aware command suggestion
 
@@ -470,7 +471,7 @@ commands:
 Per-conversation: `/command-suggestion-off` disables the layer until
 re-enabled or the chat ends. Full scoring contract and hardening:
 [`adr-command-suggestion`](docs/contracts/adr-command-suggestion.md),
-[`command-suggestion-flow`](docs/contracts/command-suggestion-flow.md) (beta).
+[`command-suggestion-flow`](.agent-src.uncompressed/contexts/contracts/command-suggestion-flow.md) (beta).
 
 ---
 

package/config/agent-settings.template.yml

@@ -7,13 +7,15 @@
 
 # --- Cost profile ---
 #
-# Selects which agent surfaces are active. See docs/customization.md for
-# the authoritative description.
+# Master switch that controls which rule tiers load each session.
+# See docs/customization.md for the authoritative description and
+# docs/contracts/rule-router.md for the kernel + router architecture.
 #
-# minimal  = rules, skills, and commands only (zero extra surface, default)
-# balanced = + runtime dispatcher for skills that declare a shell command
-# full     = + tool adapters (GitHub / Jira, read-only, opt-in)
-# custom   = ignore profile — every matrix value must be set explicitly
+# minimal  = kernel only (always-loaded Iron-Law floor, ≤ 26k chars).
+#            No router, no auto-rules. Lowest token footprint.
+# balanced = kernel + tier-1 auto-rules (default — current behaviour superset).
+# full     = kernel + tier-1 + tier-2 (everything, highest token cost).
+# custom   = ignore profile — every matrix value must be set explicitly.
 cost_profile: __COST_PROFILE__
 
 # --- Personal preferences ---
@@ -74,6 +76,22 @@ github:
   # auto                  = detect on first use and update this setting
   pr_reply_method: create_review_comment
 
+# --- Augment Code projection (.augment/) ---
+#
+# Controls how rule files are written into .augment/rules/ during
+# install (scripts/install.sh) and the package's own projection
+# (scripts/compress.py --project-augment).
+#
+# Augment Code historically does not load symlinked rule files, so the
+# default is to write each rule as a real copy. Flip the toggle to true
+# once Augment Code supports symlinked rules — symlinks keep the files
+# in sync without re-running install/sync, and remove a class of stale-
+# copy path bugs.
+augment:
+  # When true, .augment/rules/*.md are symlinked into .agent-src/rules/.
+  # When false (default) or missing, they are copied as real files.
+  rules_use_symlinks: false
+
 # --- Eloquent (Laravel) ---
 eloquent:
   # Model property access style
@@ -205,10 +223,35 @@ ai_council:
       model: "gpt-4o"
       # mode: "manual"   # uncomment to override ai_council.mode
 
+  # Default number of debate rounds per /council invocation.
+  #
+  # Round 1 sees the artefact alone. Round 2+ sees the artefact plus
+  # anonymised critiques from the previous round (provider/model
+  # identity stripped per the neutrality Iron Law). Applies identically
+  # to api and manual transports — manual mode runs round 1 across all
+  # members, the host agent consolidates, then round 2 starts with the
+  # anonymised round-1 critiques folded in.
+  #
+  # Default is 2 so council members critique each other at least once
+  # before convergence. The agent does NOT ask "how many rounds?" when
+  # the requested rounds <= min_rounds; pass `rounds:N` on the
+  # invocation (or `--rounds N` to the CLI) to override.
+  min_rounds: 2
+
+  # Higher floor for deep-reasoning artefacts (architecture review,
+  # refactoring proposals, bug-diagnosis runs). Activated when the
+  # consuming rule, skill, or command declares `council_depth: deep`
+  # in its frontmatter, or the user passes `--depth deep` to the CLI.
+  # Effective rounds = max(deep_min_rounds, min_rounds), so this floor
+  # is monotonic — lowering it below `min_rounds` has no effect.
+  # Standard tasks keep `min_rounds`; cost rises only when an artefact
+  # opts in. Set to `min_rounds` to disable the deep tier.
+  deep_min_rounds: 3
+
   # Hard cost ceiling per /council invocation. The orchestrator pauses
   # before any member whose projected spend would breach a cap and asks
   # the user to continue. `max_total_usd: 0` disables the USD ceiling
-  # (token caps still apply).
+  # (token caps still apply). Total spend = rounds * single-round cost.
   #
   # Prices come from `agents/.agent-prices.md` (gitignored, refreshed weekly
   # by `python3 scripts/update_prices.py`; bootstrapped from
@@ -219,10 +262,11 @@ ai_council:
     max_calls: 10
     max_total_usd: 0.50
 
-  # Retention for `agents/council-sessions/` audit folders. Sessions
-  # older than this are pruned automatically on the next `save()`.
+  # Retention for council artefacts. Files older than this in
+  # `agents/council-{questions,responses,sessions}/` are pruned
+  # automatically on the next `save()` and on `task council-prune`.
   # `0` disables pruning (keep forever — disk grows unbounded).
-  session_retention_days: 14
+  session_retention_days: 7
 
 # --- Onboarding ---
 #
@@ -264,3 +308,15 @@ commands:
     # Commands to never suggest. Still work when typed explicitly.
     # Example: ["/refine-ticket", "/work"]
     blocklist: []
+
+  # --- /create-pr behavior ---
+  #
+  # Pre-creation preview of the generated PR description.
+  # false (default): skip the title/body preview + adjust loop in
+  # /create-pr; use the generated content directly. Saves agent tokens
+  # by avoiding a re-render of the full description in chat.
+  # true: show title and body in copyable code blocks and ask for
+  # adjustments before creating the PR.
+  # /create-pr:description-only always previews — that is its sole purpose.
+  create_pr:
+    preview_description: false