Dateiplanungssystem

Schritt 1: Kontext wiederherstellen (v2.2.0)

1. Wenn

   task_plan.md

   existiert, lies sofort

   task_plan.md

   ,

   progress.md

   und

   findings.md

   .
2. Prüfe dann, ob die vorherige Sitzung nicht synchronisierten Kontext hat:

# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-de\scripts\session-catchup.py" (Get-Location)

1. Führe

   git diff --stat

   aus, um tatsächliche Code-Änderungen zu sehen
2. Lies die aktuellen Planungsdateien
3. Aktualisiere die Planungsdateien basierend auf dem Wiederherstellungsbericht und git diff
4. Setze dann die Aufgabe fort

Wichtig: Dateispeicherort

• Vorlagen befinden sich in

  ${CLAUDE_PLUGIN_ROOT}/templates/

• Deine Planungsdateien kommen in dein Projektverzeichnis

${CLAUDE_PLUGIN_ROOT}/

task_plan.md

findings.md

progress.md

Schnellstart

1. Erstelle

   task_plan.md

   — Siehe Vorlage templates/task_plan.md
2. Erstelle

   findings.md

   — Siehe Vorlage templates/findings.md
3. Erstelle

   progress.md

   — Siehe Vorlage templates/progress.md
4. Lies den Plan vor Entscheidungen — Frische Ziele im Aufmerksamkeitsfenster auf
5. Aktualisiere nach jeder Phase — Markiere als abgeschlossen, protokolliere Fehler

Hinweis: Planungsdateien kommen in dein Projektstammverzeichnis, nicht in das Skill-Installationsverzeichnis.

Kernmuster

Kontextfenster = Arbeitsspeicher (flüchtig, begrenzt)
Dateisystem = Festplatte (persistent, unbegrenzt)

→ Alles Wichtige wird auf die Festplatte geschrieben.

Dateizwecke

task_plan.md

findings.md

progress.md

Wichtige Regeln

1. Zuerst Plan erstellen

task_plan.md

2. Zwei-Schritte-Regel

„Nach jeweils 2 Ansicht-/Browser-/Such-Operationen speichere wichtige Erkenntnisse sofort in einer Datei."

3. Vor Entscheidungen erst lesen

4. Nach Aktionen aktualisieren

• Markiere Phasenstatus:

  in_progress

  →

  complete

• Protokolliere alle aufgetretenen Fehler
• Notiere erstellte/geänderte Dateien

5. Alle Fehler protokollieren

## Aufgetretene Fehler
| Fehler | Versuche | Lösung |
|------|---------|---------|
| FileNotFoundError | 1 | Standardkonfiguration erstellt |
| API-Timeout | 2 | Retry-Logik hinzugefügt |

6. Wiederhole niemals denselben Fehler

if Operation fehlschlägt:
    nächste Operation != dieselbe Operation

7. Nach Abschluss weitermachen

• Neue Phasen in

  task_plan.md

  hinzufügen (z.B. Phase 6, Phase 7)
• Neuen Sitzungseintrag in

  progress.md

  erstellen
• Arbeitsablauf wie gewohnt planen

Drei-Versuche-Protokoll

Versuch 1: Diagnostizieren und beheben
  → Fehler genau lesen
  → Grundursache finden
  → Gezielten Fix anwenden

Versuch 2: Alternativer Ansatz
  → Gleicher Fehler? Anderen Weg wählen
  → Anderes Tool? Andere Bibliothek?
  → Niemals exakt dieselbe fehlgeschlagene Operation wiederholen

Versuch 3: Neu denken
  → Annahmen hinterfragen
  → Lösungen recherchieren
  → Plan-Update in Betracht ziehen

Nach 3 Fehlern: Benutzer um Hilfe bitten
  → Erklären, was versucht wurde
  → Konkreten Fehler teilen
  → Um Anleitung bitten

Lesen vs. Schreiben Entscheidungsmatrix

Fünf-Fragen-Neustarttest

Wann dieses Muster verwenden

• Mehrstufige Aufgaben (3+ Schritte)
• Forschungsaufgaben
• Projekte bauen/erstellen
• Aufgaben über mehrere Tool-Aufrufe hinweg
• Jede Arbeit, die Organisation erfordert

• Einfache Fragen
• Einzelne Datei-Bearbeitung
• Schnelle Nachschlageaktionen

Vorlagen

• templates/task_plan.md — Phasenverfolgung
• templates/findings.md — Forschungsspeicher
• templates/progress.md — Sitzungsprotokoll

Skripte

• scripts/init-session.sh

  — Alle Planungsdateien initialisieren

• scripts/check-complete.sh

  — Prüfen, ob alle Phasen abgeschlossen sind

• scripts/session-catchup.py

  — Kontext aus vorheriger Sitzung wiederherstellen (v2.2.0)

Sicherheitsgrenzen

task_plan.md

task_plan.md

findings.md

task_plan.md

Anti-Muster