@event4u/agent-config 7.5.0 → 8.0.0

package/dist/agent-src/skills/html-deck/evals/triggers.json

@@ -0,0 +1,17 @@
+{
+  "skill": "html-deck",
+  "last_eval": "2026-07-06",
+  "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers deck/slides/presentation/pitch builds in HTML. Should-not-trigger covers near-miss neighbors: canvas-design (posters/static art), fe-design (responsive UI), design-variations (options), PowerPoint-file requests, and content-only outline asks.",
+  "queries": [
+    {"q": "make a 10-slide deck for the investor pitch", "trigger": true},
+    {"q": "build a presentation from this PRD for the engineering all-hands", "trigger": true},
+    {"q": "turn these notes into HTML slides I can present tomorrow", "trigger": true},
+    {"q": "create a pitch deck with our brand colors, 16:9", "trigger": true},
+    {"q": "I need a slide presentation that also prints to PDF", "trigger": true},
+    {"q": "design a poster for the conference booth", "trigger": false, "note": "static one-frame art → canvas-design"},
+    {"q": "build the landing page hero section", "trigger": false, "note": "responsive UI → fe-design / stack executor"},
+    {"q": "show me 3 design options for this dashboard", "trigger": false, "note": "options → design-variations"},
+    {"q": "write an outline for my talk", "trigger": false, "note": "content-only ask, no HTML deliverable"},
+    {"q": "export our Google Slides to PowerPoint", "trigger": false, "note": "file conversion, not an HTML deck build"}
+  ]
+}

package/dist/agent-src/skills/html-deck/templates/deck-shell.html

