← ClaudeAtlas

summarizelisted

Update the project's HANDOFF.md director (and HANDOFF-COMPLETED.md archive) for a session end or context handoff. Use when the user says /summarize, wants to end a session, hits ~50% context, or needs to hand off to a new chat window.
TySnyder/claude-handoff · ★ 0 · AI & Automation · score 62
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