handoff
Structured session handoff to another person or AI
SKILL.md.claude/skills/handoff/SKILL.md
GitHubGenerate a structured handoff briefing when passing work to another person or AI. Captures context, decisions, risks, and next steps so nothing gets lost in transition.
Steps
Step 1: Gather session context
Read:
.claude/memory.md— current state- Recent daily note — today's work log
Task Board.md— active tasks and prioritiesgit statusandgit log --oneline -10— recent changes
Step 2: Identify what was done
From the session context and git history, list:
- Completed: Tasks finished in this session
- In progress: Work started but not finished (with current state)
- Decisions made: Choices and their rationale
- Files touched: Every file modified with a one-line summary of the change
Step 3: Identify what's pending
- Immediate next steps: What should happen next (ordered)
- Blocked items: Tasks that can't proceed and why
- Open questions: Decisions that need input
- Risks: Anything that could go wrong if not handled
Step 4: Context the recipient needs
- Project context: What is this project and what matters right now?
- Key files: Where to look for the most important things
- Gotchas: Non-obvious things that will trip someone up
- Dependencies: External people, services, or events this work depends on
Step 5: Write the handoff
Save to handoffs/handoff-[date]-[time].md:
# Session Handoff
**From:** [current session / your name]
**To:** [recipient if specified, otherwise "Next session"]
**Date:** [date and time]
---
## Status Summary
[2-3 sentences: where things stand right now]
## What Was Done
- [completed task with file references]
- [completed task]
## What's In Progress
- **[task]** — Current state: [where it's at]. Next action: [what to do next]
## Decisions Made
| Decision | Rationale | Reversible? |
|----------|-----------|-------------|
| [decision] | [why] | Yes/No |
## Files Changed
| File | Change |
|------|--------|
| [path] | [one-line summary] |
## Next Steps (Priority Order)
1. [Most important next action]
2. [Second priority]
3. [Third priority]
## Blocked Items
- **[item]** — Blocked by: [reason]. Unblock by: [action needed]
## Open Questions
- [Question that needs answering before proceeding]
## Risks
- [Risk and what to do about it]
## Key Files to Read
- [file] — [why it matters]
- [file] — [why it matters]
## Gotchas
- [Non-obvious thing that will trip you up]
---
Handoff complete. Read this before starting work.
Output the summary section so the user can verify it's accurate.