principle-migrate-callers-then-delete-legacy-apis
Installation
SKILL.md
Migrate Callers Then Delete Legacy APIs
Portability (required)
This skill is part of the portable pstack pack.
- Read the
pstackcapability contract and the adapter for the active coding agent before any helper delegation. - Prefer capability verbs (
explore,implement,review,parallel,ask_user,verify,model_role) over vendor tool names. - Resolve models through
model_role. Never require a vendor-specific model identifier. - When helper spawning is unavailable, run the work on the lead agent and state that fan-out was collapsed.
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