Agent skill · software engineering · borghei
migration-architect
Plans zero-downtime migrations with compatibility validation, rollback strategies, and phased execution plans. Use when migrating databases, APIs, infrastructure, or services between platforms or versions.
Why this skill is useful
Adds 3 executable scripts for generating migration plans, compatibility checks, and rollback runbooks that are not commonly found in public documentation.
What it needs
Requires python installed locally. About 3k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
Migration Architect Generates phased migration plans with risk assessment, compatibility analysis, and rollback runbooks for database, service, infrastructure, and API migrations. Validates schema compatibility, detects breaking changes, and produces rollback procedures with trigger conditions and communication templates. Core Capabilities Phased planning — generate risk-assessed, multi-phase migration plans with validation gates, timelines, and stakeholder structures from a JSON spec. Compatibility analysis — diff before/after database or REST/JSON schemas to detect breaking changes, type mismatches, and constraint violations, with migration + rollback scripts. Rollback runbooks — phase-by-phase reversal steps, automated trigger conditions, data-recovery plans, escalation matrices, and communication templates. Pattern catalog — Expand-Contract, Dual-Write, CDC, Strangler Fig, Parallel Run, Canary, Blue-Green. Risk frameworks — technical, business, operational, and compliance risk categories. When to Use Migrating databases, APIs, infrastructure, or services between platforms or versions. Validating schema/API compatibility and detecting breaking changes before cutover. Building rollback runbooks and zero-downtime execution plans. Clarify First Before planning the migration, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] What's migrating — database, API, infrastructure, or service (sets --type and which pattern catalog applies) [ ] Deliverable — phased plan, compatibility diff, or rollback runbook (selects migrationplanner.py vs compatibilitychecker.py vs rollbackgenerator.py) [ ] Downtime budget & pattern — zero-downtime requirement and which pattern (expand-contract, dual-write, strangler fig, blue-green) (drives the phases and cutover technique) Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/migration-architect