Geçen hafta, henüz karşılaşmadığımız koronavirüslere karşı bir aşı tasarlayan bir yapay zekayı okudum (ScienceDaily). Cambridge ilk insan denemesini gerçekleştirdi ve 39 gönüllü antijeni aldı.
Bir algoritmanın bir virüsün tüm genetik ailesini analiz edip, hâlâ hayvanlarda dolaşan ve sıçramayı bekleyen üyelere karşı koruma geliştirmesi akıl almaz bir şey. Ama aynı algoritmadan, bir belge listesinden en son brifingimi getirmesini istediğimde, bana üç ay öncesine ait bir brifingi göstermek için kasamda neredeyse iki dakika boyunca yanlış dosyaları açabiliyor.
Cambridge'in özel olarak eğitilmiş bir yapay zeka kullandığını biliyorum, ancak size göstermek istediğim şey, yapay zekanın yapabilecekleri ile bir kurulumun yapmasına izin verdikleri arasındaki farkın, iş akışınızı ve üretkenliğinizi ya yapıp ya da bozan şey olduğudur.
Yakın zamana kadar hiçbir zaman bilinçli olarak bir iskele kurmadım. Ajanın etrafında kazara, klasör klasör birikti, ta ki ajan kendim için şekillendirdiğim bir karmaşanın içinde yolunu kaybedene kadar.
Bu yüzden bir günümü her başarısızlığı zamanlayarak geçirdim ve bir örüntü ortaya çıktı. Bu yazıda, dünya ona dahi derken ajanınızın neden kolay işlerde takılıp kaldığını ve onu tekrar sizin tarafınıza getirecek çözümü gösteriyorum.
Bu yazıda:
- Klasör yapısı ajanımı başarısızlığa uğrattı çünkü klasörlerim benim düşündüğüm gibi düzenlenmişti, bir ajanın gezindiği gibi değil.
- Her ana klasörün kökündeki bir indeks dosyası, yavaş aramaları otuz saniyelik okumalara dönüştürdü.
- Ajanınızın etrafındaki görünmez iskele, ajanın kendi yeteneğinden daha önemlidir ve işte bunu nasıl inşa edeceğiniz.
- Klasör yapınızın gerçek sorun olup olmadığını görmek için beş dakikada çalıştırabileceğiniz bir tanı testi.
Ajanınızın Göremediği Yapı
Kasamı çoğu insanın yaptığı gibi düzenledim. Makaleler, araştırmalar, varlıklar, strateji belgeleri; her biri kendi klasörünü aldı. Bu yapı temiz hissettirdi çünkü ben içerik türlerine göre düşünüyorum. Klasörler benim kategorilerimi yansıtıyor ve nereye bakacağımı asla düşünmüyorum. Taslaklar makalelerdir, notlar araştırmadır, dosyalama sistemi otomatik pilotta çalışır.
Ancak bir ajan kategoriler halinde düşünmez. Hermes'ten bir ürün lansmanı planlamasını istediğimde, görev farklı klasörlere dağılmış strateji notlarından, marka yönergelerinden ve önceki lansmanlardan bilgi toplar.
Bu bağlam parçaları, içerik türü yapımda farklı yerlerde yaşar. Ajanım her seferinde her yeri aramak zorundadır, hangi taslağın güncel, hangisinin arşivlendiğini veya hangi araştırma notunun bu aya ait, hangisinin altı ay öncesine ait olduğunu bilmeden.
İçerik türüne göre organizasyon insanlar için mükemmel çalışır. Hayatınız boyunca bir şeyleri kategoriler altında dosyaladınız ve beyniniz çapraz referanslamayı otomatik olarak yapar. Yapay zekanın da aynı şekilde çalışmasını beklemek doğaldır, oysa bir ajan bu çapraz referanslamayı manuel olarak yapmak zorundadır ve yapının bozulduğu yer de burasıdır.
Ajanınızın etrafındaki yapı, ajanın kendi yeteneğinden daha fazla iş yapar.
Örüntüyü gördüğümde, neden açıktı: Kasamı, bir şeylerin nerede olduğunu hatırlayan bir insan beyni için inşa etmiş, sonra da her seferinde sıfırdan aramak zorunda olan bir ajana teslim etmiştim ve bu da klasör karmaşasının altındaki gerçek sorunu ortaya çıkardı.
Bir arayıcının bir haritaya ihtiyacı vardır, çünkü harita olmadan ajan karanlıkta yürür ve her dosyaya cevap olabilecekmiş gibi davranır.
Yeteneğin İsraf Ettiği Şey
Hermes, doğru olana ulaşmadan önce bir sürü dosyayı açıp duruyor ya da geçerli dosya başka bir yerdeyken arşivlenmiş bir versiyonu kapıyordu. Daha da kötüsü, cevabın bağlamdan belli olması gerektiği durumlarda hangi dosyayı kullanacağını soruyordu. Bu, Opus, GPT 5.5, Qwen ve GLM dahil kullandığım her modelde oldu.
Örüntü tekrarlayıp duruyordu ve ben aynı yavaş aramaların görevden göreve nasıl oynandığını izlemeye mahkumdum.
Ajanım bir şeyleri bulmak için yeterince yetenekli olsa da, klasör yapısı asıl işe ulaşmadan önce ana darboğaz haline gelmişti.
Başarısızlıkları zamanladığım gün kırılma noktasına geldim. Hermes'in doğru dosyaya ulaşmadan önce kaç dosya açtığını ve oraya ulaşmasının ne kadar sürdüğünü takip ettim. Bir şeyi değiştirmeden önce beş yaygın görev şöyle görünüyordu.
Bir şeyi değiştirmeden önce:
- Güncel makale brifingini bul: 7 dosya açıldı, doğru dosyaya 2:00;
- Marka renk tanımlarını bul: 5 dosya açıldı, 1:12 sürdü;
- Planlama için makale kuyruğuna bak: 4 dosya açıldı, 0:48 sürdü;
- Aynı konudaki önceki makaleleri bul: 6 dosya açıldı, 1:36 sürdü;
- Bir lansman için promosyon stratejisini çek: 3 dosya açıldı, 0:34 sürdü.
Kaba bir deney, bu yüzden kesin sayılara yön gösterici olarak bakın.
Her görev birden çok klasörü aştı. Çoğu, aktif olanları bulmadan önce arşivlenmiş versiyonları açtı. Ajanım, işini yapmak yerine yeteneğini navigasyona harcıyordu. Bir lansman planı, üç farklı klasörde bulunan üç dosyaya ihtiyaç duyuyordu ve doğru olanlara ulaşmadan önce üç yanlış deneme yaptığını izledim.
Makaleler yazan, kodlayan ve planlayan bir ajan, zamanının çoğunu bir şeyler arayarak geçirmemeli.
İşe Yarayan En Küçük Kafes
Her ilgi alanı için bir klasör, sıra için numaralandırılmış ve her şeyi haritalayan kökünde bir INDEX.md dosyası. Tüm çözüm bu ve detaylar birlikte çalışan üç kuralda yatıyor.
Her ana klasörün kökündeki INDEX.md bir haritadır. Her alt klasörü ve kanonik dosyayı, ayrıca ajanımın nereden başlaması gerektiğini listeler. Ajanım önce bunu okur ve başka bir şeye dokunmadan önce içeride ne olduğunu bilir. Bunu, ajanın neyle çalıştığını bilene kadar çalışmaya başlamasına izin verilmeyen yumuşak bir onay kapısı olarak düşünün.
Yeniden organizasyondan sonra marka klasörü yapım şöyle görünüyor.
105.Marka/2├── INDEX.md3├── 01.Marka Sistemi/4├── 02.Editoryal Strateji/5├── 03.Promosyon/6├── 04.Herkese Açık Teslimatlar/7├── 05.Operasyon Planı/8└── 06.Arşivlenmiş/
Bu yapı, içerik türü yerine ilgi alanına göre düzenler. Her ilgi alanı kendi klasörünü alır, böylece marka çalışması marka çalışmasıyla, strateji de stratejiyle kalır. Ajanım, ait olmadığı bir şeyi aramak için sınırları aşmaz.
Klasörlerdeki numaralar, alfabetik sıralamaya güvenmek yerine okuma sırasını açık hale getirir. 01. Marka Sistemi, 02. Editoryal Strateji'den önce okunur. Ajanım tahmin etmez. Klasörlerin içindeki numaralar dosyalar için de aynısını yapar, böylece ajanım 01. Makaleler'in, 02. Önceki Makaleler'den önce başlangıç noktası olduğunu bilir.
Klasör adlarının başına bir numara koyuyorum çünkü benim hatırlamam için de daha kolay.
Tam 30 dolarlık Hermes yığınımın, ajanım asla kaybolmadan düzinelerce klasör arasında kolayca hareket etmesini sağlayan şey budur.
Arşivlenmiş şeyler, eski brifinglerin ve emekli planların beklemeye gittiği 06.Arşivlenmiş'te yaşar. Ajanım, özellikle geçmiş bağlam istemedikçe oraya bakmaması gerektiğini bilir. Bu ayrım, aktif klasörleri temiz ve aramaları hızlı tutan şeydir.
Ajanıma varsayılan olarak bu sınırı geçmemesi söylendikten sonra, aktif klasörlerin içindeki her görev daha hızlı çalıştı.
INDEX.md dosyam şöyle görünüyor.
1# Marka İndeksi23Bu klasör, mevcut marka sistemini barındırır.45## Klasör Haritası67| Klasör | Amaç | Güncellenme |8|---|---|---:|9| `01.Marka Sistemi/` | Görsel kimlik, konu kapsamı, ses | 2026-06-11 |10| `02.Editoryal Strateji/` | Makale yönü, başlık kuralları, kuyruk | 2026-06-11 |11| `03.Promosyon/` | Lansman, dağıtım, araç stratejisi | 2026-06-11 |1213## Kanonik Dosyalar1415| Dosya | Amaç |16|---|---|17| `01.Marka Sistemi/01. Marka Sistemi.md` | Görsel kimlik, renkler, tipografi |18| `02.Editoryal Strateji/01. Makaleler.md` | Makale kuyruğu, başlık kuralları |1920## Nereye Gidilmeli2122- Misyon için `01.Marka Sistemi/04. Yön.md` ile başlayın23- Makale seçimi için `02.Editoryal Strateji/01. Makaleler.md`'yi kullanın
INDEX.md üç versiyondan geçti. İlk versiyonum marka klasörünün içindeki her bir dosyayı listeliyordu ve kırk satıra ulaşıyordu. Teknik olarak eksiksizdi ancak ajanımın her seferinde onu ayrıştırması gerekiyordu ve uzunluk kendi başına bir yüktü. İkinci versiyonum çok kısaydı, yaklaşık on beş satırdı ve ajanım hâlâ cevaplamadığım sorular soruyordu. Bu üçüncü versiyon yalnızca alt klasörleri ve kanonik dosyaları, ajanıma başlangıç noktalarını söyleyen kısa bir "Nereye Gidilmeli" bölümüyle birlikte listeliyor.
Ajanımdan bir lansman için promosyon stratejisini çekmesini istediğimde, 05.Marka/INDEX.md'yi okur, 03.Promosyon/01. Promosyon Stratejisi.md'yi açar ve işe koyulur. Yeniden organizasyondan sonraki zamanlama şöyle görünüyor.
Yeniden organizasyondan sonra:
- Güncel makale brifingini bul: 1 dosya açıldı, 0:10
- Marka renk tanımlarını bul: 3 dosya açıldı, 0:22
- Planlama için makale kuyruğuna bak: 1 dosya açıldı, 0:10
- Aynı konudaki önceki makaleleri bul: 2 dosya açıldı, 0:18
- Bir lansman için promosyon stratejisini çek: 1 dosya açıldı, 0:12
En yavaş görev 2 dakikadan 26 saniyeye düştü ve en hızlı çalışmalar 10 saniye civarında gerçekleşti. Ajanım INDEX.md'yi açar, ihtiyaç duyduğu başlangıç noktasını takip eder ve dolaşmadan işe koyulur. Ajanımın tarafında hiçbir yetenek değişmedi. Klasör yapısı, görev başlamadan önce bunun çoğunu boşa harcamayı durdurdu.
Klasör yapısı, ajanımın ne yapabileceğini kısıtlamadan nasıl hareket ettiğini sınırlayan, inşa ettiğim bir kafestir. Kafesin içinde ajanım özgürce koşar. Onsuz, Hermes dolaşıp durma eğilimindedir ve ben de onu doğru dosyaya yönlendirerek zamanımı boşa harcamak zorunda kalırım.
Hermes'e geçmek, bu tür bir sistemi dosyalar, sağlayıcılar ve bellek arasında aynı anda kurmamı sağladı ve INDEX.md deseni, günlük olarak en büyük farkı yaratan en küçük parçaydı.
Her Kafesin Bir Kilidi Vardır
İlk hatam, INDEX.md'yi her alt klasöre eklemekti. Çok fazla harita, ajanımın iş yapmak yerine indeksleri okuyarak zaman geçirmesi anlamına gelir. INDEX.md'yi yalnızca Marka ve Editoryal Strateji gibi, bir haritaya ihtiyaç duyacak kadar alt klasörün bulunduğu ana klasörlerin kökünde tutuyorum. Dört veya beş dosyalı küçük bir alt klasörün içinde Hermes, hiçbir harita olmadan doğrudan gezinir.
Unutmayın, yeni klasörler eklediğinizde numaralandırma sıkıcı hale gelir. Yeni bir klasörün sıraya nereye uyduğuna karar vermem gerekiyor ve bazen her şeyi yeniden numaralandırmak yerine onu sona ekliyorum. Bu sorun değil. Numaralar, yön gösterici oldukları sürece mükemmel olmak zorunda değildir. Mükemmel sıralanmış klasörler hedef değildir ve onları öyle görmek, pratik bir düzeltmeyi kozmetik bir projeye dönüştürür.
Daha büyük bir hata, ajanınız herhangi bir kafa karışıklığı göstermeden önce yapı inşa etmektir. Çoğu insan, uygun altyapıya ihtiyacı olduğunu düşündüğü için ajan kurulumunu aşırı mühendislikle yapar.
Mevcut kuralım, MCP'ler ile CLI'lar veya kendi aracınız arasında seçim yapmanın arkasındaki prensibi takip eder. İşi halleden en küçük arayüzü kullanın. Yapıyı yalnızca ajanınız kaybolduğunda ekleyin ve yalnızca bu belirli sorunu çözecek kadar yapı ekleyin.
Karşılaştığım başka bir başarısızlık, yapıyı yapının içine yerleştirmekti. Her şeyi mükemmel bir şekilde kategorize etmek için alt klasörlerin içine alt klasörler ekledim, bu da iki seviyeli bir hiyerarşiyi beş seviyeli bir hiyerarşiye dönüştürdü. Ajanım daha sonra tek bir dosyaya ulaşmak için birden çok INDEX dosyasını okumak ve birden çok numaralandırma sırasını ayrıştırmak zorunda kaldı. Bu ekstra seviyeleri düz alt klasörlere geri çöktüm ve gezinme tekrar hızlandı.
Derinlik, hızlı dosya aramanın düşmanıdır ve çoğu yeniden organizasyon, bunun hassasiyet olduğunu düşünerek derinlik ekler.
Yeniden Düzenlemeden Önce Ölçün
Tek bir klasöre dokunmadan önce, ajanınızın en sık ele aldığı üç gerçek görevde bu testi çalıştırın. Her birini zamanlayın ve doğru olanı bulmadan önce kaç dosya açtığını not edin. Yanlış dosyayı ne sıklıkta seçtiğini veya hangisini kullanacağını sormak için durduğunu takip edin.
Ajanınızın otuz saniyeden fazla süren veya üç veya daha fazla yanlış dosya açan herhangi bir görevi, bu görevin arkasındaki bozuk bir klasörü işaret eder.
En sık meydana gelen başarısızlığı seçin. Bu klasörü açın ve her alt klasörü ve önemli dosyayı, ayrıca ajanınızın nereden başlaması gerektiğini listeleyen bir INDEX.md yazın. Kaydedin. Aynı görevi tekrar çalıştırın.
Ajanınız doğru dosyayı otuz saniyenin altında bulursa, düzeltme işe yaramıştır ve artık deseni biliyorsunuzdur. Bir sonraki bozuk klasöre uygulayın. Hâlâ başarısız olursa, sorun muhtemelen numaralandırma veya klasör başına tek ilgi alanıdır ve bunlar düzeltilecek sonraki iki şeydir.
En çok zaman kaybettiren klasörle başlayın, düzeltin ve ancak hazır olduğunuzda bir sonrakine geçin.
Çubukların Hâlâ Eğildiği Yer
Arşivlenmiş içerik, bazen bağlam için eski bir brifinge ihtiyacım olduğunda hâlâ referans alınır. Ajanımın aktif klasörler yerine 06.Arşivlenmiş'e bakması gerektiğini bilmesi gerekir ve bunu, tarihsel materyalin nerede olduğunu bilmesi için INDEX.md'de belirtiyorum. Bu not olmadan, ajanım arşivlenmiş içeriğin var olmadığını varsayar.
Ayrıca, Obsidian Sync, cihazlar arasında temiz bir şekilde yakalanmadığında ara sıra sorunlar yaratır. Dizüstü bilgisayarımda bir dosyayı güncellersem ancak VPS'mde hâlâ eski sürüm duruyorsa, Hermes VPS kopyasını yükler ve onu mevcut gerçeğin kaynağı olarak ele alır. Bu, klasör yapısı sorunundan çok bir senkronizasyon sorunudur, ancak ajan yalnızca önündeki dosyaları gördüğü için klasör sistemi içinde ortaya çıkar.
O kadar çok klasörünüz olduğunda numaralandırma bozulur ki sıra anlamsız hale gelir. Bir seviyede on veya on iki numaralı öğeyi geçtikten sonra, numaralar keyfi olmaya başlar.
Ana kategorileri bu eşiğin altında tutmaya ve üst seviyeyi genişletmek yerine daha derin yapıyı içine yerleştirmeye çalışıyorum.
Yeniden adlandırma başka bir sürtünme kaynağıdır. Yeniden düzenleme yaptığımda bazen klasörleri amaçlarına daha iyi uyacak şekilde yeniden adlandırıyorum ve güncelleyene kadar eski ada yapılan herhangi bir INDEX.md referansı bozuluyor. Artık klasör adlarını bir kez belirleyip onları olduğu gibi bırakmaya çalışıyorum, çünkü biraz garip bir isim, bozuk bir referanstan daha ucuzdur.
Bu yapı, içerik ağırlıklı iş akışları ve planlama ağırlıklı olanlar için en iyi sonucu verir. Tamamen kod veya veri ağırlıklı kurulumlar, tamamen farklı organizasyon ilkeleri gerektirebilir ve INDEX.md deseni her gezinme sorununu çözmez.
Bu makalede yazdığım her şey tek bir içgüdüye dayanıyor. Önemli olan katmana sahip olun. Yığınımı, hiçbir şirketin araçlarımı kontrol etmemesi için inşa ettim. Kasamı, hiçbir karmaşanın ajanımı kontrol etmemesi için inşa ettim. Sağlayıcılardan klasörlere ve sırada ne varsa aynı prensip.
Etrafındaki iskele bozuk olduğunda yetenek ucuzdur. İskeleyi inşa edin, yetenek kendi kendine hallolur. Bir indeks dosyası ve klasör adlarınızın önünde birkaç numara, dolaşan bir ajan ile çalışan bir ajan arasındaki farktır.
Bu faydalıysa - daha fazla bu tür içerik için @wandermist'i takip edin!
