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.
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 
23Step 4 is usually one small script that imports the same library the app ships and calls the exact function you're worried about.
24 
25## Steps
26…