DamianSpyra
Alle Artikel
Artikel

Was ist Spec-Driven Development?

· 13 Min. Lesezeit

Im ersten Teil dieser Reihe ging es um fünfzig Jahre Versuche, die Lücke zwischen dem Gewollten und dem Gebauten zu schließen. Neu war am Ende nur der Übersetzer: Ein Sprachmodell versteht Sätze statt Formeln oder Diagramme.

Dieser Teil fragt, was daraus im Alltag wird. Was ist eine Spezifikation für einen Agenten, wie läuft ein Durchgang ab, wer schreibt was, und wo geht es schief? Ich beantworte das nicht nur mit Begriffen, sondern an einem Beispiel, das ich selbst gebaut habe: dem News-Bereich dieser Seite. Er ist im Oktober 2026 nach genau diesem Verfahren entstanden, von der ersten Idee bis zum Livegang.

Warum reden gerade alle darüber?

Weil Agenten heute ganze Funktionen schreiben und der Engpass damit vom Tippen zum Beschreiben gewandert ist. Wer einem Agenten sagen kann, was genau gebaut werden soll, bekommt in Minuten, wofür früher Tage nötig waren. Wer es nicht kann, bekommt in Minuten etwas Falsches.

Entsprechend groß ist das Interesse. Die Beratung DevBoost hat mit 92 Tech Leads gesprochen, und nach Angaben von DevBoost war Spec-Driven Development dort das am häufigsten genannte Ziel für 2026. Rund 27 Prozent nannten einen solchen Ablauf konkret als Vorhaben, weniger als 5 Prozent hatten ihn strukturiert umgesetzt (DevBoost). Wie die Gespräche geführt wurden, legt DevBoost nicht offen, und das Unternehmen verkauft Schulungen zum Thema. Die Richtung der Zahlen deckt sich trotzdem mit dem, was ich sehe: Wollen ist verbreitet, Können ist selten.

Mein eigenes Beispiel zeigt, wo die Zeit hingeht. Für den News-Bereich waren sechs Arbeitsstunden geplant. Vom ersten Dokument bis zum Livegang vergingen vier Wochen. Gewartet wurde dabei fast nie auf Code, sondern auf Entscheidungen.

Woran scheitert es meistens?

Selten am Werkzeug. Meistens an einer Anforderung, die zu ungenau ist, an Wissen, das nur in Köpfen steckt, und an einem ersten Schritt, der zu groß gewählt wurde. So fasst DevBoost seine Gespräche zusammen, und es passt zu meiner Erfahrung.

Der erste Grund wiegt am schwersten. Ein Kollege füllt eine Lücke in der Anforderung mit Erfahrung und fragt nach, wenn ihm etwas seltsam vorkommt. Ein Agent füllt sie mit der Annahme, die am plausibelsten klingt, und arbeitet weiter. Das Ergebnis sieht vernünftig aus und ist trotzdem nicht das, was gemeint war. Addy Osmani kommt nach einer Auswertung von über 2 500 Anweisungsdateien für Agenten zum selben Schluss: Die meisten taugen nichts, weil sie zu vage sind (Osmani).

Eine Studie vom Oktober 2026 stützt das mit Daten aus 114 öffentlichen Projekten. Im Drittel mit den besten Spezifikationen waren 11,8 Prozent der Commits Fehlerbehebungen, im schwächsten Drittel 20,4 Prozent (Claudino u. a.). Die Autoren nennen das selbst einen Zusammenhang und keinen Beleg für eine Ursache. Ihre Diagnose passt trotzdem: Vorlagen sagen, wohin etwas gehört, aber nicht, wann genug dasteht.

Der zweite Grund ist unsichtbarer. Was ein Team über sein System weiß, steht selten irgendwo. Der Agent kennt nur, was man ihm gibt. Der dritte Grund ist der verständlichste: Wer mit dem wichtigsten Ablauf seines Produkts anfängt, lernt das Verfahren am teuersten Ort.

Was ist eine Spezifikation, und was ist sie nicht?

