handofflisted

# Handoff Compact the current conversation into one self-contained, tool-agnostic Markdown document under `docs/handoffs/` that any fresh agent can resume from by reading only that file. Reference committed artifacts by path or URL; inline anything not yet pushed; redact secrets and PII. ## Step 1: Determine the slug and any focus Derive a kebab-case `<slug>` from the user's arguments if given (e.g., "finish the migration tests" → `migration-tests`), otherwise from the conversation's most recent active thread; when no arguments were passed, state the inferred topic and slug in one line before continuing. Record a **Focus for next session** only when the conversation gives a clear signal — verbatim user arguments, or an explicitly stated next objective. Never manufacture one: with no signal, omit the focus and leave forward direction to the resumer. ## Step 2: Locate the doc; decide create, enhance, or overwrite Resolve the root with `$CLAUDE_PLUGIN_ROOT/skills/init/references/multi-repo-detection.md` — the workspace root in a multi-repo workspace, otherwise the repo/project root. The handoff folder is `docs/handoffs/` under that root. Then branch: - **`<slug>.md` exists** → read it, then `AskUserQuestion`: **Enhance** (merge new context; keep still-valid content and append a History line) or **Overwrite** (fresh rewrite; the prior version stays in git history). - **No slug match but other handoffs exist** → list them (filename · title · Last updated), then `AskUserQues