Handoff Memory

Overview

Keep shared memory documents close to the work they describe. For a single repository, keep the canonical handoff in the repo. For a multi-repository workspace, keep workspace-wide memory in the workspace root and workstream-specific memory under dedicated workstream folders.

This skill keeps one canonical handoff per scope and adds lightweight operational tooling:

• resolve the right document path
• resolve the right resume target without guessing a workstream
• create or refresh the canonical file
• sync a lightweight _memory/INDEX.json for workspace workstreams
• validate that the document is structurally usable
• check whether the document is stale before trusting it
• optionally write timestamped session snapshots without making them the primary state

Compatibility and Prerequisites