Breaking Change Detector

Detect backward-incompatible changes in APIs, schemas, configs, and interfaces before they break downstream consumers — with migration path suggestions.

Features

• API Contract Diff — Compares OpenAPI specs, GraphQL schemas, and REST endpoints for breaking changes
• Type Signature Analysis — Detects function signature changes, removed exports, and type narrowing
• Database Migration Check — Flags destructive schema changes: column drops, type changes, constraint additions
• Config Compatibility — Validates configuration file changes against previous versions
• Migration Guide Generation — Produces step-by-step migration instructions for each breaking change

Quick Start

claude skill install breaking-change-detector

Usage

# Check current branch for breaking changes against main
/breaking-change-detector check --base main

# Analyze an API schema diff
/breaking-change-detector api --old v1-spec.yaml --new v2-spec.yaml

How It Works

Compares your current changes against a baseline (branch, tag, or file) to identify removals, type changes, and behavioral modifications that could break existing consumers. Categorizes each change by severity and scope. Generates migration guides with code examples showing how consumers should update their integrations.

Compatibility

Works with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Aider.