handoff

Installation
SKILL.md

A handoff is a contract between two sessions. The next session treats it as ground truth and acts on it without re-checking — so one unverified claim ("X is done", "feature Y isn't built", "table Z is dead") becomes wrong work it can't trace back. Confident phrasing is not verification. (Picking up a handoff rather than writing one? Use /resume-handoff.)

1. Capture state by running commands, not from memory

Before writing prose, capture real state by probing, not recalling. If the work lives in a git repo, run these and paste the output — this is the anchor the reader checks for drift, plus the in-flight state that's easy to forget. Otherwise capture the equivalent (what's deployed, what's running, what's open) the same way:

echo "anchor: $(git branch --show-current) @ $(git rev-parse --short HEAD) · $(date -u +%FT%TZ)"
git status --short            # uncommitted work the next session must not clobber
git worktree list             # work possibly in flight in another tree
gh pr list --state open       # PRs that may already contain the "remaining" work

2. Tag every load-bearing claim

A load-bearing claim asserts something is done / not done / exists / missing / passing / broken — anything the next session would act on. Tag each one:

  • [verified: <probe>] — checked this session, with the probe: [verified: grep — route exists in router], [verified: SELECT count=0], [verified: tests 52/52].
  • [UNVERIFIED: <source>] — carried from memory, a prior handoff, an issue, or a code comment/label and not re-checked. A label is a claim to falsify, not a fact to forward — repeating it doesn't make it true.
Installs
12
First Seen
8 days ago
handoff — erikpr1994/skills-extended