Why I stopped drawing the “ideal” architecture first
For most of my first decade in software, the first thing I did on a new system was draw the target architecture. A clean diagram, boxes with good names, arrows that only went one way. It felt like the responsible thing to do, and it was always wrong in the same way: it described a system for a company with no history, no existing contracts, and no people.
Lead image: a whiteboard with a diagram, half erased
design process · ADRs · trade-offs · software architecture