Eine Spezifikation ist ein strukturiertes Dokument in natürlicher Sprache, das beschreibt, wie sich eine Software verhalten soll, einen Agenten bei der Umsetzung anleitet und nach der Aufgabe liegen bleibt. Die Definition geht auf Birgitta Böckeler von Thoughtworks zurück, die in ihrer Reihe über generative AI die bislang brauchbarste Fassung aufgeschrieben hat (Böckeler).

Vier Merkmale stecken darin. Die Spezifikation hat eine Form und ist kein loser Text. Sie beschreibt Verhalten, keine Bauweise. Sie steht in normaler Sprache. Und sie richtet sich an einen Agenten, auch wenn Menschen sie lesen und freigeben. Böckeler beklagt selbst, dass der Begriff schon verwässert ist, weil manche jeden ausführlichen Prompt so nennen.

Vier Abgrenzungen helfen:

  • Kein langer Prompt. Ein Prompt ist verbraucht, sobald die Antwort da ist. Eine Spezifikation wird beim nächsten Mal wieder gelesen.
  • Keine modellgetriebene Entwicklung. Dort erzeugt dieselbe Beschreibung immer denselben Code. Ein Sprachmodell kann aus derselben Spezifikation zweimal Verschiedenes machen. Senacor vergleicht die AI deshalb mit einem Compiler und schränkt den Vergleich gleich wieder ein (Senacor).
  • Kein Übergabedokument. Roman Stranghöner von INNOQ beschreibt, wie Spezifikationen dicker werden, ohne dass jemand mehr versteht (INNOQ). Er stützt sich auf einen Gedanken von Jeff Patton: Ein gemeinsames Dokument ist noch kein gemeinsames Verständnis. Die Spezifikation hält fest, was im Gespräch entschieden wurde. Sie ersetzt das Gespräch nicht.
  • Kein Wasserfall. Dort wird die Anforderung einmal festgeschrieben. Hier wächst sie mit, wird geändert und bleibt im Repo neben dem Code.

Und Vibe Coding? Das ist das Gegenteil: bauen lassen, ohne vorher aufzuschreiben, was entstehen soll. Ob das manchmal die bessere Wahl ist, klärt der nächste Teil.

Wie weit gibt man den Code aus der Hand?

Das hängt davon ab, was mit der Spezifikation nach der Aufgabe passiert. Böckeler hat daraus im Oktober 2025 drei Stufen gemacht, die seither überall auftauchen.

  • Spec-first: Die Spezifikation wird vor der Aufgabe sorgfältig geschrieben und dient der Umsetzung. Danach hat sie ihren Zweck erfüllt.
  • Spec-anchored: Die Spezifikation überlebt die Aufgabe. Sie wird weiter gepflegt und bei jeder späteren Änderung an der Funktion wieder herangezogen.
  • Spec-as-source: Die Spezifikation ist die eigentliche Quelle. Der Mensch bearbeitet nur noch sie, den Code fasst er nicht mehr an.

Die Einteilung hat Karriere gemacht, oft ohne Böckelers Namen. Senacor beschreibt sie im Dezember 2025 fast gleichlautend, stellt eine vierte Stufe davor und nennt die Urheberin nicht. Auch ein Fachaufsatz vom Januar 2026 übernimmt die Begriffe.

Die Stufen sind keine Rangliste. Sie beschreiben, wie viel Vertrauen man dem Ergebnis schenkt, und je mehr es ist, desto genauer muss die Spezifikation sein. Mein eigener Workflow steht ehrlich gesagt eher auf der ersten Stufe mit gutem Gedächtnis als auf der zweiten. Spezifikation und Plan bleiben im Repo und werden nach der Abnahme archiviert. Ändert sich die Funktion später, pflege ich sie aber nicht weiter.

Was gehört ins Fundament?

Alles, was für jede einzelne Spezifikation gilt, gehört einmal in eine Datei im Repo, die jeder Agent zuerst liest. Das Spec Kit nennt sie Constitution, in vielen Projekten heißt sie AGENTS.md oder bei Claude Code CLAUDE.md.

Hinein gehört, was sonst jede Spezifikation neu verhandeln müsste: Sprache und Framework, die Teststrategie, Bibliotheken, die nicht verwendet werden dürfen, Regeln zur Sicherheit und wann eine Architekturentscheidung aufgeschrieben werden muss. DevBoost betont einen Punkt, den ich lange unterschätzt habe. Wer nicht ausdrücklich fachlich sinnvolle Tests verlangt, bekommt Tests, die durchlaufen und nichts beweisen.

Osmani ergänzt zwei Dinge. Gute Anweisungsdateien decken sechs Bereiche ab: Befehle, Tests, Projektstruktur, Codestil, Arbeitsweise mit Git und Grenzen. Und Grenzen wirken am besten in drei Stufen: was der Agent immer darf, was er vorher fragen muss und was er nie tun darf. Gleichzeitig warnt er vor dem Gegenteil. Je mehr Regeln in einer Anweisung stehen, desto schlechter befolgt das Modell jede einzelne.

Das Fundament dieser Seite besteht aus zwei Teilen. In den Projektregeln steht zum Beispiel, dass jeder Push auf den Hauptzweig sofort live geht. Daneben liegt eine Datei mit Lektionen, die mit jedem Fehler wächst und vor jedem Plan gelesen wird. Aus dem News-Bereich allein kamen vierzehn Regeln dazu.

Wie läuft ein Durchgang ab?

Erst das Was, dann das Wie, dann die Zerlegung, dann der Code. Nach jedem Schritt liegt etwas vor, das ein Mensch lesen und ablehnen kann, bevor daraus Größeres wächst.

Die Werkzeuge unterscheiden sich darin kaum. Kiro von Amazon führt durch Anforderungen, Entwurf und Aufgaben. Das Spec Kit von GitHub stellt die Constitution voran und geht dann über Spezifikation, Plan und Aufgabenliste zur Umsetzung. Der Sinn liegt in den Haltepunkten. Eine falsche Annahme in der Spezifikation kostet eine Minute. Dieselbe Annahme, dreihundert Zeilen später entdeckt, kostet den Nachmittag.

Zwei Regeln machen den Unterschied. Die erste: In die Spezifikation gehört keine Technik. Sobald dort eine Lösung steht, prüft niemand mehr, ob es die richtige Anforderung war. Die zweite: Die Umsetzung kommt in kleinen Stücken. Kleine Aufgaben halten den Kontext des Modells sauber, lassen sich mit günstigeren Modellen erledigen und geben klare Punkte zum Zurückspringen. DevBoost bringt das auf die Formel, dass Planen heute die eigentliche Arbeit ist.

Der Preis ist Papier. Böckeler hat erlebt, wie Kiro aus einem kleinen Fehler vier User Stories mit sechzehn Akzeptanzkriterien machte, und gibt zu, dass sie lieber Code prüft als all die Markdown-Dateien.

Beim News-Bereich sah die Kette so aus: eine Idee in der Inbox, eine Discovery mit Klärungsfragen, eine Spezifikation mit zwölf Erfolgskriterien, ein Plan mit fünf Phasen. Bevor die erste Zeile Code entstand, prüfte ein Review mit mehreren Rollen den Plan und fand fünf Lücken, darunter die Zeitzone für Datumsangaben. Jede Phase endete mit Prüfungen, die automatisch liefen, und einer Bestätigung durch mich. Am Ende standen zwei Reviews des fertigen Codes. Den ganzen Ablauf habe ich unter Spec-Driven Workflow beschrieben.

Welche Werkzeuge gibt es, und wo stehen sie?

Es gibt ein halbes Dutzend Werkzeuge, aber die Methode braucht keines davon. Für den Anfang reicht eine einzige Datei im Repo, darauf weist auch DevBoost hin. Stand: November 2026 sieht die Landschaft so aus:

  • Kiro von Amazon kam im Juli 2025 und warb als erstes großes Werkzeug offensiv mit dem Begriff. Inzwischen läuft es als Entwicklungsumgebung, auf der Kommandozeile und im Browser (Kiro).
  • Spec Kit von GitHub folgte im September 2025 und steht heute bei Version 1.2 (Spec Kit). Seit Juni 2026 bringt es einen Leitfaden für mitwachsende Spezifikationen und einen Befehl, der Code gegen die Spezifikation abgleicht. Für mich ist das die zweite Stufe unter anderem Namen. Das ist aber meine Einordnung, GitHub benutzt Böckelers Begriffe nicht.
  • OpenSpec in Version 1.16 und BMAD in Version 6.12 sind die bekanntesten freien Alternativen. OpenSpec gehört zu den wenigen Werkzeugen, die ausdrücklich auch mit bestehendem Code umgehen.
  • Tessl galt lange als das Werkzeug für die dritte Stufe. Heute beschreibt es sich als Plattform, um Skills für Agenten zu verwalten, und seine Dokumentation erwähnt Spezifikationen nicht mehr (Tessl).
  • Plannotator ist kein Rahmenwerk, sondern ein kleines freies Werkzeug. Damit markiert, kommentiert und kürzt man den Plan eines Agenten, bevor er ausgeführt wird (Plannotator). DevBoost setzt es genau dafür ein.

