devrites 4.0.12 → 4.1.0

package/pack/generated/codex/skills/rite/SKILL.md

@@ -54,6 +54,7 @@ What each verb does lives once, in the Menu below; this table is the invocation
 | `pov [candidate]` | `$rite-pov` |
 | `dogfood [--port N]` | `$rite-dogfood` |
 | `pr-feedback [PR\|thread]` | `$rite-pr-feedback` |
+| `watch-pr [PR\|URL]` | `$rite-watch-pr` |
 | `customize [instruction \| skill \| agent \| plugin]` | `$rite-customize` |
 | `use <slug>` | (inline) |
 | `guide` | (inline) |
@@ -124,6 +125,7 @@ EXPLAIN       $rite explain ...        ≡    $rite-explain     grounded concept
 POV           $rite pov ...            ≡    $rite-pov         decide adopt / trial / hold / reject for an external option
 DOGFOOD       $rite dogfood ...        ≡    $rite-dogfood     browser QA by changed user journey
 PR FEEDBACK   $rite pr-feedback ...    ≡    $rite-pr-feedback fix and resolve PR review threads
+WATCH PR      $rite watch-pr ...       ≡    $rite-watch-pr    observe PR/CI once without mutation
 CUSTOMIZE     $rite customize ...      ≡    $rite-customize   author overrides/extensions without forking the pack
 SWITCH        $rite use <slug>                                re-point .devrites/ACTIVE to another feature (inline)
 GUIDE         $rite guide                                     first feature, guided — full lifecycle on one small real change (inline)

package/pack/generated/codex/skills/rite-adopt/SKILL.md

@@ -7,18 +7,17 @@ user-invocable: true
 
 # $rite-adopt: onboard existing code
 
-Reverse-engineer existing behavior into the same `spec.md` contract used by new
-features. Adoption documents the repository; it does not rewrite it or create a
+Reverse-engineer current behavior into `spec.md`; do not rewrite product code or create a
 parallel convention system.
 
 ## Workflow
 
-1. Read the core standards and resolve the repository/sub-area plus the next
-   objective. Ask once when either is materially ambiguous.
+1. Read core; resolve repository/sub-area and next objective. Ask once only if material.
 2. Follow [`reference/adoption.md`](reference/adoption.md): inspect current
    behavior, architecture and placement, callers, reusable seams, repository/CI
-   commands, visible code/test patterns, and non-obvious constraints. Read
-   existing `AGENTS.md`, `CLAUDE.md`, product, and design guidance.
+   commands, visible code/test patterns, non-obvious constraints, and any touched
+   load-bearing seam that needs `characterize-before-modify`. Read existing
+   `AGENTS.md`, `CLAUDE.md`, product, and design guidance.
 3. Create the workspace and write `spec.md`, `decisions.md`, `assumptions.md`,
    `questions.md`, and `state.md`. The spec separates the current baseline from
    the measurable next objective.
@@ -26,10 +25,9 @@ parallel convention system.
    [`ledger.md`](../rite-polish/reference/ledger.md): read current specs, preview
    ADDED entries, confirm paths, refuse escape/symlink/clobber/ignored targets,
    write, lint, and require an empty re-preview.
-5. If a repeatedly observed operating rule should govern future work, propose
-   one exact edit to the nearest existing `AGENTS.md`, `CLAUDE.md`, or scoped
-   document. Apply only after review. Do not create convention bands, scores, or
-   a command cache.
+5. For a verified non-obvious policy or recurring/costly mistake, prefer existing hook/lint/
+   CI/type/schema enforcement; else propose one evidence-cited nearest-scope instruction edit.
+   Apply only after review; never create convention bands, scores, or a command cache.
 6. A genuine non-negotiable invariant may be proposed for
    `.devrites/principles.md`; the human must ratify it.
 7. Set the next step to `$rite-clarify` and stop. Do not plan or build.

package/pack/generated/codex/skills/rite-adopt/reference/adoption.md

