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

FileKindSize
README.mdmarkdown1.5 KB
SKILL.mdskill md3.0 KB
---
name: framework-compatibility-checker
description: Check codebase compatibility with target framework versions and generate migration paths
allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Edit"]
graph:
  domains: [domain:software-engineering]
  specializations: [specialization:code-migration-modernization]
  skillAreas: [skill-area:dependency-upgrade-strategies, skill-area:breaking-change-management]
  roles: [role:backend-engineer, role:tech-lead]
  workflows: [workflow:technical-debt-reduction]
  topics: [topic:refactoring]
---

# 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

```json
{
  "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: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated 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: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall