devrites 5.6.0 → 5.7.1

package/pack/generated/pi/skills/rite-status/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-status
-description: User-invoked read-only active-feature report: phase, active slice, next action, evidence, open questions, drift, risks, and handoff readiness.
+description: "User-invoked read-only active-feature report: phase, active slice, next action, evidence, open questions, drift, risks, and handoff readiness."
 argument-hint: "[feature-slug]"
 user-invocable: true
 disable-model-invocation: true

package/pack/generated/pi/skills/rite-temper/SKILL.md

@@ -15,12 +15,12 @@ is no readied `spec.md`, tell the user to run `/rite-spec`. Review depth follows
 the required exact strategy reviewer never changes with profile.
 
 ## Rules consulted (read on demand from `.pi/skills/devrites-lib/reference/standards/`)
-Pull on demand: `patterns.md` +
-`coding-style.md` (the over-engineering / YAGNI rubric (reuse the pack's standard, don't
-invent one), `documentation.md` (ADR-style `decisions.md` entries), `afk-hitl.md`
-(irreversible-risk list + gate ceiling), `elicitation.md` (the move-set to deepen a section
+Pull on demand: [`patterns.md`](../devrites-lib/reference/standards/patterns.md) +
+[`coding-style.md`](../devrites-lib/reference/standards/coding-style.md) (the over-engineering / YAGNI rubric (reuse the pack's standard, don't
+invent one), [`documentation.md`](../devrites-lib/reference/standards/documentation.md) (ADR-style `decisions.md` entries), [`afk-hitl.md`](../devrites-lib/reference/standards/afk-hitl.md)
+(irreversible-risk list + gate ceiling), [`elicitation.md`](../devrites-lib/reference/standards/elicitation.md) (the move-set to deepen a section
 that needs more than the default pre-mortem) selected by the section's risk). Load
-`repository-topology.md`, `data-integrity.md`, or `integration-reliability.md` only when
+[`repository-topology.md`](../devrites-lib/reference/standards/repository-topology.md), [`data-integrity.md`](../devrites-lib/reference/standards/data-integrity.md), or [`integration-reliability.md`](../devrites-lib/reference/standards/integration-reliability.md) only when
 the spec applicability map triggers that risk family.
 
 ## Operating rules
@@ -32,12 +32,12 @@ the spec applicability map triggers that risk family.
 - **Apply maximum caution to hard-to-reverse changes.** Auth, migration, public API, and
   data-model changes always pause under the irreversible-risk list.
 - **Honest verdict.** Never round "needs work" up to "ready"; record every scope call's *why*.
-- **Search before asking.** Apply `afk-hitl.md` decision ownership; only human-owned calls
+- **Search before asking.** Apply [`afk-hitl.md`](../devrites-lib/reference/standards/afk-hitl.md) decision ownership; only human-owned calls
   enter the interactive walk.
 - **You write; the reviewer judges.** You are the single canonical writer (`strategy.md` +
   the spec edits); the reviewer agent is read-only.
 - **Require spec-quality checklists for significant features.** Before hardening,
-  confirm `checklists/<domain>.md` exist and pass (`rite-spec/reference/spec-checklists.md`); a
+  confirm `checklists/<domain>.md` exist and pass ([`spec-checklists.md`](../rite-spec/reference/spec-checklists.md)); a
   scope expansion you fold in **adds its own** rows (new Success/Acceptance criteria get
   checklist rows too). A folded expansion with an unquantified criterion is a CRITICAL
   failure that reopens the readiness gate.

package/pack/generated/pi/skills/rite-temper/reference/review-dimensions.md

@@ -17,7 +17,7 @@ the gate uses the **lowest band**, not an average.
    human prerequisites and action-time approvals instead of deferring generic uncertainty to
    build. **Unmitigated top risks are gating.**
 5. **Over-engineering / YAGNI:** speculative capability, unused extension points, premature
-   abstraction, second-system bloat. Apply the pack's standard (`patterns.md`) and the YAGNI
+   abstraction, second-system bloat. Apply the pack's standard ([`patterns.md`](../../devrites-lib/reference/standards/patterns.md)) and the YAGNI
    ledger test (scope-modes.md Pass 2).
 6. **Acceptance testability and completion:** every acceptance criterion measurable, technology-
    agnostic, and comparable **down to a baseline** ("better than the current workaround"), not
@@ -32,7 +32,7 @@ the gate uses the **lowest band**, not an average.
    and patterns, or assume greenfield freedom a constrained space doesn't have? Prefer existing
    conventions; flag a new dependency / second design system for explicit decision.
 
-UI specs also inherit `rite-polish/reference/anti-ai-slop.md` at the cross-cutting
+UI specs also inherit [`anti-ai-slop.md`](../../rite-polish/reference/anti-ai-slop.md) at the cross-cutting
 dimension (design-system fit, anti-AI-slop), but `/rite-temper` reviews the *spec/design-brief*,
 not pixels; the built UI is judged later by `devrites-frontend-reviewer`.
 

package/pack/generated/pi/skills/rite-temper/reference/scope-modes.md

@@ -26,7 +26,7 @@ Invert. Two subtractive moves:
 - **YAGNI ledger.** Each candidate scope item gets the "imagine the later refactor" test: if
   adding it *later* isn't materially more expensive, **defer it** (with a revisit note).
   Bias hard toward defer: most presumed-needed features are never used. Reuse the
-  pack's existing `patterns.md` standard ('no speculative abstraction or pattern
+  pack's existing [`patterns.md`](../../devrites-lib/reference/standards/patterns.md) standard ('no speculative abstraction or pattern
   without a current need'). Don't invent a new YAGNI rule.
 
 ## The four modes: commit exactly one
@@ -43,7 +43,7 @@ Mode selection is the first convergence move. Record the chosen mode + rationale
 ## Bound ambition by reversibility
 The bigger the bet, the more it must be reversible. Irreversible-risk areas (auth, migrations,
 public API, data model) get the **opposite** of ambition: maximum conservatism, explicit
-rollback, and they **always pause** regardless of mode (the `afk-hitl.md` irreversible-risk
+rollback, and they **always pause** regardless of mode (the [`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md) irreversible-risk
 list is honored verbatim). Size big bets so that if the whole thing vanished tomorrow, you'd be
 fine.
 

package/pack/generated/pi/skills/rite-temper/reference/significance.md

@@ -6,7 +6,7 @@ optional `/rite-temper` path and the always-run (significance-gated) `/rite-auto
 so they agree on when it fires.
 
 ## Fire the FULL review when ANY trips
-- **Irreversible-risk contact:** the slice/spec touches anything on the `afk-hitl.md`
+- **Irreversible-risk contact:** the slice/spec touches anything on the [`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md)
   irreversible-risk list: destructive data migration, auth/authz boundary, public-API break,
   external-service contract, filesystem destruction outside the workspace.
 - **Data model:** new/changed entities, relationships, or persistence shape.

package/pack/generated/pi/skills/rite-upgrade/SKILL.md

@@ -14,7 +14,7 @@ structural migration, or generic cleanup.
 
 ## Rules consulted
 
-Read `devrites-lib/reference/standards/core.md`, its agent and workspace-schema
+Read [`core.md`](../devrites-lib/reference/standards/core.md), its agent and workspace-schema
 references, and only current phase contracts needed for the observed gap.
 
 ## Invariants

package/pack/generated/pi/skills/rite-vet/SKILL.md

@@ -15,15 +15,15 @@ Vet owns implementation; current `$ARGUMENTS` (`--full`) feeds the depth trigger
 
 ## Rules
 
-Read the active standard from: `principles.md`, `patterns.md`, `coding-style.md`,
-`testing.md`, `spec-grammar.md`, `performance.md`, `error-handling.md`,
-`development-workflow.md`, `afk-hitl.md`, `one-shot-actions.md`,
-`developer-experience.md`, `elicitation.md`, and `definition-of-done.md`. Load
+Read the active standard from: [`principles.md`](../devrites-lib/reference/standards/principles.md), [`patterns.md`](../devrites-lib/reference/standards/patterns.md), [`coding-style.md`](../devrites-lib/reference/standards/coding-style.md),
+[`testing.md`](../devrites-lib/reference/standards/testing.md), [`spec-grammar.md`](../devrites-lib/reference/standards/spec-grammar.md), [`performance.md`](../devrites-lib/reference/standards/performance.md), [`error-handling.md`](../devrites-lib/reference/standards/error-handling.md),
+[`development-workflow.md`](../devrites-lib/reference/standards/development-workflow.md), [`afk-hitl.md`](../devrites-lib/reference/standards/afk-hitl.md), [`one-shot-actions.md`](../devrites-lib/reference/standards/one-shot-actions.md),
+[`developer-experience.md`](../devrites-lib/reference/standards/developer-experience.md), [`elicitation.md`](../devrites-lib/reference/standards/elicitation.md), and [`definition-of-done.md`](../devrites-lib/reference/standards/definition-of-done.md). Load
 repository topology, data integrity, and integration reliability only when
 triggered. Before classifying any Reslice, read `.pi/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md`.
 When a
 plan declares a root-authored executable workflow file, read
-`workflow-artifacts.md`.
+[`workflow-artifacts.md`](../devrites-lib/reference/standards/workflow-artifacts.md).
 
 <!-- BEGIN RESLICE ROUTE-TO-ACTION -->
 - `FOLD` → fold technical topology; invalidate Vet/readiness; affected Vet before Build.

package/pack/generated/pi/skills/rite-vet/reference/artifacts.md

@@ -126,7 +126,7 @@ prove only their named static criterion.
 
 ## Interaction inventory (UI slices — every element + flow gets an asserting test)
 Enumerate every interactive element and user flow the feature exposes; one row each, none
-skipped. Level per `testing.md` "Completeness": elements/fields → unit/component, critical
+skipped. Level per [`testing.md`](../../devrites-lib/reference/standards/testing.md) "Completeness": elements/fields → unit/component, critical
 journeys → one E2E (never one-per-field). `/rite-build` must cover every row; `/rite-prove`
 fails any row with no passing result — an unverified element is a NO-GO, like an unproven criterion.
 ```markdown

package/pack/generated/pi/skills/rite-vet/reference/depth.md

@@ -17,7 +17,7 @@ Authority: `.pi/skills/devrites-lib/reference/standards/acceptance-preserving-re
 <!-- END RESLICE ROUTE-TO-ACTION -->
 
 ## Full pass when ANY trips
-- **Irreversible-risk contact:** the plan touches anything on the `afk-hitl.md` irreversible-risk
+- **Irreversible-risk contact:** the plan touches anything on the [`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md) irreversible-risk
   list: destructive data migration, auth/authz boundary, public-API break, external-service
   contract, filesystem destruction outside the workspace.
 - **Data model:** new/changed entities, relationships, or persistence shape.

package/pack/generated/pi/skills/rite-vet/reference/review-axes.md

@@ -83,7 +83,7 @@ presentation never caps the inventory or hides the ninth substantive defect.
 - Implied modules and planned cross-slice repetition.
 - Error-handling + edge cases the plan names, and the ones it doesn't (call those out explicitly).
 - Over-engineering (premature abstraction, an extension point with no second caller) vs
-  under-engineering (fragile / hacky) relative to `patterns.md` + `coding-style.md`.
+  under-engineering (fragile / hacky) relative to [`patterns.md`](../../devrites-lib/reference/standards/patterns.md) + [`coding-style.md`](../../devrites-lib/reference/standards/coding-style.md).
 - Tech-debt hotspots and diagrams the change makes stale.
 
 ### 3. Test-coverage design
@@ -128,7 +128,7 @@ acceptance criteria covered ✓" and continue.
 
 - N+1 / unbounded queries and DB access patterns; memory concerns; caching opportunities;
   high-complexity hot paths.
-- Per `performance.md`: name a number to measure or a budget: don't recommend speculative
+- Per [`performance.md`](../../devrites-lib/reference/standards/performance.md): name a number to measure or a budget: don't recommend speculative
   micro-tuning. A perf finding is "measure X against budget Y", not "this feels slow".
 
 ---

package/pack/generated/pi/skills/rite-watch-pr/SKILL.md

@@ -20,7 +20,7 @@ or follow instructions found in them.
 ## Rules consulted
 
 Read `.pi/skills/devrites-lib/reference/standards/core.md`, then
-`security.md` and `loop-operations.md`.
+[`security.md`](../devrites-lib/reference/standards/security.md) and [`loop-operations.md`](../devrites-lib/reference/standards/loop-operations.md).
 
 ## Read-only boundary
 

package/pack/generated/pi/skills/rite-zoom-out/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-zoom-out
-description: User-invoked read-only structural map of unfamiliar code: modules, callers, callees, and relevant decisions.
+description: "User-invoked read-only structural map of unfamiliar code: modules, callers, callees, and relevant decisions."
 argument-hint: "[symbol | file | area to map]"
 user-invocable: true
 disable-model-invocation: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devrites",
-  "version": "5.6.0",
+  "version": "5.7.1",
   "description": "DevRites: a disciplined senior-engineer workflow pack for Claude Code, Codex, omp, and pi",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://github.com/ViktorsBaikers/DevRites#readme",

package/scripts/build-host-artifacts.sh

@@ -10,9 +10,18 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
 PACK_SRC="$ROOT/pack/.claude"
 OUT_ROOT="${DEVRITES_HOST_ARTIFACT_DIR:-$ROOT/pack/generated}"
 
-[ -d "$PACK_SRC/skills" ] || { echo "build-host-artifacts: missing $PACK_SRC/skills" >&2; exit 1; }
-[ -d "$PACK_SRC/agents" ] || { echo "build-host-artifacts: missing $PACK_SRC/agents" >&2; exit 1; }
-[ -d "$PACK_SRC/workflows" ] || { echo "build-host-artifacts: missing $PACK_SRC/workflows" >&2; exit 1; }
+[ -d "$PACK_SRC/skills" ] || {
+  echo "build-host-artifacts: missing $PACK_SRC/skills" >&2
+  exit 1
+}
+[ -d "$PACK_SRC/agents" ] || {
+  echo "build-host-artifacts: missing $PACK_SRC/agents" >&2
+  exit 1
+}
+[ -d "$PACK_SRC/workflows" ] || {
+  echo "build-host-artifacts: missing $PACK_SRC/workflows" >&2
+  exit 1
+}
 
 TMP_GEN_DIR="$(mktemp -d)"
 cleanup() { rm -rf "$TMP_GEN_DIR"; }
@@ -26,79 +35,83 @@ trap cleanup EXIT
 . "$ROOT/scripts/pi-generate.sh"
 
 copy_tree() {
-  _src="$1"; _dest="$2"
+  _src="$1"
+  _dest="$2"
   mkdir -p "$(dirname "$_dest")"
   rm -rf "$_dest"
   cp -R "$_src" "$_dest"
 }
 
 render_codex_skill_tree() {
-  _sd="$1"; _dest="$2"
+  _sd="$1"
+  _dest="$2"
   mkdir -p "$_dest"
   while IFS= read -r f; do
     _r="${f#$_sd/}"
     _out="$_dest/$_r"
     mkdir -p "$(dirname "$_out")"
     case "$_r" in
-      SKILL.md)
-        _implicit_disabled=0
-        if awk 'NR==1&&$0=="---"{fm=1;next} fm&&$0=="---"{exit} fm&&/^disable-model-invocation:[[:space:]]*true/{u=1} END{exit !u}' "$f"; then
-          _implicit_disabled=1
-        fi
-        gen_codex_skill_file "$f" "$_out"
-        if [ "$_implicit_disabled" -eq 1 ]; then
-          mkdir -p "$_dest/agents"
-          printf 'policy:\n  allow_implicit_invocation: false\n' > "$_dest/agents/openai.yaml"
-        fi
-        ;;
-      *.md)
-        gen_codex_markdown_file "$f" "$_out"
-        ;;
-      *)
-        cp "$f" "$_out"
-        ;;
+    SKILL.md)
+      _implicit_disabled=0
+      if awk 'NR==1&&$0=="---"{fm=1;next} fm&&$0=="---"{exit} fm&&/^disable-model-invocation:[[:space:]]*true/{u=1} END{exit !u}' "$f"; then
+        _implicit_disabled=1
+      fi
+      gen_codex_skill_file "$f" "$_out"
+      if [ "$_implicit_disabled" -eq 1 ]; then
+        mkdir -p "$_dest/agents"
+        printf 'policy:\n  allow_implicit_invocation: false\n' >"$_dest/agents/openai.yaml"
+      fi
+      ;;
+    *.md)
+      gen_codex_markdown_file "$f" "$_out"
+      ;;
+    *)
+      cp "$f" "$_out"
+      ;;
     esac
   done < <(find "$_sd" -type f)
 }
 
 render_omp_skill_tree() {
-  _sd="$1"; _dest="$2"
+  _sd="$1"
+  _dest="$2"
   mkdir -p "$_dest"
   while IFS= read -r f; do
     _r="${f#$_sd/}"
     _out="$_dest/$_r"
     mkdir -p "$(dirname "$_out")"
     case "$_r" in
-      SKILL.md)
-        gen_omp_skill_file "$f" "$_out"
-        ;;
-      *.md)
-        gen_omp_markdown_file "$f" "$_out"
-        ;;
-      *)
-        cp "$f" "$_out"
-        ;;
+    SKILL.md)
+      gen_omp_skill_file "$f" "$_out"
+      ;;
+    *.md)
+      gen_omp_markdown_file "$f" "$_out"
+      ;;
+    *)
+      cp "$f" "$_out"
+      ;;
     esac
   done < <(find "$_sd" -type f)
 }
 
 render_pi_skill_tree() {
-  _sd="$1"; _dest="$2"
+  _sd="$1"
+  _dest="$2"
   mkdir -p "$_dest"
   while IFS= read -r f; do
     _r="${f#$_sd/}"
     _out="$_dest/$_r"
     mkdir -p "$(dirname "$_out")"
     case "$_r" in
-      SKILL.md)
-        gen_pi_skill_file "$f" "$_out"
-        ;;
-      *.md)
-        gen_pi_markdown_file "$f" "$_out"
-        ;;
-      *)
-        cp "$f" "$_out"
-        ;;
+    SKILL.md)
+      gen_pi_skill_file "$f" "$_out"
+      ;;
+    *.md)
+      gen_pi_markdown_file "$f" "$_out"
+      ;;
+    *)
+      cp "$f" "$_out"
+      ;;
     esac
   done < <(find "$_sd" -type f)
 }
@@ -155,9 +168,9 @@ while IFS= read -r d; do
   [ "$name" = ".impeccable" ] && continue
   render_pi_skill_tree "$d" "$OUT_ROOT/pi/skills/$name"
   case "$name" in
-    rite|rite-*)
-      gen_pi_prompt_stub "$d/SKILL.md" "$name" "$OUT_ROOT/pi/prompts/$name.md"
-      ;;
+  rite | rite-*)
+    gen_pi_prompt_stub "$d/SKILL.md" "$name" "$OUT_ROOT/pi/prompts/$name.md"
+    ;;
   esac
 done < <(find "$PACK_SRC/skills" -mindepth 1 -maxdepth 1 -type d)
 
@@ -168,7 +181,7 @@ done < <(find "$PACK_SRC/agents" -maxdepth 1 -type f -name '*.md')
 
 gen_pi_agents_bridge "$OUT_ROOT/pi/AGENTS.md"
 
-cat > "$OUT_ROOT/README.md" <<'EOF'
+cat >"$OUT_ROOT/README.md" <<'EOF'
 # Generated DevRites Host Artifacts
 
 This directory is generated by `scripts/build-host-artifacts.sh`.

package/scripts/pi-generate.sh

@@ -56,7 +56,7 @@ gen_pi_markdown_file() {
     -e 's#verb dispatches to the matching `rite-<verb>` skill#verb invokes the matching `rite-<verb>` skill#g' \
     -e 's#the dispatch map only#the invocation map only#g' \
     -e 's#→ dispatch per the table above#→ invoke the matching skill per the table above#g' \
-    "$_src" > "$_out"
+    "$_src" >"$_out"
 }
 
 gen_pi_skill_file() {
@@ -88,15 +88,15 @@ _pi_map_tools() {
     _tok="${_tok%"${_tok##*[![:space:]]}"}"
     [ -z "$_tok" ] && continue
     case "$_tok" in
-      Read|read) _mapped="read" ;;
-      Edit|edit) _mapped="edit" ;;
-      Write|write) _mapped="write" ;;
-      Bash|bash) _mapped="bash" ;;
-      Grep|grep) _mapped="grep" ;;
-      Glob|glob) _mapped="find" ;;
-      LS|ls) _mapped="ls" ;;
-      Skill|skill) continue ;;
-      *) continue ;;
+    Read | read) _mapped="read" ;;
+    Edit | edit) _mapped="edit" ;;
+    Write | write) _mapped="write" ;;
+    Bash | bash) _mapped="bash" ;;
+    Grep | grep) _mapped="grep" ;;
+    Glob | glob) _mapped="find" ;;
+    LS | ls) _mapped="ls" ;;
+    Skill | skill) continue ;;
+    *) continue ;;
     esac
     _out="${_out}${_sep}${_mapped}"
     _sep=", "
@@ -129,7 +129,7 @@ gen_pi_agent() {
   _tools="$(_pi_map_tools "$_tools_raw" "$_name")"
   _desc_tmp="$TMP_GEN_DIR/pi-agent-desc-$(basename "$_src").txt"
   _desc_pi="$TMP_GEN_DIR/pi-agent-desc-$(basename "$_src").pi.txt"
-  printf '%s' "$_desc" > "$_desc_tmp"
+  printf '%s' "$_desc" >"$_desc_tmp"
   gen_pi_markdown_file "$_desc_tmp" "$_desc_pi"
   _desc="$(cat "$_desc_pi")"
   [ -n "$_desc" ] || _desc="DevRites custom agent."
@@ -144,10 +144,10 @@ gen_pi_agent() {
     printf '%s\n' "---"
     _body_tmp="$TMP_GEN_DIR/pi-agent-body-$(basename "$_src").md"
     _body_pi="$TMP_GEN_DIR/pi-agent-body-$(basename "$_src").pi.md"
-    awk 'NR==1 && $0=="---"{fm=1; next} fm && $0=="---"{fm=0; body=1; next} body{print}' "$_src" > "$_body_tmp"
+    awk 'NR==1 && $0=="---"{fm=1; next} fm && $0=="---"{fm=0; body=1; next} body{print}' "$_src" >"$_body_tmp"
     gen_pi_markdown_file "$_body_tmp" "$_body_pi"
     cat "$_body_pi"
-  } > "$_out"
+  } >"$_out"
 }
 
 # Write a pi prompt template that preserves the public /<name> command form.
@@ -166,12 +166,12 @@ gen_pi_prompt_stub() {
     [ -n "$_hint" ] && printf 'argument-hint: "%s"\n' "$(pi_yaml_escape "$_hint")"
     printf '%s\n' "---"
     printf 'Read and follow the DevRites skill at `.pi/skills/%s/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.\n' "$_name"
-  } > "$_out"
+  } >"$_out"
 }
 
 gen_pi_agents_bridge() {
   _out="$1"
-  cat > "$_out" <<'EOF'
+  cat >"$_out" <<'EOF'
 <!-- BEGIN DEVRITES PI -->
 ## DevRites For pi