Migrate

by parcadeid07ff4b06b62No license3.9K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Migration workflow - research → analyze → plan → implement → review

Instructions onlySoftware Development DevOps & Cloud

AI-generated overview

Guides a five-phase migration workflow for frameworks, languages, databases and infrastructure.

What it does: This skill defines a migration workflow that moves a project from one framework, language version, database or infrastructure to another. It sequences five phases: research the target, analyze the current codebase, produce a phased migration plan, implement the changes, and review the result. Each phase is described as a delegated task with a stated output, such as a research report, impact analysis, migration plan, code changes or review report. It also documents migration types, incremental phase-by-phase execution and flags such as dry-run, rollback and parallel.
When to use it: Use it when asked to migrate or upgrade a framework, language version, database or infrastructure, such as moving from Express to Fastify or Python 3.9 to 3.12. It suits high-risk migrations where breaking changes, dependency conflicts or data format changes need extra research and review gates. It can also be run one phase at a time for large codebases.
Requirements: Instructions only; no scripts are shipped. It assumes the named subagents (oracle, phoenix, plan-agent, kraken, surveyor) are available to execute the phases.

/migrate - Migration Workflow

Safe migrations for frameworks, languages, and infrastructure.

When to Use

"Migrate to X"
"Upgrade framework"
"Move from X to Y"
"Upgrade Python/Node/etc."
"Migrate database"
Framework version upgrades
Language migrations
Infrastructure changes

Workflow Overview

┌──────────┐    ┌──────────┐    ┌────────────┐    ┌──────────┐    ┌───────────┐│  oracle  │───▶│ phoenix  │───▶│   plan-    │───▶│  kraken  │───▶│ surveyor  ││          │    │          │    │   agent    │    │          │    │           │└──────────┘    └──────────┘    └────────────┘    └──────────┘    └───────────┘  Research       Analyze          Plan             Implement       Review  target         current          migration        changes         migration

┌──────────┐    ┌──────────┐    ┌────────────┐    ┌──────────┐    ┌───────────┐│  oracle  │───▶│ phoenix  │───▶│   plan-    │───▶│  kraken  │───▶│ surveyor  ││          │    │          │    │   agent    │    │          │    │           │└──────────┘    └──────────┘    └────────────┘    └──────────┘    └───────────┘  Research       Analyze          Plan             Implement       Review  target         current          migration        changes         migration

Agent Sequence

#	Agent	Role	Output
1	oracle	Research target framework/version	Research report
2	phoenix	Analyze current codebase for migration impact	Impact analysis
3	plan-agent	Create phased migration plan	Migration plan
4	kraken	Implement migration changes	Code changes
5	surveyor	Review migration for completeness	Migration review

Why Extra Gates?

Migrations are high-risk:

Breaking changes between versions
Dependency conflicts
Data format changes
API deprecations

The extra research and review phases catch issues early.

Execution

Phase 1: Research Target

Task(  subagent_type="oracle",  prompt="""  Research migration target: [TARGET]
  Investigate:  - Breaking changes from current version  - New APIs and patterns  - Deprecated features we use  - Migration guides from official docs  - Common pitfalls and solutions
  Output: Migration research report  """)

Task(  subagent_type="oracle",  prompt="""  Research migration target: [TARGET]
  Investigate:  - Breaking changes from current version  - New APIs and patterns  - Deprecated features we use  - Migration guides from official docs  - Common pitfalls and solutions
  Output: Migration research report  """)

Phase 2: Analyze Current State

Task(  subagent_type="phoenix",  prompt="""  Analyze codebase for migration: [FROM] → [TO]
  Identify:  - Files using deprecated APIs  - Dependency conflicts  - Patterns that need updating  - Test coverage of affected areas  - Risk areas (critical paths)
  Output: Impact analysis with affected files  """)

Task(  subagent_type="phoenix",  prompt="""  Analyze codebase for migration: [FROM] → [TO]
  Identify:  - Files using deprecated APIs  - Dependency conflicts  - Patterns that need updating  - Test coverage of affected areas  - Risk areas (critical paths)
  Output: Impact analysis with affected files  """)

Phase 3: Plan Migration

Task(  subagent_type="plan-agent",  prompt="""  Create migration plan: [FROM] → [TO]
  Research: [from oracle]  Impact: [from phoenix]
  Plan should:  - Be phased (incremental if possible)  - Each phase independently testable  - Include rollback strategy  - Prioritize critical path stability
  Output: Phased migration plan  """)

Task(  subagent_type="plan-agent",  prompt="""  Create migration plan: [FROM] → [TO]
  Research: [from oracle]  Impact: [from phoenix]
  Plan should:  - Be phased (incremental if possible)  - Each phase independently testable  - Include rollback strategy  - Prioritize critical path stability
  Output: Phased migration plan  """)

Phase 4: Implement

Task(  subagent_type="kraken",  prompt="""  Implement migration phase: [PHASE_N]
  Plan: [from plan-agent]
  Requirements:  - Follow plan exactly  - Run tests after each change  - Document any deviations  - Stop if tests fail
  Output: Completed phase with test results  """)

