EntwicklungZuletzt aktualisiert: 22. September 2026

Was ist Specification?

Eine Spezifikation (kurz Spec, deutsch Lastenheft oder Pflichtenheft) ist ein technisches Dokument, das beschreibt, was ein Produkt leisten soll und welche Regeln dabei gelten.

Definition und Wortherkunft

Es ist wie der architektonische Entwurf eines Gebäudes: Bevor der Entwickler mit dem Programmieren beginnt, schaut er sich das Dokument an und versteht, was er bauen soll. Es reduziert Fehler und klärt Erwartungen. In der API-Welt übernimmt OpenAPI diese Aufgabe, in der Hardware sind es Datenblätter (Datasheets).

Analogie: Es ist wie die Zutatenliste und die Kochschritte in einem Rezept; Wenn Sie sich nicht an das Rezept halten, schmeckt das Essen anders.

Wie kann man es kennen und im täglichen Leben anwenden?

Software: Dokument für Funktionen und Regeln.
Ausschreibung: Technische Spezifikationsdatei.
Produkt: Design- und Abnahmekriterien.

Technische Tiefe und Architektur

Eine gute Spezifikation enthält:

Umfang: Was enthalten ist und was nicht.
Abnahmekriterium: Testbare Bedingungen für den Status 'Fertig'.
Grenzen: Leistung, Sicherheit, Kompatibilität.
Release: Änderungshistorie.

Entsprechung des API-Endpunkts zur Spezifikation:

paths:
  /siparis:
    post:
      summary: Yeni sipariş oluşturur

Regel: Was nicht messbar ist, ist keine Spezifikation, sondern ein Wunsch. Jeder Punkt muss testbar geschrieben werden.

Häufig gemischte Dinge

Ähnlich wie eine Anforderung (Requirement). Eine Anforderung besagt, was gewünscht ist, eine Spezifikation erklärt, wie es umzusetzen ist. Das eine ist das Ziel, das andere der Plan.

Einsatz in verschiedenen Disziplinen

Rezept: Material- und Schrittliste.
Montageanleitung: Teile- und Reihenfolgeschema.
Ausschreibung: Administrative und technische Spezifikation.

Fragen und Antworten

Kann sich die Spezifikation ändern?

Ja, aber jede Änderung muss mit ihren Auswirkungen auf Kosten und Zeitplan genehmigt werden.

Wer schreibt die Spec-Datei?

Der Produktmanager, Ingenieur oder Analyst schreibt sie. Wichtig sind ein einzelner Verantwortlicher und eine Versionsdisziplin.

Wie viel Detail ist erforderlich?

Genug, um Unklarheiten zu beseitigen. Zu viel ermüdet den Autor, zu wenig blockiert den Entwickler.

Gibt es Specs in Agile?

Ja, in schlanker Form. User Stories mit Akzeptanzkriterien und API-Verträge fungieren als Spezifikationen.