did-we-break-it
Skill1 starsChanged 19 days agoMITView on GitHub
Find what a change breaks outside its diff, before it ships, and prove it by running real code. Use when asked what could this break, what is the impact, is this safe, or to review a risky change, and before merging a change to shared code, a schema, an API or a config. Reports findings; does not fix them.
In this repository17 other files it gives its agents.
- broooooSkill
- finish-the-prSkill
- fix-it-properlySkill
- just-tell-meSkill
- lets-build-pyramidsSkill
- next-time-fasterSkill
- no-added-commentsSkill
- onmywatchSkill
- plan-the-big-oneSkill
- sharpenSkill
- show-meSkill
- statechartSkill
- talk-is-cheapSkill
- trust-issuesSkill
- trust-me-broSkill
- walk-me-throughSkill
- you-get-meSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
Do not apply fixes.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
did-we-break-it
Find what this change breaks somewhere else. A list of callers is not the job: grep gives that in a second. The job is what grep will not show. A write-up that sounds right proves nothing, so a risk counts only when a run shows it.
Change: $ARGUMENTS. If that is empty, the current branch from its merge base with the default branch, through uncommitted work.
Steps
- Read the whole change. The diff, every name it adds, changes or deletes, and what it now does differently, including what the diff does not spell out.
- Find the one fact it is safe because of. Most risky-looking changes are safe because of one fact, such as "nothing reads this column any more". Write that fact as one sentence.
- Look where grep stops:
- Names built at run time: strings, config keys, reflection, templates, routes.
- Other readers of the same data: jobs, reports, exports, other services, the frontend.
- Saved data: rows, caches and queued messages written in the old shape.
- Timing: order of start-up, transactions, retries, concurrent calls.
- The library's own source at its pinned version, not your memory of it.
- Try to break it. For each real risk, write a script or test that runs the real code and fails loud if you are right. Run it and keep the output.
- Prove the one fact. Take it as far down this list as is cheap, and say where it stopped:
- You said so: worth nothing.
- You pointed at the line.
- You walked the failure step by step and it does not reach.
- You ran it.
- You reproduced it in the running app.
For a wide change, ask a second agent the same question and give it only the diff, not your conclusions. Keep what its runs prove.
Report
Do not apply fixes.
| Section | Content |
| Verdict | Safe, or broken, in one line. "Unproven" if the one fact did not reach step 4. |
| What it does | What changed, including the part that is not obvious. |
| The one fact | The sentence, how far it was proved, and the proof. |
| Broken | Each one: how it breaks, file:line, the command and its output, how likely and how bad. |
| Could not check | Risks with no run behind them, and the check that would settle each. |
| Cleared | What you checked and why it is fine. |
Say "nothing broken found" when that is the result. Do not invent findings to fill the table.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

