17 lines
784 B
Markdown
17 lines
784 B
Markdown
---
|
|
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.
|