codemap-handoff

name	codemap-handoff
description	Create and read cross-agent handoff artifacts. Trigger this skill when the conversation context window is full and you need to resume work in a new session, or when you are asked to pass your current progress to another autonomous agent (e.g., Claude, Cursor, Pi).

Multi-Agent Handoff

Building a handoff

codemap handoff .               # Build + save full artifact
codemap handoff --prefix .      # Stable context only (hubs, file count)
codemap handoff --delta .       # Recent work only (changed files, risk, events)
codemap handoff --json .        # Machine-readable for other tools

Reading a handoff

codemap handoff --latest .      # Read most recent saved artifact
codemap handoff --detail <file> . # Full context for one changed file

What's in a handoff

• Prefix (stable): file count, hub summaries — cache-friendly, changes rarely
• Delta (dynamic): changed files, risk files, recent events, next steps
• Hashes: deterministic — validates cache reuse across agent sessions

Artifacts written

File	Content
.codemap/handoff.latest.json	Full artifact
.codemap/handoff.prefix.json	Stable prefix snapshot
.codemap/handoff.delta.json	Dynamic delta snapshot
.codemap/handoff.metrics.log	Append-only metrics stream

When to handoff

• Switching from one agent CLI to another
• Starting a fresh session on the same branch
• Context window filling up — compact and resume
• Passing work to another developer's AI session