Label what is proven and what is not
My own design documents mark each idea as proven, shadow-mode, or aspirational, and I
keep that distinction on this site too. A corridor score running in shadow mode is
genuinely interesting; describing it as shipped would be a lie that collapses in the
first technical conversation. Knowing which of your ideas are still unproven is part
of the engineering, not an admission against it.
Assume the input is hostile
None of these systems get a clean API. They get OCR text with advertising painted
through it, GPS that drifts, and a phone that may be thermally throttled. So failure
paths are designed first: a missing OCR provider degrades one request instead of
killing the process, a bad parse lands in a recoverable state with its raw text
intact, and every correction is rescored through the same function as the original
rather than patched in beside it.
Prefer evidence to assumption
The corridor engine exists because static zone heuristics were guesses dressed up as
rules. Replacing them meant building the boring part first — a two-tap logger that
records what the driver actually observed, by area and time of day — and only then
letting the scoring lean on it. Slower to start, and the only version that improves
with use.