Spec-Driven Development

Heißt auch SDD.

Arbeitsweise, bei der eine versionierte Spezifikation das führende Artefakt ist und Code daraus entsteht.

Bei Spec-Driven Development ist die Spezifikation das führende Artefakt und der Code das abgeleitete. Sie liegt versioniert im Repository, wird wie Code geändert und dient als Maßstab dafür, ob ein Ergebnis abgenommen wird. Die Kurzform SDD ist gebräuchlich. Piskala

Der Ablauf hat vier Schritte

Die verbreitete Form zerlegt die Arbeit in Beschreiben, Planen, Zerlegen und Umsetzen. Zuerst entsteht die Spezifikation mit Nutzungsabläufen und Abnahmekriterien, dann die technische Festlegung auf Stack und Randbedingungen, dann die Aufteilung in kleine prüfbare Aufgaben, und erst am Schluss schreibt ein Agent Code. GitHub

Der Grund für diese Reihenfolge ist banal: Eine vage Anweisung zwingt das Modell, hunderte ungesagte Anforderungen zu raten. Es rät plausibel, und niemand merkt, an welcher Stelle es danebenlag.

Es gibt drei Härtegrade, nicht einen

Spec-First heißt, die Beschreibung steht am Anfang und darf danach veralten. Spec-Anchored heißt, sie bleibt verbindlich und wird bei jeder Änderung mitgeführt. Spec-As-Source heißt, sie ist die einzige Quelle und der Code gilt als Ausgabe, die jederzeit neu erzeugt werden darf. Welcher Grad angemessen ist, hängt davon ab, wie lange die Software leben soll. Piskala

So kannst du dir das vorstellen

Ein Bauantrag statt einer Skizze auf einer Serviette. Der Antrag zwingt dazu, Maße und Auflagen vorher festzulegen, und danach lässt sich streiten, ob gebaut wurde wie vereinbart. Das Bild erklärt die Rolle des Dokuments, es sagt nichts darüber, ob das Haus gut wird.

Was es in der Praxis konkret bedeutet

Fang mit einem Härtegrad an, den du durchhältst. Eine Spezifikation, die nach drei Wochen nicht mehr stimmt, ist schlechter als keine, weil ein Agent sie trotzdem als verbindlich behandelt. Prüfe deshalb bei jeder Änderung zuerst, ob die Beschreibung noch passt, und erst danach den Code.

Wo es verwechselt wird

Specificational Coding beschreibt dieselbe Grundhaltung als Arbeitsstil, SDD ist der benannte Ablauf mit Werkzeugunterstützung. Und eine Spezifikation ersetzt keine Tests: Sie sagt, was gelten soll, nicht ob es gilt.