Testing

On writing tests that catch real regressions without turning every refactor into a false alarm.

Flowchart splitting a failed test into three causes: real bug, brittle test, or missing contract

Engineering JUN 15, 2026 11 Min Read

Why Your Test Failed: Real Bug, Brittle Test, or Missing Contract

A red test simply indicates a disagreement, not a final decision. It's important to understand whether a failing test points to an actual bug, a temporary hiccup, or reveals a contract that hasn't been written yet.

Read full dispatch

Graphic reading 'Green ≠ Ship' with a checkmark, question mark, and clipboard listing claim, threshold, decision

Engineering OCT 12, 2023 9 Min Read

Your Tests Pass. That Still Doesn't Tell You Whether to Ship.

A verification contract names the claim, method, threshold and decision before you write the check, so a passing test proves what the release decision needs.

Read full dispatch