Debugging got faster when I started keeping an evidence ledger
A lightweight debugging practice that separates observations, guesses, and experiments before they blur together.
The most expensive part of debugging is often not finding evidence. It is forgetting which conclusion came from which observation.
I now keep a tiny ledger with three columns:
| Observation | Hypothesis | Next experiment |
|---|---|---|
| The retry happens after 30 seconds | A client timeout is firing | Log timestamps at both boundaries |
| The server finishes in 12 seconds | The response is delayed elsewhere | Compare proxy and browser timing |
The format prevents a plausible story from quietly turning into a fact. Each experiment must either strengthen a hypothesis, weaken it, or reveal a better question.
This is slower for the first five minutes and dramatically faster for the next hour.