Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
cursor avatar

Principle Migrate Callers Then Delete Legacy Apis

  • 404 installs
  • 2.5k repo stars
  • Updated August 5, 2026
  • cursor/plugins

When deprecating an endpoint, SDK method, or internal API, migrate every caller to the replacement surface before removing the legacy contract.

About

Teaches a safe API deprecation workflow: locate every caller of a legacy interface, move each to the new API, confirm zero remaining references, then delete the old surface so refactors do not break downstream services or clients.

  • Inventory all callers first
  • Ship replacement before removal
  • Avoid breaking silent consumers
  • Stage dual-run if needed
  • Delete legacy only when unused

Principle Migrate Callers Then Delete Legacy Apis by the numbers

  • 404 all-time installs (skills.sh)
  • Ranked #1,073 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/cursor/plugins --skill principle-migrate-callers-then-delete-legacy-apis

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs404
repo stars2.5k
Last updatedAugust 5, 2026
Repositorycursor/plugins

What it does

When deprecating an endpoint, SDK method, or internal API, migrate every caller to the replacement surface before removing the legacy contract.

Files

SKILL.mdMarkdownGitHub ↗

Migrate Callers Then Delete Legacy APIs

When we decide a new API is the right design, migrate callers and remove the old API in the same refactor wave instead of preserving compatibility layers.

Rule:

  • Do not keep legacy API paths alive only because internal callers still exist
  • Inventory callers, migrate them, and delete the old API immediately
  • Treat temporary adapters as exceptional and time-boxed, not default architecture
  • Update tests to assert the new contract, and delete tests that only protect pre-refactor implementation details

When this applies:

  • No external users depend on backward compatibility
  • The project can absorb coordinated breaking changes
  • The new API is part of a simplification or refactor initiative

Keeping both old and new APIs creates dual-path complexity, slows cleanup, and makes the codebase feel append-only.

Related skills

Backend & APIsbackendintegrations

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.