planning-with-files: den Plan eines KI-Codierungsagenten in drei Markdown-Dateien auf der Festplatte halten

Der dateibasierte Planungsansatz · Dateien als Arbeitsgedächtnis 1

planning-with-files ist eine Fähigkeit für KI-Codierungsagenten, die den Planungszustand auf der Festplatte ablegt, statt ihn nur im Kontextfenster zu belassen. Für eine Aufgabe erstellt die Fähigkeit drei Markdown-Dateien: task_plan.md verfolgt Phasen und Kontrollkästchen, findings.md sammelt Recherchenotizen und Entscheidungen, und progress.md enthält das Sitzungsprotokoll und Testergebnisse. Das README beschreibt das Kernprinzip als Behandlung des Kontextfensters wie RAM und des Dateisystems wie Festplatte: Alles Wichtige wird auf die Festplatte geschrieben. Die Dateien werden zu Beginn jeder Runde neu injiziert, sodass ein /clear, ein Absturz oder eine Kontextkomprimierung den Plan nicht zerstört. Abschnittsbezug 1.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 1.2 für planning-with-files.

Was sich nach /clear ändert · Dateien als Arbeitsgedächtnis 2

Das Vorher-Nachher-Beispiel im README zeigt das übliche Problem: Eine neue Sitzung ohne Plandateien sagt, sie habe keinen Kontext, und bittet den Benutzer, die Aufgabe neu zu beschreiben. Mit der Fähigkeit setzt der Agent fort, indem er die Dateien von der Festplatte liest. Das Injektionsformat ist ein Block, der durch ===BEGIN PLAN DATA=== und ===END PLAN DATA=== begrenzt wird und von einem UserPromptSubmit-Hook aus task_plan.md in den Kontext geschrieben wird. Der eigene interne Wiederherstellungs-Benchmark des Projekts berichtet, dass eine neue Sitzung mit den Dateien auf der Festplatte im Durchschnitt in 5,0 Runden wieder anlief, gegenüber 13,3 für einen rohen Agenten ohne Planungsmethode. Das README kennzeichnet diesen Benchmark als intern und vom Autor ausgeführt und verweist für Methode und Grenzen auf docs/evals.md. Abschnittsbezug 2.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 2.2 für planning-with-files.

Installationswege und Plattformabdeckung · Dateien als Arbeitsgedächtnis 3

Das README dokumentiert zwei Hauptinstallationswege. Für Claude Code fügt der Plugin-Weg das Repository als Marktplatz hinzu und installiert das Plugin, das die Fähigkeit, Hooks und Slash-Befehle enthält. Für jeden anderen Agenten installiert der Befehl npx skills add die Fähigkeit über den Agent-Skills-Standard und deckt damit über 60 Agenten ab. Das README warnt, dass der Fähigkeiten-Weg stillschweigend ohne Hooks enden kann, wenn Projektvertrauen nicht akzeptiert wird oder Frontmatter-Hooks bei Installationen auf Projektebene nicht registriert werden, und empfiehlt den Plugin-Weg für Benutzer, die die Hooks benötigen, gefolgt von einer Verifizierung mit /plan-doctor. Das Repository liefert auch IDE-spezifische Spiegel für Claude Code, Codex, Cursor, Kiro, OpenCode und andere Plattformen. Abschnittsbezug 3.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 3.2 für planning-with-files.

Der Mechanismus: Dateien, Hooks und Wiederherstellung · Dateien als Arbeitsgedächtnis 4

Die Fähigkeit definiert einen Entscheidungsfluss für den Agenten: Erstellen Sie die drei Dateien, wenn eine Aufgabe 3 oder mehr Schritte oder 5 oder mehr Tool-Aufrufe benötigt; hängen Sie gelernte Informationen an findings.md an; protokollieren Sie Aktionen in progress.md; haken Sie Phasen in task_plan.md ab; und lesen Sie nach einem Kontext-Reset alle Dateien erneut. Lebenszyklus-Hooks machen diese Schritte mechanisch: Das README listet 5 Hooks auf Claude Code, 7 auf Codex und 8 auf Pi, die Plan-Neinjektion in jeder Runde, Erinnerungen nach Schreibvorgängen und eine Abschlussprüfung vor dem Stoppen abdecken. Die Sitzungswiederherstellung nach /clear funktioniert, indem der Sitzungsspeicher der aktiven IDE überprüft wird, der Zeitpunkt der letzten Aktualisierung der Plandateien gefunden, das Gespräch danach extrahiert und ein Aufholbericht angezeigt wird. Abschnittsbezug 4.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 4.2 für planning-with-files.

Die v3-Funktionen für langlaufende Aufgaben · Dateien als Arbeitsgedächtnis 5

Die v3-Linie fügt Funktionen für langlaufende agentische Läufe hinzu. Der autonome Modus lässt die Plan-Rezitation pro Tool-Aufruf weg, behält aber die Injektion zu Rundenbeginn bei. Der Gated-Modus fügt ein Stop-Abschlussgate hinzu, das nur blockiert, wenn alle Abschlussbedingungen gleichzeitig erfüllt sind. Session-Catchup liest die Plandateien nach /clear aus dem Sitzungsspeicher der IDE erneut. SHA-256-Plan-Attestierung sperrt task_plan.md und verweigert bei der Injektion einen manipulierten Plan. Ein Ausführungsbuch führt Phasenübergänge als append-only JSONL-Datei. Umgebungsvariablen steuern das Verhalten: PLANNING_DISABLED=1 überspringt das gesamte Planlesen für einen Aufruf, PLAN_ID fixiert das Terminal auf einen Plan unter .planning, und PWF_INJECT=smart ersetzt das feste head -50-Injektionsfenster durch das Ziel, den nächsten Schritt, die aktuelle Phase und kürzliche Entscheidungen. Abschnittsbezug 5.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 5.2 für planning-with-files.

Die vom README berichteten Benchmarks · Dateien als Arbeitsgedächtnis 6

Das README berichtet über eine Bewertung mit Anthropics skill-creator-Framework: Fähigkeit v2.21.0, Modell claude-sonnet-4-6, datiert 2026-03-06. Die Fähigkeit bestand 29 von 30 objektiv verifizierbaren Behauptungen gegenüber 2 von 30 ohne sie, folgte dem 3-Datei-Muster in 5 von 5 Bewertungen gegenüber 0 von 5, gewann 3 von 3 Blind-A/B-Vergleichen gegenüber 0 von 3 und erreichte eine durchschnittliche Rubrikbewertung von 10,0 gegenüber 6,8. Das README stellt fest, dass diese Zahl die Dateimuster-Treue misst, nicht die Zielabweichung über lange autonome Läufe, und dass neuere Modelle und Arbeiten im autonomen Modus noch nicht abgedeckt sind. Ein separater interner Wiederherstellungs-Benchmark, v1 vom 2026-07-06 und vom Autor gegen v3.4.0 ausgeführt, maß die Runden bis zur Wiederaufnahme nach einem Kontextverlust: 5,0 mit den Dateien, 13,3 für einen rohen Agenten. Abschnittsbezug 6.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 6.2 für planning-with-files.

Repository-Inhalt und Lizenz · Dateien als Arbeitsgedächtnis 7

Das Repository-Layout im README zeigt die kanonische Fähigkeit unter skills/planning-with-files mit SKILL.md, Skripten, Vorlagen und Beispielen, plus fünf übersetzte Varianten, einen .agents/skills-Pfad für den Agent-Skills-Standard, IDE-spezifische Spiegelverzeichnisse, Dokumentation, eine Testsuite und Dateien auf Root-Ebene einschließlich LICENSE. Das Projekt wird unter der MIT-Lizenz vertrieben, Copyright 2026 Ahmad Adi, die die Erlaubnis erteilt, Kopien zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, und besagt, dass die Software ohne jegliche Garantie, einschließlich Marktgängigkeit, Eignung für einen bestimmten Zweck und Nichtverletzung von Rechten, bereitgestellt wird. Der Lizenztext behandelt weder die Sicherheitslage des Projekts noch Support-Zusagen oder etwas über diesen Haftungsausschluss hinaus. Abschnittsbezug 7.1 für planning-with-files.

task_plan.md, findings.md und progress.md werden bei jeder Runde berücksichtigt. Der README beschreibt Hooks, /clear, Kompaktierung und die Installation über den Agent-Skills-Standard. Der konkrete Bezug zu OthmanAdi/planning-with-files bleibt damit an den Angaben des README und den genannten Dateien prüfbar. Abschnittsbezug 7.2 für planning-with-files.

Redaktionelles Fazit

Geeignet ist OthmanAdi/planning-with-files für Leser, die genau die im README beschriebene Aufgabe bearbeiten. Nicht geeignet ist der Text als Beleg für undokumentierte Leistungswerte. Vor der Nutzung sollten planning-with-files, der konkrete Einstieg und die genannte Datei oder Konfiguration mit einer kleinen projektspezifischen Eingabe geprüft werden; relevant sind Ausgabe, Fehlerpfad und Abhängigkeiten.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes