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+; inspect the source before using it on your own files.
Run the checked-in example
node bin/agent-handoff-packet-validator.mjs \
--root examples/ready \
--now 2026-09-14T12:00:00ZRead 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.
Where this check stops
Stated plainly, because a tool trusted for something it does not do is worse than no tool.
Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.
Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.