What problem does it solve? Long Claude Code sessions eventually exhaust their context window, and a /clear or /compact normally wipes all working state. This Skill detects when the window is filling up, prompts for a structured handoff note before the session ends, and injects that note into the next session so work resumes without losing state. ## Core Features & Use Cases - Context usage monitoring: A Stop hook reads the transcript's real message.usage token counts and warns once per session when usage crosses a threshold (the later of a percentage rule and a reserve-token floor). - Structured handoff notes: Writes a short pointer-based HANDOFF.md (done, in-flight, next action, do-not, verify-first) that SessionStart injects into the next session after a clear, compact, or resume. - Staleness detection and archiving: Judges handoff notes by age and git drift (branch/head versus the current checkout) and archives stale notes to a timestamped folder instead of injecting outdated state. - Use Case: A developer working a multi-hour ticket hits 85% context; the watcher fires, they write a handoff, type /clear, and the new session opens already holding the note and the single next action. ## Quick Start Ask the assistant to set up context handoff monitoring so it warns before the window fills and resumes work from a handoff note after a clear.
