Dosyalarla Planlama: Manus tarzında AI ajanı bağlam sorununu çözmek

• Sorunun ortaya konması

  • AI ajanlarında (Claude Code, Cursor vb.) bağlam penceresi sınırı nedeniyle uzun süreli işlerde hedefin kaybolması
  • İlk talimatların unutulması + aynı hataların tekrar etmesi (bağlam = uçucu RAM)
  • Dosya sistemini kalıcı bellek (disk) gibi kullanmak bunu çözebilir

• Manus'un başarısının sırrı (tersine mühendislik)

  • 8 ayda 100 milyon dolar gelir → Meta tarafından 2 milyar dolara satın alındı
  • Öz: Markdown dosyalarını AI'nin harici beyni olarak kullanmak
  • Dikkat yönlendirmesi (attention manipulation) + hata kayıtlarını koruma → başarısızlıkların tekrarını önleme
  • Hatalardan kurtulma yeteneği, ajan performansının temel göstergesi

• 3 dosyalı kalıp (Planning with Files'in özü)

  • task_plan.md
    → Adım adım plan + onay kutularıyla ilerleme durumu takibi
    → Hedefi sürekli hatırlatan en önemli dosya
  • findings.md
    → Araştırma sonuçları, bulunan bilgiler ve analizlerin saklanması
  • progress.md
    → Gerçekte denenmiş işler + sonuçlar + tüm hata kayıtları

• 4 temel kullanım kuralı

  • Her zaman önce planı task_plan.md içinde yazarak başla
  • Aynı konuya 2 kereden fazla bakılıyorsa → findings.md içinde düzenle ve kaydet
  • Ortaya çıkan tüm hataları mutlaka progress.md içine kaydet
  • Aynı yöntemle başarısızlığı tekrarlama → yaklaşımı değiştirip yeniden dene

• Gerçek uygulama yöntemi

  • Claude Code'da eklenti kurulumu: /plugin marketplace add OthmanAdi/planning-with-files
  • Karmaşık işlerde (3 adımdan fazla, araştırma veya refactoring gerektiğinde) otomatik/manuel çalıştırma (/planning-with-files)
  • Etki: AI hedefi unutmuyor ve hata tekrarları belirgin biçimde azalıyor

• Temel içgörü ve sonuç

  • AI ajanı performansını artırmada → daha büyük modellerden çok etkili bellek yönetimi daha önemli
  • Yalnızca 3 Markdown dosyasıyla bile bağlam mühendisliği seviyesi büyük ölçüde yükseliyor
  • Planning with Files eklentisi → Manus tarzının açık kaynak uygulaması → herkes hemen kullanabilir

[zero0000]

task_plan.md, şu anda kullandığım yöntemle aynı görünüyor. Bunu otomatik yapsa çok kullanışlı olurdu.