summarizelisted
Install: claude install-skill TySnyder/claude-handoff
# Summarize Session — HANDOFF Director + Archive Protocol
Implements the [claude-handoff protocol](https://github.com/TySnyder/claude-handoff) —
see that repo's `docs/PROTOCOL.md` for the full rationale. `HANDOFF.md` is a
**director**, not a running log — it stays small and current. Completed work moves
OUT to `HANDOFF-COMPLETED.md`; it never just accumulates at the top of `HANDOFF.md`.
## What to do
### 1. Determine the repo root
- Use the argument path if given, otherwise the current working directory.
- If unclear: `git rev-parse --show-toplevel`.
### 2. Read current state
```bash
cat <repo>/HANDOFF.md 2>/dev/null
cat <repo>/CLAUDE.md 2>/dev/null | head -40 # project-specific overrides to this protocol, if any
git -C <repo> log --oneline -5
git -C <repo> status --short
wc -l <repo>/HANDOFF.md
ls <repo>/HANDOFF-*.md 2>/dev/null # excluding HANDOFF-COMPLETED.md: phase-index in use?
```
If `HANDOFF.md` is already an index pointing at `HANDOFF-1.md`/`HANDOFF-2.md` etc.
(a multi-phase project past the line budget), update the ACTIVE phase file, not
`HANDOFF.md` itself — see step 6.
### 3. Archive what's already finished
Anything in the current `HANDOFF.md` describing DONE, verified work (not "in
progress," not "next steps") gets cut **verbatim** and moved to the TOP of
`HANDOFF-COMPLETED.md` (newest-first), under a dated heading — `## YYYY-MM-DD — short
title (commit sha)`. Leave at most a one-line pointer behind in `HANDOFF.md`
("detail in `HANDOFF-COMPLE