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.

  1. Read the pstack capability contract and the adapter for the active coding agent before any helper delegation.
  2. Prefer capability verbs (explore, implement, review, parallel, ask_user, verify, model_role) over vendor tool names.
  3. Resolve models through model_role. Never require a vendor-specific model identifier.
  4. 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
Installs
9
Repository
go7hic/ystack
GitHub Stars
14
First Seen
Aug 5, 2026
principle-migrate-callers-then-delete-legacy-apis — go7hic/ystack