Spec-driven Development: die Spezifikation als Arbeitsauftrag
Anforderungen so schreiben, dass ein KI-Agent sie umsetzt und ein Mensch das Ergebnis prüfen kann
Inhalt
Spec-driven Development heißt: Bevor ein KI-Agent Code schreibt, steht in einer Spezifikation, was gebaut werden soll, warum, und woran man erkennt, dass es fertig ist. Der Agent setzt diese Spezifikation um, ein Mensch prüft das Ergebnis gegen dieselbe Spezifikation. Sie ist Arbeitsauftrag und Abnahmekriterium zugleich.
Eine gute Spezifikation für einen Agenten ist kurz. Sie nennt Ziel, Ausgangslage, gewünschtes Verhalten, prüfbare Kriterien, Grenzen und den Weg der Prüfung. Eine Vorlage dafür steht weiter unten. Der schwierigste Teil ist nicht das Format, sondern die Klärung davor: Was soll eigentlich passieren?
Dieser Artikel gehört zur Serie über die Agentic Software Factory.
Was Spec-driven Development ist
Der Begriff hat sich 2025 mit Werkzeugen für Coding-Agenten verbreitet. GitHub veröffentlichte im September 2025 Spec Kit, ein quelloffenes Werkzeug, das Agenten durch vier Phasen führt. Erst beschreibt man, was gebaut werden soll und warum, und der Agent schreibt daraus eine Spezifikation. Dann gibt man Technik, Architektur und Einschränkungen vor, und der Agent plant. Danach zerlegt er den Plan in kleine Aufgaben, die sich einzeln umsetzen und testen lassen. Zuletzt setzt er sie um. Quelle: GitHub Blog, Spec-driven development with AI, 2. September 2025.
Die Rolle des Menschen beschreibt GitHub dort ausdrücklich als Prüfung: Nach jeder Phase wird kontrolliert, ob etwas fehlt oder falsch ist, bevor es weitergeht. Die KI erzeugt die Dokumente, der Mensch sorgt dafür, dass sie stimmen.
Birgitta Böckeler von Thoughtworks unterscheidet drei Stufen. Bei Spec-first wird die Spezifikation vor der Arbeit geschrieben und danach meist nicht weiter gepflegt. Bei Spec-anchored bleibt sie erhalten und wird mit der Funktion weiterentwickelt. Bei Spec-as-source bearbeiten Menschen nur noch die Spezifikation, nie den Code. Böckelers Befund: Die untersuchten Werkzeuge sind alle Spec-first, kaum eines geht weiter. Quelle: Böckeler, Understanding Spec-Driven-Development, 15. Oktober 2025.
Warum Agenten eine Spezifikation brauchen
Ein Agent füllt jede Lücke im Auftrag mit einer Annahme. Bei „Mach das Kontaktformular besser“ entscheidet er selbst, was besser heißt. Das Ergebnis kann gut sein. Prüfen lässt es sich nicht, weil niemand vorher gesagt hat, wogegen.
Für einen schnellen Prototyp ist das in Ordnung. Wofür dieses Arbeiten nach Gefühl taugt und wo es aufhört, beschreibt der Artikel zu Vibe Coding und Agentic Engineering. Sobald Software in Betrieb geht, braucht es einen Maßstab. Die Spezifikation ist dieser Maßstab, und sie entsteht, bevor der Code entsteht.
Ein zweiter Grund ist die Prüfarbeit. Ohne Spezifikation muss die Person, die freigibt, aus dem Code erschließen, was er tun soll. Mit Spezifikation vergleicht sie: Steht da, was gefordert war? Fehlt etwas? Ist etwas dazugekommen, das niemand bestellt hat?
Was in eine Spezifikation für einen Agenten gehört
Die folgende Vorlage passt in die Beschreibung eines Issues oder in eine Datei im Repository. Sie ist bewusst knapper als die Dokumente, die Spec Kit erzeugt.
## Ziel
Was nach der Änderung anders ist, in einem Satz, aus Sicht der Nutzer.
## Ausgangslage
Was heute passiert. Mit Messwert, Screenshot oder Fehlermeldung.
## Gewünschtes Verhalten
- Wenn …, dann …
- Wenn …, dann …
## Akzeptanzkriterien
- [ ] Prüfbares Kriterium mit Zahl oder beobachtbarem Ergebnis
- [ ] Bestehende Tests bleiben grün, neuer Test hält das Verhalten fest
## Nicht Teil dieser Aufgabe
- Was ausdrücklich unverändert bleibt.
## Prüfweg
Wie ein Mensch das Ergebnis prüft: Vorschau-Adresse, Seite, Gerät, Messung.
## Offene Fragen
Was vor dem Start geklärt sein muss.Zwei Abschnitte werden oft vergessen. „Nicht Teil dieser Aufgabe“ verhindert, dass der Agent nebenbei aufräumt, was niemand bestellt hat. „Offene Fragen“ macht sichtbar, was noch nicht entschieden ist. Ein Agent, der eine offene Frage vorfindet, fragt nach, statt zu raten. Zumindest, wenn die Regeldatei ihm das aufträgt. Wie man eine solche Datei aufbaut, steht im Artikel zu Context Engineering und AGENTS.md.
Prüfbar schreiben: Kriterien, die ein Mensch abhaken kann
Ein Akzeptanzkriterium ist gut, wenn zwei Menschen unabhängig voneinander zum selben Urteil kommen. Das gelingt mit Zahlen, mit beobachtbarem Verhalten und mit Beispielen.
Unklar | Prüfbar |
|---|---|
Die Startseite soll schneller laden. | Largest Contentful Paint der Startseite auf Mobil unter 2,5 Sekunden, gemessen mit PageSpeed Insights auf der Vorschau. |
Das Formular soll benutzerfreundlicher werden. | Eine fehlende Pflichtangabe wird direkt am Feld gemeldet, ohne dass die Seite neu lädt. |
Fehler sollen besser behandelt werden. | Antwortet die Schnittstelle nicht, sieht der Nutzer nach höchstens zehn Sekunden einen Hinweis und kann es erneut versuchen. |
Die Suche soll bessere Ergebnisse liefern. | Für die zehn Suchbegriffe in der Liste steht der erwartete Treffer unter den ersten drei. |
Das erste Beispiel stammt aus dem Betrieb von kopfwelt.com. Ein Pull Request im November 2026 begann mit genau diesem Satz als Ziel. Der Agent hat die Ursache gesucht, die Änderung gebaut und die Vorschau gemessen. Ob das Ziel erreicht war, ließ sich vor der Freigabe ablesen. Den ganzen Ablauf beschreibt der Fallbericht zu kopfwelt.com.
Nicht jedes Kriterium lässt sich messen. Bei Gestaltung und Texten hilft ein Beispiel: eine Vorlage, ein Screenshot, ein Absatz im gewünschten Ton. Auch das ist prüfbar, nur eben durch Vergleich.
Werkzeuge: Spec Kit, Kiro und eine Datei im Repository
Für Spec-driven Development braucht es kein eigenes Werkzeug. Ein Issue mit der Vorlage oben genügt für die meisten Aufgaben. Für größere Vorhaben gibt es Werkzeuge, die den Ablauf vorgeben:
Spec Kit von GitHub ist quelloffen und arbeitet mit verschiedenen Coding-Agenten, darunter GitHub Copilot, Claude Code und Gemini CLI. Es legt Grundsätze des Projekts, Spezifikation, Plan und Aufgaben als Dateien an. Quelle: github/spec-kit.
Kiro erzeugt zu jeder Funktion drei Dateien: Anforderungen mit Akzeptanzkriterien, einen technischen Entwurf und eine Aufgabenliste. Quelle: Kiro, Specs.
Beide setzen auf dasselbe Prinzip: Die Spezifikation liegt als Datei im Repository, versioniert wie der Code. Wer sie dort ablegt, kann später nachvollziehen, warum etwas so gebaut wurde.
Wo Spec-driven Development übertreibt
Böckeler hat die Werkzeuge an echten Aufgaben ausprobiert und benennt die Schwächen deutlich. Für einen kleinen Fehler war der Ablauf von Kiro überdimensioniert. Spec Kit erzeugte so viele ähnliche Markdown-Dateien, dass sie nach eigener Aussage lieber Code geprüft hätte als diese Dokumente. Und die Agenten hielten sich nicht immer an die Spezifikation. In einem Fall legte einer vorhandene Klassen ein zweites Mal an.
Daraus folgen drei Regeln für den Alltag:
Der Umfang passt sich der Aufgabe an. Ein Tippfehler braucht einen Satz, eine neue Schnittstelle eine Seite.
Die Spezifikation ersetzt keine Prüfung. Auch ein Agent mit guter Spezifikation weicht ab. Darum endet jede Aufgabe mit einem Menschen, der das Ergebnis gegen die Kriterien prüft. Wie das organisiert ist, beschreibt der Artikel zu Human in the Loop.
Kleine Schritte bleiben besser als ein großer Entwurf. Lieber fünf Spezifikationen, die nacheinander umgesetzt und geprüft werden, als eine, die alles auf einmal regelt.
Anforderungen klären ist die eigentliche Arbeit
Spec-driven Development verschiebt Arbeit nach vorn. Was früher im Code entschieden wurde, wird jetzt im Text entschieden, bevor der Agent anfängt. Das ist keine neue Disziplin. Es ist Anforderungsklärung, wie sie in jedem Softwareprojekt gebraucht wird, nur mit einem Leser, der jede Lücke wörtlich nimmt.
An dieser Stelle setzt für mich Beratung an. Die Frage, was eine Änderung bewirken soll und woran man das merkt, beantwortet kein Werkzeug. Sie verlangt ein Gespräch mit den Menschen, die die Software nutzen und verantworten. Wie wir diese Klärung mit dem Bauen durch Agenten verbinden, steht auf der Seite zu KI-gestützter Softwareentwicklung. Für die Frage, wo KI im Unternehmen überhaupt hilft, gibt es die KI-Beratung.
Häufige Fragen zu Spec-driven Development
Was ist Spec-driven Development?
Was ist Spec-driven Development?
Ein Vorgehen, bei dem vor der Umsetzung eine Spezifikation steht: was gebaut wird, warum und woran man erkennt, dass es fertig ist. Ein KI-Agent setzt sie um, ein Mensch prüft das Ergebnis gegen dieselbe Spezifikation. Der Begriff hat sich 2025 mit Werkzeugen wie Spec Kit von GitHub verbreitet.
Wie unterscheidet sich Spec-driven Development von Vibe Coding?
Wie unterscheidet sich Spec-driven Development von Vibe Coding?
Beim Vibe Coding beschreibt man im Gespräch, was man möchte, und nimmt an, was gut aussieht. Beim Spec-driven Development steht vorher fest, wogegen geprüft wird. Für Prototypen reicht das erste, für Software im Betrieb braucht es das zweite.
Brauche ich dafür Spec Kit oder Kiro?
Brauche ich dafür Spec Kit oder Kiro?
Nein. Ein Issue mit Ziel, Akzeptanzkriterien, Grenzen und Prüfweg reicht für die meisten Aufgaben. Werkzeuge wie Spec Kit oder Kiro geben bei größeren Vorhaben einen festen Ablauf vor. Für kleine Änderungen erzeugen sie mehr Text, als nötig ist.
Wer schreibt die Spezifikation?
Wer schreibt die Spezifikation?
Wer die Anforderung verantwortet, mit Unterstützung von jemandem, der die Technik kennt. Der Agent kann einen Entwurf schreiben, so beschreibt es auch GitHub für Spec Kit. Prüfen und freigeben muss ihn ein Mensch, bevor die Umsetzung beginnt.
Ersetzt eine gute Spezifikation das Code-Review?
Ersetzt eine gute Spezifikation das Code-Review?
Nein. Sie macht das Review leichter, weil klar ist, wogegen geprüft wird. Agenten weichen trotz Spezifikation ab, legen Dinge doppelt an oder ändern mehr als verlangt. Deshalb endet jede Aufgabe mit einer Prüfung durch einen Menschen.
Quellen
Den Delimarsky, GitHub: Spec-driven development with AI: Get started with a new open source toolkit, 2. September 2025.
Birgitta Böckeler: Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl, 15. Oktober 2025.
GitHub: Spec Kit, Repository, Abruf 22.11.2026.
Kiro: Specs, Dokumentation, Abruf 22.11.2026.