api-migration
Installation
SKILL.md
API Migration
Use this skill when
- Migrating REST v1→v2 or to GraphQL
- Shifting internal implementations with stable contracts
- Coordinating old/new code coexistence
Do not use this skill when
- Minor additive feature work
- Non-API backend migration
Instructions
- Identify consumers and their traffic before migrating.
- Keep the old version live until the new one is proven.
- Add a compatibility layer where warranted.
- Shadow/dual-run new and old implementations and compare.
- Redirect consumers gradually; watch errors and latency.
- Set a sunset date and remove old code only after total cutover.
- Document what changed and what stayed (diff contract).