blast-radius

1# Blast radius
2 
3Find what a change breaks somewhere else, before it ships. Use for "blast radius of X", "what could this break", or reviewing a small diff you don't trust yet. Run it before design, not only before shipping, when a brief asserts something about existing code ("make endpoint X public"): the assertion is a hypothesis, and the consumer census is what decides the design.
4 
5Companion to `how` and `why`. `how` tells you what the code does. `why` tells you why it's shaped that way. Blast radius tells you what it breaks somewhere else.
6 
7Listing the callers is not the job. The agent can grep those in a second. The job is the breakage grep won't show you.
8 
9## Don't trust your own writeup
10 
11A blast-radius writeup that sounds right is worthless. It reads as convincing whether or not it's true. So don't hand back the writeup. Find the one or two facts the whole thing depends on and prove them by running code.
12 
13### How sure are you
14 
15For each fact the change's safety depends on, get it as far down this list as is cheap, and say where it stopped.
16 
171. You said so. Worthless on its own.
182. You pointed at the line. A real `file:line`, or the library's own source.
193. You showed the bad case can't happen. You walked the failure step by step and it doesn't reach.
204. You ran it. A script or test that calls the real code and fails loud if you're wrong.
215. You reproduced it in the running app.
22…