deprecation-and-migration

Plan deprecation and migration of legacy systems, APIs, and libraries.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/logo-solutions/NAS-logo --skill deprecation-and-migration-logo-solutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deprecation-and-migration
Source: https://github.com/logo-solutions/NAS-logo/tree/main/skills/deprecation-and-migration
Command: npx skills add https://github.com/logo-solutions/NAS-logo --skill deprecation-and-migration-logo-solutions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams decide when and how to remove or replace old systems, APIs, libraries, and features to reduce maintenance cost, security risk, and technical debt while keeping users and integrations working.

Core Features & Use Cases

  • Deprecation Decision Framework: Questions and criteria to evaluate whether a system should be maintained, migrated, or removed.
  • Migration Patterns & Processes: Practical approaches including strangler, adapter, and feature-flag migrations plus incremental rollout guidance.
  • Verification & Governance: Steps to announce, document, verify zero active usage, and safely remove old code and configuration.
  • Use Case: Migrate a legacy internal API to a new service with an adapter shim, feature flags for progressive rollout, automated verification, and a documented removal timeline.

Quick Start

Use the deprecation-and-migration skill to draft a migration plan that replaces OldService with NewService, lists affected consumers, defines rollout phases, and specifies verification metrics.

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 migrate consumers from a legacy API to a new service?

Safely migrate legacy API consumers by applying incremental rollout patterns like the strangler or adapter pattern to route traffic to the new service. This uses feature flags for progressive exposure and automated verification metrics to ensure zero downtime transitions.

What is the strangler pattern for retiring legacy code?

The strangler pattern for retiring legacy code incrementally builds new functionality alongside the old system, routing traffic progressively until the legacy implementation is fully replaced. It enables safe removal by verifying zero active usage before final deprecation.

When should I use feature flags for a system migration?

Use feature flags for system migration when you need progressive rollout and quick rollback capabilities across microservices or client SDKs. They decouple deployment from release, enabling incremental user migration and automated verification before fully sunsetting legacy services.

What is the best way to plan deprecation timelines for sunsetting services?

Plan deprecation timelines for sunsetting services by documenting replacement implementations, listing affected consumers, and defining rollout phases. Establish clear schedules with verification metrics to confirm zero active usage before removing legacy code and configuration.

How do I verify zero active usage before removing old code?

Verify zero active usage before removing old code by implementing automated verification metrics that track traffic across microservices and client SDKs. Governance steps require confirming these metrics show no active dependencies before safely deleting legacy configuration.

Can I use an adapter pattern to consolidate implementations across microservices?

Yes, use an adapter pattern to consolidate implementations across microservices by creating a shim that translates between old and new interfaces. This enables incremental consumer migration without requiring simultaneous updates across all client SDKs and integrations.