Planung & Review

DevFlow erzwingt zwei menschliche Checkpoints in jedem Flow: Plangenehmigung bevor Code geschrieben wird, und Code-Review bevor etwas gemergt wird. Diese Schranken stellen sicher, dass du die Kontrolle darueber behaeltst, was die KI baut und wie sie es baut.

Planungsphase

Was der Agent liefert

Wenn der Agent die Analyse deines Flows abgeschlossen hat, erstellt er einen Implementierungsplan, der typischerweise Folgendes enthaelt:

• Zusammenfassung des Ansatzes — Eine uebergeordnete Beschreibung, wie die Aufgabe umgesetzt wird
• Dateiaenderungen — Welche Dateien erstellt, geaendert oder entfernt werden
• Architekturentscheidungen — Strukturelle Entscheidungen und deren Begruendung
• Tasks mit Akzeptanzkriterien — Eine schrittweise Aufgliederung der Arbeit, jeweils mit klaren Abschlusskriterien
• Risiken und Randfaelle — Moegliche Probleme, die der Agent identifiziert hat

Der Plan ist fuer dich geschrieben — er erklaert das “Was” und “Warum” in einfacher Sprache, nicht nur das “Wie”.

Die Genehmigungs-Schranke

Sobald der Plan eingereicht ist, wechselt der Flow in den Status approval. Das ist eine harte Schranke:

• Der Agent kann keinen Code schreiben, bis du den Plan genehmigst
• Der Flow bleibt im Status “approval”, bis du handelst
• Niemand sonst kann den Flow vorantreiben — nur du (oder ein Projekt-Admin) kannst genehmigen
• Du erhaeltst eine “Action Required”-Benachrichtigung im Glocken-Icon, damit du weisst, dass der Plan auf dein Review wartet

Das verhindert, dass die KI grosse, moeglicherweise unerwuenschte Aenderungen an deiner Codebasis vornimmt, ohne dass du davon weisst.

Einen Plan genehmigen

Wenn der Plan gut aussieht, klicke auf Genehmigen. Der Flow wechselt zu ready, und der Agent kann mit der Implementierung beginnen.

Bevor du genehmigst, ueberlege:

• Ist der Ansatz fuer deine Codebasis sinnvoll?
• Sind die Dateiaenderungen angemessen?
• Decken die Tasks alle Akzeptanzkriterien ab?
• Gibt es Risiken, die der Agent uebersehen hat?

Einen Plan ablehnen

Wenn der Plan Aenderungen braucht, klicke auf Ablehnen und gib spezifisches Feedback. Zum Beispiel:

• “Verwende die bestehende Authentifizierungs-Middleware, anstatt eine neue zu erstellen”
• “Das sollte eine separate Komponente sein, nicht in die bestehende Datei eingefuegt werden”
• “Der Plan behandelt die Fehlerbehandlung fuer die API-Aufrufe nicht”

Der Flow kehrt zu planning zurueck, und der Agent ueberarbeitet den Plan basierend auf deinem Feedback. Er reicht einen aktualisierten Plan zur Genehmigung ein.

Du kannst so oft ablehnen und Ueberarbeitungen anfordern, wie noetig. Der Zyklus wird fortgesetzt, bis du mit dem Plan zufrieden bist.

Review-Phase

Was du erhaeltst

Nachdem der Agent die Implementierung abgeschlossen hat, wechselt der Flow zu review. Du erhaeltst eine “Action Required”-Benachrichtigung im Glocken-Icon, zusammen mit:

• Agent-Zusammenfassung — Eine Beschreibung dessen, was implementiert wurde, einschliesslich etwaiger Abweichungen vom urspruenglichen Plan und deren Gruende
• Testanweisungen — Schritt-fuer-Schritt-Anweisungen zur Verifizierung, dass die Aenderungen korrekt funktionieren
• Pull-Request-Link — Ein direkter Link zum PR mit allen Code-Aenderungen
• Commit-Historie — Eine Liste aller Commits, die mit diesem Flow verknuepft sind

Die Aenderungen testen

Folge den Testanweisungen, die der Agent bereitgestellt hat. Diese umfassen typischerweise:

1. Schritte zum Einrichten oder Ausfuehren des Features
2. Erwartetes Verhalten zur Verifizierung
3. Randfaelle, die geprueft werden sollten
4. Manuelle Pruefungen, die automatisierte Tests nicht abdecken

Nimm dir die Zeit, tatsaechlich zu testen. Der Wert der Review-Schranke haengt von gruendlicher Verifizierung ab.

Das Review genehmigen

Wenn die Aenderungen korrekt funktionieren und deinen Standards entsprechen, klicke auf Genehmigen. Der Flow wechselt zu done, und die Arbeit ist abgeschlossen.

Mit Feedback ablehnen

Wenn etwas nicht stimmt, klicke auf Ablehnen und beschreibe, was geaendert werden muss:

• “Der Ladezustand flackert beim Tab-Wechsel”
• “Fehlermeldungen werden dem Benutzer nicht angezeigt”
• “Die Sortierreihenfolge ist falsch — es sollte die neuesten zuerst anzeigen”

Der Flow kehrt zu in_progress zurueck, und der Agent liest dein Feedback. Er nimmt die gewuenschten Aenderungen vor und reicht erneut zum Review ein.

Wie bei der Planung kannst du so oft ablehnen, wie noetig, bis die Implementierung deinen Erwartungen entspricht.

Audit Trail

DevFlow zeichnet jede Genehmigung und Ablehnung mit vollstaendigen Details auf:

Ereignis	Was erfasst wird
Plan erstellt	Wer ihn erstellt hat (welcher Agent), wann
Plan genehmigt	Wer ihn genehmigt hat, wann
Plan abgelehnt	Wer ihn abgelehnt hat, wann, mit welchem Feedback
Implementierung gestartet	Welcher Agent, wann
Code zum Review eingereicht	Wann, mit Zusammenfassung und Testanweisungen
Code genehmigt	Wer ihn genehmigt hat, wann
Code abgelehnt	Wer ihn abgelehnt hat, wann, mit welchem Feedback

Dieser Audit Trail ist dauerhaft mit dem Flow verbunden. Monate spaeter kannst du jeden abgeschlossenen Flow ansehen und die vollstaendige Entscheidungshistorie nachvollziehen — wer den Plan genehmigt hat, wer den Code reviewed hat und welches Feedback unterwegs gegeben wurde.

Tipps fuer effektive Reviews

• Sei spezifisch im Feedback — “Repariere das Layout” ist weniger hilfreich als “Die Seitenleiste ueberlappt den Hauptinhalt auf Bildschirmen schmaler als 1024px”
• Pruefe Plaene sorgfaeltig — Probleme in der Planungsphase zu erkennen spart Implementierungszeit
• Teste gruendlich — Starte das Feature, probiere Randfaelle aus, pruefe Fehlerzustaende
• Pruefe Akzeptanzkriterien — Vergleiche die Implementierung mit den urspruenglichen Akzeptanzkriterien des Flows