deprecation-and-migration

Codify a deprecation plan with migration steps and verification criteria.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/jota-batuta/batuta-dots --skill deprecation-and-migration-jota-batuta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deprecation-and-migration
Source: https://github.com/jota-batuta/batuta-dots/tree/main/BatutaClaude/skills/deprecation-and-migration
Command: npx skills add https://github.com/jota-batuta/batuta-dots --skill deprecation-and-migration-jota-batuta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and execute safe deprecations and migrations to minimize risk when sunsetting features or systems.

Core Features & Use Cases

  • Deprecation decision framework (advisory vs compulsory) with migration planning.
  • Structured migration tooling and comprehensive documentation guidance.
  • Migration patterns and best practices (Strangler, Adapter, Feature Flags) to minimize risk.
  • Verification and removal checklist to ensure complete handover and clean-up.

Quick Start

Draft a deprecation plan by identifying the system to sunset, the replacement, and a concrete migration path for all consumers.

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 code migration and deprecation process for sunsetting features?

To plan safe code migration, you must codify a deprecation plan with structured migration steps, replacement tooling, and stakeholder alignment. This ensures responsible code removal by verifying completion through measurable criteria before fully sunsetting the system.

What migration patterns are best for minimizing risk during software deprecation?

The best migration patterns for minimizing risk during software deprecation include the Strangler pattern, Adapter pattern, and Feature Flags. These approaches allow gradual transitions and safe code removal while maintaining system stability throughout the consolidation process.

When do I need a formal deprecation plan for removing outdated code?

You need a formal deprecation plan for removing outdated code when sunsetting features, consolidating duplicate implementations across teams, or retiring legacy systems. It requires a replacement plan, migration tooling, and stakeholder alignment to ensure safe code removal.

How do I verify that a software migration is complete and safe for code removal?

To verify a software migration is complete and safe for code removal, use a structured verification and removal checklist. This ensures complete handover to the replacement system, confirms all consumers have migrated, and validates that measurable completion criteria are met.

Does this deprecation framework work for consolidating duplicate implementations across multiple teams?

Yes, this deprecation framework specifically applies to software systems undergoing consolidation of duplicate implementations across teams. It provides structured migration steps, advisory and compulsory decision frameworks, and stakeholder alignment tools to manage cross-team code removal safely.

What is the difference between advisory and compulsory deprecation in software maintenance?

Advisory deprecation warns users about upcoming code removal while allowing continued operation, whereas compulsory deprecation enforces migration. The framework helps codify both approaches with appropriate migration guidance, tooling, and timelines for responsible software maintenance.