@event4u/agent-config 1.19.0 → 1.20.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.20.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,6 +151,7 @@
         "./.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",
@@ -195,6 +197,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",
@@ -227,6 +230,7 @@
         "./.claude/skills/threat-model",
         "./.claude/skills/threat-modeling",
         "./.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
@@ -102,9 +143,9 @@ and
 
 ```
 .agent-src.uncompressed/      ← edit here
-  skills/       (129 skills)
-  rules/        (58 rules)
-  commands/     (95 commands)
+  skills/       (134 skills)
+  rules/        (56 rules)
+  commands/     (94 commands)
   personas/     (7 personas)
   templates/    (AGENTS.md, copilot-instructions.md, skill.md, …)
   contexts/

package/CHANGELOG.md

@@ -318,6 +318,117 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [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

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>134 Skills</strong> · <strong>56 Rules</strong> · <strong>94 Commands</strong> · <strong>51 Guidelines</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
@@ -66,9 +66,9 @@ project-locally for all supported AI tools. Task is required for
 [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`).
@@ -342,7 +342,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 95 active commands](.agent-src/commands/)
+→ [Browse all 94 active commands](.agent-src/commands/)
 
 ---
 
@@ -367,7 +367,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 + 134 skills + 94 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.

package/config/agent-settings.template.yml

@@ -84,7 +84,7 @@ eloquent:
 
 # --- Chat history (crash recovery) ---
 #
-# Persistent JSONL log at .agent-chat-history (project root, git-ignored).
+# Persistent JSONL log at agents/.agent-chat-history (git-ignored).
 # Keeps a durable record of the conversation so a crashed or switched
 # agent session can be resumed. See scripts/chat_history.py for the API.
 chat_history:
@@ -105,12 +105,19 @@ chat_history:
   #   compress = mark for summarization on the next agent turn
   on_overflow: __CHAT_HISTORY_ON_OVERFLOW__
 
-  # Heartbeat marker visibility (token-cost knob)
-  #   on     = print the 📒 marker every reply (~20 tokens/reply, legacy)
-  #   off    = never print (zero tokens, drift only visible by reading the file)
-  #   hybrid = print only on drift states (missing/foreign/returning); silent otherwise
-  # YAML 1.1 booleanizes bare on/off — both are accepted, no quoting needed.
-  heartbeat: hybrid
+  # Per-entry-type text-length caps (chars). 0 = verbatim, no slice.
+  # N > 0 = collapse whitespace, slice to N chars, append " … [+K chars]"
+  # so the log self-reports truncation. Defaults match the hardcoded
+  # fallback in scripts/chat_history.py (DEFAULT_TEXT_LIMITS).
+  #   user  = your messages — full text by default (most valuable for crash recovery)
+  #   agent = agent replies — capped to keep the log compact under load
+  #   tool  = tool inputs/outputs — short by default; bump for noisy debugging
+  #   phase = workflow phase markers — short by default
+  text_limits:
+    user: 0
+    agent: 5000
+    tool: 200
+    phase: 200
 
 # --- Optional pipelines ---
 pipelines:
@@ -179,12 +186,11 @@ ai_council:
   # Default transport mode for every member (overridable per-member
   # below, and per-invocation via `/council mode:<x>`).
   #
-  #   api        = direct SDK call against the provider's API (billable).
-  #   manual     = copy-paste loop, user is the transport (free).
-  #   playwright = browser automation (Phase 2c, not yet wired).
+  #   api    = direct SDK call against the provider's API (billable).
+  #   manual = copy-paste loop, user is the transport (free).
   #
-  # Precedence: invocation flag > per-member mode > global mode > "api".
-  mode: "api"
+  # Precedence: invocation flag > per-member mode > global mode > "manual".
+  mode: "manual"
 
   # Per-member configuration. Set enabled=true on the providers you want
   # to consult. The model field selects which model receives the query.
