The Whiteboard Test
You cannot draw a system you haven't actually thought through.
We’ve all sat in the meeting that refuses to die. Not one meeting, technically. The same discussion reincarnated across three calendar invites, each one ending in a warm, useless consensus that evaporates the second everyone leaves the call. And the strange part is that nobody in the room is wrong. That is exactly why it won’t end. Everyone is describing a slightly different system living in their own head, and the words are close enough to hide the fact that they don’t match.
Then somebody gets tired, shares their screen, and starts drawing. A box. Another box. An arrow that a colleague objects to before it’s even finished. And somehow the fight that survived three meetings is settled in ninety seconds.
We love to credit the picture. A diagram is clearer than words, we say, a thousand words and all that. That’s not it. The clarity was never in the image. It was in the drawing.
Because you cannot draw a system you haven’t actually thought through. Speech is generous with ambiguity. You can say “and then it talks to the payment service,” and every head nods, each person quietly picturing a different handshake. The sentence costs you nothing. But the moment that sentence has to become a line between two boxes, the loan comes due. Sync or async. Who owns the retry. What the caller sees when the whole thing times out at the worst possible moment.
This is where the innocent little arrows betray you. The one connecting two services that turns out to be a distributed transaction nobody agreed to own. It hid comfortably inside the words “talks to” for three meetings. It took a single stroke on a shared canvas to drag it into the light, and suddenly the room is arguing about the thing that actually matters instead of the thing everyone assumed was fine.
That is the quiet violence of a good drawing. It refuses to let you stay vague. It turns opinion into geometry, and geometry has nowhere to hide.
The value of a drawing isn’t that other people can finally see your idea. It’s that you finally have to.
So the next time a discussion has gone three rounds without drawing blood, stop talking and pick up the pen. Not because a picture is worth a thousand words, but because it’s worth one honest admission.
If you can’t draw it, you don’t understand it yet. You’re just describing your confusion in higher resolution.