handoff ยท diff

git:20261114.052ab81 to git:20261114.fa8b3c3

28 added, 22 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
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.
+ description: Use when the user runs /galdr:handoff to pass work to a new session, a worker or reviewer session, or the session of the next day.
disable-model-invocation: true
---
# handoff
- Writes a brief that a fresh session can act on with no other context, and reads back
- its report.
+ handoff writes a brief that a new session can use with no other context. Then it reads
+ the report that comes back.
## Write the brief
- Path: `docs/plans/<YYYY-MM-DD>-<topic>-brief-<n>.md`, `n` counting from 1. Sections, in
- order:
+ Use the path `docs/plans/<YYYY-MM-DD>-<topic>-brief-<n>.md`. Count `n` from 1. Write
+ these sections in this 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.
+ 1. **Goal**: one paragraph about the outcome, not the steps.
+ 2. **Approved scope**: what can change, and what must not change.
+ 3. **Read first**: the paths to the plan file and the code. Do not copy their content.
+ 4. **State**: each claim with the command that proved it in this session. A claim that
+ you did not check in this session starts with `UNVERIFIED:`.
+ 5. **Checks**: the exact commands that decide if the work is complete.
+ 6. **Stop when**: the work is complete, a user decision blocks it, or a check fails
+ three times.
+ 7. **Report to**: `docs/plans/<YYYY-MM-DD>-<topic>-report-<n>.md`. The report holds the
+ 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.
+ The brief is complete when a reader with only this file and the repository can start
+ work. Give the user the command that opens the new 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.
+ 1. The report is a set of claims. Read the diff and run its checks again.
+ 2. If you accept the work, update the checkboxes, Progress and the status line of the
+ plan.
+ 3. If you do not accept it, add a `## Review fixes` section to the same brief. Write one
+ line for each fix, with its check. Then give the brief back.
- A later session resumes from the newest brief the same way: rerun its checks first.
+ ## Continue later
+
+ A later session starts from the newest brief. First it reads the state and runs the
+ checks again. It never repeats a write if it does not know the result. If a review is
+ pending, it recovers that review before it starts a new one.