Skip to content
Writing

Practice · Reliability writing

Failure Conditions in the Record

A system description that only records the happy path is a brochure. The useful record names the trigger, the detection, and the response.

A system condition becomes a detection, then a bounded response and an explicit record for the next operator.
  1. Condition
  2. Detection
  3. Bounded response
  4. Current record
  • Source → transform → sink
  • Last node is the handoff

A system condition becomes a detection, then a bounded response and an explicit record for the next operator.

Published sequence
  1. Condition
  2. Detection
  3. Bounded response
  4. Current record
Roles in the diagram
  • external1
  • process2
  • store1

Counts from the published record. They describe structure, not a measured result.

Every system has a boundary where it stops behaving as designed. The question is whether anybody can find that boundary before an incident finds it for them.

That is why the public case-study record includes failure conditions and current state. They are not confessions added to make a page sound honest. They are the parts of the system a future operator needs first.

Write the condition, not the adjective

“Robust” does not tell an operator what to do. A useful row has three parts:

  1. The condition: an unreadable document, a dropped frame, a replayed timestamp, a full disk.
  2. The detection: OCR confidence, a frame-rate watchdog, a monotonic timestamp window, filesystem alerts.
  3. The response: hold for review, emit a coverage gap, quarantine the stream, shed non-essential writes.

The engineering record treats production as part of development for the same reason. A system that cannot be operated, backed up, migrated, or recovered is not finished because its first deployment succeeded.

Failure writing is a way to make limits legible before the next change turns an implicit assumption into an incident.

More essays

2026-09-28SaigaVision · Counting metrology

A Count Is a Measurand

The number of saigas is not a detector score. It changes meaning as an observation moves from the population, to a visible animal, to a unique track.

Read