Spezifikationsgetriebene Entwicklung

Was ist Spezifikationsgetriebene Entwicklung?

Spezifikationsgetriebene Entwicklung ist die Praxis, eine präzise Spezifikation mit Anforderungen und Abnahmekriterien zu schreiben, bevor ein KI-Agent mit dem Bauen beginnt. Die Spezifikation wird zur dauerhaften Quelle der Wahrheit, gegen die der Agent implementiert und Reviewer verifizieren, und ersetzt die verstreute Prompt-Historie, die Ad-hoc-KI-Coding hinterlässt.

Die wichtigsten Punkte

• Die Spezifikation ist das Liefergut, das der Mensch besitzt. Code wird zu einem Output, der regeneriert werden kann; die Spezifikation hält Absicht, Einschränkungen, und was "fertig" bedeutet fest.
• Abnahmekriterien leisten Doppelarbeit: Sie steuern den Agenten während der Implementierung und geben Reviewern danach eine objektive Checkliste.
• Spezifikationen beheben den größten Fehlermodus von agentischem Coding, nämlich dass der Agent selbstbewusst das Falsche baut, weil Anforderungen nur im Kopf der Ingenieurin lebten.
• Tooling hat die Praxis formalisiert. GitHubs Spec Kit, Amazons Kiro, und Plan-Modi in agentischen Tools strukturieren Arbeit alle als spezifizieren, planen, dann implementieren. Spec Kit allein sammelte innerhalb eines Jahres nach seinem Launch im August 2025 über 126.000 GitHub-Stars und 11.000 Forks [1].
• Spezifikationsqualität ist der neue Engpass. Eine vage Spezifikation produziert plausiblen Code, der Randfälle übersieht, und keine Menge an Agenten-Fähigkeit gleicht das aus.

So funktioniert es

Der Workflow teilt Lieferung in Phasen mit einem Checkpoint zwischen jeder. Zuerst kommt die Spezifikation: was das Feature tut, seine Inputs und Outputs, Fehlerverhalten, Nicht-Ziele, und ein Set von Abnahmekriterien, konkret genug, um testbar zu sein. Gute Spezifikationen lesen sich wie ein sorgfältiges Ticket plus ein Vertrag, kein Roman. Viele Teams entwerfen sie mit dem Modell selbst, lassen es die Anforderungen hinterfragen und Mehrdeutigkeiten aufdecken, bevor ein Mensch grünes Licht gibt.

Als Nächstes verwandelt der Agent, oder die Ingenieurin mit dem Agenten, die Spezifikation in einen technischen Plan: welche Dateien sich ändern, wie das Datenmodell aussieht, wie die Änderung sequenziert wird. Einen Plan zu reviewen dauert Minuten und fängt architektonische Fehler ab, bevor sie Stunden kosten. Erst dann beginnt die Implementierung. Der Agent baut gegen die Spezifikation, führt die aus den Abnahmekriterien abgeleiteten Tests aus, und iteriert, bis sie bestehen. Weil die Spezifikation als Datei im Repo sitzt statt in einem Chat-Log, kann eine frische Agenten-Sitzung, ein anderes Tool, oder ein Teammitglied dieselbe Arbeit aufnehmen, ohne Archäologie durch die Prompt-Historie zu betreiben.

Die letzte Phase ist Verifikation. Human-in-the-Loop-Review prüft den Diff gegen die Spezifikation, Kriterium für Kriterium. Das ist das Stück, das die Praxis von Vibe Coding unterscheidet: Abnahme wird vor der Generierung definiert, sodass "sieht richtig aus" nie "erfüllt die Spezifikation" ersetzt.

Beispiel

Ein Payments-Team braucht Webhook-Handling für einen neuen Anbieter. Die Teamleitung schreibt eine einseitige Spezifikation: die fünf zu verarbeitenden Event-Typen, Idempotenz geschlüsselt auf Event-ID, exponentielles Backoff bei nachgelagerten Fehlern, einen Dead-Letter-Pfad nach fünf Versuchen, und acht Abnahmetests einschließlich eines Duplikat-Zustellungsfalls. Ein KI-Coding-Agent schlägt einen Plan vor, die Teamleitung korrigiert die Queue-Wahl, und der Agent implementiert. Zwei der acht Tests scheitern beim ersten Durchlauf; der Agent behebt beide. Das Review dauert zwanzig Minuten, weil jedes Kriterium prüfbar ist. Drei Monate später erweitert eine andere Ingenieurin den Handler, indem sie zuerst die Spezifikation ändert, und die ursprüngliche Absicht ist weiterhin lesbar.

Häufige Missverständnisse

Der häufige Einwand ist, spezifikationsgetriebene Entwicklung sei Wasserfall mit neuem Etikett. Der Vergleich übersieht die Zykluszeit. Wasserfall scheiterte, weil die Lücke zwischen Spezifikation und funktionierender Software Monate betrug, sodass Spezifikationen verrotteten, bevor sie mit der Realität in Kontakt kamen. Hier beträgt die Lücke Minuten bis Stunden, und die Spezifikation wird zusammen mit dem Code versioniert und aktualisiert, sobald die Realität zurückdrückt. Es verhält sich weniger wie ein großes Vorab-Design-Dokument und mehr wie eine enge Schleife aus geäußerter Absicht und sofortiger Verifikation, im Geiste näher an testgetriebener Entwicklung als an irgendetwas aus der Wasserfall-Ära.

FAQ

Wie detailliert sollte eine Spezifikation sein? Detailliert genug, dass eine kompetente fremde Person beurteilen könnte, ob eine Implementierung sie erfüllt, und nicht mehr. Konkrete Abnahmekriterien, explizite Randfälle, und genannte Nicht-Ziele zählen am meisten. Implementierungsdetails auf Zeilenebene vorzuschreiben verschwendet die Stärken des Agenten und macht die Spezifikation zur Wartungslast.

Braucht jede Aufgabe eine Spezifikation? Nein. Eine Umbenennung, ein Abhängigkeits-Bump, oder ein Ein-Zeilen-Fix braucht einen Satz, kein Dokument. Die Praxis zahlt sich bei Arbeit mit echter Mehrdeutigkeit aus: neue Features, Integrationen, alles, was Geld, Auth oder Daten berührt. Teams setzen meist eine Schwelle und überspringen die Zeremonie darunter.

Welche Tools unterstützen spezifikationsgetriebene Entwicklung? GitHub Spec Kit und Amazon Kiro bauen den gesamten Workflow um Spezifikationen herum. Allgemeiner bringen einen die Plan-Modi in Claude Code, Cursor und ähnlichen Tools, plus ein Specs-Verzeichnis im Repo und Anweisungen in AGENTS.md oder CLAUDE.md, die meisten Teams dorthin, ohne neues Tooling. Keine der Optionen ist vollständig: Eine vergleichende Studie von sechs spezifikationsgetriebenen Frameworks im Juni 2026, einschließlich Spec Kit und OpenSpec, fand, dass kein Framework alle sechs bewerteten Prozessdimensionen stark abdeckte, also erwarten Sie einen Kompromiss zwischen Prozesstiefe und Portabilität [2].

Quellen

1. GitHub. "Stern- und Fork-Zahlen für das Repository github/spec-kit." https://github.com/github/spec-kit. Abgerufen im August 2026.
2. arXiv. "Vergleichende Bewertung von sechs Frameworks zur Unterstützung von KI-Softwareentwicklungs-Agenten." https://arxiv.org/abs/2606.04967. Abgerufen im August 2026.