@event4u/agent-config 1.19.0 → 1.21.0

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

@@ -118,6 +118,35 @@ Do NOT use when:
 - Do NOT {anti-pattern 1}.
 - Do NOT {anti-pattern 2}.
 - Do NOT {anti-pattern 3}.
+
+<!-- SENIOR-TIER STUB BLOCKS (delete entire section if not `tier: senior`):
+  Senior-tier skills (frontmatter `tier: senior`) require four extra
+  blocks per `.agent-src.uncompressed/rules/skill-quality.md` §
+  Senior-Tier Required Structure. Mid-tier and untiered skills MUST
+  remove this section entirely. The four blocks are enforced by
+  `scripts/skill_linter.py` for `tier: senior` skills only.
+
+  ## Related Skills
+
+  **WHEN to use this**
+  - {situation A this skill resolves better than peer skill}
+  - {situation B}
+
+  **WHEN NOT to use this**
+  - {situation C} — route to [`{peer-skill}`](../{peer-skill}/SKILL.md)
+  - {situation D} — route to [`{peer-skill}`](../{peer-skill}/SKILL.md)
+
+  ## When the agent should load this
+
+  - "{user phrase 1 — concrete paraphrase}"
+  - "{user phrase 2}"
+  - "{user phrase 3}"
+
+  ## Output
+
+  1. **{artifact-name.md}** — {shape: markdown table / tree / report}
+  2. **{artifact-name-2.md}** — {shape}
+-->
 ````
 
 ## Quality Checklist (5 Skill Killers)
@@ -132,5 +161,5 @@ Before considering a skill complete, verify it passes all 5 checks:
 - [ ] **K6: Under 500 lines** — if larger, extract reference tables or templates into separate files in the skill folder
 - [ ] **English only** — all content in English
 - [ ] **No duplication** — doesn't repeat rules or guidelines that are already enforced elsewhere
