Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design
Codex

Anwendungsfall für Codex

Code migrieren

Migriere ältere Stacks in Etappen und prüfe jeden Schritt.

Schwierigkeitsgrad Advanced
Zeithorizont 1h

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

    ← Alle Anwendungsfälle

    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.

    Advanced
    1h

    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.

    Advanced
    1h

    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

    Migrate this codebase from [legacy stack or system] to [target stack or system]. Requirements: - Start by inventorying the legacy assumptions: routing, data models, auth, configuration, build tooling, tests, deployment, and external contracts. - Map the old stack to the new one and call out anything that has no direct equivalent. - Propose an incremental migration plan with compatibility layers or checkpoints instead of one big rewrite. - Keep behavior unchanged unless the migration explicitly requires a user-visible change. - Work in milestones and run lint, type-check, and focused tests after each milestone. - Keep rollback or fallback options visible until the transition is complete. - If validation fails, fix it before continuing. - Start by mapping the migration surface and proposing the checkpoint plan.
    AstraMedium
    Migrate this codebase from [legacy stack or system] to [target stack or system]. Requirements: - Start by inventorying the legacy assumptions: routing, data models, auth, configuration, build tooling, tests, deployment, and external contracts. - Map the old stack to the new one and call out anything that has no direct equivalent. - Propose an incremental migration plan with compatibility layers or checkpoints instead of one big rewrite. - Keep behavior unchanged unless the migration explicitly requires a user-visible change. - Work in milestones and run lint, type-check, and focused tests after each milestone. - Keep rollback or fallback options visible until the transition is complete. - If validation fails, fix it before continuing. - Start by mapping the migration surface and proposing the checkpoint plan.
    AstraMedium

    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

    1. 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.
    2. Bitte Codex, den Konzepten des Altsystems ihre Entsprechungen im Ziel-Stack zuzuordnen und aufzuzeigen, wo eine direkte Entsprechung fehlt.
    3. 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.
    4. Behalte das bisherige Verhalten bei, solange die Migration keine sichtbare Änderung erfordert. Benenne solche Ausnahmen ausdrücklich.
    5. 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.
    6. 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