devrites 5.13.0 → 5.14.0

package/pack/generated/omp/skills/rite-adopt/reference/anti-patterns.md

@@ -8,7 +8,7 @@ Below are the rationalizations specific to onboarding an existing codebase.
 | Excuse | Rebuttal |
 |---|---|
 | "I'll improve this messy bit while I document it." | Adoption *documents* what exists; it changes nothing. A cleanup is the *next* feature through the normal lifecycle: recording it as a drive-by here hides the baseline and balloons the diff. |
-| "This looks like the convention, so I'll seed it." | Seed only what the code *and consistently* follows. A guessed seed becomes a high-confidence-looking prior that steers the first slice wrong. Observe it in ≥2 places or leave it out. |
+| "This looks like the convention, so I'll seed it." | Seed only what the code *and consistently* follows. A guessed seed becomes a high-confidence-looking prior that steers the first slice wrong. Observe it in ≥2 places, with nonconforming sites counted per [`adoption.md`](adoption.md), or leave it out. |
 | "I'll spec the ideal architecture, not the current one." | The spec's baseline is *current behavior*. Aspirations go in the next objective, not the baseline: otherwise every later slice drifts against a spec that never matched reality. |
 | "Whole repo in one adopt." | Onboard the area you'll work in. A repo-wide adopt produces an unfocused spec and a ledger full of conventions no slice will touch. |
 

package/pack/generated/omp/skills/rite-autocomplete/SKILL.md

@@ -118,7 +118,8 @@ executable controller/harness/bundle bytes or a missing writer, read
    recommended option, remaining NO-GO, or the exact fingerprint's proven
    exhaustion. An open blocking question that already names a ranked recommended
    option (`proposed` or option 1 labelled Recommended) auto-resolves through
-   `devrites-engine state resolve` and continues; do not emit `/rite-resolve` as
+   `devrites-engine state resolve` and continues (a missing or failing resolver is
+   the bounded resolver-failure stop); do not emit `/rite-resolve` as
    a user handoff. Technical exhaustion records terminal
    `Next step: none`, never a routine phase command. **Completion:** no stop is active, or its cursor and reason are durable.
 6. **Seal boundary.** Without a ship flag, stop at Seal GO with `/rite-ship` —

package/pack/generated/omp/skills/rite-autocomplete/reference/loop.md

@@ -148,7 +148,9 @@ No user-facing reply is permitted while durable state contains agent-owned
 `NEEDS_REPLAN`, an intermediate Plan/Vet action, a distinct retained
 Critical/Important fingerprint below its cap, or an open blocking question that
 already names a ranked recommended option. Invoke the next internal repair or
