christofferbergj/agent-skills69 installs
principle-migrate-callers-then-delete-legacy-apis
Choose migration strategy when an API or schema replaces an old contract: coordinated caller migration and deletion, or staged coexistence for real compatibility or release obligations.
How do I install this agent skill?
npx skills add https://github.com/christofferbergj/agent-skills --skill principle-migrate-callers-then-delete-legacy-apisIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a set of architectural principles for migrating legacy APIs. It contains no executable code, tool definitions, or scripts, making it safe for use.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Migrate callers then delete legacy APIs
This owner chooses migration strategy and verification boundaries for both Matt's ticket flow and Pstack playbooks.
- Inventory all callers and compatibility obligations, including external consumers, independently deployed versions, stored data, and rollout or rollback requirements. Complete when the old contract's consumers and required lifetime are known.
- If callers are internal and the project can absorb a coordinated change, migrate every caller and delete the old API in one verification unit. Existing internal callers alone do not justify a compatibility layer. Several bounded tickets can contribute to that unit on an isolated integration branch. Complete when the plan covers every caller, obsolete-path deletion, and the unit's checks.
- Use expand-contract only when a real compatibility obligation or required independently green release makes coexistence necessary. Add the new form, migrate consumers in checked batches, and remove the old form after the obligation ends. Give every temporary adapter a removal condition and an owning ticket. Complete when the reason for coexistence and its exit gate are explicit.
- Declare the checks for each ticket or migration phase and the final integration unit. Planned, scoped, reversible breakage may exist inside an isolated unit; passing phase checks can unblock the next ticket inside it. Work outside that unit remains blocked until its full static, runtime, and contract checks pass. Preserve an already-approved rollout contract; seek a decision before changing it. Complete when intermediate progress and final acceptance cannot be confused.
- Update tests for the accepted contract. Preserve distinct behavioral regressions while deleting tests that only protect the retired implementation. Complete when the caller inventory is exhausted, required compatibility is honored, obsolete paths are removed at their declared gate, and the final unit's checks pass.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/christofferbergj/agent-skills/principle-migrate-callers-then-delete-legacy-apis">View principle-migrate-callers-then-delete-legacy-apis on skillZs</a>