Skip to content
Kitbay
Skill

deprecation-and-migration

MITUpdated on Nov 1, 2026115,373GitHub stars

A skill from Addy Osmani's agent skills collection for retiring old systems, APIs or features and moving their users to a replacement.

What the skill teaches

A skill from Addy Osmani's agent skills collection for retiring old systems, APIs or features and moving their users to a replacement. It starts from the view that code is an ongoing cost, gives five questions for deciding whether to deprecate, and separates advisory from compulsory deprecation. The migration route is: build and prove the replacement, announce it with a guide, migrate each consumer and verify, then remove the old code only when usage is zero, using strangler, adapter or feature-flag patterns. For database schemas it sets out expand-and-contract steps so old and new code both work at every stage, and it ends with red flags and checklists.

Capabilities

  • Decide whether to deprecate a system or keep it
  • Plan a staged migration of each consumer
  • Change database schemas with expand-and-contract steps
  • Check that all traces of a removed system are gone