-`devrites-engine state resolve` immediately. A narrow reviewer closing one finding and exposing another
+`devrites-engine state resolve` immediately, unless that writer already hit the
+[resolver-failure stop](stop-conditions.md#other-stop-classes). **Failing case:**
+`state resolve` exits 1 on every call and the loop re-invokes it without end. A narrow reviewer closing one finding and exposing another
 Critical/Important invariant is progress, not exhaustion.
 
 The number of completed repair/Vet cycles is not a stop condition. Context

package/pack/generated/omp/skills/rite-autocomplete/reference/stop-conditions.md

@@ -83,6 +83,12 @@ exhausted.
   Do not stop on `--max-slices`, `max_agents`, `max_minutes`, or `max_review_queue`.
 - **Confidence:** intent still cannot become testable acceptance after interview.
 - **Repeated failure:** the exact fingerprint's bounded recovery is exhausted.
+- **Resolver failure:** `devrites-engine state resolve` not found, or nonzero exit.
+  Never hand-edit `questions.md`/`state.md` in its place. Not found stops at once;
+  nonzero allows one identical re-run (the fingerprint is command + exit code +
+  decisive stderr line; an unchanged re-run is not a correction, so no further
+  attempts). Then stop `blocked` with the exact command, exit code, and stderr line,
+  and resume action `/rite-doctor`.
 
 ## Final GO and durable stop
 

package/pack/generated/omp/skills/rite-build/reference/checkpoint-protocol.md

@@ -2,7 +2,7 @@
 
 HITL slices pause **pre-action** as a ranked **option set** before any code:
 
-- **Interactive:** `AskUserQuestion`; record to `questions.md`/`decisions.md`; clear gate;
+- **Interactive:** `ask`; record to `questions.md`/`decisions.md`; clear gate;
   continue in place (no `/rite-resolve` round-trip).
 - **Absent / AFK / notify-only:** persist open question + `Awaiting human`, notify, **stop**.
   Resume via `/rite-resolve` (or `--batch`).
@@ -14,7 +14,7 @@ observer.
 
 ### User-facing render: the option set
 
-Present as `AskUserQuestion` ranked **option set** ([`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md)): 2–4 options,
+Present as `ask` ranked **option set** ([`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md)): 2–4 options,
 recommended first + `(Recommended)`, dimension-tagged trade-offs, plus escape hatch.
 Header names slice + gate:
 
@@ -52,22 +52,14 @@ rewrite; do not claim cross-file atomicity):
    raised_at: <iso>
    ```
 
-2. **`state.md` updates:**
-
-   ```markdown
-   - Status: awaiting_human
-   - Active slice: <N — name>
-   - Slice mode: HITL
-   - Next step: /rite-resolve <qid> "<answer>"
-
-   ## Awaiting human
-   - qid: <q-...-NNN>
-   - gate: <gate>
-   - question: <Checkpoint text>
-   - proposed: <one-paragraph best-guess>
-   - raised_at: <iso>
-   - blocking_slices: [<list, from `Blocked by` lookups>]
-   ```
+2. **`state.md` updates:** cursor `status` = `awaiting_human`, `active_slice` =
+   `<N — name>`, `slice_mode` = `HITL`, `next_action` = `/rite-resolve <qid> "<answer>"`;
+   then the `Awaiting human` table (`question_id`, `gate`, `blocking_slices` from
+   `Blocked by` lookups) per its owner,
+   [`state-workspace.md`](../../rite-spec/reference/state-workspace.md#statemd-template) § state.md template.
+   Question text, `proposed`, and `raised_at` stay in the step 1 entry. Legacy
+   `- Status:`/`- Next step:`/`- qid:` bullets are engine-accepted aliases, not the
+   authoring format.
 
 3. **`notify:` hook (if `.devrites/AFK` defines one):** export all six env vars from the
    canonical contract in [`afk-discipline.md`](afk-discipline.md) (the `notify:` hook

package/pack/generated/omp/skills/rite-build/reference/parallel-batch.md

@@ -62,6 +62,15 @@ overlap → sibling **gap** (a shared path is a contract defect). **Failing
 case:** two parallel wrights share a path and fan-out proceeds without that
 check.
 
+Before `parallel select`, add each slice's hidden write surfaces (list owner:
+[repository-topology.md § Ownership rules](../../devrites-lib/reference/standards/repository-topology.md#ownership-rules))
+— lockfile/manifest, the generated target of an edited source, migration chain,
+snapshot directory, formatter sweep — and compare paths case-folded
+(`src/Api.ts` = `src/api.ts`). Slices colliding on either run serially; the rest
+stay eligible. Record `serial: <ids> — <surface>` in `evidence.md`. **Failing
+case:** two slices each add a dependency, run in parallel, and integrate fails or
+lands a broken lockfile.
+
 ## Control vs workers
 
 Control owns `.devrites/work/<slug>/` (lease + bookkeeping).
@@ -218,6 +227,6 @@ isolation cannot be established.
 
 ## Host
 
-omp: N concurrent `task` tool / `tasks[]` batch wrights (`acceptEdits`, cwd=worktree). Codex: require
+omp: one `tasks[]` batch of N wrights; `task` has no `cwd` or `acceptEdits`, so each task names its absolute worktree path and the wright works only there. Codex: require
 host-explicit concurrent worktree writers + native reconcile; else force serial.
 Never two writers in one worktree; never root-emulated concurrency.

package/pack/generated/omp/skills/rite-build/reference/wright-dispatch.md

@@ -7,7 +7,7 @@ Wright alone writes; no agents.
 ## Host gate
 
 Apply [source-writing boundary](../../devrites-lib/reference/standards/agents.md#source-writing-boundary):
-Claude grants only the exact wright `acceptEdits`; Codex uses its workspace root,
+omp has no permission modes: only the wright's `tools` allowlist has `edit`/`write`, and the root stays source-read-only by instruction. Claude grants only the exact wright `acceptEdits`; Codex uses its workspace root,
 the exact `:workspace` wright, and read-only specialists. Never bypass/substitute
 the wright or recreate an engine bridge.
 
@@ -95,7 +95,11 @@ not normal cleanup.
 1. Compare the returned file list and `git diff --name-only` with task paths.
    `devrites-engine check diff-scope <slug> --allow <task-paths>` is the
    mechanical subset gate — run it before any reviewer dispatch; a violation
-   restores through the bounded wright without spending review.
+   restores through the bounded wright without spending review, but only for a
+   path the wright's `files_changed` or diff trace attributes to it. An
+   unattributed extra path that was clean at the step-3 baseline is preserved
+   (never restored), recorded as drift, and stops for the human. **Failing case:**
+   a user edits `README.md` during a same-tree dispatch and the wright reverts it.
    Reject a result that omits any required key — the bookkeeping arrays count
    whether empty or filled — or adds a path. Root never widens scope or edits
    source.

package/pack/generated/omp/skills/rite-clarify/SKILL.md

@@ -96,7 +96,7 @@ Evidence: Decision coverage: CLEAR; human packets <n>; agent-owned facts <n>
 Open: none blocking; deferred-nonblocking <n>
 Next: /rite-temper (or /rite-define for a low-stakes spec temper skips)
 Record: .devrites/work/<slug>/decision-coverage.md
-↻ Hygiene: /clear before /rite-temper (or /rite-define)
+↻ Hygiene: /clear — decision coverage is persisted in decision-coverage.md
 ```
 
 If not clear, name the exact rows and next genuine decision packet. An objective spec defect

