deck-new

deck-new

Overview

Creates deck/ from the plugin template (neutral shell.html, a sample sections/00-cover.html, outline.md, motions/basic.js, fonts, vendor/gsap.min.js, brand assets, an empty assets/logos/sources.json, deck/.gitignore) and writes the three rule copies into .claude/rules/, each stamped with the plugin version. The deck owns every copied file afterwards. Build, check, render and deploy tools stay in the plugin and are never copied.

When to use

• The user explicitly asks for a new house-format deck in the current repository.
• Not when deck/ exists: the scaffold refuses. Use deck-sync for rule updates and deck-author for writing slides.
• Not for a generic talk or a PPTX conversion: that is frontend-slides.

Procedure

Interaction gate: Claude uses AskUserQuestion; Codex uses request_user_input when exposed, otherwise asks in plain text and waits.

1. Confirm the target. Show pwd and ask the user to confirm it is the repository root that should hold deck/.

2. Resolve the plugin root and scaffold. Shell state does not persist between tool calls, so keep the resolver and the command in one call.

   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)
   "$PY" "$PLUGIN_ROOT/scripts/kit.py" new .