Resources
Insight · Jun 2025 · 5 min
Evidence By Design.
Evidence should not be produced by adding logging at the end. It should be a first-class output of the system.
Evidence should not be produced by adding logging at the end. It should be a first-class output of the system.

When evidence is retrofitted, it takes the shape of the tool that produced it: rows in a database, JSON in a log file, entries in an audit queue. Useful for the system, not useful for a person trying to understand what happened.
Evidence by design means every consequential action produces a record that a person can read: what changed, who changed it, why, and what it affected. The record is a peer of the action, not a footnote to it.
The test is simple. A month after the fact, can a new person open the mission and understand it in five minutes? If not, the evidence design has failed.