standards-migration

Create reversible database migrations with explicit down migrations and zero-downtime deployment.

1.8k|153|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/maxritter/claude-pilot --skill standards-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: standards-migration
Source: https://github.com/maxritter/claude-pilot/tree/main/pilot/skills/standards-migration
Command: npx skills add https://github.com/maxritter/claude-pilot --skill standards-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to creating and evolving database schemas with safe rollback, clear naming, and zero-downtime deployment strategies. It helps teams avoid risky schema changes and ensures backwards compatibility.

Core Features & Use Cases

  • Granular migrations: Each change is isolated to a single logical operation (add table, add column, index, etc.).
  • Reversibility and rollback: Every migration includes a down method and a tested rollback path.
  • Zero-downtime planning: Strategies for deploying schema changes without blocking writes and safely backfilling data.

Quick Start

Create a new migration file using the project's standard template and run migration tools to verify up/down.

Frequently Asked Questions about standards-migration

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

FAQPage Schema
How do I create reversible database migrations with zero downtime?

Reversible database migrations require isolating each schema change to a single logical operation, providing an explicit down method, and using safe batching for large datasets to ensure zero downtime and safe rollback.

What is the best way to plan backwards-compatible schema changes?

Planning backwards-compatible schema changes involves separating schema migrations from data migrations, modifying schemas in granular steps, and deploying strategies that avoid blocking writes during data backfilling.

How does separating schema and data migrations improve deployment safety?

Separating schema and data migrations improves safety by decoupling structural database changes from data backfilling operations, allowing each phase to deploy independently with zero downtime and tested rollback paths.

Can I use safe batching for large datasets during data migration?

Safe batching is enforced for large datasets during data migration to process records in manageable chunks, preventing locking issues and ensuring the database migration maintains zero-downtime deployment standards.

Why do my database migrations fail to roll back safely?

Database migrations fail to roll back safely when they lack per-change granularity, missing explicit down methods, or untested rollback paths, which this approach prevents by enforcing isolated schema changes and backwards compatibility.