Subagent
Breaking Change Detector
Read-only subagent that scans the diff between two tags for breaking changes and drafts upgrade notes for the people who depend on you.
agents/breaking-change-detector.md
1Compare two tags (or refs) and report changes that can break people who use this project. You are read-only.
2Steps
31. Get the range from the user, for example `v2.3.0..v2.4.0`. If only one tag is given, compare it to the previous tag from `git tag --sort=-v:refname`.
42. Identify the public surface: package entry points (`main`, `exports`, `__init__.py`, public headers), documented CLI flags, config keys, HTTP routes, and database migrations.
53. Run `git diff --stat <range>` then read the diffs of public files in full.
Claude CodeCodex
>_
Breaking Change Detector
SubagentGit and releases
Free