checkpoint

Session Checkpoint

Quick drift check: compare current work against the original plan. Keep this analysis SHORT.

Instructions

1. Find the plan or original task. Check these locations in order:

   • .claude/plans/ — use Glob to find any plan files, read the most recent
   • .claude/handoffs/ — if no plan, check for a handoff that may describe the task
   • If neither exists, report: "No plan or handoff found. State your current task so I can track drift against it."

2. Gather current work state:

   git diff --stat
   git log --oneline -10
   

3. Compare and analyze (be terse):

   • What was planned vs. what's been done
   • Any files changed that weren't part of the plan (scope creep)
   • How many files/lines changed — is this proportional to the task?

4. Report in this format:

   ## Checkpoint
   
   **Drift detected:** {Yes/No}
   **Planned:** {1-line summary of original task}
   **Completed:** {brief list of what's done}
   **Unplanned work:** {any scope creep, or "None"}
   **Context usage:** {rough estimate — low/medium/high based on session length}
   
   **Recommendation:** {one of:}
   - "On track. Keep going."
   - "Minor drift. Refocus on: {specific task}."
   - "Significant drift. Consider `/compact` to reclaim context."
   - "Session is heavy. Create `/handoff` and start fresh."
   

5. Keep the entire output under 150 words. This checkpoint should not itself contribute to context bloat.