migrate-systems

Orchestrate incremental system migrations with AST-based codemods and verification patterns.

4|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/lushly-dev/afd --skill migrate-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-systems
Source: https://github.com/lushly-dev/afd/tree/main/.claude/skills/migrate-systems
Command: npx skills add https://github.com/lushly-dev/afd --skill migrate-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines complex system migrations, framework upgrades, and large-scale refactors, minimizing downtime and risk through incremental, automated patterns.

Core Features & Use Cases

  • Automated Refactoring: Apply AST-based codemods to automate repetitive code changes across your codebase.
  • Incremental Migration Patterns: Safely migrate systems using strategies like Strangler Fig, Expand-Contract, and Parallel Run.
  • Use Case: You need to upgrade your application from an old version of React to the latest. This Skill can guide you through applying official codemods, managing dependency bumps, and verifying the upgrade incrementally.

Quick Start

Use the migrate-systems skill to plan a framework upgrade for your project.

Frequently Asked Questions about migrate-systems

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely upgrade a framework version without causing downtime?

Database schema evolution can be managed safely using the expand-contract pattern. This technique allows you to incrementally add new schema structures, migrate data, and verify dual-write consistency before removing the old schema.

What is the best way to automate repetitive code changes across a large codebase?

AST-based codemods automate repetitive code changes by transforming abstract syntax trees using tools like jscodeshift, ts-morph, or libcst. This enables large-scale, automated refactoring with precise syntax-aware modifications.

Can I use feature flags to gate migration rollouts incrementally?

Feature-flag-gated rollouts are supported for orchestrating system migrations. This allows you to incrementally deploy migrated components, verify behavior in production, and safely roll back changes if issues arise during the migration.

When do I need the expand-contract pattern for database schema evolution?

The expand-contract pattern is needed for database schema evolution when you must avoid downtime during structural changes. It works by expanding the schema to support both old and new formats, migrating data, then contracting by removing deprecated structures.

What is a strangler fig migration and when should I use it?

A strangler fig migration incrementally replaces a legacy system by building new functionality alongside the old, gradually routing traffic to the new system. Use it for large-scale system migrations where a complete rewrite is too risky.