Zum Hauptinhalt springen

Plan-Modus

Was ist Plan-Modus?​

Plan-Modus ist Claude Codes intelligenter Workflow für die Behandlung komplexer, mehrstufiger Aufgaben. Bei größeren Refaktorierungen, neuen Feature-Entwicklungen oder systematischen Änderungen erstellt Claude zuerst einen detaillierten Plan und führt ihn dann schrittweise aus.

Das ist wie ein Architekt, der Baupläne zeichnet, bevor der Bau beginnt.

Warum brauchen wir Plan-Modus?​

Traditionelle Probleme​

Komplexe Aufgaben ohne Planung führen oft zu:

  • 🔄 Richtungsverwirrung: Designfehler werden mitten im Prozess entdeckt und erfordern Nacharbeit
  • 🧩 Fehlende Details: Vergessen von Abhängigkeiten und Sonderfällen
  • ⏰ Zeitverschwendung: Wiederholte Modifikationen und Anpassungen der Herangehensweise
  • 🐛 Fehlereinführung: Hastige Implementierung verursacht Bugs und Inkonsistenzen

Plan-Modus Vorteile​

  • 🎯 Ganzheitliche Perspektive: Gesamtarchitektur überdenken bevor gehandelt wird
  • 📋 Klare Schritte: Komplexe Aufgaben in ausführbare kleine Schritte aufteilen
  • ✅ Nachverfolgbarer Fortschritt: Jeder Schritt hat klare Vervollständigungskriterien
  • 🔄 Anpassbare Herangehensweise: Pläne vor der Ausführung diskutieren und optimieren

Plan-Modus Workflow​

1. Plan-Modus auslösen​

Automatische Auslösung​

Claude wird automatisch in Plan-Modus wechseln in folgenden Situationen:

> Refaktoriere das gesamte Benutzer-Authentifizierungssystem, unterstütze mehrere Anmeldemethoden und verbessere die Sicherheit
# Komplexität: Hoch → Automatisch in Plan-Modus

> Füge Internationalisierungsunterstützung zur Anwendung hinzu, einschließlich Frontend, Backend und Datenbank
# Auswirkungsbereich: Groß → Automatisch in Plan-Modus

Manuelle Auslösung​

Sie können Plan-Modus auch manuell aktivieren:

> /plan Implementiere Echtzeit-Chat-Funktionalität
> /plan Optimiere Anwendungsperformance, Ziel ist die Halbierung der ersten Seitenladezeit

2. Planerstellungsphase​

Claude wird die Aufgabe analysieren und einen strukturierten Plan erstellen:

## 📋 Aufgabe: Benutzer-Authentifizierungssystem Refaktorierung

### 🎯 Ziele
- E-Mail/Benutzername-Anmeldung unterstützen
- Dritt-OAuth integrieren (Google, GitHub)
- JWT + Refresh Token Mechanismus implementieren
- Zwei-Faktor-Authentifizierung (2FA) hinzufügen
- Sicherheit und Benutzererfahrung verbessern

### 🔍 Auswirkungsanalyse
- **Frontend**: Anmeldekomponenten, Authentifizierungsstatus-Management, Route Guards
- **Backend**: Authentifizierungs-APIs, Middleware, Datenbankmodelle
- **Sicherheit**: Passwort-Richtlinien, Session-Management, Angriffsschutz

### 📝 Ausführungsplan

#### Phase 1: Vorbereitung (Geschätzt 30 Minuten)
- [ ] Bestehenden Authentifizierungscode sichern
- [ ] Aktuelle Benutzerdatenstruktur analysieren
- [ ] Neues Datenbankschema entwerfen
- [ ] Migrationsskripte vorbereiten

#### Phase 2: Backend-Refaktorierung (Geschätzt 2 Stunden)
- [ ] Benutzermodell und Datenbanktabellen aktualisieren
- [ ] Neuen Authentifizierungsservice implementieren
- [ ] JWT-Utility-Klasse erstellen
- [ ] OAuth-Integration implementieren
- [ ] 2FA-Unterstützung hinzufügen

#### Phase 3: Frontend-Anpassung (Geschätzt 1,5 Stunden)
- [ ] Anmeldekomponenten refaktorieren
- [ ] Authentifizierungsstatus-Management aktualisieren
- [ ] OAuth-Anmeldeschnittstelle implementieren
- [ ] 2FA-Einstellungsseite hinzufügen

#### Phase 4: Tests und Validierung (Geschätzt 1 Stunde)
- [ ] Unit-Tests schreiben
- [ ] Integrationstests durchführen
- [ ] Sicherheitsprüfungen
- [ ] Benutzererfahrungstests

