compaction-handoff

Installation
SKILL.md

Compaction Handoff Protocol

Context compaction is lossy. Create a deliberate checkpoint that lets the next session resume from verified state without replaying the full conversation.

This protocol is snapshot-based, not append-based:

  • MEMORY.md: durable facts and pointers only.
  • docs/decisions/: durable, load-bearing decisions only.
  • .handoff/CURRENT.md: current resumable state; overwrite on every handoff.
  • Git and PR state: authoritative implementation snapshot.
  • /compact line: short pointer to the anchor, not another summary.

Claude Code compacts on its own when the context fills up. This skill defines how to checkpoint before that happens — or before you compact by hand.

Goals

A valid handoff is:

Installs
1
GitHub Stars
3
First Seen
Sep 20, 2026