cadence: Command for Claude Code

/handoff — session handoff

You are closing out a work session on CADENCE (and, when on praxis-intelligence-ledger, the Praxis layer). Produce a clean, truthful handoff so a fresh LLM session can resume with zero context loss.

$ARGUMENTS (optional) is a short context label for the handoff filename / title (e.g. v1.2-slice7, bugfix-F2). If empty, derive one from the branch + the dominant work this session.

Hard rules:

• Truth over tidiness. Document only what actually happened and what is actually true in the repo right now. Never invent progress, test results, or "next steps" that weren't established. If something is uncertain, say so explicitly in the handoff.
• No silent scope creep. Do not refactor, "fix while I'm here", merge the PR, undraft a PR, or push tags. Tag pushes and PR merges require separate explicit user approval — out of scope for /handoff.
• Push is in scope for this command (the user invoked /handoff, which explicitly requests commit + push of the current branch). But the pre-push hook runs the full gate — if it fails, stop and report; do not --no-verify.

Work the steps in order. Use a TodoWrite list to track them.

---

Step 0 — Capture ground truth

Run and read, do not skip:

git status --short --branch
git branch --show-current
git log --oneline -8
git diff --stat
node packages/core/dist/cli/index.js progress   # or: node packages/core/bin/cadence.cjs progress

If on praxis-intelligence-ledger, also: git log origin/praxis-intelligence-ledger..HEAD --oneline and note draft PR #9 status (do not change it).

Form a precise mental model: what landed this session, what's uncommitted, what's in-flight (loop position / active phase / active slice), what's blocked, what's next. Everything downstream must match this.

Step 1 — Run the gate (honest status)

The handoff must record real gate state, not assumed. Run the full done-bar:

pnpm turbo run lint typecheck test build