migration-plan

Plan phased database and code migrations with rollback steps in MIGRATION-PLAN.md.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill migration-plan-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-plan
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/migration-plan
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill migration-plan-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Database and schema changes are high-risk operations that can cause downtime, data loss, or application errors if dependencies, data transformations, and rollback paths are not carefully planned. This Skill structures discovery, impact analysis, dependency mapping, phased execution, and rollback strategies so teams can perform migrations safely across environments.

Core Features & Use Cases

  • Discovery & Inventory: Identify database type, ORM/migration tooling, existing migrations, and the precise schema elements affected.
  • Impact & Dependency Analysis: Surface affected tables, constraints, views, stored procedures, downstream services, and code paths that must be updated.
  • Phased Expand-Migrate-Contract Plan: Produce ordered phases with pre-conditions, ordered steps, verification checks, duration estimates, and explicit rollback steps.
  • Rollback & Safety: Define rollback triggers, exact undo steps, data recovery guidance, and points of no return for each phase.
  • Output Delivery: Emit a comprehensive MIGRATION-PLAN.md with a pre-flight checklist useful for staging and production rollouts.
  • Use Case Example: Preparing a zero-downtime migration to add a non-nullable column, including dual-writing, backfill in batches, and final schema cleanup.

Quick Start

Ask the skill to produce a phased migration plan for migrating the users table to a new schema including backfill, verification checks, and rollback procedures.

Frequently Asked Questions about migration-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a database schema migration with a rollback strategy?

To plan a database schema migration with rollback, you map affected tables, constraints, and code dependencies to create a phased expand-migrate-contract plan with explicit verification checks and undo steps. This ensures safe deployments across multiple environments while defining exact rollback triggers.

What is the expand-migrate-contract pattern for zero-downtime database migrations?

The expand-migrate-contract pattern for zero-downtime database migrations breaks schema changes into sequential phases: expanding the schema, migrating and backfilling data in batches, and contracting the old schema. It pairs dual-writing with verification checks to prevent application errors.

How do I safely backfill data in batches during a database migration?

To safely backfill data in batches during a database migration, you generate a phased plan that estimates durations, identifies affected constraints, and defines pre-conditions. The migration plan includes verification steps and rollback procedures to recover data if batch processing fails.

Can I use this for ORM-backed relational database migrations?

Yes, you can use this for ORM-backed relational database migrations. The process inventories existing migration tooling, maps downstream service dependencies, and produces a comprehensive migration plan document with pre-flight checklists suitable for staging and production rollouts.

When do I need a phased migration plan for indexed rebuilds?

You need a phased migration plan for indexed rebuilds when schema changes risk downtime or data loss. The plan surfaces affected tables and constraints, estimates durations, and defines points of no return to ensure safe multi-environment deployments.