Principle Migrate Callers Then Delete Legacy Apis

by cursorccb5507cec15No license10K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Apply when introducing a new internal API while old callers still exist. Migrate callers and delete the old API in the same wave instead of preserving compatibility layers.

Instructions onlySoftware Development
AI-generated overview

Guides migrating internal API callers and deleting the legacy API in the same refactor wave.

What it does
This skill states a refactoring principle: when a new internal API is chosen, callers should be inventoried, migrated, and the old API deleted in the same wave rather than keeping compatibility layers. It also advises treating temporary adapters as exceptional and time-boxed, and updating tests to assert the new contract while removing tests tied to pre-refactor details. It produces guidance, not code or files.
When to use it
Use it when introducing a new internal API while old callers still exist and no external users depend on backward compatibility. It fits projects that can absorb coordinated breaking changes as part of a simplification or refactor initiative.
Requirements
None beyond the agent; instructions only, with no scripts or external tools.

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 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.

Source and attribution

Source:cursor/pluginsinpstack/skills/principle-migrate-callers-then-delete-legacy-apisat commitccb5507

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from cursor/plugins

Unslop

cursor

Edits text to remove AI writing tells, following a numbered list of patterns to detect and fix.

Writing & Content10Kupdated today

Setup Pstack

cursor

Writes a Cursor rule that sets pstack's model per role and reasoning budget.

AI & Agents10Kupdated today

Principle Type System Discipline

cursor

Guides agents to use static type systems to make illegal states unrepresentable and eliminate runtime failures.

Software Development10Kupdated today

Thermo Nuclear Review

cursor

Audits a checked-out branch or PR diff for bugs, breaking changes, security issues, devex regressions and feature-gate leaks.

Security10Kupdated today

Run Learning Retrospective

cursor

Guides a learning retrospective to review progress, find blockers, and adjust a learning plan.

Learning & Education10Kupdated today

Ralph Loop Help

cursor

Explains the Ralph Loop plugin, its iterative technique, options, cancellation, and when to use it.

AI & Agents10Kupdated today

More in Software Development

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Software Development37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

Software Development37Kupdated today

Cardputer Buddy

anthropics

Featured

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

Software Development37Kupdated today

Dpop Adoption

google

Featured

Guides implementation of OAuth 2.0 DPoP (RFC 9449) sender-constrained refresh tokens for Google's OAuth platform.

Software Development21Kupdated today

Gemini Live Api

google

Featured

Generates a Gemini Live API WebSocket client class, tests, docs, and a demo UI for bidirectional streaming.

Software Development21Kupdated today

Gemini Api

google

Featured

Guides use of the Gemini API on Google's Agent Platform with the Gen AI SDK across languages and capabilities.

Software Development21Kupdated today