session-handoff

To preserve context when ending a session near the window limit, generate a timestamped .session markdown handoff file. This document records decisions, pending tasks, and validation results, providing a clear entry point for the next window to pick up seamlessly.

A session handoff document is a structured markdown file that saves context, learning outcomes, and pending tasks. You need to create one when explicitly terminating a session or when the context window approaches its limit to avoid losing progress.

To save a handoff file, ask the assistant to perform a session handoff. It will create a timestamped markdown file in the .session folder, evaluate learning outcomes, and provide the file location and next steps for the following window.

Yes, you can export learning outcomes before switching contexts. The session handoff evaluates learning outcomes and automatically routes them to task-local notes, support queues, or formal assets within the generated markdown file.

The best way to bundle code review decisions is to invoke session handoff to create a structured markdown document. This file captures decisions, pending tasks, and validation results, ensuring the next session resumes work without missing context.