Zum Inhalt springen
Reality Graph

Methode

Spezifikationsgetriebene Entwicklung (SDD)

Zuletzt aktualisiert: 2026-07-17Lesezeit ca. 3 Min.

Spec-Driven Development (SDD) macht Anforderungen, Design, Tasks und Akzeptanzkriterien vor der Generierung explizit. Eine Spezifikation kann Klarheit verbessern, ohne vollständig oder korrekt zu sein; Implementierung, Tests, Verifikation und Betriebsbelege bleiben eigene Artefakte und Entscheidungen.

„Tests laufen durch“vom Agenten gemeldetexit code 0von Reality Graph gestartetBelegnur die Ausführung zählt
Inhalt

Woher SDD kommt

SDD entstand 2025 als direkte Gegenbewegung zum Prompt-und-Hoffnung-Coding: Agenten erzeugen plausiblen Code, der von der Absicht wegdriftet, APIs erfindet und mit wachsendem Projekt zerfällt. Der vorgeschlagene Fix ist altmodisch und radikal zugleich - vor der Generierung eine schriftliche Spezifikation abstimmen und sie während der Umsetzung verbindlich halten. 2026 liefert jedes große Tool-Ökosystem eine SDD-Variante; GitHubs Spec Kit dokumentiert den Open-Source-Workflow; Support und Popularität sind veränderliche Anbieterfakten, daher bewertet die aktuelle Version direkt.

Die Bewegung bestätigt, was diese Seite von der Verifikationsseite her argumentiert: Das fehlende Artefakt im KI-Coding ist die schriftliche Absicht. SDD baut dieses Artefakt auf Feature-Ebene; prüfbare Vorgaben bauen es auf Run-Ebene. In der Mitte treffen sich die Philosophien.

Wie der Workflow konkret aussieht

  1. Requirements. Was das Feature leisten muss, als User Stories mit Akzeptanzkriterien - in Kiros Fluss die erste von drei Gate-Phasen, im Spec Kit der /specify-Schritt.
  2. Design. Architekturentscheidungen, Datenmodelle, Schnittstellen - abgestimmt, bevor Code existiert, damit der Agent Entscheidungen erbt statt sie still zu treffen.
  3. Tasks. Das Design in kleine, geordnete, einzeln reviewbare Arbeitspakete zerlegt - die Einheit, die ein Agent ausführt.
  4. Implementierung gegen die Spezifikation. Der Agent codiert Task für Task; Menschen reviewen gegen die abgestimmten Dokumente, statt Absicht aus Diffs zu rekonstruieren.

Anbieter- und Praxisberichte beschreiben Nutzen in ausgewählten Setups, belegen aber kein allgemeines Produktivitätsergebnis. Der sekundäre Leitfaden fasst Beispiele zusammen; Grenzen bei Setup, Zuordnung und Messung verlangen eine eigene datierte Baseline für Dokumentationsaufwand, Nacharbeit, Fehler und Review-Last.

Das Tooling, ehrlich verglichen

GitHub Spec KitAWS KiroLeichte Pro-Run-Vorgabe
FormOpen-Source-CLI + Templates, agent-agnostisch (30+ Agenten).Agentische IDE mit Gate-Fluss Requirements → Design → Tasks.Wenige Zeilen pro Run: Ziel, Grenzen, Kriterien.
Am stärksten beiFeature-Arbeit über gemischte Toolchains; Community-Momentum.Geführter, integrierter Fluss - das klarste mentale Modell der drei.Bugfixes und Einzel-Run-Aufgaben; null Setup.
Am schwächsten beiKleinen Fixes - die Zeremonie erdrückt die Änderung.Wortfülle: Praktiker nennen es „viel zu verbos für einen kleinen Bug“.Mehr-Run-Features - kein Design-Gedächtnis zwischen Runs.
Verifikations-StoryDie Spezifikation definiert den Plan; das Ergebnis dagegen zu prüfen bleibt eure Arbeit.Ebenso - die Phasen gaten die Planung, nicht die Prüfung nach dem Run.Fließt direkt in den Soll-Ist-Abgleich.
Spec Kit, Kiro und leichte Pro-Run-Vorgaben lösen dasselbe Problem in verschiedenen Gewichtsklassen - die richtige Wahl hängt an der Aufgabengröße, nicht an der Ideologie.

Ehrliche Grenzen - von Leuten, die es benutzt haben

  • Agenten gehorchen ihren eigenen Spezifikationen nicht zuverlässig. Die Fowler-Team-Analyse hält fest: Trotz aller Templates und Checklisten „hat der Agent am Ende nicht alle Anweisungen befolgt“ - ein geschriebener Plan ist kein erzwungener Plan.
  • Dokumenten-Review kann Code-Review übersteigen. Mehrere Praktiker berichten, sie würden lieber den Code reviewen als drei Markdown-Dateien darüber. SDD verlagert Aufwand nach vorn; es beseitigt ihn nicht.
  • Spezifikationen altern. Eine ungepflegte Spezifikation wird zu selbstbewusst falscher Dokumentation - schlimmer als keine, weil sie verbindlich aussieht.
  • SDD plant vorwärts; es prüft nicht rückwärts. Der Workflow gated, was gebaut wird - aber die Frage „entspricht der gemergte Code wirklich der Spezifikation?“ braucht weiterhin einen unabhängigen Soll-Ist-Abgleich - gerade wegen des ersten Punkts oben.

