kc-session-handoff

What problem does it solve?

Capture and preserve the essential state of a development session when context pressure is high or a handoff is required, so the next session can resume quickly without manual reconstruction of branch, working directory, or recent work.

Core Features & Use Cases

• Structured handoff journaling: Writes a project-scoped journal entry with a required "Session Handoff:" header and a one-line description.
• Reliable resume ID: Calls the MCP process_thoughts tool, parses the returned handoff_id, verifies repo-scoped writes, and retries on failure to ensure a usable resume identifier.
• Context restoration hygiene: Records branch, working directory, linked worktree info, optional technical insights to MEMORY.md, optional context-lake caching of file insights, and emits handoff metrics.
• Use Case: Ideal for pausing work in a complex multi-directory repo or linked worktree before meetings, code reviews, or end-of-day sessions so teammates or future sessions can restart exactly where you left off.

Quick Start

Run /kc-session-handoff with an optional focus note to record the session, capture a handoff ID, and return a one-line resume prompt for the next session.