Ajanınız bozuk değil — bozuk olan onun etrafındaki şeyler

Aynı model bir repoda güvenilir bir senior geliştirici gibi çalışırken, diğerinde şaşırıyor, oturumlar arasında bağlamını kaybediyor ve çalışmayan bir özellik için 'bitti' raporu veriyor. Birçok kişi bu anda koşarak daha yeni bir modele geçiyor. Ve bu neredeyse hiç işe yaramıyor: aynı model, iyi kurgulanmış bir projede gayet başarılı. Demek ki mesele ajanın yeteneklerinde değil, onu çevreleyen şeylerde. İşte bu çevreye harnes deniyor.

Harnes, kelimenin tam anlamıyla 'koşum takımı' demektir: modelin ağırlıklarının ötesinde kalan ve modelin yeteneklerinin hangi bölümünün projenizde gerçekten ortaya çıkacağını belirleyen her şey. Kural basit: modelin ağırlığı değilse, harnestir. Buna AGENTS.md ve CLAUDE.md gibi talimat dosyaları girer; ajanın eriştiği araçlar — shell, testler, linter, MCP konnektörleri; sürümleri ve konteynerleriyle çalıştırma ortamı; ilerleme dosyaları ve git checkpoint'leriyle durum yönetimi; ve doğrulama komutlarıyla uçtan uca (E2E) testlerden oluşan geri bildirim döngüleri.

Kursun özünü güzelce anlatan bir metafor var: model bir attır ve ne kadar safkan olursa potansiyeli o kadar yüksektir. Harnes ise koşum takımıdır: dizgin, tasma, üzengi. Mesele, safkan atın koşumsuz hiçbir yere gidememesi değil — aksine son sürat koşabilir. Asıl sorun şu: koşumsuz binici onu yönetemez. At tasmayı dinlemez, komutlara kulak asmaz, gitmesi gereken yere değil kendi istediği yere atılır. Bu yüzden bu kursta neredeyse hiç daha safkan bir modelin nasıl seçileceğini konuşmayacağız; onun yerine onu yönetilebilir kılan bir koşum takımının nasıl inşa edileceğini konuşacağız.

Kursun ilk teşhis kuralı çok basit: ajan bozulduğunda önce harnesi kontrol edin, ancak ondan sonra modeli. Aynı model, iyi yapılandırılmış repolarda benzer görevleri başarıyla çözüyorsa, sorun neredeyse kesin sizin ortamınızdadır, onun yeteneklerinde değil. Model değiştirmek en pahalı ve en öngörülemez tamirdir; çünkü her şeyi birden değiştirirsiniz ve neyin işe yaradığını bilemezsiniz. Harnes teşhisi ise daha ucuz, daha hızlı ve neredeyse her zaman sebebi daha isabetli gösterir.

Zaten kodlama için bir AI ajanı kullanıyorsanız — Claude Code, OpenAI Codex, Cursor ya da benzeri — ve kararsız sonuçlar alıyorsanız, bu kurs tam size göre. Ajanın gözetim altında on dakika değil, saatlerce ve bütün oturumlar boyunca çalışmasını isteyenler için. Ajanların etrafında dahili bir araç ya da platform kuranlar için ve ajanın yazdığı kodun korkusuzca merge edilebilmesinden sorumlu olanlar için. Kısacası: bu kurs, 'prompt yazıyorum'dan 'prompt yazan bir sistem tasarlıyorum'a geçmek isteyenler içindir.

Genelde bir kurs, bir ay sonra diskte tozlanan bir ders notudur. Burada durum farklı: tüm kurs tek bir proje etrafında kuruluyor — hayali, FastAPI tabanlı bir ödeme backend'i — ve her ders ona gerçek bir dosya ekliyor: AGENTS.md, feature_list., verify.sh, program.md ve devamı. Son derste elinizde soyut bir fikir listesi değil, harnesin tamamını barındıran çalışan bir repo olacak — ve aynı iskeleti ertesi gün kendi projenize birebir taşıyabilirsiniz.

Kursun rotası bir konu listesi değil, yol boyunca giderek iyileşen tek bir ajanın hikâyesi. Önce teori: ajan neden hata yapar ve tam olarak hangi katmanda. Ardından harnes parça parça ele alınıyor: ajanın gerçekten okuduğu talimatlar, oturumlar arası bellek, dürüst doğrulama; sonda ise otonom döngüler ve rol grafları. Her ders, 'ajan bitti yazdı ama özellik çalışmıyor' gibi gerçek bir belirtiyle başlar; tanım paragrafıyla değil. Ve bunların hepsi aynı büyüyen repo üzerinde gerçekleşiyor; böylece finalde harnes eksiksiz biçimde bir araya geliyor, birbirinden kopuk püf noktaları yığını olarak kalmıyor.

Kursun son dersi tek bir yeni kavram bile eklemiyor; bugüne kadar öğrendiğiniz her şeyi tek bir uçtan uca projede — FastAPI ile yazılmış, iyzico'yu andıran bir ödeme backend'inde — tek bir sisteme dönüştürüyor. Burada harness baştan sona kuruluyor: deponun kök dizinindeki ilk AGENTS.md'den, yolun sonundaki otonom rol grafiğine kadar. Ve ajanın metriklerinin nasıl değiştiğini kendi gözlerinizle göreceksiniz: önceden kaotik ve güvenilmezdi, şimdi öngörülebilir ve doğrulanabilir. Bu iskeleti daha sonra kendi iş projenize taşıyabilirsiniz.

Konu listesine değil, sonuca bakın. İlk derslerden sonra şunu net biçimde ayırt edeceksiniz: sorun harness'te mi, yoksa ajana modelin yetenekleri gerçekten mi yetmiyor. Ardından ajana sadece ilk beş satırına değil, tamamına uyacağı bir AGENTS.md yazacak, görevi erken 'bitti' ilan etmesinin önüne geçen bir gate kuracaksınız ve bir noktada onu saatlerce, her adımında yanınızda olmadan çalışmaya bırakabileceksiniz — çünkü hatalarını artık siz değil, harness yakalıyor.

Somut tekniklere geçmeden önce, tüm kursun üzerine kurulduğu tek bir soruyu yanıtlamak gerekiyor: ajan her adımda yüz durumun doksan beşinde haklıyken, görevi nasıl oluyor da onuncu adımda baştan aşağı batırıyor? Bu sorunun cevabı olmadan, tüm harness teknikleri neden işe yaradıklarını açıklayan bir temele sahip olmayan, rastgele bir checklist yığınından ibaret kalıyor. Bir sonraki ders tam da bu soruyla başlıyor — tanım paragrafıyla değil, somut bir başarısızlığın matematiğiyle.