checkpointlisted
Install: claude install-skill mishahanin/heading-os
# /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 FOUR pointer files: this session's pair under
`.latest/{session-slug}/{summary.md,prompt.md}`, which the SessionStart inject
hook reads, and the shared pair at `.latest/{summary.md,prompt.md}`, which
`/next` reads as "the newest handoff in this workspace"
- 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 the context 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 0 - Handle a switch argument first
Split `$ARGUMENTS` on whitespace. If the FIRST token is exactly `auto` or exactly
`unattended`, this is a switch. It is not a checkpoint. Anything else is a note,
including a word that merely begins with one of them. Match the whole token,
never a prefix.
Run one of these, then stop. Do not write any file.
```bash
python scripts/checkpoint-paths.py --auto on
python scripts/checkpoint-paths.py --auto off
python scripts/checkpoint-paths.py --auto status
python scripts/checkpoint-paths.py --unattended on
python scripts/checkpoint-paths.py --unattended