@windyroad/itil 1.2.0 → 2.0.0-preview.1111

package/scripts/reconcile-stories.sh

@@ -22,12 +22,12 @@
 #   2 = parse error (README missing or malformed)
 #
 # Output format on drift (one line per drift entry, ≤ 150 bytes per
-# ADR-038 progressive-disclosure budget):
+# progressive-disclosure-once-per-session-budget-for-userpromptsubmit-governance-prose-architecture-rule progressive-disclosure budget):
 #   DRIFT    STORY-<NNN> rankings: claims=<status> actual=<status>
 #   STALE    STORY-<NNN> rankings: actual=<status>
 #   MISMATCH STORY-<NNN> done: actual=<status>
 #
-# Reverse-trace pass (P170 Phase 2 Slice 9 — closes ADR-060 line 270):
+# Reverse-trace pass (problem-tickets-strain-as-fixes-decompose-into-multiple-coordinated-changes-need-an-rfc-framework-that-ties-all-changes-back-to-problems-and-unifies-technical-with-user-business-problems-problem Phase 2 Slice 9 — closes problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule line 270):
 # When <problems-dir> / <rfcs-dir> / <jtbd-dir> are provided AND on
 # disk, the reconciler also checks the auto-maintained `## Stories`
 # section on each parent artefact against the story frontmatter's
@@ -45,29 +45,29 @@
 #     filesystem subdir is <Y>. Status-column refresh contract was missed.
 #
 # Read-only — does NOT mutate the README. The /wr-itil:manage-story skill
-# (P170 Phase 2 Slice 8) applies edits with narrative-aware preservation;
+# (problem-tickets-strain-as-fixes-decompose-into-multiple-coordinated-changes-need-an-rfc-framework-that-ties-all-changes-back-to-problems-and-unifies-technical-with-user-business-problems-problem Phase 2 Slice 8) applies edits with narrative-aware preservation;
 # this script's only job is to report ground truth.
 #
-# Sibling to packages/itil/scripts/reconcile-rfcs.sh (ADR-060 Phase 1
-# item 5) and reconcile-readme.sh (P118 / ADR-014): same parse + diff
+# Sibling to packages/itil/scripts/reconcile-rfcs.sh (problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule Phase 1
+# item 5) and reconcile-readme.sh (docs-problems-readme-md-drifts-from-filesystem-truth-across-sessions-despite-refresh-on-create-and-refresh-on-transition-both-closed-problem / governance-skills-commit-their-own-completed-work-architecture-rule): same parse + diff
 # structure, applied at the story tier instead of the RFC / problem
 # tier. Differences from reconcile-rfcs:
 #   - Filename pattern: <state>/STORY-NNN-*.md (5 states: draft, accepted,
 #     in-progress, done, archived) — per-state subdir layout (NOT
-#     dual-tolerant flat — story tier is post-RFC-002, native-subdir)
+#     dual-tolerant flat — story tier is post-docs-problems-flat-layout-migration-per-state-subdirs-adopter-auto-migration-release-design, native-subdir)
 #   - ID format: STORY-<NNN>
-#   - No WSJF column (I11 invariant per ADR-060 line 253)
+#   - No WSJF column (I11 invariant per problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule line 253)
 #   - Story Rankings covers draft/accepted/in-progress (story dev queue)
 #   - Done covers done (matches RFC closed semantics)
 #   - No Verification Queue (stories don't have a verifying status —
-#     done is end-of-lifecycle for stories per ADR-060)
+#     done is end-of-lifecycle for stories per problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule)
 #   - No Parked tier (stories don't have a Parked status; only Problems do)
 #
-# @problem P170
-# @adr ADR-060 (Problem-RFC-Story framework — Phase 2 amendment 2026-05-10
+# @problem problem-tickets-strain-as-fixes-decompose-into-multiple-coordinated-changes-need-an-rfc-framework-that-ties-all-changes-back-to-problems-and-unifies-technical-with-user-business-problems-problem
+# @adr problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule (Problem-RFC-Story framework — Phase 2 amendment 2026-05-10
 #                 story tier; reconcile-stories is the story-tier sibling
 #                 of reconcile-rfcs)
