Skills 译文
- Skills
- official-guide
- architect
  - architect
- arena
  - arena
- automate-me
  - automate-me
- blast-radius
  - blast-radius
- bro
  - bro
- create-verification-skill
  - create-verification-skill
- figure-it-out
  - figure-it-out
- how
  - how
- interrogate
  - interrogate
- maintain-verification-skill
  - maintain-verification-skill
- make-bot-ui
  - Make Bot UI
- no-comments
  - no-comments
- poteto-mode
  - Poteto Mode
- recall
  - recall
- reflect
  - reflect
- setup-pstack
  - setup-pstack
- show-me-your-work
  - show-me-your-work
- swarm
  - swarm
- tdd
  - tdd
- teach
  - teach
- technical-writing
  - technical-writing
- typescript-best-practices
  - typescript-best-practices
- unslop
  - unslop
- why
  - why
- principle-attack-the-premise
  - principle-attack-the-premise
- principle-boundary-discipline
  - principle-boundary-discipline
- principle-build-the-lever
  - principle-build-the-lever
- principle-encode-lessons-in-structure
  - principle-encode-lessons-in-structure
- principle-exhaust-the-design-space
  - principle-exhaust-the-design-space
- principle-experience-first
  - principle-experience-first
- principle-fix-root-causes
  - principle-fix-root-causes
- principle-foundational-thinking
  - principle-foundational-thinking
- principle-guard-the-context-window
  - principle-guard-the-context-window
- principle-laziness-protocol
  - principle-laziness-protocol
- principle-make-operations-idempotent
  - principle-make-operations-idempotent
- principle-migrate-callers-then-delete-legacy-apis
  - principle-migrate-callers-then-delete-legacy-apis
- principle-minimize-reader-load
  - principle-minimize-reader-load
- principle-model-the-domain
  - principle-model-the-domain
- principle-never-block-on-the-human
  - principle-never-block-on-the-human
- principle-outcome-oriented-execution
  - principle-outcome-oriented-execution
- principle-prove-it-works
  - principle-prove-it-works
- principle-redesign-from-first-principles
  - principle-redesign-from-first-principles
- principle-separate-before-serializing-shared-state
  - principle-separate-before-serializing-shared-state
- principle-sequence-verifiable-units
  - principle-sequence-verifiable-units
- principle-subtract-before-you-add
  - principle-subtract-before-you-add
- principle-test-behavior-not-implementation
  - principle-test-behavior-not-implementation
- principle-type-system-discipline
  - principle-type-system-discipline
- agents
  - agents

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

Updated 2026-10-01

name: principle-migrate-callers-then-delete-legacy-apis
description: "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."
disable-model-invocation: true

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.

This is an unofficial Chinese learning site for pstack. It is not affiliated with poteto. Translations follow the pstack/ directory in the cursor/plugins repository. This site does not ship a Chinese plugin. github.com/cursor/plugins