planning-with-files-de

Dateiplanungssystem

Arbeite wie Manus: Verwende persistente Markdown-Dateien als deinen „Festplatten-Arbeitsspeicher".

Schritt 1: Kontext wiederherstellen (v2.2.0)

Bevor du irgendetwas anderes tust, prüfe, ob Planungsdateien existieren, und lies sie:

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
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-de}"

Wenn der Wiederherstellungsbericht nicht synchronisierten Kontext meldet:

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

Schnellstart

Vor jeder komplexen Aufgabe:

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

Dateizwecke

Wichtige Regeln

1. Zuerst Plan erstellen

Beginne niemals eine komplexe Aufgabe ohne task_plan.md. Keine Ausnahmen.

2. Zwei-Schritte-Regel

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

Dies verhindert den Verlust visueller/multimodaler Informationen.

3. Vor Entscheidungen erst lesen

Lies die Planungsdateien vor wichtigen Entscheidungen. Dies bringt die Ziele in dein Aufmerksamkeitsfenster.

4. Nach Aktionen aktualisieren

Nach Abschluss jeder Phase:

• Markiere Phasenstatus: in_progress → complete
• Protokolliere alle aufgetretenen Fehler
• Notiere erstellte/geänderte Dateien

5. Alle Fehler protokollieren

Jeder Fehler kommt in die Planungsdatei. Dies sammelt Wissen und verhindert Wiederholungen.

6. Wiederhole niemals denselben Fehler

Notiere, was du versucht hast, und ändere den Ansatz.

7. Nach Abschluss weitermachen

Wenn alle Phasen abgeschlossen sind, aber der Benutzer zusätzliche Arbeit anfordert:

• 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

Lesen vs. Schreiben Entscheidungsmatrix

Fünf-Fragen-Neustarttest

Wenn du diese Fragen beantworten kannst, ist dein Kontextmanagement solide:

Wann dieses Muster verwenden

Verwenden bei:

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

Überspringen bei:

• Einfache Fragen
• Einzelne Datei-Bearbeitung
• Schnelle Nachschlageaktionen

Vorlagen

Kopiere diese Vorlagen, um zu beginnen:

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

Skripte

Automatisierungshilfsskripte:

• 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

Dieser Skill verwendet einen PreToolUse-Hook, der task_plan.md vor jedem Tool-Aufruf neu einliest. In task_plan.md geschriebene Inhalte werden wiederholt in den Kontext eingespeist, was sie zu einem lohnenden Ziel für indirekte Prompt-Injektion macht.

Anti-Muster