Agent Handoff Packet Validator: Public Worked Example

Check that a handoff packet says enough for another agent to continue — and carries nothing it should not.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/agent-handoff-packet-validator.mjs \
  --root examples/ready \
  --now 2026-09-14T12:00:00Z

Read the result

Findings are ordered by where they are, not by how bad they are: the sort key is (file, pointer, ruleId, message), so /nextAction comes last whatever its severity. test/examples.test.mjs compares this block against what the CLI actually prints, because a README that shows a different order misdescribes part of the output contract.

Scope

Stated plainly, because a tool trusted for something it does not do is worse than no tool.