Verhaltensgetriebene Entwicklung: vom Gespräch zur ausführbaren Spezifikation
Kurz gesagt
Niveau: Einstieg
Eine einzeilige Anfrage lässt sich auf mehrere vernünftige Arten bauen, und Tests beweisen nur, was die Entwicklung verstanden hat. Verhaltensgetriebene Entwicklung (BDD) schließt diese Lücke, bevor es Code gibt.
- Führ ein kurzes Gespräch mit drei Blickwinkeln: Fachbereich, Entwicklung und Test (die drei Amigos).
- Zerleg die Story in Regeln, konkrete Beispiele und offene Fragen (Example Mapping, etwa 25 Minuten).
- Schreib jedes Beispiel als deklaratives Szenario mit Given, When, Then, das genau ein Verhalten belegt.
- Lass die Szenarien als äußere Schleife laufen und ganz normale testgetriebene Entwicklung als innere.
- Die Szenarien bleiben als Dokumentation, die das Geschäft lesen kann und der Computer prüft.
Ein freundlicher Satz der Inhaberin kann vier verschiedene Funktionen beschreiben, und niemand merkt es, bis die falsche live ist. Verhaltensgetriebene Entwicklung ist der Weg, das in zehn Minuten statt in zehn Wochen zu bemerken. Hier von Anfang an: woher sie kommt, das Gespräch in ihrem Kern, wie aus Beispielen ausführbare Szenarien werden und der erste fehlschlagende Schritt in echtem Rails Code.
Ein Satz, vier verschiedene Funktionen
Theresa Pichler führt das Teehaus am Grieskai, einen Onlineshop für losen Tee in Graz. Den größten Teil ihres Umsatzes machen die Abos: jeden Monat eine Box Tee für € 18, von der Karte abgebucht, bevor sie verschickt wird. An einem Montag schreibt sie Jana, die den Shop entwickelt und betreut, eine kurze Nachricht: "Kundinnen und Kunden fragen ständig, ob sie ihr Abo für einen Monat pausieren können. Können wir das einbauen?"
Klingt fertig. Ein Satz, freundlich, und jeder weiß, was Pausieren heißt. Jana könnte am Nachmittag loslegen. Und genau hier gehen Softwareprojekte leise schief, denn dieser Satz lässt sich auf mindestens vier Arten umsetzen, und jede davon ist eine vernünftige Lesart.
Dieser Artikel beantwortet eine Frage: Wie stellst du sicher, dass gebaut wird, was das Geschäft tatsächlich gemeint hat? Die Antwort hat einen Namen, verhaltensgetriebene Entwicklung (Behaviour Driven Development, kurz BDD), und das meiste davon passiert, bevor jemand eine Zeile Code schreibt. Der Artikel baut auf testgetriebene Entwicklung erklärt auf, dem ersten Kapitel dieser Reihe. Wenn du noch nie einen automatisierten Test gesehen hast, lies zuerst den.
Beispiel: die vier Lesarten von "einen Monat pausieren"
Das hier könnte Jana aus Theresas Satz bauen, ohne eine einzige Frage zu stellen.
- Die nächste Box überspringen. Die Kundin drückt auf Pause, die nächste Lieferung fällt aus, die übernächste kommt wie gewohnt.
- Alles für 30 Tage anhalten. Die Pause beginnt heute und endet 30 Tage später, egal wo das im Lieferrhythmus landet. Wer am Tag nach einer Lieferung pausiert, ist nach 30 Tagen fertig, bevor die nächste Box überhaupt fällig ist: Es ändert sich nichts, und die Kundin fragt sich, was der Knopf eigentlich getan hat.
- Die Zahlung einfrieren, nicht die Box. Die Box geht trotzdem raus, nur die Abbuchung rutscht einen Monat nach hinten. Die Kundschaft fände das großartig. Theresas Kontostand nicht.
- Pausieren, bis die Kundin zurückkommt. "Einen Monat" war nur ein Beispiel, und das Abo bleibt pausiert, bis jemand auf Fortsetzen drückt.
Alle vier sind sinnvoll. Nur eine ist gemeint, und niemand, auch Theresa nicht, hat bisher bemerkt, dass es hier etwas zu entscheiden gibt. Wählt Jana Lesart 2, kann der Code schön sein, vollständig getestet und trotzdem falsch. Tests beweisen, dass der Code tut, was die Entwicklerin verstanden hat. Sie beweisen nicht, dass sie das Richtige verstanden hat. Genau diese Lücke schließt BDD.
Woher BDD kommt
Den Namen BDD hat Dan North geprägt. In einem Artikel, der im März 2006 zuerst im Magazin Better Software erschien, beschreibt er, wie er beim Unterrichten von testgetriebener Entwicklung (Test Driven Development, TDD) immer wieder auf dieselben Fragen stieß: Wo fange ich an, was teste ich, wie nenne ich einen Test, und warum schlägt er fehl1?
Sein erster Schritt war klein. Er merkte: Wenn Tests als ganze Sätze benannt werden, die mit "should" beginnen, liest sich die Liste der Namen wie eine Beschreibung dessen, was das System tut. Auch Leute aus dem Fachbereich konnten sie lesen. Dann ging er weiter. Die Missverständnisse rund um TDD hingen fast immer am Wort "Test", also sagte er stattdessen "Verhalten", und eine ganze Reihe von Fragen im Coaching erledigte sich von selbst1.
Der größere Schritt kam im Gespräch mit Chris Matts, einem Business Analyst. Als North ihm sein verhaltensbasiertes Vokabular beschrieb, sagte Matts sinngemäß: "Aber das ist ja genau wie Analyse." Gemeinsam übertrugen sie den Gedanken auf Anforderungen. Sie nahmen die übliche Vorlage für User Stories ("Als [Rolle] möchte ich [Funktion], damit [Nutzen]") und ergänzten eine Vorlage für die Akzeptanzkriterien jeder Story: Given ein Ausgangszustand, When ein Ereignis eintritt, Then sind bestimmte Ergebnisse sicherzustellen1. Martin Fowler schreibt den Stil Given, When, Then North und Matts als Teil von BDD zu und weist darauf hin, dass er dieselbe Form hat wie das Arrange, Act, Assert eines ganz normalen Unit Tests2.
Die Idee steht auch auf älterem Boden. 2001 beschrieb Ron Jeffries eine User Story als drei Dinge: eine Karte, die die Anforderung benennt, ein Gespräch, in dem die Anforderung tatsächlich vermittelt wird, und eine Bestätigung, den Akzeptanztest, der zeigt, dass sie erfüllt ist. Die beste Ergänzung zum Gespräch seien Beispiele, schrieb er, und die besten Beispiele seien ausführbar3. BDD ist, in einem Satz, ein disziplinierter Weg von diesem Gespräch zu dieser Bestätigung.
Beispiel: Tests als Verhalten benennen
Jana hat schon einen Unit Test für das Abomodell. Er heißt test_pause. Das verrät nichts darüber, was Pausieren tun soll. Als Verhalten benannt, liest sich dieselbe Datei in Minitest so:
class SubscriptionTest < ActiveSupport::TestCase
test "a pause before the cut off skips the next box" do
# ...
end
test "a pause after the cut off skips the box after next" do
# ...
end
end
Die Testnamen bleiben, wie die Bezeichner im Code, auf Englisch. Trotzdem kennst du nach den beiden Namen schon zwei Regeln der Funktion: Eine Pause vor dem Stichtag überspringt die nächste Box, eine Pause danach die übernächste. Das war Norths erste Entdeckung, und sie gilt bis heute: Wenn du einen Test nicht als Satz über ein Verhalten benennen kannst, weißt du wahrscheinlich noch nicht, was das Verhalten ist.
BDD ist zuerst ein Gespräch, dann ein Werkzeug
Viele lernen BDD als Werkzeug kennen. Sie installieren Cucumber, schreiben Dateien voller Given, When, Then und schließen daraus, BDD sei eine Methode, Tests auf Englisch zu schreiben. Das ist der kleinste Teil davon.
Das Cucumber Projekt selbst beschreibt BDD als drei Praktiken, die sich bei jeder kleinen Änderung wiederholen4:
- Discovery (Entdecken): über konkrete Beispiele des neuen Verhaltens sprechen, um zu klären und zu vereinbaren, was erwartet wird.
- Formulation (Formulieren): diese Beispiele so aufschreiben, dass sie sich automatisieren lassen, und prüfen, ob noch alle zustimmen.
- Automation (Automatisieren): das Verhalten umsetzen, beginnend mit einem automatisierten Test aus jedem Beispiel.
Achte auf die Reihenfolge. Das Entdecken kommt zuerst, und es ist ein Gespräch zwischen Menschen. Lässt du es weg, bekommst du sauber formatierte Szenarien der Annahmen der Entwicklerin. Sie laufen grün und sind trotzdem genau so falsch wie die vier Lesarten oben.
Die Werkzeuge von Cucumber (Feature Dateien, Step Definitions, Tags, Hooks) erkläre ich ausführlich in meinem Artikel über Cucumber und BDD. Dieses Kapitel bleibt bei dem Teil, der vor den Werkzeugen kommt.
Beispiel: was das Gespräch liefert und ein Dokument nicht
Stell dir vor, Theresa hätte statt einer Zeile eine Seite Spezifikation geschrieben: "Kundinnen und Kunden können ihr Abo auf der Kontoseite für einen Monat pausieren. Pausierte Monate werden nicht berechnet." Das liest sich gut. Es lässt aber immer noch die Lesarten 1, 2 und 4 zu, und über eine Box, die schon gepackt ist, sagt es nichts.
Vergleich das mit dem Ergebnis eines zehnminütigen Gesprächs (die ganze Fassung kommt gleich): vier Regeln, sieben konkrete Beispiele mit echten Daten, eine offene Frage und eine Idee für später. Das Dokument war länger und hat weniger entschieden. Das Gespräch war kürzer und hat mehr entschieden, weil jedes Beispiel eine Antwort auf "und was passiert dann genau?" erzwingt.
Die drei Amigos: Fachbereich, Entwicklung und Test
Für das Gespräch braucht es die richtigen Blickwinkel. Das Glossar der Agile Alliance nennt sie die drei Amigos, ein Begriff, den George Dinwiddie 2009 in diesem Sinn verwendet hat5. Gemeint sind Blickwinkel, keine Stellenbezeichnungen:
- Fachbereich: Welches Problem wollen wir lösen?
- Entwicklung: Wie könnten wir eine Lösung für dieses Problem bauen?
- Test: Und was ist hiermit, was könnte alles passieren?
Laut Glossar geht es um die kleinste Runde, die alle drei Blickwinkel abdeckt, nicht um ein Meeting für das ganze Team und nicht um einen weiteren festen Termin im Kalender5.
In einem kleinen Unternehmen sind die drei Amigos selten drei Fachleute. Die Inhaberin bringt den fachlichen Blick mit. Die Entwicklerin den technischen. Am häufigsten fehlt der Blick fürs Testen, und der gehört dem, der beruflich misstrauisch ist: oft die Person, die die Kundenmails beantwortet, weil sie jede merkwürdige Sache kennt, die Kundschaft tatsächlich tut.
Beispiel: wer im Teehaus am Grieskai am Tisch sitzt
Für die Pausenfunktion treffen sich drei Leute zu einem kurzen Call.
- Theresa (Fachbereich) weiß, warum die Kundschaft fragt: Urlaub, und Kästen voller Tee. Sie weiß auch, dass eine übersprungene Box € 18 weniger Umsatz in diesem Monat bedeutet.
- Jana (Entwicklung) weiß, wie Abos im Code funktionieren: Jedes hat ein Datum für die nächste Box, und Boxen werden abgebucht und gepackt, bevor sie verschickt werden.
- Florian (Test) packt die Boxen und beantwortet die Mails. Er stellt die unbequemen Fragen. "Was ist, wenn jemand am 27. pausiert, wenn die Box schon bezahlt ist und bei mir auf dem Packtisch steht?" Daran hätte vor dem Start sonst niemand gedacht. Die Kundschaft hätte es in der ersten Woche gefunden.
Könnte Jana die Testrolle selbst übernehmen? Teilweise, und sie sollte es versuchen. Aber die Lücken im eigenen Verständnis findet man schwer, und genau deshalb funktioniert dieser Blickwinkel am besten, wenn ihn jemand anderes mitbringt.
Example Mapping: Regeln, Beispiele und Fragen
Gespräche schweifen ab. Matt Wynne, der das Cucumber Projekt leitet, hat 2015 eine einfache Methode veröffentlicht, die sie kurz und ergiebig hält: Example Mapping6. Du brauchst Karteikarten in vier Farben (oder Haftnotizen, oder vier Farben in einem geteilten Dokument):
- eine gelbe Karte für die besprochene Story, ganz oben;
- eine blaue Karte für jede Regel (ein Akzeptanzkriterium), die schon bekannt ist, in einer Reihe darunter;
- grüne Karten für die konkreten Beispiele, die eine Regel veranschaulichen, jeweils unter ihrer Regel;
- rote Karten für Fragen, die niemand im Raum beantworten kann.
Wynne gibt ein paar nützliche Gewohnheiten mit6. Gib Beispielen kurze Namen nach dem Muster "das, wo die Kundin den Kassenbon vergessen hat", statt im Meeting formale Szenarien zu tippen. Weiß niemand, was herauskommen soll, hast du kein Beispiel, sondern eine Frage: Schreib sie auf eine rote Karte und mach weiter, statt darüber zu streiten. Eine gut verstandene, gut geschnittene Story sollte etwa 25 Minuten dauern. Und der Tisch verrät dir auf einen Blick etwas: Viele rote Karten heißen, dass es noch viel zu lernen gibt. Viele blaue Karten heißen, dass die Story groß ist und vermutlich in kleinere zerlegt werden sollte.
Wynne sagt auch ausdrücklich, dass es nicht darum geht, in der Sitzung Tests zu schreiben. Es geht um ein gemeinsames Verständnis davon, was nötig ist, damit die Story fertig ist6.
Beispiel: "einen Monat pausieren" in zehn Minuten abbilden
So läuft das Gespräch im Teehaus am Grieskai, Karte für Karte. Jana teilt ein Dokument mit vier farbigen Überschriften, damit alle mitlesen.
Gelb, die Story. Als Abonnentin möchte ich mein Teeabo für einen Monat pausieren, damit ich keinen Tee bekomme, während ich verreist bin.
Jana beginnt mit der naheliegenden Frage: "Wenn du einen Monat sagst, meinst du die nächste Box oder 30 Tage?" Theresa antwortet sofort: die nächste Box, passt. Die Lesarten 2, 3 und 4 sind mit einem Satz vom Tisch. Daraus wird die erste Regel.
Blau, Regel 1: Eine Pause überspringt genau eine Box, die nächste.
- Grün: das, wo Jonas am 20. Februar pausiert, die Box vom 1. März ausfällt und die Box vom 1. April wie gewohnt kommt.
- Grün: das, wo Jonas mitten in einem langen Abo pausiert und nur die nächste Box betroffen ist.
Theresa ergänzt die Geldseite, ohne gefragt zu werden.
Blau, Regel 2: Eine übersprungene Box wird nicht berechnet.
- Grün: das, wo Jonas den März überspringt, für März keine € 18 abgebucht werden und die Abbuchung für April normal läuft.
Dann kommt Florians Frage nach der Box, die schon bezahlt ist und auf seinem Packtisch steht. Jana erklärt, wie der Shop heute arbeitet: Jede Box wird am 25. des Vormonats abgebucht und gepackt. Theresa entscheidet auf der Stelle, dass eine schon abgebuchte Box trotzdem verschickt wird.
Blau, Regel 3: Eine Pause nach dem Stichtag am 25. gilt für die übernächste Box.
- Grün: das, wo Jonas am 27. Februar pausiert, die Box vom 1. März trotzdem kommt und die Box vom 1. April ausfällt.
- Grün: das, wo Jonas genau am 25. Februar pausiert. Theresa überlegt kurz: Die Abbuchung läuft frühmorgens, also zählt der 25. als nach dem Stichtag. Ohne dieses Beispiel hätten zwei Entwicklerinnen zwei verschiedene Vergleiche in den Code geschrieben.
Florian hat noch eine Frage: "Kann jemand jeden Monat pausieren, nie zahlen und den Aborabatt trotzdem ewig behalten?" Das will Theresa nicht.
Blau, Regel 4: Ein Abo kann immer nur für einen Monat am Stück pausiert werden.
- Grün: das, wo Jonas den März pausiert hat, auch den April pausieren will und den Hinweis bekommt, dass er immer nur einen Monat pausieren kann.
- Grün: das, wo Jonas den März pausiert, die Box im April bekommt und den Mai pausiert. Das geht, weil die Pausen nicht direkt aufeinander folgen.
Dann eine Frage, die niemand beantworten kann. Manche Kundinnen und Kunden sind mit einem Code eingestiegen, der 20 % auf die ersten drei Boxen gibt. Zählt eine übersprungene Box als eine dieser drei?
Rot: Verbraucht eine übersprungene Box eine der drei rabattierten Boxen? Theresa will darüber nachdenken und bis Freitag entscheiden. Die Runde schreibt die Frage auf und macht weiter, genau wie Wynne es beschreibt.
Zum Schluss sagt Theresa: "Manche wollen den ganzen Sommer pausieren." Das ist eine größere Änderung mit eigenen Fragen.
Gelb, geparkt: länger als einen Monat pausieren. Eine neue Story für einen anderen Tag.
Das Ganze hat etwa zehn Minuten gedauert. Vier blaue Karten, sieben grüne, eine rote, eine geparkte Story. Die eine rote Karte blockiert die drei Regeln nicht, bei denen sich alle sicher sind. Die Runde ist sich einig, dass die Story gebaut werden kann, und die Rabattfrage wird geklärt, bevor der Rabattteil live geht.
Von der Story über Akzeptanzkriterien zu Given, When, Then
Jetzt kommt das Formulieren. Jede blaue Karte ist ein Akzeptanzkriterium: eine Bedingung, die erfüllt sein muss, damit die Story als fertig gilt. North und Matts sagen es schlicht: Erfüllt das System alle Akzeptanzkriterien, verhält es sich richtig, sonst nicht1. Jede grüne Karte wird zu einem Szenario, das ein Kriterium mit einem konkreten Fall belegt.
Ein Szenario hat drei Teile. Die Referenz von Gherkin, der Sprache, die Cucumber liest, beschreibt sie so7:
- Given beschreibt die Ausgangslage, typischerweise etwas, das schon passiert ist. Es bringt das System in einen bekannten Zustand und sollte keine Klicks einer Person beschreiben.
- When beschreibt das Ereignis: Eine Person tut etwas, oder ein anderes System löst etwas aus.
- Then beschreibt das erwartete Ergebnis, und zwar etwas, das man von außen sehen kann (eine Seite, eine Meldung, eine Mail, ein Bericht), nicht einen Datensatz tief in der Datenbank.
Gherkin kann auch Deutsch. Mit der Zeile # language: de am Anfang einer Datei heißen die Schlüsselwörter zum Beispiel Angenommen, Wenn, Dann, Und, und Szenario8. Für Theresa ist das ein echter Gewinn, denn sie soll die Szenarien lesen und abnicken können. Außerdem gibt es seit Version 6 das Schlüsselwort Rule, auf Deutsch Regel, das die Szenarien zu einer Geschäftsregel bündelt7. Das passt fast genau auf eine blaue Karte mit ihren grünen Karten darunter, also lässt sich die Karte aus dem Gespräch direkt in die Datei übertragen.
Beispiel: aus einer grünen Karte wird ein Szenario
Nimm die erste grüne Karte unter Regel 1: "das, wo Jonas am 20. Februar pausiert, die Box vom 1. März ausfällt und die Box vom 1. April wie gewohnt kommt". Jana macht daraus in vier Schritten ein Szenario.
- Was gilt, bevor irgendetwas passiert? Jonas hat ein Monatsabo, und seine nächste Box ist am 01.03.2027 fällig. Das ist das Angenommen.
- Was tut Jonas? Er pausiert das Abo am 20.02.2027. Das ist das Wenn. Das Datum zählt, weil nach Regel 3 das Datum über das Ergebnis entscheidet.
- Was sieht Jonas danach? Sein Konto zeigt, dass die Box vom 01.03.2027 ausgesetzt und nicht berechnet ist. Das ist das erste Dann.
- Was muss sonst noch stimmen? Das Konto zeigt die nächste Box am 01.04.2027. Das ist das Und, ein zweites Ergebnis desselben einen Ereignisses.
Ausgeschrieben:
# language: de
Szenario: Eine Pause vor dem Stichtag setzt die nächste Box aus
Angenommen Jonas hat ein Monatsabo mit der nächsten Box am 01.03.2027
Wenn Jonas das Abo am 20.02.2027 pausiert
Dann wird die Box vom 01.03.2027 als ausgesetzt und nicht berechnet angezeigt
Und die nächste Box wird für den 01.04.2027 angezeigt
Theresa kann jede Zeile lesen und sagen: "Ja, genau so habe ich das gemeint", oder: "Nein, so nicht." Darum geht es. Das Szenario ist eine Anforderung, die sie prüfen kann, und ein Test, den der Computer ausführen kann, in einem einzigen Dokument.
Deklarative Szenarien statt imperativer Skripte
Dasselbe Szenario lässt sich auf zwei Arten schreiben. Ein imperatives Szenario zählt die Klicks auf: öffne diese Seite, füll dieses Feld aus, drück diesen Knopf. Ein deklaratives Szenario beschreibt das Verhalten und überlässt die Klicks dem Code darunter.
Die Dokumentation von Cucumber empfiehlt den deklarativen Stil und gibt dir eine Prüffrage mit: "Muss sich diese Formulierung ändern, wenn sich die Umsetzung ändert?" Lautet die Antwort ja, schreib sie ohne die Details der Umsetzung neu9. Die Gherkin Referenz sagt es für die Wenn Schritte noch bildhafter: Stell dir vor, es ist 1922 und es gibt keine Computer, und beschreib die Handlung so, dass sie trotzdem Sinn ergibt7. Verboten sind imperative Szenarien nicht, heißt es dort, aber sie hängen am aktuellen Bildschirm und machen bei jeder Änderung daran mehr Arbeit9.
Beispiel: dieselbe Pause, zweimal geschrieben
So hätte die imperative Fassung ausgesehen, wenn Jana direkt in die Tasten gegriffen hätte:
# language: de
Szenario: Abo pausieren
Angenommen ich bin als "jonas@teehausgrieskai.example" angemeldet
Und ich öffne "/account/subscriptions/42"
Wenn ich auf "Abo verwalten" klicke
Und ich auf "Nächste Box aussetzen" klicke
Und ich auf "Bestätigen" klicke
Dann sehe ich "Deine Box vom 01.03. wird ausgesetzt"
Zähl mit, was daran nicht stimmt. Es nennt eine Datenbank ID (42), die Theresa nichts sagt. Es bricht an dem Tag, an dem jemand "Abo verwalten" in "Einstellungen" umbenennt. Es versteckt das Datum, also genau das, was nach Regel 3 über das Ergebnis entscheidet. Und der Titel "Abo pausieren" sagt nicht, welche Regel hier belegt wird.
Die deklarative Fassung aus dem vorigen Abschnitt übersteht ein Redesign, einen Link statt eines Knopfs, sogar einen künftigen Sprachassistenten, weil nichts davon das Verhalten ändert. Die Klicks gibt es eh weiterhin. Sie wandern in die Step Definition, den Ruby Code darunter, und das ist die einzige Stelle, die sich ändern soll, wenn sich der Bildschirm ändert.
Ein Verhalten pro Szenario
Ein Szenario, das drei Dinge beweist, scheitert aus drei Gründen, und wenn es um 19 Uhr vor einem Release rot wird, weiß niemand, welcher der drei es war. Die Gherkin Referenz empfiehlt drei bis fünf Schritte pro Beispiel, weil ein Beispiel mit mehr Schritten seine Kraft als Spezifikation verliert7. Eine nützliche Gewohnheit obendrauf: genau ein Wenn pro Szenario. Brauchst du ein zweites Wenn, beschreibst du ein zweites Verhalten, also schreib ein zweites Szenario.
Beispiel: ein Szenario, das alles auf einmal wollte
Dieses Szenario ist an einem hektischen Nachmittag gewachsen:
# language: de
Szenario: Pausieren funktioniert
Angenommen Jonas hat ein Monatsabo mit der nächsten Box am 01.03.2027
Wenn Jonas das Abo am 20.02.2027 pausiert
Dann wird die Box vom 01.03.2027 als ausgesetzt und nicht berechnet angezeigt
Wenn Jonas das Abo am 21.02.2027 noch einmal pausiert
Dann bekommt Jonas den Hinweis, dass ein Abo nur einen Monat am Stück pausiert werden kann
Wenn Jonas das Abo am 02.03.2027 pausiert
Dann wird die Box vom 01.04.2027 als ausgesetzt und nicht berechnet angezeigt
Drei Wenn, also drei Verhalten. Und es versteckt einen Widerspruch: Regel 4 verbietet zwei Pausen hintereinander, also müsste das letzte Wenn abgelehnt werden, und das letzte Dann ist falsch. Wer genau liest, braucht ein paar Minuten, um das zu sehen. Nach Verhalten aufgeteilt, gehört jeder Teil zu einer blauen Karte, und der Fehler ist nicht mehr zu übersehen: Der dritte Teil gehört klar unter Regel 4, und dort ist das erwartete Ergebnis eine Ablehnung, keine ausgesetzte Box.
Drei Szenarien für die Pausenfunktion
Hier die Feature Datei, die Jana nach dem Gespräch schreibt, für die drei Regeln, bei denen sich alle sicher waren. Regel 2 (nicht berechnet) steckt im Ergebnis des ersten Szenarios, weil es dasselbe eine Ereignis ist, nur von der Geldseite aus gesehen. Die rote Karte zum Rabatt bleibt draußen, bis Theresa entschieden hat.
# language: de
Funktionalität: Ein Abo für einen Monat pausieren
Als Abonnentin
möchte ich mein Teeabo für einen Monat pausieren,
damit ich keinen Tee bekomme, während ich verreist bin.
Regel: Eine Pause setzt genau die nächste Box aus, und eine ausgesetzte Box wird nicht berechnet
Szenario: Eine Pause vor dem Stichtag setzt die nächste Box aus
Angenommen Jonas hat ein Monatsabo mit der nächsten Box am 01.03.2027
Wenn Jonas das Abo am 20.02.2027 pausiert
Dann wird die Box vom 01.03.2027 als ausgesetzt und nicht berechnet angezeigt
Und die nächste Box wird für den 01.04.2027 angezeigt
Regel: Boxen werden am 25. abgebucht und gepackt, eine spätere Pause gilt für die übernächste Box
Szenario: Eine Pause nach dem Stichtag setzt die übernächste Box aus
Angenommen Jonas hat ein Monatsabo mit der nächsten Box am 01.03.2027
Wenn Jonas das Abo am 27.02.2027 pausiert
Dann wird die Box vom 01.03.2027 als fällig angezeigt
Und die Box vom 01.04.2027 wird als ausgesetzt und nicht berechnet angezeigt
Regel: Ein Abo kann immer nur einen Monat am Stück pausiert werden
Szenario: Eine zweite Pause direkt danach wird abgelehnt
Angenommen Jonas hat die Box vom 01.03.2027 ausgesetzt
Wenn Jonas das Abo am 02.03.2027 pausiert
Dann bekommt Jonas den Hinweis, dass ein Abo nur einen Monat am Stück pausiert werden kann
Und die Box vom 01.04.2027 wird als fällig angezeigt
Lies es von oben nach unten. Der Block Funktionalität trägt die Story von der gelben Karte. Jede Regel ist eine blaue Karte, Wort für Wort. Jedes Szenario ist eine grüne Karte, mit echten Daten. Jedes Szenario hat genau ein Wenn und vier Schritte. Nirgends steht eine URL, eine Knopfbeschriftung oder eine Datenbank ID.
Die übrigen grünen Karten (eine Pause genau am 25., eine Pause im Mai nach einer Box im April) werden weitere Szenarien unter denselben Regeln. Manche davon landen am Ende eher als Unit Test denn als Szenario, und darum geht es im nächsten Abschnitt und im Kapitel über Unit, Integrations und End to End Tests.
Zwei Schleifen: BDD außen, TDD innen
Wie passen Szenarien und gewöhnliche Unit Tests zusammen? Die klarste Antwort haben Steve Freeman und Nat Pryce 2009 in Growing Object Oriented Software, Guided by Tests gegeben. Ihre Abbildung zu TDD mit Akzeptanztest und Unit Test Zyklen zeigt zwei Schleifen, eine in der anderen10.
- Die äußere Schleife beginnt mit einem fehlschlagenden Akzeptanztest, hier einem Szenario. Es beschreibt ein Verhalten des ganzen Systems, so wie die Kundschaft es sieht. Es bleibt rot, während du arbeitest, manchmal stundenlang.
- Die innere Schleife ist das gewohnte Rot, Grün, Refactor aus Kapitel 1. Du schreibst einen kleinen fehlschlagenden Unit Test für ein Teil, das das Szenario braucht, bringst ihn zum Laufen, räumst auf und wiederholst das. Jede Runde dauert Minuten.
- Sind genug innere Runden geschafft, wird das Szenario grün. Dann nimmst du das nächste.
Die äußere Schleife sorgt dafür, dass du das Richtige baust. Die innere sorgt dafür, dass du es richtig baust. Keine ersetzt die andere. Ein Szenario allein sagt dir, dass etwas kaputt ist, aber nicht wo. Unit Tests allein können alle grün sein, während die Funktion als Ganzes trotzdem nicht tut, was Theresa gemeint hat.
So arbeite ich: Test zuerst, mit BDD Szenarien als äußerer Schleife (in Cucumber oder als Tests mit Capybara und Playwright) und Minitest oder RSpec für die innere Schleife.
Beispiel: der erste fehlschlagende Schritt
Jana beginnt die äußere Schleife mit dem ersten Szenario. Findet Cucumber einen Schritt, den noch kein Code versteht, markiert es ihn als undefiniert, überspringt den Rest des Szenarios und schlägt ein Stück Code als Ausgangspunkt vor11. Jana schreibt die Step Definitions, den Ruby Code, der jeden Satz in Aktionen auf der echten Anwendung übersetzt. Cucumber erlaubt in einem Schritt Platzhalter in geschweiften Klammern, sogenannte Parameter Types, und du kannst eigene definieren12. Jana definiert {date}, damit "01.03.2027" im Code als echtes Datum ankommt:
# features/support/parameter_types.rb
ParameterType(
name: "date",
regexp: /\d{2}\.\d{2}\.\d{4}/,
# macht aus "01.03.2027" ein Ruby Date
transformer: ->(text) { Date.strptime(text, "%d.%m.%Y") }
)
Zeile für Zeile: Der Parameter heißt date. Der reguläre Ausdruck passt auf zwei Ziffern, Punkt, zwei Ziffern, Punkt, vier Ziffern, also das deutsche Datumsformat. Der Transformer nimmt den gefundenen Text und macht daraus ein Ruby Date.
# features/step_definitions/subscription_steps.rb
World(ActiveSupport::Testing::TimeHelpers)
Given("Jonas hat ein Monatsabo mit der nächsten Box am {date}") do |date|
@jonas = Customer.create!(name: "Jonas", email: "jonas@teehausgrieskai.example")
@subscription = @jonas.subscriptions.create!(plan: "monthly", next_box_on: date)
end
When("Jonas das Abo am {date} pausiert") do |date|
# die Uhr auf das Datum aus dem Szenario stellen
travel_to(date) do
sign_in_as(@jonas)
visit account_subscription_path(@subscription)
click_button "Nächste Box aussetzen"
end
end
Then("wird die Box vom {date} als ausgesetzt und nicht berechnet angezeigt") do |date|
expect(page).to have_text("#{date.strftime('%d.%m.%Y')}: ausgesetzt, nicht berechnet")
end
Was die Teile tun. Die Ruby Methoden heißen weiter Given, When und Then, obwohl die Feature Datei Angenommen, Wenn und Dann sagt. Das geht, weil Cucumber beim Suchen einer Step Definition das Schlüsselwort gar nicht beachtet, nur den Text7. World(...) macht die Zeithelfer von Rails in den Schritten verfügbar, damit travel_to so tun kann, als wäre heute ein bestimmtes Datum. Mit einem Block stellt travel_to die Uhr danach wieder zurück13. Das Angenommen legt Jonas und sein Abo direkt an, weil Angenommen einen Zustand beschreibt, keine Klicks. Das Wenn meldet Jonas an (sign_in_as ist ein kleiner Helfer, den Jana in features/support pflegt), öffnet seine Aboseite und drückt den Knopf. Hierhin sind die Klicks aus der imperativen Fassung gewandert: an eine Stelle, unter den deklarativen Satz. Das Dann prüft, was Jonas tatsächlich auf der Seite sieht.
Jana startet den Lauf:
bundle exec cucumber features/subscriptions/pause.feature
Das Angenommen besteht, weil der Shop schon Kundschaft und Abos kennt. Das Wenn schlägt fehl. Capybara, die Bibliothek, die den Browser steuert, meldet, dass sie keinen Knopf namens "Nächste Box aussetzen" findet. Das ist der erste fehlschlagende Schritt, und er schlägt aus dem richtigen Grund fehl: Die Funktion gibt es noch nicht. Wäre er gescheitert, weil sich Jonas nicht anlegen lässt, wäre das Szenario kaputt und nicht die Funktion, und Jana würde das zuerst reparieren. Das ist die Entscheidung oben im Diagramm.
Jetzt geht sie in die innere Schleife. Das erste Teil, das das Szenario braucht, ist die Regel selbst: Welche Box setzt eine Pause aus? Das ist reine Logik, ohne Browser, also bekommt es einen Unit Test in Minitest:
# test/models/subscription_test.rb
require "test_helper"
class SubscriptionTest < ActiveSupport::TestCase
test "a pause before the cut off skips the next box" do
subscription = subscriptions(:jonas_monthly) # nächste Box am 01.03.2027
subscription.pause!(on: Date.new(2027, 2, 20))
assert_equal Date.new(2027, 3, 1), subscription.skipped_box_on
assert_equal Date.new(2027, 4, 1), subscription.next_box_on
end
end
subscriptions(:jonas_monthly) lädt ein vorbereitetes Abo aus den Fixtures, den Testdaten. Der Test pausiert es am 20. Februar und prüft zwei Ergebnisse: Ausgesetzt ist die Box vom 1. März, und die nächste Box ist jetzt der 1. April. Mit bin/rails test test/models/subscription_test.rb gestartet, scheitert er mit dem Fehler, dass es pause! nicht gibt. Rot, aus dem richtigen Grund.
Der einfachste Code, der besteht (nach einer Migration, die eine Datumsspalte skipped_box_on anlegt), ist dieser:
class Subscription < ApplicationRecord
def pause!(on:)
update!(skipped_box_on: next_box_on, next_box_on: next_box_on.next_month)
end
end
Er ignoriert das Datum on: komplett, und das ist Absicht. Noch verlangt kein Test den Stichtag. Der nächste Unit Test, "eine Pause nach dem Stichtag setzt die übernächste Box aus", scheitert an diesem Code und zwingt die Stichtagsregel hinein, so wie Kapitel 1 die Triangulation beschreibt. Danach kommen eine Controller Action und der Knopf. Dann startet Jana das Szenario erneut, und der Wenn Schritt besteht. Die äußere Schleife geht weiter zum Dann. Ein Szenario, eine Handvoll innerer Runden, und die erste Regel aus einem zehnminütigen Gespräch wird jetzt bei jedem Lauf vom Computer belegt.
Was du als Inhaberin oder Inhaber verlangen solltest
Du musst kein Ruby lesen können, um von BDD zu profitieren. Du musst beim Gespräch dabei sein und das Ergebnis lesen können. Das Cucumber Projekt beschreibt die Szenarien als Dokumentation, die automatisch gegen das Verhalten des Systems geprüft wird4. Anders als eine Spezifikation in einem geteilten Ordner kann sie nicht still veralten: Tut die Software nicht mehr, was ein Szenario sagt, schlägt das Szenario fehl.
Fünf Dinge lohnt es sich zu verlangen, von allen, die Software für dich bauen:
- Lad mich zum Gespräch ein, bevor du baust. Zehn bis 25 Minuten pro Story, mit Beispielen, kein langes Anforderungsmeeting.
- Zeig mir die Regeln und Beispiele in meinen Worten. Wenn ich ein Szenario nicht laut vorlesen und ihm zustimmen kann, ist es nicht fertig.
- Gib mir die offenen Fragen als Liste. Die roten Karten sind Entscheidungen, die nur ich treffen kann. Lieber am Montag als von der Kundschaft entdeckt.
- Zeig mir vor einem Release, dass die Szenarien grün sind. Ein grüner Lauf der Szenarien ist die Bestätigung aus Jeffries' drittem Punkt3.
- Markier die Szenarien, die nie brechen dürfen. Manche Verhalten bringen das Geld herein oder halten das Unternehmen rechtlich sauber. Sie verdienen mehr Schutz als der Rest, und darum geht es im Kapitel über den kritischen Pfad in Software.
Beispiel: Theresas fünf Fragen, beantwortet für die Pausenfunktion
- Theresa war beim Gespräch dabei, mit Florian, etwa zehn Minuten lang.
- Sie hat die Feature Datei oben Zeile für Zeile gelesen und zugestimmt. Eine Änderung wollte sie: "als ausgesetzt und nicht berechnet angezeigt" statt Janas erstem Entwurf "Status ist ausgesetzt", weil die Kundschaft genau diesen Wortlaut sehen wird.
- Sie hat eine rote Karte bekommen. Am Freitag hat sie entschieden, dass eine ausgesetzte Box keine der drei rabattierten Boxen verbraucht. Jana hat eine vierte Regel und ein Szenario dazu ergänzt.
- Vor dem Release hat Jana ihr den Lauf geschickt: jedes Szenario der Funktion grün, mit Namen.
- Theresa hat das zweite Szenario als eines markiert, das nie brechen darf. Eine abgebuchte und dann ausgesetzte Box bedeutet eine Erstattung, eine Entschuldigung und eine verärgerte Kundin, und Florians Packtisch voller Boxen, die niemand will.
Wann BDD mehr ist, als du brauchst
BDD gibt es nicht umsonst. Das Gespräch kostet die Zeit aller Beteiligten, und Szenarien sind Code, der gepflegt werden will. Wynne selbst merkt an, dass manche Regeln so offensichtlich sind, dass niemand Beispiele dafür braucht6, und dasselbe Urteil gilt für ganze Änderungen. Eine Änderung ohne Geschäftsregel (ein neues Foto, ein korrigierter Preis, ein Tippfehler) braucht keine drei Amigos. Eine Änderung, die ein vernünftiger Mensch auf zwei Arten lesen kann, schon. Das ist der Test: Wenn du dir vorstellen kannst, dass zwei Entwicklerinnen es unterschiedlich bauen, führ das Gespräch.
Auch die Werkzeuge sind freiwillig. Das Gespräch und die Beispiele sind BDD. Ob die Beispiele danach in Feature Dateien für Cucumber leben, in Systemtests mit RSpec oder Minitest und Capybara oder in Tests mit Playwright, ist eine praktische Entscheidung. Feature Dateien lohnen ihre Pflege, wenn Leute außerhalb der Entwicklung sie lesen. Liest sie außerhalb des Codes nie jemand, tragen gut benannte Tests in derselben Form Given, When, Then die Beispiele genauso treu.
Beispiel: zwei Anfragen in derselben Woche
In derselben Woche wie die Pausenfunktion schickt Theresa eine zweite Nachricht: "Bitte tausch das Foto auf der Seite vom Earl Grey, das neue hängt an." Eine Lesart. Jana tauscht das Foto, schaut sich die Seite an und macht weiter. Kein Gespräch, kein Szenario, nichts verloren.
Dann eine dritte Nachricht: "Können wir Abonnentinnen und Abonnenten den Versand schenken?" Jana hält inne. Kostenloser Versand für die Abobox oder für jede Bestellung, die jemand mit Abo aufgibt? In einem pausierten Monat? Für Abos nach Deutschland oder Südtirol? Wieder vier Lesarten. Die bekommt eine gelbe Karte und zehn Minuten mit Theresa und Florian.
Fazit: Das Gespräch ist die Spezifikation
BDD begann als besserer Weg, TDD zu erklären, und wurde zu einer Art, sich darauf zu einigen, was gebaut wird. Sein Kern ist kein Werkzeug. Es ist ein kurzes, strukturiertes Gespräch zwischen Fachbereich, Entwicklung und Test, vor dem Code, das aus einem vagen Satz Regeln, konkrete Beispiele und ehrliche Fragen macht. Diese Beispiele werden als Szenarien mit Given, When, Then aufgeschrieben, deklarativ und je ein Verhalten, sodass das Geschäft sie lesen und der Computer sie ausführen kann. Sie werden zur äußeren Schleife um ganz normale testgetriebene Entwicklung und bleiben als Dokumentation, die nicht veralten kann.
Noch wichtiger werden sie, wenn eine KI einen Teil des Codes schreibt. Eine Maschine kann "bau eine Pausenfunktion" genauso leicht auf vier Arten lesen wie ein Mensch. Vereinbarte Szenarien geben ihr ein genaues Ziel und dir eine Prüfung, die nicht davon abhängt, was die KI behauptet. Wie du das für ein ganzes Projekt einrichtest, steht im Kapitel über testgetriebene Entwicklung mit KI.
Theresas einzeilige Nachricht hätte vier verschiedene Funktionen ergeben können. Zehn Minuten mit drei Leuten haben die eine ergeben, die sie gemeint hat, dazu eine Frage, die niemand gesehen hatte, und eine Story für später. Das kostet weit weniger, als die falsche Funktion zu bauen und dann noch einmal, und genau hier beginnt es, das Richtige zu bauen.