handofflisted

# Handoff Preserve context across Claude Code sessions by writing a structured HANDOFF.md file at the project root. ## When to Use - Before ending a long session - Before running `/compact` to free context - When switching to a different task and planning to return - When handing work to another developer or agent ## How It Works 1. Check if a HANDOFF.md already exists in the project root 2. If it does, read it first to build on previous context 3. Write/update HANDOFF.md with the five sections below ## HANDOFF.md Format **This is the canonical definition of the HANDOFF.md format.** `/compact` reproduces this template inline for convenience; if the two ever disagree, this file is correct. See **Related — who owns what** at the end. ```markdown # Handoff — [Project Name] **Date**: YYYY-MM-DD HH:MM **Branch**: current git branch ## Goal What we're trying to accomplish overall. ## Current Progress - What's been completed this session - Files created or modified (with paths) - Decisions made and rationale ## What Worked - Approaches or patterns that succeeded - Key insights discovered ## What Didn't Work - Approaches tried and abandoned (with reasons) - Pitfalls to avoid next time ## Next Steps 1. Specific actionable items for the next session 2. Ordered by priority 3. Include file paths and context needed ``` ## Rules - Always include the current git branch and date - Be specific about file paths — the next session has zero context - List what didn't work so the