Thoughtworks bleibt zurückhaltend. Der Technology Radar führte Spec-Driven Development im November 2025 im Ring Assess, also ausprobieren und beobachten. Die Abläufe seien aufwendig und eigensinnig, und vielleicht lerne die Branche gerade neu, dass handgeschriebene Detailregeln für AI nicht skalieren (Thoughtworks). In der aktuellen Ausgabe des Radars steht der Eintrag nicht mehr.

Wer schreibt was, Mensch oder Agent?

Der Agent entwirft fast alles, der Mensch entscheidet an jedem Übergang und verantwortet das Ergebnis. DevBoost teilt es ähnlich auf. Der Mensch beschreibt, was er will, beantwortet Rückfragen und prüft Spezifikation, Plan und Code. Der Agent leitet daraus Anforderungen und Akzeptanzkriterien ab, fragt nach, plant und setzt um.

Beim News-Bereich war die Teilung so:

  • Vom Agenten: die Entwürfe von Discovery, Spezifikation und Plan, der gesamte Code, die Prüfskripte und die Reviews. Die Kandidaten für Einträge sammelt eine Routine, die jede Nacht läuft. Bis Anfang November waren es 59 Kandidaten an 26 Tagen.
  • Von mir: der Zuschnitt der Idee, die Antworten in der Discovery, die Entscheidung über jedes Finding, die Auswahl der Einträge, die Freigabe jedes Textes, die Bestätigung am Ende jeder Phase und der Livegang. Den Push auf den Hauptzweig darf der Agent gar nicht ausführen.

Ein Punkt gehört ehrlich dazu. Auch die Einordnungen in den Einträgen hat Claude entworfen. Ich habe jede geprüft und einzeln freigegeben. Auf der Seite steht, Auswahl und Einordnung seien von mir. Ob das so stimmt oder ob die Zeile genauer werden muss, habe ich noch nicht entschieden. Für mich zeigt das, wo die Grenze im Alltag wirklich liegt: nicht beim Tippen, sondern bei der Verantwortung.

Welche Fehler passieren am häufigsten?

Die meisten Fehler entstehen an den Übergängen, nicht in den Dokumenten. DevBoost nennt fünf, und alle fünf kenne ich:

  • Lösung statt Anforderung. Die Spezifikation beschreibt schon, wie gebaut wird. Dann prüft niemand mehr, ob das Was stimmt. In meinem Workflow bricht deshalb eine Prüfung das Speichern ab, sobald Produktnamen, Dateipfade oder Codebegriffe in der Spezifikation stehen.
  • Zu vage. Ohne prüfbare Kriterien hat der Agent keinen Anker. Feste Satzmuster für Anforderungen helfen, etwa die EARS-Schablone.
  • Kein Fundament. Ohne projektweite Regeln verhandelt jede Spezifikation dieselben Grundsätze neu.
  • Spezifikation außerhalb des Repos. In einem Wiki oder Ticketsystem veraltet sie innerhalb eines Sprints. Sie gehört versioniert neben den Code.
  • Kein Mensch an den Übergängen. Wer Spezifikation, Plan und Code nicht prüft, betreibt Vibe Coding und hat nur eine Spezifikation davorgestellt.

