Breaking Changes Detection Skill
Overview
Compares Claude Code API changes against our plugin ecosystem to detect compatibility issues.
API Surface File
The api-surface.md reference contains our current known API:
-
Hook types and their matchers
-
Agent frontmatter fields
-
Plugin manifest schema
-
Skill SKILL.md format
-
Script CLI flags used
Detection Workflow
-
Load current api-surface.md
-
Fetch latest Claude Code API docs
-
Diff for added/changed/removed APIs
-
Grep our plugins for each changed API
-
Report with file:line impact mapping
Impact Assessment
Change Type Severity Example
Removed API BREAKING Hook type deleted
Changed schema BREAKING Frontmatter field renamed
New required field BREAKING Mandatory new param
Deprecated API DEPRECATED Old hook still works
New optional API NEW New hook type added
References
-
API Surface
-
Migration Guide Template