legacy-migration

Guide incremental migration of legacy frontend systems to feature-based architecture.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/madlado87/agentes --skill legacy-migration-madlado87
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: legacy-migration
Source: https://github.com/madlado87/agentes/tree/main/.github/skills/legacy-migration
Command: npx skills add https://github.com/madlado87/agentes --skill legacy-migration-madlado87

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Legacy Migration Skill guides teams in transitioning legacy frontend systems to a modern feature-based architecture, enabling incremental refactors without disrupting user experience.

Core Features & Use Cases

  • Stepwise migration planning from Pages Router to App Router, Redux to Zustand/React Query, and monolithic codebases to feature modules.
  • Schema-first approach with Zod to define data models before UI changes, and to drive safe API and client boundaries.
  • Migration playbooks and decision trees that preserve URLs, offer test-before-move guidance, and enforce incremental delivery.

Quick Start

Identify a legacy feature and begin by creating a corresponding src/features/[feature] structure, then migrate one component or page at a time.

Frequently Asked Questions about legacy-migration

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

FAQPage Schema
How do I migrate a Next.js Pages Router to App Router without breaking existing routes?

Migrating Next.js Pages Router to App Router requires an incremental approach that preserves URLs and UX parity. You can restructure monolithic code into feature modules and migrate one page at a time using test-before-move guidance to ensure behavioral consistency.

What is the best way to migrate Redux to Zustand or React Query incrementally?

Migrating Redux to Zustand or React Query is guided by a stepwise playbook that transitions state management feature by feature. This incremental delivery method preserves behavioral parity while restructuring monolithic codebases into isolated feature modules.

Do I need Zod schemas before migrating frontend components to a feature-based architecture?

Yes, a schema-first approach with Zod defines data models before UI changes. This establishes safe API and client boundaries, ensuring that data validation drives the migration process when restructuring monolithic code into feature modules.

Can I refactor a monolithic frontend into feature modules without disrupting user experience?

Refactoring a monolithic frontend into feature modules preserves user experience through incremental delivery and strict behavioral parity. You migrate one component at a time into a src/features/[feature] structure, enforcing test-before-move guidance throughout.

Does converting manual types to Zod schemas support incremental frontend migration?

Converting manual types to Zod schemas supports incremental migration by establishing schema-first validation. This defines safe data boundaries before moving UI components, ensuring that API and client interfaces remain stable during the transition to feature modules.