magnus919_agent-skills/api-design-and-evolution/templates/compatibility-change-assessment.md

Compatibility Change Assessment

Change

• Proposed before/after contract and semantic behavior:
• Motivation and authoritative decision owner:
• Affected formats, versions, topics, SDKs, and deployments:

Consumer Assessment

Consumer/tool	Parsing and behavior assumptions	Impact evidence	Classification for this consumer	Mitigation or migration

Assess strict decoding, enums/unions, null/absence/defaults, ordering/pagination, signatures/caching, quotas, error handling, and operations automation where relevant.

Decision And Rollout

• Compatibility conclusion and remaining uncertainty:
• Coexistence/versioning approach and rationale:
• Contract/provider/consumer/deployed verification:
• Telemetry, communication, rollback trigger and owner: