Skip to content

Reliability is a design choice: cheatsheet

PropertyTest
ExplicitWritten down before the cases arrive
Rule-basedA specific condition fires, not a feeling
CheckableAn auditor can see which rule fired on any case

Anti-pattern: “escalate when unsure” delegates the decision to the component you were unsure about, and nothing can audit it.

TriggerResponse
A person asks for a human, in any wordsHand off immediately; no negotiation, no one-more-try
Policy is ambiguous or silentEscalate; a model fills gaps with fluent improvisation
ProxyWhy it fails
SentimentEmotion is poorly correlated with difficulty; rewards the loudest cases, not the hardest
Self-reported confidenceOne more generated output from the same process; poorly calibrated to real difficulty

Use instead: observable signals measured by code from outside the model: validation failures, disagreement between passes, missing fields, historically weak document types.

RuleBecause
Route low-signal and ambiguous cases to peopleThat is where attention changes outcomes
Measure accuracy by segment, not aggregate96 percent overall can hide a 71 percent segment
Keep a small random sample in strong segmentsCalibration decays quietly; the sample is the smoke alarm
Never punish escalation in metricsPunished systems improvise; handoffs go invisible
PrinciplePractice
The checker is not the doerA fresh instance with clean context reviews the work
The author defends; a stranger readsSelf-review inherits the assumptions that made the errors
Generalizes to any generated workCode diffs, extractions, summaries, reports
In Claude CodeA subagent’s clean context is the fresh reviewer
When the checker must be humanAgent SDK permission rules plus the approval callback
PassCatches
Per-item (one document, one job)Local errors: internal inconsistencies, implausible values
Cross-item (relationships only)Contradictions between documents: dates, sums, stories

Why not one giant pass: attention dilutes across a large input; page forty-one gets skimmed.

LineMeaning
A gate is only as good as the rules that feed itVeto power needs designed criteria upstream
The score has no outsideSelf-reported confidence is generated, not measured
Escalation is the design workingA visible handoff beats an invisible error
The checker is not the doerIndependence is the active ingredient of review