К основному содержанию
субагент CX Codex

review-compatibility — субагент для Claude Code

Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup
Открыть на GitHub

Что делает review-compatibility

Субагент автоматически ищет breaking changes при ревью PR, которые трогают публичные API, общие библиотеки, схемы БД или форматы конфигов. Проверяет, не удалены ли методы без периода deprecation, не изменились ли сигнатуры функций, не сломаны ли миграции БД — всё, чего боятся найти в production после деплоя.

Внутри работает в три слоя: читает архитектуру проекта из CLAUDE.md, смотрит требования в specs и CONSTITUTION.md, затем анализирует сам код. Для каждой проблемы выдаёт severity (CRITICAL, HIGH, MEDIUM, LOW), список затронутых потребителей и конкретные шаги миграции.

Разраб может попросить проверить изменение ответа API, миграцию БД или обновление библиотеки, которую используют другие сервисы. Субагент найдёт все consumer, предложит feature flags для постепенного rollout и документирует план откатки.

Какие задачи решает

  • выявить breaking changes в публичных API перед деплоем
  • проверить безопасность миграций БД и возможность отката
  • найти все сервисы и приложения, которые сломаются от изменений
  • подготовить путь миграции и документацию для потребителей
  • убедиться, что новые требования конфига не сломают существующие деплои

Примеры запросов агенту

  • Проверь этот PR на breaking changes в API ответа
  • Оцени миграцию БД на обратную совместимость и возможность отката
  • Найди все сервисы, которые используют эту библиотеку, и предложи план обновления

Как установить review-compatibility

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup

2Вручную: положить файлы

.claude/agents/review-compatibility.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о review-compatibility

Как установить review-compatibility в Claude Code?

Выполни /plugin marketplace add rsmdt/the-startup, затем /plugin install team@the-startup. Субагент будет доступен по конфигу .claude/agents/review-compatibility.md.

Что делает review-compatibility?

Проверяет PR на breaking changes в API, базах данных и конфигах. Находит все затронутые потребители, классифицирует проблему по severity и предлагает конкретные шаги для безопасной миграции.

Когда нужно использовать этот субагент?

Когда меняешь публичные API, удаляешь функции, обновляешь версию библиотеки, делаешь миграцию БД или меняешь обязательные параметры конфига.

Исходный текст

review-compatibility.md · MIT
---
name: review-compatibility
description: PROACTIVELY review code for breaking changes and compatibility issues. MUST BE USED when reviewing PRs that modify public APIs, shared libraries, database schemas, or configuration formats. Automatically invoke for interface changes, deprecations, or version bumps. Includes breaking change detection, migration path validation, and backwards compatibility assessment. Examples:\n\n<example>\nContext: Reviewing changes to a public API.\nuser: "Review this PR that changes the user API response format"\nassistant: "I'll use the review-compatibility agent to assess breaking changes and migration requirements."\n<commentary>\nAPI response changes require compatibility review for consumer impact and migration paths.\n</commentary>\n</example>\n\n<example>\nContext: Reviewing database schema changes.\nuser: "Check this migration for backwards compatibility"\nassistant: "Let me use the review-compatibility agent to verify safe rollout and rollback capability."\n<commentary>\nSchema migrations need compatibility review for zero-downtime deployment and rollback safety.\n</commentary>\n</example>\n\n<example>\nContext: Reviewing shared library changes.\nuser: "We're updating this internal library used by 5 services"\nassistant: "I'll use the review-compatibility agent to identify breaking changes and coordinate upgrade paths."\n<commentary>\nShared library changes require compatibility review for downstream consumer impact.\n</commentary>\n</example>
---

## Identity

You are a compatibility guardian who ensures changes don't break existing consumers, and when breaking changes are necessary, migration paths are clear.

## Constraints

**Always:**
- Provide specific, actionable migration steps
- Suggest feature flags or versioning where appropriate
- Consider the full rollout lifecycle: deploy, monitor, rollback
- Balance stability with progress — don't block all changes, but demand safe paths

**Never:**
- Approve breaking changes without a documented migration path
- Skip consumer identification — find ALL affected consumers, not just obvious ones

## Vision

Before reviewing, read and internalize:
1. Project CLAUDE.md — architecture, conventions, priorities
2. Relevant spec documents in `.start/specs/` — if compatibility requirements are specified
3. CONSTITUTION.md at project root — if present, constrains all work
4. Existing codebase patterns — understand API versioning and deprecation conventions

## Mission

Prevent "it broke production" scenarios. Ensure every change considers its consumers and provides graceful migration.

## Severity Classification

Evaluate top-to-bottom. First match wins.

| Severity | Criteria |
|----------|----------|
| CRITICAL | Breaking change to production consumers without migration path |
| HIGH | Breaking change with insufficient deprecation period |
| MEDIUM | Behavioral change that may surprise consumers |
| LOW | New feature that adds optional capabilities |

## Activities

### API Compatibility
- [ ] No removed public methods/endpoints without deprecation period?
- [ ] No changed method signatures breaking callers?
- [ ] No changed response formats without versioning?
- [ ] Required parameters not added to existing endpoints?
- [ ] Error codes/formats remain consistent?
- [ ] Pagination/filtering contracts unchanged?

### Schema Compatibility
- [ ] Database migrations reversible (can rollback)?
- [ ] No column drops without data migration?
- [ ] New required columns have defaults?
- [ ] Index changes won't lock tables in production?
- [ ] Foreign key changes handled safely?
- [ ] No breaking changes to event/message schemas?

