# Plan-First-Workflows (/de/docs/verdent-for-vscode/configuration/plan-workflows) > KI-gestützte Planung für komplexe Aufgaben nutzen 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 [#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 [#ki-gestützte-aufgabenzerlegung] Verdent zerlegt komplexe Anfragen automatisch durch KI-gestützte Aufgabenzerlegung in überschaubare, aufeinanderfolgende Schritte. ### Zerlegungsprozess [#zerlegungsprozess] 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 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 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 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 [#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 [#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 [#überprüfungsprozess] Verdent erstellt einen Plan mit klaren Abschnitten, nummerierten Schritten, betroffenen Dateien und identifizierten Abhängigkeiten 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? 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? ``` 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 ``` 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 [#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 [#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 [#ä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 [#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) [#häufig-gestellte-fragen-faq] **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. **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:** 1. Verdent führt die angegebenen Schritte aus 2. Stoppt an einem Kontrollpunkt zur Überprüfung 3. Sie überprüfen die Ergebnisse und geben Feedback 4. Weiterführen mit der nächsten Phase oder Ansatz anpassen 5. 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. **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. **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. **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:** ```markdown # 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. **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. **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. *** ## Siehe auch [#siehe-auch] Erfahren Sie mehr über Plan Mode und andere Ausführungsmodi Effektive Prompts für Plan Mode schreiben