handoff

# Handoff: resumable session snapshot Write one artifact that lets a cold session — the same person tomorrow, a fresh agent, or a colleague — resume this work without replaying the conversation. Chat is ephemeral; this file is the persistence layer for a single hand-off point. `handoff` writes exactly one surface: `.outline/handoffs/<slug>-<ts>.md`. It does not commit, does not delegate, and does not open a PR. ## When to apply / NOT Apply: - Context is running low and the task is unfinished. - End of a work block, or pausing mid-task. - Switching agents (Claude → agy/codex/grok) and the next one needs the state, not the transcript. Do NOT: - Delegate a task to another AI — `antigravity`, `codex`, and `grok` own that. - Package a branch for review — `commit-push-pr` and `pr-review` own that. ## Write procedure 1. Resolve the workspace and self-ignore it (mirrors `subagent-driven`'s `sd-workspace`): ```bash root=$(git rev-parse --show-toplevel 2>/dev/null || pwd) # cwd fallback outside a repo mkdir -p "$root/.outline/handoffs" printf '*\n' > "$root/.outline/handoffs/.gitignore" # `*` also ignores the .gitignore itself ``` The handoff stays **local and gitignored** — it never enters `git status` or a commit. To hand off to a colleague on another machine, copy the file out (paste it, or attach it to a PR/issue). 2. Name it. `slug` = kebab-case of the task title; `ts=$(date +%Y%m%d-%H%M%S)` (seconds included so two runs in the same minut...