feat: add backward compatibility review agent for component-developer plugin

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "keboola-claude-kit",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "metadata": {
     "description": "Comprehensive Claude Kit marketplace for Keboola workflows including developer tools, component development, and data app building with specialized agents and best practices"
   },
@@ -13,7 +13,7 @@
     {
       "name": "component-developer",
       "description": "Comprehensive toolkit for building Keboola Python components with Agent Skills format",
-      "version": "3.0.0",
+      "version": "3.1.0",
       "source": "./plugins/component-developer",
       "category": "development"
     },

README.md

@@ -59,7 +59,7 @@ A comprehensive toolkit for developers including specialized agents for code rev
 A specialized toolkit for building production-ready Keboola Python components following best practices and architectural patterns.
 
 **Features:**
-- 🎯 **Skills**: Build component, build UI, debug, test, review, migrate to UV, getting started
+- 🎯 **Skills**: Build component, build UI, debug, test, review, backward compatibility review, migrate to UV, getting started
 - ⚡ **Commands**: Init, run, fix, review, migrate-repo, schema-test
 - 🔌 **MCP Server**: Keboola integration
 - 📋 **Configuration Schemas**: JSON Schema with UI elements

plugins/component-developer/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "component-developer",
-  "version": "3.0.0",
-  "description": "Comprehensive toolkit for building Keboola Python components with Agent Skills format. Includes specialized skills for component development, UI/schema design, testing, debugging, and code review.",
+  "version": "3.1.0",
+  "description": "Comprehensive toolkit for building Keboola Python components with Agent Skills format. Includes specialized skills for component development, UI/schema design, testing, debugging, code review, and backward compatibility review.",
   "author": {
     "name": "Keboola :(){:|:&};: s.r.o.",
     "email": "support@keboola.com"

plugins/component-developer/README.md

@@ -69,6 +69,26 @@ Expert skill for writing comprehensive tests including datadir tests and unit te
 
 Expert skill for code review with actionable feedback grouped by severity.
 
+### Review Backward Compatibility
+**Command**: `@review-backward-compatibility` (alias: `@backward-compatibility-reviewer`)
+**Color**: 🔴 Red
+
+Expert agent for reviewing component PRs with focus on **backward compatibility** — ensuring existing user configurations, sync actions, and output tables are not broken by changes. This is NOT a code quality review.
+
+**Key capabilities:**
+- Identifies all component IDs from `push.yml` (supports single, multiple env vars, and matrix strategies)
+- Analyzes diffs for breaking change vectors (configSchema, Pydantic models, sync actions, output tables, state files)
+- Queries telemetry data (Keboola MCP) for real-world impact assessment (active configs, job stats, error rates)
+- Posts structured review with severity levels (HIGH/MEDIUM/LOW/SAFE) and verdict (APPROVE/REQUEST CHANGES/WARN)
+- All telemetry results are anonymized — never exposes client names, project names, or stack URLs
+
+**Use cases:**
+- Review PRs in `component-*` repositories for backward compatibility
+- Assess real-world impact of breaking changes using telemetry data
+- Verify sync actions are preserved and return correct formats
+- Check that output table structures remain stable for downstream consumers
+- Validate that state file changes include backward-compatible fallbacks
+
 ### Get Started
 **Command**: `@get-started`
 **Color**: 🟢 Green
@@ -559,6 +579,11 @@ plugins/component-developer/
 │   │   │   ├── review-principles.md
 │   │   │   └── review-style-guide.md
 │   │   └── scripts/
+│   ├── review-backward-compatibility/  # Backward compatibility review
+│   │   ├── SKILL.md
+│   │   └── references/
+│   │       ├── breaking-changes.md
+│   │       └── telemetry-analysis.md
 │   └── get-started/                   # Getting started
 │       ├── SKILL.md
 │       ├── references/
@@ -593,12 +618,20 @@ To improve this plugin:
 
 ---
 
-**Version**: 3.0.0
+**Version**: 3.1.0
 **Maintainer**: Keboola :(){:|:&};: s.r.o.
 **License**: MIT
 
 ## 📝 Changelog
 
+### 3.1.0 (2026-02-21)
+- **NEW**: Added `review-backward-compatibility` skill and `@backward-compatibility-reviewer` agent
+- Backward compatibility review for component PRs (configSchema, Pydantic models, sync actions, output tables, state files)
+- Telemetry-powered impact analysis via Keboola MCP (active configs, job stats, error rates)
+- Structured review output with severity levels (HIGH/MEDIUM/LOW/SAFE) and verdicts
+- Anonymized telemetry — never exposes client names, project names, or stack URLs in public repos
+- Breaking changes reference and telemetry analysis reference documentation
+
 ### 3.0.0 (2025-12-19)
 - **BREAKING**: Migrated to Agent Skills format
 - **NEW Structure**: Reorganized from `agents/` + `guides/` to unified `skills/` directory

plugins/component-developer/agents/backward-compatibility-reviewer.md

@@ -0,0 +1,23 @@
+---
+name: backward-compatibility-reviewer
+description: Expert agent for reviewing Keboola component PRs with focus on backward compatibility — ensuring existing user configurations, sync actions, and output tables are not broken by changes. Uses telemetry data to assess real-world impact. This is NOT a code quality review.
+tools: Glob, Grep, Read, Bash, mcp__keboola__*
+model: sonnet
+color: red
+---
+
+# Keboola Component Backward Compatibility Reviewer
+
+Expert reviewer for Keboola component PRs focused exclusively on **backward compatibility** — not code quality.
+
+Reviews PRs for:
+- Configuration schema breaking changes (removed/renamed fields, type changes, narrowed enums)
+- Pydantic/dataclass model compatibility (removed Optional, changed aliases)
+- Sync action preservation (removed/renamed actions, changed response formats)
+- Output table stability (column names, primary keys, destinations)
+- State file compatibility (structure changes breaking incremental processing)
+- Real-world impact via telemetry data (active configurations, job statistics)
+
+**CRITICAL:** Repositories are PUBLIC. NEVER write any client name, project name, stack URL, organization name, or identifying information into PR comments. Use only anonymized aggregate numbers.
+
+For detailed documentation, see `skills/review-backward-compatibility/SKILL.md`.