Wo Reality Graph ansetzt

SDD und Reality Graph greifen dieselbe Lücke von entgegengesetzten Enden an. SDD macht die Absicht vor der Generierung explizit. Reality Graph verifiziert das Ergebnis danach gegen die Absicht - mit Grenzprüfung, Validierung, die das Modell nicht verfasst hat, und einem Prüfbericht pro Run. Teams mit Spec Kit oder Kiro bringen exzellente Solls mit. Reality Graph überführt sie in die Vorgabe, an der ein einzelner Run gemessen wird, und schließt die Schleife, die diese Tools offen lassen.

SDD liefert

  • Abgestimmte Anforderungen und Design vor der Generierung
  • Explizite Anforderungen, Annahmen und Akzeptanzkriterien für Reviews
  • Reviewbare Arbeitspakete statt monolithischer Diffs
  • Eine gemeinsame Referenz für Menschen und Agenten

Es leistet nicht

  • Gehorsam der Agenten - Runs brauchen weiterhin Verifikation
  • Nutzen bei kleinen Fixes - Zeremonie richtig dosieren
  • Selbstpflege - Spezifikationen altern ohne Betreuung
  • Ersatz für Tests, Review oder ein menschliches Merge-Gate

Wenn diese Grenzen zu eurem Team passen:

FAQ

Was ist Spec-Driven Development und wie funktioniert es mit KI-Agenten?
Spec-Driven Development (SDD) macht Anforderungen, Designentscheidungen, Aufgabenzerlegung und Akzeptanzkriterien vor der Generierung explizit. Tools wie GitHub Spec Kit und AWS Kiro strukturieren diese Artefakte in Phasen. Die Spezifikation bleibt ein von Menschen verantwortetes Modell, das unvollständig, mehrdeutig, veraltet oder falsch sein kann; sie leitet die Implementierung, garantiert sie aber nicht.
Was unterscheidet SDD von prüfbaren Auftrags-Vorgaben?
Gleiche Philosophie, andere Gewichtsklasse. Eine prüfbare Vorgabe ist ein leichtes Pro-Run-Artefakt mit Ziel, Grenzen und Kriterien; SDD kann Anforderungen, Design und Tasks eines Features umfassen. Keine Form ist automatisch vollständig oder maschinell prüfbar: Schemas, Akzeptanzchecks und Tests decken nur kodierte Eigenschaften ab.
Ersetzt Spec-Driven Development Tests?
Nein. Die Spezifikation definiert, was gelten muss; Tests sind ein Weg, es zu prüfen. SDD-Tools erzeugen Aufgabenlisten, die üblicherweise Tests einschließen - aber eine Spezifikation, gegen die niemand validiert, bleibt ein Plan und kein Nachweis. Der Verifikationsschritt ist eigene Arbeit, egal welches Tool die Spezifikation geschrieben hat.
Lohnt sich SDD für kleine Teams?
Selektiv. Workflow-Passung, Aufgabengröße, Spezifikationsqualität und Review-Aufwand unterscheiden sich je Team. Anbieter- und Praxisbeispiele sind Beobachtungen einzelner Setups, keine Produktivitätsgarantie. Messt Dokumentationsaufwand, Nacharbeit, Fehler und Review-Last gegen eine lokale Baseline, bevor ihr eine allgemeine Vorgabe ableitet.
Was sind die Hauptkritikpunkte an SDD?
Drei kehren in Praxisberichten wieder. Der Dokumenten-Overhead erdrückt kleine Aufgaben. Agenten folgen ihren eigenen Spezifikationen nicht zuverlässig („der Agent hat am Ende nicht alle Anweisungen befolgt“). Mehrere Markdown-Dateien zu reviewen kann mehr Arbeit sein als der Code selbst. Keiner dieser Punkte erledigt die Idee - sie sprechen für richtiges Dosieren und für eine Verifikation unabhängig von der Spec-Pipeline.
Welches SDD-Tool sollten wir zuerst ausprobieren?
GitHub dokumentiert Spec Kit als Open-Source-Toolkit; AWS dokumentiert Kiros Requirements-Design-Tasks-Fluss. Produktsupport und Integrationen ändern sich, daher gilt die datierte Anbieterdokumentation der evaluierten Version. Wählt über einen begrenzten Versuch und verifiziert die resultierende Implementierung unabhängig.

Weiterlesen

Quellen

Wollt ihr sehen, wie euer letzter Agenten-Run ausgesehen hätte?

Zugang anfragen