session-handofflisted

# Session Handoff ## Objective Save and transfer the context of a work session to enable efficient resumption in a later session or by another agent. ## When to use - End of a work session (save the state) - Task too complex for a single session - Handoff between developers/agents - Documentation of work in progress ## Handoff format ### Context file: `.claude/handoff.md` ```markdown # Session Handoff **Date:** [YYYY-MM-DD HH:MM] **Session:** [ID or description] **Author:** [Human or agent] ## Project context **Project:** [Name] **Branch:** [Branch name] **Current commit:** [Hash] ## Work state ### Done - [x] [Task 1] - [Detail] - [x] [Task 2] - [Detail] ### In progress - [ ] [Task 3] - [Current state, where it stands] - Modified files: [list] - Next step: [description] - Possible blocker: [description] ### To do - [ ] [Task 4] - [Description] - [ ] [Task 5] - [Description] ## Decisions made | Decision | Reason | Rejected alternative | |----------|--------|---------------------| | [Choice 1] | [Why] | [Other option] | | [Choice 2] | [Why] | [Other option] | ## Key files | File | Role | State | |---------|------|------| | `src/xxx.ts` | [Description] | Modified / Created / To modify | | `tests/xxx.test.ts` | [Description] | Modified / Created / To create | ## Patterns and conventions discovered - [Pattern 1 from the codebase] - [Naming convention] - [Specific architecture] ## Problems encountered | Problem | Solution/Workaround | Resolved? | |------