handoff · git:20261114.052ab81 · 2026-11-14 · sha256 ea081816e266b5bb

handoff git:20261114.052ab81A

Immutable. This exact content never changes and is served at /api/v1/blob/ea081816e266b5bb.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_bthuhcrqymtvaeaa/ea081816e266b5bbbdb04744e6a8e9ee8330d80ebd4a3646705adefed3d4a4a7.json

Then /plugin install handoff@markdownregistry-bthuhcrqymtvaeaa 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: Use when the user runs /galdr:handoff to pass work to a fresh session, a worker or reviewer session, or tomorrow's session.
disable-model-invocation: true
---

# handoff

Writes a brief that a fresh session can act on with no other context, and reads back
its report.

## Write the brief

Path: `docs/plans/<YYYY-MM-DD>-<topic>-brief-<n>.md`, `n` counting from 1. Sections, in
order:

1. **Goal**: one paragraph, the outcome, not the steps.
2. **Approved scope**: what may change, and what must not.
3. **Read first**: paths to the plan file and code, never copies of them.
4. **State**: each claim with the command that proved it this session; any claim not
   checked this session starts with `UNVERIFIED:`.
5. **Checks**: the exact commands that decide done.
6. **Stop when**: done, blocked on a user decision, or a check fails three times.
7. **Report to**: `docs/plans/<YYYY-MM-DD>-<topic>-report-<n>.md`, holding status
   (`complete`, `blocked`, `needs-decision`, `failed`), a diff summary, evidence lines,
   and open questions.

Done when a reader with only this file and the repo could start work. Give the user
the command to open the fresh session on it.

## Read the report

1. Treat the report as claims: read the diff and rerun its checks.
2. Accepted: update the plan's checkboxes, Progress and status line.
3. Not accepted: append a `## Review fixes` section to the same brief, one line per
   fix, each with its check, and hand it back.

A later session resumes from the newest brief the same way: rerun its checks first.