schema-migration

name	schema-migration
description	Review event and data contract changes for consumer-safe migration paths.

Schema Migration

Review standard

For event schemas and data contracts, verify that field removals and renames include a migration path for existing consumers.

Flag changes that:

• rename event fields without preserving the old shape during migration
• remove fields that workers, subscribers, or validators still read
• update producer schemas without updating consumer validation
• change feature flag or configuration names without checking downstream references

Findings should point to the consumer path and explain how the migration can be staged safely.