
blast-radius
Find what a change could break beyond the diff.
- version
- 0.1.6
- GitHub stars
- 347
Install
/plugin install blast-radius@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Blast radius
Find what a change breaks somewhere else, before it ships. Companion to how
(what the code does) and why (why it's shaped that way).
Listing the callers is not the job. Grep does that in a second. The job is the breakage grep won't show you, and the proof that the change is safe anyway.
Authority and probes
Review-only work returns findings and isolated probe evidence. Do not edit source, persistent tests, or external state without authorization for those changes. Inside an implementation workflow, the caller retains lifecycle and write authority; this method does not expand either.
Reuse an existing safe check when it proves the fact. Put throwaway scripts and fixtures in an isolated directory under the repository's ignored build scratch or the user cache, never in tracked source. Run mutation-capable probes against disposable copies with isolated state. If safe isolation is unavailable, report the evidence limit instead of running the probe. Remove only your own scratch.
How sure are you
A writeup that sounds right reads as convincing whether or not it's true. So for each fact the change's safety depends on, get it as far down this ladder as is cheap, and say where it stopped:
- You said so. Worthless on its own.
- You pointed at the line. A real
file:line, or the library's own source. - You showed the bad case can't happen. You walked the failure step by step and it doesn't reach.
- You ran it. A script or test that calls the real code and fails loud if you're wrong.
- You reproduced it in the running app.
Step 4 is usually one small script that imports the same library the app ships and calls the exact function you're worried about. A fact you can't get to step 4 is unproven. Say so; don't round up.
Steps
- Read the change. The diff, the symbols it adds, changes, and deletes, and
what it now does differently, including the part the diff doesn't spell out.
Use
whystep 2 to pull the PR and commits. - Find the one fact it's safe because of. Most changes that look scary are safe because of a single fact, like "this call only drops already-dead cache entries and does nothing else". If it holds, most of the scary cases die at once. Spend your time here, not on a long list of maybes.
- Look where grep stops. Read the source of the library you call, and check its pinned version and any local patch. Work out when things run: microtasks, unmount and teardown, Solid versus React. Follow what a symbol search misses: the JSON an API returns, a DB column, a wire format, another language reading the same bytes, a feature flag, code three hops downstream.
- Weigh each risk. Give it a real chance of happening and a real cost if it
does. Keep the risks you confirmed; list the ones you checked and cleared
separately. Cite a real
file:line, treat a search that finds nothing as an answer, and never make up a caller or an API. - Prove the one fact with an existing safe check or an isolated script that runs the real code. Report the result and any remaining evidence limit.
- For a big or wide change, return the scope and findings to the caller.
The caller may use
interrogatefor independent review when warranted and available. Keep review separate from correction; do not invokearenaor take over the caller's lifecycle.
What to hand back
- What it does. What changed, including the part that isn't obvious.
- The one fact it's safe because of. State it, say which ladder step you reached, and show the proof or write unproven.
- Risks. Only the real ones. Each names how it breaks, the
file:line, how likely and how bad, and how to check. - Cleared. What you checked and why it's fine.
- Before you merge. The cheapest test or repro that catches the real bug, including the script you wrote.
Write it through unslop, cite real code, and strip anything private before it
goes anywhere public.
Reply: the writeup above.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/blast-radius
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- blender-toolkitv0.3.2
- develop-web-gamev0.1.7
- diagnosing-bugsv0.1.3
- dotnet-toolkitv0.1.2
- engineering-principlesv0.1.22
- engineering-workflowv0.1.27
- figure-it-outv0.1.10
- git-toolkitv0.1.15
- github-toolkitv0.1.33
- howv0.1.7
- interrogatev0.1.10
- jj-toolkitv0.1.8
- lua-toolkitv0.2.0
- mcp-builderv0.1.6
- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3