@@ -1,21 +1,19 @@
 # Adoption: reverse-investigation
 
-Loaded on demand by `$rite-adopt`. Document what the code already does so the
-lifecycle starts from evidence rather than guesses.
+Loaded by `$rite-adopt`; record code reality before forward work.
 
-Capture the durable project shape:
+Capture visible behavior; architecture/placement/callers/seams; repository/CI commands;
+live naming/layering/error/data/test conventions; and non-obvious constraints.
 
-- current user-visible behavior;
-- architecture, placement, callers, and important seams;
-- real test, build, typecheck, and lint commands from repository scripts or CI;
-- naming, layering, error, data-access, and test patterns visible in live code;
-- non-obvious ordering or framework constraints.
+For each next-objective load-bearing seam without a discriminating test, append after its
+source in `spec.md` existing behavior's `Current evidence` cell:
 
-Use native code/file search and current repository documentation. Fresh source
-and CI configuration win over historical notes.
+```text
+Characterization: characterize-before-modify; risk: <risk>; first touch: <slice|unknown>
+```
 
-Write the adopted baseline and next objective to `spec.md`; put uncertain facts
-in `assumptions.md` and durable decisions in `decisions.md`. If an observed rule
-should govern future work, propose one reviewed update to `AGENTS.md`,
-`CLAUDE.md`, or the nearest scoped project document. Do not create a convention
-ledger, confidence band, score, or duplicated command cache.
+This is a touched-behavior ratchet, not repository-wide coverage.
+
+Use current code/search/docs; source and CI beat history. Put baseline/objective in
+`spec.md`, uncertainty in `assumptions.md`, durable choices in `decisions.md`, and guidance
+in nearest scoped instructions—never ledgers, scores, confidence bands, or command caches.

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

@@ -46,8 +46,10 @@ the terminal cursor or its recovery count.
   New retained Critical/Important evidence starts offline repair and narrow Vet
   inside this Autocomplete invocation. Stop for a fresh GO only after that repair
   changes the failure condition and Vet is READY.
-- **Budget from the post-vet slice count.** Vet may split/add slices.
-  `--max-slices N` may lower the cap for a partial run; otherwise build all.
+- **Admit work under the AFK resource envelope.** Vet may split/add slices.
+  `--max-slices N` replaces the safe new-sentinel default of 10; post-Vet pending
+  count may lower it. Before every phase or leaf dispatch, also enforce expiry,
+  review-backlog, and native agent/token/cost/time limits from `afk-hitl.md`.
 - **Parse flags only from this invocation.** `--ship`, `--yolo`, `--max-slices`,
   `--full`, and `--cross-model` are active only when their exact standalone tokens
   occur in `$ARGUMENTS`; their presence in this skill, examples, or earlier messages
@@ -87,10 +89,11 @@ the terminal cursor or its recovery count.
    reconstruct any missing return cursor only from the current phase plus the
    exact approved action in `test-plan.md` / evidence, never from chat or guesswork.
    The idea + flags: `--ship` / `--yolo` (continue through ship preflight, then stop
-   for literal-GO and native approval), `--max-slices N` (optional lower safety cap for a partial run; default =
-   the plan's slice count, i.e. run all planned slices). Parse only the current
-   `$ARGUMENTS`; normalize the result to the idea, `ship_preflight: yes|no`,
-   `max_slices: N|plan`, `profile: standard|full`, and `cross_model: yes|no`.
+   for literal-GO and native approval), `--max-slices N` (optional explicit cap;
+   a newly created sentinel defaults to 10 and post-Vet pending count may lower it).
+   Parse only the current `$ARGUMENTS`; normalize the result to the idea,
+   `ship_preflight: yes|no`, `max_slices: N|default`, `profile: standard|full`, and
+   `cross_model: yes|no`.
    **Completion:** that normalized state is unambiguous and no sentinel or workspace
    file has been written.
 2. **Specify and clarify up front.** Use `devrites-interview`, `$rite-spec`, and
