Agent Flow-Workflow

Wenn ein KI-Agent an einem Flow in DevFlow arbeitet, folgt er einem strukturierten Prozess von Anfang bis Ende. Diese Seite beschreibt jeden Schritt dieses Prozesses und was in jeder Phase passiert.

Der vollstaendige Workflow

Schritt 1: Einen Flow aufnehmen

Der Agent beginnt damit, einen Flow zur Bearbeitung auszuwaehlen. Er ruft devflow_init mit der Flow-ID auf, wodurch der Flow fuer diese Agent Session gesperrt wird. Das verhindert, dass mehrere Agents gleichzeitig am selben Flow arbeiten.

Du kannst einem Agent einen Flow zuweisen, indem du ihn nach planning verschiebst, oder der Agent kann jeden Flow aufnehmen, der sich im Status “ready” befindet.

Schritt 2: Anforderungen analysieren

Bevor der Agent irgendeinen Plan schreibt, liest er die Zusammenfassung, Beschreibung und Akzeptanzkriterien des Flows. Er erkundet ausserdem deine Codebasis, um Folgendes zu verstehen:

Bestehende Code-Struktur und Muster
Zugehoerige Dateien und Module
Test-Konventionen
Abhaengigkeiten, die betroffen sein koennten

Diese Analysephase stellt sicher, dass der Agent den vollstaendigen Kontext versteht, bevor er Aenderungen vorschlaegt.

Schritt 3: Einen Implementierungsplan erstellen

Der Agent erstellt einen detaillierten Plan, der Folgendes umfasst:

Ansatz — Wie die Aufgabe umgesetzt wird
Dateiaenderungen — Welche Dateien erstellt, geaendert oder geloescht werden
Architekturentscheidungen — Strukturelle Entscheidungen und deren Begruendung
Tasks — Eine Aufgliederung in einzelne Schritte, jeweils mit Akzeptanzkriterien
Risiken und Ueberlegungen — Moegliche Probleme oder Randfaelle

Der Plan ist in einfacher Sprache verfasst, damit du ihn pruefen kannst, ohne Code lesen zu muessen.

Schritt 4: Zur Genehmigung einreichen

Der Flow wechselt in den Status approval. Das ist eine Schranke — es wird kein Code geschrieben, bis du den Plan geprueft und genehmigt hast.

Du erhaeltst den Plan in der Flow-Detailansicht, wo du:

Den vollstaendigen Plan lesen kannst
Die vorgeschlagenen Tasks pruefen kannst
Genehmigen kannst, um fortzufahren
Mit spezifischem Feedback ablehnen kannst

Siehe Planung und Review fuer weitere Details zu diesem Prozess.

Schritt 5: Mit der Implementierung beginnen

Nachdem du den Plan genehmigt hast, wechselt der Flow zu ready und dann zu in_progress, wenn der Agent mit dem Programmieren beginnt. Der Agent folgt dem genehmigten Plan und implementiert jeden Task der Reihe nach.

Schritt 6: Fortschritt ueber Tasks verfolgen

Waehrend der Agent arbeitet, markiert er Tasks einzeln als erledigt. Du kannst diesen Fortschritt in Echtzeit in der Flow-Detailansicht oder auf dem Kanban-Board verfolgen. Jeder Task hat eigene Akzeptanzkriterien, sodass du genau sehen kannst, was der Agent fuer jeden Schritt als “erledigt” betrachtet.

Schritt 7: Commits erstellen und Git-Aenderungen verfolgen

Der Agent erstellt Git-Commits waehrend der Arbeit und folgt dabei den Konventionen deines Projekts:

Branch-Benennung — Verwendet das in deinen Projekteinstellungen konfigurierte Muster
Commit-Nachrichten — Folgt dem Commit-Nachrichtenformat deines Projekts
Commit-Tracking — Jeder Commit-Hash und jede Nachricht wird im Flow erfasst

Alle Git-Aktivitaeten sind mit dem Flow verknuepft, sodass du einen klaren Pfad von der Anforderung bis zum Code hast.

Schritt 8: Zur Pruefung einreichen

Wenn die Implementierung abgeschlossen ist, verschiebt der Agent den Flow nach review und liefert:

Agent-Zusammenfassung — Eine Beschreibung dessen, was implementiert wurde und welche Entscheidungen getroffen wurden
Testanweisungen — Eine Schritt-fuer-Schritt-Anleitung, wie die Aenderungen verifiziert werden koennen
PR-Link — Ein Link zum Pull Request, falls einer erstellt wurde
Commit-Liste — Alle Commits, die mit diesem Flow verknuepft sind

Schritt 9: Du testest und entscheidest

Du pruefst die Implementierung, indem du:

Die Zusammenfassung des Agents liest
Den Testanweisungen folgst
Den PR und die Code-Aenderungen pruefst
Die Anwendung startest, um das Verhalten zu verifizieren

Dann entscheidest du:

Genehmigen — Der Flow wechselt zu done. Die Arbeit ist abgeschlossen.
Mit Feedback ablehnen — Der Flow kehrt zu in_progress zurueck. Der Agent liest dein Feedback und nimmt die gewuenschten Aenderungen vor.

Git-Einstellungen-Integration

Der Agent beachtet die Git-Konfiguration deines Projekts waehrend des gesamten Workflows:

Branch-Namenskonvention — Der Agent erstellt Branches nach deinem Muster (z.B. feature/<display-id>-<slug>)
Commit-Konventionen — Commit-Nachrichten folgen deinem konfigurierten Stil
PR-Ziel — Pull Requests werden gegen den aktiven Release-Branch erstellt, oder gegen main, wenn kein Release aktiv ist

Du konfigurierst diese Einstellungen einmal in den Git-Einstellungen deines Projekts. Der Agent folgt ihnen automatisch bei jedem Flow.

Was passiert, wenn etwas schiefgeht

Agent stoesst auf einen Fehler — Er protokolliert den Fehler in der Session und bittet moeglicherweise um Klaerung
Plan wird abgelehnt — Der Agent ueberarbeitet ihn basierend auf deinem Feedback und reicht ihn erneut ein
Review wird abgelehnt — Der Agent kehrt zur Implementierung zurueck und bearbeitet deine Anmerkungen
Session wird unterbrochen — Der Flow bleibt in seinem aktuellen Status. Eine neue Agent Session kann dort weitermachen, wo die vorherige aufgehoert hat