framework-compatibility-checker

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