Anhang C. Checklisten und Vorlagen

Dieser Anhang kann als Schnellreferenz während der Arbeit am Projekt verwendet werden.

Checkliste vor der Erstellung einer Spezifikation

• Ziel des Features ist klar;
• Zielgruppe ist bekannt;
• Arbeitsgrenzen sind definiert;
• Es ist klar, was nicht zur Aufgabe gehört;
• Stack-Einschränkungen sind bekannt;
• Es gibt mindestens ein überprüfbares Ergebnis;
• Es ist klar, welche Phase der Roadmap umgesetzt wird;
• Kein Geheimnis oder Zugriff erforderlich, der nicht in der lokalen Umgebung vorhanden ist.

Checkliste vor der Implementierung

• requirements.md erstellt;
• plan.md erstellt;
• validation.md erstellt;
• Spezifikation ist committet;
• Dem Agenten wurden Links zu Dateien übergeben, keine lange Chat-Historie;
• Aktueller Branch ist sauber oder der Stand ist klar;
• Feature-Grenzen widersprechen nicht tech-stack.md;
• Im Plan gibt es keine unzusammenhängenden Refactorings.

Checkliste vor dem Merge-Request

• Alle geänderten Dateien sind mit dem Feature verbunden;
• Pflichtfakten aus validation.md wurden überprüft;
• Fehlgeschlagene Fakten sind explizit aufgeführt;
• Zurückgestellte Fakten haben einen Grund;
• Neue Hooks und MCP-Server wurden reviewed;
• Geheimnisse sind nicht in Spezifikationen, Logs und Memory gelandet;
• CHANGELOG.md aktualisiert, falls das Projekt eines führt;
• Roadmap aktualisiert oder es gibt einen Grund, sie in diesem Branch nicht zu aktualisieren.

Merge-Request-Vorlage

## Spezifikation

- Ordner: `specs/YYYY-MM-DD-feature-name/`
- Roadmap-Phase:

## Was geändert wurde

- 

## Überprüfungsfakten

- [ ] `npm run typecheck`
- [ ] `npm test`
- [ ] 

## Nicht überprüfte oder zurückgestellte Fakten

- 

## Änderungen außerhalb der Feature-Grenzen

- Keine / aufzählen:

## Was der Reviewer besonders aufmerksam prüfen sollte

- 

Retrospektive-Vorlage

# SDD-Retrospektive

## Was die Spezifikation richtig beschrieben hat

## Was der Agent selbst ableiten musste

## Was die Überprüfung aufgedeckt hat

## Welche Fakten schwach waren

## Was in QWEN.md oder specs/ übernommen werden soll

## Was aus dem Prozess entfernt werden soll

Checkliste für eine neue Sitzung nach /clear

• Agent hat QWEN.md oder AGENTS.md gelesen;
• Agent hat mission.md gelesen;
• Agent hat tech-stack.md gelesen;
• Agent hat den benötigten Feature-Ordner gelesen;
• Agent weiß, welche Dateien nicht geändert werden dürfen;
• Agent weiß, welche Überprüfungsbefehle erwartet werden;
• Agent hält nach dem Bericht an, wenn die Aufgabe nur recherchierender Natur ist.

Minimaler Request für Implementierungsreview

/clear
Lies @QWEN.md, die Spezifikation des aktuellen Features und git diff.
Vergleiche die Implementierung mit requirements.md, plan.md und validation.md.
Zeige:
- Übereinstimmungen;
- Abweichungen;

- Nicht überprüfte Fakten;
- Änderungen außerhalb der Feature-Grenzen.
Ändere keine Dateien.

Minimaler Request für Neubewertung

/clear
Lies @specs/mission.md, @specs/tech-stack.md, @specs/roadmap.md,
jüngste Feature-Spezifikationen und @CHANGELOG.md.
Zeige, was vor der nächsten Phase aktualisiert werden muss.
Ändere keine Dateien, bis ich zustimme.