KI Beschreibungen für PRs brauchen einen menschlich kuratierten Einstieg

Simon Willison nutzt den Pull Request als grundlegende Arbeitseinheit mit Claude Code und Codex. Die lange maschinell erstellte Beschreibung löscht er nicht. Er legt sie in ein aufklappbares Element und setzt einige von einem Menschen ausgewählte Sätze davor.

GitHub kann maschinelle Details verbergen, ohne sie zu verlieren

GitHub Markdown unterstützt die HTML Elemente details und summary in Pull Request Beschreibungen und Kommentaren. Willison legt die Erklärung des Agents dort ab. Sichtbar bleiben eine kurze Einleitung, manchmal ein Bild sowie eine Angabe zum Modell oder Aufwand.

Er zeigt fünf konkrete Pull Requests. Eine Einleitung beschreibt ein Layoutproblem mit einer Tabelle aus 46 Spalten. Eine andere nennt das unnötige Laden einer Datei von ungefähr 220 KB. Der ausführliche Bericht über Umsetzung und Tests bleibt nach dem Aufklappen verfügbar.

Nach dem billigen Schreiben wird das Lesen zum Engpass

Ein Coding Agent kann eine genaue und vollständige Beschreibung fast ohne Aufwand für den Autor erzeugen. Reviewer bezahlen weiterhin mit ihrer Zeit. Wenn jeder Pull Request mehrere gleichermaßen ausführliche Absätze mitbringt, erschwert Vollständigkeit die Orientierung.

Willison trennt zwei Aufgaben. Die kurze Einleitung beantwortet, ob die Änderung Aufmerksamkeit verdient. Der eingeklappte Teil bewahrt Entscheidungen, Implementierungsdetails und Tests für den Moment auf, in dem sie jemand braucht. Menschliche Arbeit verlagert sich vom Schreiben zur Auswahl.

Ein Klappelement ersetzt weder Urteil noch Review

Das Muster garantiert weder korrekten Code noch eine zutreffende Beschreibung. Eine schlecht gewählte Einleitung kann ein Risiko ebenso leicht verbergen wie Fülltext. Der lange Text im Inneren bleibt außerdem lang, auch wenn er den ersten Blick nicht mehr blockiert.

Die Konvention funktioniert nur mit einem klaren Versprechen im Team: Der sichtbare Absatz zeigt menschlich bestätigte Prioritäten und ist keine weitere automatische Zusammenfassung. Ohne diese Verantwortung wird das Element zu einem digitalen Schrank, den alle füllen und niemand öffnet.

Schnellere Entscheidungen zählen mehr als längere Beschreibungen

Das sinnvolle Signal ist eine kürzere Zeit bis zum ersten Review und weniger übersehene Risiken, nicht die Zahl der Wörter hinter einem Pfeil. Teams sollten prüfen, ob die Einleitung Zweck, Umfang und wichtigstes Risiko einer Änderung zuverlässig nennt.

Wenn sich das Muster verbreitet, wirkt die Änderung unscheinbar. Der Agent liefert die vollständige Akte, ein Mensch wählt das Deckblatt und der Reviewer entscheidet, ob der Rest geöffnet wird.

Liliths Urteil

Der Agent bringt einen ganzen Karton Akten zum Review. Ein Mensch muss auf den Deckel schreiben, warum ihn jemand öffnen sollte.