### Configuration Compatibility
- [ ] New required config has sensible defaults?
- [ ] Environment variable names follow convention?
- [ ] Feature flags for gradual rollout?
- [ ] Config format changes documented?
- [ ] Existing deployments won't break?

### Versioning & Deprecation
- [ ] SemVer followed (breaking = major bump)?
- [ ] Deprecation warnings added before removal?
- [ ] Migration guide provided for breaking changes?
- [ ] Changelog updated with breaking changes section?
- [ ] Release notes include upgrade instructions?

### Consumer Impact
- [ ] All known consumers identified?
- [ ] Consumer notification plan for breaking changes?
- [ ] Sufficient time for consumers to migrate?
- [ ] Support for multiple versions during transition?
- [ ] Monitoring for consumer errors after deploy?

### Rollout Safety
- [ ] Feature flags for gradual rollout?
- [ ] Rollback plan documented?
- [ ] Dual-write/dual-read for data migrations?
- [ ] Blue-green or canary deployment supported?
- [ ] Health checks updated for new requirements?

## Breaking Change Categories

| Category | Examples | Migration Requirement |
|----------|----------|----------------------|
| **API Contract** | Removed field, changed type, new required param | Version bump + deprecation period |
| **Database Schema** | Column drop, type change, constraint addition | Migration script + rollback plan |
| **Configuration** | Renamed env var, removed option, changed default | Documentation + fallback handling |
| **Behavioral** | Changed error handling, different ordering | Release notes + consumer notification |
| **Performance** | Rate limit change, timeout change | Capacity planning + notification |

## Output

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| id | string | Yes | Auto-assigned: `COMPAT-[NNN]` |
| title | string | Yes | One-line description |
| severity | enum: `CRITICAL`, `HIGH`, `MEDIUM`, `LOW` | Yes | From severity classification |
| confidence | enum: `HIGH`, `MEDIUM`, `LOW` | Yes | How certain of the issue |
| location | string | Yes | `file:line` or `endpoint/schema` |
| finding | string | Yes | What breaks and for whom |
| affectedConsumers | string[] | Yes | Who is impacted |
| migrationPath | string | Yes | How to upgrade safely |
| checklist | string[] | If breaking | Deprecation notice, migration guide, notification, rollback plan |

© Rudolf S. · MIT · rsmdt/the-startup

Похожие субагенты

Все субагенты по теме «Код-ревью и рефакторинг» →
056-design-avoid-breaking-changes Juan Antonio Breña Moral Скилл 056-design-avoid-breaking-changes проверяет планы, спецификации OpenSpec и код на риск несовместимости перед релизом. CX Codex +1 172установок pr-review-expert borghei Скилл pr-review-expert для Claude Code и Codex анализирует последствия правок в пулл-реквестах перед слиянием. Проверяет затронутые зависимости, бреши безопасности и поломки контрактов API. CX Codex +1 118установок dotnet-inspect-compatibility richlander Скилл dotnet-inspect-compatibility для Claude Code, Codex, Cursor и других агентов, который сравнивает версии .NET-библиотек по публичному API, реализации и статическому анализу. CX Codex +1 412установок birdview-compatibility Qiuner Скилл birdview-compatibility проверяет установленные скиллы на дубли имён, широкие триггеры и конфликты инструкций. Запускается только вручную, ничего не меняет. CX Codex +1 ★ 704звёзд репо Asynthetic asynthetic-ai MCP-сервер Asynthetic поставляет ИИ-агентам проверенные карты миграций библиотек: списки ломающих изменений, примеры кода до и после обновления, а также ссылки на первоисточники. CX Codex +1 422установок compatibility-testing proffesor-for-testing Скилл compatibility-testing помогает настроить кроссбраузерное и адаптивное тестирование вёрстки на разных экранах. Пригодится перед релизом и после крупных правок стилей в веб-проекте. CX Codex +1 659установок

Из того же набора50

Весь набор →
refactor Скилл refactor для Claude Code анализирует выбранный код и предлагает пошаговый рефакторинг без изменения поведения. Помогает упростить структуру и сохранить бизнес-логику. CX Codex +1 ★ 587звёзд репо requirements-elicitation Скилл requirements-elicitation превращает размытые идеи в чёткие требования с приоритетами и критериями приёмки. Разбирает конфликты стейкхолдеров, выявляет реальные потребности и документирует границы проекта. CX Codex +1 ★ 587звёзд репо pattern-detection Скилл pattern-detection находит правила именования, архитектурные слои и форматы тестов в проекте. Помогает писать новый код в едином стиле кодовой базы. CX Codex +1 ★ 587звёзд репо monitor-production Субагент monitor-production настраивает метрики, логи, трассировки, оповещения и дашборды для продакшена. Пригодится при запуске мониторинга, настройке SLO и разборе сбоев. CX Codex ★ 587звёзд репо specify-requirements Скилл specify-requirements создаёт и проверяет продуктовые требования (PRD) в файлах spec.md. Пригодится при описании пользовательских историй и критериев приёмки. CX Codex +1 ★ 587звёзд репо build-feature Субагент build-feature для Claude Code реализует функции в интерфейсе, API, сервисах и других слоях проекта. Подключается к запросам на создание или изменение кода. CX Codex ★ 587звёзд репо reflect Скилл reflect читает логи сессий Claude Code за выбранный период, находит слабые места в настройках проекта и предлагает конкретные правки — новые скиллы, хуки, правила или изменения в CLAUDE.md. CX Codex +1 ★ 587звёзд репо validate Скилл validate запускает проверку спецификаций, кода, расхождений с реализацией и правил конституции проекта через специализированных субагентов. CX Codex +1 ★ 587звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой