# Migration

> Implement reversible compatibility-safe transitions.

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

- Page: https://ss33.ai/skills/juliusbrussee/migration-71441384295
- Publisher: juliusbrussee
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [APIs & backend](https://ss33.ai/skills/category/software-development-t44z8z/apis-and-backend-t0x840)
- License: Apache-2.0
- Source: https://github.com/juliusbrussee/caveman/blob/bad48a0e1df55e05e3f52249afa35ecc1909ee76/skills/migration/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/juliusbrussee/migration-71441384295

# 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.