Wie man einem Coding-Agenten eine ausführbare Spezifikation gibt

Coding-Agenten arbeiten am besten mit konkreten Schritten und sichtbarem Erfolg. Microsoft beschreibt spec-driven development mit einer lebenden, versionierten Spezifikation als Quelle der Wahrheit.

1. Ergebnis zuerst

Beschreibe Nutzer und beobachtbares Verhalten, bevor du Dateien auswählst.

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. Abnahmekriterien

Normalfall, leere Zustände, ungültige Eingaben, Berechtigungen und Fehler gehören in die Kriterien.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. Erst untersuchen, dann planen

Lass den Agenten Routen, Komponenten, Datenzugriff und Tests kartieren, einen kurzen Plan liefern und offene Fragen nennen. Prüfe bestehende Verträge.

4. Ausführbar machen

Lege die Spezifikation in einem gepflegten versionierten Dokument oder issue ab und verknüpfe jedes Kriterium mit einem Test oder einer manuellen Prüfung.

5. Menschliche Stopppunkte

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. Aktualisieren

Die Spezifikation ist kein einmaliger Prompt. Wenn Tests oder Produktentscheidungen neue Regeln zeigen, aktualisiere sie und gleiche den Code erneut ab. Beginne klein und verlange Evidenz für jedes Kriterium.