Migration Sherpa Agent

The Migration Sherpa Agent guides you through framework and runtime upgrades with staged PRs and automated code transformations.

What It Does

• Analyzes upgrade paths - Determines the best route for migration
• Detects breaking changes - Identifies code that needs modification
• Creates staged PRs - Breaks migration into manageable chunks
• Runs compatibility tests - Verifies each stage works correctly
• Provides rollback plans - Documents how to revert if needed

Supported Migrations

| From | To | Support | |------|-----|---------| | React 17 | React 18+ | Full | | Next.js 12/13 | Next.js 14/15 | Full | | Vue 2 | Vue 3 | Full | | Django 3 | Django 4/5 | Full | | Node.js LTS | Latest LTS | Full | | TypeScript 4.x | TypeScript 5.x | Full |

Configuration

agents:
  - name: migration-sherpa
    template: migration-sherpa
    triggers:
      manual: true
    config:
      # Target version to migrate to
      target_version: "next@14"

      # Create staged PRs or single PR
      staged_migration: true

      # Number of files per PR
      batch_size: 20

      # Run tests after each transformation
      test_after_transform: true

Migration Process

1. Analysis Phase

   • Scans codebase for deprecated APIs
   • Identifies breaking changes
   • Estimates effort and risk

2. Planning Phase

   • Creates migration plan with stages
   • Prioritizes by dependency order
   • Generates rollback strategy

3. Execution Phase

   • Creates PRs for each stage
   • Applies code transformations
   • Runs tests after each change

4. Validation Phase

   • Verifies all tests pass
   • Checks for runtime issues
   • Documents completed migration