
Inhaltsverzeichnis
In großen Softwarefirmen gibt es für Code-Reviews feste Prozesse, eigene Tools und manchmal sogar Rollen, die sich nur um Qualitätssicherung kümmern. In kleinen Teams mit zwei bis acht Entwicklerinnen und Entwicklern sieht die Realität anders aus: Jeder ist gleichzeitig Autor und Reviewer, Deadlines drücken, und der Pull Request liegt manchmal drei Tage, bevor ihn jemand öffnet. Dabei lassen sich Reviews auch mit wenig Aufwand so organisieren, dass sie Fehler finden, Wissen verteilen und niemanden ausbremsen.
Wozu Code-Reviews in kleinen Teams dienen
Der offensichtliche Zweck eines Code-Reviews ist, Fehler zu finden, bevor sie in die Produktion gelangen. In kleinen Teams ist ein zweiter Effekt mindestens genauso wichtig: Wissen wird verteilt. Wenn nur eine Person ein bestimmtes Modul kennt, wird jeder Urlaub und jede Krankheit zum Risiko. Reviews sorgen dafür, dass mindestens zwei Leute jede Änderung gesehen haben.
Ein dritter Nutzen wird oft unterschätzt: Reviews machen implizite Konventionen sichtbar. Wie werden Variablen benannt? Wo gehören Konfigurationswerte hin? Wann wird ein Test geschrieben? Was in größeren Organisationen in Styleguides steht, entsteht in kleinen Teams häufig erst durch Kommentare in Pull Requests.
Die Grundlage: ein klarer Branch-Workflow
Bevor es um Reviews geht, muss geklärt sein, wie Änderungen überhaupt in den Hauptzweig kommen. Für die meisten kleinen Teams hat sich der Feature-Branch-Workflow bewährt: Jede Aufgabe bekommt einen eigenen Branch, Änderungen werden per Pull Request (bei GitLab Merge Request genannt) eingebracht, und der Hauptzweig ist geschützt, sodass niemand direkt hineinschreiben kann. Wer die Begriffe Commit, Branch, Merge und Remote noch einmal sauber auseinanderhalten möchte, findet eine verständliche Einführung in diesem Ratgeber zu Git-Grundlagen und Team-Workflow, der auch typische Fehler und deren Behebung erklärt.
Wichtig ist der Unterschied zwischen Git und der Plattform: Git selbst kennt keine Pull Requests. Diese Funktion stellen Plattformen wie GitHub, GitLab, Bitbucket oder Gitea bereit. Die Regeln für Freigaben, Pflicht-Reviewer und automatische Tests werden deshalb in der Plattform eingestellt, nicht im Repository selbst.
Pull Requests klein halten
Die wirksamste einzelne Maßnahme für bessere Reviews ist, Pull Requests klein zu halten. Ein Pull Request mit 50 geänderten Zeilen wird gründlich gelesen. Einer mit 1.500 Zeilen wird überflogen und mit „Sieht gut aus“ freigegeben, weil niemand die Zeit hat, ihn wirklich zu verstehen. Bewährte Faustregeln:
- Eine Aufgabe pro Pull Request: Refactoring und neue Funktion getrennt einreichen, auch wenn sie zusammengehören.
- Vorarbeiten ausgliedern: Wer erst eine Hilfsfunktion umbauen muss, reicht diese Änderung vorab ein.
- Feature-Flags nutzen: Größere Funktionen lassen sich in kleinen Schritten mergen, wenn sie hinter einem Schalter verborgen bleiben, bis sie fertig sind.
- Generierte Dateien kennzeichnen: Lockfiles oder automatisch erzeugter Code sollten nicht die eigentliche Änderung verdecken.
Eine gute Pull-Request-Beschreibung
Reviewer sparen viel Zeit, wenn sie nicht erraten müssen, worum es geht. Eine einfache Vorlage, die viele Plattformen als Template hinterlegen können, enthält:
- Was ändert sich? Zwei bis drei Sätze in Klartext.
- Warum? Verweis auf Ticket oder Anforderung.
- Wie wurde getestet? Automatische Tests, manuelle Schritte, Testdaten.
- Worauf soll besonders geachtet werden? Unsichere Stellen offen benennen.
- Screenshots bei Oberflächenänderungen.
Gerade Punkt 4 verändert die Dynamik: Wer selbst sagt, wo er unsicher ist, bekommt gezielteres Feedback und muss sich weniger rechtfertigen.
Regeln für das Review selbst
Reaktionszeiten vereinbaren
Das häufigste Problem in kleinen Teams ist nicht schlechtes Feedback, sondern ausbleibendes. Eine einfache Vereinbarung hilft: Ein Pull Request bekommt innerhalb eines Arbeitstages eine erste Reaktion. Manche Teams legen dafür feste Zeitfenster fest, etwa direkt nach dem Daily oder nach der Mittagspause.
Kommentare einordnen
Nicht jeder Kommentar hat das gleiche Gewicht. Eine einfache Kennzeichnung schafft Klarheit:
| Präfix | Bedeutung |
| blocker: | muss vor dem Merge geändert werden, etwa ein Fehler oder ein Sicherheitsproblem |
| frage: | Verständnisfrage, keine Änderung zwingend |
| vorschlag: | wäre besser, kann aber auch später oder gar nicht umgesetzt werden |
| nit: | Kleinigkeit wie Formatierung oder Benennung |
Automatisieren, was automatisierbar ist
Formatierung, Linting und Tests gehören in die CI-Pipeline, nicht in menschliche Kommentare. Wenn ein Formatter wie Prettier, Black oder gofmt automatisch läuft, entfallen Diskussionen über Einrückung und Leerzeichen vollständig. Die Plattform kann so eingestellt werden, dass ein Merge erst möglich ist, wenn alle Prüfungen grün sind. Menschliche Reviewer können sich dann auf Logik, Lesbarkeit, Architektur und Randfälle konzentrieren.
Wie viele Freigaben braucht es?
In Teams mit drei bis acht Personen reicht in der Regel eine Freigabe pro Pull Request. Zwei Pflicht-Reviewer verdoppeln die Wartezeit, ohne dass sich die Qualität entsprechend verbessert. Ausnahmen sind sicherheitskritische Bereiche wie Authentifizierung, Zahlungsabwicklung oder Datenbankmigrationen, für die über eine CODEOWNERS-Datei feste Verantwortliche hinterlegt werden können.
Bei Zwei-Personen-Teams stellt sich die Frage, ob sich Reviews überhaupt lohnen. Die Antwort ist meist ja, schon wegen des Wissensaustauschs. Alternativ kann bei sehr kleinen Änderungen Pair Programming das formale Review ersetzen.
Ton und Teamkultur
Reviews sind Gespräche über Code, nicht über Personen. Formulierungen wie „Was hältst du davon, hier eine Map zu verwenden?“ funktionieren besser als „Das ist falsch“. Ebenso wichtig ist, gelungene Lösungen ausdrücklich zu erwähnen. Ein kurzes „Schöne Lösung für den Randfall“ kostet nichts und sorgt dafür, dass Reviews nicht nur als Fehlersuche empfunden werden.
Bewährt hat sich auch, Reviews gelegentlich in einer Retrospektive zu besprechen: Wie lange warten Pull Requests im Schnitt? Gibt es wiederkehrende Diskussionen, die in eine Konvention oder einen Linter-Regel überführt werden sollten? Kleine Teams haben den Vorteil, solche Anpassungen schnell umsetzen zu können, ohne dass es eine Abstimmung über mehrere Abteilungen braucht.


