Spec to Scale — wir bauen zuerst das System, mit dem gute Software wiederholbar geliefert wird. Und entwickeln damit das eigentliche Produkt.
Die meisten Softwareprojekte scheitern nicht am Code, sondern an dem, was vor dem Code nie aufgeschrieben wurde: welcher Nutzerjob erledigt sein muss, wo das System endet, was im Fehlerfall gilt. Spec to Scale ist unser Vorgehen, diese Fragen zuerst zu beantworten — in einer Form, die Menschen lesen und gegen die Maschinen prüfen können.
Das Pflichtenheft war mal richtig. Sein Nachfolger heißt Backlog und hat dasselbe fehlende Feld.
Ein Pflichtenheft kennt eine Richtung: Anforderungen rein, Produkt raus, Unterschrift drunter. Das war eine ehrliche Antwort auf eine Zeit, in der Software selten umgebaut wurde und Fremdsysteme ihr Datenmodell nicht alle paar Monate änderten. Heute hält es genau bis zum ersten Nutzer — oder bis zum ersten Sonderfall, und der kommt selten zum vereinbarten Termin.
Sein Nachfolger ist meist das bestgepflegte Dokument im Haus: der Backlog. Jede Karte hat eine Schätzung, ein Akzeptanzkriterium und einen Platz in der Reihenfolge; jeden Dienstag wird nachgeschärft. Frag trotzdem einmal, welches Problem weg wäre, wenn die obersten zwanzig Karten morgen fertig wären — meist wird es still. Der Backlog weiß alles über das Was und hat für das Warum kein Feld. Dieses Feld ist die SPEC.
Eine SPEC ist ein Vertrag über den Nutzerjob, keine Liste von Features.
SPEC schreiben wir groß, weil wir etwas anderes meinen als Lastenheft, Pflichtenheft oder das Dokument im Anhang des Angebots, das nach der Unterschrift niemand mehr öffnet. Eine SPEC bei uns beschreibt:
- den Nutzerjob — wer am Ende was erledigt haben muss, in dessen eigenen Worten;
- die Systemgrenze — was dieses System tut und was es ausdrücklich den Nachbarsystemen überlässt;
- Daten und Zustände — welche Objekte es gibt, welches System sie führt, welche Zustände sie annehmen können;
- Entscheidungen und Verantwortlichkeiten — wo ein Mensch, eine Regel oder ein Modell entscheidet, und wer die Entscheidung trägt;
- Erfolg, Fehler und Abnahme — woran man erkennt, dass es funktioniert, und was passiert, wenn nicht;
- offene Annahmen — was wir noch nicht wissen und womit wir es prüfen.
Dazu kommen Architektur, Akzeptanzkriterien und Qualitätsregeln, und zwar maschinenlesbar (also: strukturiert genug, dass ein Test oder ein Agent dagegen prüfen kann, ob das Gebaute der SPEC entspricht). Das ist der Unterschied zur Pflichtenheft-Folklore: Die SPEC wird nicht abgenickt, sie wird getestet. Wo sie und die Software sich widersprechen, hat eine von beiden einen Fehler — und beides ist eine Erkenntnis, kein Change Request.
Sechs Phasen, und keine davon heißt „Übergabe".
Wir zeichnen, was ist: Prozesse, Systeme, Risiken, Werthebel. Exporte, Tabellen und Schattenprozesse stehen auf derselben Karte wie die APIs, weil sie denselben Prozess tragen. Ergebnis: ein Bild der Ist-Landschaft, über das sich alle Beteiligten streiten können — und zwar am selben Gegenstand.
Fachlichkeit, Architektur, Akzeptanzkriterien, Qualitätsregeln — maschinenlesbar. Ergebnis: ein Vertrag, gegen den gebaut und getestet wird, und eine Liste der Annahmen, die noch offen sind.
Zuerst eine dünne produktive Strecke: ein Vorgang, von vorne bis hinten durch das ganze System, mit echten Daten im echten Betrieb. Kein Wegwerf-Prototyp, der nach dem Meeting in einem Ordner verschwindet. Ergebnis: Software, die läuft und die wir weiterbauen, statt sie neu zu schreiben.
Im Betrieb zeigt sich, was keine SPEC vorhersagt: die Ausnahme, der Lastmoment, das Fremdsystem, das sein Format ändert. Ergebnis: Zustände und Fehler, die sichtbar sind und einen Grund tragen — statt Logfile-Archäologie.
Was der Betrieb zeigt, fließt zurück in Architektur und SPEC. Sonderfälle werden Regeln, Annahmen werden bestätigt oder gestrichen. Ergebnis: eine korrigierte SPEC, die beschreibt, was wirklich läuft.
Den nächsten messbaren Engpass beseitigen — und nur den. Ergebnis: die nächste Strecke, mit der Begründung, warum gerade diese und keine andere.
Die sechs Phasen sind kein Wasserfall mit sechs Stufen, sondern ein Loop — näher an agil als an jedem Phasenplan: Nach Improve kommt wieder Map, nur mit besserer Karte. Deshalb heißt es Spec to Scale und nicht Spec to Launch.
Scale heißt nicht automatisch mehr Nutzer.
Scale kann heißen: mehr Datensätze, ein zweiter Mandant, der vierte Kanal — oder ein Montagmorgen, an dem niemand mehr etwas von Hand retten muss. Und manchmal heißt es, dass ein System den Dienstleister überlebt. Für Schmetterling haben wir 2012 das erste TOMA-Reservierungssystem komplett auf Webtechnologien gebaut, von null konzipiert; seit 2017 entwickelt Schmetterling es intern weiter, heute als Teil der GO Suite. Es zeigt, woran wir Scale messen: nicht am Launch, sondern an dem, was Jahre später noch läuft.
Agenten bauen mit. Verantworten tun Menschen.
AI und Agenten unterstützen bei uns Planung, Implementierung, Tests und Doku; andere Agenten prüfen ihre Arbeit. Architektur, Security, Qualität und Produktion verantworten Menschen, und an der Stelle, an der jemand mit Urteilsvermögen sitzen muss, sitzt weiter einer. Das ist auch der eigentliche Grund für die maschinenlesbare SPEC: Ein Agent kann gegen einen Vertrag prüfen, aber keinen aushandeln. Aushandeln tun wir mit euch, vorher.
Wo das im Angebot sitzt: Der Blueprint ist Map plus erste SPEC. Run & Improve ist der Loop danach.
Der System Blueprint ist Map und erste SPEC als bezahlter, abgegrenzter Einstieg — zwei bis vier Wochen, am Ende eine Entscheidungsvorlage, die auch Nein heißen darf. Ab Build & Connect übernimmt Build, und mit Run & Improve bekommen Run, Learn und Improve eine benannte Verantwortung über den Launch hinaus. Woran so ein Loop thematisch arbeitet, steht beim Delivery-Loop: vom Auftrag zur Auslieferung mit einem Status, der stimmt.
Die SPEC sieht von allen Phasen am wenigsten nach Fortschritt aus und erzeugt am meisten davon: Jede Stunde in der SPEC ist eine, die wir später nicht damit verbringen, einen Sonderfall im Code zu suchen, der in keinem Dokument stand. Deshalb steht sie vorne — als Vertrag, den wir zuerst mit uns selbst schließen. Wenn bei euch der Backlog gepflegt ist und die Frage nach dem Warum trotzdem ins Leere läuft:
Fünf Fragen, die zu Spec to Scale fast immer kommen.
Was ist eine SPEC, und wie unterscheidet sie sich von Lastenheft und Pflichtenheft?
Lastenheft und Pflichtenheft beschreiben, was gebaut werden soll — aus Sicht des Auftraggebers das eine, aus Sicht des Lieferanten das andere —, und dann wird unterschrieben. Eine SPEC beschreibt Nutzerjob, Systemgrenze, Zustände und Abnahmekriterien so, dass Tests und Agenten dagegen prüfen können. Das Heft endet mit der Unterschrift; die SPEC fängt dort erst an zu arbeiten.
Ist Spec to Scale Wasserfall oder agil?
Keins der beiden Etiketten. Die SPEC steht vor dem Code, das klingt nach Wasserfall; gebaut wird in dünnen Strecken, die im Betrieb lernen und die SPEC korrigieren, das ist agil, nur mit einem Vertrag darunter. Was wir nicht machen: einen Backlog ohne Warum abarbeiten und das Iteration nennen.
Wie lange dauert die SPEC-Phase, und was kostet sie?
Als bezahlter, abgegrenzter Einstieg heißt sie System Blueprint: zwei bis vier Wochen zum Festpreis, mit Karte, Zielarchitektur, Risikoregister und erster SPEC. Innerhalb eines laufenden Builds ist die SPEC je Strecke kürzer, weil sie auf der Karte aufsetzt, die schon da ist. Was der Blueprint kostet, hängt an der Größe eurer Systemlandschaft und steht fest, bevor er beginnt.
Können wir die SPEC lesen und ändern, oder ist das Code?
Lesbar ist sie, Quelltext ist sie nicht: ein Dokument mit festen Abschnitten, und genau diese Ordnung macht sie maschinenlesbar — ein Test findet darin die Zustände und Kriterien, gegen die er prüft. Ändern dürft ihr sie jederzeit. Die Änderung wird versioniert, und die Tests, die davon abhängen, ziehen nach.
Was passiert, wenn sich Anforderungen nach der SPEC ändern?
Dann ändert sich die SPEC, und zwar zuerst — nicht der Code mit einem Nachtrag irgendwann später. Die Phase Learn ist genau dafür da: Was der Betrieb zeigt, fließt zurück, Sonderfälle werden Regeln, Annahmen werden bestätigt oder gestrichen. Eine Anforderung, die sich ändert, ist kein Change Request gegen das Projekt, sondern der Grund, warum wir in Strecken bauen.