Zum Inhalt springen
Reality Graph

Methode

Der Zwei-Phasen-Review-Workflow

Zuletzt aktualisiert: 2026-08-06Lesezeit ca. 4 Min.

Der Zwei-Phasen-Review-Workflow teilt das Review in eine Maschinen- und eine Menschen-Phase: automatisierte Verifikation pro Änderung zuerst - Typen, Tests, Grenzen, Soll-Abgleich, erzwungen in der CI -, dann menschliches Review auf dem vorgeprüften Diff, fokussiert auf Architektur und Business-Logik. Maschinen übernehmen die entscheidbaren Fragen; Menschen behalten das Urteil und die Merge-Entscheidung.

„Tests laufen durch“vom Agenten gemeldetexit code 0von Reality Graph gestartetBelegnur die Ausführung zählt
Inhalt

Warum eine Phase nicht mehr funktioniert

Review war eine einzige Tätigkeit, weil eine Person beide Jobs tragen konnte: Korrektheit prüfen und Qualität beurteilen. KI-Volumen hat diese Jobs auseinandergerissen: Telemetrie über 10.000+ Entwickler berichtet in einer Drittzusammenfassung von 2026 eine Assoziation zwischen intensiver KI-Nutzung, mehr gemergten PRs und längerer Review-Zeit; eine Ursache-Wirkung-Beziehung ist damit nicht belegt. Laut Sonar empfinden 38 % das Review von KI-Code als aufwendiger. Wenn dieselben knappen Minuten Stil-Nits, Typfehler, Scope-Checks und Architektur-Urteil tragen müssen, verdrängt die mechanische Arbeit das Urteil - also genau den Teil, für den Menschen gebraucht wurden.

JetBrains’ Engineering-Blog formuliert den Fix unverblümt: maschinell fangbare Fehler gar nicht erst ins menschliche Review schicken. Der Zwei-Phasen-Workflow ist dieses Prinzip, systematisiert.

Wo die Grenze zwischen den beiden Jobs verläuft - wofür Review da ist und was Verifikation tatsächlich abdeckt - zeigt Code-Review vs. Verifikation.

Phase 1: die maschinelle Vorprüfung

Phase 1 läuft bei jedem Push, als Required Status Check - nichts erreicht einen Menschen, das hier durchfällt:

  1. Deterministische Gates. Formatierung, Lint, Typen, Build und die Testsuite - inklusive vor dem Run geschriebener Tests, damit das generierende Modell nicht seinen eigenen Richter verfasst hat. Ob diese Gates tatsächlich gelaufen sind statt nur als gelaufen gemeldet zu werden, ist ein eigener Nachweis: die pro Befehl beobachteten Exit-Codes.
  2. Grenzprüfung. Der Diff gegen die deklarierten Auftragsgrenzen - Dateien und Verhalten, die sich nicht ändern dürfen. Änderungen außerhalb lassen die Phase scheitern.
  3. Soll-Abgleich. Der Soll-Ist-Abgleich gegen die Akzeptanzkriterien des Auftrags, mit festgehaltenem Ergebnis.
  4. Optional: KI-Pre-Review als Hypothesenfilter. Ein KI-Reviewer markiert wahrscheinliche Probleme im Diff. Cloudflares Orchestrierung dokumentiert eine konkrete Produktionsumsetzung im großen Maßstab. Das ist kein Beleg für denselben Effekt in jedem Team; der Output bleibt ein Screening-Signal, das Menschen bewerten, nie ein Verdikt.

Phase 2: das menschliche Review, aufgewertet

Der Reviewer bekommt den Diff plus die Phase-1-Ergebnisse: was geprüft wurde, was bestand, was übersprungen wurde. Der Job wandelt sich vom Absichts-Rekonstruieren zum Urteilen - ist das der richtige Ansatz, passt es zur Architektur, sollte es das überhaupt geben. Die saubere Aufteilung:

AspektPhase 1 - MaschinePhase 2 - Mensch
Formatierung, Lint, Typen, BuildErzwungenes GateSieht es nie
Testergebnisse (inkl. vorab geschriebener Tests)Erzwungenes GateLiest die Zusammenfassung
Scope vs. deklarierte GrenzenErzwungenes GateBeurteilt die Absicht erlaubter Änderungen
Akzeptanzkriterien (Soll-Abgleich)Geprüft + festgehaltenStichprobe auf dem Protokoll
Bug-Hypothesen (KI-Review)Screent + filtertEntscheidet über Markiertes
Architektur & System-Passung-Kernjob
Business-Logik-Plausibilität-Kernjob
Merge-EntscheidungNieImmer - mit Belegen vor Augen
Was in die Maschinen-Phase gehört und was menschlich bleibt: Die Trennlinie ist Entscheidbarkeit - alles Ja/Nein-Beantwortbare geht in Phase 1, alles Urteilende bleibt in Phase 2.

