Spezifikationsgetriebene Entwicklung für KI-Agenten
SpecScore ist ein offenes, lintbares Dateiformat für Spezifikationen, geschrieben in Markdown und YAML (YAML Ain't Markup Language), mit einer Befehlszeilenschnittstelle (CLI), die sie prüft. Spezifikationsgetriebene Entwicklung (Spec-Driven Development, SDD) ist eine Praxis, bei der eine schriftliche, testbare Spezifikation – Anforderungen und Akzeptanzkriterien – die Quelle der Wahrheit ist, gegen die Code gebaut und verifiziert wird. Statt direkt von einem Prompt oder einem Ticket zum Code überzugehen, vereinbart man zuerst, was die Software tun soll, und baut anschließend nach dieser Spezifikation. Da KI-Agenten heute einen Großteil des Codes schreiben, sorgt die Spezifikation dafür, dass sie das Richtige bauen.
- Die Spezifikation ist die Quelle der Wahrheit; Code wird aus ihr abgeleitet und gegen sie geprüft.
- Anforderungen werden von expliziten Akzeptanzkriterien begleitet – „fertig“ ist testbar, nicht subjektiv.
- KI-Agenten fragen die Spezifikation nach der Absicht ab, statt sie aus dem Code zu erraten – weniger Fehlbauten.
- Es ergänzt testgetriebene Entwicklung (TDD), ersetzt sie aber nicht.
Was ist spezifikationsgetriebene Entwicklung?
Spezifikationsgetriebene Entwicklung kehrt die übliche Arbeitsreihenfolge um. Anstatt die Spezifikation als nachträgliche Dokumentation zu behandeln – oder sie ganz wegzulassen –, macht SDD die Spezifikation zum primären Artefakt. Code, Tests und Reviews beziehen sich alle direkt auf sie.
Eine Spezifikation in diesem Sinne ist keine endlose Textwand. Sie ist strukturiert: eine Menge vonAnforderungen (Requirements), jede mit expliziten Akzeptanzkriterien (Acceptance Criteria), die in testbaren Begriffen beschreiben, was erfüllt sein muss, damit die Anforderung als abgeschlossen gilt. Diese Struktur ermöglicht es Reviewern, Test-Suiten und KI-Agenten gleichermaßen, dasselbe Dokument auf dieselbe Weise zu interpretieren.
Die Spezifikation ist zudem ein lebendiges Artefakt. Wenn sich Anforderungen ändern, wird zuerst die Spezifikation angepasst und der Code folgt danach – so driftet die Spezifikation nie zur Fiktion ab.
Warum es jetzt wichtig ist: KI erhöht die Einsätze
KI-Coding-Agenten erzeugen Code viel schneller, als ein Mensch ihn lesen kann. Das verschiebt den Engpass. Der schwierige Teil ist nicht mehr das Schreiben der Implementierung – sonderndie Absicht so präzise zu spezifizieren, dass der generierte Code genau der Code ist, den du wolltest. Ein Agent, der mit einem vagen Prompt gefüttert wird, liefert mit hoher Zuverlässigkeit etwas Plausibles, aber Falsches – und das in Maschinengeschwindigkeit.
Die Spezifikation dient als Leitplanke. Wenn das beabsichtigte Verhalten und die Akzeptanzkriterien schriftlich fixiert sind, hat der Agent ein unmissverständliches Ziel, auf das er hinarbeiten kann, und eine Checkliste zur Verifizierung – und ein menschlicher Reviewer hat eine feste Grundlage zur Freigabe, bevor auch nur eine Zeile Code existiert. SDD ist der Weg, wie Teams verhindern, dass KI-Geschwindigkeit in KI-Nacharbeit umschlägt.
Wie spezifikationsgetriebene Entwicklung funktioniert
Der Workflow ist eine Schleife, kein einmaliges Dokument:
- Absicht erfassen. Halte die grobe Richtung fest – das Problem, das Ziel, offene Fragen –, bevor du dich auf eine Lösung festlegst.
- Verhalten spezifizieren. Übertrage die vereinbarte Richtung in Anforderungen, jede mit expliziten, testbaren Akzeptanzkriterien.
- In einen Plan zerlegen. Teile die Spezifikation in geordnete Aufgaben auf, von denen jede die Akzeptanzkriterien nennt, die sie erfüllt.
- Implementieren. Setze Aufgabe für Aufgabe um – ob Mensch oder KI-Agent – immer entlang der Spezifikation.
- Gegen Kriterien verifizieren. Prüfe das Ergebnis gegen die Akzeptanzkriterien, nicht nach Bauchgefühl.
- Spezifikation lebendig halten. Wenn sich Anforderungen ändern, aktualisiere zuerst die Spezifikation; der Code folgt.
Vorteile spezifikationsgetriebener Entwicklung
- Meinungsverschiedenheiten werden während des Spezifikations-Reviews sichtbar – kostengünstig – statt nach der Implementierung – teuer.
- „Fertig“ ist objektiv, weil die Akzeptanzkriterien überprüfbar sind.
- Die Spezifikation ist der gemeinsame Kontext für alle: Produkt, Entwicklung und KI-Agenten.
- Änderungen bleiben nachvollziehbar – jede Aufgabe verweist auf die Kriterien, die sie erfüllt.
Warum es speziell KI-Agenten hilft
- Maschinenlesbare Absicht: Der Agent liest Anforderungen direkt aus, anstatt sie aus Code zu erraten.
- Weniger Kontext zu laden: Der Agent ruft nur den relevanten Teil der Spezifikation ab, statt das gesamte Repository einzulesen.
- Verifizierbares Ergebnis: Akzeptanzkriterien geben dem Agenten ein klares Pass/Fail-Ziel.
- Rückverfolgbarkeit: Generierter Code lässt sich direkt auf die Anforderung zurückführen, die ihn veranlasst hat.
Spezifikationsgetriebene Entwicklung im Vergleich
| Praxis | Quelle der Wahrheit | Verhältnis zu SDD |
|---|---|---|
| Testgetriebene Entwicklung (TDD) | Fehlschlagende Tests auf Code-Ebene | Ergänzend – Akzeptanzkriterien werden zu Tests. |
| Klassisches PRD | Fließtext für Menschen | Weniger strukturiert; nicht direkt testbar oder maschinenlesbar. |
| Reines Prompting („Vibe Coding“) | Der Prompt und die Vermutung des Modells | Kein dauerhaftes, überprüfbares Ziel – genau das, was SDD löst. |
Einen detaillierten Vergleich von SpecScore mit anderen Spezifikations-Tools findest du aufunserer Vergleichsseite.
Außerdem die Vergleiche mit Kiro, Tessl, BMAD Method, Task Master AI.
Für die Werkzeuge als Ganzes — GitHub Spec Kit, OpenSpec, Kiro und die übrigen — siehedie besten Werkzeuge für spezifikationsgetriebene Entwicklung 2026.
Wie man Akzeptanzkriterien schreibt, die ein KI-Agent prüfen kann, steht inAkzeptanzkriterien schreiben.
Die EARS-Satzmuster, die Kiro für Anforderungen verwendet, stehen in EARS-Anforderungssyntax.
Wie diese Spezifikation in der kontinuierlichen Integration gelintet wird, steht in Spezifikationen in CI linten.
Eine Markdown-Vorlage für eine Feature-Spezifikation — ein Produktanforderungsdokument (PRD) mit Anforderungen, Akzeptanzkriterien, einem Plan und Aufgaben — steht in PRD-Vorlage in Markdown.
Spec-driven Development mit Claude Code und Cursor — was in die Feature-Datei gehört, was specscore agent setup schreibt und wie specscore spec lint in der Schleife und in der CI läuft — steht in Spec-driven Development mit Claude Code und Cursor.
Kompromisse und wann man es nicht nutzen sollte
Spezifikationsgetriebene Entwicklung ist nicht kostenlos. Sie verlagert den Aufwand nach vorne – in das Nachdenken und Aufschreiben, bevor Code ausgeführt wird. Für ein einmaliges Wegwerfskript oder ein schnelles Experiment ist das der falsche Tausch. Zudem hilft eine Spezifikation nur, wenn sie gepflegt wird – eine veraltete Spezifikation stiftet Verwirrung und ist schlimmer als gar keine. SDD zahlt sich aus, wenn die Arbeit planungsbedürftig ist, langfristig gewartet werden soll oder an einen KI-Agenten zur Umsetzung übergeben wird.
Spezifikationsgetriebene Entwicklung mit KI in der Praxis
Um SDD mit KI-Agenten zu betreiben, brauchst du zwei Dinge: ein maschinenlesbares Spezifikationsformat, das dein Team und deine Agenten gleichermaßen verstehen, und einen Weg für Agenten, diese Spezifikationen zu lesen, zu schreiben und zu validieren.
SpecScore ist genau das. Es ist ein offenes Markdown + YAML-Format für Features, Anforderungen und Akzeptanzkriterien – einfache Dateien in deinem Repository –, kombiniert mit einer CLI, die deine Agenten aufrufen, um Spezifikationen abzufragen, zu bearbeiten und zu linten. Weil die Struktur maschinenlesbar ist, kann ein Agent fragen: „Woran sollte ich als Nächstes bauen?“, erhält die offenen Anforderungen mit ihren Akzeptanzkriterien und prüft seine Arbeit dagegen ab. Es ist werkzeugagnostisch und Open Source.
Starte mit den KI-Skills für deinen Coding-Agenten oderinstalliere die CLI.
Häufig gestellte Fragen
Ist spezifikationsgetriebene Entwicklung dasselbe wie testgetriebene Entwicklung?
Nein. TDD steuert die Implementierung anhand fehlschlagender Tests auf Code-Ebene. Spezifikationsgetriebene Entwicklung setzt eine Ebene höher an: Sie fixiert zuerst das beabsichtigte Verhalten und die Akzeptanzkriterien in einer schriftlichen Spezifikation. Sie ergänzen sich gegenseitig – die Akzeptanzkriterien einer Spezifikation werden oft zu den Tests, die dann das TDD steuern.
Verlangsamt einen spezifikationsgetriebene Entwicklung?
Sie erfordert Zeit, bevor Code geschrieben wird, und spart Zeit ein, die sonst für das Umbauen falscher Lösungen draufgeht. Für Wegwerf-Skripte lohnt sich der Aufwand nicht. Für alles, was ein KI-Agent in größerem Umfang generiert oder was ein Team langfristig pflegen muss, ist das Vorab-Schreiben der Spezifikation von Anfang bis Ende meist schneller.
Was ist der Unterschied zwischen einer Spezifikation und einem PRD?
Ein PRD ist meist Fließtext für Menschen. Eine Spezifikation in der spezifikationsgetriebenen Entwicklung ist strukturiert und testbar – diskrete Anforderungen mit expliziten Akzeptanzkriterien –, sodass sowohl menschliche Reviewer als auch KI-Agenten präzise danach handeln können.
Wie nutzen KI-Coding-Agenten eine Spezifikation?
Wenn die Spezifikation maschinenlesbar ist, fragt der Agent gezielt die für seine aktuelle Aufgabe relevanten Anforderungen und Akzeptanzkriterien ab, statt die gesamte Codebasis einzulesen. Anschließend prüft er sein Ergebnis gegen diese Kriterien – ein Schutzschild gegen plausiblen, aber falschen Code.
Was ist SpecScore?
SpecScore ist ein offenes, lintbares Dateiformat für Spezifikationen in Markdown und YAML, mit einer Befehlszeilenschnittstelle (CLI), die diese Dateien abfragt, bearbeitet und lintet. Das Format liegt im öffentlichen Repository specscore/specscore.
Unter welcher Lizenz steht SpecScore?
Spezifikation und Dokumentation im öffentlichen Repository specscore/specscore stehen unter CC BY 4.0. Die Referenz-Befehlszeilenschnittstelle (CLI) in specscore/specscore-cli steht unter Apache-2.0.
Verlangt spezifikationsgetriebene Entwicklung einen KI-Anbieter?
Nein. Spezifikationen sind Textdateien im Repository. Die CLI ist ein lokales Programm. Die AI Skills auf dieser Website kapseln diese CLI für Agenten, die Skills ausführen können. Das Format verlangt keinen einzelnen Anbieter.
Wie installiere ich die CLI?
Die Installationsanleitung steht unter /de/cli/install/, der Einstieg über die AI Skills. Das CLI-Programm kommt aus specscore/specscore-cli.