migration-architect
von alirezarezvanimigration-architect unterstützt bei der Planung von Zero-Downtime-Migrationen für Datenbanken, Services und Infrastruktur – mit phasenweiser Umsetzung, Kompatibilitätsvalidierung, Datenabgleich und Rollback-Runbooks. Enthält Scripts für Migrationspläne, Kompatibilitätsprüfungen und Rollback-Generierung für Software-Architecture-Teams.
Dieser Skill erreicht 84/100 Punkte und ist damit ein solider Kandidat für Verzeichnisnutzer, die komplexe Migrationen planen. Das Repository bietet genügend klare Trigger, Workflow-Substanz, Scripts, Beispiel-Assets und erwartete Ausgaben, damit ein Agent mehr leisten kann als mit einem generischen Prompt. Anwender sollten jedoch damit rechnen, generierte Pläne anzupassen und organisationsspezifische Details zu ergänzen.
- Klarer Auslösebereich: Das Frontmatter adressiert ausdrücklich Datenbankmigrationen, Infrastruktur-Cutover, Systemablösungen und risikoreiche Übergänge, die Rollback-Pfade benötigen.
- Substanzielle Workflow-Assets: Drei Scripts decken die Erstellung von Migrationsplänen, Kompatibilitätsprüfungen und Rollback-Runbooks ab, ergänzt durch Beispieleingaben und erwartete Ausgaben.
- Gute Entscheidungsgrundlage für die Installation: Referenzdokumente behandeln Migrationsmuster, Zero-Downtime-Techniken und Strategien zum Datenabgleich und vermitteln damit ein konkretes Bild der Methodik des Skills.
- In SKILL.md ist kein Installationsbefehl enthalten. Nutzer müssen die Einrichtung daher ggf. aus der Repository-Struktur und den README-Beispielen ableiten.
- Die generierten Runbook-Beispiele enthalten weiterhin Platzhalter wie TBD-Kontakte und generische Validierungsbefehle. Für den Produktionseinsatz sind daher Anpassung und Review erforderlich.
Überblick über den migration-architect skill
Wofür migration-architect gedacht ist
Der migration-architect skill unterstützt die Planung risikoreicher Migrationen von Software, Datenbanken, Services und Infrastruktur, bei denen Ausfallzeiten, Datenverlust, API-Brüche oder unklare Rollback-Pfade ein Geschäftsrisiko darstellen würden. Der skill ist besonders hilfreich, wenn eine allgemeine Migrations-Checkliste nicht ausreicht: phasenweise Umsetzung, Kompatibilitätsprüfung, Cutover-Planung, Datenabgleich und ein Rollback-Runbook, dem Operations-Teams tatsächlich folgen können.
Geeignete Nutzer und Migrationsszenarien
Nutzen Sie den migration-architect skill, wenn Sie als Software Architect, Staff Engineer, Platform Engineer, SRE, Database Lead oder Technical Program Owner einen produktiven Übergang vorbereiten. Er passt zu Upgrades von PostgreSQL oder anderen Datenbanken, Migrationen vom Monolithen zu Services, Service-Ablösungen nach dem Strangler-Fig-Muster, Cloud-Cutovers, Schema-Evolution, API-Versionierung und Migrationen mit Compliance-Anforderungen wie GDPR, SOX oder PCI DSS.
Was diesen skill unterscheidet
Das Repository bietet praktische Unterstützung über reinen Prompt-Text hinaus: scripts/migration_planner.py, scripts/compatibility_checker.py und scripts/rollback_generator.py sowie Beispiel-Spezifikationen für Datenbank- und Service-Migrationen. Die Referenzdateien behandeln Migrationsmuster, Zero-Downtime-Techniken und Strategien für den Datenabgleich. Dadurch ist der skill für Entscheidungen in der Software Architecture deutlich belastbarer als ein einzelner Prompt nach dem Muster „mach mir einen Plan“.
Worauf Sie bei der Einführung achten sollten
Dieser skill liefert die besten Ergebnisse, wenn Sie echte Rahmenbedingungen bereitstellen können: Ausfallzeitbudget, Abhängigkeiten, Schemaänderungen, Traffic-Profil, Datenvolumen, Compliance-Anforderungen, Validierungsgates und Rollback-Auslöser. Er ersetzt keine umgebungsspezifischen Tests, Lasttests, Datenbank-Engine-Expertise oder formale Change-Freigaben. Behandeln Sie seine Ergebnisse als Beschleuniger für die Architekturplanung, nicht als automatische Produktionsfreigabe.
So verwenden Sie den migration-architect skill
migration-architect installieren und die ersten Dateien lesen
Installieren Sie den skill in einer Claude Skills-kompatiblen Umgebung mit:
npx skills add alirezarezvani/claude-skills --skill migration-architect
Prüfen Sie anschließend den skill unter:
engineering/skills/migration-architect
Lesen Sie zuerst README.md, um die Komponentenübersicht und Quick-Start-Befehle zu verstehen, danach SKILL.md für den vorgesehenen Workflow. Sehen Sie sich assets/sample_database_migration.json und assets/sample_service_migration.json an, bevor Sie eigene Eingaben schreiben, denn diese Beispiele zeigen, welchen Detailgrad die Scripts und Prompts erwarten. Nutzen Sie expected_outputs/, um die Form brauchbarer Ergebnisse zu verstehen, bevor Sie angepasste Artefakte anfordern.
Eingaben, mit denen migration-architect wirksam wird
Ein schwacher Prompt lautet: „Plan our database migration.“ Ein deutlich besserer Prompt gibt dem skill entscheidungsrelevanten Kontext:
- Migrationstyp: database, service, infrastructure oder hybrid
- Quell- und Zielplattformen, Versionen und Hosting-Modell
- Grenze für Ausfallzeit und Toleranz für Datenverlust
- Datenvolumen, Zeilenzahlen, Kritikalität von Tabellen oder Request-Last
- abhängige Services, Clients, Jobs, Queues, Analytics und Backups
- Schema- oder API-Änderungen, einschließlich Risiken durch Breaking Changes
- Compliance-, Audit-, Retention- und Verschlüsselungsanforderungen
- Erfolgsmetriken, Validierungsabfragen, Rollback-Auslöser und verantwortliche Rollen
Beispiel-Prompt:
“Use the migration-architect skill to create a phased zero-downtime migration plan for PostgreSQL 13 on-prem to PostgreSQL 15 managed cloud. Data volume is 2.5 TB. Max downtime is 30 minutes. Critical dependencies are authentication, notification, analytics, and backups. Include compatibility risks, validation gates, reconciliation checks, rollback criteria, and a stakeholder communication timeline.”
Die enthaltenen Scripts nutzen
Das README zeigt die Nutzung per Kommandozeile zum Erzeugen von Plänen und Reports. Ein typischer Workflow sieht so aus:
python3 scripts/migration_planner.py \
--input assets/sample_database_migration.json \
--output migration_plan.json \
--format both
Verwenden Sie scripts/compatibility_checker.py mit Vorher-/Nachher-Schemadateien wie assets/database_schema_before.json und assets/database_schema_after.json, um Kompatibilitätsrisiken sichtbar zu machen. Nutzen Sie scripts/rollback_generator.py, nachdem der Migrationsplan vorliegt, damit die Rollback-Schritte zu den geplanten Phasen passen und nicht nur generische Fehlerbehandlung abbilden.
Praktischer Workflow für bessere Pläne
Kopieren Sie zunächst ein Beispiel-Asset in Ihre eigene Migrationsspezifikation und ersetzen Sie dann jeden Platzhalter durch produktionsnahe Fakten. Bitten Sie den skill um einen ersten Plan und fordern Sie anschließend separat einen Kompatibilitätsbericht, ein Rollback-Runbook und eine Cutover-Checkliste an. Vergleichen Sie das Ergebnis mit expected_outputs/sample_database_migration_plan.txt, schema_compatibility_report.txt und rollback_runbook.txt, um zu prüfen, ob Ihr Output spezifisch genug für ein Review durch Engineering, SRE, Security und Business-Verantwortliche ist.
FAQ zum migration-architect skill
Ist migration-architect nur für Datenbankmigrationen gedacht?
Nein. Das Repository enthält Beispiele für Datenbank- und Service-Migrationen. Der Datenbankpfad ist besonders konkret, weil er Vorher-/Nachher-Schema-Assets und Kompatibilitätsprüfungen enthält. Das Service-Beispiel unterstützt jedoch auch Strangler-Fig-Migrationen, Endpoint-Kompatibilität, Änderungen im Lastprofil, Client-Abhängigkeiten und Session-Kontinuität.
Warum ist das besser als ein gewöhnlicher Migrations-Prompt?
Ein gewöhnlicher Prompt erzeugt oft eine plausibel klingende Checkliste. Der migration-architect skill ist dagegen um Migrationsmuster, Zero-Downtime-Techniken, Kompatibilitätsanalyse, Datenabgleich und Rollback-Erzeugung herum strukturiert. Die enthaltenen Scripts und erwarteten Outputs erleichtern es, Artefakte zu erstellen, die eher wie Engineering-Runbooks wirken als wie strategische Notizen.
Können Einsteiger den migration-architect skill verwenden?
Ja, aber Einsteiger sollten mit den Beispiel-JSON-Dateien beginnen und keine Rahmenbedingungen auslassen. Der skill kann die Struktur einer guten Planung vermitteln, setzt aber voraus, dass Sie Systeme, Abhängigkeiten, Datenspeicher, operative Grenzen und Validierungsanforderungen identifizieren können. Wenn diese Fakten noch unbekannt sind, nutzen Sie den ersten Durchlauf, um Discovery-Fragen zu generieren, bevor Sie einen finalen Plan anfordern.
Wann sollte ich diesen skill nicht verwenden?
Verlassen Sie sich nicht allein auf migration-architect bei akuter Live-Wiederherstellung, herstellerspezifischem Datenbank-Tuning, rechtlicher Compliance-Freigabe oder Änderungen, die tiefen Zugriff auf proprietäre Infrastruktur erfordern. Der skill ist außerdem wenig geeignet für triviale Migrationen ohne produktive Nutzer, ohne Kompatibilitätsrisiko und ohne Rollback-Anforderung.
So verbessern Sie den migration-architect skill
Bessere migration-architect Ergebnisse durch präzisere Rahmenbedingungen
Der häufigste Fehlerfall ist ein Plan, der vollständig klingt, aber nicht ausführbar ist. Vermeiden Sie das durch harte Zahlen: maximale Ausfallzeit, RPO/RTO, Datenmenge, Peak Traffic, Batch-Fenster, tolerierbarer Replikations-Lag, Zeitlimit für Rollback und wer welches Gate freigeben darf. Ersetzen Sie vage Formulierungen wie „minimal downtime“ durch messbare Schwellenwerte, etwa „no more than 5 minutes of write unavailability.“
Validierung und Datenabgleich konkretisieren
Für Datenbankarbeiten sollten Sie Primary Keys, Zeilenzahlen, kritische Tabellen, Schemaänderungen, Indexes, Constraints und repräsentative Validierungsabfragen angeben. Für Service-Arbeiten gehören Endpoint-Listen, erwartete Statuscodes, Kompatibilitätszusagen, Strategie zur Traffic-Aufteilung, Latenzziele und Client-Versionen dazu. Der skill arbeitet besser, wenn er diese Fakten in Gates, Smoke Tests und Reconciliation Checks übersetzen kann.
Vom Plan zum Runbook iterieren
Hören Sie nicht beim ersten Migrationsplan auf. Fordern Sie eine Risikoprüfung an, danach ein Rollback-Runbook und anschließend eine Operator-Checkliste. Ein hilfreicher Follow-up-Prompt ist: “Review this plan for hidden coupling, missing validation gates, rollback ambiguity, and data reconciliation gaps. Return only changes that would reduce production risk.” So wird migration-architect vom Planungswerkzeug zu einem Review-Assistenten.
Das Repository für Ihre Umgebung erweitern
Um den migration-architect skill für wiederholte interne Nutzung zu verbessern, ergänzen Sie organisationsspezifische Templates: Freigabe-Gates, Incident-Kontakte, Cloud-Provider-Befehle, Datenbank-Backup-Verfahren, Observability-Dashboards, Feature-Flag-Standards und Monitoring-Checks nach dem Cutover. Halten Sie diese Informationen als wiederverwendbare Referenzdateien vor, statt sie in einem einzelnen Prompt zu verstecken, damit künftige Migrationspläne dieselben operativen Standards übernehmen.