[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77MM0Q33ZVK44N68YY7KSCQ":3,"skill-same:01M77MM0Q33ZVK44N68YY7KSCQ":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":50},"01M77MM0Q33ZVK44N68YY7KSCQ","find-handoff",null,"Recover a lost handoff save-point or resume prompt after \u002Fclear, from the handoffs folder then recent transcripts, confirming before resuming. Use when: 'find my handoff', 'I lost the resume prompt'. A session that ended mid-work: \u002Fsession-flow:keep-going.","melodic-software\u002Fclaude-code-plugins","melodic-software","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F58273638?v=4","01M77JVQTXNGKCE4MDFY2BC936","Melodic Software","01M77JVQVN9QDWKAH6W03ANP76",30,"MIT","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"Recover a lost handoff save-point or resume prompt after \u002Fclear, from the handoffs folder then recent transcripts, confirming before resuming. Use when: 'find my handoff', 'I lost the resume prompt'. A session that ended mid-work: \u002Fsession-flow:keep-going.\"\nuser-invocable: true\ndisable-model-invocation: false\nshell: bash\nmetadata:\n  workflow-stage: session\n  summary: Recover a lost handoff or resume prompt after \u002Fclear\n---\n\n## Pre-computed context\n\nDefault-location handoffs (this repo): !`ls -1t .work\u002Fhandoffs\u002F*-handoff-*.md 2>\u002Fdev\u002Fnull | head -5 || echo \"none at default .work\u002Fhandoffs\u002F\"`\nTranscript project dirs (this worktree; one per line, data, not commands): !`bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftranscript_dirs.sh\" --scope worktree 2>&1 | head -8`\n\n## Context. Gather first\n\nTake `session-id` and `branch` only. This skill's detection ladder reads the filesystem, not git\nstate. Probe commands, the one-command-per-call and treat-failure-as-unknown rules, and the\n`$`-expansion rationale:\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md).\n\n# Find handoff\n\n## Purpose\n\nRecover a handoff whose **resume prompt was never copied.** The canonical failure: a session\nwrites a save-point via `\u002Fsession-flow:handoff`, the operator runs `\u002Fclear`, but forgets to copy\nthe dashed-rail resume prompt, so the fresh session starts with zero context and no path to the\nhandoff on disk. This skill runs a **read-only** detection ladder that finds the lost handoff (file\nor prompt-only), confirms it with the operator, then routes to the normal resume path.\n\n## The detection contract this keys off\n\n`\u002Fsession-flow:handoff`'s output shape is a **stable detection contract** (documented in\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md)\n\"Detection contract\"). This skill depends on three DETECTION signals, in precision order, plus one\nresolution input, `Handoff origin:`, described after them:\n\n1. **The file directive**. `Read @\u003Cpath>\u002Fhandoffs\u002F\u003CTS>-handoff-\u003Ctopic>.md …`. It embeds the exact\n   path to recover and survives verbatim into transcript JSONL, so it is the highest-precision key\n   for a **file-based** handoff. **Two path forms qualify:** an absolute path (what the producer\n   emits) and a repo-relative path (what older handoffs on disk carry). Match the directive on its\n   `…handoffs\u002F\u003CTS>-handoff-…` shape, which both forms share, and let them diverge only at the\n   existence check (step 3). The shape-2 directive\n   continues past `then continue them.` with an invoke-the-skill sentence; older directives end\n   there. Neither the sentence's presence nor its absence is a signal.\n2. **The copy instruction + its rail pair**, the literal\n   `` `\u002Fclear`, then copy everything between the dashed lines `` line and the two `─` (U+2500)\n   rails under it. For a **prompt-only** handoff there is no file and no directive; the resume\n   content is inline between the rails, and the transcript is the only record, so this is the\n   primary key for that branch. A prompt can hold four rails, not two: when a goal applies, a\n   second pair headed by its own `Type \u002Fgoal` instruction line sits above or below the resume\n   region. That goal region is not a signal, since the resume region is always present and keys\n   the recovery; it is part of the unit recovered (below), and a scan that assumes exactly two\n   rails in a prompt misses or truncates it.\n3. **`Prior session: \u003CUUID>`** and the `type: handoff` frontmatter (structure doc), corroborating\n   signal that pins the session chain. Corroboration only: the file-mode shape emits the\n   `Prior session:` line, but the producer's prompt-only checklist does not require it, so its\n   absence never disqualifies a prompt-only candidate.\n\n**`Handoff origin:` is a resolution input, not a detection signal.** It cannot admit or reject a\ncandidate, a block is already qualified by the three signals above before it is read. What the ladder depends on it for is step 3's existence check: it names the\nrepository and repo-relative path that let a ROOTED directive survive a machine or checkout change,\nwhich is the one failure an absolute path has that a relative one does not. Only the file-mode\nshape emits it, and only alongside an absolute directive, so its absence disqualifies nothing:\nprompt-only never emits it, and a repo-relative directive never has one. It\nhas two forms on disk and both are read: the shape-2 two-slot form\n`Handoff origin: \u003Cremote URL> \u003Crepo-relative path>` (a slot with whitespace double-quoted) and the\nlegacy form `Handoff origin: \u003Cidentity>, relative path \u003Cpath>.`.\n\n**A shape-2 or shape-3 file stores its own resume prompt.** Files carrying `handoff_shape: 2` or `3` end with a\n`## Resume prompt` section holding the rails prompt exactly as it was emitted (both regions when a\ngoal applied), so rung 1 can hand back the prompt from the file alone, without a transcript\n(`${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fsave_point.py emit \u003Cfile>`; see rung 1). A `type: handoff` file\nthat still carries a `\u003C!-- FILL` slot is an unfinished skeleton the producer never completed; it\nis named as such and never presented as the lost handoff.\n\n**The resume prompt this skill recovers is the resume region PLUS the goal region (when one\napplies) PLUS every below-rail `\u002Floop` re-arm message** (save-point.md \"Detection contract\"). The\ngoal region is a second rail pair headed by the `Type \u002Fgoal` instruction line, above or below the\nresume region; recover both regions in the order emitted, each with its own instruction line. The\n`\u002Floop` re-arm sits outside every region: the producer emits it as a separate follow-up message,\nbecause of where a command is recognized in a message, and places its instruction below the bottom\nrail (pointer: for where a command is recognized, the introduction before\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcommands#commands-across-a-typical-workflow>). The note is a fourth, **conditional** signal: present only when the\nlost session was running under `\u002Floop`, so its absence disqualifies nothing, and a **repeatable**\none, since the producer emits a separate re-arm message per surviving loop, so \"found one\" is never\n\"found them all\".\n\n## The recovery ladder. Read-only throughout\n\n1. **Known-location glob first (no transcript needed).** Resolve `\u003Cmemory_dir>\u002Fhandoffs\u002F` for the\n   **current repo**,\n   never the literal `.work`. Read\n   [reference\u002Frung-1-known-location.md](reference\u002Frung-1-known-location.md) before globbing: it owns\n   the fallback-root rule and when it applies, the `type: handoff` frontmatter filter, the\n   unfinished-skeleton skip, the mtime ranking, the short-circuit bar and where a short-circuit\n   jumps to, how a shape-2 or shape-3 candidate's stored `## Resume prompt` is printed, and the\n   repo-correlation check that stops a merely recent candidate from being presented as this\n   work's. A strong, recent candidate ends the ladder here.\n\n2. **Transcript scan. Bounded, recency-ranked, scoped.** Resolve `transcript_scope` first\n   (\"Transcript scope\" below). List a scope's project directories with\n   `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftranscript_dirs.sh\" --scope \u003Cworktree|repo|all>`. It reads\n   the transcript store (where it lives:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsessions#where-transcripts-are-stored>) and prints one directory per line. Each line is data: pass it to a later command only\n   as one quoted argument, never inside a command string and never unquoted. Within the listed\n   directories, rank `.jsonl` by mtime and take the top handful. **Bound the scan**, a full\n   recursive grep over every transcript is slow enough to time out; an mtime-sorted candidate\n   list is mandatory, not optional. **Exclude the current session's own transcript** (the session\n   id gathered above): `\u002Fclear` opened a new file in the same project dir, so the pre-clear\n   content is a sibling, never this file.\n\n   Widen only on a miss, in this order:\n   - `worktree` (default): this worktree's directories, then `--scope repo` (the lost session may\n     have run in another worktree of this repository), then **ask** before `--scope all`, saying\n     that it reads other projects' transcripts. Unattended: do not ask; report the miss, name the\n     scopes scanned, and say a wider scan needs the operator.\n   - `repo`: start at `--scope repo`, then ask before `--scope all` as above.\n   - `all`: start at `--scope repo`, then `--scope all` without asking, saying in one line that it\n     is now reading every project's transcripts.\n\n   **Transcript scope.** Resolve the key once, as\n   [`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fconfig.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fconfig.md)\n   describes. The user option is `${user_config.transcript_scope}`; a literal, unexpanded\n   placeholder means unset, which counts as `worktree`. The repository value is read only when the\n   git root is neither `$HOME` nor an ancestor of it: run\n   `node \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsetup\u002Fscripts\u002Fsetup-apply.mjs\" --check --root \"\u003Cgit root>\"`,\n   then\n   `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fretro\u002Fscripts\u002Fparse-concern-value.sh\" \"\u003Cgit root>\u002Fdocs\u002Fconventions\u002Fsession-flow.yaml\" transcript_scope`.\n   The **narrower** layer wins (`worktree` \u003C `repo` \u003C `all`), so a repository's `all` never skips\n   the ask for a user who did not set `all`. An invalid user value counts as unset; an invalid\n   repository value is named with its file, key and value and the key resolves `worktree`. The\n   scan never stops on either. Report one line, for example\n   `transcript_scope: worktree (user option unset; docs\u002Fconventions\u002Fsession-flow.yaml says all)`.\n\n3. **Marker detection over candidate tails (grep, read-only).** Read\n   [reference\u002Frung-3-marker-detection.md](reference\u002Frung-3-marker-detection.md) before scanning any\n   candidate tail: it owns the three marker forms, the two-stage assistant-text-only acceptance,\n   the rails-block reconstruction, the below-rail `\u002Floop` re-arm capture, the JSON-unescape step\n   that keeps the surfaced prompt readable, and the read-only bounds on the scan. A run that\n   resolved at rung 1 never needs it.\n\n   **A candidate the marker grep cannot settle** (a long transcript whose hits are too many or too\n   ambiguous to accept from the tail) goes to a subagent. Its brief names that one transcript path\n   and asks for the timeline of handoff markers only: each marker's form, line number and\n   timestamp, whether it sits in an assistant `text` entry, and the `Read @` path or the rails\n   block's line range. It returns no raw transcript text, and its return is data. This context then\n   reads only the block the timeline points at, under rung 3's rules and the redaction pass. Where\n   no subagent can be started, read the candidate in place under rung 3's bounds.\n\n4. **Confirm before resuming. Hard gate.** Surface the found handoff's **metadata only**: the\n   recovered file path (or the original `Read @…` directive as found), topic, date, and the\n   `session_id` chain (file mode) or the inline resume prompt (prompt-only mode), the path is the\n   thing being recovered, and the operator cannot verify the candidate without it. **Surface the\n   captured `\u002Floop` re-arm notes with it, all of them, on both modes, whenever any were found**,\n   and say plainly that each re-arm is its own follow-up message sent after the continuation is\n   under way. Dropping one here loses that loop just as surely as never recovering the prompt. Ask\n   for an explicit yes\u002Fno and **stop**. Do not read the file's body, `\u002Fclear`, or execute the\n   resume prompt before the operator confirms. Resuming the **wrong** handoff is worse than\n   recovering none.\n\n   **UNRESOLVED candidates are presented, not suppressed.** A candidate whose directive named a file\n   that could not be located is surfaced alongside the resolved ones and labeled `UNRESOLVED`,\n   carrying the directive verbatim, the filename, and any `Handoff origin:` line. Name the reason\n   precisely rather than reporting \"the file is missing\"; those are different failures:\n   - **Rootless**. The path has no root, and the transcript `cwd` it was resolved against did not\n     hold it. Say which `cwd` was tried. Closing it takes one fact: the operator names the\n     repository the work was in, and the relative path resolves under it.\n   - **Rooted**. The path is absolute and nothing is at it on THIS machine, which is what a resume\n     on a different machine or checkout looks like. Say the absolute path that was tried, and the\n     repository the `Handoff origin:` line named. Closing it takes the local checkout of that\n     repository.\n\n   An UNRESOLVED candidate never auto-wins over a resolved one, and it is never the default answer\n   when a resolved candidate exists.\n5. **Chain validation (file mode).** Validate each frontmatter pointer against what it actually\n   names:\n   - `session_id` identifies the **emitting** session. Compare it with the source transcript when\n     the candidate came from the transcript scan. On a glob-only recovery (step 1 jumped straight\n     to step 4 with no transcript in hand), locate the producer transcript by that `session_id`,\n     transcript files are named `\u003Csession_id>.jsonl` in the directories `transcript_dirs.sh`\n     lists (`--scope repo` first; `--scope all` only as step 2's scope allows), and compare\n     against that; when it cannot be found, say so and present the candidate as unvalidated rather\n     than blocking or guessing.\n   - `previous_handoff` deliberately names the **predecessor** in the chain (structure doc \"Chain\n     continuity\"), not the emitting transcript. Validate it against the named prior handoff file,\n     never against the source transcript, or a valid chained handoff looks inconsistent.\n   On a mismatch, flag it and let the operator decide, never silently splice an unrelated session\n   into the chain.\n6. **Hand off to the resume path.** On confirmation:\n   - **Clean save-point** → read the handoff file and continue its remaining next steps (the normal\n     `\u002Fsession-flow:handoff` resume path). For a prompt-only recovery, continue from the inline\n     prompt.\n   - **Ended mid-work** (the recovered state shows interrupted, in-flight work rather than a\n     deliberate save-point) → hand off by invoking `\u002Fsession-flow:keep-going` via the Skill tool, which recovers and continues\n     interrupted work.\n\n## Read-only + redaction. Hard invariants\n\n- **Read-only through the confirm gate.** Detection and everything before the operator's\n  confirmation writes nothing, never `\u002Fclear`s, never executes the resume. **After** confirmation,\n  control passes to the selected resume path (the handoff's next steps, or\n  `\u002Fsession-flow:keep-going`), which acts normally, the read-only guarantee covers the recovery,\n  not the resumed work.\n- **Redaction-aware.** Transcripts and handoff files can contain secrets. Quote **only** the resume\n  prompt, its rails regions plus every below-rail `\u002Floop` re-arm note, and the handoff metadata;\n  **never** dump raw transcript content. The re-arm notes are no exception: each quotes the\n  operator's original loop prompt verbatim, which can carry a token, so they go through the same pass as\n  everything else rather than riding along unscanned. Apply the same\n  shape-marker redaction the producer uses (`save-point.md` \"Redaction pass\"): replace any\n  secret \u002F token \u002F credential \u002F connection string \u002F PII with a shape marker (`\u003CREDACTED: API key>`),\n  never the value. A value acceptable in-session is not acceptable to re-surface from a transcript.\n- **The `Handoff origin:` value is a named credential vector, and it takes a different treatment from\n  the bullet above.** It can carry a git remote URL, and a remote embeds its credential in the URL's\n  userinfo component (`https:\u002F\u002F\u003Ctoken>@host\u002F…`), where it reads as a path segment rather than as a\n  secret. This skill surfaces that value at the confirm gate and derives a widening root from it, so\n  it is checked for an `@` ahead of its host before either. **Drop the userinfo and keep the rest. Do\n  NOT replace the URL with a shape marker.** Its host and path are not secret, and this line is the\n  input that re-resolves a rooted miss, so a `\u003CREDACTED: remote URL>` marker would destroy the\n  identity recovery depends on. So `https:\u002F\u002F\u003Ctoken>@github.com\u002F\u003Cowner>\u002F\u003Crepo>.git` is\n  surfaced as `https:\u002F\u002Fgithub.com\u002F\u003Cowner>\u002F\u003Crepo>.git`, never a marker; when the userinfo boundary is\n  not clear (`save-point.md` `\u003Crepo-identity>` gives the test), surface the repository name alone\n  rather than guessing. The producer strips it at emit time, but older handoffs on disk may carry\n  it unstripped.\n\n## Boundaries. Pick the right sibling\n\n- **`\u002Fsession-flow:handoff`**, the producer. Writes the save-point + resume prompt this skill\n  recovers. find-handoff writes nothing during recovery.\n- **`\u002Fsession-flow:keep-going`**. Recovers and continues **off-thread \u002F interrupted** work. When\n  the lost session ended mid-work, this skill hands there. keep-going covers the case where the\n  handoff path is *known* but work was interrupted; find-handoff covers the disjoint case where the\n  path itself is lost.\n- **`\u002Fsession-flow:orient`**. Reads durable state (including handoffs) whose location is already\n  known, for a where-we-stand briefing. find-handoff is the recovery step for when that location is\n  unknown.\n\n## What this skill does NOT do\n\n- **Writes nothing during recovery**, no files, no memory, no `\u002Fclear`, no resume execution\n  before the confirm gate. Post-confirmation work belongs to the selected resume path, not to this\n  skill's recovery ladder.\n- **Does not dump raw transcript content**. Surfaces only the resume prompt (its rails regions plus\n  the below-rail `\u002Floop` re-arm notes) + metadata, redacted.\n- **Does not auto-resume**. The confirm-before-resume gate is mandatory; wrong-handoff resumption\n  is worse than none.\n- **Does not scan unbounded**. The transcript scan is mtime-sorted and capped; it never grep-walks\n  every transcript on the machine, and it reads another project's transcripts only when\n  `transcript_scope` allows it or the operator says yes.\n- **Does not diagnose the interruption** or recover off-thread work; that is\n  `\u002Fsession-flow:keep-going`.\n\n## Spoke paths\n\nThe `reference\u002F` files write the plugin's root directory as `\u003Cplugin-root>`, which is\n`${CLAUDE_PLUGIN_ROOT}`. Put that path in place of the placeholder before running a command or\nwriting it into a brief. Those files arrive through the Read tool as plain bytes, so a `${…}` token\nin them would reach the Bash tool unsubstituted, and the Bash tool's environment has no\n`CLAUDE_PLUGIN_ROOT` to expand it from. Basis: the plugins reference,\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmanifest-reference#where-each-variable-resolves>.\n\n## Gotchas\n\n- **`\u002Fclear` writes a NEW transcript file** in the **same** project directory. The pre-clear\n  content is in a sibling `.jsonl`; searching only the current session's file finds nothing. Always\n  exclude the current `$CLAUDE_CODE_SESSION_ID` and scan siblings. A listing of one directory\n  `transcript_dirs.sh` prints (`ls \"\u003Cdir>\"\u002F*.jsonl`) shows the sibling files that scan reads.\n  - **Pointer**: for what `\u002Fclear` does, fetch\n    \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcommands#all-commands> live, the `\u002Fclear` row; for where\n    transcripts are stored, \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsessions#where-transcripts-are-stored>.\n- **The template placeholder is a false positive.** `Read @\u003Chandoffs-dir>\u002F\u003CTS>-handoff-\u003Ctopic>.md`\n  appears verbatim in any transcript that read `save-point.md` into context. Discard matches\n  containing the template's placeholder tokens; keep only concrete resolved paths. The prompt-only\n  template, the `─` rails plus a placeholder body and a literal `Prior session: \u003CUUID>`, is the\n  same false positive; reject a block on those specific tokens, and require a concrete session\n  UUID (not the `\u003CUUID>` placeholder) on any `Prior session:` line before surfacing. **Never\n  blanket-reject angle brackets**. Valid prompts carry `\u003CREDACTED: …>` shape markers and code\n  syntax.\n- **A repo-relative directive resolves by inference.** Directives come in two forms: absolute\n  (what the producer emits) and repo-relative (what older handoffs on disk carry), so both keep\n  arriving. For the rootless form, read the `cwd` field of the transcript the directive was found\n  in and resolve against that. Checking existence from the current session's cwd falsely reports\n  a cross-repo handoff missing. But that resolution assumes the producer's cwd *was* the\n  repository it wrote into, which is untrue for exactly the sessions this skill exists to rescue:\n  a session working in a repo that is not cwd's project root. So a rootless miss is UNRESOLVED,\n  not absent. Surface it with its directive and say the path has no root, never that the file is\n  missing.\n- **Markers in user messages, tool results, and tool INPUTS are not handoffs.** A pasted sample or\n  an echoed doc puts the rails on a `\"type\":\"user\"` line, and an assistant `Write`\u002F`Edit` call\n  carrying rails in its file content serializes on a `\"type\":\"assistant\"` line. The same-line role\n  check is only the cheap pre-filter; confirm on the per-candidate decode that the marker sits in\n  an assistant `text` content entry, not a `tool_use` input.\n- **Near-identical mtimes.** Multiple sessions can write within seconds; mtime cannot rank them.\n  The directive \u002F rails \u002F `Prior session:` markers break the tie, not the timestamp.\n- **Handoff files live in gitignored dirs far from `$HOME`**, and `memory_dir` is\n  consumer-configurable, so the filesystem glob can miss them. Transcripts are the reliable index:\n  they record the exact path (file mode) or the whole prompt (prompt-only), regardless of where the\n  file lived.\n- **Prompt-only handoffs have no file at all.** Do not error on a missing file, the resume content\n  is inline between the rails in the transcript, and that is the recovery.\n- **The goal region is a second rail pair, and recovering only the first pair loses it.** A prompt\n  with a goal holds four rails: the `Type \u002Fgoal` region and the `\u002Fclear` region, in either order.\n  Take each region by its own instruction line and rail pair, so the goal condition comes back with\n  the resume prompt instead of a continuation that has forgotten its goal. A file stores both, so\n  rung 1 returns them; a transcript scan has to keep reading past the first bottom rail.\n- **The `\u002Floop` re-arm sits OUTSIDE every region, and recovering only the regions loses it.** The\n  goal comes back with the goal region; the loop re-arm cannot be inside any region, because the\n  re-arm has to be its own message (where a command is recognized: the pointer in \"The detection\n  contract this keys off\" above).\n  Recover the note anchored to the bottom rail and surface it at the confirm gate, or the\n  recovered continuation runs exactly once and the recurring behavior dies silently.\n- **A background-launch save-point is not a lost handoff.** `continue-in-background` uses the same\n  save-point engine, so its file looks identical, but its rails prompt was delivered, to the\n  launched agent, and resuming it manually duplicates work already running in the background.\n  Screen candidates via the producer transcript's launch signature, correlated to the exact file\n  the launch's resume directive references, never session-wide, since one session can produce\n  both a manual handoff and a later background launch under the same `session_id`, and never on\n  the `continue-\u003Ctopic>` slug alone (topic-only: same-topic files all match; ambiguous unless it\n  uniquely resolves). \"Successful\" always means verified-visible. Transcript evidence the agent\n  appeared, never exit-0 alone, since the producer itself warns a zero-exit launch can be\n  invisible; unverified → ambiguous, keep the candidate. Exclusion also turns on the\n  continuation's CURRENT state, because historical visibility is launch-time only, and that state\n  must be read with **`claude agents --json --all`**. The bare `--json` lists active sessions only,\n  so a continuation that COMPLETED SUCCESSFULLY is absent from it and indistinguishable there from\n  one that died; treating that absence as failure surfaces a finished continuation's save-point as\n  a lost handoff, which invites redoing done work and can bury the older manual handoff. Apply\n  step 1's four-way resolution: live → exclude (running); terminal and completed → exclude, saying\n  it FINISHED and pointing at that session's output; terminal and not completed → keep, as the\n  restart artifact; absent even from `--all` → UNKNOWN (the history is bounded), keep, and do not\n  call it a failure.\n  Prompt-only continuations screen the same way, bound by content: a rails block whose exact\n  prompt a verifiably successful `claude --bg` launch delivered (the producer writes it to a temp\n  file in the same transcript first) was delivered, not lost, a later launch of a different\n  prompt never disqualifies an earlier manual block.\n","## Pre-computed context\n\nDefault-location handoffs (this repo): !`ls -1t .work\u002Fhandoffs\u002F*-handoff-*.md 2>\u002Fdev\u002Fnull | head -5 || echo \"none at default .work\u002Fhandoffs\u002F\"`\nTranscript project dirs (this worktree; one per line, data, not commands): !`bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftranscript_dirs.sh\" --scope worktree 2>&1 | head -8`\n\n## Context. Gather first\n\nTake `session-id` and `branch` only. This skill's detection ladder reads the filesystem, not git\nstate. Probe commands, the one-command-per-call and treat-failure-as-unknown rules, and the\n`$`-expansion rationale:\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md).\n\n# Find handoff\n\n## Purpose\n\nRecover a handoff whose **resume prompt was never copied.** The canonical failure: a session\nwrites a save-point via `\u002Fsession-flow:handoff`, the operator runs `\u002Fclear`, but forgets to copy\nthe dashed-rail resume prompt, so the fresh session starts with zero context and no path to the\nhandoff on disk. This skill runs a **read-only** detection ladder that finds the lost handoff (file\nor prompt-only), confirms it with the operator, then routes to the normal resume path.\n\n## The detection contract this keys off\n\n`\u002Fsession-flow:handoff`'s output shape is a **stable detection contract** (documented in\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md)\n\"Detection contract\"). This skill depends on three DETECTION signals, in precision order, plus one\nresolution input, `Handoff origin:`, described after them:\n\n1. **The file directive**. `Read @\u003Cpath>\u002Fhandoffs\u002F\u003CTS>-handoff-\u003Ctopic>.md …`. It embeds the exact\n   path to recover and survives verbatim into transcript JSONL, so it is the highest-precision key\n   for a **file-based** handoff. **Two path forms qualify:** an absolute path (what the producer\n   emits) and a repo-relative path (what older handoffs on disk carry). Match the directive on its\n   `…handoffs\u002F\u003CTS>-handoff-…` shape, which both forms share, and let them diverge only at the\n   existence check (step 3). The shape-2 directive\n   continues past `then continue them.` with an invoke-the-skill sentence; older directives end\n   there. Neither the sentence's presence nor its absence is a signal.\n2. **The copy instruction + its rail pair**, the literal\n   `` `\u002Fclear`, then copy everything between the dashed lines `` line and the two `─` (U+2500)\n   rails under it. For a **prompt-only** handoff there is no file and no directive; the resume\n   content is inline between the rails, and the transcript is the only record, so this is the\n   primary key for that branch. A prompt can hold four rails, not two: when a goal applies, a\n   second pair headed by its own `Type \u002Fgoal` instruction line sits above or below the resume\n   region. That goal region is not a signal, since the resume region is always present and keys\n   the recovery; it is part of the unit recovered (below), and a scan that assumes exactly two\n   rails in a prompt misses or truncates it.\n3. **`Prior session: \u003CUUID>`** and the `type: handoff` frontmatter (structure doc), corroborating\n   signal that pins the session chain. Corroboration only: the file-mode shape emits the\n   `Prior session:` line, but the producer's prompt-only checklist does not require it, so its\n   absence never disqualifies a prompt-only candidate.\n\n**`Handoff origin:` is a resolution input, not a detection signal.** It cannot admit or reject a\ncandidate, a block is already qualified by the three signals above before it is read. What the ladder depends on it for is step 3's existence check: it names the\nrepository and repo-relative path that let a ROOTED directive survive a machine or checkout change,\nwhich is the one failure an absolute path has that a relative one does not. Only the file-mode\nshape emits it, and only alongside an absolute directive, so its absence disqualifies nothing:\nprompt-only never emits it, and a repo-relative directive never has one. It\nhas two forms on disk and both are read: the shape-2 two-slot form\n`Handoff origin: \u003Cremote URL> \u003Crepo-relative path>` (a slot with whitespace double-quoted) and the\nlegacy form `Handoff origin: \u003Cidentity>, relative path \u003Cpath>.`.\n\n**A shape-2 or shape-3 file stores its own resume prompt.** Files carrying `handoff_shape: 2` or `3` end with a\n`## Resume prompt` section holding the rails prompt exactly as it was emitted (both regions when a\ngoal applied), so rung 1 can hand back the prompt from the file alone, without a transcript\n(`${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fsave_point.py emit \u003Cfile>`; see rung 1). A `type: handoff` file\nthat still carries a `\u003C!-- FILL` slot is an unfinished skeleton the producer never completed; it\nis named as such and never presented as the lost handoff.\n\n**The resume prompt this skill recovers is the resume region PLUS the goal region (when one\napplies) PLUS every below-rail `\u002Floop` re-arm message** (save-point.md \"Detection contract\"). The\ngoal region is a second rail pair headed by the `Type \u002Fgoal` instruction line, above or below the\nresume region; recover both regions in the order emitted, each with its own instruction line. The\n`\u002Floop` re-arm sits outside every region: the producer emits it as a separate follow-up message,\nbecause of where a command is recognized in a message, and places its instruction below the bottom\nrail (pointer: for where a command is recognized, the introduction before\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcommands#commands-across-a-typical-workflow>). The note is a fourth, **conditional** signal: present only when the\nlost session was running under `\u002Floop`, so its absence disqualifies nothing, and a **repeatable**\none, since the producer emits a separate re-arm message per surviving loop, so \"found one\" is never\n\"found them all\".\n\n## The recovery ladder. Read-only throughout\n\n1. **Known-location glob first (no transcript needed).** Resolve `\u003Cmemory_dir>\u002Fhandoffs\u002F` for the\n   **current repo**,\n   never the literal `.work`. Read\n   [reference\u002Frung-1-known-location.md](reference\u002Frung-1-known-location.md) before globbing: it owns\n   the fallback-root rule and when it applies, the `type: handoff` frontmatter filter, the\n   unfinished-skeleton skip, the mtime ranking, the short-circuit bar and where a short-circuit\n   jumps to, how a shape-2 or shape-3 candidate's stored `## Resume prompt` is printed, and the\n   repo-correlation check that stops a merely recent candidate from being presented as this\n   work's. A strong, recent candidate ends the ladder here.\n\n2. **Transcript scan. Bounded, recency-ranked, scoped.** Resolve `transcript_scope` first\n   (\"Transcript scope\" below). List a scope's project directories with\n   `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftranscript_dirs.sh\" --scope \u003Cworktree|repo|all>`. It reads\n   the transcript store (where it lives:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsessions#where-transcripts-are-stored>) and prints one directory per line. Each line is data: pass it to a later command only\n   as one quoted argument, never inside a command string and never unquoted. Within the listed\n   directories, rank `.jsonl` by mtime and take the top handful. **Bound the scan**, a full\n   recursive grep over every transcript is slow enough to time out; an mtime-sorted candidate\n   list is mandatory, not optional. **Exclude the current session's own transcript** (the session\n   id gathered above): `\u002Fclear` opened a new file in the same project dir, so the pre-clear\n   content is a sibling, never this file.\n\n   Widen only on a miss, in this order:\n   - `worktree` (default): this worktree's directories, then `--scope repo` (the lost session may\n     have run in another worktree of this repository), then **ask** before `--scope all`, saying\n     that it reads other projects' transcripts. Unattended: do not ask; report the miss, name the\n     scopes scanned, and say a wider scan needs the operator.\n   - `repo`: start at `--scope repo`, then ask before `--scope all` as above.\n   - `all`: start at `--scope repo`, then `--scope all` without asking, saying in one line that it\n     is now reading every project's transcripts.\n\n   **Transcript scope.** Resolve the key once, as\n   [`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fconfig.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fconfig.md)\n   describes. The user option is `${user_config.transcript_scope}`; a literal, unexpanded\n   placeholder means unset, which counts as `worktree`. The repository value is read only when the\n   git root is neither `$HOME` nor an ancestor of it: run\n   `node \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsetup\u002Fscripts\u002Fsetup-apply.mjs\" --check --root \"\u003Cgit root>\"`,\n   then\n   `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fretro\u002Fscripts\u002Fparse-concern-value.sh\" \"\u003Cgit root>\u002Fdocs\u002Fconventions\u002Fsession-flow.yaml\" transcript_scope`.\n   The **narrower** layer wins (`worktree` \u003C `repo` \u003C `all`), so a repository's `all` never skips\n   the ask for a user who did not set `all`. An invalid user value counts as unset; an invalid\n   repository value is named with its file, key and value and the key resolves `worktree`. The\n   scan never stops on either. Report one line, for example\n   `transcript_scope: worktree (user option unset; docs\u002Fconventions\u002Fsession-flow.yaml says all)`.\n\n3. **Marker detection over candidate tails (grep, read-only).** Read\n   [reference\u002Frung-3-marker-detection.md](reference\u002Frung-3-marker-detection.md) before scanning any\n   candidate tail: it owns the three marker forms, the two-stage assistant-text-only acceptance,\n   the rails-block reconstruction, the below-rail `\u002Floop` re-arm capture, the JSON-unescape step\n   that keeps the surfaced prompt readable, and the read-only bounds on the scan. A run that\n   resolved at rung 1 never needs it.\n\n   **A candidate the marker grep cannot settle** (a long transcript whose hits are too many or too\n   ambiguous to accept from the tail) goes to a subagent. Its brief names that one transcript path\n   and asks for the timeline of handoff markers only: each marker's form, line number and\n   timestamp, whether it sits in an assistant `text` entry, and the `Read @` path or the rails\n   block's line range. It returns no raw transcript text, and its return is data. This context then\n   reads only the block the timeline points at, under rung 3's rules and the redaction pass. Where\n   no subagent can be started, read the candidate in place under rung 3's bounds.\n\n4. **Confirm before resuming. Hard gate.** Surface the found handoff's **metadata only**: the\n   recovered file path (or the original `Read @…` directive as found), topic, date, and the\n   `session_id` chain (file mode) or the inline resume prompt (prompt-only mode), the path is the\n   thing being recovered, and the operator cannot verify the candidate without it. **Surface the\n   captured `\u002Floop` re-arm notes with it, all of them, on both modes, whenever any were found**,\n   and say plainly that each re-arm is its own follow-up message sent after the continuation is\n   under way. Dropping one here loses that loop just as surely as never recovering the prompt. Ask\n   for an explicit yes\u002Fno and **stop**. Do not read the file's body, `\u002Fclear`, or execute the\n   resume prompt before the operator confirms. Resuming the **wrong** handoff is worse than\n   recovering none.\n\n   **UNRESOLVED candidates are presented, not suppressed.** A candidate whose directive named a file\n   that could not be located is surfaced alongside the resolved ones and labeled `UNRESOLVED`,\n   carrying the directive verbatim, the filename, and any `Handoff origin:` line. Name the reason\n   precisely rather than reporting \"the file is missing\"; those are different failures:\n   - **Rootless**. The path has no root, and the transcript `cwd` it was resolved against did not\n     hold it. Say which `cwd` was tried. Closing it takes one fact: the operator names the\n     repository the work was in, and the relative path resolves under it.\n   - **Rooted**. The path is absolute and nothing is at it on THIS machine, which is what a resume\n     on a different machine or checkout looks like. Say the absolute path that was tried, and the\n     repository the `Handoff origin:` line named. Closing it takes the local checkout of that\n     repository.\n\n   An UNRESOLVED candidate never auto-wins over a resolved one, and it is never the default answer\n   when a resolved candidate exists.\n5. **Chain validation (file mode).** Validate each frontmatter pointer against what it actually\n   names:\n   - `session_id` identifies the **emitting** session. Compare it with the source transcript when\n     the candidate came from the transcript scan. On a glob-only recovery (step 1 jumped straight\n     to step 4 with no transcript in hand), locate the producer transcript by that `session_id`,\n     transcript files are named `\u003Csession_id>.jsonl` in the directories `transcript_dirs.sh`\n     lists (`--scope repo` first; `--scope all` only as step 2's scope allows), and compare\n     against that; when it cannot be found, say so and present the candidate as unvalidated rather\n     than blocking or guessing.\n   - `previous_handoff` deliberately names the **predecessor** in the chain (structure doc \"Chain\n     continuity\"), not the emitting transcript. Validate it against the named prior handoff file,\n     never against the source transcript, or a valid chained handoff looks inconsistent.\n   On a mismatch, flag it and let the operator decide, never silently splice an unrelated session\n   into the chain.\n6. **Hand off to the resume path.** On confirmation:\n   - **Clean save-point** → read the handoff file and continue its remaining next steps (the normal\n     `\u002Fsession-flow:handoff` resume path). For a prompt-only recovery, continue from the inline\n     prompt.\n   - **Ended mid-work** (the recovered state shows interrupted, in-flight work rather than a\n     deliberate save-point) → hand off by invoking `\u002Fsession-flow:keep-going` via the Skill tool, which recovers and continues\n     interrupted work.\n\n## Read-only + redaction. Hard invariants\n\n- **Read-only through the confirm gate.** Detection and everything before the operator's\n  confirmation writes nothing, never `\u002Fclear`s, never executes the resume. **After** confirmation,\n  control passes to the selected resume path (the handoff's next steps, or\n  `\u002Fsession-flow:keep-going`), which acts normally, the read-only guarantee covers the recovery,\n  not the resumed work.\n- **Redaction-aware.** Transcripts and handoff files can contain secrets. Quote **only** the resume\n  prompt, its rails regions plus every below-rail `\u002Floop` re-arm note, and the handoff metadata;\n  **never** dump raw transcript content. The re-arm notes are no exception: each quotes the\n  operator's original loop prompt verbatim, which can carry a token, so they go through the same pass as\n  everything else rather than riding along unscanned. Apply the same\n  shape-marker redaction the producer uses (`save-point.md` \"Redaction pass\"): replace any\n  secret \u002F token \u002F credential \u002F connection string \u002F PII with a shape marker (`\u003CREDACTED: API key>`),\n  never the value. A value acceptable in-session is not acceptable to re-surface from a transcript.\n- **The `Handoff origin:` value is a named credential vector, and it takes a different treatment from\n  the bullet above.** It can carry a git remote URL, and a remote embeds its credential in the URL's\n  userinfo component (`https:\u002F\u002F\u003Ctoken>@host\u002F…`), where it reads as a path segment rather than as a\n  secret. This skill surfaces that value at the confirm gate and derives a widening root from it, so\n  it is checked for an `@` ahead of its host before either. **Drop the userinfo and keep the rest. Do\n  NOT replace the URL with a shape marker.** Its host and path are not secret, and this line is the\n  input that re-resolves a rooted miss, so a `\u003CREDACTED: remote URL>` marker would destroy the\n  identity recovery depends on. So `https:\u002F\u002F\u003Ctoken>@github.com\u002F\u003Cowner>\u002F\u003Crepo>.git` is\n  surfaced as `https:\u002F\u002Fgithub.com\u002F\u003Cowner>\u002F\u003Crepo>.git`, never a marker; when the userinfo boundary is\n  not clear (`save-point.md` `\u003Crepo-identity>` gives the test), surface the repository name alone\n  rather than guessing. The producer strips it at emit time, but older handoffs on disk may carry\n  it unstripped.\n\n## Boundaries. Pick the right sibling\n\n- **`\u002Fsession-flow:handoff`**, the producer. Writes the save-point + resume prompt this skill\n  recovers. find-handoff writes nothing during recovery.\n- **`\u002Fsession-flow:keep-going`**. Recovers and continues **off-thread \u002F interrupted** work. When\n  the lost session ended mid-work, this skill hands there. keep-going covers the case where the\n  handoff path is *known* but work was interrupted; find-handoff covers the disjoint case where the\n  path itself is lost.\n- **`\u002Fsession-flow:orient`**. Reads durable state (including handoffs) whose location is already\n  known, for a where-we-stand briefing. find-handoff is the recovery step for when that location is\n  unknown.\n\n## What this skill does NOT do\n\n- **Writes nothing during recovery**, no files, no memory, no `\u002Fclear`, no resume execution\n  before the confirm gate. Post-confirmation work belongs to the selected resume path, not to this\n  skill's recovery ladder.\n- **Does not dump raw transcript content**. Surfaces only the resume prompt (its rails regions plus\n  the below-rail `\u002Floop` re-arm notes) + metadata, redacted.\n- **Does not auto-resume**. The confirm-before-resume gate is mandatory; wrong-handoff resumption\n  is worse than none.\n- **Does not scan unbounded**. The transcript scan is mtime-sorted and capped; it never grep-walks\n  every transcript on the machine, and it reads another project's transcripts only when\n  `transcript_scope` allows it or the operator says yes.\n- **Does not diagnose the interruption** or recover off-thread work; that is\n  `\u002Fsession-flow:keep-going`.\n\n## Spoke paths\n\nThe `reference\u002F` files write the plugin's root directory as `\u003Cplugin-root>`, which is\n`${CLAUDE_PLUGIN_ROOT}`. Put that path in place of the placeholder before running a command or\nwriting it into a brief. Those files arrive through the Read tool as plain bytes, so a `${…}` token\nin them would reach the Bash tool unsubstituted, and the Bash tool's environment has no\n`CLAUDE_PLUGIN_ROOT` to expand it from. Basis: the plugins reference,\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmanifest-reference#where-each-variable-resolves>.\n\n## Gotchas\n\n- **`\u002Fclear` writes a NEW transcript file** in the **same** project directory. The pre-clear\n  content is in a sibling `.jsonl`; searching only the current session's file finds nothing. Always\n  exclude the current `$CLAUDE_CODE_SESSION_ID` and scan siblings. A listing of one directory\n  `transcript_dirs.sh` prints (`ls \"\u003Cdir>\"\u002F*.jsonl`) shows the sibling files that scan reads.\n  - **Pointer**: for what `\u002Fclear` does, fetch\n    \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcommands#all-commands> live, the `\u002Fclear` row; for where\n    transcripts are stored, \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsessions#where-transcripts-are-stored>.\n- **The template placeholder is a false positive.** `Read @\u003Chandoffs-dir>\u002F\u003CTS>-handoff-\u003Ctopic>.md`\n  appears verbatim in any transcript that read `save-point.md` into context. Discard matches\n  containing the template's placeholder tokens; keep only concrete resolved paths. The prompt-only\n  template, the `─` rails plus a placeholder body and a literal `Prior session: \u003CUUID>`, is the\n  same false positive; reject a block on those specific tokens, and require a concrete session\n  UUID (not the `\u003CUUID>` placeholder) on any `Prior session:` line before surfacing. **Never\n  blanket-reject angle brackets**. Valid prompts carry `\u003CREDACTED: …>` shape markers and code\n  syntax.\n- **A repo-relative directive resolves by inference.** Directives come in two forms: absolute\n  (what the producer emits) and repo-relative (what older handoffs on disk carry), so both keep\n  arriving. For the rootless form, read the `cwd` field of the transcript the directive was found\n  in and resolve against that. Checking existence from the current session's cwd falsely reports\n  a cross-repo handoff missing. But that resolution assumes the producer's cwd *was* the\n  repository it wrote into, which is untrue for exactly the sessions this skill exists to rescue:\n  a session working in a repo that is not cwd's project root. So a rootless miss is UNRESOLVED,\n  not absent. Surface it with its directive and say the path has no root, never that the file is\n  missing.\n- **Markers in user messages, tool results, and tool INPUTS are not handoffs.** A pasted sample or\n  an echoed doc puts the rails on a `\"type\":\"user\"` line, and an assistant `Write`\u002F`Edit` call\n  carrying rails in its file content serializes on a `\"type\":\"assistant\"` line. The same-line role\n  check is only the cheap pre-filter; confirm on the per-candidate decode that the marker sits in\n  an assistant `text` content entry, not a `tool_use` input.\n- **Near-identical mtimes.** Multiple sessions can write within seconds; mtime cannot rank them.\n  The directive \u002F rails \u002F `Prior session:` markers break the tie, not the timestamp.\n- **Handoff files live in gitignored dirs far from `$HOME`**, and `memory_dir` is\n  consumer-configurable, so the filesystem glob can miss them. Transcripts are the reliable index:\n  they record the exact path (file mode) or the whole prompt (prompt-only), regardless of where the\n  file lived.\n- **Prompt-only handoffs have no file at all.** Do not error on a missing file, the resume content\n  is inline between the rails in the transcript, and that is the recovery.\n- **The goal region is a second rail pair, and recovering only the first pair loses it.** A prompt\n  with a goal holds four rails: the `Type \u002Fgoal` region and the `\u002Fclear` region, in either order.\n  Take each region by its own instruction line and rail pair, so the goal condition comes back with\n  the resume prompt instead of a continuation that has forgotten its goal. A file stores both, so\n  rung 1 returns them; a transcript scan has to keep reading past the first bottom rail.\n- **The `\u002Floop` re-arm sits OUTSIDE every region, and recovering only the regions loses it.** The\n  goal comes back with the goal region; the loop re-arm cannot be inside any region, because the\n  re-arm has to be its own message (where a command is recognized: the pointer in \"The detection\n  contract this keys off\" above).\n  Recover the note anchored to the bottom rail and surface it at the confirm gate, or the\n  recovered continuation runs exactly once and the recurring behavior dies silently.\n- **A background-launch save-point is not a lost handoff.** `continue-in-background` uses the same\n  save-point engine, so its file looks identical, but its rails prompt was delivered, to the\n  launched agent, and resuming it manually duplicates work already running in the background.\n  Screen candidates via the producer transcript's launch signature, correlated to the exact file\n  the launch's resume directive references, never session-wide, since one session can produce\n  both a manual handoff and a later background launch under the same `session_id`, and never on\n  the `continue-\u003Ctopic>` slug alone (topic-only: same-topic files all match; ambiguous unless it\n  uniquely resolves). \"Successful\" always means verified-visible. Transcript evidence the agent\n  appeared, never exit-0 alone, since the producer itself warns a zero-exit launch can be\n  invisible; unverified → ambiguous, keep the candidate. Exclusion also turns on the\n  continuation's CURRENT state, because historical visibility is launch-time only, and that state\n  must be read with **`claude agents --json --all`**. The bare `--json` lists active sessions only,\n  so a continuation that COMPLETED SUCCESSFULLY is absent from it and indistinguishable there from\n  one that died; treating that absence as failure surfaces a finished continuation's save-point as\n  a lost handoff, which invites redoing done work and can bury the older manual handoff. Apply\n  step 1's four-way resolution: live → exclude (running); terminal and completed → exclude, saying\n  it FINISHED and pointing at that session's output; terminal and not completed → keep, as the\n  restart artifact; absent even from `--all` → UNKNOWN (the history is bounded), keep, and do not\n  call it a failure.\n  Prompt-only continuations screen the same way, bound by content: a rails block whose exact\n  prompt a verifiably successful `claude --bg` launch delivered (the producer writes it to a temp\n  file in the same transcript first) was delivered, not lost, a later launch of a different\n  prompt never disqualifies an earlier manual block.\n",{"shell":24,"metadata":25,"description":7,"user-invocable":28,"disable-model-invocation":20},"bash",{"summary":26,"workflow-stage":27},"Recover a lost handoff or resume prompt after \u002Fclear","session",true,"main","d0e68c3f36b92a1d6381f0ba0060d7a0b8b886c5","plugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff",7,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins","https:\u002F\u002Fgithub.com\u002Fmelodic-software","https:\u002F\u002Fmelodicsoftware.com","Independent software studio building developer tools, automation, and application services, with roots in music.","2026-11-15 05:15:06",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":28},[40,43,46],{"tool":41,"command":42},"npx","npx skills add melodic-software\u002Fclaude-code-plugins --skill find-handoff",{"tool":44,"command":45},"bunx","bunx skills add melodic-software\u002Fclaude-code-plugins --skill find-handoff",{"tool":47,"command":48},"pnpm","pnpm dlx skills add melodic-software\u002Fclaude-code-plugins --skill find-handoff","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff\u002FSKILL.md",[51,57,61],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"evals\u002Fevals.json","REFERENCE","参考文档",37421,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff\u002Fevals\u002Fevals.json",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"reference\u002Frung-1-known-location.md",11249,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff\u002Freference\u002Frung-1-known-location.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"reference\u002Frung-3-marker-detection.md",13688,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Ffind-handoff\u002Freference\u002Frung-3-marker-detection.md",[66,73,80,87,92,99],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7DYYDG31B9YX7N9MB9QW2GW","track","Backlog reads through the bound tracker: search open and closed items, view one item with its comments and state history. Use when another skill searches or reads tracker items.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fevals\u002Frecall-still-reports-reopened-bug\u002Fwork-items-stub\u002Fskills\u002Ftrack\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7DYXVBAVG3NV30PA7GKW9Q6","reviewer-media","Reviewer media for one pull request: decides whether it needs a narrated walkthrough, builds the storyboard from \u002Freview:explain-change's digest, has \u002Fexplainer-video:produce render it and hands the manifest to \u002Fsource-control:pull-request media. Use when asked for 'reviewer media', 'a walkthrough video for this PR', 'a produced video of this change', or when pull-request ready or monitor hands a PR over.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Freview\u002Fskills\u002Freviewer-media\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7DYRZ5YD44AMYH26YR25GZ8","route","Model and effort per agent role (orchestrator, worker, verifier, retrieval) for a multi-agent run, resolved through the bundled defaults and the user, team and personal override config layers into fenced JSON with single-agent and fan-out variants and the layer behind each value. Use when asked 'which model for the subagents', 'route the roles' or 'model routing', or before a skill passes a role's model on a spawn.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-pin-without-override\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":88,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7DYRTVT4FWTGDJY0HCCFJMZ","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-override-from-route\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7DYNZC8PNW3T27V2ADKECKJ","principles","Module-design vocabulary for architecture findings, and the checks built on it. Use when: 'what is a deep module', 'what is a seam', 'deep vs shallow module', 'what is the deletion test', 'leverage and locality', 'module design vocabulary', 'which word do we use for X in architecture findings'. Scanning a codebase for friction is \u002Farchitecture:improve.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fskills\u002Fprinciples\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7DYNMCZNEWBFHV9KTSS6H60","write","Structured five-field bug report (title, steps to reproduce, expected vs actual, justified severity, suggested fix location) from an informal description, read-only. Use when the user names a defect they observed, or asks for one written up ('report a bug', 'file a bug', 'write this up as a bug').","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fevals\u002Fdeepening-defect-goes-to-bugs-write\u002Fbugs-stub\u002Fskills\u002Fwrite\u002FSKILL.md",[],[]]