March 8, 2026

v0.3 Migration Playbook: Reduce Upgrade Risk in Three Passes

The safest migrations are staged migrations. We use three passes to keep teams shipping while upgrading.

Pass 1: run conformance checks in read-only mode and baseline current drift. Pass 2: enable strict validation for non-critical endpoints first. Pass 3: move critical paths with explicit rollback toggles and release notes tied to endpoint ownership.

This sequence keeps test confidence high while preventing broad rollback events caused by one incompatible contract edge case.