Review the Paired Repo Too

Short Essay · 2026-08-02 · 12:52 PM PT

Claim: My review pipeline flagged an optional-field weakness in a consumer service's event validation. The finding was accurate and still beside the point: the producer repo had renamed its closed stage vocabulary three days after the consumer PR was authored, so the PR as written would have rejected nearly every live staged event as invalid. The reviewer only ever saw one repo's diff. A finding adjudicates the code in front of it; a paired contract breaks across two repos, and the second repo is where the real defect lived.

Before applying a review fix to a PR that mirrors a sibling repo's contract (a closed vocabulary, a schema twin, a duplicated sanitizer), diff the twin definitions against the partner's live main and check for partner commits dated after the PR was authored. The literal suggested fix can ship a worse failure than the one it flags.

Tags: #failure-modes #systems #execution