Skip to main content

Spezifikation vor Code (Spec-First Vibe Coding)

FÜR AI-AGENTENChatGPTClaude

Eine KI-gestützte Entwicklungsmethodik (Spec-Driven Development). Anstatt sofort chaotischen Code zu generieren, lässt der Entwickler das Modell zunächst eine strukturierte SPEC.md-Datei erstellen, die Architektur, Datentypen und Implementierungsschritte definiert.

1. Überblick über das Konzept und den Zweck

Die größte Versuchung für Einsteiger im Vibe Coding ist die Geschwindigkeit. Es scheint, als liege die Magie der KI darin, einen einzigen Satz einzugeben: „Erstelle mir ein Abonnement-System mit Stripe, einem Benutzer-Dashboard und einer Datenbank“ – und zuzusehen, wie in 30 Sekunden eine Menge Code entsteht.

Doch in 95 % der Fälle endet diese Euphorie im Chaos: Das Projekt wirft 50 rote Kompilierungsfehler, Datenbank-Migrationen kollidieren miteinander, und Versuche, mit „Fix this!“ nachzubessern, verschlimmern die Situation nur noch, indem sie bereits funktionierenden Code überschreiben.

Die Spec-First-Methodologie (Spezifikation vor Code) ist der Goldstandard für reife Entwicklung mit KI. Sie basiert auf einer eisernen Regel:

Keine Zeile Code, bis der Architekturplan in der Datei SPEC.md von einem Menschen gelesen und freigegeben wurde!

2. Mentales Modell: Chaotisches Coden vs. Spec-First

┌─────────────────────────────────────────────────────────────┐
│                 ДВА ПІДХОДИ ДО ВАЙБКОДИНГУ                  │
├─────────────────────────────────────────────────────────────┤
│ ❌ Хаотичний підхід (Vibe & Pray):                          │
│    «Напиши всю фічу одразу»                                 │
│    ➔ ШІ нагенерував 500 рядків каші                         │
│    ➔ Нічого не працює ➔ 3 години дебагу та нервів           │
├─────────────────────────────────────────────────────────────┤
│ ✅ Підхід Spec-First (Дисциплінований інжиніринг):          │
│    1. Складаємо `SPEC.md` (Архітектура та кроки)            │
│    2. Людина вичитує план: «Отут поправ логіку»             │
│    3. Тільки після ОК: Агент реалізує Крок 1 ➔ Перевірка    │
│    4. Агент реалізує Крок 2 ➔ Перевірка                     │
│    ➔ Чистий, працюючий проект з першого разу!               │
└─────────────────────────────────────────────────────────────┘

3. Die vier Schritte der Methodologie in der Praxis

  1. Schritt 1: Planungs-Prompt:

    „Schreibe keinen Code! Wir planen, ein Kommentarsystem unter Artikeln hinzuzufügen. Erstelle eine SPEC.md, in der du beschreibst: das Schema der Datenbank-Tabelle, die benötigten API-Routen, eine Liste der neuen Komponenten sowie vier schrittweise Implementierungsaufgaben.“

  2. Schritt 2: Menschliches Review: Du öffnest die erstellte SPEC.md, liest sie und nimmst Änderungen vor: „Lass uns anonyme Kommentare entfernen, nur nach Login erlauben.“
  3. Schritt 3: Schrittweise Ausführung (Execution):

    „Der Plan ist genehmigt. Führe jetzt NUR Aufgabe 1 aus der Spezifikation durch (erstelle das Tabellen-Schema und die Migration). Rühre den Rest nicht an.“

  4. Schritt 4: Verifizierung: Du prüfst, ob die Migration erfolgreich durchgeführt wurde, und gibst erst dann den Befehl, zu Aufgabe 2 überzugehen.

4. Warum dich das zum 10x-Ingenieur macht

Der Spec-First-Ansatz verwandelt dich von einem ratlosen Nutzer, der einen Bot bittet, eine kaputte Website zu reparieren, in einen Technical Director (CTO). Du steuerst Strategie und Architektur, während die KI gehorsam die Rolle eines schnellen, aber disziplinierten Ausführers übernimmt.

/ Häufig gestellte FragenSchema.org FAQPage

FAQ: Spezifikation vor Code (Spec-First Vibe Coding)

Wenn das Modell Hunderte Zeilen Code ohne vorher abgestimmten Plan schreibt, trifft es viele versteckte Annahmen: Es wählt unbequeme Datenbankstrukturen, erfindet unnötige Bibliotheken und erstellt inkonsistente Typen. Wenn Sie feststellen, dass der Code nicht funktioniert, ist es extrem schwierig, dieses verworrene Durcheinander zu korrigieren.
/ Interne Links
Alle Begriffe