Planning with Files: Das Kontextproblem von AI-Agenten auf Manus-Art lösen

• Problemstellung

  • Durch die Begrenzung des Kontextfensters von AI-Agenten (Claude Code, Cursor usw.) verlieren sie bei langlaufenden Aufgaben ihr Ziel aus den Augen
  • Anfangsanweisungen werden vergessen + dieselben Fehler treten wiederholt auf (Kontext = flüchtiger RAM)
  • Das lässt sich lösen, wenn man das Dateisystem wie einen permanenten Speicher (Festplatte) nutzt

• Das Erfolgsgeheimnis von Manus (Reverse Engineering)

  • In 8 Monaten 100 Millionen US-Dollar Umsatz → Übernahme durch Meta für 2 Milliarden US-Dollar
  • Kernpunkt: Markdown-Dateien als externes Gehirn der AI verwenden
  • Attention-Manipulation + Beibehaltung von Fehlerprotokollen → verhindert die Wiederholung von Fehlschlägen
  • Die Fähigkeit zur Fehlerbehebung ist ein zentraler Indikator für die Leistung von Agenten

• Das 3-Dateien-Muster (Kern von Planning with Files)

  • task_plan.md
    → Schritt-für-Schritt-Plan + Fortschrittsverwaltung mit Checkboxes
    → die wichtigste Datei, um das Ziel ständig in Erinnerung zu rufen
  • findings.md
    → speichert Rechercheergebnisse, entdeckte Informationen und Analyseinhalte
  • progress.md
    → tatsächlich durchgeführte Versuche + Ergebnisse + Protokoll aller Fehler

• Vier zentrale Nutzungsregeln

  • Immer zuerst mit der Planung in task_plan.md beginnen
  • Wenn dasselbe Thema mehr als zweimal nachgeschlagen wird → in findings.md zusammenfassen und speichern
  • Alle aufgetretenen Fehler müssen in progress.md festgehalten werden
  • Dasselbe Scheitern darf nicht auf die gleiche Weise wiederholt werden → Ansatz ändern und erneut versuchen

• Praktische Anwendung

  • Plugin in Claude Code installieren: /plugin marketplace add OthmanAdi/planning-with-files
  • Komplexe Aufgaben (mehr als 3 Schritte, bei Recherche- oder Refactoring-Bedarf) automatisch/manuell ausführen (/planning-with-files)
  • Effekt: Die AI vergisst ihr Ziel nicht und wiederholt Fehler deutlich seltener

• Zentrale Erkenntnis & Schlussfolgerung

  • Für bessere AI-Agenten ist effektives Memory-Management weitaus wichtiger als größere Modelle
  • Schon mit nur drei Markdown-Dateien steigt das Niveau des Context Engineering deutlich
  • Das Planning-with-Files-Plugin → Open-Source-Implementierung des Manus-Ansatzes → sofort von allen nutzbar