Refactoring mit Codex: Plan, Ziel und ein Review für jeden Schritt

Was Codex für Refactoring erledigt

• Arbeitet einen Refactoring-Backlog in kleinen Schritten ab, jeder als eigener Pull Request.
• Führt die Tests vor und nach jedem Schritt aus und hört auf, wenn sie fehlschlagen.
• Erledigt den mechanischen Teil von Migrationen: Umbenennungen in der ganzen Codebasis, API-Upgrades, den Umstieg auf eine neue Library.
• Entfernt toten Code und doppelte Logik und begründet jede Entfernung.

Funktionen von Codex für Refactoring

So richtest du Codex für Refactoring ein

1. Verbinde die Tools

   Es gibt nichts zu verbinden. Sicher wird ein Refactoring durch einen Testbefehl, den Codex ausführen kann, und eine Obergrenze für die Größe jedes Schritts; schreib beides in die AGENTS.md.

   # In der CLI: den Plan abstimmen, dann das Ziel setzen
   /plan Propose a migration plan for the billing module
   /goal Finish the migration and keep tests green

2. Schreib die Regeln in die AGENTS.md

   Codex liest die AGENTS.md vor jeder Arbeit: zuerst ~/.codex/AGENTS.md, dann die Dateien vom Root des Repositorys bis zu dem Ordner, in dem es arbeitet. Schreib die Regeln der Aufgabe dort hinein oder, wenn sie lang sind, in einen Skill unter .agents/skills/. Siehe den AGENTS.md-Leitfaden.

   ## Refactoring-Regeln
   - Keine Verhaltensänderungen. Muss ein Test geändert werden, hör auf
     und frag.
   - Führ `npm test` aus, bevor du anfängst, und nach jedem Schritt.
   - Ein Schritt pro Pull Request, unter 400 geänderten Zeilen.
   - Halte REFACTOR.md aktuell: Hak ab, was erledigt ist, und ergänze,
     was du gefunden hast.
   - Fass migrations/, generierte Dateien oder öffentliche APIs nicht an,
     ohne zu fragen.

3. Führ es ohne die interaktive Oberfläche aus

   codex exec führt eine Aufgabe aus und beendet sich. Der Fortschritt geht nach stderr, die letzte Nachricht nach stdout; -o schreibt sie zusätzlich in eine Datei, und --json streamt Events. Die Sandbox ist schreibgeschützt, außer du gibst --sandbox workspace-write an.

   # Tag eins, dann am nächsten Tag dieselbe Session wieder
   codex exec --sandbox workspace-write "Erledige den ersten Schritt in REFACTOR.md"
   codex exec resume --last "Mach mit dem nächsten offenen Schritt in REFACTOR.md weiter"

4. Bring es in einen Zeitplan

   Leg eine geplante Aufgabe in der ChatGPT-Desktop-App oder im Web an (die CLI verwaltet keine) oder starte codex exec per cron. Siehe Codex proaktiv machen.

Quelle: Dokumentation von Codex (Englisch)

Grenzen und Sicherheit

• Ohne Tests kann es ein Refactoring nicht von einer Verhaltensänderung unterscheiden. Schreib zuerst Tests für den Bereich.
• Ein großer Umbau in einem Durchgang ist schwer zu reviewen. Kleine Schritte, die jeweils gemergt werden, sind sicherer und am Ende schneller.
• Es weiß nicht, welcher seltsame Code Absicht ist. Markiere diese Stellen mit einem Kommentar oder in den Regeln.
• Codex führt Befehle standardmäßig in einer Sandbox aus: Schreibzugriffe bleiben im Workspace, das Netzwerk ist aus. Nutze danger-full-access nur auf einem isolierten Runner oder in einem Container.

Claude Code oder Codex für Refactoring?

Die Regeln lassen sich mitnehmen. Schreib sie einmal in die AGENTS.md und setz @AGENTS.md in die CLAUDE.md, dann lesen beide Agenten dieselbe Datei.

Schritt für Schritt für den anderen Agenten: Refactoring mit Claude Code.

Mach Refactoring zur festen Aufgabe

Befehle laufen, wenn jemand daran denkt, sie auszuführen. Crewmark macht aus deinem eigenen Codex einen KI-Mitarbeiter mit Rolle, einem Ziel in Zahlen, Arbeitszeiten und einem Heartbeat, damit die Arbeit nach Zeitplan passiert und auf einem Board sichtbar wird.

1. Fang mit der Rolle an

   Der KI-Softwareentwickler, mit diesen Regeln in seiner Rollenbeschreibung.

2. Bring die Arbeit auf sein Board

   Leg die Aufgabe als wiederkehrendes Issue an. Der Mitarbeiter wacht per Heartbeat auf, erledigt sie und berichtet in einem Kommentar.

3. Mehr dazu

   Code-Review prüft jeden Schritt vor dem Merge.

FAQ