@@ -0,0 +1,77 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Deck</title>
+<style>
+  /* Deck shell — fixed-canvas slides (default 1920×1080) letterboxed to any
+     viewport. Slides are direct children <section> of <main class="deck">. */
+  :root { --deck-w: 1920; --deck-h: 1080; }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body { height: 100%; background: #111; overflow: hidden; }
+  .deck { position: absolute; top: 50%; left: 50%; width: calc(var(--deck-w) * 1px); height: calc(var(--deck-h) * 1px); transform-origin: center center; }
+  .deck > section { position: absolute; inset: 0; display: none; overflow: hidden; background: #fafafa; color: #1a1a1a; }
+  .deck > section.active { display: block; }
+  .deck-counter { position: fixed; right: 16px; bottom: 12px; font: 14px/1 monospace; color: #888; z-index: 10; }
+  @media print {
+    html, body { height: auto; overflow: visible; background: none; }
+    .deck { position: static; transform: none !important; width: auto; height: auto; }
+    .deck > section { position: relative; display: block; width: calc(var(--deck-w) * 1px); height: calc(var(--deck-h) * 1px); page-break-after: always; }
+    .deck-counter { display: none; }
+  }
+</style>
+</head>
+<body>
+<main class="deck">
+  <!-- Each slide: <section data-screen-label="01 Title">…</section> (1-indexed
+       labels match the counter the viewer sees). Replace the samples. -->
+  <section data-screen-label="01 Title">
+    <h1 style="font-size:96px;padding:120px">Deck title</h1>
+  </section>
+  <section data-screen-label="02 Content">
+    <h2 style="font-size:64px;padding:120px 120px 40px">Section</h2>
+    <p style="font-size:32px;padding:0 120px">Body text on a 1080p canvas stays at 24px minimum; 32px preferred.</p>
+  </section>
+</main>
+<div class="deck-counter" aria-hidden="true"></div>
+<script>
+(() => {
+  const deck = document.querySelector(".deck");
+  const slides = Array.from(deck.querySelectorAll(":scope > section"));
+  const counter = document.querySelector(".deck-counter");
+  const KEY = "deck-slide:" + location.pathname;
+  let i = Math.min(parseInt(localStorage.getItem(KEY) || "0", 10) || 0, slides.length - 1);
+
+  function show(n) {
+    i = Math.max(0, Math.min(n, slides.length - 1));
+    slides.forEach((s, k) => s.classList.toggle("active", k === i));
+    counter.textContent = (i + 1) + " / " + slides.length;
+    localStorage.setItem(KEY, String(i));
+  }
+
+  function fit() {
+    const w = parseFloat(getComputedStyle(document.documentElement).getPropertyValue("--deck-w"));
+    const h = parseFloat(getComputedStyle(document.documentElement).getPropertyValue("--deck-h"));
+    const scale = Math.min(innerWidth / w, innerHeight / h);
+    deck.style.transform = "translate(-50%, -50%) scale(" + scale + ")";
+  }
+
+  addEventListener("keydown", (e) => {
+    if (e.key === "ArrowRight" || e.key === "PageDown" || e.key === " ") show(i + 1);
+    else if (e.key === "ArrowLeft" || e.key === "PageUp") show(i - 1);
+    else if (e.key === "Home") show(0);
+    else if (e.key === "End") show(slides.length - 1);
+  });
+  // Tap/click navigation: right two-thirds advances, left third goes back.
+  addEventListener("click", (e) => {
+    if (e.target.closest("a, button, input, textarea, select, [contenteditable]")) return;
+    show(e.clientX < innerWidth / 3 ? i - 1 : i + 1);
+  });
+  addEventListener("resize", fit);
+  fit();
+  show(i);
+})();
+</script>
+</body>
+</html>

package/dist/agent-src/skills/judge-code-quality/SKILL.md

@@ -3,6 +3,7 @@ model_tier: high
 name: judge-code-quality
 description: "Use when a diff needs a readability review — naming, single-responsibility, DRY, dead code, mismatch with codebase conventions — dispatched by /review-changes, /do-and-judge, /judge."
 domain: quality
+parallelizable: files
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/skills/laravel/SKILL.md

@@ -1,7 +1,6 @@
 ---
 model_tier: medium
 name: laravel
-source: package
 description: "Writes Laravel PHP — Eloquent, Artisan controllers, FormRequests, jobs, events, policies, providers. For Symfony / Doctrine use `symfony-workflow`. For framework-free PHP use `php-coder`."
 domain: engineering
 workspaces:

package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md

@@ -233,6 +233,26 @@ before handing to `upstream-contribute`. The
 gate is hard: non-zero exit = the proposal does not move
 to stage `gated`.
 
+### 9. Degrade the source to a pointer (when promoted from a knowledge page)
+
+If the learning came from an `agents/knowledge/procedures/skill-candidates.md`
+entry or any other `agents/knowledge/` page (see § "Knowledge-candidate
+learnings" below), promotion is **not complete** until the source is
+degraded to a pointer — this prevents double-maintenance between the
+knowledge page and the new artifact:
+
+```bash
+./scripts-run src/scripts/degrade_to_pointer \
+    --source "agents/knowledge/procedures/skill-candidates.md#<topic>" \
+    --artifact "<promoted-artifact-path>" \
+    --date "<YYYY-MM-DD>"
+```
+
+This rewrites the source entry to `Promoted to <artifact> on <date>; see
+<path>.` and regenerates `agents/knowledge/INDEX.md`. Skip when the
+learning's source was NOT a knowledge page (direct user request,
+audit-log pattern, one-off observation).
+
 ## Output format
 
 For the **decision step** (what this skill prints to the user):
@@ -332,6 +352,32 @@ mining `agents/runtime/state/audit/<YYYY-MM>.jsonl`
    and link the mining-script run id, so the human reviewer can
    reproduce the pattern from the raw audit log.
 
+## Knowledge-candidate learnings (optional source)
+
+When the input is an entry from `agents/knowledge/procedures/skill-candidates.md`
+that reached candidate status (≥ 3 mentions across distinct sessions —
+see `update_skill_candidates.ts` and the
+[`memory-consolidation`](../memory-consolidation/SKILL.md) recurrence
+step):
+
+1. Treat the candidate's topic as the **State the learning** step
+   input (§1). The repetition gate (§0) is already satisfied by the
+   ≥ 3-mention threshold — skip straight to §3 (decide the target).
+   Overlap check (§4) and proposal draft (§8) remain mandatory.
+2. **Ground the draft in the original session logs, never the
+   consolidated summary alone.** The candidate entry's `Sessions:`
+   list names the chat-history session ids the topic recurred in —
+   pull those via [`/chat-history import`](../../../commands/chat-history/import.md)
+   (select by id) or the host's native transcript view before
+   drafting. A skill written purely from the recurrence-counter
+   summary tends to be plausible but wrong; the original transcripts
+   carry the detail the summary dropped.
+3. Set `source_learning` to the knowledge-candidate entry
+   (`agents/knowledge/procedures/skill-candidates.md#<topic>`).
+4. **§9 (degrade the source) is mandatory for this source type** —
+   the whole point of the candidate counter is that it stops counting
+   once promoted.
+
 ## Environment notes
 
 Prefer updating existing rule/skill when possible.

package/dist/agent-src/skills/lint-skills/SKILL.md

@@ -9,8 +9,8 @@ execution:
   timeout_seconds: 120
   allowed_tools: []
   command:
-    - python3
-    - src/scripts/skill_linter.ts
+    - ./scripts-run
+    - src/scripts/skill_linter
     - "--all"
 workspaces:
   - agent-config-maintainer
@@ -39,8 +39,8 @@ Do NOT use when:
 
 ### 1. Inspect the environment
 
-Confirm `python3` is available and the working directory is the agent-config
-repository root — the linter expects to find `.agent-src.uncondensed/skills/`
+Confirm `./scripts-run` is executable and the working directory is the agent-config
+repository root — the linter expects to find `src/skills/`
 and related directories relative to `cwd`.
 
 ### 2. Dispatch via the runtime layer
@@ -53,7 +53,7 @@ this skill's frontmatter governs the call:
 ```
 
 The dispatcher resolves the request, the shell handler runs
-`python3 src/scripts/skill_linter.ts --all`, captures stdout/stderr, and returns
+`./scripts-run src/scripts/skill_linter --all`, captures stdout/stderr, and returns
 a typed `ExecutionResult`.
 
 ### 3. Verify the result
@@ -64,7 +64,7 @@ Check the returned `ExecutionResult`:
 - `exit_code: 1` → warnings only — review `stdout` for the listed warnings
 - `exit_code: 2` → errors present — fix the flagged files before continuing
 - `status: timeout` → the linter exceeded `timeout_seconds` — investigate
-- `status: error` → the interpreter could not launch — check that `python3`
+- `status: error` → the runner could not launch — check that `./scripts-run`
   is on `PATH` and the repository root is the current working directory
 
 ## Output format

package/dist/agent-src/skills/md-language-check/SKILL.md

@@ -9,8 +9,8 @@ execution:
   timeout_seconds: 30
   allowed_tools: []
   command:
-    - python3
-    - scripts/check_md_language.py
+    - ./scripts-run
+    - src/scripts/check_md_language
 workspaces:
   - agent-config-maintainer
 packs:
@@ -114,7 +114,7 @@ proceeds on exit `0`.
 ## Do NOT
 
 - Do NOT silence the checker by deleting trigger words from
-  `scripts/check_md_language.py`; extend the allow-list (anchor
+  `src/scripts/check_md_language.ts`; extend the allow-list (anchor
   blocks, ignore marker) instead
 - Do NOT add the ignore marker to body prose just to push a save
   through; the marker is for meta-documentation that quotes tokens,

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

@@ -101,9 +101,35 @@ miner is too loose; tighten patterns and re-run before promoting.
    curated YAML (next phase) become team-shared (committed).
 3. Default to `--preview` mode: render the JSONL block to stdout and
    stop. Only `--commit-intake` writes the file.
+4. **Triage each fact NOT already promoted to curated YAML** against
+   `agents/knowledge/{concepts,procedures}/` before treating it as
+   brand new:
+
+   | Triage | Condition | Action |
+   |---|---|---|
+   | `NEW` | No existing knowledge page covers this topic | Candidate for a new page (via `/team-knowledge consolidate`, not this skill) |
+   | `EXTEND` | An existing page covers the topic but is missing this detail | Note the target page in the report; do not edit mid-cycle |
+   | `CONFIRM` | An existing page already states this exactly | Discard — no duplicate entry |
+   | `CONFLICT` | An existing page states the opposite or a stale variant | Record **both** positions verbatim in the report with a `contested: true` recommendation for that page — never silently overwrite; resolution is always human |
+
+5. **Track cross-cycle recurrence toward skill-candidacy.** For each
+   `NEW` fact, run:
+
+   ```bash
+   ./scripts-run src/scripts/update_skill_candidates --topic "<stable-slug>" --session "<session-id>" --date "<YYYY-MM-DD>"
+   ```
+
+   This increments a durable per-topic counter in
+   `agents/knowledge/procedures/skill-candidates.md` — a fact that
+   recurs unpromoted across ≥ 3 consolidation cycles becomes a live
+   candidate the exit report surfaces for
+   [`learning-to-rule-or-skill`](../learning-to-rule-or-skill/SKILL.md)
+   to pick up. This script only counts; it never proposes or writes
+   the skill/rule itself. Regenerate `agents/knowledge/INDEX.md`
+   (`generate_knowledge_index.ts`) after any candidate update.
 
 **Exit gate:** every fact carries ≥ 1 tag and a JSONL-shape that
-validates against the contract.
+validates against the contract; every fact has a triage verdict.
 
 ### Phase 4 — PRUNE & INDEX
 
@@ -143,6 +169,15 @@ skills — github.com/ViktorAxelsen/MemSkill, Apache-2.0, commit `9907c35f8cc7`)
   reusable facts, not transcripts or one-off chatter.
 - **One durable fact per entry.** No narrative blobs — each entry is a single
   PATTERN / CONVENTION / INVARIANT / GOTCHA the next agent can act on.
+- **"Don't relitigate" memories carry scope + `revisit-if`.** A memory that
+  locks a question as settled — an honest-null verdict, a council convergence,
+  a maintainer call — is not a permanent law; it is a decision under the
+  conditions that held when it was written. Record what exactly is settled
+  (narrow enough that a different-but-similar proposal is not silently
+  covered) and at least one concrete condition that reopens it. Tag whether
+  it is **settled-by-evidence** (an eval ran) or **settled-by-decision** (a
+  maintainer call) — the latter is cheaper to reopen. See
+  [`decision-revisit-gate`](../../rules/decision-revisit-gate.md).
 
 This is **meta-memory**: the skill of *how to remember* (what to extract,
 keep, forget) — distinct from the remembered content. The store stays simple
@@ -151,6 +186,36 @@ INSERT/UPDATE/DELETE/NOOP operation machinery (append-only JSONL + curated
 YAML need no such ops) and do **not** import any retrieval / decay / trust
 engine.
 
+## Applying recalled memories
+
+How memories are *written* is covered above; this section covers how
+recalled content is *used* once retrieved.
+
+- **Apply selectively and contextually.** A recalled fact surfaces only
+  when it's relevant to the current turn — not as a demonstration that
+  memory exists.
+- **Never narrate the retrieval mechanism.** Forbidden phrases: "I
+  remember", "based on your memories", "according to your profile/data",
+  "I can see from memory". Recalled facts surface as normal working
+  knowledge, indistinguishable in tone from anything else the agent knows.
+- **Sensitivity floor.** Recalled content about sensitive topics
+  (personal difficulties, conflicts, health) is never surfaced
+  unprompted — only when the user raises the topic first, this session.
+  Bringing up a sensitive memory unprompted is not just unhelpful, it is
+  actively harmful.
+- **Staleness still applies.** A recalled memory reflects what was true
+  when it was written — verify referenced files/flags/state still hold
+  before treating it as current (see the memory-and-other-persistence
+  guidance this skill's callers already carry).
+
+### Retrieval-trigger linguistics
+
+Before answering from scratch, treat these as signals to consult memory
+first: possessives ("my/our X"), definite references to unnamed prior
+work ("that bug", "the migration"), and past-time cues ("last week",
+"back then"). These phrasings imply the user expects continuity with
+something already known, not a first-time explanation.
+
 ## TranscriptAdapter contract
 
 The miner is host-agnostic by design. A `TranscriptAdapter` for host

package/dist/agent-src/skills/migration-architect/SKILL.md

@@ -5,6 +5,7 @@ description: "Use when shaping a non-trivial migration — rollout phases, dual-
 personas:
   - backend-architect
   - senior-engineer
+  - data-integrity
 domain: process
 workspaces:
   - engineering

package/dist/agent-src/skills/module-detect-on-the-fly/SKILL.md

@@ -67,8 +67,8 @@ Confirm both flags via `get_modules_config()` before running detection.
 
    - **Option 1** — build the payload (matches `propose_modules_config.py
      --json` shape, includes `detection_acknowledged: true`), pipe into
-     `python3 scripts/apply_modules_config.py --project <root>`.
-   - **Option 2** — run `python3 scripts/apply_modules_config.py
+     `./scripts-run src/scripts/apply_modules_config --project <root>`.
+   - **Option 2** — run `./scripts-run src/scripts/apply_modules_config
      --project <root> --acknowledge-only`. Flips only the ack flag;
      every other `modules.*` key stays untouched.
    - **Option 3** — list candidates, then loop back to step 3.

package/dist/agent-src/skills/performance-analysis/SKILL.md

@@ -2,6 +2,8 @@
 model_tier: high
 name: performance-analysis
 description: "ONLY when user explicitly requests: performance audit, bottleneck analysis, or N+1 query detection. NOT for regular feature work."
+personas:
+  - performance-engineer
 domain: discovery
 workspaces:
   - engineering

package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md

@@ -145,9 +145,9 @@ Don't hand-pick a scoreline. Run the executed grid optimiser — builds the full
 Poisson score grid, returns the EV-max tip under the step-1 point tiers:
 
 ```bash
-python3 scripts/prediction-pool/score_ev.py --lh <home-xg> --la <away-xg> \
+./scripts-run src/scripts/prediction-pool/score_ev --lh <home-xg> --la <away-xg> \
     --tendency <t> --diff <d> --exact <e>          # one match
-python3 scripts/prediction-pool/score_ev.py matches.json \
+./scripts-run src/scripts/prediction-pool/score_ev matches.json \
     --tendency <t> --diff <d> --exact <e>          # batch, prints a ranked table
 ```
 
@@ -176,7 +176,7 @@ of the field)**; pure EV-max converges with the crowd, can't open a gap.
 Measure it with the executed field simulator, not a "rough Kelly" hand-wave:
 
 ```bash
-python3 scripts/prediction-pool/pool_winsim.py pool.json --runs 4000 --max-flips 4
+./scripts-run src/scripts/prediction-pool/pool_winsim pool.json --runs 4000 --max-flips 4
 ```
 
 Models the field as softmax-EV tippers, reports `P(win)` for EV-max-everywhere,
@@ -204,7 +204,7 @@ question type — full taxonomy + per-type method in
   winner") aggregated per step 2, **or** the executed Poisson simulator:
 
   ```bash
-  python3 scripts/prediction-pool/poisson_sim.py <teams-xg.json> --runs 20000
+  ./scripts-run src/scripts/prediction-pool/poisson_sim <teams-xg.json> --runs 20000
   ```
 
   It plays the bracket from per-team expected goals and prints empirical

package/dist/agent-src/skills/premortem/SKILL.md

@@ -1,18 +1,15 @@
 ---
 name: premortem
 description: "Use before committing to a heavy or irreversible plan — imagine it's 6 months later and this failed; enumerate why, score each mode, derive early-warning signals and preventive guardrails."
-source: package
 domain: quality
 model_tier: high
 workspaces:
   - engineering
 packs:
   - analysis-workbench
-lifecycle: active
 trust:
   level: professional
   confidence: medium
-  human_review_required: false
 install:
   default: false
   removable: true

package/dist/agent-src/skills/project-analysis-core/SKILL.md

@@ -129,6 +129,22 @@ Check:
 6. Known uncertainties
 7. Recommended next specialist skill
 
+## Knowledge capture (`convention_detected` events)
+
+An architecture-map or stack finding that recurs (naming convention,
+module boundary, layering rule) is worth persisting for the team.
+Append to the knowledge intake instead of leaving it in the one-off
+analysis output — applies to every `project-analysis-*` specialist
+this skill hands off to:
+
+```bash
+./scripts-run src/scripts/emit_knowledge_event --type convention_detected \
+    --pattern "<pattern>" --evidence "file:line" --sample-size <N> --scope project
+```
+
+`/team-knowledge consolidate` turns accumulated events into
+`agents/knowledge/concepts/` pages as a reviewed batch.
+
 ## Gotcha
 
 * If versions are guessed, the whole analysis becomes unreliable.

package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md

@@ -71,7 +71,9 @@ coordinates.
 Each link **delegates** to the artifact that owns it (no duplication):
 
 1. **ground** — close constraints/tools/info-gaps before designing
-   ([`think-before-action` § Environment grounding](../../rules/think-before-action.md)).
+   ([`think-before-action` § Environment grounding](../../rules/think-before-action.md));
+   seed the read from the **repo** slot of the
+   [context-spine](../../../docs/contracts/context-spine.md) when present.
 2. **intent** — state the inferred goal + one recommendation, standard host only
    ([`improve-before-implement` § Intent inference](../../rules/improve-before-implement.md)).
 3. **notes** — hypotheses/predictions/decisions/uncertainty to the notes file, not

package/dist/agent-src/skills/release-comms/SKILL.md

@@ -21,77 +21,77 @@ install:
 
 ## When to use
 
-- Release shipping with user-facing change, team about to send feature-list email.
-- Changelog draft reads like commit log — engineering-honest, unparseable for user.
-- Multiple comms surfaces (in-app, email, social, docs) about to be written by different people from same release.
+- A release is shipping that contains user-facing change and the team is about to send a feature-list email.
+- A changelog draft reads like a commit log — engineering-honest, but unparseable for the user.
+- Multiple comms surfaces (in-app, email, social, docs) are about to be written by different people from the same release.
 
 Do NOT use for incident comms (see `incident-commander`),
-deprecation announcements needing legal sign-off, or pre-release
-discovery — this skill assumes change is **shipped**.
+deprecation announcements that need legal sign-off, or pre-release
+discovery — this skill assumes the change is **shipped**.
 
 ## Cognition cluster
 
-- **Mental model 16 — Leading vs. lagging indicators.** Release note
-  is lagging artifact; leading version = in-app prompt that fired
-  before user found change-log. See
+- **Mental model 16 — Leading vs. lagging indicators.** A release
+  note is the lagging artifact; the leading version is the in-app
+  prompt that fired before the user found the change-log. See
   [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 16.
-- **Value-not-feature heuristic.** Every paragraph passes *"so the
-  user can ___"* completion. Failing rows go back for re-write.
+- **Value-not-feature heuristic.** Every paragraph passes the *"so
+  the user can ___"* completion. Failing rows go back for re-write.
 
 ## Procedure
 
 ### Step 0: Ground the release
 
-1. Read merged PR list / changelog block / release branch diff. Release = **what**; comms = **so what**. Conflate the two → ship marketing.
-2. Read **product** and **team** slots of [context-spine](../../../docs/contracts/context-spine.md) (if consumer filled them) for bounded scope and cadence — surface choice depends on cadence (weekly: in-app + log; quarterly: email + post; major: all four).
-3. Identify **single dominant change** the release ships. Three "headliners" reads as three half-announcements.
+1. Read the merged PR list / changelog block / release branch diff. The release is the **what**; comms is the **so what**. Conflate the two and you ship marketing.
+2. Read the **product** and **team** slots of the [context-spine](../../../docs/contracts/context-spine.md) (if the consumer project has filled them) for bounded scope and release cadence — surface choice depends on cadence (weekly: in-app + log; quarterly: email + post; major: all four).
+3. Identify the **single dominant change** the release ships. A release with three "headliners" reads as three half-announcements.
 
 ### Step 1: Audience-segment
 
-1. Three audiences max: **active user**, **at-risk / lapsed user**, **prospect**. More fragments message; fewer hides routing.
-2. Per audience, write one sentence: *"After this release, you can …"* completing with user-side verb, not product-side feature.
-3. If two audiences end up with same sentence, collapse — segmentation that does not change message = theatre.
+1. Three audiences max: **active user**, **at-risk / lapsed user**, **prospect**. More segments fragment the message; fewer hides the routing.
+2. Per audience, write one sentence: *"After this release, you can …"* completing with a user-side verb, not a product-side feature.
+3. If two audiences end up with the same sentence, collapse them — segmentation that does not change the message is theatre.
 
 ### Step 2: Map surfaces to audiences
 
 1. **Changelog** (always) — engineers + power users; truthful, dense, link-heavy. Source of truth — every other surface points back here.
 2. **In-app prompt** — active users; ≤ 1 sentence + 1 CTA; fires for users whose past behaviour predicts they'll touch the new path.
 3. **Email** — at-risk / lapsed; one headline value, one CTA, one paragraph of context. No feature lists.
-4. **Social / blog** — prospect; the **why**, not the **what** — frame against user job (cite [`customer-research`](../customer-research/SKILL.md) if switch-event surfaced).
+4. **Social / blog** — prospect; the **why**, not the **what** — frame against the user job (cite [`customer-research`](../customer-research/SKILL.md) if a switch-event surfaced).
 
-Cut surfaces aggressively. Weekly release does not need blog post.
+Cut surfaces aggressively. A weekly release does not need a blog post.
 
 ### Step 3: Draft each surface from the changelog
 
-1. Open changelog. Per surface, copy dominant change line, then **rewrite verb subject** from "we" to "you".
-2. Strip qualifiers ("now", "even better", "lightning-fast"). Noise, not signal.
-3. Run *"so the user can ___"* completion on every paragraph. Failing paragraphs cut, not edited.
+1. Open the changelog. Per surface, copy the dominant change line, then **rewrite the verb subject** from "we" to "you".
+2. Strip qualifiers ("now", "even better", "lightning-fast"). They are noise, not signal.
+3. Run the *"so the user can ___"* completion on every paragraph. Failing paragraphs are cut, not edited.
 
 ### Step 4: Truth-check
 
-1. Every claim links back to changelog row or doc URL. Unsourced claim → cut.
-2. No tense games — past for shipped, future for coming-soon (and only if date is committed). "Roadmap" lives outside this skill.
-3. Names match product surface. In-app says "Reports" and email says "Insights" → user fires lookup tax.
+1. Every claim links back to a changelog row or a doc URL. Unsourced claim → cut.
+2. No tense games — past for shipped, future for coming-soon (and only if the date is committed). "Roadmap" lives outside this skill.
+3. Names match the product surface. If the in-app says "Reports" and the email says "Insights", the user fires the lookup tax.
 
 ### Step 5: Hand off
 
-1. Produce four artifacts (see `## Output`).
-2. Hand to whoever owns send. Do not embed scheduling or A/B test plans here — that is RevOps.
+1. Produce the four artifacts (see `## Output`).
+2. Hand to whoever owns the send. Do not embed scheduling or A/B test plans here — that is RevOps.
 
 ## Related Skills
 
 **WHEN to use this**
 
-- Change is **shipped** and needs to reach existing users.
-- Multiple comms surfaces written by different people from same source.
-- Team about to default to feature-list email.
+- The change is **shipped** and needs to reach existing users.
+- Multiple comms surfaces will be written by different people from the same source.
+- The team is about to default to a feature-list email.
 
 **WHEN NOT to use this**
 
-- Production incident comms → [`incident-commander`](../incident-commander/SKILL.md).
-- Pre-release discovery / validation → [`customer-research`](../customer-research/SKILL.md).
-- Funnel-stage diagnostics post-release → [`funnel-analysis`](../funnel-analysis/SKILL.md).
-- Ranking which release to comms next → [`rice-prioritization`](../rice-prioritization/SKILL.md).
+- Production incident comms — route to [`incident-commander`](../incident-commander/SKILL.md).
+- Pre-release discovery / validation — route to [`customer-research`](../customer-research/SKILL.md).
+- Funnel-stage diagnostics post-release — route to [`funnel-analysis`](../funnel-analysis/SKILL.md).
+- Ranking which release to comms next — route to [`rice-prioritization`](../rice-prioritization/SKILL.md).
 
 ## When the agent should load this
 
@@ -104,29 +104,30 @@ Cut surfaces aggressively. Weekly release does not need blog post.
 ## Output
 
 1. **`release-narrative.md`** — single source of truth: dominant change, audiences (1–3), per-audience *"After this release, you can …"* sentence, links to source changelog rows.
-2. **`changelog-entry.md`** — engineer-honest, dense, link-heavy block ready to paste into project's changelog.
-3. **`comms-pack.md`** — per-surface drafts (in-app prompt, email, optional social/blog), each ≤ surface's hard cap, each pointing back to `changelog-entry.md`.
-4. **`comms-checklist.md`** — pre-send checks: every claim sourced, names consistent across surfaces, audience match, "so the user can …" completion passing on every paragraph. Hand-off artifact for senior PO ([`product-owner`](../../personas/product-owner.md)).
+2. **`changelog-entry.md`** — engineer-honest, dense, link-heavy block ready to paste into the project's changelog.
+3. **`comms-pack.md`** — per-surface drafts (in-app prompt, email, optional social/blog), each ≤ the surface's hard cap, each pointing back to `changelog-entry.md`.
+4. **`comms-checklist.md`** — pre-send checks: every claim sourced, names consistent across surfaces, audience match, "so the user can …" completion passing on every paragraph. Hand-off artifact for the senior PO ([`product-owner`](../../personas/product-owner.md); senior persona shipping in next plate).
 
 ## Gotcha
 
-- Default failure mode = feature-list email — written to make engineering feel seen, not to help user.
-- Marketing puffery ("revolutionary", "delightful") fails source check; cut on sight.
-- Two surfaces using different names for same thing = highest-frequency support-ticket trigger after release.
+- The default failure mode is feature-list email — written to make engineering feel seen, not to help the user.
+- Marketing puffery ("revolutionary", "delightful") fails the source check; cut on sight.
+- Two surfaces using different names for the same thing is the highest-frequency support-ticket trigger after a release.
 - Hidden coming-soon claims in past-tense paragraphs erode trust faster than missing the comms entirely.
 
 ## Do NOT
 
-- Do NOT promote coming-soon item alongside shipped items — user cannot tell which is which and stops trusting next note.
-- Do NOT let long-tail change steal the headline — dominant change earns headline, long tail goes in changelog.
-- Do NOT ship surfaces without truth-check pass; unsourced claim survives in social longer than release does.
+- Do NOT promote a coming-soon item alongside shipped items — the user cannot tell which is which and stops trusting the next note.
+- Do NOT let a long-tail change steal the headline — the dominant change earns the headline, the long tail goes in the changelog.
+- Do NOT ship surfaces without the truth-check pass; an unsourced claim survives in social longer than the release does.
+- Do NOT paste more than a short excerpt from a linked source (commit message, PR body, issue thread) — `content-quoting-floor` caps verbatim quotes at 15 words, one per source; paraphrase the rest.
 
 ## Runnable example
 
 Sprint 47 ships a one-click monthly export and three small bug fixes:
 
 - Dominant change: one-click export. Bug fixes go in changelog only.
-- Audiences: active user (will use it), at-risk (export friction was churn trigger per [`customer-research`](../customer-research/SKILL.md) evidence-log).
+- Audiences: active user (will use it), at-risk (export friction was a churn trigger per [`customer-research`](../customer-research/SKILL.md) evidence-log).
 - "After this release, you can pull a board-ready monthly report in one click." (active, at-risk — same sentence ⇒ collapse to one).
-- Surfaces: changelog (full), in-app prompt to active users on next month-end, email to at-risk cohort with same sentence and one CTA. No social.
-- Truth-check: claim links to export PR; "one click" is literal — verified against shipped UI.
+- Surfaces: changelog (full), in-app prompt to active users on next month-end, email to at-risk cohort with the same sentence and one CTA. No social.
+- Truth-check: claim links to the export PR; "one click" is literal — verified against the shipped UI.

package/dist/agent-src/skills/roadmap-management/SKILL.md

@@ -212,6 +212,16 @@ unfamiliar codebases.
 
 ### Executing a roadmap
 
+0. Read `execution.mode` from the roadmap frontmatter
+   (`autonomous` | `phase-checkpoints` | `interactive`; absent =
+   `interactive`). Under `/roadmap:process-*` the mode selects the
+   interaction pattern via the run-start execution contract — see
+   [`roadmap-execution-contract`](../../contexts/execution/roadmap-execution-contract.md).
+   The manual flow below describes `interactive`; under `autonomous`
+   / `phase-checkpoints` step 4's per-step ask is replaced by the
+   accepted contract. **Mode never changes archival semantics** —
+   glyph counting, the closure decision table, and the Iron Law 3
+   deferred-resolution gate below apply identically in every mode.
 1. Read the full roadmap.
 2. Find the next unchecked step (`- [ ]`).
 3. Summarize what needs to be done.
@@ -455,6 +465,17 @@ No global tooling required.
 
 The dashboard is a **read-only snapshot**. Do not edit it by hand — regenerate it.
 
+### Blockers on the dashboard
+
+Overview table's `Blocker` column counts each roadmap's open
+`## Blockers` entries (or legacy `> Blocked until` note), links to
+per-roadmap breakdown, which lists every open blocker with owner,
+blocked scope, full instructions. Authoring shape:
+[`templates/roadmaps.md` rule 20](../../agent-src/templates/roadmaps.md);
+authoring guidance: [`roadmap-writing § 5b`](../roadmap-writing/SKILL.md).
+Clearing a blocker flips `Status: resolved`, regenerates dashboard in
+same reply — same cadence as a checkbox flip.
+
 ## Rubric pass (optional, surfacing-only)
 
 After producing roadmap, run [`judge-artifact-completeness`](../judge-artifact-completeness/SKILL.md) with rubric `roadmap-score` to surface missing dimensions (risk, tests, migration, maintainability). Score is a recommendation; never blocks shipping. Invoke only when user wants completeness check — not by default.