jintomjose/mini-software-factory

Spezifikation schreiben

Eingabe: work/<feature>/intent.md. Ausgabe: work/<feature>/spec.md aus factory/templates/spec.md.

1. Lies intent.md, CLAUDE.md und die Teile des Codes, die die Änderung berührt. Eine Spezifikation, die ohne Code-Lektüre geschrieben wird, übersieht Randbedingungen – das ist der häufigste Fehler.
2. Schreibe User Stories in Prioritätsreihenfolge (P1, P2, P3). Jede P1-Story muss unabhängig auslieferbar und testbar sein.
3. Versehe jede funktionale Anforderung mit einer stabilen ID (FR-001) und jedes Erfolgskriterium ebenfalls mit einer stabilen ID (SC-001). Reviews und Tests beziehen sich auf diese IDs.
4. Markiere im Text, kläre niemals stillschweigend:
   • [NEEDS CLARIFICATION: ...] für jede Entscheidung, die die Absicht nicht festlegt
   • [POLICY: privacy | security | legal | money | brand] immer dann, wenn eine Richtlinie greift, samt der Richtlinie
5. Schreibe den Design-Abschnitt nur so tief, wie der Plan es braucht: Datenänderungen, Schnittstellen, Zustände, Fehlerfälle.
6. Liste auf, was explizit außerhalb des Umfangs liegt.
7. Zeige die Spezifikation, kläre jedes [NEEDS CLARIFICATION] mit dem Menschen, dann speichere. Das Committen der spec.md ist der Auslöser für den Plan-Modus.