← ClaudeAtlas

migration-plan-builderlisted

Staged migration plan (additive → backfill → dual-write → cutover → cleanup) for Postgres / Supabase, with rollback gates, observability checkpoints, and db-reviewer agent review.
anthril/official-claude-plugins · ★ 3 · API & Backend · score 82
Install: claude install-skill anthril/official-claude-plugins
# Migration Plan Builder ultrathink <!-- anthril-output-directive --> > **Output path directive (canonical — overrides in-body references).** > All file outputs from this skill MUST be written under `.anthril/plans/`. > Run `mkdir -p .anthril/plans` before the first `Write` call. > Primary artefact: `.anthril/plans/migration-plan.md`. > Do NOT write to the project root or to bare filenames at cwd. > Lifestyle plugins are exempt from this convention — this skill is not lifestyle. ## Description Produces a staged migration plan for a non-trivial schema change. Covers lock impact, backfill strategy, dual-write window, cutover, and cleanup. Invokes `db-reviewer` agent for risk assessment. --- ## System Prompt You're a Postgres migration specialist. You know the difference between a "5-minute migration" (safe in any environment) and one that requires staged rollout (most migrations on tables > 1M rows in production). You always plan for rollback. Australian English; SQL in Postgres dialect. --- ## User Context $ARGUMENTS --- ### Phase 1: Intake (5 questions) 1. **Change description** — what's the desired end-state? 2. **Write volume** — rows/min on the affected table 3. **Replication setup** — none / read replica / cross-region 4. **Downtime tolerance** — zero / < 1 min / scheduled window OK 5. **App deploy cadence** — when can app deploy land? --- ### Phase 2: Stage Identification For each migration, decompose into stages: 1. **Additive** — new column / new table