Projekte

Projekte sind die oberste Organisationsebene in DevFlow. Jeder Flow, jedes Release, jeder Zeiteintrag und jede Teamzuweisung lebt innerhalb eines Projekts. Egal ob du ein einzelnes Produkt entwickelst oder mehrere verwaltest — jedes Projekt bietet dir einen eigenen Arbeitsbereich mit eigenem Kanban Board, Dashboard und eigenen Einstellungen.

Projekt erstellen

1. Klicke auf “New Project” in der Seitenleiste oder auf dem Dashboard
2. Gib einen Projektnamen ein
3. Optional: Fuege eine Beschreibung, ein Logo und eine Farbe hinzu
4. Klicke auf Create

Dein Projekt erscheint sofort in der Seitenleiste. Du wirst auf die Projekteinstellungen weitergeleitet, wo du weitere Details konfigurieren kannst.

Projekteinstellungen

Oeffne die Einstellungen ueber das Zahnrad-Symbol auf der Projektseite. Die Einstellungen sind in fuenf Tabs organisiert.

Allgemein

• Projektname und Beschreibung — Identifizieren dein Projekt. Aenderungen werden automatisch gespeichert, waehrend du tippst.
• Flow Prefix — Ein 2-5 Zeichen langer Code, der fuer Flow-IDs verwendet wird. Wenn das Prefix z.B. MA ist, werden Flows als MA-1, MA-2 usw. nummeriert. DevFlow schlaegt automatisch ein Prefix basierend auf dem Projektnamen vor.
• Farbe — Waehle eine Farbe, um dieses Projekt in der Seitenleiste, im Timer und in den Time Tracking-Ansichten visuell hervorzuheben.
• Logo — Lade ein Bild hoch (PNG, JPG oder SVG, max. 500 KB) oder fuege eine Bild-URL ein. Das Logo erscheint in der Seitenleiste und auf Projektkarten.
• Auto Timer — Wenn aktiviert, startet der Timer automatisch und wechselt den Kontext, wenn du in diesem Projekt an Flows arbeitest.
• Tracking Level — Waehle, auf welcher Ebene die Zeit erfasst wird: Projekt, Flow oder Ticket.
• Takt (Rundung) — Lege ein projektspezifisches Rundungsintervall fuer Zeitbloecke fest (5, 15, 30 oder 60 Minuten). Leer lassen, um den globalen Standard zu verwenden.
• Projekt uebertragen — Eigentuemer koennen ein Projekt zwischen ihrem persoenlichen Bereich und einer Organisation verschieben.
• Projekt loeschen — Entfernt das Projekt dauerhaft. Nur fuer den Projekteigentuemer verfuegbar.

Team

Wenn dein Projekt zu einer Organisation gehoert, zeigt der Team-Tab alle Mitglieder und ihre Rollen an. Du kannst verwalten, wer Zugriff hat und welche Berechtigungen sie besitzen.

Bei persoenlichen Projekten (ausserhalb einer Organisation) bist du das einzige Mitglied.

Knowledge

Speichere projektspezifische Dokumentation, Architektur-Notizen, Tech-Stack-Details und Anweisungen fuer Agents. Diese Informationen stehen KI-Agents zur Verfuegung, die am Projekt arbeiten, und helfen ihnen, deine Codebasis und Konventionen zu verstehen.

Rules

Der Rules-Tab konfiguriert zwei Dinge: Pipeline-Regeln (wie Agent und Mensch zusammenarbeiten) und Git-Workflow (Branch-/Commit-/PR-Konventionen).

Pipeline-Regeln

Die Pipeline definiert, was bei jedem Schritt eines Flows passiert — von der Idee bis zum Abschluss. Jeder Step wird als Karte dargestellt, deren Header den zugehoerigen Flow-State anzeigt (passend zu den Kanban-Spalten).

Presets — Starte mit einem Preset und passe es dann an:

Preset	Beschreibung
Off	Minimaler Prozess — nur der Execution-Step ist aktiv, Agent arbeitet frei
Balanced	Standard-Workflow — Agent plant, Mensch genehmigt, Agent implementiert, Mensch testet
Strict	Maximale Kontrolle — alle Steps aktiv, Reviews bei jedem Schritt
Custom	Wird angezeigt wenn du einen Step manuell angepasst hast

Pipeline-Steps — Jeder Step hat eine Actor-Einstellung, die steuert wer die Arbeit macht:

Actor	Bedeutung
Human	Nur der Mensch arbeitet in diesem Step
Agent	Nur der KI-Agent arbeitet in diesem Step
Both	Mensch oder Agent koennen arbeiten
Auto	System-Step, kein aktiver Bearbeiter (z.B. Ready, Done)
Skip	Step wird komplett uebersprungen

Klicke auf das Actor-Badge einer Step-Karte um durch die Optionen zu wechseln.

Wie Steps zum Kanban-Board passen:

Die Pipeline-Steps entsprechen den Flow-States (den Spalten auf deinem Kanban-Board). Die meisten States haben einen Step, aber review enthaelt zwei Sub-Steps:

Kanban-Spalte	Pipeline-Step(s)
Idea	Idea
Planning	Planning
Approval	Approval
Ready	Ready
In Progress	Execution
Review	Review → Testing
Done	Done

Gate-Verhalten — Steps mit bestimmten Transition Policies steuern, wer einen Flow vorwaerts bewegen darf:

• Approval und Testing sind Gate-Steps — der KI-Agent wird blockiert bis ein Mensch in der DevFlow-UI genehmigt oder ablehnt
• Idea, Planning, Execution, Review — Agent und Mensch koennen den Flow vorwaerts bewegen
• Ready und Done — automatische System-Transitionen

Skills — Agent-Steps koennen Skills in drei Phasen zugewiesen bekommen:

• Pre — Vorbereitung vor der Hauptarbeit (z.B. Brainstorming, Branch-Erstellung)
• Action — Die Hauptarbeit (z.B. Plan schreiben, Code implementieren)
• After — Nacharbeit (z.B. Design-Docs, Commit & PR)

Klicke auf die Phasen-Punkte unter einer Step-Karte um Skills zuzuweisen oder zu aendern.

Reject-Loops — Wenn ein Mensch Arbeit bei einem Review-Step (Approval oder Testing) ablehnt, geht der Flow zurueck zu einem vorherigen Step. Die Info-Box unter der Pipeline zeigt diese Reject-Pfade (z.B. “On reject: Approval → Planning”).

Git-Workflow

Git-Workflow ein-/ausschalten. Wenn aktiviert, konfiguriere:

• Branch Convention — Wie Flow-Branches benannt werden sollen (z.B. feature/MA-1-add-login)
• Commit Convention — Format der Commit-Nachrichten (z.B. Conventional Commits)
• PR Template — Wie Pull-Request-Beschreibungen strukturiert sein sollen

Klicke auf das Bearbeiten-Icon bei jeder Konvention zum Anpassen. Eine Live-Vorschau am Ende der Seite (“What the agent sees”) zeigt, wie die generierten Richtlinien fuer den KI-Agent aussehen.

Strictness-Level

Das Enforcement-Level (in der Vorschau als “Paranoid”, “Standard” etc. angezeigt) wird pro Projekt konfiguriert und bestimmt, wie strikt der Agent den Regeln folgen muss. Hoehere Level erfordern mehr Dokumentation, Planung und Review-Schritte.

Extensions

Verbinde externe Tools mit deinem Projekt. Integrationen (GitHub, GitLab, Slack) sind fuer zukuenftige Releases geplant.

Projekt-Dashboard

Jedes Projekt hat ein eigenes Dashboard, das dir einen Ueberblick ueber den aktuellen Stand gibt:

• Flow Pipeline — Eine visuelle Zusammenfassung, wie viele Flows sich in jedem Status befinden (idea, planning, approval, ready, in progress, review, done)
• Letzte Aktivitaeten — Die neuesten Flow-Updates, Statusuebergaenge und Team-Aktionen
• Release-Fortschritt — Status des aktuellen aktiven Releases, einschliesslich der Anzahl abgeschlossener vs. verbleibender Flows
• Zeitstatistiken — Erfasste Stunden pro Woche und Monat, aufgeschluesselt nach Projektmitglied

Projektberechtigungen

Projekte unterstuetzen drei Rollen mit unterschiedlichen Zugriffsebenen:

Rolle	Berechtigungen
Owner	Volle Kontrolle. Kann alle Einstellungen bearbeiten, das Projekt uebertragen oder loeschen, Mitglieder und Rollen verwalten
Manager	Kann Projekteinstellungen bearbeiten, Flows verwalten und Teammitglieder verwalten
Member	Kann das Projekt einsehen, Flows erstellen und bearbeiten sowie Zeit erfassen

Bei Projekten innerhalb einer Organisation werden Rollen von der Organisationsmitgliedschaft uebernommen, koennen aber auf Projektebene angepasst werden.