Handoff

Overview

Structured handoff documents for transferring work between sessions when context is exhausted or work needs to continue later.

Process

Creating a Handoff

When a session needs to end with work in progress:

1. Capture current state — what's done, what's in progress, what's next
2. Document blockers — what's preventing progress, what needs resolution
3. Record key decisions — decisions made during this session that context would be lost
4. List file pointers — plan file, design doc, spec, relevant source files
5. Write handoff to docs/handoffs/YYYY-MM-DD-<topic>-handoff.md

Handoff Document Format

# [Topic] Handoff

**Date:** YYYY-MM-DD
**Session:** [brief description of what this session worked on]

## Status

### Completed
- [x] [What was finished]

### In Progress
- [ ] [What was started but not finished — include current state]

### Not Started
- [ ] [What was planned but not reached]

## Blockers

- [What's preventing progress — errors, missing info, decisions needed]

## Key Decisions Made

- [Decision and rationale — these would be lost without documentation]

## File Pointers

- Plan: `docs/plans/YYYY-MM-DD-<topic>-plan.md`
- Design: `docs/plans/YYYY-MM-DD-<topic>-design.md`
- Spec: `docs/spec.md`
- Key files: [list relevant source files]

## Resume Instructions

[Specific instructions for the next session — what to do first, what to verify, what to watch out for]