checkpoint

# /checkpoint Save a manual session checkpoint without running `/compact` or clearing context. ## What this does - Writes ONE combined handoff file to `outputs/operations/handoff-archive/` - Updates pointer files at `outputs/operations/handoff-archive/.latest/{summary.md,prompt.md}` so the SessionStart inject hook picks them up next time - Does NOT run `/compact` - Does NOT clear the session - Does NOT continue implementation after writing - wait for the user to direct next action ## When to use - Soft / hard checkpoint offer fired (`Stop` hook surfaced 25%/30% threshold) - About to switch to an unrelated task, want resume-ready snapshot - Mid-implementation, want to save state before risky action - Long session approaching natural pause point ## Procedure ### Step 1 - Determine archive paths Use UTC timestamp `YYYY-MM-DD-HHMMSS`. Get it from: ```bash date -u +'%Y-%m-%d-%H%M%S' ``` Build the archive filename: ``` outputs/operations/handoff-archive/{stamp}_handoff_manual_{session-slug}.md ``` Where `session-slug` is a short safe slug from the current session id (or "session" if not derivable). Example: ``` outputs/operations/handoff-archive/2026-05-25-143052_handoff_manual_a4b2c1.md ``` ### Step 2 - Write the combined handoff file The file MUST contain these sections in order. Keep prose concise - this is for resume, not a report: ```markdown # Handoff - manual checkpoint Generated: {ISO UTC timestamp} Trigger: manual-checkpoint Session: {session id if known} ...