Definition

Spec-before-Generation besagt: Kein KI-generierter Produktionsartefakt ohne vorherige, explizite menschliche Spezifikation.

Gegenteil: Vibe Coding — KI generiert Code direkt aus natürlichsprachigen Anfragen ohne formale Spezifikation, was zu unkontrollierten Ergebnissen führt.

Warum Spec-before-Generation?

Problem: Unkontrollierte KI-Codegenerierung

Ohne Spezifikation entstehen:

Nicht-auditierbare Entscheidungen (“Warum hat die KI X getan?”)
Fehlende Anforderungs-Traceability (Was war die ursprüngliche Anforderung?)
Schwierige Code-Reviews (Reviewer hat keinen Referenzpunkt)
Drift bei iterativen Anfragen (jede Iteration verändert ursprüngliche Absicht)

Lösung: Spec als Prüfpunkt

Anforderung (natürlichsprachig)
        ↓
   [SPEC-GATE] ← HITL: Spec review
Spezifikation (strukturiert, dokumentiert)
        ↓
KI-generiertes Artefakt
        ↓
   [REVIEW-GATE] ← HITL: Code review gegen Spec
Produktionsartefakt

Spezifikations-Formate

Minimalspezifikation (Inline)

## Spec: User Login Component

**Zweck:** Nutzer-Authentifizierung via SSO
**Input:** Email, Passwort (oder SSO-Token)
**Output:** JWT + Session-Cookie
**Constraints:** 
  - DSGVO-konform (kein Tracking)
  - Brute-Force-Schutz (max 5 Versuche)
  - Nur HTTPS
**Tests:** Unit + Integration verpflichtend

Formale Spec (IIO-Standard)

spec:
  id: SPEC-2026-0042
  title: User Login Component
  author: zolo
  created: "2026-05-19"
  status: approved
  requirements:
    - auth via SSO (Keycloak OIDC)
    - DSGVO Art. 25 Privacy by Design
    - No plaintext password storage
  constraints:
    - HTTPS only
    - max_login_attempts: 5
  acceptance_criteria:
    - unit tests pass
    - penetration test: no SQL injection
  hitl_required: true

Verhältnis zu anderen Prinzipien

Prinzip	Verhältnis
HITL	Spec-Gate ist ein HITL-Gate
Fail-Closed	Keine Spec → keine Generierung
Audit Trail	Spec ist Bestandteil des Audit Trails
Vibe Coding	Anti-Pattern zu Spec-before-Generation

EU AI Act Relevanz

Für Hochrisiko-KI-Systeme (Art. 9) ist ein Risikomanagementsystem Pflicht, das “systematische Maßnahmen” bei Entwicklung und Betrieb vorschreibt. Spec-before-Generation ist eine operative Umsetzung dieser Anforderung.

IIO-Implementierung

IIO erzwingt Spec-before-Generation durch:

Coding-Flow — SPEC-REVIEW-GATE vor jeder Codegenerierung
Queue YAML — Specs als maschinenlesbare Anforderungen
Git-Commits — Spec-ID in Commit-Message (Traceability)
CI-Checks — Automated spec-coverage verification

Bevor KI-Agenten Code oder ähnliches generieren, muss zunächst eine explizite Spezifikation existieren, die von Menschen überprüft wurde.

Aprovado

Gerado por: scripts/generate-glossary-register-variants.py (qwen2.5:7b (lokal via Ollama, kein Cloud-Fallback))
Gerado em: 2026-09-21T00:11:29.079655+00:00
Norma: Linguagem simples ~B1 — não a norma alemã de leitura fácil DIN SPEC 33429
Revisado por: zolo · 2026-09-21T00:30:10.463422+00:00

Spec-before-Generation ist ein Governance-Prinzip, das verlangt, dass KI-Agenten keine Code-, Konfiguration- oder Produktionsartefakte generieren dürfen, bevor eine explizite Spezifikation (Spec) von einem Menschen überprüft und dokumentiert wurde. Dies sorgt für eine klare Anforderung an die Vorgehensweise bei der Erstellung technischer Artefakte und verhindert unerwartete oder fehlende Implementierungen.

Aprovado

Gerado por: scripts/generate-glossary-register-variants.py (qwen2.5:7b (lokal via Ollama, kein Cloud-Fallback))
Gerado em: 2026-09-21T00:11:29.079655+00:00
Norma: Linguagem simples ~B1 — não a norma alemã de leitura fácil DIN SPEC 33429
Revisado por: zolo · 2026-09-21T00:30:10.463422+00:00

Citação

"Spec-before-Generation." Open Cognition Commons Foundation. https://opencognitioncommons.org/pt/glossary/spec-before-generation. CC-BY 4.0.

Metadados legíveis por máquina

{
  "@context": "https://schema.org",
  "@type": "DefinedTerm",
  "name": "Spec-before-Generation",
  "description": "Spec-before-Generation ist ein Governance-Prinzip, das vorschreibt: Bevor KI-Agenten Code, Konfiguration oder andere Produktionsartefakte generieren, muss eine explizite, menschlich überprüfte Spezifikation (Spec) vorliegen und dokumentiert sein.\n",
  "url": "https://opencognitioncommons.org/pt/glossary/spec-before-generation",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "alternateName": [
    "Spec-before-Generation",
    "SbG"
  ]
}