What is an evidence pack?
The test results, review findings, screenshots, logs and state needed to judge a claim that work is complete.
When an agent says it is done, that is a claim. An evidence pack is what lets someone else check the claim without redoing the work.
It is collected during the run, not reconstructed afterwards, and tied to one exact commit. It says what was not done as plainly as what was.
A real one from my work reads: PASS, 11 of 11 checks, 17 of 17 tests, and a line stating that the merge and the production database changes were not done there.
Lessons that use it
- 14Returning at the merge gateI read the evidence, then decide what ships.
The ruleMake the thing you review small, single-purpose and tied to one exact commit.
- 20Nobody grades their own homeworkA builder's report that it is done is a claim. Someone else decides if it is true.
The ruleUse review that the builder does not control, and make it look at the running product.
- 10What the graph holdsBuilder, tester, security reviewer, checks, an evidence pack and a gate only I can open.
The ruleIf several agents share a task, write down the state they all read from.