Zwei eigene Fehler kommen dazu. Der erste: Prüfen nur am Ende reicht nicht. Beim News-Bereich hatte das Plan-Review fünf Lücken gefunden, und trotzdem lehnte das erste Review des fertigen Codes ab. Ein großgeschriebenes Feld im Kopf eines Eintrags wurde still ignoriert, und damit hätte ein Entwurf live gehen können. Seitdem bricht jedes unbekannte Feld den Bau ab. Der zweite: Lange Branches veralten. In den vier Wochen musste ich den Hauptzweig fünfmal in den Feature-Branch nachziehen. Eine neue Sitzung auf dem Branch hätte sonst mit einem veralteten Stand weitergearbeitet.

Was ändert sich für die Arbeit?

Das Programmieren verschwindet nicht, aber der Engpass wandert dorthin, wo entschieden wird, was gebaut werden soll. Simon Martinelli, ein Berater aus der Schweiz, beschreibt das an einem Projekt für das Schweizer Parlament (Vortrag). Er ist der Einzige, der Code anfasst, und die zwei Product Owner haben inzwischen mehr zu tun als er. Der Takt hat sich verschoben. Früher wechselten zwei Wochen Anforderungen und zwei Wochen Umsetzung, heute folgen auf zwei Wochen Klärung fünf Minuten Umsetzung.

DevBoost zieht daraus eine Warnung für Teams. Wer nicht genau hinsieht, wird von der AI geführt statt umgekehrt. Ich teile das. Mein News-Bereich hat nicht wegen des Codes vier Wochen gebraucht, sondern weil Entscheidungen auf mich warteten. Das ist kein Mangel des Verfahrens. Das ist genau die Arbeit, die übrig bleibt.

Was wird häufig gefragt?

Brauche ich dafür ein Werkzeug?

Nein. Eine Markdown-Datei mit der Spezifikation und eine mit den Projektregeln reichen für den Anfang. Werkzeuge wie das Spec Kit nehmen Schreibarbeit ab, kosten aber Einarbeitung und viele Tokens.

Ist das nicht einfach Wasserfall?

Nein. Im Wasserfall wird die Anforderung einmal geschrieben und dann abgearbeitet. Hier entsteht die Spezifikation für ein kleines Stück, wird geprüft, umgesetzt und bei Bedarf geändert. Ein Durchgang dauert Stunden oder Tage, nicht Monate.

Lohnt sich das auch für kleine Aufgaben?

Für einen Tippfehler nicht. Ab einer Änderung, die mehrere Dateien berührt oder eine Entscheidung enthält, lohnt sich mindestens eine kurze Spezifikation. Mein Workflow hat dafür einen schnellen Weg, der Discovery, Spezifikation und Plan in einem Durchgang bündelt.

Wie lang sollte eine Spezifikation sein?

So kurz, dass ein Mensch sie in wenigen Minuten prüfen kann. Mehr Text bedeutet nicht mehr Klarheit, denn das Modell befolgt einzelne Regeln schlechter, je mehr es sind. Lieber eine knappe Spezifikation pro Funktion als ein dickes Dokument für alles.

Was ist der Unterschied zu einem guten Prompt?

Ein Prompt gilt für eine Antwort. Eine Spezifikation gilt für eine Funktion, liegt im Repo und wird geprüft, bevor gebaut wird. Sie überlebt die Sitzung und dient beim nächsten Mal als Ausgangspunkt.

Funktioniert das auch mit bestehendem Code?

Ja, aber der Einstieg ist teurer, weil das Wissen über das System erst aufgeschrieben werden muss. Für das Spec Kit gibt es erste Erweiterungen aus der Community, die aus vorhandenem Code Spezifikationen ableiten. Das ist ein eigenes Thema.

Wie fange ich an?

Mit einer Funktion, die abgegrenzt und nicht geschäftskritisch ist. Erst die Projektregeln aufschreiben, dann eine kurze Spezifikation. Danach den Agenten einen Plan machen lassen und diesen Plan gründlich lesen, bevor eine Zeile Code entsteht.

Wie geht es weiter?

Wie mein eigener Ablauf im Detail aussieht, mit allen Schritten und dem aktuellen Stand meines Workflow-Kits, steht unter Spec-Driven Workflow. Im nächsten und letzten Teil dieser Reihe geht es um die Frage, die über allem steht: Wann lohnt sich der ganze Aufwand, und wann baut man besser einfach drauflos?