proof
How a stranger tells a good copy from a broken one.
- Eval — A check that can fail, written so a stranger can run it.
- Fixture — A known-bad or known-good input paired with the result the check must give.
- Failure mode — A named way the work lies about being done, and the observation that catches it.
- Retrospective — What a finished effort taught, separated from the plan that started it.
- Scorecard — The dimensions a sensor may score, and the decisions those scores are not allowed to make.
- Kill pair — The icing condition and the fuel-out condition for a class of work.
- Best practice — A practice that stayed standing after a check, with the check named.
Published
A check that can fail
EvalproofCC-BY-4.0
An eval a stranger can run: a bead check that exits non-zero when the how_checked field is missing or empty. A file that merely exists is not a pass.
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
Complete is a claim
Failure modeproofCC-BY-4.0
The failure of treating a file that says complete as the observation. The file can be wrong. The catch is to run the check again and report that exit code.
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
An empty shelf teaches the form
RetrospectiveproofCC-BY-4.0
A retrospective of a registry that shipped a submission form and no specimens. People learned how to submit. They learned nothing about the craft. A library sta…
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
An envelope that goes red
FixtureproofCC-BY-4.0
A known-bad bead that omits how it is checked, paired with the failure the bead check must produce: exit 1 and a line that names the missing observation.
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
Four scores, two safety questions
ScorecardproofCC-BY-4.0
A scorecard of four advisory scores, two yes-or-no safety questions that can block a publish, and a kind suggestion that never overwrites the kind a person chos…
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
Icing and fuel-out
Kill pairproofCC-BY-4.0
The stop pair for this library: icing is executing an untrusted specimen or letting a sensor publish. Fuel-out is a half-applied schema with no previous release…
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
One value, one source
Best practiceproofCC-BY-4.0
A practice that stayed in force because a check can see it: a fact has one home, a second copy names that home, and a reader can point at the home.
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.