Skip to main content
kitlocal.dev

Ship a risky migration safely

A workflow for planning, rehearsing and rolling out a schema or dependency migration with a check and a rollback at each step.

Before you start

  • A staging environment that resembles production.
  • A way to restore data (backup or snapshot) that you have tested.

Steps

  1. Plan the steps

    Describe the change and generate ordered steps with a check and rollback for each, then review them with the team.

    Check before moving on

    • Every step has a rollback and a verification.
  2. Rehearse on staging

    Run the full sequence on staging, including the rollback of at least one step.

    Check before moving on

    • Rollback was actually executed, not just written down.
  3. Roll out and record

    Roll out step by step, pausing at the agreed safe points, and write the result down.

    Check before moving on

    • The team knows who can stop the rollout and how.

Expected outcome

A completed migration with a recorded plan, results and a rollback that was tested.

Related resources

  • Turns a description of a risky change (schema, dependency or API) into ordered steps with a check and a rollback for each.

    CuratedKitLocalUpdated 2 days ago

    migrationplanningrollback
About this catalog

Bundled snapshot · published Nov 15, 2026, 6:05 AM · Catalog revision 5bc079fe355af2214bc0

Showing the snapshot bundled with this app (no content source is configured). Newer content may exist at the source.