Framework Compatibility Checker Skill

Checks codebase compatibility with target framework versions, identifies breaking changes, and recommends migration paths.

Purpose

Enable framework upgrade assessment for:

• Deprecated API detection
• Breaking change impact analysis
• Compatibility matrix generation
• Migration path recommendation
• Risk assessment

Capabilities

1. Deprecated API Usage Detection

• Find deprecated method calls
• Identify removed APIs
• Detect obsolete patterns
• Map replacement APIs

2. Breaking Change Impact Analysis

• Analyze upgrade changelogs
• Match breaking changes to code
• Estimate impact scope
• Prioritize by severity

3. Compatibility Matrix Generation

• Map current vs target versions
• List compatible dependencies
• Identify version conflicts
• Generate upgrade paths

4. Migration Path Recommendation

• Suggest incremental upgrades
• Identify intermediate versions
• Recommend safe upgrade order
• Plan breaking change handling

5. Risk Assessment

• Score upgrade difficulty
• Identify high-risk areas
• Estimate testing needs
• Calculate timeline impact

Tool Integrations

Tool	Framework	Integration Method
Angular Update Guide	Angular	Web / API
React Codemod	React	CLI
Next.js Upgrade	Next.js	CLI
Spring Boot Migrator	Spring	CLI
Vue Migration Guide	Vue	Web / CLI
.NET Upgrade Assistant	.NET	CLI

Output Schema

{
  "analysisId": "string",
  "timestamp": "ISO8601",
  "current": {
    "framework": "string",
    "version": "string"
  },
  "target": {
    "framework": "string",
    "version": "string"
  },
  "compatibility": {
    "compatible": "boolean",
    "breakingChanges": [
      {
        "type": "string",
        "description": "string",
        "locations": [],
        "migration": "string",
        "effort": "string"
      }
    ],
    "deprecations": [],
    "removedApis": []
  },
  "migrationPath": {
    "steps": [],
    "intermediateVersions": [],
    "estimatedEffort": "string"
  },
  "risk": {
    "score": "number",
    "factors": []
  }
}

Integration with Migration Processes

• framework-upgrade: Primary compatibility check
• language-version-migration: Version analysis

Related Skills

• codemod-executor: Automated fixes
• dependency-updater: Dependency upgrades

Related Agents

• framework-upgrade-specialist: Upgrade execution