deprecation-and-migration

Plan deprecation and migration with replacement plans and removal criteria.

2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/GoBeromsu/obsidian-workspace --skill deprecation-and-migration-goberomsu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deprecation-and-migration
Source: https://github.com/GoBeromsu/obsidian-workspace/tree/main/.claude/skills/deprecation-and-migration
Command: npx skills add https://github.com/GoBeromsu/obsidian-workspace --skill deprecation-and-migration-goberomsu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Legacy systems, APIs, and features accumulate maintenance costs, security risk, and organizational fatigue. This skill provides a disciplined approach to sunsetting unused components, migrating users safely, and deciding whether to maintain or remove legacy code.

Core Features & Use Cases

  • Structured deprecation planning to decide what to remove and when.
  • Migration patterns and tooling guidance (Strangler, Adapter, and feature-flag based approaches) to guide safe transitions.
  • Clear documentation, stakeholder communication, and removal readiness to minimize disruption.

Quick Start

Begin by selecting the deprecated system and drafting a migration plan that follows this guide.

Frequently Asked Questions about deprecation-and-migration

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

FAQPage Schema
How do I plan a safe migration from a deprecated API to a new implementation?

Plan a safe migration by drafting a replacement strategy, generating migration tooling, and establishing clear removal criteria. This structured approach enforces migration readiness, using patterns like Strangler or Adapter, to transition users safely off deprecated systems.

What is the best way to sunset a legacy feature without disrupting users?

Sunsetting a legacy feature safely requires clear documentation, stakeholder communication, and a defined replacement plan. This approach minimizes disruption by enforcing migration-ready processes and removal criteria before legacy code is actually removed.

When should I decide between maintaining or removing legacy code?

Decide whether to maintain or remove legacy code by evaluating accumulated maintenance costs and security risks against migration readiness. Apply structured deprecation planning to your project backlog to determine safe sunset timing and removal criteria.

Does this approach support feature-flag based migration patterns?

Yes, this approach supports feature-flag based migration patterns alongside Strangler and Adapter approaches. It guides safe transitions by enforcing a migration-ready process tailored to your specific codebase and replacement plan.

What are the risks of removing deprecated systems without a migration guide?

Removing deprecated systems without a migration guide introduces organizational fatigue and security risks from unmaintained legacy code. Enforcing a structured deprecation plan with documentation and migration tooling minimizes these disruptions.