
Database Migration Helper
Generate safe, reversible database migrations with zero-downtime strategies
What You Can Do
Transform schema and data changes into production-ready migration packages that protect data integrity and minimize downtime. You can handle column additions, renames, type conversions, and backfills using proven patterns like expand-contract and shadow tables. The skill generates explicit rollback scripts, validation checklists, and phased execution plans that keep applications stable throughout the migration.
Features
Examines current database structure and application code to identify migration risks and compatibility issues
Selects appropriate patterns (expand-contract, shadow tables, feature flags) for your specific change type
Generates SQL with explicit rollback procedures, allowing safe testing and rapid recovery if issues arise
Creates validation queries and checksums to verify data correctness before, during, and after migration
Breaks large migrations into testable stages with rollback triggers and success criteria
Ensures application code continues working during staged schema rollout
Provides step-by-step procedures and triggers for rolling back if migration fails
Identifies downtime windows, locking scenarios, and performance implications per database platform
Example Output
For adding a non-nullable column with computed data:
Migration Phase 1: Expand
- ALTER TABLE users ADD COLUMN account_tier VARCHAR(50) DEFAULT 'standard'
- Rollback: ALTER TABLE users DROP COLUMN account_tier
Migration Phase 2: Backfill
- UPDATE users SET account_tier = CASE WHEN subscription_id IS NOT NULL THEN 'premium' ELSE 'standard' END WHERE account_tier = 'standard'
- Validation: SELECT COUNT(*) FROM users WHERE account_tier IS NULL (should be 0)
- Rollback: UPDATE users SET account_tier = 'standard'
Migration Phase 3: Contract
- ALTER TABLE users ALTER COLUMN account_tier DROP DEFAULT, SET NOT NULL
- Rollback: ALTER TABLE users ALTER COLUMN account_tier SET DEFAULT 'standard'
For renaming a column safely:
Phase 1: Shadow Column
- CREATE TRIGGER sync_old_to_new AFTER INSERT/UPDATE on users
FOR EACH ROW SET NEW.email_address = NEW.contact_email
Phase 2: Dual Write (app code changes)
- Application writes to both contact_email and email_address
- Validation queries verify 100% matching data
Phase 3: Retire Old Column
- DROP TRIGGER sync_old_to_new
- ALTER TABLE users DROP COLUMN contact_email
What's Included
- SKILL.md: Complete migration planning framework with risk analysis checklist
- Migration Pattern Templates: Expand-contract, shadow tables, and feature flag patterns with SQL examples
- Rollback Procedure Checklist: Step-by-step validation and recovery guides
- Pre-Flight Analysis Worksheet: Questions to assess schema, application impact, and downtime tolerance
- Phased Execution Timeline: Template for breaking migrations into stages with success criteria and rollback triggers
Who It's For
- Database Administrators managing production schema changes and operational safety
- Backend Engineers responsible for coordinating code deployments with schema migrations
- Site Reliability Engineers planning zero-downtime operations and disaster recovery
- Technical Architects designing migration strategies for large-scale systems
- DevOps Engineers automating safe database change workflows
Best For
- Large table column additions, renames, or type changes on production systems
- Data backfill and normalization with validation and rollback safeguards
- Multi-phase migrations requiring application code coordination
- Generating rollback procedures and testing migration reversibility
- Assessing downtime impact and selecting appropriate zero-downtime patterns






