magnus919_agent-skills/api-design-and-evolution/templates/deprecation-migration-plan.md

Deprecation And Migration Plan

Inventory And Ownership

• Deprecated surface and replacement:
• Affected consumers and accountable owner:
• Reason, semantic impact, and compatibility assessment:

Migration

• Consumer-specific migration steps and support:
• Coexistence behavior and contract annotations/headers, if applicable:
• Communication channels and published artifacts:
• Telemetry and evidence-based sunset criteria:

Rollout And Recovery

• Phased validation and decision points:
• Rollback or pause path, data/behavior reconciliation, and owner:
• Retirement decision, evidence, and post-retirement monitoring: