migration-planner

Assess database schema migration risks and produce a pre-implementation dossier.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/Sfzmango/Maungs-agentic-toolbelt --skill migration-planner-sfzmango
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-planner
Source: https://github.com/Sfzmango/Maungs-agentic-toolbelt/tree/main/plugins/maungs-agentic-toolbelt/skills/migration-planner
Command: npx skills add https://github.com/Sfzmango/Maungs-agentic-toolbelt --skill migration-planner-sfzmango

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unvetted database schema migrations are a leading cause of unplanned production outages, irreversible data loss, and extended downtime for engineering teams, often discovered only after changes are already applied to live systems.

Core Features & Use Cases

  • Auto-detection of project context: Automatically identifies the project's migration system, ORM, database engine and version, and existing migration conventions to ground analysis in actual project rules rather than generic assumptions.
  • Comprehensive risk dossier: Produces a structured assessment covering data-loss risks, lock and downtime impact by database engine, safe backfill strategies, zero-downtime expand/contract rollout plans, honest rollback paths, and blast radius of affected application code.
  • Use case example: For a proposed change to add a NOT NULL tenant_id column to a large orders table, the skill will flag full-table rewrite lock risks, provide a batched backfill plan, outline the zero-downtime deployment steps, and list all code that reads or writes the orders table that needs to be updated in lockstep with the migration.

Quick Start

Use the migration-planner skill to analyze your proposed database schema change or existing unapplied migration file and receive a full risk dossier before any implementation work begins.

Frequently Asked Questions about migration-planner

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

FAQPage Schema
How do I check database migration risks before deploying schema changes to production?

To check database migration risks, you need a pre-flight analysis that identifies data-loss exposure, lock impact, and rollback paths before executing schema changes. This assessment evaluates downtime risks and affected code blast radius for proposed migrations.

What is a zero-downtime database migration and when do I need it?

A zero-downtime database migration uses expand and contract rollout patterns to apply schema changes without locking tables or interrupting service. You need it when modifying large tables where standard migrations would cause unacceptable production outages.

How do I plan a rollback for a failed database schema migration?

Planning a rollback for a failed database schema migration requires mapping honest reversal paths before execution, accounting for irreversible data loss. A pre-migration risk dossier outlines these rollback steps to ensure safe recovery from failed schema changes.

Does this migration risk analysis support Prisma, Alembic, and Django ORM projects?

Yes, the migration risk analysis supports common migration systems and ORMs including Prisma, Alembic, Django, ActiveRecord, Flyway, and Knex. It auto-detects project context to ground the assessment in the specific database engine and existing migration conventions.

How do I add a NOT NULL column to a large table without locking the database?

To add a NOT NULL column to a large table without locking the database, use a batched backfill strategy combined with a zero-downtime expand and contract rollout. Pre-migration analysis identifies full-table rewrite lock risks and provides safe backfill steps to prevent downtime.

What are the limitations of analyzing schema migrations before execution?

The limitation of analyzing schema migrations before execution is that it provides a read-only, human-gated risk assessment rather than automatically applying fixes. It identifies downtime risks and code blast radius but requires manual implementation of the suggested rollout paths.