Eine Spezifikation hält eine Anforderung als Text fest: Ziel, Begriffe, nummerierte Regeln (R1, R2 …), konkrete Beispiele als Szenarien, offene Fragen und nicht-funktionale Anforderungen. Die Szenarien sind Gherkin-Blöcke („Angenommen … Wenn … Dann …") und lassen sich als .feature-Dateien exportieren.
Die Übersicht zeigt, welche Regel schon durch Beispiele belegt ist und welche Fragen offen sind. Das Prüfergebnis meldet unter anderem Widersprüche (gleiche Ausgangslage und Handlung, aber anderes Ergebnis), Regeln ohne Beispiel, Fragen zu unbekannten Regeln und Oberflächenbegriffe in fachlichen Szenarien. Keine Prüfung blockiert das Speichern; nur der .feature-Export braucht eine fehlerfreie Spezifikation.
Format-Beschreibung: docs/spec-format-spec.md (bdt-spec/0.1).
Zeile anklicken öffnet die Spezifikation – eine Zeile markieren schaltet die Aktionen rechts frei.
Regeln (blau) mit Beispielen (grün) belegen, Unklares als Frage (rot) festhalten. Ein Beispiel zuerst als einen Satz notieren („Auftrag ohne Position, sichern → Meldung") und erst danach als Szenario ausformulieren. Änderungen am Board schreiben den Text in kanonischer Form neu.
Der Text ist die einzige Wahrheit (Format bdt-spec/0.1). Fehler blockieren nicht das Speichern, nur den .feature-Export. Doc-Strings in Szenarien mit """ schreiben.
Lesesicht auf die Gherkin-Blöcke, gruppiert nach Regel. Klick auf Regel oder Szenario springt im Text an die Stelle.
Szenarien mit @ui oder @mockup:<Seite> laufen gegen das gebundene Mockup. Grün heißt: das Mockup entspricht der Erwartung – nicht: die Erwartung ist richtig. Grau sind Schritte außerhalb des gebundenen Vokabulars (manuell prüfen).
Seiten über ihren Titel, Felder über Bezeichnung oder technischen Namen, Aktionen über ihre Beschriftung. Im UI-Mockup-Studio entsteht dieses Vokabular auch automatisch: im Simulator „Aufzeichnen" wählen, klicken, Erwartung nennen.
Szenarien mit @mcp rufen Tools, Ressourcen und Prompts eines MCP-Servers auf – gegen den gebundenen MCP Simulator oder, als Abnahmetest, gegen einen echten Server aus den MCP-Inspector-Profilen. Beim echten Server laufen Tools, die er nicht als nur lesend kennzeichnet, erst nach einer Rückfrage. Grün heißt: der Server antwortet wie erwartet – nicht: die Erwartung ist richtig.
„Szenarien aus Beispielen“ legt je aufgezeichnetes Beispiel des Simulators ein Szenario an (vorhandene Namen werden übersprungen).
Woher die Anforderung kommt. Jede Bindung landet im Frontmatter; alles, was hier entsteht, ist ein Vorschlag (Entwurf im Formular, Regeln/Skizzen auf dem Board) – geprüft und ergänzt wird im Example Mapping.
Ideen und Prototypen werden Regeln, Tests und Feedback Beispielskizzen (mit @story:<Id>), Annahmen Fragen. Eine Szene wird zum Szenario-Entwurf: Auftritte → Angenommen, Sprechen/Testen → Wenn, gezeigte Karten → Dann.
Ist ein Katalog gebunden, prüft das Studio Beispielspalten mit technischem Feldnamen (z. B. NETWR, VBAK-NETWR) gegen ihn, und das Ausformulieren-Formular bietet die Felder zum Einfügen an.
Die markierten Schritte werden Wenn-Schritte, die Transaktion der ersten Marke die Ausgangslage; das erwartete Ergebnis (Dann) formulierst du – die Aufzeichnung kennt nur den Weg. @process:<Marke> hält den Bezug.
Übergabe an die Entwicklung. Alles hier ist eine Vorlage aus den Szenarien – nichts wird in ein SAP-System geschrieben. Szenarien mit @validation, @determination oder @action[:Name] werden zu BDEF-Fragmenten, jedes Szenario zu einer Testmethode.
Die Spezifikation wird als Dokument vom Typ GUIDE abgelegt (ein erneutes Ablegen aktualisiert dasselbe Dokument), offene Fragen mit Nummer optional als ISSUE. Braucht einen AIPC-Endpunkt mit „Schreibzugriffe erlaubt" und das Häkchen „ADT-Schreibzugriffe" unter Erweiterte Verwendung.
Links einen Baustein wählen.
Legt den Text als Baustein in diesem Projekt ab (erscheint danach im Bausteine-Baum unter „Sonstige").