Migrate Callers Then Delete Legacy APIs
Trigger
When replacing an internal API.
Rule
Move callers to the new shape and delete the old path in the same migration wave instead of carrying a compatibility layer.
Application
- Name the concrete decision this principle changes.
- Apply the rule to that decision, not as a decorative citation.
- Prefer evidence from the current repository/runtime over generic preference.
- If the principle conflicts with an explicit user constraint, keep the constraint and state the tradeoff.