Sync Session State

Use this skill before ending a work session to capture context for resuming later.

Steps

1. Gather Current State

# Get current branch
git branch --show-current

# Get recent changes
git status --short

# Get recent commits (this session)
git log --oneline -5

2. Review What Was Worked On

Read the current SESSION.md and identify:

• Which "In Progress" items were completed
• What new work was started
• Any blockers encountered

3. Update SESSION.md Sections

Current Focus

Update branch name and objective if changed.

In Progress

• Keep items still being worked on
• Remove completed items (move to Recently Completed)
• Add any new tasks discovered

Recently Completed

• Add items completed this session
• Keep last 5-10 items, archive older ones

Blockers / Issues

• Document any blockers encountered
• Note what's needed to resolve them

Context for Next Session

Where We Left Off: Describe the exact state - what file were you editing, what problem were you solving, what's the next step?

Key Files Modified Recently: List the main files changed this session.

Commands to Resume: Include any setup commands needed (docker, servers, etc.)

Scratch Notes

• Clean up temporary notes
• Move anything important to permanent sections
• Delete obsolete scratch content

4. Final State

# Show what SESSION.md looks like now
cat .claude/SESSION.md

Output Format

After updating, provide a brief summary:

• What was accomplished
• What's still in progress
• Any blockers for next session
• Suggested first action for next session