-- [ ] **No "Related skills" section** — the agent discovers skills via `<available_skills>` descriptions; cross-links waste tokens and create maintenance burden
+- [ ] **No "Related skills" section for mid-tier / untiered skills** — the agent discovers them via `<available_skills>` descriptions; cross-links waste tokens. Senior-tier skills (`tier: senior`) MUST include the block per `skill-quality.md` § Senior-Tier Required Structure (linter-enforced).
 

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.19.0"
+    "version": "1.21.0"
   },
   "plugins": [
     {
@@ -39,9 +39,8 @@
         "./.claude/skills/bug-fix",
         "./.claude/skills/bug-investigate",
         "./.claude/skills/chat-history",
-        "./.claude/skills/chat-history-checkpoint",
-        "./.claude/skills/chat-history-clear",
-        "./.claude/skills/chat-history-resume",
+        "./.claude/skills/chat-history-import",
+        "./.claude/skills/chat-history-learn",
         "./.claude/skills/chat-history-show",
         "./.claude/skills/check-current-md",
         "./.claude/skills/check-refs",
@@ -74,6 +73,7 @@
         "./.claude/skills/dashboard-design",
         "./.claude/skills/data-flow-mapper",
         "./.claude/skills/database",
+        "./.claude/skills/dcf-modeling",
         "./.claude/skills/dependency-upgrade",
         "./.claude/skills/description-assist",
         "./.claude/skills/design-review",
@@ -105,6 +105,7 @@
         "./.claude/skills/fix-refs",
         "./.claude/skills/fix-seeder",
         "./.claude/skills/flux",
+        "./.claude/skills/funnel-analysis",
         "./.claude/skills/git-workflow",
         "./.claude/skills/github-ci",
         "./.claude/skills/grafana",
@@ -150,11 +151,13 @@
         "./.claude/skills/module-explore",
         "./.claude/skills/module-management",
         "./.claude/skills/multi-tenancy",
+        "./.claude/skills/okr-tree-modeling",
         "./.claude/skills/onboard",
         "./.claude/skills/openapi",
         "./.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",
@@ -183,6 +186,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",
@@ -195,6 +199,7 @@
         "./.claude/skills/requesting-code-review",
         "./.claude/skills/review-changes",
         "./.claude/skills/review-routing",
+        "./.claude/skills/rice-prioritization",
         "./.claude/skills/roadmap",
         "./.claude/skills/roadmap-create",
         "./.claude/skills/roadmap-execute",
@@ -226,7 +231,9 @@
         "./.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",
         "./.claude/skills/update-form-request-messages",
         "./.claude/skills/upstream-contribute",

package/AGENTS.md

@@ -14,6 +14,18 @@ when they install the package.
 
 ## What this repo is
 
+`event4u/agent-config` is a **governed skill suite** for two cognition
+clusters: engineering depth (Wing 1) and senior cross-department
+cognition (Wings 2–4: Product + Foundation, GTM + Growth, Money +
+Strategy + Ops). The differentiator is **depth over breadth, decisions
+over boilerplate, under a shared Iron-Law floor** (`commit-policy`,
+`non-destructive-by-default`, `language-and-tone`, `skill-quality`,
+`direct-answers`). The same agent that ships a refactor commit also
+runs DCF sensitivity, OKR-tree decomposition, and launch-funnel
+diagnosis — under the same governance.
+
+Mechanically the package is:
+
 - A distribution package, not an application of any framework.
 - `type: library` in `composer.json`; no `app/` directory, no application
   runtime (no Laravel, Symfony, Next.js, or other framework app code).
@@ -21,6 +33,26 @@ when they install the package.
 - Installed into consumer projects via `scripts/install.sh` (Bash) and
   `scripts/install.py` (Python bridge).
 
+## The four wings
+
+The skill suite is organized as four wings under one Iron-Law floor.
+Each wing has its own roadmap, its own personas, and its own plate;
+they compose via the cross-wing handoff contract
+([`docs/contracts/cross-wing-handoff.md`](docs/contracts/cross-wing-handoff.md) (beta),
+landing in `road-to-suite-closure.md` Phase 3).
+
+| Wing | Cognition cluster |
+|---|---|
+| **1 — Engineering** | Code craft, debugging, refactoring, release discipline; depth-first |
+| **2 — Product + Foundation** | Roles cluster (PM, designer, QA, EM); product discovery, prioritization, delivery shape |
+| **3 — GTM + Growth** | CMO + marketing + sales + lifecycle; channel-agnostic positioning + funnel cognition |
+| **4 — Money + Strategy + Ops** | CFO + COO + board-level strategy, valuation, org-design; stage-agnostic financial + operational cognition |
+
+Per-wing plates (roadmaps, persona maps, decision logs) live under
+`agents/roadmaps/` and `agents/contexts/`. Roadmaps are transient
+working layers — agents that need a wing's plate look it up by wing
+number rather than by file path (per `no-roadmap-references`).
+
 ## Source of truth
 
 | Directory | Purpose | Editable? |
@@ -48,6 +80,15 @@ No application code or framework runtime (no Laravel / Symfony / Next.js /
 Express). The `composer.json` / `package.json` are thin distribution
 manifests.
 
+**Cognition-only floor for Wings 2–4.** Wings 2, 3, and 4 enforce a
+no-SaaS-auth, no-vendor-SDK, no-stage-prescription floor: cognition
+artifacts (markdown tables, scoring rubrics, walkthroughs) must work
+in any host without external dependencies. The structural-malice
+check in `skill_linter.py` enforces this boundary mechanically (no
+credential exfiltration, no remote execution, no shell injection in
+subprocess calls — see `.agent-src.uncompressed/rules/skill-quality.md`
+§ Structural Malice Floor).
+
 ## Working on this repo
 
 ```bash
@@ -70,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).
 
@@ -84,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
 
@@ -98,11 +139,35 @@ 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/       (129 skills)
+  skills/       (136 skills)
   rules/        (58 rules)
   commands/     (95 commands)
   personas/     (7 personas)
@@ -110,7 +175,10 @@ and
   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,183 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [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
+
+* **rules:** add no-attribution-footers + create-pr strip-pass ([7f72630](https://github.com/event4u-app/agent-config/commit/7f72630e0f334b30df6bc8ffc0fabb82fcca2fe3))
+* **orchestration:** mode-6 do-in-worktrees for cross-wing chains ([9087e50](https://github.com/event4u-app/agent-config/commit/9087e50f753fa5c4ef0eb1a048a64f7ccb4994af))
+* **cognition:** port five senior-tier cognition skills (Wings 3+4) ([aa958e7](https://github.com/event4u-app/agent-config/commit/aa958e772f82f05f3b23f9bbdd38ff0c8a89bd51))
+* **handoff:** cross-wing handoff contract + lint ([cb8e73a](https://github.com/event4u-app/agent-config/commit/cb8e73a8e0dd433d8e166ab926f585914aa5dbf1))
+* **skill-quality:** senior-tier authoring standard + structural malice lint ([bcbf8de](https://github.com/event4u-app/agent-config/commit/bcbf8de61f4d6b47fe244c80722886f512315caf))
+* **chat-history:** surface helper-built summary in session picker ([0bdd61b](https://github.com/event4u-app/agent-config/commit/0bdd61b1f00ed911ee5dbf764e9598f24d80fb54))
+* **infra:** relocate chat-history + prices to agents/ folder ([2727f26](https://github.com/event4u-app/agent-config/commit/2727f26bb986b4ed7414f466561ae600ca3a24ba))
+* **council:** add --model per-invocation override ([b21a20c](https://github.com/event4u-app/agent-config/commit/b21a20c16b49392070c62fc21af8ab887b8df978))
+* **settings:** expose chat_history.text_limits in template ([7941d7f](https://github.com/event4u-app/agent-config/commit/7941d7fd9a4a66fde046646661c0f8a467fc6900))
+* add docs-verified hook extractors for cursor/cline/windsurf/gemini ([5fa2e14](https://github.com/event4u-app/agent-config/commit/5fa2e14dd5cd2b88156d36d5cc47d9fad918758a))
+* **hooks:** universal capture + redact tooling for verified-platforms roadmap ([32a6ecd](https://github.com/event4u-app/agent-config/commit/32a6ecdc1f68c7187aa73a98e2116fb2f26ee201))
+* **hooks:** cowork platform support + hook-manifest tightening ([6016286](https://github.com/event4u-app/agent-config/commit/601628601dde7bb15e0e5ae4d3d23fbdeac8d3a9))
+* **chat-history:** schema v4 — stateless multi-session, position-based pruning, work-engine hook fix ([364990b](https://github.com/event4u-app/agent-config/commit/364990b3768af8d19bb6ecca916d3e5dac8c56c4))
+* **chat-history:** shrink session sidecar to {fp, started_at} ([c00a3e2](https://github.com/event4u-app/agent-config/commit/c00a3e27691637c1ffe9ca6b05d1f0531c95e85d))
+* **chat-history:** add /chat-history learn for selective historical context import ([2a88511](https://github.com/event4u-app/agent-config/commit/2a885111399eac7a5756edfaea5981e403e93177))
+* **chat-history:** add session isolation (schema v3) with read filter and sessions API ([6fd118d](https://github.com/event4u-app/agent-config/commit/6fd118d0f138068789e2167226a524ef92b82eab))
+* **contexts:** drop handshake context, slim platform-hooks doc ([ad39197](https://github.com/event4u-app/agent-config/commit/ad39197a089d79b00263625a4c84bb1ed1937193))
+* **commands:** trim /chat-history to show-only ([ba1d305](https://github.com/event4u-app/agent-config/commit/ba1d305e2ca6365a0668113ce94a3c3afc78bcee))
+* **work-engine:** drop chat-history turn-check + heartbeat hooks ([7883e64](https://github.com/event4u-app/agent-config/commit/7883e640bf880bf371ad1dd14a37b1f79d9aaf88))
+* **chat-history:** auto-adopt on session_start + delete cooperative rules ([579a1bc](https://github.com/event4u-app/agent-config/commit/579a1bcdea2b4fe7dbff8d650997c35d5366d292))
+
+### Bug Fixes
+
+* **no-roadmap-refs:** drop roadmap file links from stable artifacts ([b4a56f4](https://github.com/event4u-app/agent-config/commit/b4a56f499d1c070ad658fb9a87b6d272f1d05b79))
+* **public-links:** tag cross-wing-handoff as beta, drop link into agents/contexts/ ([89ac1ac](https://github.com/event4u-app/agent-config/commit/89ac1ac13ce52d26914abe14de2336f68f4e252f))
+* **check-refs:** allow runtime-bootstrapped agents/.agent-prices.md ([5b45a17](https://github.com/event4u-app/agent-config/commit/5b45a176cc42a04a771a01aa9384a0ad8da0b222))
+* **roadmap:** demote Kill-switch headings so check-roadmap-trackable stops parsing them as phases ([3029195](https://github.com/event4u-app/agent-config/commit/3029195c75eb16b95f57dd2c04401f8ead63f5e9))
+* **roadmap:** repair remaining check-refs errors in event-driven-discipline ([bd8f908](https://github.com/event4u-app/agent-config/commit/bd8f908f9d5955cb8aa8a6b8c841076f0ee4dc91))
+* **roadmap:** repair broken refs in event-driven-discipline ([6584a52](https://github.com/event4u-app/agent-config/commit/6584a5221a0fdb05b2f69d7a6b5c9c4c7b8ee163))
+* **chat-history:** migrate stale v3 header in-place on first hook write ([d239a39](https://github.com/event4u-app/agent-config/commit/d239a3903a81a569ee2cd372dd3c6c709153bbb8))
+* **lint:** add skills frontmatter to /chat-history learn ([01e8db3](https://github.com/event4u-app/agent-config/commit/01e8db31a1822c275dff6410fed2622ba9683fad))
+* **readme:** drop agents/contexts/ deep-link, mark hook-architecture-v1 as beta ([eeacbeb](https://github.com/event4u-app/agent-config/commit/eeacbeb1e748e98613102f0008756a5db155159b))
+
+### Documentation
+
+* **roadmaps:** add productization + kernel-and-router roadmaps ([1f7fbd4](https://github.com/event4u-app/agent-config/commit/1f7fbd4aca67e33a086d90e8a9e316ab0d7d8815))
+* **roadmap:** add road-to-package-optimization + dashboard sync ([016597f](https://github.com/event4u-app/agent-config/commit/016597ff468bc74cfefa0af9e86052cce872d865))
+* **analysis:** add package-optimizer design comparison ([607cf7f](https://github.com/event4u-app/agent-config/commit/607cf7f2b1786b62b36265798f66daa057d37e8f))
+* **council:** add package-optimizer design Q&A ([2211a59](https://github.com/event4u-app/agent-config/commit/2211a59fc8ae408a18a01101ac33711eda8a8285))
+* **roadmap:** add road-to-token-optimization + dashboard sync ([6348108](https://github.com/event4u-app/agent-config/commit/6348108162993e5947eea3d5612e43c4fdc18686))
+* **analysis:** add token-optimizer design comparison ([05462cf](https://github.com/event4u-app/agent-config/commit/05462cf17ebab4dd9c02b9683bc741e5be3c8a12))
+* **council:** add token-optimizer skill design Q&A ([eb6f9c3](https://github.com/event4u-app/agent-config/commit/eb6f9c3aad9c4ef20707181f8f3454f37f405761))
+* **roadmap:** add road-to-ruflo-adoption + dashboard sync ([009d94d](https://github.com/event4u-app/agent-config/commit/009d94d26c83c28dc0b2bac52b7109ff5f6a72d9))
+* **analysis:** add ruflo harvest comparison ([55d371c](https://github.com/event4u-app/agent-config/commit/55d371c1d427d20391f875430541d47b81fb9095))
+* **council:** add ruflo harvest prioritization Q&A ([7452d39](https://github.com/event4u-app/agent-config/commit/7452d3966bd6f7ce8e8f6e03e88a6bc6acb6fef8))
+* **roadmap:** add road-to-mobile-adoption + dashboard sync ([ca092df](https://github.com/event4u-app/agent-config/commit/ca092df913d00870d3227e212e507075462f0d87))
+* **analysis:** add mobile harvest comparison ([6791a78](https://github.com/event4u-app/agent-config/commit/6791a780276da3fccd100d6f5fd6b6e29c466673))
+* **council:** add mobile harvest prioritization Q&A ([48cc665](https://github.com/event4u-app/agent-config/commit/48cc6655927447e18fea455c89c7c7066c4ec9f6))
+* **roadmap:** add road-to-deep-research-adoption + dashboard sync ([9adc2d8](https://github.com/event4u-app/agent-config/commit/9adc2d8b0dd7ee0cdd2b919a4d776cab0f9f4b7a))
+* **analysis:** add deep-research harvest comparison ([4f5ead5](https://github.com/event4u-app/agent-config/commit/4f5ead50ee02de32016262fe6189208c7f9c6cbc))
+* **council:** add deep-research harvest prioritization Q&A ([1b08ea5](https://github.com/event4u-app/agent-config/commit/1b08ea5bdac158bb119f0851684f391e69e26c72))
+* add Microck deep-scan harvest analysis, council artifacts, and roadmap ([36baf23](https://github.com/event4u-app/agent-config/commit/36baf23ef898ab860163fcacfa9239a403032df0))
+* add Microck methodology comparison analysis ([1e34e78](https://github.com/event4u-app/agent-config/commit/1e34e788877a9f6101af5426587de63156e267dd))
+* add markitdown adoption analysis, council artifacts, and roadmap ([276b5d4](https://github.com/event4u-app/agent-config/commit/276b5d4374547386d407b1a01995620c90754363))
+* **suite:** lock identity as four-wing governed skill suite ([47c8211](https://github.com/event4u-app/agent-config/commit/47c8211ab7b42fa97352f747e2081fba82fe92b5))
+* **roadmap:** expand event-driven-discipline with platform tiers ([11edf9b](https://github.com/event4u-app/agent-config/commit/11edf9bb7666eaac18f7b8937437ff07db2b28f7))
+* sync active command count to 94 (drift fix) ([9be26bc](https://github.com/event4u-app/agent-config/commit/9be26bc6f4a2dbfd2bb53fe7052ce5717a6f9c47))
+* **roadmap:** event-driven agent discipline v3 ([71728cd](https://github.com/event4u-app/agent-config/commit/71728cde49a08f74c9fb44b133befcd4b6b89796))
+* **hooks:** relocate payload capture guide to docs/ ([4d39510](https://github.com/event4u-app/agent-config/commit/4d395108d461137e4df15adb04eed5fdd2a27dbb))
+* **rules,roadmap:** inline user-interaction failure-mode catalog + chat-history verified-platforms roadmap ([7ec07a0](https://github.com/event4u-app/agent-config/commit/7ec07a0733179373bcf3df6affcefe75ce341440))
+* **chat-history:** document v3 sidecar shape and legacy kill-switch ([2d1a393](https://github.com/event4u-app/agent-config/commit/2d1a39316c595810b24cc5e14fb153a2cf6a48c3))
+* bump remaining 92 → 93 command counts in browse + tools blurb ([1eeb019](https://github.com/event4u-app/agent-config/commit/1eeb019e34f1dfa0747e65eee304b8897c650389))
+* regenerate index/catalog and tag sidecar-shrink complexity ([c8e25d8](https://github.com/event4u-app/agent-config/commit/c8e25d86f6b19b10c06a7d845dc81da840ea6fb6))
+* bump command count to 93 across README, AGENTS, and architecture ([1902f22](https://github.com/event4u-app/agent-config/commit/1902f2230c433f1f33bf2ae4ad2cfbf2cfc3274c))
+* **chat-history:** document session-isolation read contract in platform-hooks context ([a59602e](https://github.com/event4u-app/agent-config/commit/a59602e8ad160f2da90ca8553b4e7c5fd8f62a60))
+
+### Refactoring
+
+* **work-engine:** remove obsolete chat-history heartbeat hook ([df2c6f1](https://github.com/event4u-app/agent-config/commit/df2c6f101edd60f77877c6162753c5b7d13f1992))
+* **chat-history:** split learn into import + project-learning workflow ([e11daa5](https://github.com/event4u-app/agent-config/commit/e11daa5c389ca1a4f3dd9b5ca123c57e145476c8))
+
+### Tests
+
+* **budget:** re-baseline TOP5_CEILING after language-and-tone re-sync ([3ac7b7b](https://github.com/event4u-app/agent-config/commit/3ac7b7b5b92d7a1cdfd6b80c6d77151034847939))
+
+### Chores
+
+* **matrix:** regenerate ownership matrix after no-attribution-footers add ([1bb7a9e](https://github.com/event4u-app/agent-config/commit/1bb7a9e452089f57f29c5aa74673fe682ecc682b))
+* **index:** regenerate after no-attribution-footers rule add ([0a95647](https://github.com/event4u-app/agent-config/commit/0a9564795b7d1c0a9e353927c07d9f15459f5ee8))
+* **tools:** regenerate .windsurfrules after no-attribution-footers trim ([d2a780b](https://github.com/event4u-app/agent-config/commit/d2a780b9c538c22fdc56ebcb1c245b23dababdee))
+* **rules:** trim no-attribution-footers to satisfy long_rule budget ([c407192](https://github.com/event4u-app/agent-config/commit/c40719271caddb1ccb0bf7e144aa42a295e391a5))
+* **ci:** unblock PR #44 — broken refs + word-count regression ([eccede0](https://github.com/event4u-app/agent-config/commit/eccede000451c4cec5b547deca1d78e0d3d916b5))
+* regenerate roadmap progress dashboard ([0c68f5b](https://github.com/event4u-app/agent-config/commit/0c68f5b354a61865836cde2e07fbfb19a3446e31))
+* **ownership-matrix:** regenerate after suite-closure work ([0b7f992](https://github.com/event4u-app/agent-config/commit/0b7f9920702df1e8b5b7db47d596caec312e0c17))
+* **roadmaps:** tag wing roadmaps with complexity: structural ([1e0c9c6](https://github.com/event4u-app/agent-config/commit/1e0c9c6b32e5ba16f34e62efb56a5a563a42b11c))
+* **index:** regenerate agents/index and docs/catalog ([9a3c1cb](https://github.com/event4u-app/agent-config/commit/9a3c1cb5c6730e5d48c85b85cf055f6e0302a5a7))
+* **sync:** refresh compression hashes and gitignore ([5f91975](https://github.com/event4u-app/agent-config/commit/5f91975f81c2c1ba0bf079b8366750e2aec1e984))
+* **roadmaps:** regenerate roadmaps-progress dashboard ([3d85dbd](https://github.com/event4u-app/agent-config/commit/3d85dbd854cbabc0c85c47685bdb96a22338a9fa))
+* **council:** remove unused playwright transport-mode scaffold ([672c512](https://github.com/event4u-app/agent-config/commit/672c5126e477ec43e4cc50d17e34f7ee3bca9a53))
+* **council:** default transport mode to manual instead of api ([4a41dfb](https://github.com/event4u-app/agent-config/commit/4a41dfbbaf879f5333ba5b665d5a0e32c4fac82d))
+* **roadmap:** regenerate roadmaps-progress dashboard ([6b01795](https://github.com/event4u-app/agent-config/commit/6b01795a267d5f69c5754ef7d59fbb125187be3a))
+* **ownership:** regenerate file-ownership matrix ([383d580](https://github.com/event4u-app/agent-config/commit/383d5808d5a0234149a69deb744625b1bc983b95))
+* **compress:** re-compress language-and-tone + user-interaction mirrors ([66a9f91](https://github.com/event4u-app/agent-config/commit/66a9f91520775f0097e33f688b2a2fa458c2d14b))
+* **index:** regenerate index + catalog after command-count sync ([03cf603](https://github.com/event4u-app/agent-config/commit/03cf603e84feedb7eea1845f39f258dbf0225f3a))
+* **hashes:** refresh compression hashes for language-and-tone + user-interaction ([fc361b4](https://github.com/event4u-app/agent-config/commit/fc361b49f19c14ddc3e4b8aa33093d1f9fa4ca7c))
+* add chat history cross agend hardening ([b9b9adb](https://github.com/event4u-app/agent-config/commit/b9b9adb2fb14ca089e92070a57821762269517b6))
+* **rules:** tighten language-and-tone and user-interaction iron laws ([57fa47d](https://github.com/event4u-app/agent-config/commit/57fa47d4331f0c2043165d82a3cbb2941c6278f9))
+* **roadmap:** archive road-to-verified-chat-history-platforms ([b1881f0](https://github.com/event4u-app/agent-config/commit/b1881f084d2d2f9eba225d7144345163fcb0e1b3))
+* **handoff:** close cowork chat-history handoff after council verification ([99190c9](https://github.com/event4u-app/agent-config/commit/99190c9f0f3c475ca11bab0e0482b20e82c1717c))
+* **roadmap:** regenerate roadmap-progress dashboard ([c7e2ff1](https://github.com/event4u-app/agent-config/commit/c7e2ff14b6d7afc593a2d9b12775f16fe491e452))
+* **roadmap:** archive sidecar-shrink roadmap with council notes ([3cd3826](https://github.com/event4u-app/agent-config/commit/3cd3826d86197e8e5297cef300d97ca23d7efc40))
+* regenerate file-ownership matrix for /chat-history learn ([537e13e](https://github.com/event4u-app/agent-config/commit/537e13e2ccea293d9f15a0a68ee27bf21f1ddbb7))
+* **roadmaps:** archive hook-only and session-isolation; add sidecar-shrink follow-up ([099a81d](https://github.com/event4u-app/agent-config/commit/099a81de5b90bd28dd7e4748612cf2efaf71ff28))
+* **docs:** drop roadmap citations from superseded markers ([369eb7e](https://github.com/event4u-app/agent-config/commit/369eb7e33b831daf3cf3a1348637596913923bbe))
+* **docs:** sync command counts to 92 after chat-history trim ([0b20e8f](https://github.com/event4u-app/agent-config/commit/0b20e8f05332974ad6ace222dfa152b086a42bf8))
+* **docs+settings:** hook-only sweep + remove dead phase-coupling guard ([5a66dc9](https://github.com/event4u-app/agent-config/commit/5a66dc954959c0dd02babb0661014fbf387ffec4))
+
 ## [1.19.0](https://github.com/event4u-app/agent-config/compare/1.18.0...1.19.0) (2026-05-05)
 
 ### Features
@@ -1187,7 +1364,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))
@@ -1363,8 +1540,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>129 Skills</strong> · <strong>58 Rules</strong> · <strong>95 Commands</strong> · <strong>51 Guidelines</strong> · <strong>8 AI Tools</strong>
+  <strong>136 Skills</strong> · <strong>58 Rules</strong> · <strong>95 Commands</strong> · <strong>56 Guidelines</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
@@ -55,20 +55,16 @@ 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, Cursor, Cline, Windsurf, Gemini CLI, Copilot fallback)
-is wired through one universal dispatcher per
-[`hook-architecture-v1`](docs/contracts/hook-architecture-v1.md). Run
+(Augment, Claude Code, Cowork, Cursor, Cline, Windsurf, Gemini CLI,
+Copilot fallback) is wired through one universal dispatcher per
+[`hook-architecture-v1`](docs/contracts/hook-architecture-v1.md) (beta). Run
 `./agent-config hooks:status` for the matrix (`--strict` for CI,
 `--format json` for tooling). The installer also dry-fires the
 dispatcher per bridge as a post-install smoke test (skip: `--no-smoke`).
@@ -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
@@ -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 + 129 skills + 95 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).
 
 ---