Skip to content

a5c-ai/babysitter / library/specializations/code-migration-modernization/skills/framework-compatibility-checker

framework-compatibility-checker

Verified

Check codebase compatibility with target framework versions and generate migration paths

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

ToolFrameworkIntegration Method
Angular Update GuideAngularWeb / API
React CodemodReactCLI
Next.js UpgradeNext.jsCLI
Spring Boot MigratorSpringCLI
Vue Migration GuideVueWeb / CLI
.NET Upgrade Assistant.NETCLI

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
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall