Back to prompts
Coding & DevelopmentPremiumadvanced
0.0

Migration Playbook — Move Between Frameworks Without Breaking Everything

Migrating frameworks? This prompt creates a step-by-step migration plan with zero downtime.

Copy & Paste this prompt
You are a software migration specialist who has led 50+ major framework and language migrations without downtime or data loss.

Plan my migration.

From: [CURRENT FRAMEWORK/LANGUAGE/VERSION]
To: [TARGET FRAMEWORK/LANGUAGE/VERSION]
Project size: [ROUGH LOC COUNT OR DESCRIPTION — small/medium/large]
Team size: [HOW MANY DEVELOPERS?]
Can we freeze features during migration? [YES / NO / PARTIALLY]
Must-not-break: [CRITICAL FEATURES THAT CANNOT HAVE DOWNTIME]

Create a complete migration playbook:

1. COMPATIBILITY AUDIT — What breaks immediately? List every breaking change between source and target with severity.

2. MIGRATION STRATEGY — Recommend one:
   - Big Bang (rewrite everything at once)
   - Strangler Fig (gradually replace piece by piece)
   - Parallel Run (run both, compare, switch)
   Explain WHY this strategy fits my situation.

3. PHASE PLAN — Break the migration into ordered phases:
   Phase 1: [scope] — [estimated days] — [risk level]
   Phase 2: [scope] — [estimated days] — [risk level]

4. AUTOMATED CODEMODS — List any existing migration tools, codemods, or scripts that automate parts of the migration. Include exact commands.

5. TESTING STRATEGY — How to verify the migration works:
   - Unit test migration approach
   - Integration test critical paths
   - Regression test checklist
   - Performance comparison baseline

6. ROLLBACK PLAN — Exact steps to revert if things go wrong at each phase.

7. GOTCHAS — Non-obvious things that WILL bite you during this specific migration.
#migration#framework#upgrade#planning#refactoring

Works with

chatgptclaudecopilot

💡 Pro Tips

  • •Always use Strangler Fig for production systems — Big Bang migrations fail 60% of the time
  • •Set up automated tests BEFORE starting the migration
  • •Keep a migration journal — document every surprise for the team

✨ Example Output

MIGRATION: Express.js → Fastify
STRATEGY: Strangler Fig — recommended because your API has 47 endpoints and you can't freeze features.
PHASE 1 (3 days, Low risk): Set up Fastify alongside Express, route /health and /status to Fastify
PHASE 2 (5 days, Medium): Migrate stateless GET endpoints
GOTCHA: Fastify's plugin system is different from Express middleware — you can't just copy-paste app.use() calls.