devrites 5.6.0 → 5.7.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to DevRites are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and DevRites adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Releases are generated automatically by [semantic-release](https://semantic-release.gitbook.io/) from Conventional Commits on `main`.
 
+## [5.7.0](https://github.com/ViktorsBaikers/DevRites/compare/v5.6.0...v5.7.0) (2026-09-13)
+
+### Added
+
+* **installer:** pi as fourth host target + skill frontmatter YAML fix ([#70](https://github.com/ViktorsBaikers/DevRites/issues/70)) ([9275755](https://github.com/ViktorsBaikers/DevRites/commit/92757555f4c6cf74f8cdec5f8e8688ec28360508))
+
 ## [5.6.0](https://github.com/ViktorsBaikers/DevRites/compare/v5.5.0...v5.6.0) (2026-09-13)
 
 ### Added

package/README.md

@@ -33,7 +33,7 @@ project-conventional push, tag, or PR action, and archive the workspace.
 Unattended runs may create local WIP checkpoint commits along the way, but they
 remain local unless Ship's disclosed plan includes an approved remote action.
 
-**Status:** [`v5.6.0`](https://github.com/ViktorsBaikers/DevRites/releases/tag/v5.6.0): see [`CHANGELOG.md`](CHANGELOG.md) for release notes.
+**Status:** [`v5.7.0`](https://github.com/ViktorsBaikers/DevRites/releases/tag/v5.7.0): see [`CHANGELOG.md`](CHANGELOG.md) for release notes.
 
 This is the latest published release; `main` may contain unreleased work.
 

package/install.sh

@@ -28,8 +28,8 @@ normalize_release_tag() {
   printf '%s\n' "$version" | LC_ALL=C grep -Eq '^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*)?(\+[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*)?$' || return 1
   prerelease="${version%%+*}"
   case "$prerelease" in
-    *-*) prerelease="${prerelease#*-}" ;;
-    *) prerelease="" ;;
+  *-*) prerelease="${prerelease#*-}" ;;
+  *) prerelease="" ;;
   esac
   if [ -n "$prerelease" ]; then
     printf '%s\n' "$prerelease" | awk -F. '{ for (i = 1; i <= NF; i++) if ($i ~ /^[0-9]+$/ && length($i) > 1 && substr($i, 1, 1) == "0") exit 1 }' || return 1
@@ -45,11 +45,11 @@ bounded_curl() {
   DOWNLOAD_FAILURE=""
   rm -f "$out" "$out.part"
   curl -fL --proto '=https' --proto-redir '=https' --tlsv1.2 --connect-timeout 10 --max-time "$seconds" \
-    "$url" 2>/dev/null | head -c "$((limit + 1))" > "$out.part"
+    "$url" 2>/dev/null | head -c "$((limit + 1))" >"$out.part"
   pipeline_status=("${PIPESTATUS[@]}")
   curl_status="${pipeline_status[0]}"
   head_status="${pipeline_status[1]}"
-  bytes="$(wc -c < "$out.part" 2>/dev/null)" || {
+  bytes="$(wc -c <"$out.part" 2>/dev/null)" || {
     DOWNLOAD_FAILURE="local write"
     rm -f "$out.part"
     return 1
@@ -66,15 +66,19 @@ bounded_curl() {
   fi
   if [ "$curl_status" -ne 0 ]; then
     case "$curl_status" in
-      22) DOWNLOAD_FAILURE="HTTP status" ;;
-      28) DOWNLOAD_FAILURE="timeout" ;;
-      47) DOWNLOAD_FAILURE="redirect" ;;
-      *) DOWNLOAD_FAILURE="download" ;;
+    22) DOWNLOAD_FAILURE="HTTP status" ;;
+    28) DOWNLOAD_FAILURE="timeout" ;;
+    47) DOWNLOAD_FAILURE="redirect" ;;
+    *) DOWNLOAD_FAILURE="download" ;;
     esac
     rm -f "$out.part"
     return 1
   fi
-  mv "$out.part" "$out" || { DOWNLOAD_FAILURE="local write"; rm -f "$out.part"; return 1; }
+  mv "$out.part" "$out" || {
+    DOWNLOAD_FAILURE="local write"
+    rm -f "$out.part"
+    return 1
+  }
 }
 
 bounded_decompress() {
@@ -83,11 +87,11 @@ bounded_decompress() {
   limit="$3"
   DECOMPRESS_FAILURE=""
   rm -f "$out" "$out.part"
-  gzip -dc "$archive" 2>/dev/null | head -c "$((limit + 1))" > "$out.part"
+  gzip -dc "$archive" 2>/dev/null | head -c "$((limit + 1))" >"$out.part"
   pipeline_status=("${PIPESTATUS[@]}")
   gzip_status="${pipeline_status[0]}"
   head_status="${pipeline_status[1]}"
-  bytes="$(wc -c < "$out.part" 2>/dev/null)" || {
+  bytes="$(wc -c <"$out.part" 2>/dev/null)" || {
     DECOMPRESS_FAILURE="could not write bounded archive"
     rm -f "$out.part"
     return 1
@@ -107,7 +111,11 @@ bounded_decompress() {
     rm -f "$out.part"
     return 1
   fi
-  mv "$out.part" "$out" || { DECOMPRESS_FAILURE="could not write bounded archive"; rm -f "$out.part"; return 1; }
+  mv "$out.part" "$out" || {
+    DECOMPRESS_FAILURE="could not write bounded archive"
+    rm -f "$out.part"
+    return 1
+  }
 }
 
 verify_sha256() {
@@ -173,19 +181,31 @@ preflight_archive() {
 bootstrap_bundle() {
   script="install"
   case "${1:-}" in
-    install|update|uninstall)
-      script="$1"
-      shift
-      ;;
+  install | update | uninstall)
+    script="$1"
+    shift
+    ;;
   esac
   if [ "${DEVRITES_BOOTSTRAPPED:-0}" = "1" ]; then
     echo "error: bootstrap re-exec did not find pack/ - aborting to avoid a loop." >&2
     exit 1
   fi
-  command -v curl >/dev/null 2>&1 || { echo "error: curl is required for the network installer." >&2; exit 1; }
-  command -v gzip >/dev/null 2>&1 || { echo "error: gzip is required for the network installer." >&2; exit 1; }
-  command -v tar >/dev/null 2>&1 || { echo "error: tar is required for the network installer." >&2; exit 1; }
-  valid_repo "$DEVRITES_REPO" || { echo "error: DEVRITES_REPO must be an owner/repository name." >&2; exit 1; }
+  command -v curl >/dev/null 2>&1 || {
+    echo "error: curl is required for the network installer." >&2
+    exit 1
+  }
+  command -v gzip >/dev/null 2>&1 || {
+    echo "error: gzip is required for the network installer." >&2
+    exit 1
+  }
+  command -v tar >/dev/null 2>&1 || {
+    echo "error: tar is required for the network installer." >&2
+    exit 1
+  }
+  valid_repo "$DEVRITES_REPO" || {
+    echo "error: DEVRITES_REPO must be an owner/repository name." >&2
+    exit 1
+  }
   old_umask="$(umask)"
   umask 077
   BOOTSTRAP_DIR="$(mktemp -d "${TMPDIR:-/tmp}/devrites-bootstrap.XXXXXX" 2>/dev/null)" || {
@@ -197,7 +217,10 @@ bootstrap_bundle() {
   trap 'exit 1' HUP INT TERM
   trap 'rm -rf "$BOOTSTRAP_DIR"' EXIT
   if [ -n "$DEVRITES_REF" ]; then
-    tag="$(normalize_release_tag "$DEVRITES_REF")" || { echo "error: DEVRITES_REF must be an exact semantic version." >&2; exit 1; }
+    tag="$(normalize_release_tag "$DEVRITES_REF")" || {
+      echo "error: DEVRITES_REF must be an exact semantic version." >&2
+      exit 1
+    }
   else
     metadata="$BOOTSTRAP_DIR/latest.json"
     bounded_curl "https://api.github.com/repos/$DEVRITES_REPO/releases/latest" "$metadata" "$BOOTSTRAP_MAX_METADATA" 30 || {
@@ -205,23 +228,53 @@ bootstrap_bundle() {
       exit 1
     }
     metadata_tag="$(sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$metadata" | head -n1)"
-    tag="$(normalize_release_tag "$metadata_tag")" || { echo "error: latest release did not provide an exact semantic version." >&2; exit 1; }
+    tag="$(normalize_release_tag "$metadata_tag")" || {
+      echo "error: latest release did not provide an exact semantic version." >&2
+      exit 1
+    }
   fi
   asset="devrites-$tag.tar.gz"
   archive="$BOOTSTRAP_DIR/$asset"
   sidecar="$archive.sha256"
   url="https://github.com/$DEVRITES_REPO/releases/download/$tag/$asset"
-  bounded_curl "$url" "$archive" "$BOOTSTRAP_MAX_ARCHIVE" 120 || { echo "error: release $tag asset $asset: ${DOWNLOAD_FAILURE:-download} failed." >&2; exit 1; }
-  bounded_curl "$url.sha256" "$sidecar" "$BOOTSTRAP_MAX_SIDECAR" 30 || { rm -f "$archive"; echo "error: release $tag asset $asset.sha256: ${DOWNLOAD_FAILURE:-download} failed." >&2; exit 1; }
-  verify_sha256 "$archive" "$sidecar" "$asset" || { rm -f "$archive" "$sidecar"; echo "error: release $tag asset $asset: checksum failed." >&2; exit 1; }
+  bounded_curl "$url" "$archive" "$BOOTSTRAP_MAX_ARCHIVE" 120 || {
+    echo "error: release $tag asset $asset: ${DOWNLOAD_FAILURE:-download} failed." >&2
+    exit 1
+  }
+  bounded_curl "$url.sha256" "$sidecar" "$BOOTSTRAP_MAX_SIDECAR" 30 || {
+    rm -f "$archive"
+    echo "error: release $tag asset $asset.sha256: ${DOWNLOAD_FAILURE:-download} failed." >&2
+    exit 1
+  }
+  verify_sha256 "$archive" "$sidecar" "$asset" || {
+    rm -f "$archive" "$sidecar"
+    echo "error: release $tag asset $asset: checksum failed." >&2
+    exit 1
+  }
   uncompressed="$BOOTSTRAP_DIR/devrites-$tag.tar"
-  bounded_decompress "$archive" "$uncompressed" "$BOOTSTRAP_MAX_UNCOMPRESSED" || { rm -f "$archive" "$sidecar"; echo "error: release $tag asset $asset: ${DECOMPRESS_FAILURE:-decompression failed}." >&2; exit 1; }
-  preflight_archive "$uncompressed" "$tag" || { rm -f "$archive" "$sidecar" "$uncompressed"; echo "error: release $tag asset $asset: archive preflight failed." >&2; exit 1; }
+  bounded_decompress "$archive" "$uncompressed" "$BOOTSTRAP_MAX_UNCOMPRESSED" || {
+    rm -f "$archive" "$sidecar"
+    echo "error: release $tag asset $asset: ${DECOMPRESS_FAILURE:-decompression failed}." >&2
+    exit 1
+  }
+  preflight_archive "$uncompressed" "$tag" || {
+    rm -f "$archive" "$sidecar" "$uncompressed"
+    echo "error: release $tag asset $asset: archive preflight failed." >&2
+    exit 1
+  }
   extract="$BOOTSTRAP_DIR/extract"
   mkdir "$extract" || exit 1
-  tar -C "$extract" -xf "$uncompressed" || { rm -rf "$extract"; echo "error: could not extract bounded DevRites tarball" >&2; exit 1; }
+  tar -C "$extract" -xf "$uncompressed" || {
+    rm -rf "$extract"
+    echo "error: could not extract bounded DevRites tarball" >&2
+    exit 1
+  }
   bundle="$extract/devrites-$tag"
-  [ -f "$bundle/$script.sh" ] || { rm -rf "$extract"; echo "error: extracted bundle is missing $script.sh" >&2; exit 1; }
+  [ -f "$bundle/$script.sh" ] || {
+    rm -rf "$extract"
+    echo "error: extracted bundle is missing $script.sh" >&2
+    exit 1
+  }
   chmod +x "$bundle/install.sh" "$bundle/uninstall.sh" "$bundle/update.sh" 2>/dev/null || true
   echo "DevRites: bootstrapped from $tag"
   export DEVRITES_BOOTSTRAPPED=1
@@ -235,25 +288,38 @@ if [ -z "$SELF_DIR" ] || [ ! -d "$SELF_DIR/pack" ]; then
 fi
 
 INSTALL_LIB="$SELF_DIR/scripts/install-lib.sh"
-[ -f "$INSTALL_LIB" ] || { echo "error: extracted bundle is missing scripts/install-lib.sh" >&2; exit 1; }
+[ -f "$INSTALL_LIB" ] || {
+  echo "error: extracted bundle is missing scripts/install-lib.sh" >&2
+  exit 1
+}
 . "$INSTALL_LIB"
 
-DR_ENGINE_PATH=""; DR_ENGINE_TMP=""
+DR_ENGINE_PATH=""
+DR_ENGINE_TMP=""
 trap dr_cleanup_engine EXIT
 trap 'exit 1' HUP INT TERM
-dr_acquire_engine "$SELF_DIR" install "$DEVRITES_REPO" || { echo "error: could not acquire devrites-engine (no usable installed binary and no matching verified release binary${DR_ACQUIRE_FAILURE:+; $DR_ACQUIRE_FAILURE})." >&2; exit 1; }
+dr_acquire_engine "$SELF_DIR" install "$DEVRITES_REPO" || {
+  echo "error: could not acquire devrites-engine (no usable installed binary and no matching verified release binary${DR_ACQUIRE_FAILURE:+; $DR_ACQUIRE_FAILURE})." >&2
+  exit 1
+}
 ENGINE="$DR_ENGINE_PATH"
 PAYLOAD="${DEVRITES_HOST_ARTIFACT_DIR:-$SELF_DIR/pack/generated}"
-if [ ! -d "$PAYLOAD/claude/skills" ] || [ ! -d "$PAYLOAD/codex/skills" ] \
-  || [ ! -d "$PAYLOAD/pi/skills" ] || [ ! -d "$PAYLOAD/pi/agents" ] \
-  || [ ! -d "$PAYLOAD/pi/prompts" ] \
-  || [ ! -f "$PAYLOAD/claude/skills/devrites-lib/reference/standards/agents.md" ] \
-  || [ ! -f "$PAYLOAD/codex/skills/devrites-lib/reference/standards/agents.md" ] \
-  || [ ! -f "$PAYLOAD/pi/skills/devrites-lib/reference/standards/agents.md" ] \
-  || [ ! -f "$PAYLOAD/codex/config.toml" ] || [ ! -f "$PAYLOAD/pi/AGENTS.md" ]; then
+if [ ! -d "$PAYLOAD/claude/skills" ] || [ ! -d "$PAYLOAD/codex/skills" ] ||
+  [ ! -d "$PAYLOAD/pi/skills" ] || [ ! -d "$PAYLOAD/pi/agents" ] ||
+  [ ! -d "$PAYLOAD/pi/prompts" ] ||
+  [ ! -f "$PAYLOAD/claude/skills/devrites-lib/reference/standards/agents.md" ] ||
+  [ ! -f "$PAYLOAD/codex/skills/devrites-lib/reference/standards/agents.md" ] ||
+  [ ! -f "$PAYLOAD/pi/skills/devrites-lib/reference/standards/agents.md" ] ||
+  [ ! -f "$PAYLOAD/codex/config.toml" ] || [ ! -f "$PAYLOAD/pi/AGENTS.md" ]; then
   BUILDER="$SELF_DIR/scripts/build-host-artifacts.sh"
-  [ -f "$BUILDER" ] || { echo "error: generated install payload missing at $PAYLOAD and builder missing at $BUILDER" >&2; exit 1; }
-  DEVRITES_HOST_ARTIFACT_DIR="$PAYLOAD" bash "$BUILDER" >/dev/null || { echo "error: could not generate install payload at $PAYLOAD" >&2; exit 1; }
+  [ -f "$BUILDER" ] || {
+    echo "error: generated install payload missing at $PAYLOAD and builder missing at $BUILDER" >&2
+    exit 1
+  }
+  DEVRITES_HOST_ARTIFACT_DIR="$PAYLOAD" bash "$BUILDER" >/dev/null || {
+    echo "error: could not generate install payload at $PAYLOAD" >&2
+    exit 1
+  }
 fi
 export DEVRITES_ENGINE_CLI="$ENGINE"
 "$ENGINE" install --source-dir "$SELF_DIR" --payload-dir "$PAYLOAD" "$@"

package/pack/.claude/skills/rite-define/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-define
-description: Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.
+description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---

package/pack/.claude/skills/rite-handoff/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-handoff
-description: User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.
+description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
 user-invocable: true
 disable-model-invocation: true
 argument-hint: "[what the next session will focus on]"

package/pack/.claude/skills/rite-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-plan
-description: Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.
+description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
 argument-hint: "[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]"
 user-invocable: true
 ---

package/pack/.claude/skills/rite-pressure-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-pressure-test
-description: Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.
+description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
 argument-hint: "[rough idea or plan to stress-test]"
 user-invocable: true
 ---

package/pack/.claude/skills/rite-quick/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-quick
-description: Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.
+description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
 argument-hint: "<what to change>"
 user-invocable: true
 ---

package/pack/.claude/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/.claude/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/pack/generated/claude/skills/rite-define/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-define
-description: Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.
+description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-handoff
-description: User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.
+description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
 user-invocable: true
 disable-model-invocation: true
 argument-hint: "[what the next session will focus on]"

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

@@ -1,6 +1,6 @@
 ---
 name: rite-plan
-description: Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.
+description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
 argument-hint: "[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]"
 user-invocable: true
 ---

package/pack/generated/claude/skills/rite-pressure-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-pressure-test
-description: Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.
+description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
 argument-hint: "[rough idea or plan to stress-test]"
 user-invocable: true
 ---

package/pack/generated/claude/skills/rite-quick/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-quick
-description: Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.
+description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
 argument-hint: "<what to change>"
 user-invocable: true
 ---

package/pack/generated/claude/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/claude/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/pack/generated/codex/skills/rite-define/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-define
-description: Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.
+description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-handoff
-description: User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.
+description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
 user-invocable: true
 disable-model-invocation: true
 argument-hint: "[what the next session will focus on]"

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

@@ -1,6 +1,6 @@
 ---
 name: rite-plan
-description: Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.
+description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
 argument-hint: "[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]"
 user-invocable: true
 ---

package/pack/generated/codex/skills/rite-pressure-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-pressure-test
-description: Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.
+description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
 argument-hint: "[rough idea or plan to stress-test]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-quick
-description: Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.
+description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
 argument-hint: "<what to change>"
 user-invocable: true
 ---

package/pack/generated/codex/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/codex/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/pack/generated/omp/skills/rite-define/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-define
-description: Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.
+description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-handoff
-description: User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.
+description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
 user-invocable: true
 disable-model-invocation: true
 argument-hint: "[what the next session will focus on]"

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

@@ -1,6 +1,6 @@
 ---
 name: rite-plan
-description: Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.
+description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
 argument-hint: "[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]"
 user-invocable: true
 ---

package/pack/generated/omp/skills/rite-pressure-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-pressure-test
-description: Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.
+description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
 argument-hint: "[rough idea or plan to stress-test]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-quick
-description: Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.
+description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
 argument-hint: "<what to change>"
 user-invocable: true
 ---

package/pack/generated/omp/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/omp/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/pack/generated/pi/prompts/rite-define.md

@@ -1,5 +1,5 @@
 ---
-description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
+description: "\"Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.\""
 argument-hint: "\"[feature-slug]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-define/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-handoff.md

@@ -1,5 +1,5 @@
 ---
-description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
+description: "\"User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.\""
 argument-hint: "\"[what the next session will focus on]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-handoff/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-plan.md

@@ -1,5 +1,5 @@
 ---
-description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
+description: "\"Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.\""
 argument-hint: "\"[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-plan/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-pressure-test.md

@@ -1,5 +1,5 @@
 ---
-description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
+description: "\"Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.\""
 argument-hint: "\"[rough idea or plan to stress-test]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-pressure-test/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-quick.md

@@ -1,5 +1,5 @@
 ---
-description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
+description: "\"Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.\""
 argument-hint: "\"<what to change>\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-quick/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-status.md

@@ -1,5 +1,5 @@
 ---
-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]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-status/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

package/pack/generated/pi/prompts/rite-zoom-out.md

@@ -1,5 +1,5 @@
 ---
-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]\""
 ---
 Read and follow the DevRites skill at `.pi/skills/rite-zoom-out/SKILL.md`, applying it to: ${ARGUMENTS:-the current request}.

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

@@ -1,6 +1,6 @@
 ---
 name: rite-define
-description: Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan.
+description: "Define the first build plan from an approved spec: architecture, task slices, traceability, and state. Use when turning approved intent into its initial plan."
 argument-hint: "[feature-slug]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-handoff
-description: User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff.
+description: "User-invoked handoff writer: sync chat-only context into `.devrites/` and write a fresh-agent handoff."
 user-invocable: true
 disable-model-invocation: true
 argument-hint: "[what the next session will focus on]"

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

@@ -1,6 +1,6 @@
 ---
 name: rite-plan
-description: Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition.
+description: "Re-plan existing work when reality invalidates the plan: reslice a slice that is too big, repair drift, reorder dependencies, split boundaries, or unblock work. Not first-pass decomposition."
 argument-hint: "[mode: decompose|reslice|repair|reorder|split|unblock|course-correct|revise]"
 user-invocable: true
 ---

package/pack/generated/pi/skills/rite-pressure-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rite-pressure-test
-description: Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec.
+description: "Pressure-test a rough/vague idea: ideate, explore 3-5 approaches, radically different shapes, diverge then converge on direction before spec. Not for writing spec."
 argument-hint: "[rough idea or plan to stress-test]"
 user-invocable: true
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: rite-quick
-description: Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.
+description: "Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix."
 argument-hint: "<what to change>"
 user-invocable: true
 ---

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-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.0",
   "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