Anwendungsfall für Codex
Code migrieren
Migriere ältere Stacks in Etappen und prüfe jeden Schritt.
Ordne mit Codex die Bestandteile eines Altsystems dem neuen Stack zu. Setze die Migration in Etappen um und prüfe vor jedem Übergang, ob sich beide Systeme gleich verhalten.
Besonders geeignet für
- Projekte, die auf einen modernen Stack umsteigen und dafür Frameworks, Laufzeitumgebungen, Build-Systeme oder Plattformkonventionen ändern müssen.
- Teams, die Kompatibilitätsschichten brauchen, die Umstellung in Etappen durchführen und das Ergebnis nach jeder Etappe gezielt prüfen müssen.
Inhalt
Code migrieren
Migriere ältere Stacks in Etappen und prüfe jeden Schritt.
Ordne mit Codex die Bestandteile eines Altsystems dem neuen Stack zu. Setze die Migration in Etappen um und prüfe vor jedem Übergang, ob sich beide Systeme gleich verhalten.
Ordne mit Codex die Bestandteile eines Altsystems dem neuen Stack zu. Setze die Migration in Etappen um und prüfe vor jedem Übergang, ob sich beide Systeme gleich verhalten.
Besonders geeignet für
- Projekte, die auf einen modernen Stack umsteigen und dafür Frameworks, Laufzeitumgebungen, Build-Systeme oder Plattformkonventionen ändern müssen.
- Teams, die Kompatibilitätsschichten brauchen, die Umstellung in Etappen durchführen und das Ergebnis nach jeder Etappe gezielt prüfen müssen.
Skills und Plug-ins
- Prüfe vor dem Merge riskante Migrationen, Änderungen an Abhängigkeiten und von außen zugängliche Schnittstellen.
- Behebe CI-Fehler nach jeder Migrationsetappe, damit sich die Nacharbeit nicht bis zum Schluss ansammelt.
- Nutze die Empfehlungen für ASP.NET Core, wenn die Migration Anwendungsmodelle, `Program.cs`, Middleware, Tests, Performance oder Versionsupgrades betrifft.
| Skill | Nutzen |
|---|---|
| Security Best Practices | Prüfe vor dem Merge riskante Migrationen, Änderungen an Abhängigkeiten und von außen zugängliche Schnittstellen. |
| Gh Fix Ci | Behebe CI-Fehler nach jeder Migrationsetappe, damit sich die Nacharbeit nicht bis zum Schluss ansammelt. |
| Aspnet Core | Nutze die Empfehlungen für ASP.NET Core, wenn die Migration Anwendungsmodelle, `Program.cs`, Middleware, Tests, Performance oder Versionsupgrades betrifft. |
Prompt für den Einstieg
Einführung
Wenn du von einem Stack auf einen anderen wechselst, kannst du mit Codex die Migration planen und kontrolliert durchführen. Das gilt für Routing, Datenmodelle, Konfiguration, Authentifizierung, Hintergrundjobs, Build-Werkzeuge, Deployment und Tests, aber auch für die Konventionen der Sprache und des Frameworks selbst.
Codex kann das Altsystem erfassen, bisherigen Konzepten ihre Entsprechungen im neuen Stack zuordnen und die Änderungen in überschaubaren Etappen umsetzen. So kannst du nach jeder Etappe das Ergebnis prüfen. Das ist besonders wichtig, wenn du ein altes Framework ablöst, Code auf eine neue Laufzeitumgebung portierst oder einen Stack schrittweise durch einen anderen ersetzt, während das Produkt weiter funktionieren muss.
So gehst du vor
- Erfasse zunächst, was von der Migration betroffen ist. Dazu gehören Pakete des Altsystems, Framework-Konventionen, Routing, Datenzugriff, Authentifizierung, Konfiguration, Build-Werkzeuge und Tests. Halte auch fest, von welchen Annahmen das Deployment ausgeht und welche externen Schnittstellenverträge weiterhin gelten müssen.
- Bitte Codex, den Konzepten des Altsystems ihre Entsprechungen im Ziel-Stack zuzuordnen und aufzuzeigen, wo eine direkte Entsprechung fehlt.
- Wähle eine Strategie für die schrittweise Umstellung. Du kannst eine Kompatibilitätsschicht einziehen, den Code Modul für Modul portieren, Branch by Abstraction nutzen oder nach dem Strangler-Muster einen Systemteil nach dem anderen an seiner Schnittstelle ablösen.
- Behalte das bisherige Verhalten bei, solange die Migration keine sichtbare Änderung erfordert. Benenne solche Ausnahmen ausdrücklich.
- Führe nach jedem Meilenstein die kleinste Prüfung durch, die belegt, dass das Verhalten mit dem des Altsystems übereinstimmt. Dafür eignen sich je nach Änderung Linting, eine Typprüfung, gezielte Tests, Vertragstests, Smoke-Tests oder ein direkter Vergleich mit dem bisherigen Ausführungspfad.
- Prüfe nach jeder Etappe den Diff und bewerte die verbleibenden Risiken der Umstellung. Warte damit nicht, bis die Neuimplementierung abgeschlossen ist.
ExecPlans nutzen
In unserem Cookbook zur Code-Modernisierung stellen wir ExecPlans vor. Mit diesen Dokumenten behält Codex den Überblick über die Aufräumarbeiten, beschreibt den angestrebten Endzustand und hält nach jedem Durchgang die Prüfergebnisse fest. Wenn du Codex mit einer komplexen Migration beauftragst, bitte Codex, für jeden Systemteil einen ExecPlan zu erstellen. So hält Codex alle Entscheidungen fest, auch die Wahl des Technologie-Stacks, und du kannst sie später überprüfen.
Ein Ziel für die Migration festlegen
Gib Codex für länger dauernde Migrationsetappen ein Ziel vor. Beschreibe den gewünschten Endzustand. Lege fest, wie Codex die Übereinstimmung mit dem bisherigen Verhalten prüfen soll, was du bei einem Rollback erwartest und wann Codex die Arbeit beenden soll.
Verwandte Anwendungsfälle
Browserspiele entwickeln
Beschreibe deine Spielidee kurz. Codex kann daraus einen konkreten Plan entwickeln und ihn...
Deine Codebasis refaktorieren
Entferne mit Codex toten Code, gliedere große Dateien übersichtlicher, führe doppelte Logik...
Dokumentation aktuell halten
Gleiche mit Codex Änderungen am Quellcode mit der öffentlichen Dokumentation, den Release...