← ClaudeAtlas

session-updatelisted

Use when the user says "update session", "log progress", "checkpoint session", or invokes /session-update — especially before /clear or handoff
jkm-4314/claude-code-skills · ★ 4 · AI & Automation · score 78
Install: claude install-skill jkm-4314/claude-code-skills
# Session Update (Checkpoint) You are capturing work-in-progress into today's SESSION_LOG.md entry **before context is cleared or handed off**. The goal: preserve what THIS Claude instance knows — decisions, reasoning, blockers, dead-end approaches — before it's lost. Git alone can't recover any of that. Primary use case: run this right before `/clear`. Secondary: mid-session checkpoint after a chunk of work. ## Step 1: Verify Today's Entry Exists Read `.claude/SESSION_LOG.md`. Find the top entry. **If top entry's date == today** (MM-DD-YYYY format; legacy YYYY-MM-DD is equivalent): continue to Step 2. **If no today entry:** tell the user: > "No session-start stub exists for today. Run `/session-start` first to create today's entry, then re-run session-update." Stop. Do not create the entry here — that's session-start's job. ## Step 2: Determine Scope of "New Work" Look inside today's entry for a tracking marker of the form: ```html <!-- last-update: <git-hash> --> ``` - **If present:** new work = commits since `<git-hash>` + current uncommitted changes + this conversation's work not yet in the entry. - **If absent:** new work = commits since today's start that aren't obviously reflected in the entry + current uncommitted changes + this conversation's work. Collect inputs: ```bash # Current HEAD (for the new marker) git rev-parse --short HEAD # Commits since last marker (if marker exists): git log --oneline --all <marker-hash>..HEAD # Or commits since today's