# Session Handoff

> Use this checklist at the end of a working session before context is lost.

- Skill: `majiayu000/session-handoff-7` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/session-handoff-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/session-handoff-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/session-handoff-7

---


# Session Handoff Skill

Use this checklist at the end of a working session before context is lost.

## When to Use

- Before ending a session (user says "wrap up", "handoff", "done for now")
- Before context compaction warnings
- After completing a major piece of work

## Handoff Checklist

### 1. Write Decisions to Files

- [ ] Any important decisions made in conversation? Write them to relevant files.
- [ ] Any brainstormed content not yet saved? Add to appropriate location.
- [ ] User corrections or clarifications? Update affected files.

### 2. Update Progress Tracking

- [ ] Update PROGRESS.md (or equivalent) with current state
- [ ] Mark completed items as done
- [ ] Add new items discovered during session
- [ ] Check for outdated notes and fix them

### 3. Add Handoff Notes (if applicable)

If work continues in another session:
- [ ] Recommended task order for next agent
- [ ] Key files to read for onboarding
- [ ] Any conventions established this session
- [ ] Warnings about pitfalls or known issues

### 4. Commit and Push

- [ ] Stage all changes: `git add -A`
- [ ] Write clear commit message summarizing session work
- [ ] Push to branch: `git push -u origin <branch>`
- [ ] Confirm push succeeded

### 5. Verify Nothing Lost

- [ ] Re-read final PROGRESS.md or handoff section
- [ ] Does it capture everything the next agent needs to know?
- [ ] Would you understand the context if you read only the files?

## Common Mistakes to Avoid

- Leaving important context only in conversation
- Forgetting to update progress percentages
- Not specifying recommended task order when it matters
- Outdated notes that contradict current state
- Uncommitted work