OpenAI Codex Workflow: Von der Aufgabe bis zum Merge

Was Codex im Workflow übernimmt - und was nicht

Codex übernimmt die Ausführung einer klar umrissenen Aufgabe: Code schreiben, vorhandene Tests laufen lassen, einen Diff oder Pull Request vorschlagen. Was Codex nicht übernimmt: entscheiden, welche Aufgabe als Nächstes dran ist, sich Kontext aus vorherigen Sessions von selbst merken, oder die Merge-Entscheidung treffen. Der Workflow drumherum füllt genau diese Lücke.

Schritt 1: Die Aufgabe vorbereiten

Je präziser die Aufgabe, desto brauchbarer das Ergebnis. Ziel, Kontext, erlaubter Dateibereich, Schutzbereiche und Akzeptanzkriterien gehören in jeden Auftrag - unabhängig vom Werkzeug. Eine fertige, werkzeugneutrale Struktur dafür liefert die AI-Agenten-Briefing Vorlage.

Schritt 2: Ausführen lassen und beobachten

„Beobachten" heißt nicht, jeden Zwischenschritt zu unterbrechen - es heißt, grob zu verfolgen, in welche Richtung die Umsetzung geht, besonders bei Aufgaben in sensiblen Bereichen. Je risikoreicher der Bereich, desto enger die Beobachtung; bei einer kleinen, gut abgegrenzten Aufgabe reicht ein Blick auf das Endergebnis.

Schritt 3: Diff und Report prüfen

Codex liefert typischerweise einen Diff oder Pull-Request-Vorschlag mit einer Zusammenfassung. Diese Zusammenfassung ist ein Ausgangspunkt, kein Beleg - der Diff selbst und die Liste der geänderten Dateien entscheiden. Eine vollständige Prüfroutine dafür steht in der Merge-Checkliste für AI-generierten Code.

Schritt 4: QA vor dem Merge

Tests und Build sollten selbst ausgeführt und tatsächlich grün gesehen werden, nicht nur laut Zusammenfassung „bestanden". Ein kurzer manueller Smoke-Test ergänzt das bei sichtbaren Änderungen. Die ausführliche Version dieser Routine steht in der KI-Agenten QA-Checkliste.

Schritt 5: Die Merge-Entscheidung treffen

Am Ende steht eine bewusste Einordnung: merge-ready, Review nötig, oder do-not-merge. Diese Entscheidung bleibt beim Menschen - Codex kann einen Vorschlag liefern, aber die Freigabe für Push, Merge und Deploy ist keine Werkzeugentscheidung.

Codex neben anderen Agenten einsetzen

Codex lässt sich neben Claude Code oder ChatGPT einsetzen, etwa für unterschiedliche Aufgabentypen oder parallele Bereiche desselben Projekts. Wie sich das ohne Repo-Chaos organisieren lässt, zeigt Mehrere AI-Agenten parallel nutzen; wie sich die drei Werkzeuge als Team koordinieren lassen, beschreibt ChatGPT, Claude und Codex als Team koordinieren. Wer noch entscheiden muss, wofür welches Werkzeug passt, findet die Gegenüberstellung in Claude Code vs. Codex.

Checkliste: Codex-Auftrag von Start bis Merge

CODEX-WORKFLOW - Start bis Merge

[ ] Ziel, Kontext und Dateibereich im Auftrag benannt
[ ] Schutzbereiche explizit ausgeschlossen
[ ] Akzeptanzkriterien festgelegt
[ ] Ausführung grob beobachtet (bei sensiblen Bereichen enger)
[ ] Diff und Dateiliste gegen den Auftrag geprüft
[ ] Tests/Build selbst ausgeführt, Ausgabe gesehen
[ ] Kurzer Smoke-Test bei sichtbaren Änderungen
[ ] Abschlussbericht mit tatsächlichem Ergebnis abgeglichen
[ ] Einordnung: merge-ready / Review nötig / do-not-merge
[ ] Entscheidung bewusst getroffen und kurz dokumentiert

Typische Fehler im Codex-Workflow

• Die Aufgabe zu groß schneiden, sodass ein einzelner Auftrag mehrere Entscheidungen bündelt.
• Keine Schutzbereiche benennen und auf „gesunden Menschenverstand" hoffen.
• Den vorgeschlagenen Pull Request ungelesen mergen.
• Tests laut Zusammenfassung als „bestanden" akzeptieren, ohne sie selbst laufen zu lassen.
• Keinen Rollback-Plan haben, falls die Änderung doch nicht passt.

Was dieser Workflow nicht verspricht

Dieser Ablauf macht die Arbeit mit Codex nachvollziehbarer - er ist kein Urteil darüber, ob Codex „besser" als ein anderes Werkzeug ist, das hängt von der Aufgabe und dem Team ab. Er ersetzt keine Entwicklung, kein Design und keine fachliche Beratung, und er sagt nichts über Verfügbarkeit, Kosten oder Funktionsumfang von Codex selbst aus - diese Details ändern sich unabhängig von dieser Seite.