@windyroad/retrospective 0.20.4 → 0.21.0-preview.387

package/.claude-plugin/plugin.json

@@ -66,5 +66,5 @@
     }
   },
   "name": "wr-retrospective",
-  "version": "0.20.4"
+  "version": "0.21.0"
 }

package/README.md

@@ -32,7 +32,7 @@ Restart Claude Code after installing.
 /wr-retrospective:run-retro
 ```
 
-This walks through the session's work, identifies what went well and what didn't, updates `docs/BRIEFING.md`, and creates problem tickets for any failures. The retro also runs every shipped advisory script (briefing budgets, ask-hygiene, README JTBD currency per ADR-051, SKILL.md runtime budgets per ADR-054) so doc-content drift surfaces in the retro summary alongside session-level reflections.
+This walks through the session's work, identifies what went well and what didn't, updates `docs/BRIEFING.md`, and creates problem tickets for any failures. The retro also runs every shipped advisory script (briefing budgets, ask-hygiene, README skill-inventory currency per ADR-069, SKILL.md runtime budgets per ADR-054) so doc-content drift surfaces in the retro summary alongside session-level reflections.
 
 **Analyse session context usage:**
 
@@ -57,7 +57,7 @@ Each script ships as a `bin/`-resolvable shim per ADR-049. They emit signal-as-d
 
 | Shim | Purpose |
 |------|---------|
-| `wr-retrospective-check-readme-jtbd-currency` | ADR-051 Phase 1 detector — surfaces drift between plugin READMEs and the JTBD jobs they cite |
+| `wr-retrospective-check-readme-jtbd-currency` | ADR-069 detector — surfaces skill-inventory drift (a shipped skill not named in the plugin's README) |
 | `wr-retrospective-check-skill-md-budgets` | ADR-054 detector — flags SKILL.md files over the WARN / MUST_SPLIT byte budget |
 | `wr-retrospective-check-internal-id-leaks` | ADR-055 detector — flags internal IDs leaking into published artefacts |
 | `wr-retrospective-list-plugin-attribution` | Per-plugin context attribution support for `analyze-context` |
@@ -71,19 +71,6 @@ Each script ships as a `bin/`-resolvable shim per ADR-049. They emit signal-as-d
 | `session-start-briefing.sh` | Session start | Surfaces the latest `docs/BRIEFING.md` and any pending retrospective items so the new session begins with prior-session context (per [ADR-040](../../docs/decisions/040-session-start-briefing-surface.proposed.md)) |
 | `retrospective-reminder.sh` | Session end | Reminds you to run a retrospective |
 
-## Jobs to be Done
-
-This plugin serves the [Jobs to be Done](../../docs/jtbd/) below. Per [ADR-051](../../docs/decisions/051-jtbd-anchored-readme-with-drift-advisory.proposed.md), the persona-grouped JTBD anchor is the canonical source of truth for the README's value framing.
-
-### Solo developer
-
-- **[JTBD-006 Progress the Backlog While I'm Away](../../docs/jtbd/solo-developer/JTBD-006-work-backlog-afk.proposed.md)** — every AFK iteration runs a retrospective before exiting so per-iter friction is captured as problem tickets and surfaced on return; learnings flow back into `docs/BRIEFING.md` so the next session starts with context.
-- **[JTBD-002 Ship AI-Assisted Code with Confidence](../../docs/jtbd/solo-developer/JTBD-002-ship-with-confidence.proposed.md)** — release-readiness signals (pipeline-instability scan, ask-hygiene check, doc-currency advisory) accumulate at retro time so unresolved friction is visible before the next release.
-
-### Plugin user
-
-- **[JTBD-302 Trust That the README Describes the Plugin I Just Installed](../../docs/jtbd/plugin-user/JTBD-302-trust-readme-describes-installed-behaviour.proposed.md)** — this README is anchored on current JTBD job IDs; drift between prose and shipped behaviour is detectable at retro time per ADR-051.
-
 ## Updating and Uninstalling
 
 ```bash

package/hooks/retrospective-readme-jtbd-currency.sh

@@ -1,23 +1,28 @@
 #!/bin/bash
-# P159: PreToolUse:Bash hook — denies `git commit` invocations whose
-# post-commit working tree exhibits JTBD-currency drift in any
-# packages/<plugin>/README.md (no JTBD-NNN anchor, stale or
-# deprecated-only citation, or skill directory missing from README).
+# ADR-069 (P294): PreToolUse:Bash hook — denies `git commit` invocations
+# whose post-commit working tree exhibits skill-inventory drift in any
+# packages/<plugin>/README.md (a directory under packages/<plugin>/skills/
+# is not named in the README).
 #
-# Hook-level enforcement at commit time replaces ADR-051 Phase 1's
-# retro-time advisory surface (shipped under P158, df47ad1). The user
-# correction (P159) and the architect verdict identified the retro
-# surface as too late: the most-common drift class (contributor adds
-# skill/hook/agent and forgets the README) ships in a commit that
-# does not touch README.md, so a retro-time consumer sees the drift
-# only after the contributor has already committed.
+# HISTORY: this hook formerly (P159, under superseded ADR-051) also gated on
+# JTBD-ID-citation drift (no JTBD-NNN anchor, stale/deprecated citation).
+# ADR-069 superseded ADR-051: plugin READMEs market the persona's problem
+# derived FROM the JTBD but MUST NOT cite JTBD IDs. The JTBD-ID anchor + its
+# docs/jtbd/ resolution are removed; the mechanical skill-inventory-drift
+# signal (ADR-051's original P152 empirical core) survives as the load-
+# bearing currency gate. Filename retained deliberately per ADR-069.
 #
-# Detection delegates to the existing detector script
+# Hook-level enforcement at commit time (vs retro-time advisory) is retained
+# per the carried-forward load-bearing-from-the-start-for-drift-class driver:
+# the most-common drift class (contributor adds a skill and forgets the
+# README) ships in a commit that does not touch README.md, so a retro-time
+# consumer sees the drift only after the contributor has already committed.
+#
+# Detection delegates to the detector script
 # (`packages/retrospective/scripts/check-readme-jtbd-currency.sh`),
-# invoked against the project's working tree (`./packages/` +
-# `./docs/jtbd/`). The hook reads the detector's
-# `TOTAL packages=<N> with_jtbd=<M> drift_instances=<K>` summary and
-# denies when `drift_instances > 0`.
+# invoked against the project's working tree (`./packages/`). The hook reads
+# the detector's `TOTAL packages=<N> drift_instances=<K>` summary and denies
+# when `drift_instances > 0`.
 #
 # Allow paths (exit 0 silently per ADR-045 Pattern 1):
 #   - tool_name != "Bash"            (only Bash invocations are gated)
