Migration Architect

Zero-downtime migration planning, compatibility validation, and rollback strategy generation.

Development / Engineeringdevelopmentengineering
by AgentVoltv1.0.0Published 1y ago2 installs
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

PromptPlan a database migration with zero downtime for our production system.
Beforegeneric AI agent
Database migrations are risky because they can break your application if something goes wrong. You need to think about your rollback strategy first in case you need to abort. Testing the migration on a copy of your production database is important to catch issues before you do it for real. You'd want to have a communication plan so your team knows what's happening. Compatibility checks are important—make sure your application code is compatible with the new schema before you migrate. Timing matters too; you want to do it during low-traffic hours. Having a runbook that documents every step helps.
Afterwith Migration Architect
I'll architect a zero-downtime database migration with compatibility checks, staged rollout, and explicit rollback paths.

MIGRATION STRATEGY
PHASE 0: DUAL-WRITE SETUP (24 hours before cutover)
Deploy code that writes to BOTH old and new database simultaneously. Reads still come from old DB.
Verify data consistency: new DB receives same writes as old DB.

PHASE 1: MIGRATION RUN (low-traffic window, approximately 2 hours)
Backfill data: copy all old DB data to new DB (validate row counts, checksums match)
Run data integrity checks: spot-check 1000 random rows across tables for correctness

PHASE 2: READ SWITCHOVER (5-minute window)
Update app to READ from new DB (still writing to both)
Monitor query latency, error rates for 30 minutes
If anything breaks: ROLLBACK (switch reads back to old DB in 30 seconds; dual-write is still active)

PHASE 3: CLEANUP (hours 4-24 after cutover)
Verify old DB has received no writes for 6 hours
Decommission old database (after keeping backup for 7 days)

ROLLBACK PLAN
T+0 to T+6 hours: full rollback available (dual-write still active, revert to old DB, ~30 sec downtime)
T+6 to T+48 hours: rollback needs careful data reconciliation (dual-write off)
T+48 hours: rollback risky (data diverged, manual work needed)

RUNBOOK CHECKLIST
Backup old DB before any migration
Test migration on staging clone
Identify which queries change performance (index new DB appropriately first)
Notify ops team of maintenance window
Monitor CPU, disk, connection pools during migration
Plan communication: status page, Slack updates

DELIVERABLE
Step-by-step migration plan with checkpoints, rollback triggers, monitoring dashboard config, and runbook.

About this skill


name: migration-architect description: Use when Zero-downtime migration planning, compatibility validation, and rollback strategy generation.

Migration Architect

Zero-downtime migration planning, compatibility validation, and rollback strategy generation. Tools for system, database, and infrastructure migrations with minimal business impact. Use when planning a database migration, infrastructure cutover, system replacement, or any high-risk transition that needs explicit rollback paths.

What you get

  • Public GitHub repo (alirezarezvani/claude-skills)
  • the migration-architect skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.

Customize your output

  • Fork the repo and adapt the skill's instructions and references to your workflow.

Example output

Activates automatically when your request matches Migration Architect; chains with the other skills, agents, and commands in the collection.

Best for

Creators, builders, and teams using Claude Code.

SKILL.md preview

SKILL.md
---
name: migration-architect
description: Use when planning a database migration, infrastructure cutover, system replacement, or any high-risk transition that needs an explicit rollback path.
version: 1.0.0
category: Development / Engineering
author: AgentVolt
license: proprietary
tags:
  - development
  - engineering
---

# Migration Architect

Plans zero-downtime migrations with compatibility validation and explicit rollback strategy generation for database, system, and infrastructure transitions.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill

Featured in

More development skills

View all Development skills →