package/pack/generated/omp/skills/rite-converge/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-converge
-description: Converge intent and live code. Use when resuming a half-built feature, after `/rite-adopt` drift, or the user asks "what's left to build". Not for initial planning.
+description: Converge intent and live code. Use when resuming a half-built feature, after `/rite-adopt` drift, or live code may have diverged from the plan. Not for initial planning.
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---
@@ -59,6 +59,13 @@ Pull on demand:
 - **Principles are non-negotiable.** A live violation of a declared invariant with no recorded
   exception is the top-severity gap, walked first. Absent/empty principles file → none declared
   → skip the check gracefully, never block for its absence.
+- **Unadmitted bytes from a lost wright.** When a stalled slice's wright never returned an
+  admitted result, act only after its terminal state is proven
+  ([`parallel-dispatch.md`](../devrites-lib/reference/parallel-dispatch.md) § Cancellation);
+  unproven stays a gap. Then inspect task-path bytes changed since the recorded pre-dispatch
+  `git diff --name-only` baseline (none recorded → every changed task path counts). They are
+  never cited `built`, never discarded (user work): classify the slice `partial (unadmitted
+  bytes)` and name those paths in the appended slice. A change outside task paths stops for the human.
 - **Scout observes; root classifies and writes.** Use
   [`agents.md`](../devrites-lib/reference/standards/agents.md). The evidence scout returns
   live-code citations only; the controlling chat owns built/partial/absent calls and append-only
@@ -115,7 +122,7 @@ Pull on demand:
    `decisions.md` for any material call. When slices were appended, run
    `devrites-engine check task-graph <slug>` before invoking Vet; failure stays in
    Converge for correction and never spends a Vet reviewer context.
-7. **STOP.** Report units assessed, built / partial / absent counts, slices appended, and any
+7. **STOP.** Report units assessed, built / partial / absent / unrequested counts, slices appended, and any
    principle violation found. A direct invocation that appended slices becomes
    the caller for the mandated next step: save a return cursor
    (`return_phase`/`return_next_action`) naming this Converge pass as the

package/pack/generated/omp/skills/rite-converge/reference/convergence-assessment.md

@@ -52,6 +52,11 @@ Before appending a slice, separate the two failure directions:
   ([`spec-drift-guard.md`](../../rite-build/reference/spec-drift-guard.md)) + a recorded decision, and let `/rite-plan
   repair` reshape intent. Convergence enqueues work; it never launders a spec bug into a code
   task.