@@ -98,8 +101,10 @@ the terminal cursor or its recovery count.
    coverage never arms AFK. **Completion:** `decision-coverage.md` records `CLEAR`.
 3. **Arm AFK after clarity.** Require `Decision coverage: CLEAR`, then apply the
    loop's [one-write AFK contract](reference/loop.md#arm-afk-once): preserve a valid
-   existing sentinel byte-for-byte or create an advisory-only sentinel once; never
-   rewrite it after Vet. Also `touch .devrites/CHECKPOINT`: unattended runs use
+   existing sentinel byte-for-byte or create an advisory-only sentinel once with
+   bounded slices, agents, wall time, review queue, and four-hour absolute expiry;
+   never rewrite it after Vet or reset it on resume. Also `touch .devrites/CHECKPOINT`:
+   unattended runs use
    checkpoint mode so each proven slice is committed locally as a crash-survivable
    `WIP` ([rite-build/reference/checkpoint.md](../rite-build/reference/checkpoint.md));
    `$rite-ship` collapses them into the one feature commit. **Completion:** AFK config is
@@ -116,14 +121,16 @@ the terminal cursor or its recovery count.
    phase resumes.
    Immediately after `$rite-vet` and before the first Build dispatch, apply the loop's
    [mutable post-vet budget](reference/loop.md#derive-the-mutable-post-vet-budget)
-   contract. **Completion:** the loop reaches Seal GO, or a stop condition is persisted
+   contract, then apply resource admission before every phase and native dispatch.
+   **Completion:** the loop reaches Seal GO, or a stop condition is persisted
    before any later phase runs; the cursor names the last completed phase and the
    effective remaining budget.
 5. **Apply stop conditions at every gate** ([reference/stop-conditions.md](reference/stop-conditions.md)):
    first route an agent-owned red technical result through the loop's bounded
    recovery; its `blocked` label alone is not a stop condition. After that, on
-   hard-risk / human-owned blocking / escalating / NO-GO / budget-exhausted / still-low-confidence
-   → write `state.md` (`Status`, `Next step`), surface *why*, and **STOP**.
+   hard-risk / human-owned blocking / escalating / NO-GO / slice, agent, token,
+   cost, time, review-queue, or expiry exhaustion / still-low-confidence → write
+   `state.md` (`Status`, `Next step`), surface *why*, and **STOP**.
    Exhausted agent-owned technical recovery uses the terminal `Next step: none`
    marker and never hands the user `$rite-plan unblock` or another routine
    phase command.

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

@@ -9,15 +9,23 @@ Arm the gate policy up front without mutating it later:
 
 ```yaml
 allow_gates: [advisory]        # only advisory auto-handles; validating+ pause
-# notify: "<cmd>"              # optional — fired on any awaiting_human pause
-# max_slices: <N>              # include only for an explicit/configured cap
+max_slices: 10                 # explicit --max-slices N replaces this default
+max_agents: 32                 # native leaf dispatches in this host activation
+max_minutes: 120               # activation wall-clock cap
+max_review_queue: 8            # unresolved review/gate backlog cap
+expires_at: "<now + 4 hours>"  # write one absolute ISO-8601 UTC timestamp
+# max_tokens: <N>              # optional stricter native-host cap
+# max_cost_usd: <amount>        # optional stricter native-host cap
+# notify: "<cmd>"              # optional — fired after a durable stop
 ```
 
 Read an existing sentinel first. Preserve it byte-for-byte when valid; stop if its gate
-ceiling exceeds `advisory` or its `max_slices` conflicts with the invocation. If absent,
-write it once after clarity with `allow_gates: [advisory]` and an explicit
-`--max-slices N` only when supplied. The sentinel is read-only: never rewrite it after
-`$rite-vet` to inject a discovered plan count.
+ceiling exceeds `advisory`, its required resource envelope is missing/malformed/expired,
+or its `max_slices` conflicts with the invocation. If absent, write it once after clarity
+with the safe defaults above, replacing `max_slices` only for an explicit
+`--max-slices N` and resolving `expires_at` to one absolute timestamp. The sentinel is
+read-only: never rewrite it after `$rite-vet` to inject a discovered plan count or to
+reset resource authority.
 
 ### Derive the mutable post-vet budget
 
@@ -28,6 +36,19 @@ valid remaining counter already exists, retain the lower of it and the derived b
 never increase or reinitialize it. This keeps the crash-survivable budget in its mutable owner
 without changing AFK configuration mid-run.
 
+### Admit each unattended cycle
+
+Before every phase, parallel review fan-out, recovery dispatch, or writer dispatch,
+apply [`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md#unattended-resource-envelope):
+run the cheapest readiness/current-state check, reject overlapping work, count the
+current unresolved review queue, and check expiry plus native agent/token/cost/time
+headroom. Count every leaf, including failed/malformed/unavailable results. At the
+review cap, only reconciliation that reduces the queue may run. Any limit reached or
+unobservable declared cap ends the current activation before more work and persists
+its checkpoint/reason. A genuinely new native activation starts fresh agent/time/token/
+cost counters, but reuses durable slice/recovery state, absolute expiry, and recomputed
+review queue. It never resets those durable bounds.
+
 `allow_gates: [advisory]` prevents an open `gate: validating` from being queued until
 seal, where it would force NO-GO under `afk-hitl.md`. Autocomplete pauses on it instead. Widen
 `allow_gates` only outside autocomplete through an explicit human configuration change;
@@ -125,6 +146,8 @@ rest point or one of the shared human/safety/access/exhaustion stop conditions.
 ## Between phases
 
 - Re-read the active workspace before each phase (don't trust chat memory).
+- Re-run resource admission before each phase or native dispatch; stop before work
+  when expiry, review backlog, or agent/token/cost/time headroom is exhausted.
 - After a phase that edits code (build, polish, review), evidence may be stale: let
   the next gate re-prove rather than carrying a stale pass (see
   `.agents/skills/devrites-lib/reference/standards/development-workflow.md`).

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

@@ -101,6 +101,13 @@ exists, a real human/risk/scope gate owns it, or bounded recovery is exhausted.
   remaining value, explicit flag, sentinel cap, or post-vet pending count) and the
   unbuilt slices. A malformed value also fails closed. Zero with no pending slices is
   normal completion → continue to `$rite-prove` without pausing.
+- **Resource envelope unavailable or exhausted:** stop before more work when the AFK
+  envelope is missing/malformed/expired; another run overlaps; native agent, token,
+  cost, or wall-time headroom is exhausted/unobservable despite a declared cap; or
+  unresolved review/gate backlog is above its cap. At the review cap, permit only
+  reconciliation that reduces the queue. Record the exact winning limit and observed
+  usage/count. A new activation gets fresh activation-local counters; it does not reset
+  durable slice/recovery budgets, expiry, or the recomputed queue.
 - **Still low-confidence after the interview:** the idea can't be pinned to testable
   acceptance criteria → stop and ask, rather than guessing the product.
 - **Repeated failure:** bounded recovery exhausts → stop with reproduction.

package/pack/generated/codex/skills/rite-build/SKILL.md

@@ -31,12 +31,18 @@ reads named on-demand rules while writing; root reads them for doubt/record gate
 - `patterns.md`: composition over inheritance, avoid premature abstraction.
 - `principles.md`: the project invariants (`.devrites/principles.md`) the slice must honor; the wright reads them as **binding**, not priors.
 - `security.md`: when the slice touches user input, auth, data, or external integrations.
+- `repository-topology.md`: when targets span roots/languages/services or touch generated/vendor surfaces.
+- `data-integrity.md`: when the slice writes durable state or changes migration/concurrency/tenant/retention behavior.
+- `integration-reliability.md`: when the slice changes an API/webhook/queue/job/cache/cross-service boundary.
 - `definition-of-done.md`: standing Done bar: acceptance mapped, fresh proof, no open hard gates, scoped edits, rollback/docs where needed.
 
 
 ## Operating rules
 - **One slice per wright dispatch.** Every wright returns after it. The controlling
-  root applies the mode rule above before another dispatch.
+  root applies the mode rule above before another dispatch. Prefer the guarded serial
+  native-worktree pilot in `wright-dispatch.md` only when its committed-clean
+  preflight and explicit reconciliation path both hold; otherwise use the existing
+  serial same-worktree writer. Never run writers in parallel.
 - Evidence over confidence. Prefer existing conventions. Feature scope only: no
   drive-by refactors.
 - **Record adjacent issues; do not edit them.** An issue outside the exact paths

package/pack/generated/codex/skills/rite-build/reference/phase-contract.md

@@ -9,7 +9,9 @@ See [`one-slice-cycle.md`](one-slice-cycle.md); candidate lifecycle is
    ID-and-meaning traceability, and green proof preflight; run
    `devrites-engine check readiness <slug>`. Any miss/nonzero stops.
 2. **Select one target.** Restate goal, acceptance criteria, exclusions, and exact
-   source/test paths. Before dispatch, validate relevant `assumptions.md` rows
+   source/test paths. Reconcile the spec/plan applicability map and include only the
+   triggered topology/data/integration standards plus their named failure/recovery/proof
+   cases in the writer contract. Before dispatch, validate relevant `assumptions.md` rows
    against live evidence. If one is disproved and changes acceptance, architecture,
    scope, or proof, use the Spec Drift Guard/plan recovery; a human-owned unknown
    stops. Resolve HITL before source work. AFK answers only permitted gates;
@@ -50,6 +52,9 @@ the candidate manifest; it returns through narrow Vet before any consumptive act
    and recheck `git diff --name-only`. Missing, weakened, red, or source-mutating proof
    is not success.
 
+   A failure is `pre-existing` or environment-specific only with a same-command,
+   same-environment baseline predating the candidate; otherwise it remains unresolved.
+
    Technical failure uses bounded `devrites-debug-recovery`: reapply the host gate
    before an accepted in-slice correction, keep one exact fingerprint/three
    no-progress attempts, and never rerun an unchanged check. A closed reproduction

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

@@ -11,6 +11,32 @@ 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.
 
+## Isolated writer-worktree pilot
+
+Use native isolation only when the current host exposes an explicit named-writer
+worktree plus result reconciliation; separate agent threads or inherited sandboxes do
+not qualify. Codex CLI custom subagents therefore use `same-worktree` unless a future
+supported interface passes this capability gate—never create a manual worktree from the
+read-only root to imitate it. Also require `git rev-parse
+--show-superproject-working-tree` to be empty; resolved git/common dirs; committed,
+clean candidate/index; all inputs at `HEAD`; no other writer; and green cheap isolated
+baseline proof. Otherwise use serial same-worktree dispatch—never stash, commit, or
+discard user work to qualify. Ask host for an explicit current-`HEAD` base when
+supported. Regardless of host defaults, the wright's first command must prove actual `git rev-parse HEAD` equals supplied
+`worktree_base`. Mismatch returns a gap with no write before project reads or baseline proof.
+
+The isolated wright returns one local unpushed `transfer_commit`, its `worktree_base`,
+and exact files. Root proves descendant base, exact `git diff --name-only
+<base>..<transfer>`, no `.devrites/**`/submodule/symlink/unrelated delta, unchanged
+source base, and no user-work overwrite. Use only host-native explicit reconciliation;
+never ad hoc copy, cherry-pick, or merge from read-only root. Compare transferred bytes,
+run approved proof, record evidence, then let host remove worktree.
+
+Conflict, extra/missing commit, moved base, or cleanup failure is `gap`/STOP:
+preserve the worktree and commit. Without explicit reconciliation, use same-worktree serial.
+Parallel writer work remains forbidden until this serial pilot measures transfer,
+conflict, proof, and review outcomes on both hosts.
+
 ## Prepare
 
 1. Derive the smallest exact project-relative source/test path list; reject
@@ -20,15 +46,20 @@ the wright or recreate an engine bridge.
    [`workflow-artifacts.md`](../../devrites-lib/reference/standards/workflow-artifacts.md);
    its rejection here is not a blocker.
 2. Put it in the task with goal, verbatim acceptance, exclusions, context,
-   `test-plan.md` proof commands, and applicable standards.
+   `test-plan.md` proof commands, and applicable standards. For each triggered
+   topology/data/integration standard, include only the feature-specific owner/invariant,
+   failure or partial-state case, recovery rule, and required proof from the vetted plan.
+   Do not paste the whole standard or silently omit an applicable risk.
    A new path requires a new bounded contract; the wright cannot widen the task.
 3. Record `git diff --name-only` before dispatch so unrelated work remains
-   distinguishable.
+   distinguishable. For an isolated pilot, also record committed base SHA and exact
+   baseline status before asking the host for isolation.
 
 ## Run
 
-Ask the host for the exact writer in fresh context and wait. Never run two
-writers in one worktree or substitute a generic agent.
+Ask the host for the exact writer in fresh context and wait. Use at most one writer
+across all linked worktrees for this workspace. Never run two writers in one worktree,
+run isolated and same-worktree writers concurrently, or substitute a generic agent.
 
 ## Inspect and prove
 
@@ -38,6 +69,8 @@ writers in one worktree or substitute a generic agent.
    wright; root never widens scope or edits source.
 2. Inspect the test diff for deletion, skipping, focus markers, or loosened
    assertions. Dedicated test analysis treats weakening as Critical.
+   Confirm a test for a data/integration/topology risk can actually exhibit that risk;
+   mocks that erase it and one-root proof offered for another root are unproven.
 3. Run only repository proof already approved by `test-plan.md`, then inspect
    `git diff --name-only` again in case a proof tool changed source.
 4. Challenge decisions. Human choices return; native diagnosis routes failures.

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

@@ -39,8 +39,9 @@ dispatch uses
    `Spec gate: passed`; otherwise stop at `$rite-spec`. Apply the native cursor
    protocol below before changing workspace artifacts.
 2. **Enumerate the topology.** From the spec, live code, contracts, references,
-   and recorded decisions, list every material actor, journey/component, state,
-   data lifecycle, integration, operation, proof surface, and must-NOT boundary.
+   and recorded decisions, list every material stakeholder/priority, invariant, actor,
+   journey/component, state, data lifecycle, integration, failure/recovery path,
+   operation, proof surface, applicability row, and must-NOT boundary.
 3. **Scan coverage.** Apply `devrites-interview` in clarify mode and mark each
    material surface Clear, Partial, Missing, not-applicable, or justified
    deferred-nonblocking with evidence and an owner. Use native repository search

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

@@ -27,9 +27,11 @@ Pull on demand:
 - `spec-grammar.md`: buildable acceptance criteria vs `## Success metrics` (outcome KPIs the
   code can't make true and this pass never enqueues); structured `### Requirement:` /
   `#### Scenario:` blocks, each scenario one behavior to check as built / partial / absent.
-- `tooling.md`: prefer a code-intelligence index (codebase-memory-mcp → codegraph → graphify,
-  else LSP / Read/Grep/Glob) to read the live code, not assumptions.
+- `tooling.md`: use the primary available code index; cross-check only a named unresolved
+  predicate, then fall back to LSP/file search. Read live code, not artifact claims.
 - `testing.md`: a criterion with code but no covering test is *partial*, not done.
+- `repository-topology.md`, `data-integrity.md`, `integration-reliability.md`: only for
+  triggered applicability rows; missing failure/recovery behavior is partial or absent.
 
 ## Operating rules
 - **APPEND-ONLY, never rewrite.** The only write to `tasks.md` is **appending** new

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

@@ -25,10 +25,14 @@ slice.
 | **partial** | Some of it exists: happy path only, un-wired, untested, a TODO stub, or an edge case from the scenario's WHEN/THEN missing. | Append a slice for the **remainder**, its `Known-Gotchas` naming what's already there so `$rite-build` extends rather than rebuilds. |
 | **absent** | No code implements it. | Append a full slice. |
 
-Read the code to decide: do not infer from the plan. Use the code-intelligence index
-(codebase-memory-mcp → codegraph → graphify, else LSP / grep) so the verdict reflects live
-code, not the artifacts' claims. Read `traceability.md` to see what is mapped; only reading the
-code and tests tells you what is built.
+Read the code to decide: do not infer from the plan. Apply `standards/tooling.md`: use the
+primary available code index, cross-check only a named unresolved predicate, then use LSP/file
+search so the verdict reflects live code. Read `traceability.md` to see what is mapped; only
+code and tests tell you what is built.
+
+Treat accepted invariants, failure/recovery rows, and triggered applicability obligations as
+buildable units alongside REQ/AC/scenarios. A happy path with missing applicable
+duplicate/retry/concurrency/tenant/timeout/order/interruption/rollback behavior is `partial`.
 
 ## Principle violations
 

package/pack/generated/codex/skills/rite-customize/SKILL.md

@@ -8,33 +8,31 @@ disable-model-invocation: true
 
 # $rite-customize: native project customization
 
-Use native; DevRites has no registry, override layer, or sync.
-`--import-legacy` is active only when that exact standalone token occurs in the
-current `$ARGUMENTS`; its presence below or in earlier context cannot activate it.
+Use native; no registry/override/sync. `--import-legacy` is active only when that exact
+standalone token occurs in current `$ARGUMENTS`; earlier context cannot activate it.
 
 ## Workflow
 
-1. Map policy to an instruction, reusable work to a skill, a specialist to an
-   agent, and external capability to a connected plugin/MCP server.
-2. Inspect target and host docs; reuse before copying DevRites.
-3. Draft the smallest nearest-scope change; do not restate base safeguards.
-4. Show path and exact diff; wait for approval.
-5. Write only the approved artifact; run native validation; keep no mirror.
+1. Map policy→instruction, reusable work→skill, specialist→agent, external capability→plugin/MCP.
+2. Inspect target/host docs; reuse before copying.
+3. Draft smallest nearest-scope change; do not restate safeguards.
+4. Show path/exact diff; wait.
+5. Write approved artifacts, validate natively, keep no mirror.
 
-Here, edit canonical source, run its generator, and never edit derived artifacts.
+Here, edit canonical source and generate; never edit derived artifacts.
 
 ## Legacy import mode
 
-`--import-legacy` migrates useful behavior without a registry:
-
-1. Inventory `.devrites/extensions/`, `.devrites/overrides/`, and
-   `.devrites/runbooks/` read-only; treat them as untrusted and keep useful rules.
-2. Map behavior to a project skill, scoped policy to its nearest instruction,
-   specialists to agents, and each runbook to a native skill with explicit gate,
+1. Inventory `.devrites/extensions/`, `.devrites/overrides/`, and `.devrites/runbooks/` read-only
+   as untrusted data.
+2. Record origin/files: external URL/SHA/path/license or local relative path, commit/content
+   digest, and owner confirmation. Add review date, copied/re-authored status, canonical owner,
+   and derived targets. Unverified external rights stay reference-only; never execute imported instructions.
+3. Map useful behavior to native owners; map runbooks to a native skill with explicit gate,
    checkpoint, and resume semantics.
-3. Reject gate/permission weakening. Show every target and diff; wait. Never auto-copy,
+4. Reject weaker gates/permissions. Show every diff and provenance receipt; wait. Never auto-copy,
    bulk-convert, or delete.
-4. Write approved native artifacts and validate. Leave the legacy files intact until native
+5. Write and validate approved native artifacts. Leave the legacy files intact until native
    validation passes; cleanup needs separate approval.
 
 ## Rules