handoff · git:20261111.9185dc4 · 2026-11-11 · sha256 248d6623bb4fe93b
handoff git:20261111.9185dc4A
Immutable. This exact content never changes and is served at /api/v1/blob/248d6623bb4fe93b.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_qptlpgsbh4k53s37/248d6623bb4fe93bbe495ff141b580ede30e07869176192367e9aa88883dcefc.json
Then /plugin install handoff@markdownregistry-qptlpgsbh4k53s37 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: handoff description: Write a self-contained brief and either dispatch one task to Claude Code, Codex or Antigravity under a hard time budget, or save a handover so a later session or another agent continues the work. Use whenever a user asks to hand one task or half-finished work to an agent (named or not) or to write the brief for it, to restart a timed-out or stalled run with a fresh brief, to send review findings back for a fix, or to wrap up a session to resume it later. Choosing among agents, parallel dispatch and quota belong to fnl-delegate. user-invocable: true argument-hint: "[--agent claude|codex|antigravity] [--model <id>] [--worktree] <task>" --- # Handoff The receiving agent starts with **zero context**: the brief is everything it knows. Write it so the agent could finish the task with no question back to you. **User's arguments:** $ARGUMENTS ## Modes - **Dispatch**: a task goes to another agent now. Everything below applies. - **Resume**: the user is stopping or switching and wants the work continued later, by a new session or another agent. You write the handover and launch nothing; see "Resume". Take Resume when the user is stopping or switching and asks to save the state, wrap up, continue later or hand over for later. A request to hand a task over now, with or without a named agent, is Dispatch: `fnl-delegate` picks the agent when none is named. When unsure whether the work starts now or later, ask in one line. **Advisory (agent judgment):** Talk to the user in the language they are using, including questions and option labels; keep command names, flags, file paths, skill names and other technical names unchanged. ## Prerequisites Dispatch only. Load the `fnl-delegate` skill and the host config it names. Requires the `fnl-delegate` skill installed beside this one. When it is missing, tell the user to add it (`npx skills add finolabs/finolabs-vibecode --skill fnl-delegate`, or install the whole plugin) and stop. Grade and route the task there unless the arguments name an agent. ## Arguments 1. **Agent and model**: `--agent` and `--model`, or ones named in the text; otherwise the `fnl-delegate` routing. 2. **Isolation**: `--worktree`, or any parallel dispatch → a new git worktree on a short branch named after the task, cut from the integration branch tip (`fnl-commit-messages` "Branches"). 3. **Task**: everything else. ## The brief Read [references/brief-template.md](references/brief-template.md) in full before drafting; it owns the template, required environment constraint and lint command. **Preserve task semantics.** Investigate-only → "Do not edit files." Fix → "implement the fix." Refactor → "refactor, not rewrite." Carry the user's exact intent and scope. **Findings sent back.** While the run is still light, send the findings as a follow-up to the same run, one defect per item. Open a new run with a new brief, carrying what was tried, when the run has used about 60% of its context or two rework rounds have not cleared the defects (`fnl-session-hygiene` "Context pressure"). **Prose output.** Write the brief in English and name the output language and tone in the Task. When the result is social content or a document for readers, and the user's instructions give an editing pass for that language, the coordinator runs the pass at acceptance; the agent does not. A plain reply to a user needs no pass. For Antigravity, write an edit-only brief when its commands fall outside both its allow-rules and what the user granted for this run (`fnl-delegate` "Route"), and paste the search results or excerpts it would otherwise fetch. ## Dispatch 1. Save the brief where `fnl-delegate` "Where files go" puts it, as `<slug>.md` (`fnl-session-hygiene` titles): a local handoff brief in `.finolabs/briefs/`, a brief worth keeping as project documentation in the project's documentation folder. 2. Record the dispatch: `ledger.py start ...` (see `fnl-delegate`), keeping the id. 3. Launch the agent with the host config's command, under the hard cap, in the host's background mode (never `( … ) &` or `nohup`), with its log and final output in `.finolabs/logs/`. 4. Tell the user in one line: the run's name (`<runner>: <project> <scope> <activity>`, `fnl-session-hygiene` "Titles"), agent, model, worktree, budget, check deadline, ledger id. The completion notice brings you back. At the check deadline, judge liveness from artifacts as `fnl-delegate` describes, then accept and record the outcome there. ## Resume Load `fnl-session-hygiene` "Handover content" and follow its save-and-continue procedure. It is the one home for handover content, storage, read-back and continuation. This mode launches nothing. Requires `fnl-session-hygiene`; when it is missing, tell the user to add it (`npx skills add finolabs/finolabs-vibecode --skill fnl-session-hygiene`, or install the whole plugin) and stop.