+- **Unrequested:** within `touched-files.md` paths and plan touch-points, observable behavior
+  no REQ/AC/decision explains. It never enqueues a build slice: keep it through the Spec Drift
+  Guard plus a recorded decision, or record a `drift.md` removal item for `/rite-review`. Report
+  its count; an unrouted one blocks a clean result. **Failing case:** adopted code serves an admin export
+  endpoint no REQ names, Converge says "nothing unmet", and later slices build on it.
 
 ## Numbering + ordering the appended batch
 

package/pack/generated/omp/skills/rite-define/SKILL.md

@@ -66,7 +66,8 @@ Pull these via `Read` when shaping the plan:
    and respect the IN/OUT line; map coverage against the **hardened** spec), and
    **`design-brief.md` if the feature touches UI** (the UX/UI contract `/rite-spec` shaped:
    its key states, interaction model, and proof targets drive how UI slices are cut). If a blocking
-   `[NEEDS CLARIFICATION]` remains, stop → `/rite-clarify`.
+   `[NEEDS CLARIFICATION]` remains, stop → `/rite-clarify`. Run the [`spec-grammar.md`](../devrites-lib/reference/standards/spec-grammar.md) marker
+   sweep; a kept hit stops the same way, and its `marker sweep:` line goes in the step-7 digest.
    Reconcile every `Applicability map` row against live repository evidence. Load each
    applicable standard; a false `not applicable` is a blocking spec gap, not a planning
    shortcut.
@@ -121,6 +122,10 @@ Pull these via `Read` when shaping the plan:
    ([`acceptance-criteria.md`](../rite-spec/reference/acceptance-criteria.md)); no orphaned criteria, no slice without a
    criterion. Lift covered/backstop `Edge Coverage` rows and resolved `Prohibitions (must-NOT)`
    rows into `traceability.md` and `test-plan.md`; unresolved rows get a gate/owner. Each
+   `Existing behavior to preserve` row becomes a regression row whose current evidence is
+   observed green on the unchanged baseline as a prerequisite of the first slice touching that
+   seam, and green again at Prove; a red baseline is recorded pre-existing, never relabelled.
+   Evidence that cannot run takes `characterize-before-modify` or blocks. Each
    cross-slice boundary names producer, consumer, invariant, integration step, and proof.
    Map each applicable topology/data/integration risk to a slice, failure/recovery path,
    and discriminating proof; a risk cannot live only in the architecture narrative.

package/pack/generated/omp/skills/rite-define/reference/plan-template.md

@@ -92,6 +92,9 @@ Shared contract impact: none — <specific justification>
 List slice prerequisites, non-code prerequisites, and deployable order:
 contract/schema/config → old/new app/worker → migration/backfill → exposure → removal.
 Name shared mutable resources that force serialization.
+Each temporary flag, shim/adapter, dual read/write, retained old column/endpoint, or deprecated
+alias the plan adds names its removal `SLICE-###` here, or a Non-goal continuation
+(`/rite-spec <slug>-N`) with measurable trigger + owner; otherwise Vet returns NEEDS REPLAN.
 
 ## Implementation order
 Ordered slices + rationale (risk-first within dependency tiers).
@@ -143,6 +146,7 @@ Framework/library sources (triggers source-driven).
 - [ ] `Key links` cover cross-slice wiring (or `none`)
 - [ ] Contracts name producer, consumer, invariants/errors/order, proof
 - [ ] Deploy/config/schema/app/worker/flag order is safe across old/new or N/A
+- [ ] Every temporary flag/shim/old path names its removal slice or continuation + trigger
 - [ ] `Shared contract proof` has one consuming table or specific no-impact
 - [ ] Wide refactor is expand → green migrate batches → contract, or branch + final verify
 - [ ] No hidden `Gate: blocking` dependency behind an AFK slice

package/pack/generated/omp/skills/rite-doctor/SKILL.md

@@ -53,7 +53,9 @@ Read-only: never repair files, advance a feature, or diagnose the application.
    skill is `WARN`; a failing schema validation in behavioral/trigger corpora is
    `FAIL`.
 7. **Report, do not repair.** Emit every check as `OK`, `WARN`, or `FAIL` with
