@event4u/agent-config 1.35.0 → 1.36.1

package/.agent-src/skills/memory-consolidation/SKILL.md

@@ -0,0 +1,216 @@
+---
+name: memory-consolidation
+description: "Use when consolidating session signals into curated memory — four-phase loop ORIENT → GATHER → CONSOLIDATE → PRUNE. Triggers on 'mine my sessions', 'consolidate memory', 'review intake signals'."
+status: active
+tier: senior
+source: package
+domain: engineering
+context_spine: [repo]
+---
+
+# memory-consolidation
+
+## When to use
+
+- Intake JSONL has accumulated unreviewed signals and `/memory:load` shows the inline-review block.
+- A pattern recurred across recent sessions (correction, preference, decision, repeat-bug) and is at risk of being forgotten by the next fresh chat.
+- Before closing out a multi-day implementation, capture project-scoped facts so the next agent does not re-discover them.
+
+Do NOT use for one-off code review notes (those belong in PR comments,
+not memory), for user-attribute facts like name or IDE preference (the
+`onboard` flow owns those), or for transient TODOs (use the task list).
+
+## Cognition cluster
+
+- **Mental model 5 — Signal vs. noise.** A consolidation pass that
+  promotes 30 entries from a 50-message session is noise; the Pareto
+  cut is roughly 3–5 promote-worthy signals per cycle. See
+  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 5.
+- **Mental model 12 — Defense in depth.** Date-discipline, tag
+  intersection, and per-invocation transcript-access confirmation are
+  three independent guards; any one alone fails open. See § 12.
+
+## Procedure
+
+The loop is four sequential phases. Each phase has one exit gate; do
+not advance until the gate is green.
+
+### Phase 1 — ORIENT (review scope and assess adapter)
+
+1. Confirm scope: which project, which time window, which transcript
+   source. Default window: last 14 days. The agent must read the
+   user's last chat message for an explicit `--since` override before
+   defaulting.
+2. Inspect the current curated state: list files under
+   `agents/memory/` and check the most recent `last_validated`
+   timestamps. Identify which schemas are stale before mining adds
+   noise.
+3. Review the **repo** slot of the [context-spine](../../../docs/contracts/context-spine.md)
+   for project boundaries (modules, owners, sensitive paths). If empty,
+   note the gap in the consolidation report; do not invent.
+4. Resolve the `TranscriptAdapter` for the current host (see Adapter
+   contract below). If no adapter matches, stop and route the user to
+   `/memory:propose` for manual signal entry. Do **not** synthesize.
+
+**Exit gate:** scope, window, adapter all named. If any one is
+missing, stop.
+
+### Phase 2 — GATHER SIGNAL
+
+1. Stream transcript turns through the four signal regex families:
+   - **Correction:** `actually|wrong|stop doing|don't do|that's not what|nicht so`.
+   - **Preference:** `prefer|always|never|standard|i want|ich will`.
+   - **Decision:** `let's go with|decided|we'll use|entschieden`.
+   - **Pattern (recurring):** the same file path or symbol appears in
+     ≥ 3 turns within 24 hours.
+2. For each match, extract a **normalised fact** — strip personal
+   pronouns, IDE chrome, timestamps, and turn-id. The fact must be
+   project-scoped (refers to a file, module, command, or invariant)
+   not user-scoped (refers to *me*, *Matze*, *my IDE*).
+3. Drop user-attribute matches. If the fact cannot survive the
+   normalisation, discard it. The miner is a strict gate.
+
+**Exit gate:** ≤ 5 normalised facts per cycle. More than 5 means the
+miner is too loose; tighten patterns and re-run before promoting.
+
+### Phase 3 — CONSOLIDATE
+
+1. Tag each fact via the schema-routing table:
+
+   | Tag | Schema |
+   |---|---|
+   | `convention` | `agents/memory/conventions.yml` |
+   | `invariant` | `agents/memory/domain-invariants.yml` |
+   | `gotcha` | `agents/memory/operational-gotchas.yml` |
+   | `pattern` | `agents/memory/recurring-patterns.yml` |
+
+   A fact may carry **two** tags; the promoter resolves via tag
+   intersection, not by file extension. See
+   [`docs/contracts/agent-memory-contract.md`](../../../docs/contracts/agent-memory-contract.md)
+   for the curated YAML schemas.
+
+2. Append each fact as one JSONL line to
+   `agents/memory/intake/<primary-tag>.jsonl` with required fields
+   per the contract: `ts`, `type`, `key`, `observation`, `source:
+   agent`, `session_id`, plus the new optional `tags: [<one>, <two>]`.
+3. Default to `--preview` mode: render the JSONL block to stdout and
+   stop. Only `--commit-intake` writes the file.
+
+**Exit gate:** every fact carries ≥ 1 tag and a JSONL-shape that
+validates against the contract.
+
+### Phase 4 — PRUNE & INDEX
+
+1. After promotion (handled by `/memory:promote`, not this skill),
+   archive the consumed JSONL lines into
+   `agents/memory/intake/.archive/YYYY-Www.jsonl` — week-bucketed,
+   not day-bucketed (defeats session-context inference attacks).
+2. If a curated entry's `last_validated` field is older than 90 days
+   AND no signal in the last 30 days touched its `key`, mark it
+   stale in the consolidation report — but do **not** auto-delete.
+   Pruning is a human-confirmed action.
+
+**Exit gate:** report cites ≥ 0 promotions, ≥ 0 stale flags, 0
+auto-deletes.
+
+## TranscriptAdapter contract
+
+The miner is host-agnostic by design. A `TranscriptAdapter` for host
+`X` ships:
+
+- **Discover:** function returning the absolute path(s) of session
+  transcripts for the active project, scoped to the `--since` window.
+  Phase 1 ships the Claude-Code adapter only; absent adapter →
+  `not-supported-on-this-host`.
+- **Iterate:** generator yielding turn objects with `{role, ts,
+  text}`. Adapter strips IDE chrome and tool-call boilerplate before
+  yielding.
+- **Redact:** function applied to every yielded text — drops user
+  names, file paths outside the repo root, and any personal
+  identifier the consumer project lists in
+  `.agent-settings.yml` under `memory.redact_patterns`.
+
+Phase 1 implementation lives in
+`/memory:mine-session` (single host: Claude Code,
+`~/.claude/projects/*/sessions/*.jsonl`). Phase 3 of the
+adoption roadmap adds a second host adapter; the contract above is
+documented now so the second implementation is not a vacuum design.
+
+## Related Skills
+
+**WHEN to use this**
+
+- Intake JSONL has > 10 unreviewed signals.
+- A correction / preference recurred across ≥ 3 sessions.
+- Closing out a multi-day implementation.
+
+**WHEN NOT to use this**
+
+- One-off PR review notes — comment on the PR.
+- User-attribute facts (name, IDE) — those belong to the
+  [`onboard`](../../commands/onboard.md) flow, not curated memory.
+- Transient TODOs — use the task-list tools.
+- A single bug fix that does not generalise — fix the bug, do not
+  memorise it.
+
+## When the agent should load this
+
+- "Mine my recent sessions for memory signals."
+- "Consolidate the intake stream into curated entries."
+- "What did we decide about X across the last week?"
+- "Review unreviewed memory signals before I switch projects."
+- "Run a memory consolidation cycle."
+
+## Output
+
+1. **Consolidation report** — Markdown block printed to stdout: scope
+   (project, window, host), signal counts per class, list of
+   normalised facts with tag and target schema, stale-flag list. No
+   side effects in `--preview` mode.
+2. **Intake JSONL appendix** — only with `--commit-intake`: appended
+   lines to `agents/memory/intake/<tag>.jsonl`. Lines validate
+   against the contract.
+3. **Archive bucket** — only after `/memory:promote` runs and lifts
+   the lines into curated YAML: appends to
+   `agents/memory/intake/.archive/YYYY-Www.jsonl`. Week-bucketed.
+
+## Gotcha
+
+- Mining without `--confirm-transcript-access` reads zero turns and
+  prints an opt-in hint. The flag is per-invocation, not persistent.
+- The miner is a strict gate. > 5 normalised facts per cycle means
+  the regex set is too loose, not that the session was rich.
+- A fact tagged `gotcha + invariant` lands in the `gotcha` JSONL
+  (primary tag); the promoter reads tag intersection to decide the
+  curated YAML target.
+- Date-discipline: the `check_memory.py` linter rejects
+  `yesterday|today|tomorrow|last/next/this week|month|year` in curated
+  YAML without an `YYYY-MM-DD` anchor within ±20 chars. Re-anchor
+  before commit.
+
+## Do NOT
+
+- Do NOT auto-trigger this skill on session end. The flow is manual,
+  per-invocation, and confirmed.
+- Do NOT vendor patterns or text from `grandamenium/dream-skill` —
+  the upstream lacks a `LICENSE`. Concept and procedure structure are
+  the only adoption surface.
+- Do NOT promote a normalised fact whose `key` falls outside the
+  repo root or names another consumer project.
+- Do NOT delete a stale curated entry without explicit user
+  confirmation. Stale-flag is the most this skill emits.
+
+## Runnable example
+
+After a 4-day refactor of `app/Services/PaymentGateway`, run a
+consolidation cycle:
+
+- `/memory:mine-session --since 2026-05-06 --confirm-transcript-access --preview`.
+- Miner surfaces 4 facts: 1 correction (`PaymentGateway::charge` must
+  not throw on idempotency replays — `convention`), 1 decision
+  (`Stripe webhook signing key lives in `config/services.php` only —
+  `gotcha`), 2 patterns (`PaymentGatewayTest` flakes when seeded data
+  carries timestamps in microseconds — `pattern + gotcha`).
+- Report cites 0 stale flags. Re-run with `--commit-intake` after
+  spot-checking the 4 facts.
+- Hand off to `/memory:promote` for the curated-YAML write.

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

@@ -43,15 +43,20 @@ Templates for roadmap files stored in `agents/roadmaps/` or `app/Modules/{Module
     or budget-invariant changes; multi-round council, file-ownership
     matrices, > 600 lines. Enforced by `task lint-roadmap-complexity`.
     Standard: [`docs/contracts/roadmap-complexity-standard.md`](../docs/contracts/roadmap-complexity-standard.md).
-16. **No time-boxed plates, no visible-horizon sections.** Roadmaps describe
-    scope and phase ordering, not week-by-week commitments. No
-    `## Horizon (N-week visible plate)` sections, "Inside / outside the
-    plate" framings, `In-plate?` columns, or `**Out-of-plate.**` /
-    `**Out-of-horizon.**` / `(out-of-horizon, gated on Phase N)` suffixes.
-    AI execution does not operate on calendar plates; scope ordering and
-    dependency gates suffice. Pacing is the user's call, decided per turn
-    — never encoded into the plan. Enforced by `task lint-roadmap-complexity`
-    (plate-token detection).
+16. **Time-boxed plates / visible-horizon sections — opt-in via
+    `roadmap.horizon_weeks` in `.agent-settings.yml`.** Default is `0`
+    (off): roadmaps describe scope and phase ordering, not week-by-week
+    commitments. With the default, do **not** add `## Horizon (N-week
+    visible plate)` sections, "Inside / outside the plate" framings,
+    `In-plate?` columns in decision tables, or `**Out-of-plate.**` /
+    `**Out-of-horizon.**` / `(out-of-horizon, gated on Phase N)`
+    suffixes on steps or phase headers. AI execution does not operate
+    on calendar plates by default; scope ordering and dependency gates
+    are sufficient. Pacing is the user's call, decided per turn —
+    never encoded into the plan unless they have explicitly set
+    `horizon_weeks` to a positive integer. Enforced by
+    `task lint-roadmap-complexity` (plate-token detection skipped when
+    `horizon_weeks > 0`).
 
 ---
 

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.35.0"
+    "version": "1.36.1"
   },
   "plugins": [
     {
@@ -160,7 +160,9 @@
         "./.claude/skills/md-language-check",
         "./.claude/skills/memory",
         "./.claude/skills/memory-add",
+        "./.claude/skills/memory-consolidation",
         "./.claude/skills/memory-load",
+        "./.claude/skills/memory-mine-session",
         "./.claude/skills/memory-promote",
         "./.claude/skills/memory-propose",
         "./.claude/skills/merge-conflicts",

package/CHANGELOG.md

@@ -318,6 +318,48 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [1.36.1](https://github.com/event4u-app/agent-config/compare/1.36.0...1.36.1) (2026-05-10)
+
+### Refactoring
+
+* **scope-control:** extract roadmap-shape, kernel-rule-edits, fenced-step detail to scope-mechanics ([e52c834](https://github.com/event4u-app/agent-config/commit/e52c834a672e6f24b1b7c1608e481b7f45a46054))
+
+### Chores
+
+* **generate-tools:** regenerate .windsurfrules for scope-control extraction ([ee7664e](https://github.com/event4u-app/agent-config/commit/ee7664ee6cd0ec5aacdf95b5e4ec1000e01a0121))
+
+Tests: 2621 (+0 since 1.36.0)
+
+## [1.36.0](https://github.com/event4u-app/agent-config/compare/1.35.0...1.36.0) (2026-05-10)
+
+### Features
+
+* **commands:** tier-0 surfacing on /memory:load and ts_week on /memory:promote ([85f4b63](https://github.com/event4u-app/agent-config/commit/85f4b63dc792488ba60af4da2b09d4fcaa58506c))
+* **memory:** add priority enum validator and tier-0 stale checks ([5d61328](https://github.com/event4u-app/agent-config/commit/5d61328fa1bc1ac38d9acb98a9f97d2dc0dab4a7))
+* **memory:** consolidation skill + /memory:mine-session + intake review hook ([7037a45](https://github.com/event4u-app/agent-config/commit/7037a45b2e63193a3289622784093f522c578158))
+
+### Bug Fixes
+
+* **check-refs:** skip agents/council-responses/ like council-sessions/ ([d18551e](https://github.com/event4u-app/agent-config/commit/d18551e896d747533f2aa4465b390b291c931c4a))
+* **check-refs:** skip agents/council-responses/ like council-sessions/ ([4faf5f8](https://github.com/event4u-app/agent-config/commit/4faf5f82c380222281b38213c38399187757840b))
+* **scope-control:** trim authoring section to fit kernel ceiling ([b436d0a](https://github.com/event4u-app/agent-config/commit/b436d0a8840b0498688ed9efe28eb76bbfc08a5a))
+* **roadmap:** suppress council-reference lint on dream-skill roadmap ([c355ca5](https://github.com/event4u-app/agent-config/commit/c355ca5d8b4e7e5f181f31efe057e2c0d5ff63eb))
+
+### Documentation
+
+* **roadmap:** close out dream-skill adoption — Phase 3 cancelled-deferred, archive ([63bedd0](https://github.com/event4u-app/agent-config/commit/63bedd02c7686e183acadebff742423ab0c258a6))
+* **roadmap:** mark Phase 2 partial shipped, B1 + Phase 3 deferred with rationale ([620d7f0](https://github.com/event4u-app/agent-config/commit/620d7f09372b866659f0a41f1690fdab904777bb))
+* **memory:** document priority enum and ts_week jitter convention ([f9f65d4](https://github.com/event4u-app/agent-config/commit/f9f65d4d9d699d7b65c496745e440f3fa7de1c54))
+
+### Chores
+
+* **roadmap:** mark Phase 1 of dream-skill adoption complete ([b46ce4c](https://github.com/event4u-app/agent-config/commit/b46ce4ca7737fd9f4d29692837680023d3fbf68d))
+* **meta:** regenerate ownership matrix after scope-control trim ([db14110](https://github.com/event4u-app/agent-config/commit/db14110b0aebf9acc178cd997d1e11d0d91fd382))
+* **meta:** regenerate ownership matrix ([a23604e](https://github.com/event4u-app/agent-config/commit/a23604ef031daf0ec5e9dfdce30baf3c0293340d))
+* **rules:** harden against unsolicited implementation + horizon opt-in ([00b5fa9](https://github.com/event4u-app/agent-config/commit/00b5fa96b93b41943559c4dac775069a2e14b0e3))
+
+Tests: 2621 (+15 since 1.35.0)
+
 ## [1.35.0](https://github.com/event4u-app/agent-config/compare/1.34.0...1.35.0) (2026-05-10)
 
 ### 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>173 Skills</strong> · <strong>60 Rules</strong> · <strong>103 Commands</strong> · <strong>69 Guidelines</strong> · <strong>8 AI Tools</strong>
+  <strong>174 Skills</strong> · <strong>60 Rules</strong> · <strong>104 Commands</strong> · <strong>69 Guidelines</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
@@ -343,7 +343,7 @@ kernel set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-member
 | [`/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 103 active commands](.agent-src/commands/)
+→ [Browse all 104 active commands](.agent-src/commands/)
 
 ---
 
@@ -368,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 + 173 skills + 103 native commands). Cursor, Cline, Windsurf,
+> package (rules + 174 skills + 104 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

@@ -164,6 +164,22 @@ roadmap:
   # is mandatory before any "roadmap complete" claim regardless of cadence.
   quality_cadence: end_of_roadmap
 
+  # Visible-horizon framing in roadmap authoring (integer weeks, default 0).
+  # 0  = off (default). Time-boxed plate / horizon framing is forbidden:
+  #      no `## Horizon (N-week visible plate)` sections, no
+  #      "inside / outside the plate" phrasing, no `out-of-horizon` /
+  #      `out-of-plate` suffixes. Phase ordering and dependency gates
+  #      carry the deferral semantics. Enforced by
+  #      `task lint-roadmap-complexity`.
+  # > 0 = opt-in. Roadmaps may include a `## Horizon (N-week visible plate)`
+  #      section with that many weeks; the linter relaxes the plate-token
+  #      ban for files declaring the section. Pacing is still the user's
+  #      call — N is just the authoring window.
+  # 6 weeks proved too long for AI-paced work; the default is 0 so plans
+  # describe scope and ordering, not calendars. Flip to a positive integer
+  # only if your team genuinely commits work on a calendar plate.
+  horizon_weeks: 0
+
 # --- Subagent orchestration ---
 #
 # Controls model selection and parallelism for subagent-based workflows
@@ -320,3 +336,22 @@ commands:
   # /create-pr:description-only always previews — that is its sole purpose.
   create_pr:
     preview_description: false
+
+# --- Memory ---
+#
+# Engineering memory consolidation behaviour. See
+# docs/contracts/agent-memory-contract.md for the on-disk shape and
+# .augment/skills/memory-consolidation/ for the four-phase loop.
+memory:
+  # Inline-review threshold for /memory load.
+  # When the unreviewed intake stream contains more than this many
+  # entries, /memory load surfaces a top-3 preview block before the
+  # full curated load. Set to 0 to disable the inline review entirely.
+  review_threshold: 10
+
+  # Patterns redacted from transcripts before mining.
+  # The TranscriptAdapter applies these as a regex blocklist on every
+  # yielded turn. Add personal identifiers, project-internal tokens,
+  # or paths outside the repo root that must not land in intake JSONL.
+  # Example: ["api[_-]?key", "/Users/[a-z]+/Library"]
+  redact_patterns: []

package/docs/architecture.md

@@ -96,9 +96,9 @@ fails on any source-side violation, without producing artifacts.
 
 | Layer | Count | Purpose |
 |---|---|---|
-| **Skills** | 173 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
+| **Skills** | 174 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
 | **Rules** | 60 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
-| **Commands** | 103 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
+| **Commands** | 104 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
 | **Guidelines** | 69 | 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 **398 public artefacts** shipped by
+Consumer-facing catalog of all **404 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 (169)
+## Skills (174)
 
 | kind | name | extra | description |
 |---|---|---|---|
@@ -35,6 +35,7 @@ are excluded.
 | skill | [`code-review`](../.agent-src/skills/code-review/SKILL.md) |  | Use when the user says "review this", "check my code", or wants feedback on changes. Reviews for correctness, quality, security, and coding standards. |
 | skill | [`command-routing`](../.agent-src/skills/command-routing/SKILL.md) |  | Use when the user invokes a slash command like /create-pr, /commit, /fix-ci, or pastes command file content — routes to the right command with context inference and GitHub API patterns. |
 | skill | [`command-writing`](../.agent-src/skills/command-writing/SKILL.md) |  | Use when creating or editing a slash command in .agent-src.uncompressed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'. |
+| skill | [`competitive-positioning`](../.agent-src/skills/competitive-positioning/SKILL.md) |  | Use when comparing this package to a peer / competitor — ours-vs-theirs verdict table, axis selection, adoption queue. Triggers on 'how do we compare to X', 'should we adopt their pattern'. |
 | skill | [`composer-packages`](../.agent-src/skills/composer-packages/SKILL.md) |  | Use when building or maintaining a Composer library — versioning, Laravel integration, autoloading, publishing to private registries — even when the user says 'release a new version'. |
 | skill | [`context-authoring`](../.agent-src/skills/context-authoring/SKILL.md) |  | Use when filling in knowledge-layer context files — auth-model, tenant-boundaries, data-sensitivity, deployment-order, observability — interactive walkthrough that turns templates into reviewer fuel. |
 | skill | [`context-document`](../.agent-src/skills/context-document/SKILL.md) |  | Use when the user says "create context", "document this area", or wants a structured snapshot of a codebase area for agent orientation. |
@@ -54,6 +55,7 @@ are excluded.
 | 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. |
 | skill | [`devcontainer`](../.agent-src/skills/devcontainer/SKILL.md) |  | Use when configuring DevContainers or GitHub Codespaces — devcontainer.json, custom images, secrets, VS Code features — even when the user just says 'why does my Codespace not start'. |
 | skill | [`developer-like-execution`](../.agent-src/skills/developer-like-execution/SKILL.md) |  | Use when implementing, debugging, refactoring, or reviewing code — enforces the think → analyze → verify → execute workflow — even when the user just says 'implement X' without naming it. |
+| skill | [`discovery-interview`](../.agent-src/skills/discovery-interview/SKILL.md) |  | Use when running discovery interviews — question-bank build, bias audit, insight extraction. Triggers on 'audit my guide', 'extract insights from transcript', 'is my hypothesis falsifiable'. |
 | skill | [`docker`](../.agent-src/skills/docker/SKILL.md) |  | Use when working with Docker — Dockerfile edits, docker-compose services, containers, or the dual-container (fast + Xdebug) setup — even when the user just says 'my container won't start'. |
 | skill | [`dto-creator`](../.agent-src/skills/dto-creator/SKILL.md) |  | Use when the user says "create a DTO", "new data transfer object", or needs to convert request/response data into a typed PHP class. Creates DTOs with SimpleDto base class and attribute mapping. |
 | skill | [`eloquent`](../.agent-src/skills/eloquent/SKILL.md) |  | Use when writing Eloquent models, relationships, scopes, or queries via Model:: — 'fetch users with their orders'. NOT for PHPStan output, non-Eloquent services, or raw SQL questions. |
@@ -88,6 +90,7 @@ are excluded.
 | skill | [`laravel-reverb`](../.agent-src/skills/laravel-reverb/SKILL.md) |  | Use when configuring Laravel Reverb — the first-party WebSocket server with Pusher protocol compatibility, horizontal scaling, and Pulse monitoring. |
 | skill | [`laravel-scheduling`](../.agent-src/skills/laravel-scheduling/SKILL.md) |  | Use when configuring Laravel task scheduling — cron expressions, frequency helpers, overlap prevention, maintenance mode, or output handling. |
 | skill | [`laravel-validation`](../.agent-src/skills/laravel-validation/SKILL.md) |  | Use when writing validation — Form Requests, rules, custom rule objects, request-boundary design — even when the user just says 'validate this input' or 'check the request' without naming it. |
+| skill | [`launch-readiness`](../.agent-src/skills/launch-readiness/SKILL.md) |  | Use before merging a release-shaped PR — pre-merge checklist, rollout plan, rollback criteria, ops handoff. Triggers on 'ready to ship', 'launch checklist', 'rollout plan for X'. |
 | skill | [`learning-to-rule-or-skill`](../.agent-src/skills/learning-to-rule-or-skill/SKILL.md) |  | Use when a repeated learning, mistake, or successful pattern should be turned into a new rule or skill. Also use after completing a task to capture learnings from the work. |
 | skill | [`lint-skills`](../.agent-src/skills/lint-skills/SKILL.md) |  | Use when running the package's skill linter against all skills and rules to validate frontmatter, required sections, and execution metadata. |
 | skill | [`livewire`](../.agent-src/skills/livewire/SKILL.md) |  | Use when the project's frontend stack is Livewire — dispatched by `directives/ui/{apply,review,polish}.py`. Covers reactive state, events, lifecycle hooks, and component/view separation. |
@@ -97,6 +100,7 @@ are excluded.
 | skill | [`mcp`](../.agent-src/skills/mcp/SKILL.md) |  | Use when working with MCP (Model Context Protocol) servers — their tools, capabilities, and best practices for effective agent workflows. |
 | skill | [`mcp-builder`](../.agent-src/skills/mcp-builder/SKILL.md) |  | Use when building an MCP server in Python (FastMCP) or Node/TypeScript (MCP SDK) — agent-centric tool design, input schemas, error handling, and the 10-question evaluation harness. |
 | skill | [`md-language-check`](../.agent-src/skills/md-language-check/SKILL.md) |  | Use BEFORE saving any .md under .augment/, .agent-src*/, or agents/ — scans umlauts, German function words, and quoted German phrases outside DE:/EN: anchor blocks. Hard gate per language-and-tone. |
+| skill | [`memory-consolidation`](../.agent-src/skills/memory-consolidation/SKILL.md) |  | Use when consolidating session signals into curated memory — four-phase loop ORIENT → GATHER → CONSOLIDATE → PRUNE. Triggers on 'mine my sessions', 'consolidate memory', 'review intake signals'. |
 | skill | [`merge-conflicts`](../.agent-src/skills/merge-conflicts/SKILL.md) |  | Use when the user has merge conflicts or says "resolve conflicts". Understands conflict markers, resolution strategies, and verification workflow. |
 | skill | [`migration-architect`](../.agent-src/skills/migration-architect/SKILL.md) |  | Use when shaping a non-trivial migration — rollout phases, dual-write windows, cutover sequencing, deprecation cycles — hands off to `migration-creator` for DDL once locked. |
 | 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. |
@@ -179,6 +183,7 @@ are excluded.
 | 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'. |
 | skill | [`validate-feature-fit`](../.agent-src/skills/validate-feature-fit/SKILL.md) |  | Validate whether a feature request fits the existing codebase — check for duplicates, contradictions, scope creep, and architectural misfit |
 | 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 | [`voc-extract`](../.agent-src/skills/voc-extract/SKILL.md) |  | Use when extracting Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns. Triggers on 'what are users saying', 'recurring complaints', 'top themes'. |
 | 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 (57)
@@ -243,7 +248,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 (103)
+## Commands (104)
 
 | kind | name | cluster | description |
 |---|---|---|---|
@@ -304,9 +309,10 @@ are excluded.
 | command | [`judge`](../.agent-src/commands/judge.md) | cluster: judge | Judge orchestrator — routes to solo, steps, on-diff |
 | command | [`memory:add`](../.agent-src/commands/memory/add.md) | cluster: memory | Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules) |
 | command | [`memory:load`](../.agent-src/commands/memory/load.md) | cluster: memory | Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered |
+| command | [`memory:mine-session`](../.agent-src/commands/memory/mine-session.md) | cluster: memory | Mine the active session transcript for memory signals (corrections, preferences, decisions, recurring patterns) — preview-by-default, opt-in transcript access, host-agnostic via TranscriptAdapter. |
 | command | [`memory:promote`](../.agent-src/commands/memory/promote.md) | cluster: memory | Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate. |
 | command | [`memory:propose`](../.agent-src/commands/memory/propose.md) | cluster: memory | Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or agent) to record a finding without committing to a curated entry. |
-| command | [`memory`](../.agent-src/commands/memory.md) | cluster: memory | Memory orchestrator — routes to add, load, promote, propose |
+| command | [`memory`](../.agent-src/commands/memory.md) | cluster: memory | Memory orchestrator — routes to add, load, mine-session, promote, propose |
 | command | [`mode`](../.agent-src/commands/mode.md) |  | Set the active role mode — prints the contract, lists default skills, and refuses work outside the contract (see role-contracts) |
 | command | [`module:create`](../.agent-src/commands/module/create.md) | cluster: module | Create a new module from .module-template with interactive setup |
 | command | [`module:explore`](../.agent-src/commands/module/explore.md) | cluster: module | Explore a module — load its structure, docs, and context into the current conversation |

package/docs/contracts/agent-memory-contract.md

@@ -122,10 +122,24 @@ command: JSONL append-only drop-ins under
 is present, the same payload is accepted by a `propose()` CLI or MCP
 call. File-drop is the always-works path.
 
-Required fields (keep in sync with `/propose-memory` command):
+**Required fields** (keep in sync with `/propose-memory` command):
 `ts`, `type`, `key` (path or logical id), `observation`, `source`
 (`agent` or `human`), `session_id`.
 
+**Optional fields:**
+
+- `tags: string[]` — zero or more schema-routing labels from the
+  controlled vocabulary `{convention, invariant, gotcha, pattern}`.
+  Default `[]`. Producers (`/memory propose`, `/memory mine-session`)
+  emit tags; consumers (`/memory promote`) read **tag intersection**
+  to pick the curated YAML target when a signal carries two tags
+  (e.g. `[gotcha, invariant]` → primary `gotcha` JSONL, promote target
+  resolved by the reviewer at promotion time). See
+  [`memory-consolidation`](../../.agent-src.uncompressed/skills/memory-consolidation/SKILL.md)
+  § Phase 3 for the schema-routing table.
+- `confidence: low | medium | high` — producer-supplied estimate; the
+  inline-review hook in `/memory load` ranks the top-3 by this field.
+
 ## Revisit triggers
 
 Q29 is **parked open**, not a blocker. Revisit when **one** of these

package/docs/contracts/command-clusters.md

@@ -32,7 +32,7 @@ column 1 of this table.
 | `feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
 | `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 | `init` · `optimize` · `audit` | AGENTS.md file family (high-frequency) — repurposed 2026-05-09: `init` (was `/copilot-agents init`) · `optimize` (merger of `/optimize agents-md` + `/copilot-agents optimize`) · `audit` (was `/optimize agents`, collapses old `audit` + `check` verbs); legacy folder ops (`prepare` / `cleanup` / folder-`audit`) moved to `/optimize agents-dir` |
-| `memory` | 2 | `add` · `load` · `promote` · `propose` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory` |
+| `memory` | 2 | `add` · `load` · `promote` · `propose` · `mine-session` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory`; `mine-session` added 2026-05-10 — manual transcript-mining sub-command from `road-to-dream-skill-adoption.md`, opt-in via `--confirm-transcript-access` per invocation |
 | `roadmap` | 2 | `create` · `ai-council` · `process-step` · `process-phase` · `process-full` | `roadmap-create` · `roadmap-execute` (replaced — autonomous, no per-step gate; `process-phase` is the default execution scope); `ai-council` added 2026-05-07 — wraps `/council default` with `--input-mode roadmap --depth deep` |
 | `module` | 2 | `create` · `explore` | `module-create` · `module-explore` |
 | `tests` | 2 | `create` · `execute` | `tests-create` · `tests-execute` |