Task(  subagent_type="kraken",  prompt="""  Implement migration phase: [PHASE_N]
  Plan: [from plan-agent]
  Requirements:  - Follow plan exactly  - Run tests after each change  - Document any deviations  - Stop if tests fail
  Output: Completed phase with test results  """)

Phase 5: Review Migration

Task(  subagent_type="surveyor",  prompt="""  Review migration: [FROM] → [TO]
  Check:  - All deprecated APIs replaced  - No remaining compatibility shims  - Tests passing  - Performance acceptable  - No security regressions
  Output: Migration review report  """)

Task(  subagent_type="surveyor",  prompt="""  Review migration: [FROM] → [TO]
  Check:  - All deprecated APIs replaced  - No remaining compatibility shims  - Tests passing  - Performance acceptable  - No security regressions
  Output: Migration review report  """)

Migration Types

Framework Upgrade

Language Version

Database Migration

Infrastructure

Example

User: /migrate from Express to Fastify
Claude: Starting /migrate workflow: Express → Fastify
Phase 1: Researching Fastify...[Spawns oracle]Key differences:- Schema-based validation (vs middleware)- Plugin architecture- Async/await native- Different middleware pattern
Phase 2: Analyzing current Express usage...[Spawns phoenix]Impact analysis:- 23 route files to update- 8 middleware to convert- 3 plugins need Fastify equivalents- Test coverage: 78%
Phase 3: Creating migration plan...[Spawns plan-agent]
Migration Plan: Express → Fastify━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Phase 1: Setup & Core- Add Fastify alongside Express- Migrate core server setup- Run both in parallel
Phase 2: Routes (by domain)- Migrate auth routes- Migrate user routes- Migrate product routes- ...
Phase 3: Middleware- Convert error handler- Convert auth middleware- Convert logging
Phase 4: Cleanup- Remove Express- Remove compatibility layer- Final testing
Rollback: Keep Express until Phase 4 complete
Phase 4: Implementing Phase 1...[Spawns kraken]✅ Fastify server running alongside Express✅ Core routes migrated✅ Tests passing
[Continues through phases...]
Phase 5: Reviewing migration...[Spawns surveyor]✅ All Express code removed✅ 23/23 routes migrated✅ Performance improved (2.1x faster)✅ No security regressions
Migration complete! Express → Fastify

User: /migrate from Express to Fastify
Claude: Starting /migrate workflow: Express → Fastify
Phase 1: Researching Fastify...[Spawns oracle]Key differences:- Schema-based validation (vs middleware)- Plugin architecture- Async/await native- Different middleware pattern
Phase 2: Analyzing current Express usage...[Spawns phoenix]Impact analysis:- 23 route files to update- 8 middleware to convert- 3 plugins need Fastify equivalents- Test coverage: 78%
Phase 3: Creating migration plan...[Spawns plan-agent]
Migration Plan: Express → Fastify━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Phase 1: Setup & Core- Add Fastify alongside Express- Migrate core server setup- Run both in parallel
Phase 2: Routes (by domain)- Migrate auth routes- Migrate user routes- Migrate product routes- ...
Phase 3: Middleware- Convert error handler- Convert auth middleware- Convert logging
Phase 4: Cleanup- Remove Express- Remove compatibility layer- Final testing
Rollback: Keep Express until Phase 4 complete
Phase 4: Implementing Phase 1...[Spawns kraken]✅ Fastify server running alongside Express✅ Core routes migrated✅ Tests passing
[Continues through phases...]
Phase 5: Reviewing migration...[Spawns surveyor]✅ All Express code removed✅ 23/23 routes migrated✅ Performance improved (2.1x faster)✅ No security regressions
Migration complete! Express → Fastify

Incremental Migration

For large codebases, run one phase at a time:

User: /migrate React 17 → 18 --phase 1[Runs only Phase 1]
User: /migrate React 17 → 18 --phase 2[Runs Phase 2, reads previous handoff]

User: /migrate React 17 → 18 --phase 1[Runs only Phase 1]
User: /migrate React 17 → 18 --phase 2[Runs Phase 2, reads previous handoff]

Flags

--phase N: Run specific phase only
--dry-run: Plan without implementing
--rollback: Execute rollback plan
--parallel: Run new alongside old (strangler fig)

Source and attribution

Source:parcadei/continuous-claude-v3in.claude/skills/migrateat commitd07ff4b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Migrate

/migrate - Migration Workflow

When to Use

Workflow Overview

Agent Sequence

Why Extra Gates?

Execution

Phase 1: Research Target

Phase 2: Analyze Current State

Phase 3: Plan Migration

Phase 4: Implement

Phase 5: Review Migration

Migration Types

Framework Upgrade

Language Version

Database Migration

Infrastructure

Example

Incremental Migration

Flags

Source and attribution

More from parcadei/continuous-claude-v3

Tldr Stats

Wiring

Workflow Router

Validate Agent

Tour

Tldr Overview

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices