Git-Integration

DevFlow integriert sich mit Git, um alle Code-Aenderungen zu verfolgen, die mit einem Flow verbunden sind. Branches, Commits und Pull Requests sind direkt mit Flows verknuepft, sodass du einen klaren Pfad von der Anforderung bis zum gemergten Code hast.

Branch-Erstellung

Wenn der Agent mit der Arbeit an einem Flow beginnt, erstellt er einen Git-Branch nach der Namenskonvention deines Projekts. Das Standardmuster ist:

feature/<display-id>-<slug>

Zum Beispiel wuerde ein Flow mit der Display-ID DF-42 und der Zusammenfassung “Add user login page” folgenden Branch erzeugen:

feature/DF-42-add-user-login-page

Du konfigurierst das Branch-Namensmuster in den Git-Einstellungen deines Projekts. Der Agent folgt diesem Muster automatisch bei jedem Flow.

Commit-Tracking

Jeder Commit, den der Agent erstellt, wird im Flow erfasst. Die Flow-Detailansicht zeigt:

• Commit-Hash — Der vollstaendige Git-Commit-Hash
• Commit-Nachricht — Was in diesem Commit geaendert wurde
• Zeitstempel — Wann der Commit erstellt wurde

So erhaeltst du eine chronologische Aufzeichnung, wie die Implementierung Commit fuer Commit vorangeschritten ist. Du kannst dich zu deinem Git-Anbieter durchklicken, um den vollstaendigen Diff fuer jeden Commit zu sehen.

Pull-Request-Erstellung

Wenn der Agent die Implementierung eines Flows abschliesst, kann er automatisch einen Pull Request erstellen. Der PR enthaelt:

• Einen beschreibenden Titel basierend auf der Flow-Zusammenfassung
• Einen Body mit einer Zusammenfassung der Aenderungen, Testanweisungen und Links zurueck zum Flow
• Den korrekten Ziel-Branch (siehe unten)

Die PR-URL wird im Flow erfasst, sodass du direkt von DevFlow zum Pull Request fuer das Code-Review navigieren kannst.

PR-Ziel

Pull Requests werden automatisch basierend auf deiner Release-Konfiguration ausgerichtet:

• Wenn ein Release aktiv ist — Der PR zielt auf den Release-Branch
• Wenn kein Release aktiv ist — Der PR zielt auf main (oder deinen Standard-Branch)

Das bedeutet, du musst nicht darueber nachdenken, welchen Branch du als Ziel waehlen sollst. DevFlow uebernimmt das basierend auf deinem aktuellen Release-Status.

Git-Einstellungen

Jedes Projekt hat seine eigene Git-Konfiguration. Du kannst diese beim Erstellen eines Projekts einrichten oder spaeter in den Projekteinstellungen aktualisieren. Die verfuegbaren Optionen umfassen:

Branch-Namenskonvention

Definiere das Muster fuer Branch-Namen. Du kannst Variablen verwenden wie:

• <display-id> — Die Display-ID des Flows (z.B. DF-42)
• <slug> — Ein automatisch generierter Slug aus der Flow-Zusammenfassung
• <type> — Der Flow-Typ (feature, bug, chore)

Commit-Konventionen

Konfiguriere, wie Commit-Nachrichten formatiert werden sollen. Der Agent folgt diesen Konventionen beim Erstellen von Commits waehrend der Implementierung.

PR-Vorlagen

Richte Vorlagen fuer Pull-Request-Beschreibungen ein. Der Agent verwendet diese Vorlagen beim Erstellen von PRs und fuellt die relevanten Details aus dem Flow ein.

Kopierfertige Befehle

Die Flow-Detailansicht enthaelt kopierfertige Befehle, die du direkt in dein Terminal einfuegen kannst. Diese sind nuetzlich, wenn du selbst an einem Flow arbeiten oder den Agent unterstuetzen moechtest:

• Branch-Name — Bereit zum Kopieren fuer git checkout -b
• Claude Code-Befehl — Ein vorgefertigter Befehl, um den Agent fuer diesen Flow zu starten

Klicke auf das Kopier-Symbol neben einem dieser Eintraege, um sie in die Zwischenablage zu legen.

Release-Branches

Wenn du ein Release in DevFlow erstellst, kannst du ihm einen eigenen Branch zuweisen. Alle Flows, die diesem Release zugeordnet sind, haben ihre PRs auf den Release-Branch statt auf main ausgerichtet.

Das unterstuetzt einen sauberen Release-Workflow:

1. Erstelle ein Release mit einem Branch (z.B. release/v1.2.0)
2. Ordne Flows dem Release zu
3. Der Agent erstellt PRs, die auf den Release-Branch zielen
4. Wenn alle Flows abgeschlossen sind, merge den Release-Branch nach main

Siehe Releases fuer weitere Informationen zum Release-Management.

Wie alles zusammenhaengt

So fliesst die Git-Aktivitaet durch DevFlow:

1. Flow erstellt — Noch keine Git-Aktivitaet
2. Planung genehmigt — Der Agent erstellt einen Branch nach deiner Namenskonvention
3. In Bearbeitung — Der Agent erstellt Commits, jeder wird im Flow erfasst
4. Review eingereicht — Der Agent erstellt einen PR auf den korrekten Branch
5. Review genehmigt — Der PR ist bereit zum Mergen, der Flow wechselt zu “done”

Jeder Schritt ist in der Flow-Detailansicht sichtbar und gibt dir volle Transparenz von der ersten Idee bis zum gemergten Code.