Vibe Coding Workshop

Spec-Driven
Development

Ein System gegen Rätselraten01 / 08
Die Frage

Was ist Spec-Driven Development?

→

Define what to build before building it

→

Einfach gesagt: Texte, die verschiedene Aspekte eines Projekts erklären.

Kein kompliziertes Format02 / 08
Ein schneller Blick
⌄docs
⌄frontend
↓design.md
↓elements.md
↓postcards.md
›milestones
⌄technical
↓core-architecture.md
↓stripe.md
↓project-overview.md
project-overview.md

Flower postcard shop

The shop is called Paper Flowers.

A highly stylized flower shop where customers choose a postcard design, add a personal message and provide the delivery address. The service prints and sends it.

The sentiment is the same as sending flowers: “I’m thinking of you.” A postcard simply makes the gesture cheaper and easier.

Goal

A simple storefront demo with no backend or Stripe integration.

Audience

  • Core age: 25–45
  • Comfortable with online gifting
  • Birthdays and small celebrations
  • Thank-you gifts
  • Long-distance relationships
  • Personal messages matter
Ein Ordner. Klare Orientierung.03 / 08
Was kann in Specs stehen?

Je nach Projekt.

Website

  • Design
  • Content
  • Verbundene Systeme
  • Grundlegende Architektur

Präsentation

  • Design
  • Content

Internes Tool

  • Problemstellung
  • Angedachte Lösung
Achtung: Hubert aus der IT braucht eine Sonderlösung.
Relevant statt vollständig04 / 08
Wo?

Direkt im Projektordner.

/mein-projekt/docs/
für Claude lesbarfür Codex lesbarfür Menschen lesbar
Die Specs reisen mit dem Projekt05 / 08
Verschiedene Ebenen

Vom Überblick zur Umsetzung.

Ebene 01

Dokumentation

Projektübersicht und Details zu Design, Frontend, Backend oder Systemarchitektur.

→
Ebene 02

Meilensteine

Fassen einen kompletten Feature-Strang zusammen. Sie beschreiben das Was und Wieso.

→
Ebene 03

Tasks

Brechen Meilensteine in kleinere Happen herunter. Sie beschreiben das Wie.

Übersicht → Feature → Arbeitsschritt06 / 08
Warum ist das nötig?
?

Annahmen und Halluzinationen vermeiden.

Je mehr Lücken, desto mehr Fantasie07 / 08
Der Kern

Specs sind das Fundament der KI-Entwicklung.

Sie machen aus einer Idee einen gemeinsamen, belastbaren Ausgangspunkt.

Als Nächstes: die erste Spec.08 / 08