deck-check

deck-check

Overview

One QA pass over a house-format deck. Every tool runs from the plugin, against ./deck and the repo's .claude/rules/. Output is a short report: slide count, copy violations, rule-copy status, render and interaction status, and what the rendered PNGs show.

When to use

• After editing sections, shell.html, motions or assets, and always before deck-deploy.
• When the user asks whether the deck builds, whether copy rules pass, or whether rule copies are current.
• Not for a deck that lacks deck/shell.html + deck/sections/ (that is not the house format).

Procedure

Shell state does not persist between tool calls. Put this resolver at the top of every command block below.

PLUGIN_ROOT="${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
[ -z "$PLUGIN_ROOT" ] && [ -f plugins/deck/scripts/kit.py ] && PLUGIN_ROOT=plugins/deck
if [ -z "$PLUGIN_ROOT" ]; then
  # find, not a glob: zsh aborts on an unmatched glob and does not split an unquoted list.
  found=$(find "$HOME/.claude/plugins/cache" "${CODEX_PLUGIN_CACHE:-$HOME/.codex/plugins/cache}" \
    -mindepth 3 -maxdepth 3 -type d -path '*/deck/*' 2>/dev/null | awk -F/ '{print $NF "\t" $(0)}')
  if sort -V </dev/null >/dev/null 2>&1; then
    PLUGIN_ROOT=$(printf '%s\n' "$found" | sort -V | tail -1 | cut -f2-)
  else
    PLUGIN_ROOT=$(printf '%s\n' "$found" | sort -t. -k1,1n -k2,2n -k3,3n | tail -1 | cut -f2-)
  fi
fi
[ -f "$PLUGIN_ROOT/scripts/kit.py" ] || { echo "deck plugin scripts not found; export PLUGIN_ROOT=<path to plugins/deck>"; exit 1; }
PY=$(command -v python3 || command -v python)

1. Build, copy check, rule copies. Run from the repo root (the directory that holds deck/).

   # resolver block above goes here
   # Run every check even after a failure, then fail the block if any of them failed.
   rc=0
   "$PY" "$PLUGIN_ROOT/scripts/build.py" deck || rc=1
   "$PY" "$PLUGIN_ROOT/scripts/check_copy.py" deck || rc=1
   "$PY" "$PLUGIN_ROOT/scripts/kit.py" check . || rc=1
   [ "$rc" -eq 0 ]