mcpField
P
principle-migrate-callers-then-delete-legacy-apis

principle-migrate-callers-then-delete-legacy-apis

github.com/q-qp-pDevelopment146 installsUpdated 2w ago
Repository

About principle-migrate-callers-then-delete-legacy-apis

This skill guides refactors that replace an internal API: migrate callers to the new contract, then remove the legacy API in the same change wave. It is intended for projects able to coordinate breaking changes without preserving external compatibility.

Key features

  1. 01Inventory existing API callers
  2. 02Migrate callers to the new contract
  3. 03Remove legacy API paths
  4. 04Update tests for the new contract
  5. 05Time-box exceptional adapters

Use cases

  1. 01Simplifying an internal API during refactoring
  2. 02Coordinating a breaking change without external compatibility needs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/q-qp-p/pstack --skill principle-migrate-callers-then-delete-legacy-apis

After installing, type/principle-migrate-callers-then-delete-legacy-apisin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported