← Alle Semantic Contracts

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, mit Geschäftsregeln (BR-IDs)
  • 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)
  • Einzelanforderungen in EARS-Syntax wo passend (When/While/If/Shall)
  • Ergänzende Spezifikationen nach Bedarf: Entity Model, State Machines, Interface Contracts, Validierungsregeln

Verwandte Anker