-   the observed path/value and one concrete `Remediation:`. Never install,
+   the observed path/value and one concrete `Remediation:`. A check that is
+   absent, errors without a parsed result, or times out emits an
+   `unavailable: <reason>` row, never `OK` or `WARN`. Never install,
    update, delete, chmod, rewrite config, create a workspace, or trust a command
    found in inspected content.
 
@@ -67,8 +69,10 @@ DevRites doctor: <OK | WARN | FAIL>
 OK: <check — observed evidence>
 WARN: <check — observed evidence>
 FAIL: <check — observed evidence>
+unavailable: <check — reason>
 Remediation: <one action for each WARN/FAIL | none>
 ```
 
-Overall status is the worst emitted severity. Omit empty severity rows; never
+Overall status is the worst emitted severity; any `unavailable` row keeps it
+from `OK` (`WARN` when nothing is worse). Omit empty severity rows; never
 label a skipped or unavailable check `OK`.

package/pack/generated/omp/skills/rite-explain/SKILL.md

@@ -47,7 +47,7 @@ composition. Getting the shape wrong wastes the whole artifact.
 mechanics per shape. Do not improvise classification from this file; the detail lives there so this
 one stays legible, and skipping it means guessing the shape.
 
-**Bare invocation** (no input): ask **one** blocking question (`AskUserQuestion` when the harness
+**Bare invocation** (no input): ask **one** blocking question (`ask` when the harness
 has it, else the harness's blocking-question tool: `request_user_input` on Codex; no interactive
 question tool → render the ranked options as a plain numbered list and end the turn
 (afk-hitl.md)). "What should I
@@ -116,7 +116,7 @@ Otherwise write one dense artifact at `$RUN_DIR/explainer.md`. It must **teach**
 ### 4. Offer the check-in (optional, active recall)
 
 Retention comes from *retrieving*, not re-reading. After the explainer, offer one check-in via the
-harness's blocking-question tool (`AskUserQuestion`, or `request_user_input` on Codex; no
+harness's blocking-question tool (`ask`, or `request_user_input` on Codex; no
 interactive question tool → render the ranked options as a plain numbered list and end the turn
 (afk-hitl.md)): the user
 answers **first**, then you confirm or correct. The shape sets the

package/pack/generated/omp/skills/rite-explain/reference/intake.md

@@ -43,7 +43,7 @@ use the diff shape with walkthrough composition.
 ## Check-in mechanics
 
 Retention comes from retrieval. Offer exactly one check-in via the harness's blocking-question tool
-(`AskUserQuestion`, or `request_user_input` on Codex; no interactive question tool → render the
+(`ask`, or `request_user_input` on Codex; no interactive question tool → render the
 ranked options as a plain numbered list and end the turn (afk-hitl.md)); the user answers **before** any reveal. Grade honestly: a wrong prediction that gets corrected teaches more than a
 confirmed one, so do not lead the witness.
 

package/pack/generated/omp/skills/rite-handoff/SKILL.md

@@ -28,7 +28,11 @@ cannot hold; the engine supplies what the workspace already knows.
 ## Where to write
 
 - **Active feature exists** → `.devrites/work/<slug>/handoff.md` (overwrites the previous
-  handoff; the workspace is the canonical home for this slug).
+  handoff; the workspace is the canonical home for this slug). Before overwriting, read the
+  previous file: its "External references" and "Live assumptions" exist nowhere else. Carry
+  each still-valid entry into the new file or list it under "Retired from the previous
+  handoff" with a reason; an entry in neither place is a silent drop — fix the draft before
+  writing.
 - **No active feature** → OS temp dir (`$TMPDIR` / `/tmp` / `%TEMP%`) as
   `rite-handoff-<ISO-timestamp>.md`. Print the absolute path after writing.
 
@@ -64,7 +68,15 @@ themselves. The workspace is the canonical store; the handoff is the chat-only d
 4. **Live assumptions the agent is acting on** that the workspace doesn't reflect yet
    (after the sync above, this section should be near-empty: flag anything that
    remains).
-5. **How to resume:** fixed boilerplate (see template below).
+5. **Tree record.** `HEAD <sha>` (`git rev-parse HEAD`) and the `git status --short` path
+   count at write time, so the next session can see edits made after the handoff.
+6. **In-flight work.** Every dispatch wave opened or sealed without a return (`devrites-engine
+   dispatch <slug> status`), running writer handle, held claim id plus paths (`devrites-engine
+   claim list --all`), and consumptive action started, each `terminal: yes|unknown` (`yes` only with
+   an admitted return, release, or proof of stop). The live handle exists only in chat. Any
+   `unknown` row makes item 1 a reconcile step (`dispatch <slug> status`, `parallel status`,
+   `claim list --all`), never a writer command: otherwise the next session dispatches a second writer.
+7. **How to resume:** fixed boilerplate (see template below).
 
 ## What NOT to include
 

package/pack/generated/omp/skills/rite-handoff/reference/handoff-template.md

@@ -10,6 +10,8 @@ Loaded on demand by `/rite-handoff`. Write the filled-in template to
 Current objective: <one sentence>
 Last completed slice: <SLICE-### | none>
 Blockers: <none | q-YYYY-MM-DD-NNN / released Q-### / DRIFT-###>
+Tree at write: HEAD <sha | no git>; dirty paths <n>
+In flight: <none | wave <id> role <r> handle <h> | wright SLICE-### handle <h> | claim <id> <paths> | action <name>>; each `terminal: yes|unknown`
 
 ## Read next
 1. `.devrites/work/<slug>/README.md` — workspace map.
@@ -18,17 +20,22 @@ Blockers: <none | q-YYYY-MM-DD-NNN / released Q-### / DRIFT-###>
 4. <phase-specific source artifact; link, do not duplicate>.
 
 ## Next action
-<one command or action, no option set>
+<one command or action, no option set; any `terminal: unknown` row makes it reconcile:
+`devrites-engine dispatch <slug> status`, `devrites-engine parallel status --root <repo> --slug <slug>`,
+`devrites-engine claim list --all` — never a writer command>
 
 ## What changed this turn
 - <short event; link to source artifact instead of copying full content>
 
 ## External references (chat-only)
-- <URL / Figma / screenshot path / video timestamp>
+- <URL / Figma / screenshot path / video timestamp>   (carried forward if still valid)
 
 ## Live assumptions (not yet in assumptions.md)
 - ...   (this section should be near-empty after the sync step)
 
+## Retired from the previous handoff
+- <none | reference or assumption — why it no longer holds>
+
 ## Synced this turn
 - decisions.md: <N entries appended>
 - questions.md: <N appended>
@@ -39,6 +46,11 @@ Blockers: <none | q-YYYY-MM-DD-NNN / released Q-### / DRIFT-###>
 ## How to resume
 1. Read this file.
 2. Read `.devrites/work/<slug>/state.md` for the workspace cursor.
-3. Run `/rite-status` for the current phase / next action / open drift.
-4. Continue with the `Next action` above.
+3. Tree check: compare `git rev-parse HEAD` and `git status --short` with `Tree at write`
+   and `touched-files.md`. Other HEAD, other dirty count, or a path missing from
+   `touched-files.md` → record it in `drift.md` or `questions.md` before any writer command.
+4. Any `In flight` row `terminal: unknown` → run the reconcile commands first; never dispatch
+   a second writer onto its paths.
+5. Run `/rite-status` for the current phase / next action / open drift.
+6. Continue with the `Next action` above.
 ```

package/pack/generated/omp/skills/rite-learn/SKILL.md

@@ -20,10 +20,20 @@ of one authority; it cannot promote a rule alone.
 
 ## Workflow
 
-1. Read [durable promotion](../devrites-lib/reference/standards/documentation.md#promote-durable-guidance);
-   bound the archive; inspect applicable `AGENTS.md`/`CLAUDE.md`, accepted ADRs, and relevant `.devrites/archive/*/{decisions,drift,review,seal}.md`.
+1. Read [durable promotion](../devrites-lib/reference/standards/documentation.md#promote-durable-guidance).
+   Before bounding, fixed-string search all of `.devrites/archive/` and active
+   `decisions.md` for `rite-learn: accepted` and `rite-learn: declined`; read every hit
+   whole. Then bound the archive; inspect applicable `AGENTS.md`/`CLAUDE.md`, accepted ADRs, and relevant `.devrites/archive/*/{decisions,drift,review,seal}.md`.
+   **Failing case:** a declined proposal returns because its feature fell outside the bound.
 2. Broad mode dispatches exact fresh/read-only `devrites-retrospector`; reconcile its claims against cited files.
+   A missing, failed, timed-out, or malformed result reports `Candidate: NOT-RUN
+   (unavailable: <reason>)` as a gap, never `Candidate: none`; an unavailable role stops
+   for HITL per [`agents.md`](../devrites-lib/reference/standards/agents.md) (trigger `agents`).
 3. Keep corrections repeated in two features, a judgement call made twice, or a defect class seen twice; drop one-off preferences, task-specific detail, generic advice.
+   Broad mode also proposes **retirements**: a rule found via a `rite-learn: accepted`
+   marker whose cited failing case or owner no longer exists in live source, whose
+   review-by date passed unverified, or that is a model-default no-op. Zero is valid but
+   names the searched scope; a rule still guarding a live failing case is never retired.
 4. Verify claims against live authoritative sources; state currentness signal, applies/does-not-apply scope, `unknown` where unverifiable.
    **Research promotion requires:** each external claim carries a dated citation per
    [[`tooling.md`](../devrites-lib/reference/standards/tooling.md) § Research provenance](../devrites-lib/reference/standards/tooling.md#research-provenance-staleness-and-cost).
@@ -44,6 +54,20 @@ of one authority; it cannot promote a rule alone.
   conversation or on an unmerged branch is lost and will be re-litigated.
   **Failing case:** the same rejected proposal returns next round because no tracked
   entry exists.
+- Every disposition entry carries the fixed marker `rite-learn: accepted` or
+  `rite-learn: declined`, its evidence refs, and (accepted) owner path plus a review-by
+  date. A later round reuses a matching declined record instead of re-proposing.
+- A lesson needs an **external signal** (user correction, failing test/gate, review
+  finding) with its source; self-critique or model reflection alone never changes guidance.
+- Promotion path is fixed: lesson → artifact type (retrospector class) → one canonical
+  owner → human approval of the exact edit. A skipped stage is no promotion.
+- **Recurrence ⇒ mechanism.** When `Authority: existing <path>` already holds the violated
+  rule, the candidate is a check, gate, template slot, or default at that owner
+  ([`skill-authoring.md`](../devrites-lib/reference/standards/skill-authoring.md#match-form-to-failure) § Match form to failure),
+  never a reworded, bolder, or relocated copy; otherwise record `no mechanical form
+  possible: <reason>` and narrow the proposal. An unwired or broken existing check is
+  itself the candidate. **Failing case:** a round accepts a bolder copy of an `AGENTS.md`
+  rule that two archived features already violated.
 - A lesson proposing a new recurring check names its **controls**: the real past
   instance it would have caught (positive) and a near-miss class it must not fire on
   (negative). **Failing case:** a trigger patterned on an imagined command that never
@@ -52,17 +76,23 @@ of one authority; it cannot promote a rule alone.
 - A proposal names the **retrospective failing case**: the concrete past feature/artifact the
   rule would have caught. None → generic advice — drop.
 - ≤3 accepted lessons per round; proposals extend/narrow but never lower an existing bar (revisions show old text beside new); duplicates consolidate into one canonical edit — simplification (deletions/merges) counts toward the cap.
+  Net growth cap: a round adds at most 3 net rules across all owners (additions minus
+  retirements). A round whose approved edits add net bytes to an owner states the
+  retirement search it ran.
 - An accepted lesson ships with a **follow-through owner and deadline**: the exact edit
   lands in the named canonical file in the same round; a lesson unapplied at round end
   returns to candidates with its blocker recorded. **Failing case:** an accepted lesson
   with no applied edit and no recorded blocker — promotion failed; re-raise it.
+  Still unapplied at a second round end, it becomes an apply-or-decline decision; a
+  decline takes the `rite-learn: declined` record, so no lesson is carried a third time.
 
 ## Output
 
 ```text
 Done: reviewed <scope>.
 Changed: none (proposal only)
-Candidate: <specific proposal or none>
+Candidate: <specific proposal | none | NOT-RUN (unavailable: <reason>)>
+Retirements: <candidates | none — searched <scope>>
 Currentness: <live source + signal | unknown>
 Scope: applies <trigger>; does not apply <boundary>
 Authority: existing <path|none>; canonical <path>; consumers/discovery <route>
@@ -70,5 +100,5 @@ Disposition: <no conflict | update/narrow/replace/retire path + reason>
 Evidence: <feature/file references>
 Awaiting: <approval for exact edits | none>
 Next: <single action>
-Record: <nearest owning decisions file | chat-only>
+Record: <nearest owning decisions file | chat-only only when the round made no accepted/declined disposition>
 ```

package/pack/generated/omp/skills/rite-plan/SKILL.md

@@ -63,7 +63,8 @@ Before classifying any Reslice, read `.omp/skills/devrites-lib/reference/standar
    dependency's current API surface, consult context7 if available.
 2. **Pick the mode** (`$ARGUMENTS` or infer): Apply the marked action before writes and
    retain its decision/coverage evidence.
-   - **decompose:** first/again break the feature into vertical slices.
+   - **decompose:** break an already-sliced feature into vertical slices again. With no
+     `SLICE-###` in `tasks.md`, stop and route to `/rite-define`; first-pass decomposition is its.
    - **reslice:** a slice is too large; split into thinner end-to-end slices.
    - **repair:** a Spec Drift Guard event; fold the resolution into plan + tasks.
    - **reorder:** fix the dependency order.

package/pack/generated/omp/skills/rite-plan/reference/task-breakdown.md

@@ -38,6 +38,12 @@ This reference owns decomposition; the shared schema owns field names and meanin
   called `clearLayers()` in slice 3 and `clearFullLayers()` in slice 7 is a planning bug:
   name shared symbols once, here.
 - Don't pre-write code in the task: describe the outcome, not the implementation.
+- **Read the fields, not the title.** A slice fails Vet (`kind: contract`, Important, field
+  quoted) when its `Goal` or `Done condition` names an activity instead of an observable end
+  state ("implement backend", "add tests", "handle errors", "wire up UI"); when a no-op or
+  wrong diff could meet the `Done condition` ("tests pass", "works correctly"); or when
+  `Tests/proof` names no specific test or assertion ("run the suite"). **Failing case:**
+  `Goal: Implement export backend · Done condition: tests pass · Tests/proof: go test ./...`.
 - Don't bundle "while we're here" work into a slice. That's scope creep; log it as a
   follow-up instead.
 - Don't slice to a target number: the count comes from the capabilities + the sizing

package/pack/generated/omp/skills/rite-polish/SKILL.md

@@ -63,12 +63,18 @@ Incomplete comparison is **not** agreement. Record axis deltas in `polish-report
    Then read the explicit or active workspace's `state.md` directly.
 1. **Read** `state.md`, `touched-files.md`, the current candidate digest, and the
    `git diff` for the active workspace (or `$ARGUMENTS` if a target was given).
-2. **Detect UI scope:** UI is touched if the diff or `touched-files.md`
-   contains any of: `.tsx`, `.jsx`, `.vue`, `.svelte`, `.html`, `.css`,
+2. **Detect UI scope:** UI is touched when the diff changes rendered output:
+   markup, template, style, design token, client component, or a visible string
+   (including an API error message shown in the UI). These paths are leads to
+   inspect, not the predicate: `.tsx`, `.jsx`, `.vue`, `.svelte`, `.html`, `.css`,
    `.scss`, `.sass`, `.less`, `.styl`, component dirs (`components/`,
    `pages/`, `routes/`, `app/`, `views/`, `screens/`), Storybook stories,
-   or design-token files. When in doubt, look for visual changes that need
-   verification.
+   or design-token files; when in doubt whether output changes, treat it as UI
+   scope. A diff with no rendered-output change records
+   `UI scope: none (no rendered output)` and skips Phases 3–4; non-visual client
+   code still gets frontend engineering review (`devrites-code-reviewer` frontend lane).
+   **Failing case:** an `app/services/billing.rb` diff opens Phase 4 and demands
+   captures.
 3. **Always** read [`reference/code.md`](reference/code.md) and assess **Phase 1
    (code polish)**; if backend was touched, assess **Phase 2 (backend polish)** from
    the same file. Reconcile the findings, then send accepted corrections as one bounded