Was ist ein Quality Gate? Definition, Kriterien und typische Fehler

Ein Quality Gate ist ein definierter Prüfpunkt mit festen Kriterien, den eine Änderung bestehen muss, bevor sie weitergereicht wird. Es ist keine Empfehlung und keine Kennzahl, sondern eine Schranke: Kriterien erfüllt heißt weiter, nicht erfüllt heißt Stopp. Diese Eindeutigkeit ist der ganze Wert — ein Gate, das man übergehen kann, ist ein Bericht.

Was ist ein Quality Gate?

Der Begriff kommt aus dem Projektmanagement und bezeichnete ursprünglich einen Meilenstein, an dem definierte Ergebnisse vorliegen müssen, bevor die nächste Phase beginnt. In der Softwareentwicklung hat er eine engere, technische Bedeutung bekommen: eine automatisierte Prüfung in der Auslieferungskette, die bei Nichterfüllung den Vorgang abbricht.

Drei Eigenschaften machen ein Gate zum Gate:

• Die Kriterien stehen vorher fest. Nicht im Einzelfall verhandelt, sondern als Regel formuliert.
• Die Entscheidung ist binär. Bestanden oder nicht. „Grenzwertig, aber es eilt" ist keine zulässige Antwort einer Maschine.
• Sie ist verbindlich. Ein nicht bestandenes Gate hält den Vorgang an. Sonst ist es ein Hinweis.

Welche Kriterien gehören in ein Quality Gate?

Nur solche, die eine Maschine eindeutig entscheiden kann. Alles andere gehört ins Review, nicht ins Gate.

Kriterium	Sinnvolle Schwelle
Testlauf	keine fehlschlagenden Tests — ohne Ausnahme
Abdeckung der geänderten Zeilen	nicht unter dem bestehenden Projektwert
Neue Befunde der statischen Analyse	keine oberhalb der festgelegten Schwere
Bekannte Schwachstellen in Abhängigkeiten	keine neuen kritischen
Geheimnisse im Quelltext	keine — Verstoß bricht immer ab
Neue Duplikate	keine oberhalb der festgelegten Blockgröße

Die entscheidende Unterscheidung steckt in der zweiten Spalte: Die Schwellen gelten für neuen und geänderten Code, nicht für den Bestand. Ein Gate, das den Altbestand bewertet, blockiert am ersten Tag alles und wird am zweiten abgeschaltet.

Wo im Ablauf sollte ein Quality Gate stehen?

An mehreren Stellen, mit steigender Strenge und sinkender Häufigkeit.

• Beim Commit (Sekunden): Formatierung, offensichtliche Fehler, Geheimnisse. Was hier scheitert, kostet nichts.
• Beim Pull Request (Minuten): Tests, statische Analyse, Abdeckung, Abhängigkeiten. Das eigentliche Gate.
• Vor dem Deploy (die harte Schranke): alles davor plus die Fragen, die nur hier zählen — ist eine Migration dabei, ist sie umkehrbar, gibt es einen Rückrollweg, wurde etwas mitgeschickt, das nie auf einen Server gehört?

Der letzte Punkt wird oft vergessen, weil er nicht nach Codequalität aussieht. Er ist der teuerste: Eine falsch mitgelieferte Konfigurationsdatei oder eine nicht umkehrbare Migration ist der einzige Fehler in dieser Liste, der ein System für Stunden lahmlegen kann. Details unter Quality Gates in der CI/CD-Pipeline.

Warum scheitern Quality Gates in der Praxis?

An vier Fehlern, die alle dieselbe Wirkung haben: Das Gate wird umgangen statt genutzt.

• Zu viele Kriterien auf einmal. Wer mit fünfzehn Regeln startet, blockiert jeden Vorgang und wird nach einer Woche abgeschaltet. Beginnen Sie mit drei.
• Bestand statt Neues bewerten. Der häufigste Einführungsfehler — siehe oben.
• Umgehung ohne Spur. Es muss eine Möglichkeit geben, ein Gate zu übergehen, sonst blockiert der erste Sonderfall den Betrieb. Diese Möglichkeit muss protokolliert sein und einen Namen tragen. Eine stille Umgehung macht das Gate wertlos.
• Kriterien, die nichts entscheiden. Ein Gate, das seit einem Jahr immer grün ist, prüft nichts. Entweder die Schwelle ist zu lasch oder das Kriterium ist beim aktuellen Arbeitsstil irrelevant.

Warum sind Quality Gates bei KI-Code wichtiger geworden?

Weil die Prüfkapazität nicht mit der Erzeugungsgeschwindigkeit mitwächst. Ein Mensch prüft heute nicht mehr Zeilen pro Stunde als vor drei Jahren; erzeugt werden aber deutlich mehr.

Die Folge ist eine Bewegung, die ein Mensch im einzelnen Diff nicht sehen kann — mehr Duplikate, weniger Aufräumen (Zahlen und Herkunft) — und die eine Schwelle in der Pipeline sofort meldet. Genau dafür ist ein Gate das richtige Werkzeug: Es vergleicht nicht die Zeile, sondern den Zustand.

Häufige Fragen zu Quality Gates

Was ist der Unterschied zwischen Quality Gate und Definition of Done?

Das Gate prüft maschinell und entscheidet binär. Die Definition of Done ist die Vereinbarung im Team und enthält auch Punkte, die keine Maschine beurteilen kann. Das Gate setzt den technischen Teil der Definition of Done durch — siehe Definition of Done.

Brauche ich SonarQube für ein Quality Gate?

Nein. Jede CI-Pipeline kann bei einem Fehlschlag abbrechen — das ist bereits ein Gate. Eine Plattform liefert Verlauf, Schwellenverwaltung und Auswertung, ist aber keine Voraussetzung.

Wie viele Kriterien sollte ein Gate haben?

Am Anfang drei: keine fehlschlagenden Tests, keine neuen kritischen Analysebefunde, keine Geheimnisse im Code. Erweitern Sie, wenn diese drei stabil grün sind.

Was, wenn ein Gate dringende Arbeit blockiert?

Dann wird es dokumentiert übergangen, mit Namen und Grund — und der Fall wird nachbereitet. Häufen sich Umgehungen an derselben Stelle, stimmt das Kriterium nicht, nicht die Dringlichkeit.

Ein Gate wirkt nur, wenn es vor dem Schritt steht und nicht daneben. Genau das ist die Bauart von Code Guardian: fünf Gates bei Deploy, Migration, neuer Abhängigkeit, Datenurteil und Optionsfrage — vier davon mit einem Hook, der den Vorgang tatsächlich anhält.

Quellen

• GitClear, The Maintainability Gap: 2026 AI Code Quality Research.
• ISO/IEC 25010:2023 (Qualitätsmerkmale, an denen sich Gate-Kriterien ausrichten lassen).

Stand: 27. Juli 2026. Allgemeine fachliche Einordnung.