/ Wissenshub /

Specification Driven Development umsetzen: Architektur und Prozesse

Business 18/05/2026

Specification Driven Development (SDD) in einer technischen Organisation einzuführen, markiert den Übergang von passiver Dokumentation zu aktiven, ausführbaren Verträgen. In diesem Modell dient die Spezifikation als einzige verlässliche Quelle, die die Qualitätssicherung automatisiert und verteilte Teams synchronisiert.

Wenn Sie mehr darüber erfahren wollen, was SDD ist und wie es in Ihrer Organisation wirken kann, lesen Sie den vorherigen Artikel der Reihe: Specification Driven Development: planbare Entwicklung. In diesem Artikel gehen wir in die Tiefe.

SDD in verteilten Systemen: Microservices und Event-Driven-Architektur

In modernen IT-Landschaften treten Fehler am häufigsten an den Integrationspunkten zwischen Diensten auf. SDD mindert dieses Risiko, indem es Schnittstellen und Kommunikationsprotokolle strikt festlegt.

Consumer-Driven Contracts (CDC) – Kompatibilität garantieren

Consumer-Driven Contracts (CDC) ist eine Technik, bei der der API-Client (Consumer) seine Anforderungen an den Server (Provider) definiert.

  • So funktioniert es: Der Client erstellt eine Spezifikation, etwa mit Pact, die für den Server zum verbindlichen Test wird.
  • Der Nutzen: Eine Backend-Entwicklerin kann kein Datenbankfeld entfernen, wenn der Vertrag zeigt, dass die mobile App weiterhin darauf angewiesen ist. Damit verschwinden Breaking Changes, bevor sie die Produktion erreichen.

Ereignisse spezifizieren und der AsyncAPI-Standard

In ereignisgetriebenen Systemen wie Kafka oder RabbitMQ sind Spezifikationen entscheidend, um Datenchaos zu vermeiden.

  • AsyncAPI: der Branchenstandard, mit dem im SDD Nachrichtenstrukturen (Payloads), Kanäle und Protokolle definiert werden.
  • Anwendung: Statt Code rückwärts zu analysieren, konsultiert die Entwicklung den Vertrag. Das erlaubt eine automatisierte Prüfung der Nachrichten und verhindert Fehler durch vergiftete Nachrichten.

Mocks auf Vertragsbasis

Im SDD lösen wir uns von handgeschriebenen, dummen Mocks zugunsten von aus der Spezifikation erzeugten Mocks.

  • Der Mechanismus: Werkzeuge wie Prism erzeugen eine Mock-API, die stets mit dem aktuellen Vertrag übereinstimmt.
  • Die Wirkung: Ändert sich die Spezifikation, schlägt der Mock in der Testumgebung automatisch fehl und zwingt die Entwicklung, den Code zu aktualisieren, bevor er die CI/CD-Pipeline erreicht.

Das Modell Spec-as-Code

Der Ansatz Spec-as-Code bedeutet, technische Spezifikationen mit derselben Strenge zu behandeln wie den Quellcode der Anwendung.

Eine einzige verlässliche Quelle

Die Verbindung von .feature-Dateien (BDD-Szenarien) mit technischen Definitionen wie OpenAPI/Swagger schafft ein einheitliches Ökosystem.

  • Automatisierung: Die Spezifikation wird zur Grundlage von Codegeneratoren wie Swagger Codegen. So sind TypeScript-Interfaces oder Java-Klassen stets ein direktes Abbild der aktuellen fachlichen Annahmen.

Versionierung der Verträge und Code Review

Technische Spezifikationen gehören in eine Versionsverwaltung (Git).

  • Transparenz: Jede Vertragsänderung durchläuft ein Code Review. Tech Leads verfolgen die Entwicklung der API und erkennen brechende Änderungen an Datentypen, bevor sie andere Microservices treffen.
  • SemVer: Semantische Versionierung der Spezifikationen ermöglicht reibungslose Migrationspfade zwischen API-Versionen.

Automatisierte Schemaprüfung

Eine tragende Säule des SDD ist die automatisierte Konformitätsprüfung.

  • CI/CD-Integration: Im Build prüft das System, ob der Code die in der Spezifikation definierten Schemaanforderungen erfüllt. Nutzt jemand den Feldnamen user_id statt des geforderten userId, wird der Build automatisch blockiert (Quality Gate).

Der Shift-Left-Workflow – Prüfung und Rollen optimieren

Der Shift-Left-Ansatz verlagert Tests und Prüfungen in die frühestmögliche Phase des Softwarelebenszyklus (SDLC).

Three Amigos 2.0

Im SDD-Modell mündet das Treffen der „Three Amigos“ (Fachbereich, Entwicklung, Test) in einen technischen Entwurf der Spezifikation.

  • Definition of Ready (DoR): Eine Aufgabe geht erst in die Entwicklung, wenn ein geprüfter technischer Vertrag vorliegt. Das verkürzt die Time-to-Market, weil Mehrdeutigkeit von Anfang an entfällt.

Aus QA wird Quality Engineering (QE)

Die Rolle der manuellen Testerin entwickelt sich zur Quality Engineer (QE).

  • Aufgaben: Statt manueller Regressionstests entwirft die QE Verträge und Grenzfallszenarien innerhalb der Spezifikation. Aus der Testerin wird eine Hüterin der systemischen Widerspruchsfreiheit statt einer nachträglichen Fehlerjägerin.

Neue Maßstäbe für die Definition of Done (DoD)

Die Einführung von SDD erfordert neue Abschlusskriterien für Aufgaben:

  • DoD im SDD: Eine Aufgabe ist erst erledigt, wenn die Umsetzung alle Vertragstests besteht und zu 100 % der Spezifikation entspricht. So ist jedes neue Codestück reif für die nahtlose Integration.

FAQ: Specification Driven Development umsetzen

Was sind Consumer-Driven Contracts (CDC)?

CDC ist eine SDD-Methode, bei der der API-Client Tests für den Server definiert und damit sicherstellt, dass Backend-Änderungen weder das Frontend noch andere abhängige Dienste zerstören.

Welche Vorteile bietet Spec-as-Code?

Die wichtigsten Vorteile sind automatisierte Codeerzeugung, lebendige Dokumentation in Git und das frühzeitige Erkennen von Integrationsfehlern.

Ersetzt SDD manuelle Tests?

SDD verringert den Bedarf an manuellen Integrationstests drastisch und erlaubt es den QA-Teams, sich auf übergeordnete UX-Fragen und komplexe Geschäftslogik zu konzentrieren.