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](references/api-surface.md)
- [Migration Guide Template](references/templates/migration-guide.md)