### ⚠️ Risikopunkte
- Datenmigration kann bestehende Benutzer beeinträchtigen
- OAuth-Konfiguration erfordert externe Service-Unterstützung
- 2FA-Implementierung benötigt zusätzliche Abhängigkeitspakete

### 🎯 Erfolgskriterien
- [ ] Alle Tests bestehen
- [ ] Bestehende Benutzerdaten vollständig migriert
- [ ] Neue Authentifizierungsfeatures funktionieren normal
- [ ] Keine signifikante Performance-Degradierung

3. Planbestätigungsphase​

Claude wird den Plan präsentieren und um Bestätigung bitten:

Claude: Ich habe einen detaillierten Plan für die Authentifizierungssystem-Refaktorierung erstellt. Bitte überprüfen Sie den obigen Plan.

Was möchten Sie tun:
1. 🚀 Mit der Ausführung dieses Plans beginnen
2. ✏️ Bestimmte Teile des Plans modifizieren
3. 📋 Weitere Implementierungsdetails anzeigen
4. ⏸️ Pausieren, später ausführen

Wie ist Ihre Wahl?

4. Ausführungsphase​

Sobald der Plan bestätigt ist, beginnt Claude mit der schrittweisen Ausführung:

[✅ Phase 1.1 Vollständig] Bestehenden Authentifizierungscode gesichert in backup/auth-legacy/
[🔄 Phase 1.2 In Bearbeitung] Analysiere aktuelle Benutzerdatenstruktur...

Gefunden:
- Benutzertabelle enthält email, username, password_hash
- OAuth-bezogene Felder fehlen
- Keine 2FA-Konfigurationsfelder

[✅ Phase 1.2 Vollständig] Datenstrukturanalyse abgeschlossen
[🔄 Phase 1.3 In Bearbeitung] Entwerfe neues Datenbankschema...

Plan-Modus Typen​

1. Sequenzieller Plan (Linearer Plan)​

Schritte müssen in Reihenfolge ausgeführt werden:

1. Datenbankschema entwerfen
2. Backend-API implementieren
3. Frontend-Schnittstelle entwickeln
4. Integrationstests

Geeignet für: Architekturänderungen, Datenmigration, Bereitstellungsprozesse

2. Paralleler Plan​

Einige Schritte können gleichzeitig ausgeführt werden:

Parallele Gruppe A:
- Benutzer-Authentifizierungs-API implementieren
- Anmeldeschnittstelle entwerfen

Parallele Gruppe B:
- Unit-Tests schreiben
- Dokumentationsupdates vorbereiten

Konvergenzpunkt: Integrationstests

Geeignet für: Feature-Entwicklung, Performance-Optimierung, Multi-Modul-Projekte

3. Iterativer Plan​

In mehreren Iterationszyklen vollenden:

Iteration 1: Grundlegende Authentifizierung (MVP)
- E-Mail/Passwort-Anmeldung
- Grundlegendes Session-Management

Iteration 2: Erweiterte Features
- OAuth-Drittanbieter-Anmeldung
- Passwort-Reset-Funktionalität

Iteration 3: Sicherheitsverbesserung
- Zwei-Faktor-Authentifizierung
- Anmelde-Anomalie-Erkennung

Geeignet für: Große Projekte, progressive Verbesserung, MVP-Entwicklung

Best Practices​

1. Plan-Granularität​

✅ Angemessene Granularität​

- [ ] Benutzer-Registrierungs-API-Endpunkt implementieren
- [ ] E-Mail-Verifizierungslogik hinzufügen
- [ ] Registrierungsformular-Komponente erstellen
- [ ] Formularvalidierung integrieren

❌ Zu grob​

- [ ] Benutzersystem vollenden
- [ ] Frontend-Schnittstelle machen

❌ Zu granular​

- [ ] register.js Datei erstellen
- [ ] Erste Codezeile hinzufügen
- [ ] Express-Modul importieren
- [ ] Variablendeklaration schreiben

2. Risikomanagement​

Risiken im Plan identifizieren und markieren:

### ⚠️ Hochrisiko-Schritte
- **Datenbankemigration** (Risiko: Datenverlust)
  - Abschwächung: Zuerst in Testumgebung validieren
  - Notfallplan: Rollback-Skripte vorbereiten

- **Drittanbieter-Service-Integration** (Risiko: Service nicht verfügbar)
  - Abschwächung: Graceful Degradation implementieren
  - Notfallplan: Manuelle Anmeldeoption bereitstellen

3. Checkpoint-Einstellung​

Verifikation an Schlüsselknoten setzen:

#### Checkpoint 1: Datenmigration abgeschlossen
Verifikationsbedingungen:
- [ ] Alle Benutzerdaten erfolgreich migriert
- [ ] Sowohl alte als auch neue Passwort-Hashes können verifizieren
- [ ] Testbenutzer können sich normal anmelden

#### Checkpoint 2: API-Funktionalitätsprüfung
Verifikationsbedingungen:
- [ ] Alle Authentifizierungsendpunkte antworten normal
- [ ] Fehlerbehandlung deckt verschiedene Szenarien ab
- [ ] API-Dokumentation aktualisiert

4. Fortschrittsverfolgung​

Planfortschritt in Echtzeit aktualisieren:

> Wie ist der aktuelle Fortschritt?

Claude:
📊 Gesamtfortschritt: 60% (12/20 Schritte abgeschlossen)

✅ Abgeschlossen:
- Datenbankschema-Design
- Backend-API-Implementierung
- JWT-Utility-Klasse-Entwicklung

🔄 In Bearbeitung:
- Frontend-Anmeldekomponenten-Entwicklung (70%)

⏳ Ausstehend:
- OAuth-Integration
- Tests und Dokumentation

Erweiterte Techniken​

1. Bedingte Zweig-Planung​

### Zweig-Entscheidungspunkt: Bestehende Benutzerdatenbehandlung

**Option A**: Online-Migration
- Vorteil: Transparent für Benutzer
- Risiko: Kann Performance beeinträchtigen
- Bedingung: Benutzeranzahl < 100k

**Option B**: Offline-Migration
- Vorteil: Sicher und zuverlässig
- Risiko: Erfordert Wartungsfenster
- Bedingung: Benutzeranzahl > 100k

**Entscheidungsgrundlage**: Aktuelle Benutzeranzahl und Geschäftsanforderungen

2. Rollback-Planung​

### 🔄 Rollback-Strategie

Wenn große Probleme während der Ausführung auftreten:

**Sofortige Rollback-Auslöser**:
- Datenverlust oder -korruption
- Systemcrash oder Nichtverfügbarkeit
- Sicherheitsvulnerabilität entdeckt

**Rollback-Schritte**:
1. Neue Bereitstellungen stoppen
2. Datenbank-Backup wiederherstellen
3. Code auf vorherige Version zurücksetzen
4. Relevante Teams benachrichtigen

3. Qualitäts-Gates​

### ✅ Qualitätsstandards

Jeder Phasenabschluss muss erfüllen:

**Code-Qualität**:
- ESLint 0 Fehler, 0 Warnungen
- TypeScript Strict-Modus besteht
- Testabdeckung > 80%

**Funktionale Qualität**:
- Alle Benutzerszenarien getestet
- Performance-Metriken erfüllt
- Sicherheitsscan zeigt keine Hochrisiko-Probleme

Häufige Szenario-Anwendungen​

Szenario 1: Performance-Optimierungsprojekt​

> /plan Optimiere Anwendungsperformance, reduziere erste Seitenladezeit von 5 Sekunden auf unter 2 Sekunden

Claude wird einen umfassenden Plan erstellen einschließlich:

  • Performance-Problem-Diagnose
  • Optimierungslösungsdesign
  • Code-Splitting-Implementierung
  • Cache-Strategie-Optimierung
  • Bild- und Ressourcenoptimierung
  • Validierung und Überwachung

Szenario 2: Tech-Stack-Migration​

> /plan Migriere Projekt von React-Klassenkomponenten zu Funktionskomponenten + Hooks

Plan beinhaltet:

  • Migrationsstrategie-Formulierung
  • Komponenten-Prioritätssortierung
  • Progressive Migrations-Implementierung
  • Test-Validierungsprozess
  • Team-Training-Arrangement

Szenario 3: Neue Feature-Entwicklung​

> /plan Füge vollständige Einkaufswagen- und Checkout-Funktionalität zur E-Commerce-Website hinzu

Umfasst:

  • Anforderungsanalyse und technisches Design
  • Datenmodell-Design
  • API-Entwicklung
  • Frontend-Schnittstellen-Implementierung
  • Zahlungsintegration
  • Tests und Bereitstellung

Nach dem Beherrschen des Plan-Modus können Sie Auto Plan Mode lernen, um zu verstehen, wie Claude intelligenter bestimmen kann, wann Plan-Modus zu verwenden ist.