-# @adr ADR-049 (Plugin script resolution via bin/ on PATH — paired bin shim
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (Plugin script resolution via bin/ on PATH — paired bin shim
 #                at packages/itil/bin/wr-itil-reconcile-stories)
 
 set -uo pipefail
@@ -219,7 +219,7 @@ reverse_trace_pass() {
       esac
       pfile="${matches[0]:-}"
 
-      # ADR-103: a release row may be the RFC, so no markdown parent exists.
+      # a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule: a release row may be the RFC, so no markdown parent exists.
       # In that case the map row itself is the reverse trace and must contain
       # this story. Query the canonical map island rather than scraping HTML.
       if [ "$parent_kind" = rfcs ] && [ -z "$pfile" ]; then

package/scripts/reconcile-story-maps.sh

@@ -6,11 +6,11 @@
 # files across 5 lifecycle subdirs (draft, accepted, in-progress,
 # completed, archived) and reports each disagreement against the README.
 #
-# Sibling to reconcile-stories.sh (P170 Phase 2 Slice 9) and
-# reconcile-rfcs.sh (ADR-060 Phase 1 item 5). Differences:
+# Sibling to reconcile-stories.sh (problem-tickets-strain-as-fixes-decompose-into-multiple-coordinated-changes-need-an-rfc-framework-that-ties-all-changes-back-to-problems-and-unifies-technical-with-user-business-problems-problem Phase 2 Slice 9) and
+# reconcile-rfcs.sh (problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule Phase 1 item 5). Differences:
 #   - File extension: .html (not .md)
 #   - ID format: STORY-MAP-<NNN>
-#   - No WSJF (I5 invariant per ADR-060 line 145)
+#   - No WSJF (I5 invariant per problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule line 145)
 #   - No Rankings table — story-maps are planning artefacts, not work items;
 #     README has only a single lifecycle-grouped table
 #   - 5 lifecycle subdirs (vs story tier's 5 + RFC tier's 5)
@@ -26,11 +26,11 @@
 #   1 = drift detected (structured stdout)
 #   2 = parse error (README missing or malformed)
 #
-# @problem P170
-# @adr ADR-060 (Problem-RFC-Story framework — Phase 2 amendment 2026-05-10
+# @problem problem-tickets-strain-as-fixes-decompose-into-multiple-coordinated-changes-need-an-rfc-framework-that-ties-all-changes-back-to-problems-and-unifies-technical-with-user-business-problems-problem
+# @adr problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule (Problem-RFC-Story framework — Phase 2 amendment 2026-05-10
 #                story-map tier; reconcile-story-maps is the story-map-tier
 #                sibling of reconcile-stories + reconcile-rfcs)
-# @adr ADR-049 (Plugin-bundled scripts via bin/ on PATH — paired bin shim
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (Plugin-bundled scripts via bin/ on PATH — paired bin shim
 #                at packages/itil/bin/wr-itil-reconcile-story-maps)
 
 set -uo pipefail

package/scripts/render-story-map.mjs

@@ -27,10 +27,10 @@
 // there is no seed file, no bootstrap flag, and no second code path to keep
 // in step with the first.
 //
-// @adr ADR-102 (story maps render from JSON through a canonical template)
-// @adr ADR-060 (Problem-RFC-Story framework — Phase 2 encoding, amended)
-// @adr ADR-103 (story cards single-line — a readability convention now, not a
-//      correctness constraint: ADR-101's whole-line filter that made it
+// @adr story-maps-render-from-json-through-a-canonical-template-architecture-rule (story maps render from JSON through a canonical template)
+// @adr problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule (Problem-RFC-Story framework — Phase 2 encoding, amended)
+// @adr a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule (story cards single-line — a readability convention now, not a
+//      correctness constraint: an-afk-loop-may-accept-and-implement-a-story-that-only-decomposes-already-ratified-substance-architecture-rule's whole-line filter that made it
 //      load-bearing is retired, and cards sit outside the fingerprint basis)
 
 import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'node:fs';
@@ -134,7 +134,7 @@ function resolveStoryProblems(storiesDir, storyId) {
  *  Derived, never stored on the card — the fifth application of the same rule
  *  that removed storyStatus, card titles, the RFC story list and row status. A
  *  hand-written card value duplicates the story and degrades it: every one on
- *  STORY-MAP-002 had drifted into a "Value: ..." paraphrase while the stories
+ *  take-a-problem-from-noticed-to-resolved-journey-map-journey-map had drifted into a "Value: ..." paraphrase while the stories
  *  themselves carried proper value-first statements. Deriving keeps the map
  *  showing what the story actually says.
  *
@@ -154,7 +154,7 @@ function resolveStoryValue(storiesDir, storyId) {
   if (end === -1) end = lines.length;
   // The value statement is the FIRST paragraph. Filtering blanks out of the
   // whole section glued a following paragraph onto the "I want" clause: on a
-  // phone STORY-052's card ran to 169 words, most of it the evidence prose the
+  // phone surface-still-outstanding-family-members-before-a-close-delivery-story's card ran to 169 words, most of it the evidence prose the
   // author had deliberately put below the statement. A story is free to
   // explain itself under its value; the card carries the statement.
   const para = [];
@@ -197,7 +197,7 @@ function splitValue(text) {
   //
   // The article is NOT required. "as whoever picks the ticket up" is the shape
   // written correctly; demanding a/an/the was a guess about wording, and the
-  // guess cost STORY-060 its three lines with nothing reporting why. Widening
+  // guess cost pick-up-a-captured-ticket-and-know-what-was-observed-delivery-story its three lines with nothing reporting why. Widening
   // does not close that class on its own — see assertValueStatementsSplit,
   // which is what makes the next unanticipated phrasing loud instead of silent.
   // The connectives are CAPTURED, not re-emitted from memory. A story written
@@ -297,11 +297,11 @@ function renderMeta(map, derived) {
   const t = map.traces ?? {};
   // `problems` and `rfcs` are DERIVED, and the read is unconditional — no
   // `?? t.problems` alternation, which would let a pre-migration island outvote
-  // the corpus and re-open the override ADR-104 forbids.
+  // the corpus and re-open the override a-story-map-card-stores-no-value-a-story-file-already-carries-architecture-rule forbids.
   //
   // The rfcs filter is load-bearing, not defensive: a row legitimately carries no
   // RFC, in two spellings — `"rfc": null` on a pre-RFC row, and no `rfc` key at
-  // all. A raw join yields ",RFC-005,…" or ",,", and `content=",,"` satisfies the
+  // all. A raw join yields ",rfc-first-trace-invariant-not-enforced-at-fix-time-release-design,…" or ",,", and `content=",,"` satisfies the
   // reverse-tracers' `content="[^"]+"` guard, so a map with no RFCs would stop
   // looking like one.
   const rfcs = [...new Set((map.releases ?? []).map((r) => r.rfc).filter(Boolean))];
@@ -335,7 +335,7 @@ function renderMeta(map, derived) {
  */
 function resolveHref(mapPath, id) {
   const docs = join(dirname(dirname(mapPath)), '..');
-  // No RFC entry, deliberately. ADR-103 made the release row the RFC, so the
+  // No RFC entry, deliberately. a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule made the release row the RFC, so the
   // 59 files under docs/rfcs/ are legacy records of delivered work. Linking one
   // sends a reader to a superseded artefact and re-teaches the two-tier model
   // this decision removed.
@@ -385,7 +385,7 @@ function resolveHref(mapPath, id) {
  *  resolves, which is the published-package case: a map opened outside a
  *  repository shows no status, no values and plain text instead of links.
  */
-/** A row's status, derived — never authored (ADR-103).
+/** A row's status, derived — never authored (a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule).
  *
  *  delivered  — every story in the row is done or archived
  *  proposed   — a problem or an RFC names the row, and it is not delivered
@@ -500,7 +500,7 @@ function renderStatus(map, storiesDir, mapPath) {
  * Rendering here costs nothing that mattered. The renderer already runs on every
  * edit (story-map-edit re-renders after each operation), it already reads the
  * story corpus for status, values and problems, and the fingerprint is scoped to
- * the data island (ADR-102) — so generated markup in the file cannot drift a
+ * the data island (story-maps-render-from-json-through-a-canonical-template-architecture-rule) — so generated markup in the file cannot drift a
  * ratification. Presentation stays de-duplicated in the shared stylesheet, which
  * is where the duplication actually was.
  *
@@ -523,10 +523,10 @@ function badgeClass(rel) {
   }
 }
 
-/** What a row is CALLED. A row IS an RFC (ADR-103), so where a problem has
+/** What a row is CALLED. A row IS an RFC (a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule), so where a problem has
  *  proposed it, its id is the label. There is deliberately no "not yet
  *  allocated" state: drawing the row is what allocates the identity. */
-/** What a row is CALLED. A row IS an RFC (ADR-103), so its id is the label.
+/** What a row is CALLED. A row IS an RFC (a-release-row-is-the-rfc-and-the-map-is-the-approval-surface-architecture-rule), so its id is the label.
  *
  *  Without one, the label says what is MISSING rather than inventing a status.
  *  Two distinct gaps, and they need different work:
@@ -539,7 +539,7 @@ function badgeClass(rel) {
  *
  *  Neither is a resting state, so neither gets a comfortable name. "Speculative"
  *  was the comfortable name, and it rendered on a row whose own header read
- *  "closes P160, P443" — the label and the trace contradicting each other.
+ *  "closes ship-quota-pacing-surface-to-prevent-weekly-quota-exhaustion-advisory-or-blocking-nudge-when-burn-rate-exceeds-sustainable-pace-so-users-retain-claude-tokens-for-non-claude-code-surfaces-chat-cowork-for-the-full-week-problem, quota-pacing-shipped-without-a-grounded-jtbd-persona-usm-rfc-story-lineage-governance-artefacts-are-wrong-orphaned-or-missing-problem" — the label and the trace contradicting each other.
  */
 function rowLabel(rel) {
   if (rel.rfc) return rel.rfc;
@@ -657,13 +657,13 @@ function parseDerived(statusBlock) {
 
 /* There is no lead paragraph. It was persona plus an observation, and both were
  * already on the page: the persona appears in every card's value statement ("as
- * a developer", 24 times on STORY-MAP-002), and any observation about the shape
+ * a developer", 24 times on take-a-problem-from-noticed-to-resolved-journey-map-journey-map), and any observation about the shape
  * of the work — how many columns, how much is live, which cells are empty — is
  * countable from the grid the reader is looking at.
  *
  * A map shows the work. Where a specific column or row needs a note, both carry
  * a `note` field for exactly that, next to the thing it is about. Prose at the
- * top that restates the picture below it is the ADR-104 rule applied to writing.
+ * top that restates the picture below it is the a-story-map-card-stores-no-value-a-story-file-already-carries-architecture-rule rule applied to writing.
  */
 
 function renderGrid(map, derived) {
@@ -757,7 +757,7 @@ function renderGrid(map, derived) {
  * its own header. It was added when problems became derived, and it duplicated
  * the thing it was derived into.
  *
- * Both are the ADR-104 rule applied to presentation rather than to data: do not
+ * Both are the a-story-map-card-stores-no-value-a-story-file-already-carries-architecture-rule rule applied to presentation rather than to data: do not
  * show in two places what one place already says. The maintainer caught this as
  * the seventh instance, introduced while fixing the sixth.
  */
@@ -773,13 +773,13 @@ function renderGrid(map, derived) {
  *  `traces.adrs`; and "open questions" was a changelog entry, not a trace.
  *
  *  Rendering the ids directly means there is no prose to keep in step. It is the
- *  ADR-104 rule again: show what is authored once, derive the rest, write
+ *  a-story-map-card-stores-no-value-a-story-file-already-carries-architecture-rule rule again: show what is authored once, derive the rest, write
  *  nothing twice.
  */
 function renderTrace(map, derived) {
   const hrefs = derived.hrefs ?? {};
   const tr = map.traces ?? {};
-  // Jobs only. `Decisions` went with `traces.adrs` (ADR-106 — a map carries no
+  // Jobs only. `Decisions` went with `traces.adrs` (a-story-map-carries-no-decision-trace-architecture-rule — a map carries no
   // decision trace). `RFCs` went too rather than being derived: it would have
   // restated the row badges immediately beside it, which is the duplication
   // deleted from the map-level problems line for the same reason.
@@ -802,12 +802,12 @@ function renderTrace(map, derived) {
  *  exist, then it shouldn't even be in the map."
  *
  *  This is also what makes an untraced row unreachable on a valid map: every
- *  card has a story, and ADR-060 I6 hard-blocks a story that traces no problem,
+ *  card has a story, and problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule I6 hard-blocks a story that traces no problem,
  *  so every row traces something.
  *
  *  Only fires when a story corpus is present. Rendering from the published
  *  package resolves nothing at all, and refusing there would reject every valid
- *  map for lacking a tree that was never there (ADR-104's degrade-gracefully
+ *  map for lacking a tree that was never there (a-story-map-card-stores-no-value-a-story-file-already-carries-architecture-rule's degrade-gracefully
  *  consequence).
  */
 /** Archived work is separated from live work.
@@ -842,7 +842,7 @@ function renderTrace(map, derived) {
  *  This is the second time the class has fired. The first cost 15 stories
  *  their three lines; the fix was to loosen the pattern, and the pattern will
  *  always be narrower than the ways people write, so the class stayed open and
- *  STORY-060 walked into it. Loosening cannot close it. Refusing can: the
+ *  pick-up-a-captured-ticket-and-know-what-was-observed-delivery-story walked into it. Loosening cannot close it. Refusing can: the
  *  renderer is the last point where anyone still knows a split was attempted.
  *
  *  Silent only when there is genuinely nothing to check — no stories tree, or
@@ -947,7 +947,7 @@ function assertEveryCardHasAStory(map, storiesDir) {
   }
   lines.push('');
   lines.push('  Fix each one: capture the story (/wr-itil:capture-story, which');
-  lines.push('  hard-blocks a story that traces no problem — ADR-060 I6), or');
+  lines.push('  hard-blocks a story that traces no problem — problem-rfc-story-framework-with-mandatory-problem-trace-and-unified-problem-ontology-architecture-rule I6), or');
   lines.push('  remove the card. A card is a story\'s position in a journey; a');
   lines.push('  card without one is a sketch, and the map should not carry it.');
   throw new Error(lines.join('\n'));

package/scripts/render-story-map.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Thin bash entry point for the story-map renderer, so the ADR-049/ADR-080
+# Thin bash entry point for the story-map renderer, so the plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule/highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule
 # shim machinery (which resolves `scripts/<NAME>.sh`) reaches the Node
 # implementation without the generator needing to learn about .mjs.
 #
@@ -8,8 +8,8 @@
 # One mode: renders a map in place from its own data island. To create a map,
 # write a file containing just the island and render it.
 #
-# @adr ADR-102 (story maps render from JSON through a canonical template)
-# @adr ADR-049 (plugin scripts resolve via bin/ on $PATH)
+# @adr story-maps-render-from-json-through-a-canonical-template-architecture-rule (story maps render from JSON through a canonical template)
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (plugin scripts resolve via bin/ on $PATH)
 
 set -euo pipefail
 exec node "$(cd "$(dirname "$0")" && pwd)/render-story-map.mjs" "$@"

package/scripts/resolve-governance-plugin-dirs.sh

@@ -2,7 +2,7 @@
 # Resolve --plugin-dir arguments for the governance plugins an AFK iter
 # subprocess needs.
 #
-# P382: headless `claude -p` loads only USER-scoped enabledPlugins, NOT
+# work-problems-claude-p-iter-subprocesses-miss-project-scoped-governance-plugins-need-plugin-dir-in-dispatch-problem: headless `claude -p` loads only USER-scoped enabledPlugins, NOT
 # project-scoped ones. When the windyroad plugins are enabled at project scope
 # (the common adopter setup), an iter subprocess dispatched by work-problems
 # Step 5 receives no windyroad agents/hooks — it commits ungated and cannot run
@@ -13,10 +13,10 @@
 # into its `claude -p` invocation.
 #
 # Resolution: each plugin's cache parent is located from its bin dir on $PATH
-# (ADR-049 bin-on-PATH precedent — present in adopter marketplace-cache trees
+# (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule bin-on-PATH precedent — present in adopter marketplace-cache trees
 # and source-dev alike), then the HIGHEST-SEMVER sibling under that cache parent
-# is selected (ADR-080 highest-version-wins). $PATH order is frozen at session
-# init and goes stale mid-session (P343 / ADR-080 / ADR-081), so it MUST NOT be
+# is selected (highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule highest-version-wins). $PATH order is frozen at session
+# init and goes stale mid-session (install-updates-refreshes-the-global-plugin-cache-but-does-not-fix-path-ordering-stale-plugin-version-shims-stay-first-on-path-so-subsequent-shim-invocations-run-old-code-problem / highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule / sessionstart-path-refresh-hook-for-plugin-cache-architecture-rule), so it MUST NOT be
 # trusted for version selection — only to discover the cache parent.
 #
 # Output: two lines per resolvable plugin — `--plugin-dir` then the plugin root
@@ -28,11 +28,11 @@
 #
 # Override the plugin set via WR_GOVERNANCE_PLUGINS (space-separated).
 #
-# @adr ADR-032 (governance skill invocation — Step 5 dispatch contract, P382 amendment)
-# @adr ADR-049 (plugin-bundled scripts resolve via bin/ on $PATH)
-# @adr ADR-080 (highest-version-wins resolution — $PATH order is not authoritative)
-# @adr ADR-052 (behavioural test — resolve-governance-plugin-dirs.bats)
-# @problem P382
+# @adr governance-skill-invocation-patterns-foreground-background-with-deferred-question-resumption-architecture-rule (governance skill invocation — Step 5 dispatch contract, work-problems-claude-p-iter-subprocesses-miss-project-scoped-governance-plugins-need-plugin-dir-in-dispatch-problem amendment)
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (plugin-bundled scripts resolve via bin/ on $PATH)
+# @adr highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule (highest-version-wins resolution — $PATH order is not authoritative)
+# @adr behavioural-tests-default-for-skill-testing-architecture-rule (behavioural test — resolve-governance-plugin-dirs.bats)
+# @problem work-problems-claude-p-iter-subprocesses-miss-project-scoped-governance-plugins-need-plugin-dir-in-dispatch-problem
 set -euo pipefail
 
 PLUGINS="${WR_GOVERNANCE_PLUGINS:-wr-architect wr-jtbd wr-risk-scorer wr-voice-tone wr-itil wr-retrospective wr-style-guide}"
@@ -54,7 +54,7 @@ for plugin in $PLUGINS; do
   done
   [ -n "$cache_parent" ] || continue
 
-  # Select the highest-semver sibling under <cache_parent> (ADR-080). PATH order
+  # Select the highest-semver sibling under <cache_parent> (highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule). PATH order
   # may name a stale version after a mid-session /install-updates, so re-resolve
   # the version here rather than reading it from the PATH entry.
   highest=""

package/scripts/run-check-deferred-placeholder-staleness.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # wr-itil — echo the deferred-placeholder + README-cadence promotion reason,
-# or empty if promotion is not warranted (P271 / P317 RFC-009 adopter-safe).
+# or empty if promotion is not warranted (wr-itil-review-problems-not-auto-fired-when-needed-user-has-to-remember-to-run-it-problem / capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design adopter-safe).
 #
 # Adopter-safe wrapper: sources the canonical lib RELATIVE TO THIS SCRIPT
 # (`$(dirname)/../lib`), then echoes the function's result on stdout (the SKILL
@@ -10,8 +10,8 @@
 # source monorepo, not adopter installs.
 #
 # SKILLs invoke this by name via the
-# `wr-itil-check-deferred-placeholder-staleness` PATH shim (ADR-049 +
-# ADR-080). Operates on the directory given as $1 (defaults to $PWD).
+# `wr-itil-check-deferred-placeholder-staleness` PATH shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule +
+# highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule). Operates on the directory given as $1 (defaults to $PWD).
 set -uo pipefail
 
 LIB="$(cd "$(dirname "${BASH_SOURCE[0]}")/../lib" 2>/dev/null && pwd)" || {

package/scripts/run-check-outbound-responses-staleness.sh

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
 # wr-itil — echo the outbound-responses-preflight promotion reason, or empty
-# if promotion is not warranted (P220 + P317/RFC-009).
+# if promotion is not warranted (manage-problem-has-no-cadence-for-checking-upstream-bound-tickets-problem + capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem/adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design).
 #
 # Adopter-safe wrapper: sources the canonical lib RELATIVE TO THIS SCRIPT
 # (`$(dirname)/../lib`), then echoes the function's result on stdout (the SKILL
 # captures it via `$(...)`). Replaces any SKILL-inline
 # `source packages/itil/lib/check-outbound-responses-staleness.sh;
 #  preflight_reason="$(should_promote_outbound_responses_preflight "$PWD")"`,
-# which only resolves in the source monorepo (P317). SKILLs invoke this by name
-# via the `wr-itil-check-outbound-responses-staleness` PATH shim (ADR-049).
+# which only resolves in the source monorepo (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem). SKILLs invoke this by name
+# via the `wr-itil-check-outbound-responses-staleness` PATH shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule).
 # Operates on the directory given as $1 (defaults to $PWD).
 set -uo pipefail
 

package/scripts/run-check-upstream-cache-staleness.sh

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
 # wr-itil — echo the inbound-discovery-preflight promotion reason, or empty if
-# promotion is not warranted (P317/RFC-009).
+# promotion is not warranted (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem/adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design).
 #
 # Adopter-safe wrapper: sources the canonical lib RELATIVE TO THIS SCRIPT
 # (`$(dirname)/../lib`), then echoes the function's result on stdout (the SKILL
 # captures it via `$(...)`). Replaces the SKILL-inline
 # `source packages/itil/lib/check-upstream-cache-staleness.sh;
 #  preflight_reason="$(should_promote_inbound_discovery_preflight "$PWD")"`,
-# which only resolved in the source monorepo (P317). SKILLs invoke this by name
-# via the `wr-itil-check-upstream-cache-staleness` PATH shim (ADR-049).
+# which only resolved in the source monorepo (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem). SKILLs invoke this by name
+# via the `wr-itil-check-upstream-cache-staleness` PATH shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule).
 # Operates on the directory given as $1 (defaults to $PWD).
 set -uo pipefail
 

package/scripts/run-enumerate-postrelease-kv-candidates.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # wr-itil — emit `KV_CANDIDATE` lines for Known Error tickets whose
 # Release-vehicle citation matches a just-shipped (deleted-from-tree)
-# changeset (P228 / P317 RFC-009 adopter-safe).
+# changeset (known-error-md-verifying-md-transition-not-happening-consistently-at-release-time-problem / capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design adopter-safe).
 #
 # Adopter-safe wrapper: sources the canonical lib RELATIVE TO THIS SCRIPT
 # (`$(dirname)/../lib`), then invokes the function. The SKILL parses the
@@ -11,8 +11,8 @@
 # the source monorepo, not adopter installs.
 #
 # SKILLs invoke this by name via the
-# `wr-itil-enumerate-postrelease-kv-candidates` PATH shim (ADR-049 +
-# ADR-080).
+# `wr-itil-enumerate-postrelease-kv-candidates` PATH shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule +
+# highest-version-wins-shim-wrapper-for-plugin-scaffold-template-shims-architecture-rule).
 #
 # Arguments (positional, all optional):
 #   $1 — problems-dir (defaults to ./docs/problems)

package/scripts/run-migrate-problems-layout.sh

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# wr-itil — run the problems-layout flat→per-state migration (P317/RFC-009).
+# wr-itil — run the problems-layout flat→per-state migration (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem/adopter-safe-path-resolution-in-shipped-skills-24-repo-relative-references-release-design).
 #
 # Adopter-safe wrapper: sources the canonical lib RELATIVE TO THIS SCRIPT
 # (`$(dirname)/../lib`), then invokes the function. Replaces the SKILL-inline
 # `source packages/itil/lib/migrate-problems-layout.sh; migrate_... "$PWD"`,
-# which only resolved in the source monorepo (P317). SKILLs invoke this by name
-# via the `wr-itil-migrate-problems-layout` PATH shim (ADR-049). The migration
+# which only resolved in the source monorepo (capture-problem-capture-rfc-manage-problem-step-2-create-gate-marker-step-sources-repo-relative-packages-itil-hooks-lib-sh-fails-in-adopter-installs-recurring-published-path-class-problem). SKILLs invoke this by name
+# via the `wr-itil-migrate-problems-layout` PATH shim (plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule). The migration
 # routine is idempotent + partial-migration-safe (no-op when no flat-layout
 # files exist). Operates on the directory given as $1 (defaults to $PWD).
 set -uo pipefail

package/scripts/skill-invocations.sh

@@ -1,15 +1,15 @@
 #!/usr/bin/env bash
 # packages/itil/scripts/skill-invocations.sh
 #
-# Phase 2a (P087) transcript-axis maturity-measurement script.
+# Phase 2a (problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem) transcript-axis maturity-measurement script.
 #
 # Reads `~/.claude/projects/**/*.jsonl` (recursive), filters to
 # `type=assistant` messages whose `message.content` array carries a
 # `tool_use` entry, tallies invocations by `Skill` / `Agent` / `Bash` per
-# ADR-058 §Script contracts, and emits one NDJSON record per surface to
+# windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Script contracts, and emits one NDJSON record per surface to
 # stdout.
 #
-# Schema (per ADR-058 line 70-82):
+# Schema (per windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 70-82):
 #   {"schema_version":"1.0","axis":"skill-invocations","surface":"<name>",
 #    "kind":"skill|agent|bash-attributed","plugin":"<name>",
 #    "window_days":<N>,"invocations":<N>,
@@ -21,19 +21,19 @@
 #                              [--category-overrides=FILE]
 #
 # Defaults:
-#   --window-days   30   (ADR-058 line 67)
+#   --window-days   30   (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 67)
 #   --root          ~/.claude/projects
 #   --project-root  $PWD   (opt-out marker location: <project-root>/.claude/.skill-metrics-opt-out)
 #
 # Exit codes:
-#   0 = always — ADR-013 Rule 6 fail-safe. Opt-out marker / inaccessible
+#   0 = always — structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 fail-safe. Opt-out marker / inaccessible
 #                root / missing data all hit the zero-records path with
 #                stderr-comment.
 #
-# Privacy (ADR-035 clauses adopted verbatim):
+# Privacy (centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule clauses adopted verbatim):
 #   - Opt-out marker `.claude/.skill-metrics-opt-out` disables reads.
 #   - No network egress — the script body invokes no exfiltration
-#     primitives. ADR-058 §Confirmation 3 enforces via negative-grep
+#     primitives. windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Confirmation 3 enforces via negative-grep
 #     on this file (banned-token list lives in the bats fixture, not
 #     here, to avoid self-matching).
 #   - Content sanitisation — only fixed-pattern surface names extracted
@@ -44,16 +44,16 @@
 #     The v1.0 schema has no path-bearing field; the hashing function is
 #     internal defence-in-depth, exercised structurally by Confirmation #4.
 #
-# @problem P087 (Phase 2a — transcript axis)
-# @adr ADR-058 (Plugin maturity measurement mechanism)
-# @adr ADR-049 (Shim grammar — bin/wr-itil-skill-invocations on $PATH)
-# @adr ADR-035 (Privacy posture adopted verbatim)
-# @adr ADR-052 (Behavioural tests default; ADR-058 §Confirmation 1-5)
-# @adr ADR-013 Rule 6 (non-interactive fail-safe — exit 0 always)
-# @adr ADR-023 (Performance — < 1.5s warm-cache; 30-day window default)
-# @jtbd JTBD-101 (Extend the Suite — hardening-prioritisation outcome,
+# @problem problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem (Phase 2a — transcript axis)
+# @adr windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule (Plugin maturity measurement mechanism)
+# @adr plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule (Shim grammar — bin/wr-itil-skill-invocations on $PATH)
+# @adr centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule (Privacy posture adopted verbatim)
+# @adr behavioural-tests-default-for-skill-testing-architecture-rule (Behavioural tests default; windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Confirmation 1-5)
+# @adr structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 (non-interactive fail-safe — exit 0 always)
+# @adr wr-architect-agent-performance-review-scope-prompt-amendment-performance-budget-adr-template-architecture-rule (Performance — < 1.5s warm-cache; 30-day window default)
+# @jtbd extend-the-suite-with-new-plugins-user-outcome (Extend the Suite — hardening-prioritisation outcome,
 #   2026-05-04 amendment serves Phase 2 NDJSON as data source)
-# @jtbd JTBD-201 (Restore Service Fast — audit-trail composition)
+# @jtbd restore-service-fast-with-an-audit-trail-user-outcome (Restore Service Fast — audit-trail composition)
 
 set -uo pipefail
 
@@ -80,7 +80,7 @@ for arg in "$@"; do
   esac
 done
 
-# ── Opt-out marker check (ADR-035 / ADR-058 §Privacy posture) ───────────────
+# ── Opt-out marker check (centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule / windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Privacy posture) ───────────────
 
 OPT_OUT_MARKER="${PROJECT_ROOT}/.claude/.skill-metrics-opt-out"
 if [ -e "$OPT_OUT_MARKER" ]; then
@@ -88,14 +88,14 @@ if [ -e "$OPT_OUT_MARKER" ]; then
   exit 0
 fi
 
-# ── Transcript root accessibility (ADR-013 Rule 6 fail-safe) ────────────────
+# ── Transcript root accessibility (structured-user-interaction-for-governance-skill-decisions-architecture-rule Rule 6 fail-safe) ────────────────
 
 if [ ! -d "$TRANSCRIPT_ROOT" ]; then
   echo "# wr-itil-skill-invocations: transcript root inaccessible at ${TRANSCRIPT_ROOT}" >&2
   exit 0
 fi
 
-# ── --category-overrides validation (ADR-058 §Per-category override hook) ───
+# ── --category-overrides validation (windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Per-category override hook) ───
 # Forward-extension flag; ships unused in Phase 2. Validated for path
 # existence; not yet consumed by the body.
 
@@ -104,7 +104,7 @@ if [ -n "$CATEGORY_OVERRIDES" ] && [ ! -f "$CATEGORY_OVERRIDES" ]; then
   exit 0
 fi
 
-# ── JSONL parse + NDJSON emit (Python 3 stdlib — ADR-058 line 127) ──────────
+# ── JSONL parse + NDJSON emit (Python 3 stdlib — windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 127) ──────────
 # Inputs pinned via environment to avoid argv leakage of secrets.
 
 export SI_TRANSCRIPT_ROOT="$TRANSCRIPT_ROOT"
@@ -121,19 +121,19 @@ window_days = int(os.environ["SI_WINDOW_DAYS"])
 now = time.time()
 cutoff = now - window_days * 86400
 
-# Bin shim grammar from ADR-049: wr-<plugin>-<kebab-script-name>.
+# Bin shim grammar from plugin-bundled-scripts-invoked-from-skill-md-resolve-via-bin-on-path-architecture-rule: wr-<plugin>-<kebab-script-name>.
 # Anchor on word boundary; allow alnum + hyphens; non-greedy plugin token
 # stops at the first hyphen so `wr-itil-reconcile-readme` attributes to
 # `itil`, not `itil-reconcile`.
 BIN_RE = re.compile(r"\bwr-([a-z0-9]+)-[a-z0-9-]+")
 
-# Phase 2e (P087) byte-seek bisect — find the earliest byte offset whose
+# Phase 2e (problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem) byte-seek bisect — find the earliest byte offset whose
 # line carries a timestamp >= cutoff, then linear-scan from there. Files
 # below the threshold linear-scan from byte 0 (bisect overhead is not
 # worth it; the ratio of bisect-seeks to in-window lines flips around
 # this size on warm-cache developer laptops per Phase 2c profile data).
 # JSONL append-only monotonicity is the input invariant — pinned in
-# ADR-058 §Performance contract Phase 2e amendment. Non-monotonic input
+# windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule §Performance contract Phase 2e amendment. Non-monotonic input
 # under-counts gracefully (bisect locates by byte position, not by
 # content scan) without crashing or emitting malformed NDJSON; pinned
 # by the "non-monotonic timestamps — graceful degradation" bats fixture.
@@ -206,7 +206,7 @@ def find_first_in_window_offset(fh, file_size, cutoff_epoch):
 def plugin_from_skill(name):
     """`wr-itil:manage-problem` -> `itil`. Non-wr-prefixed or short-form
     names like `commit`, `loop` return None (excluded from per-plugin
-    attribution per ADR-058 line 64)."""
+    attribution per windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule line 64)."""
     if not name or ":" not in name:
         return None
     prefix = name.split(":", 1)[0]
@@ -218,7 +218,7 @@ def plugin_from_agent(name):
     return plugin_from_skill(name)
 
 def hash_path(p):
-    """sha256-prefix-12hex per ADR-035 path-hashing convention. Reserved
+    """sha256-prefix-12hex per centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule path-hashing convention. Reserved
     for future schema bumps that emit path-bearing fields; not consumed
     by the v1.0 schema."""
     return hashlib.sha256(str(p).encode("utf-8")).hexdigest()[:12]
@@ -244,13 +244,13 @@ for jsonl in jsonl_iter:
     except OSError:
         continue
     with fh:
-        # Phase 2e (P087) byte-seek bisect — for files at or above the
+        # Phase 2e (problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem) byte-seek bisect — for files at or above the
         # threshold, locate the first line whose timestamp falls within
         # the cutoff window and start the linear scan from there. Files
         # below the threshold scan linearly from byte 0 (the bisect
         # overhead exceeds the savings on small files). The bisect
         # presumes JSONL append-only monotonic timestamps within a single
-        # session file — pinned as an input invariant in ADR-058
+        # session file — pinned as an input invariant in windyroad-plugin-maturity-measurement-mechanism-session-transcript-invocation-counts-plus-commit-history-composite-read-only-ndjson-architecture-rule
         # §Performance Phase 2e amendment; non-monotonic input degrades
         # gracefully via under-count, pinned by the bats "non-monotonic"
         # fixture.
@@ -261,7 +261,7 @@ for jsonl in jsonl_iter:
                 continue
             fh.seek(start_offset)
         for raw_line in fh:
-            # Phase 2d (P087) substring pre-filter — skip json.loads() on
+            # Phase 2d (problem-087-no-maturity-battle-hardening-signal-on-plugins-skills-agents-or-hooks-readmes-don-t-tell-users-which-features-are-stable-vs-experimental-problem) substring pre-filter — skip json.loads() on
             # lines that cannot possibly contribute a count. The literal
             # substring `"tool_use"` is the discriminating token: every
             # content block we count carries `"type":"tool_use"`, while
@@ -329,7 +329,7 @@ for jsonl in jsonl_iter:
                     if m:
                         # Surface is the matched bin shim token only. The
                         # surrounding command (paths, secrets, args) is
-                        # discarded — content-sanitisation per ADR-035.
+                        # discarded — content-sanitisation per centralised-review-reports-for-cross-project-skill-improvement-jsonl-at-claude-review-reports-architecture-rule.
                         surface = m.group(0)
                         kind = "bash-attributed"
                         plugin = m.group(1)