handofflisted

# /handoff -- Session Handoff > Capture everything a fresh Claude session needs to continue this work without losing the thread. When invoked, perform the following steps in order. Do not ask for confirmation -- just execute. --- ## Step 1: Gather Context Collect the following (use Bash/Git/TaskList tools as needed): 1. **Project name and path** -- current working directory 2. **Git state** -- `git status --short` + `git log --oneline -5` (skip if not a git repo) 3. **Active tasks** -- check TaskList tool for in_progress or pending items 4. **Session audit** -- review the full conversation and identify: - What was being built / worked on - What is complete vs. in-progress vs. blocked - Key decisions made, errors hit, approaches tried - Next concrete action needed --- ## Step 2: Write HANDOFF.md Write `HANDOFF.md` to the **project root directory**. Overwrite if it already exists. **Determine the project root:** - If the CWD is inside a project directory -- use the project root (the directory containing `.git`, `package.json`, `CLAUDE.md`, or similar project markers). - If the CWD is a generic location (`~/`, `/tmp`, etc.) -- identify the project from session context (files read, git repos referenced) and write to that project's root. - Fallback: write to CWD and note the path clearly in the output. Use this exact structure (adapt content, keep structure): ```markdown # Handoff -- [Project Name] -- [Date] > Read this at the start of the next session. Pa