@@ -139,11 +144,11 @@ fi
 # Fail-open if not inside a git working tree.
 git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
 
-# Fail-open if the project lacks ADR-051's structural anchors.
-# Adopter projects without `./packages/` or `./docs/jtbd/` are not
-# subject to the rule; the hook is a no-op for them.
+# Fail-open if the project lacks the structural anchor (`./packages/`).
+# Adopter projects without `./packages/` are not subject to the rule; the
+# hook is a no-op for them. (ADR-069: the `./docs/jtbd/` guard is removed —
+# skill-inventory drift does not consult docs/jtbd/.)
 [ -d "./packages" ] || exit 0
-[ -d "./docs/jtbd" ] || exit 0
 
 # Fail-open if the detector script itself is missing (defensive —
 # hook + detector ship together, but install-time corruption or
@@ -152,7 +157,7 @@ git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
 
 # Run the detector. Capture exit code + output. Fail-open on detector
 # error (exit != 0).
-DETECTOR_OUTPUT=$(bash "$DETECTOR" "./packages" "./docs/jtbd" 2>/dev/null) || exit 0
+DETECTOR_OUTPUT=$(bash "$DETECTOR" "./packages" 2>/dev/null) || exit 0
 
 # Parse the TOTAL summary line. If absent, no packages were
 # enumerated — fail-open (no drift to report).
