methodatlas

Agile Workshop-Methode

Specification by Example

Macht Geschäftsregeln durch konkrete Beispiele gemeinsam verständlich, formulierbar und später automatisierbar.

Specification by Example verbindet Discovery, Formulation und Automation. Fachseite, Entwicklung und Test klären Regeln an realistischen Beispielen, formulieren sie in domänennaher Sprache und halten ausführbare Spezifikation und Systemverhalten gemeinsam aktuell.

Kernfrage
Welche konkreten Beispiele zeigen, dass die Geschäftsregel fachlich richtig, vollständig und testbar verstanden ist?
Teilnehmende
3-6
Zeit
60-90 min pro Feature

Discovery klärt Regeln und Beispiele, Formulation macht sie lesbar ausführbar, Automation prüft das Systemverhalten.

Papierillustration für Specification by Example mit fachlich beschrifteter Arbeitsfläche.
  1. Entdecken

    Regeln mit Beispielen erkunden

    Gemeinsames Verständnis der fachlichen Regel, Grenzen und offenen Fragen herstellen.

  2. Formulieren

    Beispiele als lesbare Spezifikation schreiben

    Ausgewählte Beispiele mit Kontext, Ereignis und erwartetem Ergebnis eindeutig formulieren.

  3. Automatisieren

    Beispiele mit dem System verbinden

    Ausführbare Beispiele als schnelle, verlässliche Rückmeldung in die Delivery integrieren.

  4. Pflegen

    Lebende Spezifikation erhalten

    Regel, Beispiele, Automatisierung und Systemverhalten bei Änderungen synchron halten.

Beispiele mit jeder Regeländerung aktualisieren; Spezifikation und Automatisierung gemeinsam mit dem Produktcode versionieren.

Geeignet, wenn

Geeignet für verhaltensreiche Softwareanforderungen und Regeln mit Grenzfällen. Für reine technische Qualitätsattribute braucht es ergänzende Mess- und Lastkriterien.

Ideal für

  • Refinement
  • BDD-Einführung
  • Komplexe Geschäftsregeln

Nicht gut für

  • Reine UI-Polish-Tasks ohne Logik

Ergebnisse

  • Example Map und Regelset

    Geschäftsregeln, typische Fälle, Grenzbeispiele, Gegenbeispiele und offene Fragen.

  • Lebende ausführbare Spezifikation

    Domänennah formulierte Beispiele mit Automatisierungsstatus und gemeinsamer Versionierung.

Regel-Beispiel-Spezifikation

Fiktives Arbeitsbeispiel

Jede Zeile verbindet eine Geschäftsregel mit einem konkreten Beispiel und offenem Klärungsbedarf.

Regel-Beispiel-Spezifikation
BeispielGeschäftsregelGiven: KontextWhen: EreignisThen: ErgebnisOffene Frage oder Grenze
Storno exakt 24 Stunden vorherGrenzbeispielKostenlose Stornierung bis einschließlich 24 Stunden vor Beginn.Termin beginnt am 20.06. um 10:00; bezahlt sind 120 €.Kundin storniert am 19.06. um 10:00.120 € werden vollständig erstattet; Bestätigung nennt 0 € Gebühr.Welche Zeitzone bestimmt Beginn und Stornozeitpunkt?
  1. 1. Geschäftsregel

    Storno exakt 24 Stunden vorher
    Kostenlose Stornierung bis einschließlich 24 Stunden vor Beginn.
  2. 2. Given: Kontext

    Storno exakt 24 Stunden vorher
    Termin beginnt am 20.06. um 10:00; bezahlt sind 120 €.
  3. 3. When: Ereignis

    Storno exakt 24 Stunden vorher
    Kundin storniert am 19.06. um 10:00.
  4. 4. Then: Ergebnis

    Storno exakt 24 Stunden vorher
    120 € werden vollständig erstattet; Bestätigung nennt 0 € Gebühr.
  5. 5. Offene Frage oder Grenze

    Storno exakt 24 Stunden vorher
    Welche Zeitzone bestimmt Beginn und Stornozeitpunkt?

Ein Beispiel illustriert eine Regel. Fragen werden vor der Formulation entschieden oder sichtbar zurückgestellt.

Cucumber: Behaviour-Driven Development

Erster Schritt

Beginne mit der Kernfrage: Welche konkreten Beispiele zeigen, dass die Geschäftsregel fachlich richtig, vollständig und testbar verstanden ist?

Zur Methodenanleitung

Vertiefung

Zweck

Wenn fachliche Regeln präzise werden sollen, verbindet sie Sprache, Beispiel und Prüfung. Sie verhindert, dass Anforderungen zu abstrakt oder missverständlich bleiben.

Funktionsweise

Sie formuliert Verhalten über konkrete Beispiele und nutzt diese als gemeinsame Referenz für Verständnis und Validierung. So wird aus Beschreibung eine überprüfbare Spezifikation, die alle Seiten lesen und gegen dieselben Fälle prüfen können.

Im Detail

Specification by Example funktioniert, weil gewünschtes Systemverhalten an realistischen Beispielen klarer und prüfbarer wird als in abstrakten Anforderungssätzen. Gute Anwendung hält Beispiele fachlich präzise und verknüpft sie mit Regeln, Ausnahmen und erwarteten Ergebnissen. Dadurch entsteht eine gemeinsame Referenz für Fachseite, Test und Umsetzung, die Missverständnisse früh abfängt und spätere Regressionen besser auffindbar macht.

Durchführung

Wähle Fachfälle, die normale Verläufe und kritische Ausnahmen gemeinsam abdecken, damit die Spezifikation Tragweite bekommt. Besonders viel lernt ihr an der Stelle, an der ein Beispiel mehrere Interpretationen zulässt und dadurch die Regel präzisiert werden muss. Schließe mit wenigen belastbaren Beispielen, die direkt für Review, Test oder Automatisierung weitergenutzt werden können.

Die Methodenanleitung führt mit 4 Phasen, Zeitrahmen, 4 Stolperfallen und klaren Abbruchkriterien durch die Umsetzung.

Methodenanleitung öffnen

Deine Einschätzung

Hilft dir diese Methode für dein Vorhaben?

Mit deinem Feedback hilfst du, den Methodatlas weiterzuentwickeln.

Quellen und Themen

Themen
Artefakt-Vorlagen
Specification by Example: ArbeitsvorlagePlane Specification by Example mit realem Scope, passenden Rollen und einem klaren Entscheidungsziel.
markdown

specification-by-example-working-template.md

Plane Specification by Example mit realem Scope, passenden Rollen und einem klaren Entscheidungsziel.

Specification by Example: Arbeitsvorlage

Fragestellung

Noch zu klären

Gewünschtes Ergebnis

Noch zu klären

Rahmen

Praxis einrichten und prüfen Zeit: 25–45 Minuten Discovery je kleine Story; Formulation und Automation folgen

Diese Vorlage während der Arbeit auf Papier oder in einem eigenen Dokument ausfüllen.

Vorbereitung für diesen Umfang

Methodische Grundausstattung

  • Materialien: Story oder Regel, reale Fälle, vierfarbige Example-Map-Karten, Domänenvokabular, Feature-Datei und Testzugang.
  • Rollen: Product/Domain Expert · Developer · Tester · optional Facilitator
  • Vorab-Infos: Kleine Änderung auswählen, bekannte Regeln und Vorfälle sammeln und entscheidungsfähige Domainperson einladen.
  • Gesamter Zeitbedarf: 25–45 Minuten Discovery je kleine Story; Formulation und Automation folgen
  • Setup: Story, Regeln, Beispiele und Fragen getrennt darstellen; Gherkin erst nach gemeinsamer Discovery formulieren.

Für die Arbeitsschritte bereitstellen

Entdecken: Regeln mit Beispielen erkunden

  • Kleine Story oder fachliche Änderung
  • Domain Expert, Developer und Tester
  • Bekannte Regeln und Vorfälle

Formulieren: Beispiele als lesbare Spezifikation schreiben

  • Example Map
  • Gemeinsames Domänenvokabular
  • Entschiedene Fragen

Automatisieren: Beispiele mit dem System verbinden

  • Abgestimmte Spezifikation
  • Testzugänge und Daten
  • Produktcode

Pflegen: Lebende Spezifikation erhalten

  • Ausführbare Spezifikation
  • Testergebnisse
  • Neue fachliche Entscheidungen

Regel-Beispiel-Spezifikation

BeispielRegelAusgangslageEreignisBeobachtbares ErgebnisFrage · Grenze
Storno exakt 24 Stunden vorher
  • Storno exakt 24 Stunden vorher: Grenzbeispiel

Geschäftsverhalten beschreiben; UI- und Implementierungsdetails weglassen.

Cucumber: Behaviour-Driven Development

Entdecken: Regeln mit Beispielen erkunden

Erwartetes Artefakt: Example Map

Regeln · Beispiele · Fragen · Scope

Eintrag:

...

  • Illustriert jedes Beispiel genau eine Regel?

Formulieren: Beispiele als lesbare Spezifikation schreiben

Erwartetes Artefakt: Ausführbare Spezifikation

Rule · Example · Given · When · Then

Eintrag:

...

  • Kann eine fachkundige Person das Verhalten ohne Implementierungswissen prüfen?

Automatisieren: Beispiele mit dem System verbinden

Erwartetes Artefakt: Automatisierte Beispiele

Spezifikation · Testbindung · Ergebnis

Eintrag:

...

  • Fehlschlägt das Beispiel aus einem fachlich verständlichen Grund?

Pflegen: Lebende Spezifikation erhalten

Erwartetes Artefakt: Lebende Dokumentation

Aktuelle Regeln · Beispiele · Teststatus

Eintrag:

...

  • Beschreibt jedes grüne Beispiel noch relevantes Verhalten?

Offene Fragen und nächste Schritte

...

Methodenanleitung: https://methodatlas.meierhoff-systems.de/de/methods/specification-by-example/run-sheet

Alternativen und Nachbarn

Passende Alternativen mit Entscheidungshilfe, danach weitere verwandte Methoden.

Alle Methoden
Rahmenbedingungen und Herkunft
MittelWorkshop60-90 min pro Feature

Steckbrief

Methodenform
Workshop-Methode
Teilnehmende
3-6
Zeit
60-90 min pro Feature
Reifegrad
Canonical
Ursprung
Gojko Adzic
Papierillustration für Acceptance Criteria Workshop mit fachlich beschrifteter Arbeitsfläche.
Als Nächstes: Acceptance Criteria Workshop