name	migration
description	Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

Migration

Map current readers, writers, data shape, compatibility window, and ownership before editing.

Define forward path and rollback path.
Preserve existing data; make destructive steps explicit and separately authorized.
Keep mixed-version operation safe where rollout can overlap.
Sequence expand, migrate, verify, then contract when applicable.
Make retries idempotent and partial failure observable.
Verify old and new paths at required transition stages.

Stop after requested stage passes; do not perform later destructive contraction implicitly.

name	migration
description	Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

Map current readers, writers, data shape, compatibility window, and ownership before editing.

Define forward path and rollback path.
Preserve existing data; make destructive steps explicit and separately authorized.
Keep mixed-version operation safe where rollout can overlap.
Sequence expand, migrate, verify, then contract when applicable.
Make retries idempotent and partial failure observable.
Verify old and new paths at required transition stages.

Stop after requested stage passes; do not perform later destructive contraction implicitly.

migration