Plan-First-Workflows

Plan-First-Workflows nutzen Plan Mode, einen schreibgeschützten Ausführungsmodus, in dem Verdent Code analysiert, Recherchen durchführt und detaillierte Pläne erstellt, bevor Änderungen ausgeführt werden. Dieser Workflow trennt die strategische Planung von der Umsetzung und ermöglicht eine Überprüfung und Verfeinerung, bevor Codeänderungen festgelegt werden.

Wann Sie Plan Mode verwenden sollten

Komplexe, mehrere Dateien betreffende Änderungen, die Koordination erfordern
Unsicherheit über den besten Umsetzungsansatz
Risikobehaftete Änderungen an produktionskritischem Code
Aufgaben in unbekannten Codebasen, die Exploration erfordern
Strategischer Planungsbedarf, der eine Freigabe vor der Ausführung erfordert

KI-gestützte Aufgabenzerlegung

Verdent zerlegt komplexe Anfragen automatisch durch KI-gestützte Aufgabenzerlegung in überschaubare, aufeinanderfolgende Schritte.

Zerlegungsprozess

Analyse der Anfrage

Verdent analysiert Ihre natürlichsprachliche Anfrage, um Folgendes zu identifizieren:

Primäres Ziel und gewünschtes Ergebnis
Betroffene Dateien, Komponenten oder Systeme
Erforderliche technische Vorgänge und Abhängigkeiten
Mögliche Komplexitätsfaktoren

Kontext der Codebasis

Verdent untersucht Ihre Projektstruktur, um Folgendes zu verstehen:

Bestehende Architektur und etablierte Muster
Dateiorganisation und Technologie-Stack
Aktuelle Implementierungen, die geändert werden müssen

Aufgabenzerlegung

Verdent zerlegt die Anfrage in logische Teilaufgaben:

Identifiziert natürliche Trennpunkte und Umsetzungsphasen
Ordnet Aufgaben nach Abhängigkeit (vorausgesetzte Aufgaben zuerst)
Gruppiert zusammenhängende Vorgänge
Schätzt Umfang und Komplexität jeder Teilaufgabe ein

Interaktive Klärung

Verdent kann Fragen stellen, um die Zerlegung zu verfeinern:

„Soll ich die bestehende Validierung ändern oder einen neuen Validator erstellen?"
„Möchten Sie die Tests für alle betroffenen Komponenten aktualisieren?"
„Soll diese Änderung sowohl für Web- als auch für Mobile-Komponenten gelten?"

Merkmale der Zerlegung

Aufgaben sind auf 15–45 Minuten fokussierte Arbeit ausgelegt
Natürliche Trennpunkte für Tests und Validierung
Komplex genug, um sinnvoll zu sein, einfach genug, um umgesetzt zu werden

Abhängigkeiten werden berücksichtigt (Einrichtung vor Umsetzung)
Logischer Ablauf (Datenschicht → Geschäftslogik → Benutzeroberfläche)
Verifizierungsschritte nach wichtigen Phasen

Das Format der Planzerlegung lässt sich über plan_rules.md anpassen, um Folgendes zu steuern:

Detailgrad (grober Überblick vs. granular)
Planstruktur und Abschnitte
Enthaltene Informationen (Zeitschätzungen, Risiken, Abhängigkeiten)

Planüberprüfung und -freigabe

Nachdem Sie eine Anfrage in Plan Mode gesendet haben, erstellt Verdent einen strukturierten Plan, der zur Überprüfung in der Chat-Ansicht angezeigt wird.

Überprüfungsprozess

Strukturierten Plan erhalten

Verdent erstellt einen Plan mit klaren Abschnitten, nummerierten Schritten, betroffenen Dateien und identifizierten Abhängigkeiten

Planqualität analysieren

Prüfen Sie Folgendes:

Korrektheit: Löst der Ansatz das Problem?
Vollständigkeit: Sind alle notwendigen Schritte enthalten?
Effizienz: Ist dies der beste Ansatz?
Risiko: Was könnte schiefgehen? Randfälle oder Sicherheitsbedenken?

Klärende Fragen stellen

Fordern Sie zusätzliche Informationen an, wenn etwas unklar ist:

Can you explain step 3 in more detail?
Why are we modifying both the service and controller?
What happens if the API call fails in step 5?

Änderungen anfordern

Geben Sie Feedback, um den Plan zu überarbeiten:

Let's use JWT tokens instead of OAuth2
Can we break step 4 into smaller substeps?
Add error handling considerations to the plan

Nächste Aktion wählen

Nachdem Verdent den Plan erstellt hat, werden zwei Optionen angeboten:

Bearbeiten: Änderungen anfordern, klärende Fragen stellen oder den Plan weiter verfeinern
Umsetzung starten: Zu Agent Mode wechseln und mit der Ausführung des freigegebenen Plans beginnen

Optionen für die Planinteraktion

Nach der Überprüfung des erstellten Plans bietet Verdent zwei Optionen an:

Bearbeiten:

Wählen Sie diese Option, um:

Konkrete Änderungen am Planansatz anzufordern
Klärende Fragen zu Umsetzungsdetails zu stellen
Fehlende Elemente oder Überlegungen hinzuzufügen
Bestimmte Schritte zu vereinfachen oder zu erweitern
Alternative Ansätze zu erkunden

Dadurch bleiben Sie im Plan Mode für iterative Verfeinerung, ohne dass Änderungen ausgeführt werden.

Umsetzung starten:

Wählen Sie diese Option, um:

Zu Agent Mode zu wechseln und die Ausführung zu beginnen
Den freigegebenen Plan mit vollständiger Autonomie umzusetzen
Dateiänderungen vorzunehmen und Befehle wie geplant auszuführen

Sie können sich außerdem für Folgendes entscheiden:

Manuelle Umsetzung: Den Plan überprüfen und die Änderungen selbst umsetzen
Schrittweise Ausführung: Verdent bitten, bestimmte Phasen mit Kontrollpunkten zur Überprüfung zwischen den Phasen umzusetzen

Verwenden Sie Bearbeiten, um den Plan so oft wie nötig zu überarbeiten. Wählen Sie Umsetzung starten erst, wenn Sie sicher sind, dass der Ansatz korrekt und vollständig ist.

Iterative Planung

Nutzer können Pläne durch Auswahl von Bearbeiten und konversationelles Feedback frei ändern und iterieren. Verdent behandelt die Planerstellung als interaktiven, iterativen Prozess.

Änderungsmethoden

Konkrete Änderungen anfordern:

Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5

Fehlende Elemente hinzufügen:

Add error handling for network failures
Include rollback procedures
Add performance optimization considerations

Vereinfachen oder erweitern:

This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes

Alternativen erkunden:

What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?

Beispiel für einen Iterationsablauf

User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]

Unbegrenzte Iterationen:

Keine Begrenzung der Anzahl der Überarbeitungen
Jede Iteration behält den Konversationskontext bei
Frühere Versionen bleiben im Chat-Verlauf erhalten
Sie können auf frühere Planversionen verweisen: „Zurück zum ersten Ansatz"

Die Ablehnung eines Plans ist ein natürlicher Bestandteil des iterativen Planungsprozesses. Sie sorgt dafür, dass nur freigegebene, gut verstandene Strategien ausgeführt werden, was vergeudeten Aufwand durch fehlerhafte Umsetzungen reduziert.

Häufig gestellte Fragen (FAQ)

Schreibt Plan Mode tatsächlich Code in meine Dateien?

Nein. Plan Mode ist strikt schreibgeschützt:

Verdent kann Dateien lesen, Code durchsuchen und Ihre Codebasis analysieren
Es finden keine Dateischreibvorgänge, -änderungen oder -löschungen während Plan Mode statt
Pläne werden nur in der Chat-Ansicht angezeigt
Die Codeausführung beginnt erst, nachdem Sie ausdrücklich zustimmen und zu Agent Mode wechseln

Sicherheitsgarantie: Plan Mode kann Ihren Code nicht versehentlich ändern. Es ist für sichere Exploration und Strategieentwicklung konzipiert.

Kann ich einen Plan schrittweise statt auf einmal ausführen?

Ja. Die schrittweise Ausführung wird vollständig unterstützt:

Muster für schrittweise Freigabe:

Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes

Funktionsweise:

Verdent führt die angegebenen Schritte aus
Stoppt an einem Kontrollpunkt zur Überprüfung
Sie überprüfen die Ergebnisse und geben Feedback
Weiterführen mit der nächsten Phase oder Ansatz anpassen
Wiederholen, bis die Aufgabe abgeschlossen ist

Am besten geeignet für: Risikoreiche Änderungen, unbekannte Muster, produktionskritischen Code, bei dem eine schrittweise Einführung das Risiko verringert.

Mit der schrittweisen Ausführung können Sie Teile eines Plans freigeben und andere zurückstellen – nützlich, wenn sich Prioritäten mitten in einer Aufgabe ändern.

Was passiert, wenn ich einen Plan ablehne?

Die Ablehnung eines Plans ist völlig normal und erwartet:

Verdent erstellt basierend auf Ihrem Feedback einen neuen Plan
Frühere Planversionen bleiben zur Referenz im Chat-Verlauf erhalten
Es werden keine Codeänderungen vorgenommen (Plan Mode ist schreibgeschützt)
Sie können beliebig oft iterieren, bis Sie zufrieden sind

Häufige Gründe für eine Ablehnung:

Der Ansatz ist zu komplex oder zu einfach
Fehlende Randfälle oder Fehlerbehandlung
Es existiert eine bessere alternative Architektur
Missverstandene Anforderungen

Profi-Tipp: Ablehnung ist Teil des Prozesses. Es ist besser, Pläne iterativ zu verfeinern, als Aufwand für die Ausführung fehlerhafter Strategien zu verschwenden.

Wie wechsle ich zwischen Plan Mode und Agent Mode?

Der Wechsel erfolgt sofort über das Eingabefeld:

So aktivieren Sie Plan Mode:

Klicken Sie auf die Schaltfläche Modus wechseln im Eingabefeld
Wählen Sie Plan Mode aus dem Dropdown-Menü
ODER sagen Sie: „Wechsle zu Plan Mode"

So verlassen Sie Plan Mode:

Klicken Sie auf die Schaltfläche Modus wechseln im Eingabefeld
Wählen Sie Agent Mode aus dem Dropdown-Menü
ODER wählen Sie Umsetzung starten nach der Überprüfung eines Plans

Beibehaltung des Modus:

Die Moduswahl bleibt innerhalb der aktuellen Sitzung erhalten
Neue Sitzungen beginnen im Standard-Agent Mode
Sie können den Modus jederzeit frei wechseln

Typischer Workflow: Plan Mode → Überprüfung → Agent Mode → Ausführung → zurück zu Plan Mode für das nächste komplexe Feature.

Kann ich das Format und den Detailgrad der erstellten Pläne anpassen?

Ja, mithilfe von plan_rules.md:

Speicherort: ~/.verdent/plan_rules.md (globales Konfigurationsverzeichnis)

Was Sie anpassen können:

Detailgrad: Grober Überblick vs. granulare Schritt-für-Schritt-Anleitung
Planstruktur: Einzuschließende Abschnitte (Zusammenfassung, Risiken, Abhängigkeiten, Tests)
Enthaltene Informationen: Zeitschätzungen, Dateipfade, Verifizierungsschritte
Formatpräferenzen: Nummerierte Listen, Phasen, Kategorisierung

Beispiel für plan_rules.md:

# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase

Änderungen wirken sich sofort auf neue Plan Mode-Sitzungen aus.

Verwendet Plan Mode denselben Kontext wie Agent Mode?

Nein, Plan Mode verfügt über eine separate Kontextverwaltung:

Plan Mode-Kontext: Optimiert für Analyse und strategisches Denken
Agent Mode-Kontext: Optimiert für Ausführung und Umsetzung
Vorteil: Pläne belasten den Ausführungskontext nicht mit explorativer Recherche

Warum die Trennung wichtig ist:

Plan Mode kann mehrere Ansätze erkunden, ohne Agent Mode zu überladen
Abgelehnte Planversuche verbrauchen keinen Agent Mode-Kontext
Ein unbelasteter Start beim Wechsel zur Ausführung

Kontext-Zurücksetzung: Der Wechsel des Modus sorgt für einen frischen Kontext für den neuen Aufgabentyp.

Was passiert, wenn Verdent während der Planung klärende Fragen stellt?

Klärende Fragen sind Teil des Zerlegungsprozesses:

Warum Fragen gestellt werden:

Mehrdeutige Anforderungen müssen geklärt werden
Es existieren mehrere gültige Ansätze (einer muss gewählt werden)
Randfälle oder Einschränkungen sind noch nicht spezifiziert
Präferenzen sind aus der ursprünglichen Anfrage nicht klar erkennbar

Wie Sie antworten sollten:

Antworten Sie direkt in natürlicher Sprache
Geben Sie bei Bedarf Beispiele an
Sagen Sie „Ihre Entscheidung", wenn Sie dem Urteil von Verdent vertrauen
Stellen Sie Gegenfragen, wenn Sie unsicher sind

Beispiel für einen Austausch:

Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]

Profi-Tipp: Fragen helfen Verdent, präzise, relevante Pläne zu erstellen, die auf Ihre spezifischen Bedürfnisse zugeschnitten sind.