plan-delete

Clear the current session's Claude Code plan file. Plans accumulate in ~/.claude/plans/<slug>.md as plan mode is re-entered within a session — this command resets to a clean slate.

Follow these steps exactly. Do not prompt the user for confirmation; the explicit /planning-tools:plan-delete invocation is the confirmation.

Step 1: Detect the current session's plan slug

Claude Code stamps every transcript entry with a top-level "slug" field once plan mode is entered. That slug equals the plan filename (without .md). This is the authoritative signal — far more reliable than path-grepping or file mtime.

Run this bash one-liner:

SESSION_ID="${CLAUDE_CODE_SESSION_ID:-}"
if [ -z "$SESSION_ID" ]; then
  echo "ERROR: CLAUDE_CODE_SESSION_ID not set"; exit 1
fi
# Session IDs are globally unique UUIDs; find the transcript wherever it lives
# (more robust than computing the encoded-CWD path, which is fragile for paths with spaces/Unicode).
TRANSCRIPT="$(find "$HOME/.claude/projects" -name "${SESSION_ID}.jsonl" -type f 2>/dev/null | head -1)"
if [ -z "$TRANSCRIPT" ] || [ ! -f "$TRANSCRIPT" ]; then
  echo "NO_TRANSCRIPT"; exit 0
fi
SLUG="$(grep -m1 -o '"slug":"[^"]*"' "$TRANSCRIPT" 2>/dev/null | sed 's/"slug":"//; s/"$//')"
if [ -z "$SLUG" ]; then
  echo "NO_PLAN_FOUND"
else
  # Defense in depth: slugs are random adjective-style strings like "moonlit-swimming-petal".
  # Reject anything that could escape ~/.claude/plans/ (slashes, dots, control chars, spaces).
  case "$SLUG" in
    *[!a-z0-9-]*|""|*--*|-*|*-)
      echo "ERROR: malformed slug rejected: '$SLUG'"; exit 1 ;;
  esac
  PLAN_PATH="$HOME/.claude/plans/${SLUG}.md"
  echo "SLUG=$SLUG"
  echo "PLAN_PATH=$PLAN_PATH"
  ls -la "$PLAN_PATH" 2>/dev/null || echo "(file no longer exists on disk)"
fi

Interpret the output:

• SLUG=<x> and PLAN_PATH=<path> → go to Step 3
• NO_TRANSCRIPT or NO_PLAN_FOUND → go to Step 2 (bootstrap)

Step 2: Bootstrap a plan file (only if Step 1 returned NO_PLAN_FOUND / NO_TRANSCRIPT)