breaking-change-detector

Detect breaking API, schema, and interface changes before implementation.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor --skill breaking-change-detector-sjdjdiejdrirhdkjej
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breaking-change-detector
Source: https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor/tree/main/.claude/skills/breaking-change-detector
Command: npx skills add https://github.com/Sjdjdiejdrirhdkjej/Claude-code-conductor --skill breaking-change-detector-sjdjdiejdrirhdkjej

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill detects and warns about breaking API, schema, and interface changes before they are implemented, acting as a guardrail to protect client trust and system stability.

Core Features & Use Cases

  • Detects API, database, and interface changes early in the development lifecycle.
  • Assigns severity levels (CRITICAL, HIGH, MEDIUM) and blocks deployment when necessary.
  • Suggests migration paths aligned with api-strategy.md and versioning rules.
  • Validates changes against the project's API versioning and deprecation policies.
  • Integrates with developer workflows to ensure safe evolution of contracts.

Quick Start

Integrate the detector into your CI/CD or PR review process so that any breaking change is reported with recommended migration options and gating rules.

Frequently Asked Questions about breaking-change-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect breaking API changes before they reach production?

To detect breaking API changes before production, integrate a breaking change detector into your CI/CD pipeline to automatically evaluate schema and interface modifications during PR review. It flags risky contract changes early, assigning severity levels to block deployment if necessary.

What is a breaking change in database schema and API versioning?

A breaking change in database schema and API versioning is any modification to an interface contract that compromises client compatibility. The detector identifies these changes early and validates them against your project's specific API versioning and deprecation policies to ensure safe contract evolution.

How do I automate migration guidance for risky API modifications in CI/CD?

To automate migration guidance for risky API modifications, configure your CI/CD workflow to run the detector on schema changes. It automatically assesses risk levels and suggests migration paths aligned with your versioning strategy, ensuring safe evolution of interface contracts.

Can I block deployment when a critical interface contract change is detected?

Yes, you can block deployment when critical interface contract changes are detected. The detector assigns severity levels like CRITICAL, HIGH, and MEDIUM to breaking changes, enabling your CI/CD pipeline to automatically halt production releases based on the assigned risk.

Does the breaking change detector validate changes against existing deprecation policies?

Yes, the breaking change detector validates API and schema changes against the project's existing API versioning and deprecation policies. It checks if modifications comply with established rules and suggests migration paths aligned with your documented api-strategy.md guidelines.

What is the best way to manage risk assessment for API evolution in a pull request?

The best way to manage risk assessment for API evolution in a pull request is integrating an automated detector. It evaluates interface contracts during PR review, assigns severity levels to breaking changes, and provides migration options to enforce safe development.