@@ -204,7 +210,7 @@ ai_council:
   # the user to continue. `max_total_usd: 0` disables the USD ceiling
   # (token caps still apply).
   #
-  # Prices come from `.agent-prices.md` (gitignored, refreshed weekly
+  # Prices come from `agents/.agent-prices.md` (gitignored, refreshed weekly
   # by `python3 scripts/update_prices.py`; bootstrapped from
   # scripts/ai_council/_default_prices.py on first run).
   cost_budget:

package/config/gitignore-block.txt

@@ -19,13 +19,13 @@
 .agent-settings.backup.key-value
 
 # Agent config — persistent chat history (crash recovery, never commit)
-.agent-chat-history
-.agent-chat-history.bak
-.agent-chat-history.*.bak
+/agents/.agent-chat-history
+/agents/.agent-chat-history.bak
+/agents/.agent-chat-history.*.bak
 
 # Agent config — artefact engagement telemetry (default-off, maintainer-only, never commit)
 .agent-engagement.jsonl
 .agent-engagement.jsonl.bak
 
 # Agent config — AI Council price table (refreshed weekly, never commit)
-.agent-prices.md
+/agents/.agent-prices.md

package/docs/architecture.md

@@ -62,9 +62,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** | 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`, … |
+| **Skills** | 134 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
+| **Rules** | 56 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
+| **Commands** | 94 | 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 |

package/docs/catalog.md

@@ -1,13 +1,13 @@
 # agent-config — Public Catalog
 
-Consumer-facing catalog of all **330 public artefacts** shipped by
+Consumer-facing catalog of all **332 public artefacts** shipped by
 this package. Internal package-maintenance rules and deprecation shims
 are excluded.
 
 > **Regenerate:** `python3 scripts/generate_index.py`
 > Auto-generated — do not edit manually.
 
-## Skills (129)
+## Skills (134)
 
 | kind | name | extra | description |
 |---|---|---|---|
@@ -39,6 +39,7 @@ are excluded.
 | skill | [`dashboard-design`](../.agent-src/skills/dashboard-design/SKILL.md) |  | Use when designing monitoring dashboards — visualization selection, layout principles, observability strategies (RED/USE/Golden Signals), and data storytelling. |
 | skill | [`data-flow-mapper`](../.agent-src/skills/data-flow-mapper/SKILL.md) |  | Use BEFORE editing code that touches user data — traces the value from entry → validation → transformation → storage → egress, every hop cited with file:line. |
 | skill | [`database`](../.agent-src/skills/database/SKILL.md) |  | Use when working with database architecture, MariaDB/MySQL tuning, indexing strategies, slow queries, or multi-connection patterns — even when the user just says 'this query is slow'. |
+| skill | [`dcf-modeling`](../.agent-src/skills/dcf-modeling/SKILL.md) |  | Wing-4 valuation cognition for a CFO / finance-partner. Use when a deal, internal investment, or board ask names DCF, intrinsic value, WACC, terminal value, or 'what's it worth on a 5-year hold'. |
 | skill | [`dependency-upgrade`](../.agent-src/skills/dependency-upgrade/SKILL.md) |  | Use when upgrading dependencies — "update Laravel", "bump PHP version", or "upgrade packages". Covers changelog review, breaking change detection, and verification. |
 | skill | [`description-assist`](../.agent-src/skills/description-assist/SKILL.md) |  | Use when polishing a skill/rule/command/guideline frontmatter description — pushier phrasing, trigger coverage, undertrigger audit — even if the user just says 'make this pushier'. |
 | skill | [`design-review`](../.agent-src/skills/design-review/SKILL.md) |  | Use when the user says "review the design", "check the UI", or wants a comprehensive UI/UX review. Uses a 7-phase methodology covering interaction, responsiveness, accessibility, and more. |
@@ -54,6 +55,7 @@ are excluded.
 | skill | [`file-editor`](../.agent-src/skills/file-editor/SKILL.md) |  | Use when opening edited files in the user's IDE. Reads settings from .agent-settings.yml to determine IDE and whether auto-open is enabled. |
 | skill | [`finishing-a-development-branch`](../.agent-src/skills/finishing-a-development-branch/SKILL.md) |  | Use when the feature is implementation-complete and the next step is 'ship it' — verifies, cleans up, and routes to merge/PR/park/discard — even when the user just says 'I'm done, what now?'. |
 | skill | [`flux`](../.agent-src/skills/flux/SKILL.md) |  | Use when the project uses `livewire/flux` — dispatched by `directives/ui/{apply,review,polish}.py`. Covers Flux components, slots, variants, and form primitives. |
+| skill | [`funnel-analysis`](../.agent-src/skills/funnel-analysis/SKILL.md) |  | Use when diagnosing where a SaaS or product funnel leaks — visitor → signup → activation → paid → retained — channel-agnostic, conversion-rate-driven. |
 | skill | [`git-workflow`](../.agent-src/skills/git-workflow/SKILL.md) |  | Use when working with Git — branch naming, commit messages, PR creation, rebasing, or the code review process — even when the user says 'push this' or 'merge the branch' without naming Git. |
 | skill | [`github-ci`](../.agent-src/skills/github-ci/SKILL.md) |  | Use when working with GitHub Actions — workflow YAML, quality gates, test matrices, deployment triggers, reusable workflows — even when the user just says 'my CI is failing' or 'add a check'. |
 | skill | [`grafana`](../.agent-src/skills/grafana/SKILL.md) |  | Use when working with Grafana — dashboards, Loki LogQL queries, alerting rules, monitoring panels — even when the user just says 'build me a dashboard' or 'query the logs' without naming Grafana. |
@@ -84,6 +86,7 @@ are excluded.
 | skill | [`migration-creator`](../.agent-src/skills/migration-creator/SKILL.md) |  | Use when the user says "create migration", "add column", or "new table". Creates migrations with correct table prefixes, column naming, and multi-tenant awareness. |
 | skill | [`module-management`](../.agent-src/skills/module-management/SKILL.md) |  | Use when the user says "create module", "explore module", or works within app/Modules/. Understands module structure, auto-loading, route registration, and namespace conventions. |
 | skill | [`multi-tenancy`](../.agent-src/skills/multi-tenancy/SKILL.md) |  | Use when working with the multi-tenant architecture — customer DB switching, FQDN routing, tenant isolation, or cross-tenant operations. |
+| skill | [`okr-tree-modeling`](../.agent-src/skills/okr-tree-modeling/SKILL.md) |  | Use when decomposing a company objective into team OKRs, auditing a draft OKR tree, or stress-testing an existing one for measurability and laddering. |
 | skill | [`openapi`](../.agent-src/skills/openapi/SKILL.md) |  | Use when documenting APIs — OpenAPI/Swagger, PHP attributes, Redocly validation, versioned specs — even when the user just says 'document this endpoint' without naming OpenAPI. |
 | skill | [`override-management`](../.agent-src/skills/override-management/SKILL.md) |  | Creates and manages project-level overrides for shared skills, rules, and commands — extending or replacing originals from .augment/ with project-specific behavior in agents/overrides/. |
 | skill | [`performance`](../.agent-src/skills/performance/SKILL.md) |  | Use when optimizing application performance — caching strategies, eager loading, query optimization, Redis patterns, or background job design. |
@@ -113,6 +116,7 @@ are excluded.
 | skill | [`refine-ticket`](../.agent-src/skills/refine-ticket/SKILL.md) |  | Refine a Jira/Linear ticket before planning — 'refine ticket', 'tighten AC on PROJ-123', 'ist das Ticket klar?' — rewritten ticket, Top-5 risks, persona voices, sub-skills orchestrated, close-prompt. |
 | skill | [`requesting-code-review`](../.agent-src/skills/requesting-code-review/SKILL.md) |  | Use when asking for a review or creating a PR — self-review first, frame the right context, test plan included — even when the user just says 'open a PR' or 'ready to merge'. |
 | skill | [`review-routing`](../.agent-src/skills/review-routing/SKILL.md) |  | Use when preparing a PR description, suggesting reviewers, or flagging risk — produces owner-mapped roles plus historical bug-pattern matches from project-local YAML. |
+| skill | [`rice-prioritization`](../.agent-src/skills/rice-prioritization/SKILL.md) |  | Use when ranking competing initiatives for a roadmap, breaking a tie between two features, or auditing a backlog for hidden low-value work via Reach × Impact × Confidence ÷ Effort. |
 | skill | [`roadmap-management`](../.agent-src/skills/roadmap-management/SKILL.md) |  | Use when the user says "create roadmap", "show roadmap", or "execute roadmap". Creates, reads, and manages roadmap files with phase tracking. |
 | skill | [`rtk-output-filtering`](../.agent-src/skills/rtk-output-filtering/SKILL.md) |  | Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns. |
 | skill | [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) |  | Use when creating or editing a rule in .agent-src.uncompressed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'. |
@@ -125,7 +129,7 @@ are excluded.
 | skill | [`skill-reviewer`](../.agent-src/skills/skill-reviewer/SKILL.md) |  | Use when reviewing, auditing, or optimizing skills — validates against the 7 Skill Killers checklist and produces fix recommendations. |
 | skill | [`skill-writing`](../.agent-src/skills/skill-writing/SKILL.md) |  | Use when deciding 'should this be a skill or a rule?', creating/improving/reviewing agent skills, SKILL.md frontmatter, or procedure sections — even without saying 'skill-writing'. |
 | skill | [`sql-writing`](../.agent-src/skills/sql-writing/SKILL.md) |  | Use when writing raw SQL — MariaDB/MySQL syntax, parameterization, raw migrations, seeders with `DB::statement` — even when the user just pastes a query and asks 'why is this slow' without naming SQL. |
-| skill | [`subagent-orchestration`](../.agent-src/skills/subagent-orchestration/SKILL.md) |  | Use when orchestrating implementer/judge subagents — five modes (do-and-judge, do-in-steps, do-in-parallel, do-competitively, judge-with-debate) — models from .agent-settings.yml. |
+| skill | [`subagent-orchestration`](../.agent-src/skills/subagent-orchestration/SKILL.md) |  | Use when orchestrating implementer/judge subagents — six modes (do-and-judge, do-in-steps, do-in-parallel, do-competitively, judge-with-debate, do-in-worktrees) — models from .agent-settings.yml. |
 | skill | [`systematic-debugging`](../.agent-src/skills/systematic-debugging/SKILL.md) |  | Use when hitting a bug, test failure, crash, or unexpected behavior — enforces reproduce → isolate → hypothesize → verify before any fix — even when the user just says 'this is broken' or 'quick fix'. |
 | skill | [`technical-specification`](../.agent-src/skills/technical-specification/SKILL.md) |  | Use when the user says "write a spec", "create RFC", or "document this decision". Writes technical specifications, RFCs, and ADRs with clear structure. |
 | skill | [`terraform`](../.agent-src/skills/terraform/SKILL.md) |  | Use when writing Terraform — AWS modules, resources, variables, outputs, remote state — even when the user just says 'provision this infra' or 'add an S3 bucket' without naming Terraform. |
@@ -134,6 +138,7 @@ are excluded.
 | skill | [`test-performance`](../.agent-src/skills/test-performance/SKILL.md) |  | Use when optimizing test suite performance — database setup, seeder optimization, parallel testing, CI pipeline efficiency, or RefreshDatabase alternatives. |
 | skill | [`threat-modeling`](../.agent-src/skills/threat-modeling/SKILL.md) |  | Use when adding auth, webhooks, uploads, queues, secrets, tenant boundaries, or public endpoints — produces trust boundaries + abuse cases mapped to files, BEFORE implementation. |
 | skill | [`traefik`](../.agent-src/skills/traefik/SKILL.md) |  | Use when setting up Traefik as a local reverse proxy — real domains on 127.0.0.1, trusted HTTPS via mkcert, automatic service discovery, and multi-project routing. |
+| skill | [`unit-economics-modeling`](../.agent-src/skills/unit-economics-modeling/SKILL.md) |  | Use when modeling CAC, LTV, gross-margin payback, or contribution margin per customer — for SaaS, marketplace, or transactional businesses. |
 | skill | [`universal-project-analysis`](../.agent-src/skills/universal-project-analysis/SKILL.md) |  | ONLY when user explicitly requests: full project analysis, deep codebase audit, or comprehensive architecture review. Routes to core and framework-specific analysis skills. |
 | skill | [`upstream-contribute`](../.agent-src/skills/upstream-contribute/SKILL.md) |  | Use when a learning, new skill, rule improvement, or bug fix from a consumer project should be contributed back to the shared agent-config package. |
 | skill | [`using-git-worktrees`](../.agent-src/skills/using-git-worktrees/SKILL.md) |  | Use when starting parallel work in isolation from the current branch — spawn a git worktree with ignore-safety checks and a clean test baseline — even when the user says 'try this on the side'. |
@@ -141,7 +146,7 @@ are excluded.
 | skill | [`verify-completion-evidence`](../.agent-src/skills/verify-completion-evidence/SKILL.md) |  | Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs. |
 | skill | [`websocket`](../.agent-src/skills/websocket/SKILL.md) |  | Use when building real-time features — WebSocket broadcasting, live updates, presence channels, connection state — even when the user just says 'push this to the client live'. |
 
-## Rules (55)
+## Rules (53)
 
 | kind | name | type | description |
 |---|---|---|---|
@@ -154,9 +159,6 @@ are excluded.
 | rule | [`ask-when-uncertain`](../.agent-src/rules/ask-when-uncertain.md) | always | Ask when uncertain — don't guess, assume, or improvise |
 | rule | [`autonomous-execution`](../.agent-src/rules/autonomous-execution.md) | auto | Deciding whether to ask the user or just act on a workflow step — trivial-vs-blocking classification, autonomy opt-in detection, commit default; defers to non-destructive-by-default for the Hard Floor |
 | rule | [`capture-learnings`](../.agent-src/rules/capture-learnings.md) | auto | After completing a task where a repeated mistake or successful pattern appeared — capture as rule or skill |
-| rule | [`chat-history-cadence`](../.agent-src/rules/chat-history-cadence.md) | auto | Appending to .agent-chat-history — cadence boundaries (per_turn/per_phase/per_tool), turn-check ownership refusal handling, never writing the file directly; cadence is the trigger, not reply length |
-| rule | [`chat-history-ownership`](../.agent-src/rules/chat-history-ownership.md) | auto | First turn or reference to .agent-chat-history — detects ownership (match/returning/foreign/missing) and HOOK/ENGINE/CHECKPOINT/MANUAL path classification with numbered-options prompt |
-| rule | [`chat-history-visibility`](../.agent-src/rules/chat-history-visibility.md) | auto | Emitting the chat-history heartbeat marker — paste subprocess stdout verbatim or nothing, never type from memory, hybrid mode prints on drift only, slip handling per language-and-tone |
 | rule | [`cli-output-handling`](../.agent-src/rules/cli-output-handling.md) | auto | Running CLI commands that produce verbose output — git, tests, linters, docker, build tools, artisan, npm, composer. Wrap with rtk when installed; tail/grep is fallback. |
 | rule | [`command-suggestion-policy`](../.agent-src/rules/command-suggestion-policy.md) | auto | User prompt without /command but matching an eligible slash command — surface matches as numbered options with as-is escape hatch; never auto-executes, user always picks |
 | rule | [`commit-conventions`](../.agent-src/rules/commit-conventions.md) | auto | Git commit message format, branch naming, conventional commits, committing, pushing, or creating pull requests |
@@ -174,6 +176,7 @@ are excluded.
 | rule | [`minimal-safe-diff`](../.agent-src/rules/minimal-safe-diff.md) | auto | When writing or reviewing a diff — the smallest change that solves the stated problem; no drive-by edits, no opportunistic refactors, no reformatting of untouched code |
 | rule | [`missing-tool-handling`](../.agent-src/rules/missing-tool-handling.md) | auto | When a CLI tool needed for the task is not installed — ask before working around it; do NOT install silently |
 | rule | [`model-recommendation`](../.agent-src/rules/model-recommendation.md) | auto | Starting a new task, switching task type, or invoking a command — detect task complexity and recommend the optimal model (Opus/Sonnet/GPT) before any work |
+| rule | [`no-attribution-footers`](../.agent-src/rules/no-attribution-footers.md) | auto | Generating PR/issue/comment/commit-message bodies — forbids unsolicited 'Generated with', 'Co-authored by', or 'Pull Request opened by' attribution footers in any user-owned artifact |
 | rule | [`no-cheap-questions`](../.agent-src/rules/no-cheap-questions.md) | always | No cheap questions — never ask what context answers, never offer Iron-Law-violating options, never stage no-trade-off choices; mode-independent (off / auto / on) |
 | rule | [`no-roadmap-references`](../.agent-src/rules/no-roadmap-references.md) | auto | Adding a link to a specific file in agents/roadmaps/ from any stable artifact (rule, skill, command, context, guideline) — roadmaps are transient; promote durable findings to agents/contexts/ instead |
 | rule | [`non-destructive-by-default`](../.agent-src/rules/non-destructive-by-default.md) | always | Agent is never destructive — Hard Floor always asks for prod-trunk merges, deploys, pushes, prod data/infra, bulk deletions, and bulk-deletion/infra commits; no autonomy or roadmap bypass |
@@ -201,7 +204,7 @@ are excluded.
 | rule | [`user-interaction`](../.agent-src/rules/user-interaction.md) | auto | Asking the user a question, presenting options, or summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators |
 | rule | [`verify-before-complete`](../.agent-src/rules/verify-before-complete.md) | always | Verify before completion — run tests and quality tools before claiming done |
 
-## Commands (95)
+## Commands (94)
 
 | kind | name | cluster | description |
 |---|---|---|---|
@@ -214,11 +217,10 @@ are excluded.
 | command | [`analyze-reference-repo`](../.agent-src/commands/analyze-reference-repo.md) |  | Analyze an external reference repository (competitor, inspiration, peer) and produce a structured comparison + adoption plan for this project. |
 | command | [`bug-fix`](../.agent-src/commands/bug-fix.md) |  | Plan and implement a bug fix — based on investigation, with quality checks and test verification |
 | command | [`bug-investigate`](../.agent-src/commands/bug-investigate.md) |  | Investigate a bug — auto-detect ticket from branch, gather Jira/Sentry/description context, trace root cause |
-| command | [`chat-history:checkpoint`](../.agent-src/commands/chat-history/checkpoint.md) | cluster: chat-history | Append a phase-boundary entry to .agent-chat-history — CHECKPOINT fallback for platforms without a native hook (Augment IDE, Cursor pre-1.7, Cline non-Mac/Linux). ~1s. |
-| command | [`chat-history:clear`](../.agent-src/commands/chat-history/clear.md) | cluster: chat-history | Manually delete the persistent chat-history log — asks for confirmation, optionally archives to a timestamped backup before wiping |
-| command | [`chat-history:resume`](../.agent-src/commands/chat-history/resume.md) | cluster: chat-history | Load the persistent chat-history log into the current conversation — picks match/returning/foreign flow and supports resume, merge, replace, or continue |
+| command | [`chat-history:import`](../.agent-src/commands/chat-history/import.md) | cluster: chat-history | Surface prior chat-history sessions as numbered options, let the user pick exactly one, then render its entries verbatim into the current chat — selective, user-driven cross-session import |
+| command | [`chat-history:learn`](../.agent-src/commands/chat-history/learn.md) | cluster: chat-history | Pick a prior chat-history session and mine it for project-improving learnings — runs learning-to-rule-or-skill on the picked session, drafts proposal(s) under agents/proposals/ |
 | command | [`chat-history:show`](../.agent-src/commands/chat-history/show.md) | cluster: chat-history | Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and the last few entries |
-| command | [`chat-history`](../.agent-src/commands/chat-history.md) | cluster: chat-history | Chat-history orchestrator — routes to show, resume, clear, checkpoint |
+| command | [`chat-history`](../.agent-src/commands/chat-history.md) | cluster: chat-history | Chat-history orchestrator — routes to show, import, learn |
 | command | [`check-current-md`](../.agent-src/commands/check-current-md.md) |  | Check the open .md file (or a passed path) for German outside DE:/EN: anchor blocks — umlauts, function words, untranslated quotes. Reports and offers fixes. |
 | command | [`commit:in-chunks`](../.agent-src/commands/commit/in-chunks.md) | cluster: commit | Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for autonomous flows |
 | command | [`commit`](../.agent-src/commands/commit.md) | cluster: commit | Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits |

package/docs/contracts/adr-chat-history-split.md

@@ -4,7 +4,16 @@ stability: beta
 
 # ADR — Chat-history rule split
 
-> **Status:** Decided · 2026-05-02
+> **Status:** Superseded · 2026-05-04 · by
+> [`agents/contexts/chat-history-platform-hooks.md`](../../agents/contexts/chat-history-platform-hooks.md).
+> The cooperative three-rule split this ADR locked in
+> (`chat-history-ownership` / `-cadence` / `-visibility`) has been
+> reduced to a hook-only structural artifact. The three always-rules,
+> the heartbeat marker, and the Foreign-Prompt handshake are gone;
+> `session_start` hooks auto-adopt foreign sessions silently. The text
+> below is preserved for historical context only.
+>
+> **Original status:** Decided · 2026-05-02
 > **Context:** AI #1, AI #3, AI #5 review of PR #29 flagged the
 > 200-line monolithic `rules/chat-history.md` as the rule the agent
 > revisited 12+ times during the 1.14.0 cycle — three independent

package/docs/contracts/command-clusters.md

@@ -30,7 +30,7 @@ column 1 of this table.
 | `fix` | 1 | `ci` · `pr` · `pr-bots` · `pr-developers` · `portability` · `refs` · `seeder` | `fix-ci` · `fix-pr-comments` · `fix-pr-bot-comments` · `fix-pr-developer-comments` · `fix-portability` · `fix-references` · `fix-seeder` |
 | `optimize` | 1 | `agents` · `augmentignore` · `rtk` · `skills` | `optimize-agents` · `optimize-augmentignore` · `optimize-rtk-filters` · `optimize-skills` |
 | `feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
-| `chat-history` | 2 | `show` · `resume` · `clear` · `checkpoint` | `chat-history` (legacy status) · `chat-history-resume` · `chat-history-clear` · `chat-history-checkpoint` |
+| `chat-history` | 2 | `show` · `import` · `learn` | `chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only` (auto-adopt + structural hooks); `import` (verbatim cross-session render) and `learn` (project-improving learning extraction) added in the v4 stateless schema |
 | `agents` | 2 | `audit` · `cleanup` · `prepare` | `agents-audit` · `agents-cleanup` · `agents-prepare` |
 | `memory` | 2 | `add` · `load` · `promote` · `propose` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory` |
 | `roadmap` | 2 | `create` · `execute` | `roadmap-create` · `roadmap-execute` |