session-updatelisted
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