@@ -188,12 +193,11 @@ OFFENDING_HINTS=$(echo "$OFFENDING_LINE" | grep -oE 'drift_hints=[A-Za-z0-9,_-]+
 PRIMARY_HINT="${OFFENDING_HINTS%%,*}"
 
 # Deny — voice/tone budget per ADR-045 deny-band ≤300 bytes total
-# (envelope ~137 bytes; REASON ~163 bytes for worst-case slug +
-# hint). Names the offending plugin slug, the primary drift hint,
-# the wr-jtbd:agent recovery path with hand-edit fallback (graceful
-# degradation per architect F advisory), the BYPASS env, and the
-# P159 cite.
-REASON="BLOCKED: P159 JTBD drift in ${OFFENDING_SLUG} (${PRIMARY_HINT}). Recovery: wr-jtbd:agent OR cite a JTBD-NNN in README. Bypass: BYPASS_JTBD_CURRENCY=1."
+# (envelope ~137 bytes; REASON ~145 bytes for worst-case slug + the
+# single inventory hint). Names the offending plugin slug, the drift
+# hint, the mechanical recovery (name the skill in the README — NOT
+# a JTBD-ID citation per ADR-069), the BYPASS env, and the P294 cite.
+REASON="BLOCKED: P294 README inventory drift in ${OFFENDING_SLUG} (${PRIMARY_HINT}). Recovery: name the skill in the README. Bypass: BYPASS_JTBD_CURRENCY=1."
 
 cat <<EOF
 {

package/hooks/test/retrospective-readme-jtbd-currency.bats

@@ -1,32 +1,31 @@
 #!/usr/bin/env bats
 
-# P159: retrospective-readme-jtbd-currency.sh PreToolUse:Bash hook must
-# deny `git commit` invocations whose post-commit working tree exhibits
-# JTBD-currency drift (no JTBD-NNN anchor in a plugin README, stale or
-# deprecated-only citations, or skills/<dir>/ missing from the README).
-# Hook-level enforcement at commit time replaces ADR-051 Phase 1's
-# retro-time advisory surface, which the user correction (P159) and the
-# architect verdict identify as too late: the most-common drift class
-# (contributor adds skill/hook/agent and forgets the README) ships in a
-# commit that doesn't touch README.md, so a retro-time consumer sees the
-# drift only after the contributor has already committed.
+# ADR-069 (P294): retrospective-readme-jtbd-currency.sh PreToolUse:Bash hook
+# must deny `git commit` invocations whose post-commit working tree exhibits
+# skill-inventory drift (a directory under packages/<plugin>/skills/ is not
+# named in that plugin's README). Hook-level enforcement at commit time is
+# retained per the carried-forward load-bearing-from-the-start-for-drift-class
+# driver: the most-common drift class (contributor adds a skill and forgets
+# the README) ships in a commit that doesn't touch README.md.
 #
-# Detection delegates to the existing
-# `packages/retrospective/scripts/check-readme-jtbd-currency.sh`
-# detector, which the hook invokes against the project's working tree
-# (`./packages/` + `./docs/jtbd/`). The hook reads the detector's
-# `TOTAL packages=<N> with_jtbd=<M> drift_instances=<K>` summary line
-# and denies when `drift_instances > 0`.
+# HISTORY: under superseded ADR-051 (P159) this hook also gated on
+# JTBD-ID-citation drift. ADR-069 superseded that rule — READMEs market the
+# persona's problem derived FROM the JTBD but MUST NOT cite JTBD IDs. The
+# JTBD-ID anchor + its docs/jtbd/ resolution (and the docs/jtbd/ activation
+# guard) are removed; only skill-inventory-drift remains.
 #
-# Per ADR-005 (plugin testing strategy) — hook bats live under
-# packages/<plugin>/hooks/test/ and assert on emitted JSON, not source
-# content. Per ADR-052 / P081 — behavioural; no source greps. Per
-# ADR-045 Pattern 1 — allow paths emit 0 bytes; deny-band ≤300 bytes.
-# Per ADR-013 Rule 1 — deny redirects to mechanical recovery (here: the
-# wr-jtbd:agent for prose-weaving guidance, with hand-edit fallback).
-# Per ADR-013 Rule 6 — fail-open outside a git work tree, on parse
-# errors, or in projects without ADR-051's structural anchors
-# (./packages/ or ./docs/jtbd/) so adopter projects are not blocked.
+# Detection delegates to
+# `packages/retrospective/scripts/check-readme-jtbd-currency.sh`, invoked
+# against the project's working tree (`./packages/`). The hook reads the
+# detector's `TOTAL packages=<N> drift_instances=<K>` summary and denies
+# when `drift_instances > 0`.
+#
+# Per ADR-005 / ADR-052 / P081 — behavioural; assert on emitted JSON, no
+# source greps. Per ADR-045 Pattern 1 — allow paths emit 0 bytes; deny-band
+# ≤300 bytes. Per ADR-013 Rule 1 — deny redirects to mechanical recovery
+# (here: "name the skill in the README"). Per ADR-013 Rule 6 — fail-open
+# outside a git work tree, on parse errors, or in projects without
+# `./packages/`.
 
 setup() {
   SCRIPT_DIR="$(cd "$(dirname "$BATS_TEST_FILENAME")/.." && pwd)"
@@ -56,86 +55,49 @@ run_bash_hook() {
   echo "$json" | bash "$HOOK"
 }
 
-# Helper: build a stub project layout with a drifted plugin README.
-# README has no JTBD-NNN citation; jtbd dir has one resolving job.
+# Helper: stub project with skill-inventory drift —
+# packages/stub/skills/orphan/ exists but the README doesn't name "orphan".
 make_drifted_project() {
-  mkdir -p packages/stub docs/jtbd/plugin-user
-  printf '%s\n' "# @windyroad/stub" "no jtbd anchor here" > packages/stub/README.md
-  cat > docs/jtbd/plugin-user/JTBD-302-trust-readme.proposed.md <<'EOF'
----
-status: proposed
-job-id: trust-readme
-persona: plugin-user
-date-created: 2026-05-04
----
-
-# JTBD-302
-EOF
-}
-
-# Helper: build a stub project layout with a clean plugin README.
-# README cites a resolving JTBD-NNN; no skill drift.
+  mkdir -p packages/stub/skills/orphan
+  printf '%s\n' "# @windyroad/stub" "Markets a problem in prose; names no skills." > packages/stub/README.md
+}
+
+# Helper: clean stub project — every skill directory is named in the README.
 make_clean_project() {
-  mkdir -p packages/stub docs/jtbd/plugin-user
-  printf '%s\n' "# @windyroad/stub" "Serves JTBD-302." > packages/stub/README.md
-  cat > docs/jtbd/plugin-user/JTBD-302-trust-readme.proposed.md <<'EOF'
----
-status: proposed
-job-id: trust-readme
-persona: plugin-user
-date-created: 2026-05-04
----
-
-# JTBD-302
-EOF
-}
-
-# Helper: build a stub project with skill-inventory-drift —
-# packages/stub/skills/orphan/ exists but README doesn't name "orphan".
-make_skill_drift_project() {
-  mkdir -p packages/stub/skills/orphan docs/jtbd/plugin-user
-  printf '%s\n' "# @windyroad/stub" "Serves JTBD-302." > packages/stub/README.md
-  cat > docs/jtbd/plugin-user/JTBD-302-trust-readme.proposed.md <<'EOF'
----
-status: proposed
-job-id: trust-readme
-persona: plugin-user
-date-created: 2026-05-04
----
-
-# JTBD-302
-EOF
+  mkdir -p packages/stub/skills/do-thing
+  printf '%s\n' "# @windyroad/stub" "Run /wr-stub:do-thing to solve the problem." > packages/stub/README.md
 }
 
 # ── Trap detection: deny when drift detected ───────────────────────────────
 
-@test "deny: drifted README (no JTBD-NNN cite) on git commit triggers deny" {
+@test "deny: skill-inventory drift on git commit triggers deny" {
   make_drifted_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
   [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
-  [[ "$output" == *"P159"* ]]
+  [[ "$output" == *"P294"* ]]
 }
 
-@test "deny: skill-inventory-drift on git commit triggers deny" {
-  make_skill_drift_project
+@test "deny message names the offending plugin slug" {
+  make_drifted_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
-  [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
+  [[ "$output" == *"stub"* ]]
 }
 
-@test "deny message names the offending plugin slug" {
+@test "deny message names the mechanical recovery (name the skill in the README)" {
   make_drifted_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
-  [[ "$output" == *"stub"* ]]
+  [[ "$output" == *"name the skill in the README"* ]]
 }
 
-@test "deny message names the wr-jtbd:agent recovery path" {
+@test "deny message does NOT instruct citing a JTBD ID (ADR-069 regression guard)" {
   make_drifted_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
-  [[ "$output" == *"wr-jtbd"* ]]
+  [[ "$output" != *"JTBD-NNN"* ]]
+  [[ "$output" != *"wr-jtbd"* ]]
 }
 
 @test "deny message stays under ADR-045 deny-band (<300 bytes)" {
@@ -145,16 +107,13 @@ EOF
   [ "${#output}" -lt 300 ]
 }
 
-@test "deny: chore release commit (chore: version packages) is subject to the gate" {
+@test "deny: canonical release commit shape (chore: version packages) is subject to the gate" {
   make_drifted_project
+  # Not a `git commit` invocation — the bare message must NOT deny.
   run run_bash_hook "chore: version packages"
-  # Not a `git commit` invocation — should NOT trigger deny because the
-  # command field is the message, not the invocation. The actual release
-  # path runs `git commit` which IS gated; verify that shape:
   [ "$status" -eq 0 ]
   [[ "$output" != *"\"permissionDecision\": \"deny\""* ]]
-
-  # Now the canonical release commit shape:
+  # The canonical release commit shape IS gated:
   run run_bash_hook "git commit -m 'chore: version packages'"
   [ "$status" -eq 0 ]
   [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
@@ -167,9 +126,18 @@ EOF
   [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
 }
 
+@test "deny: skill drift with NO docs/jtbd present still denies (ADR-069 guard removed)" {
+  make_drifted_project
+  # deliberately no docs/jtbd/ — under ADR-051 the hook was a no-op here;
+  # ADR-069 removed that guard, so inventory drift is now evaluated.
+  run run_bash_hook "git commit -m 'feat'"
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
+}
+
 # ── Allow paths: each non-trap shape must NOT deny ─────────────────────────
 
-@test "allow: clean README (cites resolving JTBD-NNN) on git commit allows the commit" {
+@test "allow: clean README (all skills named) on git commit allows the commit" {
   make_clean_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
@@ -211,15 +179,14 @@ EOF
 }
 
 @test "allow: project without packages/ dir exits 0 without deny (fail-open)" {
-  # No packages/, no docs/jtbd/ — adopter project shape.
+  # No packages/ — adopter project shape.
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
   [[ "$output" != *"\"permissionDecision\": \"deny\""* ]]
 }
 
-@test "allow: project with packages/ but no docs/jtbd/ exits 0 without deny (fail-open)" {
-  mkdir -p packages/stub
-  echo "# stub" > packages/stub/README.md
+@test "allow: project with packages/ and no docs/jtbd/, clean README, allows (docs/jtbd no longer required)" {
+  make_clean_project
   run run_bash_hook "git commit -m 'feat'"
   [ "$status" -eq 0 ]
   [[ "$output" != *"\"permissionDecision\": \"deny\""* ]]
@@ -266,8 +233,7 @@ EOF
 #
 # The hook must fire on ACTUAL `git commit` invocations, NOT on Bash that
 # merely MENTIONS the phrase "git commit" in argument vectors or heredoc
-# bodies. Mirrors P268 regression fixtures in command-detect.bats and
-# P272 sibling fixtures in itil-changeset-discipline.bats.
+# bodies. Mirrors P268 regression fixtures in command-detect.bats.
 
 @test "P275 allow: grep with literal 'git commit' pattern on drifted project does NOT deny" {
   make_drifted_project
@@ -316,7 +282,7 @@ EOF
   run run_bash_hook "GIT_AUTHOR_NAME=foo git commit -m 'feat'"
   [ "$status" -eq 0 ]
   [[ "$output" == *"\"permissionDecision\": \"deny\""* ]]
-  [[ "$output" == *"P159"* ]]
+  [[ "$output" == *"P294"* ]]
 }
 
 @test "P275 deny: cd-prefixed git commit on drifted project still triggers deny" {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windyroad/retrospective",
-  "version": "0.20.4",
+  "version": "0.21.0-preview.387",
   "description": "Session retrospectives that update briefings and create problem tickets",
   "bin": {
     "windyroad-retrospective": "./bin/install.mjs"

package/scripts/check-readme-jtbd-currency.sh

@@ -1,57 +1,64 @@
 #!/usr/bin/env bash
 # packages/retrospective/scripts/check-readme-jtbd-currency.sh
 #
-# Diagnose-only advisory script for ADR-051 (JTBD-anchored README rule).
-# Walks packages/*/README.md and emits a drift signal per package:
+# Diagnose-only advisory script for ADR-069 (README markets the persona's
+# problem; skill-inventory currency gate). Walks packages/*/README.md and
+# emits a skill-inventory-drift signal per package:
 #
-#   - has_jtbd_anchor=<yes|no>     — at least one JTBD-\d{3} match in the README
-#   - cited_jobs=<count>           — count of distinct JTBD IDs cited
-#   - known_jobs=<count>           — count of cited IDs that resolve to a current
-#                                    docs/jtbd/<persona>/JTBD-NNN-*.md (any status)
-#   - drift_hints=<comma-list>     — signal vocabulary:
-#         missing-jtbd-section     (no JTBD-\d{3} at all)
-#         stale-jtbd-citation      (cited ID has no resolving file)
-#         deprecated-jtbd-citation (cited ID resolves only to .deprecated.md / .superseded.md)
-#         skill-inventory-drift    (a directory under packages/<plugin>/skills/ is not named in README)
+#   - skills=<count>        — directories under packages/<plugin>/skills/
+#   - in_readme=<count>     — those skill directories named in the README
+#   - drift_hints=<csv>     — signal vocabulary (inventory-only):
+#         skill-inventory-drift  (a directory under packages/<plugin>/skills/
+#                                 is not named in the README)
 #
 # Plus a trailing TOTAL line summarising the window:
-#   TOTAL packages=<N> with_jtbd=<M> drift_instances=<K>
+#   TOTAL packages=<N> drift_instances=<K>
 #
-# Exit code is always 0 — the script is advisory per ADR-013 Rule 6
-# fail-safe / ADR-040 declarative-first / ADR-051 Phase 1.
-# Drift count is emitted as data on stdout; downstream consumers
-# (run-retro Step 2b future wiring, release-pre-flight habit, Phase 2
-# escalation per ADR-051 Phase 2 criterion) decide whether to act.
+# Exit code is always 0 — the script is advisory; the commit-hook
+# (retrospective-readme-jtbd-currency.sh) reads drift_instances and decides
+# whether to deny. drift_instances counts packages with a non-empty
+# drift_hints set.
+#
+# HISTORY / NAME-RETENTION: this script formerly enforced ADR-051's
+# JTBD-ID-citation rule (grep for JTBD-\d{3}, resolve against docs/jtbd/).
+# ADR-069 (P294) superseded ADR-051: plugin READMEs market to the persona's
+# problem derived FROM the JTBD, but MUST NOT cite JTBD IDs. The JTBD-ID
+# anchor + its docs/jtbd/ resolution are removed; the mechanical
+# skill-inventory-drift signal (ADR-051's original P152 empirical core)
+# survives as the load-bearing currency gate. The `jtbd-currency` filename
+# is retained deliberately per ADR-069 — a rename would ripple into mutable
+# ADRs 054/055/057 + the ADR-049 bin-grammar three-touch tax for a filename
+# adopters rarely see. A clean rename is deferred to a future
+# check-*-currency.sh family consolidation (ADR-069 Reassessment Criteria).
 #
 # Usage:
-#   check-readme-jtbd-currency.sh [<packages-dir>] [<jtbd-dir>]
+#   check-readme-jtbd-currency.sh [<packages-dir>]
 #
 # Defaults:
 #   <packages-dir> = ./packages
-#   <jtbd-dir>     = ./docs/jtbd
+#
+# A second argument (formerly <jtbd-dir>) is accepted and ignored for
+# backward compatibility with pre-ADR-069 callers.
 #
 # Exit codes:
 #   0 = always (advisory only — count is signal, not failure)
-#   2 = parse error (packages-dir or jtbd-dir missing or unreadable)
+#   2 = parse error (packages-dir missing or unreadable)
 #
 # Output format (one line per package, alphabetical):
-#   README package=<name> has_jtbd_anchor=<yes|no> cited_jobs=<N> known_jobs=<M> drift_hints=<csv>
+#   README package=<name> skills=<N> in_readme=<M> drift_hints=<csv>
 #
-# @problem P152 (No pressure or nudge for documentation currency — the driver problem)
-# @adr ADR-051 (JTBD-anchored README with declarative drift advisory — this script's normative source)
-# @adr ADR-008 (JTBD directory structure — the resolution target layout)
+# @problem P152 (No pressure or nudge for documentation currency — the original driver)
+# @problem P294 (ADR-051 superseded — README markets the persona's problem, no JTBD-ID citation)
+# @adr ADR-069 (README markets persona problem; skill-inventory currency gate — this script's normative source)
+# @adr ADR-051 (superseded — original JTBD-anchored README rule this script no longer enforces)
 # @adr ADR-013 Rule 6 (non-interactive fail-safe — advisory script never blocks AFK)
 # @adr ADR-040 (declarative-first / advisory-then-escalate precedent)
 # @adr ADR-049 (bin/-on-PATH script resolution — paired wr-retrospective-check-readme-jtbd-currency shim)
-# @adr ADR-005 / ADR-037 (Plugin testing strategy — behavioural tests via bats)
-# @jtbd JTBD-302 (Trust That the README Describes the Plugin I Just Installed — primary served job)
-# @jtbd JTBD-007 (Keep Plugins Current Across Projects — currency expansion)
-# @jtbd JTBD-101 (Extend the Suite with New Plugins — clear patterns the detector documents)
+# @adr ADR-052 / P081 (behavioural tests via bats; no structural-grep on this source)
 
 set -uo pipefail
 
 PACKAGES_DIR="${1:-packages}"
-JTBD_DIR="${2:-docs/jtbd}"
 
 # ── Pre-checks ──────────────────────────────────────────────────────────────
 
@@ -60,34 +67,6 @@ if [ ! -d "$PACKAGES_DIR" ]; then
   exit 2
 fi
 
-if [ ! -d "$JTBD_DIR" ]; then
-  echo "check-readme-jtbd-currency: jtbd dir not found: $JTBD_DIR" >&2
-  exit 2
-fi
-
-# ── Build the JTBD index ────────────────────────────────────────────────────
-# Map JTBD-NNN -> comma-separated status suffixes (proposed|validated|deprecated|superseded)
-# A JTBD ID may resolve to multiple files (e.g. during a status transition);
-# we record ALL status suffixes per ID for downstream use.
-
-declare -A JTBD_STATUS_BY_ID
-declare -A JTBD_RESOLVED
-
-for jpath in "$JTBD_DIR"/*/JTBD-*.md; do
-  [ -e "$jpath" ] || continue
-  base="$(basename "$jpath")"
-  if [[ "$base" =~ ^(JTBD-[0-9]{3})-.*\.([a-z]+)\.md$ ]]; then
-    id="${BASH_REMATCH[1]}"
-    status="${BASH_REMATCH[2]}"
-    JTBD_RESOLVED["$id"]=1
-    if [ -z "${JTBD_STATUS_BY_ID[$id]:-}" ]; then
-      JTBD_STATUS_BY_ID["$id"]="$status"
-    else
-      JTBD_STATUS_BY_ID["$id"]="${JTBD_STATUS_BY_ID[$id]},$status"
-    fi
-  fi
-done
-
 # ── Helpers ─────────────────────────────────────────────────────────────────
 
 append_hint() {
@@ -102,22 +81,9 @@ append_hint() {
   fi
 }
 
-is_deprecated_only() {
-  local statuses="$1"
-  IFS=',' read -ra arr <<< "$statuses"
-  for s in "${arr[@]}"; do
-    case "$s" in
-      deprecated|superseded) ;;
-      *) return 1 ;;
-    esac
-  done
-  return 0
-}
-
 # ── Scan packages ───────────────────────────────────────────────────────────
 
 total_packages=0
-total_with_jtbd=0
 total_drift_instances=0
 
 package_dirs=()
@@ -142,52 +108,21 @@ for pdir in "${sorted_dirs[@]}"; do
 
   total_packages=$(( total_packages + 1 ))
 
-  # Extract distinct JTBD-NNN matches from the README
-  cited_ids=()
-  while IFS= read -r id; do
-    [ -z "$id" ] && continue
-    cited_ids+=("$id")
-  done < <(grep -oE 'JTBD-[0-9]{3}' "$readme" 2>/dev/null | sort -u)
-
-  cited_count="${#cited_ids[@]}"
-
-  has_anchor="no"
-  if [ "$cited_count" -gt 0 ]; then
-    has_anchor="yes"
-    total_with_jtbd=$(( total_with_jtbd + 1 ))
-  fi
-
   hints=""
-  known_count=0
-
-  if [ "$cited_count" -eq 0 ]; then
-    hints=$(append_hint "$hints" "missing-jtbd-section")
-  else
-    has_stale=0
-    has_deprecated_only=0
-    for id in "${cited_ids[@]}"; do
-      if [ -n "${JTBD_RESOLVED[$id]:-}" ]; then
-        known_count=$(( known_count + 1 ))
-        if is_deprecated_only "${JTBD_STATUS_BY_ID[$id]}"; then
-          has_deprecated_only=1
-        fi
-      else
-        has_stale=1
-      fi
-    done
-    [ "$has_stale" -eq 1 ] && hints=$(append_hint "$hints" "stale-jtbd-citation")
-    [ "$has_deprecated_only" -eq 1 ] && hints=$(append_hint "$hints" "deprecated-jtbd-citation")
-  fi
+  skills_count=0
+  in_readme_count=0
 
-  # Soft heuristic: skill inventory drift — every directory under
-  # packages/<plugin>/skills/ should be named in the README.
+  # Skill inventory drift: every directory under packages/<plugin>/skills/
+  # should be named in the README so the inventory stays current.
   if [ -d "$pdir/skills" ]; then
     for sdir in "$pdir/skills"/*/; do
       [ -d "$sdir" ] || continue
       skill="$(basename "$sdir")"
-      if ! grep -q -F "$skill" "$readme" 2>/dev/null; then
+      skills_count=$(( skills_count + 1 ))
+      if grep -q -F "$skill" "$readme" 2>/dev/null; then
+        in_readme_count=$(( in_readme_count + 1 ))
+      else
         hints=$(append_hint "$hints" "skill-inventory-drift")
-        break
       fi
     done
   fi
@@ -197,11 +132,11 @@ for pdir in "${sorted_dirs[@]}"; do
     total_drift_instances=$(( total_drift_instances + 1 ))
   fi
 
-  echo "README package=$package has_jtbd_anchor=$has_anchor cited_jobs=$cited_count known_jobs=$known_count drift_hints=$hints"
+  echo "README package=$package skills=$skills_count in_readme=$in_readme_count drift_hints=$hints"
 done
 
 if [ "$total_packages" -gt 0 ]; then
-  echo "TOTAL packages=$total_packages with_jtbd=$total_with_jtbd drift_instances=$total_drift_instances"
+  echo "TOTAL packages=$total_packages drift_instances=$total_drift_instances"
 fi
 
 exit 0

package/scripts/test/check-readme-jtbd-currency.bats

@@ -2,37 +2,36 @@
 #
 # packages/retrospective/scripts/test/check-readme-jtbd-currency.bats
 #
-# Behavioural tests for `check-readme-jtbd-currency.sh` — the JTBD-anchored
-# README drift advisory (ADR-051 / P152 Phase 1). Mirrors the fixture-based
-# pattern of sibling detectors (`check-tickets-deferred-cause.bats`,
-# `check-briefing-budgets.bats`, `check-ask-hygiene.bats`).
+# Behavioural tests for `check-readme-jtbd-currency.sh` — the skill-inventory
+# README currency advisory (ADR-069 / P294, superseding ADR-051's JTBD-ID
+# rule). Mirrors the fixture-based pattern of sibling detectors
+# (`check-briefing-budgets.bats`, `check-ask-hygiene.bats`).
 #
-# Tests are behavioural per ADR-005 / ADR-037 / P081 — they exercise the
-# script end-to-end against fixture packages/ + docs/jtbd/ trees and assert
-# on stdout / exit code shape. No structural greps of the script source.
+# Tests are behavioural per ADR-005 / ADR-052 / P081 — they exercise the
+# script end-to-end against fixture packages/ trees and assert on stdout /
+# exit code shape. No structural greps of the script source.
 #
-# @problem P152 (No pressure or nudge for documentation currency)
+# @problem P152 (No pressure or nudge for documentation currency — original driver)
+# @problem P294 (ADR-051 superseded — README markets the persona's problem, no JTBD-ID citation)
 # @problem P081 (Structural-content tests are wasteful — behavioural preferred)
-# @adr ADR-051 (JTBD-anchored README rule with declarative drift advisory)
+# @adr ADR-069 (README markets persona problem; skill-inventory currency gate)
+# @adr ADR-051 (superseded — original JTBD-anchored README rule)
 # @adr ADR-013 Rule 6 (non-interactive fail-safe)
-# @adr ADR-005 / ADR-037 (Plugin testing strategy — behavioural tests)
-# @jtbd JTBD-302 (Trust That the README Describes the Plugin I Just Installed)
-# @jtbd JTBD-007 (Keep Plugins Current Across Projects — currency expansion)
+# @adr ADR-005 / ADR-052 (Plugin testing strategy — behavioural tests)
 
 SCRIPT="${BATS_TEST_DIRNAME}/../check-readme-jtbd-currency.sh"
 
 setup() {
   TEST_DIR="$(mktemp -d)"
   PKG_DIR="$TEST_DIR/packages"
-  JTBD_DIR="$TEST_DIR/docs/jtbd"
-  mkdir -p "$PKG_DIR" "$JTBD_DIR/plugin-user" "$JTBD_DIR/solo-developer"
+  mkdir -p "$PKG_DIR"
 }
 
 teardown() {
   rm -rf "$TEST_DIR"
 }
 
-# Helper: write a synthetic plugin layout into PKG_DIR
+# Helper: write a synthetic plugin README into PKG_DIR
 make_plugin() {
   local name="$1"
   local readme_content="$2"
@@ -40,25 +39,6 @@ make_plugin() {
   printf '%s\n' "$readme_content" > "$PKG_DIR/$name/README.md"
 }
 
-# Helper: write a synthetic JTBD job file into JTBD_DIR
-make_jtbd() {
-  local persona="$1"
-  local id="$2"
-  local slug="$3"
-  local status="$4"
-  mkdir -p "$JTBD_DIR/$persona"
-  cat > "$JTBD_DIR/$persona/$id-$slug.$status.md" <<EOF
----
-status: $status
-job-id: $slug
-persona: $persona
-date-created: 2026-05-03
----
-
-# $id: stub job for fixture
-EOF
-}
-
 # ── Pre-checks ──────────────────────────────────────────────────────────────
 
 @test "script file exists and is executable" {
@@ -67,149 +47,117 @@ EOF
 }
 
 @test "missing packages dir exits 2 with error message on stderr" {
-  run bash "$SCRIPT" "$TEST_DIR/does-not-exist" "$JTBD_DIR"
+  run bash "$SCRIPT" "$TEST_DIR/does-not-exist"
   [ "$status" -eq 2 ]
   [[ "$output" == *"packages dir not found"* ]]
 }
 
-@test "missing jtbd dir exits 2 with error message on stderr" {
-  run bash "$SCRIPT" "$PKG_DIR" "$TEST_DIR/does-not-exist"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"jtbd dir not found"* ]]
-}
-
 @test "empty packages dir exits 0 with empty stdout" {
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
   [ -z "$output" ]
 }
 
-# ── Drift fixture: README has no JTBD citation ──────────────────────────────
-
-@test "drift fixture: README with no JTBD-NNN cite emits has_jtbd_anchor=no + missing-jtbd-section drift hint" {
-  make_plugin "stub" "# @windyroad/stub
-This README documents nothing about JTBD."
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
-
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"package=stub"* ]]
-  [[ "$output" == *"has_jtbd_anchor=no"* ]]
-  [[ "$output" == *"cited_jobs=0"* ]]
-  [[ "$output" == *"drift_hints="*"missing-jtbd-section"* ]]
-  [[ "$output" == *"TOTAL packages=1 with_jtbd=0 drift_instances=1"* ]]
-}
-
-# ── Clean fixture: README cites a current JTBD ID ───────────────────────────
-
-@test "clean fixture: README citing a resolving JTBD-NNN emits has_jtbd_anchor=yes with empty drift_hints" {
+@test "legacy second argument (former jtbd-dir) is accepted and ignored" {
   make_plugin "stub" "# @windyroad/stub
-This plugin serves JTBD-302 and JTBD-007."
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
-  make_jtbd "solo-developer" "JTBD-007" "keep-plugins-current" "proposed"
-
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+A plugin that solves a problem."
+  run bash "$SCRIPT" "$PKG_DIR" "/some/legacy/jtbd/path"
   [ "$status" -eq 0 ]
   [[ "$output" == *"package=stub"* ]]
-  [[ "$output" == *"has_jtbd_anchor=yes"* ]]
-  [[ "$output" == *"cited_jobs=2"* ]]
-  [[ "$output" == *"known_jobs=2"* ]]
-  [[ "$output" == *"drift_hints="$'\n'* || "$output" == *"drift_hints= "* || "$output" == *"drift_hints="*$'\n'* ]]
-  [[ "$output" == *"TOTAL packages=1 with_jtbd=1 drift_instances=0"* ]]
+  [[ "$output" == *"TOTAL packages=1 drift_instances=0"* ]]
 }
 
-# ── Stale-ID fixture: cited JTBD does not resolve ───────────────────────────
+# ── Drift fixture: skills/ directory not named in README ────────────────────
 
-@test "stale-ID fixture: README citing JTBD-NNN with no resolving file emits stale-jtbd-citation hint" {
-  make_plugin "stub" "# @windyroad/stub
-This plugin serves JTBD-999 (which doesn't exist)."
-  # No JTBD-999 file; only JTBD-302 exists in the fixture
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
+@test "drift fixture: skills/ directory not named in README emits skill-inventory-drift" {
+  mkdir -p "$PKG_DIR/stub/skills/orphan-widget"
+  printf '%s\n' "# @windyroad/stub
+This README documents no skills." > "$PKG_DIR/stub/README.md"
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
   [[ "$output" == *"package=stub"* ]]
-  [[ "$output" == *"has_jtbd_anchor=yes"* ]]
-  [[ "$output" == *"cited_jobs=1"* ]]
-  [[ "$output" == *"known_jobs=0"* ]]
-  [[ "$output" == *"stale-jtbd-citation"* ]]
-  [[ "$output" == *"TOTAL packages=1 with_jtbd=1 drift_instances=1"* ]]
+  [[ "$output" == *"skills=1"* ]]
+  [[ "$output" == *"in_readme=0"* ]]
+  [[ "$output" == *"drift_hints="*"skill-inventory-drift"* ]]
+  [[ "$output" == *"TOTAL packages=1 drift_instances=1"* ]]
 }
 
-# ── Deprecated-only fixture: cited JTBD resolves only to deprecated ─────────
+# ── Clean fixture: every skill named in README ──────────────────────────────
 
-@test "deprecated-only fixture: cited JTBD resolves to .deprecated.md emits deprecated-jtbd-citation hint" {
-  make_plugin "stub" "# @windyroad/stub
-This plugin serves JTBD-888."
-  make_jtbd "plugin-user" "JTBD-888" "old-job" "deprecated"
+@test "clean fixture: all skills/ directories named in README emit empty drift_hints" {
+  mkdir -p "$PKG_DIR/stub/skills/manage-secret"
+  printf '%s\n' "# @windyroad/stub
+Run /wr-stub:manage-secret to rotate a secret." > "$PKG_DIR/stub/README.md"
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
   [[ "$output" == *"package=stub"* ]]
-  [[ "$output" == *"has_jtbd_anchor=yes"* ]]
-  [[ "$output" == *"cited_jobs=1"* ]]
-  [[ "$output" == *"known_jobs=1"* ]]
-  [[ "$output" == *"deprecated-jtbd-citation"* ]]
-  [[ "$output" == *"drift_instances=1"* ]]
+  [[ "$output" == *"skills=1"* ]]
+  [[ "$output" == *"in_readme=1"* ]]
+  [[ "$output" != *"skill-inventory-drift"* ]]
+  [[ "$output" == *"TOTAL packages=1 drift_instances=0"* ]]
 }
 
-# ── Skill-inventory-drift fixture ───────────────────────────────────────────
+# ── Regression guard: a JTBD-NNN citation must NOT change the verdict ────────
+# (ADR-069 removed the JTBD-ID rule; the detector no longer reads JTBD IDs.)
 
-@test "skill-inventory-drift fixture: skills/ directory not named in README emits skill-inventory-drift hint" {
-  mkdir -p "$PKG_DIR/stub/skills/orphan-widget"
+@test "regression: README with NO JTBD-NNN citation is clean when its skills are named" {
+  mkdir -p "$PKG_DIR/stub/skills/do-thing"
   printf '%s\n' "# @windyroad/stub
-This plugin serves JTBD-302." > "$PKG_DIR/stub/README.md"
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
+Markets a problem in plain prose. Run /wr-stub:do-thing. No JTBD IDs here." > "$PKG_DIR/stub/README.md"
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
-  [[ "$output" == *"package=stub"* ]]
-  [[ "$output" == *"skill-inventory-drift"* ]]
-  [[ "$output" == *"drift_instances=1"* ]]
+  [[ "$output" != *"missing-jtbd-section"* ]]
+  [[ "$output" != *"stale-jtbd-citation"* ]]
+  [[ "$output" == *"TOTAL packages=1 drift_instances=0"* ]]
 }
 
-@test "skill-inventory-drift NOT flagged when skills/ directories are all named in README" {
-  mkdir -p "$PKG_DIR/stub/skills/manage-secret"
-  printf '%s\n' "# @windyroad/stub
-This plugin serves JTBD-302 via the manage-secret skill." > "$PKG_DIR/stub/README.md"
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
+# ── Package with no skills/ directory ───────────────────────────────────────
+
+@test "package without a skills/ directory reports skills=0 and no drift" {
+  make_plugin "umbrella" "# @windyroad/umbrella
+A marketplace package with no skills of its own."
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
-  [[ "$output" == *"package=stub"* ]]
+  [[ "$output" == *"package=umbrella"* ]]
+  [[ "$output" == *"skills=0"* ]]
+  [[ "$output" == *"in_readme=0"* ]]
   [[ "$output" != *"skill-inventory-drift"* ]]
 }
 
 # ── Multi-package aggregation ───────────────────────────────────────────────
 
 @test "multi-package aggregation: emits one README line per package + TOTAL summary" {
-  make_plugin "alpha" "# alpha
-Serves JTBD-302."
-  make_plugin "bravo" "# bravo
-No anchor here."
+  mkdir -p "$PKG_DIR/alpha/skills/run-alpha"
+  printf '%s\n' "# alpha
+Run /wr-alpha:run-alpha." > "$PKG_DIR/alpha/README.md"
+  mkdir -p "$PKG_DIR/bravo/skills/lost-skill"
+  printf '%s\n' "# bravo
+README forgot to mention its skill." > "$PKG_DIR/bravo/README.md"
   make_plugin "charlie" "# charlie
-Serves JTBD-302 and JTBD-007."
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
-  make_jtbd "solo-developer" "JTBD-007" "keep-plugins-current" "proposed"
+No skills directory at all."
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
   [[ "$output" == *"package=alpha"* ]]
   [[ "$output" == *"package=bravo"* ]]
   [[ "$output" == *"package=charlie"* ]]
-  # bravo has missing-jtbd-section, alpha + charlie are clean
-  [[ "$output" == *"TOTAL packages=3 with_jtbd=2 drift_instances=1"* ]]
+  # only bravo drifts (lost-skill not named)
+  [[ "$output" == *"TOTAL packages=3 drift_instances=1"* ]]
 }
 
 # ── Package without README is skipped ───────────────────────────────────────
 
 @test "package without README.md is silently skipped" {
-  mkdir -p "$PKG_DIR/no-readme"
-  make_plugin "with-readme" "# with-readme
-Serves JTBD-302."
-  make_jtbd "plugin-user" "JTBD-302" "trust-readme" "proposed"
+  mkdir -p "$PKG_DIR/no-readme/skills/x"
+  mkdir -p "$PKG_DIR/with-readme/skills/y"
+  printf '%s\n' "# with-readme
+Run /wr-with-readme:y." > "$PKG_DIR/with-readme/README.md"
 
-  run bash "$SCRIPT" "$PKG_DIR" "$JTBD_DIR"
+  run bash "$SCRIPT" "$PKG_DIR"
   [ "$status" -eq 0 ]
   [[ "$output" != *"package=no-readme"* ]]
   [[ "$output" == *"package=with-readme"* ]]

package/skills/run-retro/SKILL.md

@@ -159,22 +159,22 @@ The shape mirrors P068's Step 4a Verification-close housekeeping: glob / evidenc
 
 6. **Non-interactive / AFK fallback (ADR-013 Rule 6)**: when `AskUserQuestion` is unavailable (autonomous retro, batch session-wrap), do NOT auto-create tickets — record each detection in the retro summary's new **Pipeline Instability** section with its category, citations, and dedup status (`new` or `matches P<NNN>`). The user reviews on return and runs `/wr-itil:manage-problem` per accepted detection. Same trust-boundary shape as Step 4a's AFK deferral: surface the evidence, defer the decision. This matches the user's documented preference (feedback_verify_from_own_observation.md memory): surface observations from the agent's own in-session activity, but ticket-creation decisions remain user-confirmed.
 
-**JTBD currency advisory (ADR-051 Phase 1, P158).** Beyond the categorical pipeline-instability detection above, Step 2b also runs the ADR-051 Phase 1 advisory detector on every retro to surface README-content drift between the suite's plugin READMEs and the documented JTBD jobs they cite. Drift here is not pipeline-instability in the conventional sense — it is content-currency — but the surfacing channel is the same: the retro summary's Pipeline Instability section. Wiring deferred from the original ADR-051 landing per Confirmation criterion 5 ("wiring into `/wr-retrospective:run-retro` Step 2b is deferred to a follow-on iter once the detector is empirically validated against current READMEs"); the empirical-validation precondition was met by commit `8df1692` (the retroactive refresh of 12 plugin READMEs to JTBD-anchored shape; detector now reports `drift_instances=1`).
+**README inventory currency advisory (ADR-069, P294).** Beyond the categorical pipeline-instability detection above, Step 2b also runs the README inventory-currency detector on every retro to surface drift between each plugin's shipped skills and the skills its README names. (Under superseded ADR-051 this detector also flagged JTBD-ID-citation drift; ADR-069 superseded that — READMEs market the persona's problem derived FROM the JTBD but MUST NOT cite IDs — so the detector is now skill-inventory-only.) The surfacing channel is the retro summary's Pipeline Instability section.
 
-**Mechanism**: invoke `wr-retrospective-check-readme-jtbd-currency` (resolves on `$PATH` to `packages/retrospective/scripts/check-readme-jtbd-currency.sh` per ADR-049 naming grammar). The script walks `packages/*/README.md`, greps each for `JTBD-\d{3}` citations, resolves cited IDs against `docs/jtbd/<persona>/JTBD-NNN-*.md` (any status suffix), and emits:
+**Mechanism**: invoke `wr-retrospective-check-readme-jtbd-currency` (resolves on `$PATH` to `packages/retrospective/scripts/check-readme-jtbd-currency.sh` per ADR-049 naming grammar; filename retained per ADR-069). The script walks `packages/*/README.md` and, for each, checks that every directory under `packages/<plugin>/skills/` is named in the README, emitting:
 
-- Per-package: `README package=<name> has_jtbd_anchor=<yes|no> cited_jobs=<N> known_jobs=<M> drift_hints=<csv>`
-- Trailing summary: `TOTAL packages=<N> with_jtbd=<M> drift_instances=<K>`
+- Per-package: `README package=<name> skills=<N> in_readme=<M> drift_hints=<csv>`
+- Trailing summary: `TOTAL packages=<N> drift_instances=<K>`
 
-Drift-hint vocabulary: `missing-jtbd-section`, `stale-jtbd-citation`, `deprecated-jtbd-citation`, `skill-inventory-drift`. Always exits 0 — the script is advisory per ADR-013 Rule 6 / ADR-040 declarative-first / ADR-051 Phase 1.
+Drift-hint vocabulary: `skill-inventory-drift` (inventory-only per ADR-069). Always exits 0 — the script is advisory per ADR-013 Rule 6 / ADR-040 declarative-first; the commit-hook `retrospective-readme-jtbd-currency.sh` is the load-bearing surface.
 
 **Interpretation**:
 
-1. **`drift_instances == 0`** — emit a one-line `JTBD currency advisory: clean (<N> packages)` to the retro summary's Pipeline Instability section.
+1. **`drift_instances == 0`** — emit a one-line `README inventory currency: clean (<N> packages)` to the retro summary's Pipeline Instability section.
 2. **`drift_instances ≥ 1`** — emit the detector's full per-package output as a fenced code block in the Pipeline Instability section. Each affected package's `drift_hints` enumerate the specific findings. Per ADR-013 Rule 6, the user reviews on return and tickets via `/wr-itil:manage-problem` per accepted finding (same trust-boundary shape as the categorical detection above — surface the evidence; defer the ticket-creation decision).
 3. **Detector failure** — if the detector exits non-zero (parse error, missing `packages/` or `docs/jtbd/` directories, runtime exception), log the failure inline as `JTBD currency advisory failed: <stderr>` but do NOT halt the retro. Same fail-open contract as Step 3's `check-briefing-budgets.sh` defensive trip — the cheap layer trips silently and degrades to a one-line pointer rather than blocking the retro.
 
-**Phase 2 escalation criterion (per ADR-051)**: if the detector emits `drift_instances ≥ 2` across 3 consecutive `chore: version packages` releases without correction, escalate to a load-bearing hook per ADR-013 Rule 6 escalation pattern. Phase 2 is out of scope for this wiring; the criterion is captured here so future contributors know the bar.
+**Already load-bearing (ADR-069)**: the commit-hook `retrospective-readme-jtbd-currency.sh` denies `git commit` when `drift_instances ≥ 1` (skill-inventory-drift), per the carried-forward load-bearing-from-the-start-for-drift-class driver. This Step 2b advisory is the backup / cross-cutting surface — it catches drift in sessions that bypass the commit-hook (`BYPASS_JTBD_CURRENCY=1`) and summarises across packages; it is not the gate.
 
 **Interaction with other surfaces:**