ARS.FLOW
← Back to skills
Migrations & Rollback SafetyHigh ReliabilityHigh-Risk Workflow

Migration Rollback Safety

Defines preflight and rollback-safe migration execution with deterministic gating and ownership for production-impacting changes.

Version

0.1.0

Last Updated

Apr 22, 2026

Verification Type

integration tests, manual review required, reconciliation checks

Downloads

0

Required inputs

  • migration_plan (markdown)

    Forward migration steps and assumptions.

  • rollback_constraints (markdown)

    Operational limits and rollback expectations.

Expected outputs

  • safe_runbook (markdown)

    Preflight checks, staged execution, and rollback procedure.

  • rollback_matrix (markdown)

    Trigger thresholds with owner assignment.

Included checks and assets

  • scripts/check_migration_plan.py (script)

    Checks that migration plans include preflight and rollback sections.

  • references/rollback-matrix-template.md (reference)

    Template for rollback trigger, owner, and action mapping.

  • references/preflight-check-catalog.md (reference)

    Recommended preflight checks by migration class.

  • references/staging-rehearsal-guide.md (reference)

    Procedure for forward/rollback rehearsal in staging.

Failure modes

  • Undocumented side effects invalidate rollback assumptions.
  • No rollback rehearsal in staging.
  • Operational ownership gaps during rollback execution.

Ideal use cases

  • Production schema migrations
  • High-risk config rollouts
  • Data-platform change management

Example runs

Orders table phased migration

Validated sample run

Two-phase rollout with shadow writes and rollback guardrails.

Input preview

migration plan + rollback constraints

Output preview

Runbook with abort thresholds and owner matrix

Changelog summary

  • 0.1.0 · Apr 22, 2026

    Initial release for rollback-safe migration planning.

Links

Inspect the source, read authored documentation, or download the published skill bundle.

DownloadSourceDocs