Grenzen und typische Fehler

  • Alibi-Automatisierung. Ein grünes Phase-1-Badge ist ein Input für das Review, kein Ersatz. Werden Freigaben reflexhaft, ist der Workflow leise gescheitert.
  • Lautes Pre-Review. Ein KI-Reviewer, der ständig Alarm schlägt, trainiert das Team, Phase 1 komplett zu ignorieren. Auf Präzision statt Vollständigkeit tunen; die Autorität tragen die deterministischen Gates.
  • Keine schriftliche Absicht. Ohne Auftragsvorgabe schrumpft Phase 1 auf Stil und Tests - echter Wert, aber die stärksten Prüfungen (Grenzen, Kriterien) brauchen ein schriftliches Soll.
  • Phase 1 als optional behandeln. Eine Vorprüfung, die sich unter Termindruck überspringen lässt, wird übersprungen - Required Status Checks gibt es aus gutem Grund.

Die Quellen beschreiben konkrete Umfragen, Produkte und Betriebskontexte mit Abrufstand Juli 2026. Eine bestandene erste Phase belegt nur, dass die deklarierten Checks bestanden wurden; sie beweist weder Korrektheit noch Eignung, Freigabe oder Release-Reife. Vor Merge oder Deployment muss ein Mensch Belege und Restrisiko einordnen und entscheiden.

Wo Reality Graph ansetzt

Reality Graph ist eine strukturierte Phase 1 mit Auftragsbezug: Grenzen und Akzeptanzkriterien vor dem Run definiert, der Diff danach dagegen geprüft, Validierung, die das Modell nicht verfasst hat, und ein Prüfbericht als Übergabe-Artefakt in Phase 2 - das fehlende Stück zwischen generischen CI-Checks und dem menschlichen Reviewer, eingebettet in den Verifikations-Loop.

Der Zwei-Phasen-Workflow liefert

  • Menschliche Review-Minuten für Urteil statt Mechanik
  • Ein konsistentes Maschinen-Gate auf jeder einzelnen Änderung
  • Reviewer, die vorgeprüfte Diffs mit Belegen lesen
  • Skalierung: Phase 1 wächst mit der CI, nicht mit Headcount

Er leistet nicht

  • Ersatz der menschlichen Merge-Entscheidung - nie
  • Wirkung als Alibi - grüne Badges sind Inputs, keine Verdikte
  • Volle Stärke ohne schriftliche Auftragsabsicht
  • Bindung an einen bestimmten KI-Reviewer oder Anbieter

Wenn diese Grenzen zu eurem Team passen:

FAQ

Wie sieht ein effizienter Review-Workflow für KI-Code aus?
Zwei Phasen mit verschiedenen Jobs: Phase eins ist maschinelle Verifikation pro Änderung - Formatierung, Typen, Tests, Grenz- und Soll-Prüfung, optional ein KI-Pre-Review als Hypothesenfilter - erzwungen als Required Status Check. Phase zwei ist menschliches Review auf dem vorgeprüften Diff, fokussiert auf Architektur, Business-Logik und die Fragen, die keine Checkliste stellen kann. Die Merge-Entscheidung trifft immer ein Mensch.
Was gehört in die Maschinen-Phase, was bleibt menschlich?
Alles Entscheidbare gehört der Maschine: Stil, Typen, Testergebnisse, Scope gegen deklarierte Grenzen, Kriterien aus der Auftragsvorgabe. Alles Urteilende bleibt menschlich: Ist das der richtige Ansatz, passt es ins System, ist die Absicht selbst sinnvoll. Die Trennlinie ist Entscheidbarkeit, nicht Schwierigkeit.
Ist ein KI-Reviewer dasselbe wie eine maschinelle Vorprüfung?
Er ist eine Zutat, nicht die Phase selbst. Ein KI-Reviewer erzeugt Hypothesen über Probleme - nützlich, um mechanisches Rauschen zu räumen, aber er weiß nicht, was die Änderung leisten sollte. Ihre Autorität bezieht die Vorprüfung aus deterministischen Gates (Tests, Typen, Grenzen, Soll-Abgleich); der KI-Reviewer ergänzt Breite, gefiltert über eine menschlich gesetzte Signalschwelle.
Bremst ein Pflicht-Pre-Check das Mergen nicht aus?
Er verlagert einige wiederholbare Prüfungen von Menschen auf Maschinen; Zeit- und Qualitätseffekt hängen jedoch von Repository, Gates und Fehlalarmrate ab. Cloudflare beschrieb 2026 die eigene Orchestrierung automatisierter Reviews. Das ist ein Betriebsbeispiel, kein universelles Effizienzergebnis.
Woran scheitert dieser Workflow am häufigsten?
An Alibi-Automatisierung: Die Vorprüfung existiert, also lesen Menschen nicht mehr - oder die Vorprüfung ist so laut, dass alle lernen, sie zu ignorieren. Beides sind Kalibrierungsfehler. Das Phase-1-Signal muss präzise bleiben (JetBrains' Rat gilt: IDE-fangbare Fehler gar nicht erst ins Review schicken), und Phase 2 muss echtes Review bleiben statt Stempel auf grünem Häkchen.
Braucht es dafür eine Auftragsvorgabe?
Der Workflow verbessert Review auch ohne - aber seine stärkste Prüfung, der Abgleich gegen deklarierte Absicht und Grenzen, braucht einen schriftlichen Auftrag. Fünf Minuten Vorgabe pro Run machen den Unterschied zwischen „die Tests sind grün“ und „das ist nachweislich die beauftragte Änderung“.

Weiterlesen

Quellen

Wollt ihr sehen, wie euer letzter Agenten-Run ausgesehen hätte?

Zugang anfragen