Spezifikation

Was wir meinen, wenn wir 'Spec' sagen

Ein Semantic Contract: Vokabular, das dein Projekt selbst mitliefert — zum Einsetzen in deine CLAUDE.md / AGENTS.md.

Wenn wir von einer "Spezifikation" oder "Spec" sprechen, meinen wir:

Persona Use Cases im Cockburn Fully Dressed Format (Primary Actor, Trigger, Main Success Scenario, Extensions, Nachbedingungen) auf User-Goal-Ebene
Regeln und Anforderungen als eine nummerierte Liste (BR-IDs). Jeder Eintrag ist eine Aussage in einem EARS-Pattern (ubiquitär "shall", ereignisgesteuert "When", zustandsgesteuert "While", unerwünschtes Verhalten "If … then", optionales Feature "Where"), mit seiner Quelle. EARS ist die Grammatik der Regeln, keine zweite Liste: Ein separates Anforderungsregister gibt es nicht.
System Use Cases für jede technische Schnittstelle (API-Endpunkt, CLI-Befehl, Event, Dateiformat): Input/Validierung, Verarbeitung, Output/Statuscodes, Fehlerantworten
Activity Diagrams für alle Abläufe (nicht nur der Happy Path)
Akzeptanzkriterien im Gherkin-Format (Given/When/Then). Jedes Szenario nennt die Regel, die es belegt, mindestens ein Szenario je Use-Case-Extension. Die Regel ist der Vertrag, das Szenario der Beweis.
Ergänzende Spezifikationen nach Bedarf: Entity Model, State Machines, Interface Contracts, Validierungsregeln

Verwandte Anker