Lab 3: Spec-Mini

Spec-Driven Design kompakt: Think before Typing

← Zurück zur Übersicht

Modus: Spec Dauer: ca. 15-20 Minuten Zeigt: alle drei Artefakte, Think before Typing

Wichtig: Wir erstellen alle drei Spec-Artefakte (requirements.md, design.md, tasks.md), führen die Tasks aber bewusst nicht aus. Ziel ist, den Spec-Workflow und die drei Artefakte zu erleben, nicht ein ganzes Feature zu bauen. So bleibt die Übung kurz und der Fokus liegt auf den Artefakten.

Ziel

Für eine kleine Erweiterung des Kanban-Boards aus Lab 2 lässt du Kiro eine vollständige Spec erstellen — also requirements.md, design.md und tasks.md — und hältst vor der Ausführung der Tasks an (kein Code). Dadurch wird der Unterschied zum schnellen Chat-Modus greifbar.

Vorbereitung

  • Das Projekt aus Lab 2 (Kanban-Board) geöffnet.
  • In Kiro den Spec-Modus wählen (statt Chat).

Schritt 1 – Spec starten

Formuliere das gewünschte Feature. Beispiel:

Erstelle eine Spec für ein Filter-Feature im Kanban-Board:
Man soll die Karten nach Fälligkeitsdatum filtern können
(z. B. "nur heute fällige", "diese Woche", "alle").
Erzeuge zunächst nur die Requirements. Noch keinen Code.

Schritt 2 – requirements.md prüfen

  • Kiro erzeugt requirements.md mit User Stories und Akzeptanzkriterien (oft in EARS-Notation: „WENN … DANN soll das System …“).
  • Gemeinsam lesen: Ist das „Was“ vollständig und verständlich?
  • Bei Bedarf verfeinern (z. B. „Ergänze ein Kriterium für den leeren Filterzustand“).

Schritt 3 – design.md erzeugen

Erstelle jetzt das Design (design.md) für dieses Feature:
Datenfluss, betroffene Funktionen/Strukturen und wie der Filter im
bestehenden Board integriert wird. Weiterhin kein Code.
  • design.md ansehen: Architektur, Datenfluss, ggf. ein kleines Diagramm.

Schritt 4 – tasks.md erzeugen

Jetzt lassen wir Kiro auch die Task-Liste generieren — die dritte und letzte Spec-Datei:

Erstelle jetzt die Task-Liste (tasks.md) für dieses Feature.
Nur die Aufgaben auflisten und sequenzieren – die Tasks aber noch
NICHT ausführen und keinen Code schreiben.
  • tasks.md ansehen: diskrete, nachvollziehbare Aufgaben mit Reihenfolge und Abhängigkeiten.
  • Jetzt liegen alle drei Artefakte vor: requirements.md (Was) → design.md (Wie) → tasks.md (Ausführungsplan).

Schritt 5 – Tasks bewusst NICHT ausführen

  • Wir gehen nicht weiter zur Umsetzung. Klicke also nicht auf „Start task“ / „Run all tasks“ / „Implementieren“, auch wenn Kiro es anbietet.
  • Schau dir stattdessen in Ruhe die drei erstellten Dateien an: requirements.md (das Was), design.md (das Wie) und tasks.md (der Plan).
  • Kurz für dich festhalten: Was ist hier anders als im Chat-Modus, wo sofort Code kommt?

Erwartetes Ergebnis

Drei nachvollziehbare Artefakte (requirements.md, design.md, tasks.md) im Ordner .kiro/specs/…, die das Feature beschreiben und einen Ausführungsplan enthalten — ohne dass Code entstanden ist (die Tasks wurden nicht ausgeführt).

Lernpunkte

  • Spec-Driven erzwingt eine „Denk-Pause“ vor dem Coden (Think before Typing).
  • Die drei Artefakte: requirements (Was) → design (Wie) → tasks (Ausführung).
  • Ergebnisse sind nachvollziehbar und für Teams prüf-/freigebbar (auditierbar).
  • Spec-Driven für Produktion, Chat-Modus für schnelle Prototypen.