deprecation-and-migration

Plan and execute legacy system retirement with incremental user migration.

Updated May 27, 2026
One-click install
npx skills add https://github.com/santanapol/agent-skills --skill deprecation-and-migration-santanapol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deprecation-and-migration
Source: https://github.com/santanapol/agent-skills/tree/main/.cursor/skills/deprecation-and-migration
Command: npx skills add https://github.com/santanapol/agent-skills --skill deprecation-and-migration-santanapol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk and hidden costs of maintaining unneeded legacy systems, outdated APIs, and unused features, while ensuring users are not disrupted when old tools are retired.

Core Features & Use Cases

  • Deprecation Decision Framework: Guides teams to evaluate whether to retire a system by assessing maintenance costs, user impact, and replacement readiness, with clear guidance for advisory vs compulsory deprecation.
  • Structured Migration Process: Provides step-by-step instructions for incremental user migration, including pre-migration planning, cutover execution, and post-migration cleanup.
  • Proven Migration Patterns: Includes ready-to-use patterns like Strangler, Adapter, and Feature Flag migration to fit different system architectures and user bases.
  • Zombie Code Management: Helps identify and address unmaintained, ownerless code that poses security and stability risks.
  • Use Case: A team planning to retire a legacy internal authentication API can use this Skill to build a deprecation timeline, create a migration guide for dependent teams, and execute the cutover without breaking existing user workflows.

Quick Start

Use the deprecation-and-migration skill to create a deprecation plan and step-by-step migration guide for the legacy payment processing API used by the customer support team.

Frequently Asked Questions about deprecation-and-migration

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

FAQPage Schema
How do I safely retire a legacy API without disrupting dependent users?

To safely retire a legacy API, use a structured migration process that includes deprecation planning, incremental user migration, and post-deprecation verification checklists to minimize disruption and ensure complete system retirement.

What is the best way to plan an incremental migration from a legacy system?

The best way to plan an incremental migration involves using proven patterns like Strangler, Adapter, and Feature Flag migration, which fit different system architectures and allow gradual user cutover without breaking existing workflows.

How do I decide if an outdated system is ready for deprecation?

Decide if an outdated system is ready for deprecation by applying a decision framework that evaluates maintenance costs, user impact, and replacement readiness to determine whether advisory or compulsory retirement is appropriate.

How can I identify and clean up unmaintained zombie code in my repository?

Identify and clean up unmaintained zombie code by evaluating ownerless code that poses security and stability risks, then applying structured retirement checklists to safely remove the unused features from your workflow.

What migration patterns work best for retiring legacy systems?

The best migration patterns for retiring legacy systems include Strangler, Adapter, and Feature Flag approaches, which provide structured frameworks for incremental user migration and low-risk cutover execution across different architectures.

Do I need a post-migration checklist when retiring an internal API?

Yes, you need a post-migration checklist when retiring an internal API to verify deprecation completeness, ensure dependent teams have switched over, and confirm that the legacy system retirement poses no remaining security or stability risks.