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

```bash
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

```bash
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

More agent context in shalomb/agent-skills

86 other files this repository gives its agents, the first 60 shown.