Mid-session save point: create a descriptive git commit and a brief handoff note, then keep working. Use before a risky change or refactor, when switching tasks, or to bank progress without ending the session. Triggers on: /checkpoint, "checkpoint", "save progress", "commit and handoff", "save state

/checkpoint What A quick mid session save that banks the known good state in two moves: 1. Descriptive git commit — stage relevant changes and commit with a message that summarizes the work. 2. Brief handoff note — write .claude/handoff.md so a resumed session (or you, after a botched refactor) knows exactly where things stand. Checkpoint is the mid session save; /wrap up is the end of session ritual. Checkpoint commits and jots a note, then keeps working. Wrap up does the full handoff plus learning extraction into MEMORY.md . When Before a risky refactor or destructive change — checkpoint the known good state When switching to a different task or feature mid session After completing a logical unit of work — bank it User says "checkpoint", "save progress", "save state", "pause here" If the session is actually ending, use /wrap up for the full ritual How 1. Assess state — git status and git diff to see staged and unstaged changes. 2. Stage changes — Stage specific files; never git add A . Exclude generated files, build artifacts, and secrets ( .env , credentials). 3. Commit — Descriptive message following the repo's commit style (conventional prefixes: feat: , fix: , refactor: ). New commit, never amend. If there is nothing to commit, skip to the handoff. 4. Write handoff note — .claude/handoff.md , same format as /wrap up but abbreviated: Completed, Pending (with specific next steps), Learned (only if something non obvious surfaced), and Context (branch + commit hash). One file, always overwritten. 5. Confirm — Report the commit hash and the handoff summary, then resume work. Safety Rules Never push, force push, or touch remote branches Never commit secrets Never amend — a checkpoint is a new commit you can return to No changes to commit? Update the handoff only Example Related /wrap up — End of session ritual: full handoff format definition plus learning extraction into MEMORY.md /build fix — Get the build green before checkpointing