Vision. Erst das Problem.
Ziel, Problem, Architektur. Versioniert wie Quellcode. Der Code folgt daraus, nicht umgekehrt.
Bevor Geld in Code fließt, steht fest, was gebaut wird und woran Erfolg gemessen wird.
Vier Stufen. Ein Dokument. Ein Team aus Agenten. Und am Ende ein Mensch, der freigibt.
Sondern die Frage, ob das Richtige gebaut wird. Und ob es in einem Jahr noch jemand versteht.
SDD beantwortet beides mit einem Dokument: einer präzisen, versionierten Spezifikation. Problem, Architektur, Randbedingungen, Tests, Abnahme. Bevor die erste Zeile Code entsteht.
SDD ist nicht an eine Sprache oder Plattform gebunden. Dieselbe Vorlage trägt Web, Backend, Embedded und Apps.
Eine Live-Plattform für Indoor-Cycling-Rennen. Die Ausschnitte stammen aus zwei Spezifikationen dieses Projekts: Spec 12 (Architektur) und Spec 68 (Datenpfad). Namen sind entfernt.
Ziel, Problem, Architektur. Versioniert wie Quellcode. Der Code folgt daraus, nicht umgekehrt.
Bevor Geld in Code fließt, steht fest, was gebaut wird und woran Erfolg gemessen wird.
Die Spec zerfällt in nummerierte Einheiten. Jede mit Testszenarien aus echten Werten. Ergebnis: grün oder rot.
Ob etwas fertig ist, entscheidet kein Bauchgefühl.
| ID | Gegeben | Wenn | Dann | Prüft |
|---|---|---|---|---|
| T68-02 | Kaltstart, 8 Felder | erster Refresh | jedes Feld = Zielwert ±1e-6, kein Gleiten von null | AC-02 |
| T68-03 | Slot wird von neuem Rad belegt | erster Refresh | Wert des neuen Rads, kein Rest des alten | AC-02 |
| T68-09 | 20 Fahrer, alle gleichauf | Sortierung | Fallback auf Neusortierung greift | AC-03 |
| T68-17a | Voller Raum | publish | 0 Byte alloziert | AC-07 |
| T68-21 | Schema-Konstante verletzt | Generator läuft | Build bricht ab, kein Header | AC-09 |
5 von 24 Szenarien
Agenten schreiben den Code, testgetrieben. Die Randbedingungen stehen in der Spec, nicht im Kopf eines Entwicklers.
Kein Wissen versickert in Chatverläufen. Die Spec ist die Dokumentation.
publish() alle 33 ms, Rangfolge im HeaderGenerator erzeugt den C-Header aus dem Schema. Weicht etwas ab, hält der Build an.
Randbedingungen
allocateDirect sein. Ein Heap-Puffer lässt den nativen Aufruf still zurückkehren, ohne zu schreiben.publish() alloziert pro Takt nichts, auch nicht bei vollem Raum.Jedes Abnahmekriterium nennt die Tests, die es prüfen. Was offen ist, steht als offen da.
Sie nehmen gegen Kriterien ab, die Sie vorher kannten.
publish alloziert nichts und bleibt unter 10 % des Takts. T68-17a/b, -19a/b, -20exp() nativ gegen Kotlin auf dem Gerät. offen: Entscheidung nötigJeder Agent hat genau eine Aufgabe. Keiner kann eine Spec allein erfüllen. Koordiniert wird über die Spezifikation.
Animation: Der Domain-Agent klärt mit dem Architekten die Fachbegriffe. Der Architekt zerlegt die Spezifikation in Microspecs und verteilt sie an drei Worker. Die Worker arbeiten testgetrieben: Test rot, Code, Test grün. Die Ergebnisse gehen an Reviewer und Security-Agent; beide schicken je einen Befund zurück, die Worker beheben ihn mit einem neuen Test. Am Ende prüft ein Mensch und gibt frei. Der Ablauf steht als Liste daneben.
Schematischer Ablauf, keine Aufzeichnung.
Nicht die Agenten entscheiden, wann sie fertig sind. Die Tests tun es, und am Ende ein Mensch.
Schreiben Sie mir kurz, worum es geht. Das Erstgespräch ist unverbindlich, die Antwort kommt von mir.