Herkes döngülerden bahsediyor. Neredeyse hiç kimse döngünün ne üzerinde çalıştığından bahsetmiyor. 10 geliştiriciden 9'u Claude Code'u varsayılan harness ile çalıştırıyor - hiçbir kural, alt-ajan, hook veya bellek olmadan.
Sonra da döngülerinin neden kalitesiz çıktı ürettiğini merak ediyorlar. Gerçek basit: bir döngü, ancak altındaki harness kadar iyidir. Bu, harness için 14 adımlık yol haritasıdır - tek bir ajandan kendini geliştiren bir sisteme.
Taze AI alfaları için Substack'imi takip edin:
Döngü mühendisliği - ajanınızı bir programa göre yönlendiren bir sistem oluşturmak - bu ay tüm ilgiyi topladı. Ancak döngüler hakkında uzun soluklu makaleyi yazan Addy Osmani, bunun altında yatan şeye dikkat çekmeyi ihmal etmedi:
"Döngü mühendisliği, harness'in bir üst katında yer alır. Harness, tek bir ajanın içinde çalıştığı ortamdır. Döngü ise harness'tir, ancak bir zamanlayıcıyla çalışır, yardımcılar oluşturur ve kendini besler."
Harness mühendisliği, bu ortamı tasarlamaktır: model, araçlar, izinler, bağlam, bellek.
Gösterişsiz katmandır - ve üzerindeki her şeyin çalışıp çalışmayacağını belirleyen katmandır. Kötü bir harness üzerindeki harika bir döngü, ölçekte hızlı bir şekilde kalitesiz çıktı üretmenin yoludur.
14 adım. 3 kademe. Diğer her şeyin üzerine inşa edildiği temel.
Bölüm 1 · Harness Nedir
01. Harness, bir ajanın içinde çalıştığı ortamdır.
Jargonu bir kenara bırakın, bir harness dört şeyden oluşur: düşünmeyi yapan model, ulaşabileceği araçlar, bu araçlar üzerindeki izinler ve her çalıştırmada okuduğu bağlam.
Bütün yüzey bu kadar. Diğer her şey - alt-ajanlar, hook'lar, bellek - bu dört unsurdan birini şekillendirmenin bir yoludur.
Harness'in insanların düşündüğünden daha önemli olmasının nedeni: ajan, bir araç seçen, onu çalıştıran, sonuca bakan ve bir sonraki hamleye karar veren bir while True döngüsüdür.
Harness, hangi araçların var olduğunu, ajanın ne yapmasına izin verildiğini ve başlangıçta ne bildiğini tanımlar. Aynı model, farklı harness, tamamen farklı ajan.
02. Harness'in tamamı tek bir klasörde yaşar. .claude/
Ajanınızı şekillendiren her şey, proje kök dizininizdeki tek bir dizinde bulunur. Bu düzeni öğrenin, herhangi birinin harness'ine bakarak anlayabilirsiniz:
1.claude/2├─ CLAUDE.md # sabit bilgiler — her oturumda okunur3├─ settings.json # izinler, model, hook'lar4├─ .mcp.json # harici araç bağlantıları5├─ rules/ # yol kapsamlı davranışlar6│ ├─ tests.md7│ └─ python-types.md8├─ agents/ # alt-ajan tanımları (~30 satır)9│ ├─ reviewer.md10│ └─ eval-runner.md11├─ skills/ # tekrar kullanılabilir iş akışları12│ └─ pr-checklist/13│ └─ SKILL.md14└─ agent-memory/ # çalıştırmalar arasında hayatta kalanlar15 └─ STATE.md
Temiz bir harness'i karmakarışık olandan ayıran tek bir kural: her dosyanın neden var olduğunu açıklayabileceğiniz kadar küçük tutun. Bir kuralın, hook'un veya alt-ajanın ne işe yaradığını söyleyemiyorsanız, silin.
03. Harness vs döngü vs sistem. Üç katman, bunları karıştırmayın.
Çoğu "ajan kurulumum berbat" sorunu, üç katmanı birbirine karıştırmaktan kaynaklanır. Bunları ayırın:
- Harness, bir ajanın yaşadığı çalışma zamanıdır. Statik yapılandırma: model, araçlar, izinler, bağlam. Bu sayı.
- Döngü, ajanı bir zamanlayıcıda yönlendirir, yardımcılar oluşturur, kendini besler. Harness'in üzerinde çalışır.
- Kendini geliştiren sistem, bir döngü artı biriken bellektir - her çalıştırma bir sonrakini daha keskin hale getirir.
Pratik versiyonu: sabit bilgileri bağlama, zorunlulukları hook'lara, prosedürleri skill'lere ve izolasyonu alt-ajanlara koyun.
Bunları karıştırmak - CLAUDE.md'de zorunluluklar, bağlamı şişiren prosedürler - tutarsız ve pahalı ajanların temel nedenidir.
04. Varsayılan harness. Kutudan çıkan hali.
Claude Code'u kurun, bir klasör açın ve zaten bir harness'iniz var - sadece boş bir tane. Varsayılan, size yetenekli bir model, yerleşik araçlar (oku, yaz, bash, ara) ve riskli her şeyde onay istemleri verir. Proje bağlamı yok, özel alt-ajan yok, bellek yok.
Tek seferlik bir görev için varsayılan yeterlidir. Birden fazla yaptığınız herhangi bir şey için varsayılan, ajanı her oturumda projenizi sıfırdan keşfetmeye, güvenli işlemler için izin istemeye ve terminali kapattığınızda her şeyi unutmaya terk eder.
Sonraki on adım, bu boşluğu kapatmakla ilgilidir.
05. CLAUDE.md: kısa tutulan sabit bilgiler.
CLAUDE.md, her oturumun başında okunur. Ajanın projeniz hakkındaki sabit bilgisidir - kurallar, mimari, "şu olaydan dolayı bu şekilde yapmıyoruz."
En yaygın tek hata: Bunun, her oturumu şişiren devasa bir prosedür belgesine dönüşmesine izin vermek.
Bunu günlük olarak kullanan uygulayıcıların kuralı: ana bellek dosyasını yaklaşık ~500 jetonun altında tutun. Sabit bilgiler buraya gider.
Çok adımlı prosedürler skill'lere gider (adım 8). Yola özgü davranışlar, geçerli oldukları yere kapsamlandırılmış rules/ dosyalarına gider. CLAUDE.md'nin bir bölümü bir prosedür haline geldiyse, başka bir yere aittir.
CLAUDE.md dosyanızı yüksek sesle okuyun. Her satır, ajanın her oturumda ihtiyaç duyduğu bir
bilgi
olmalıdır ("pnpm kullanırız, npm değil"). Bir satır bir
prosedür
ise ("bir özellik eklemek için, önce..."), onu bir skill'e taşıyın.
Eğer bir klasör için bir kural ise, rules/ dosyasına taşıyın.
06. settings.json: izinler ve model, bir kere ayarlanır.
Varsayılan harness, her riskli eylemden önce sorar. Bu, izlerken doğru, izlemezken yanlıştır. settings.json, güvenli şeyleri önceden onayladığınız, tehlikeli şeyleri reddettiğiniz ve hangi modelin çalışacağını seçtiğiniz yerdir.
1{2 "model": "claude-sonnet-4-6",3 "permissions": {4 "autoApprove": [5 "Read(*)", "Grep(*)",6 "Bash(npm test)", "Bash(git status)"7 ],8 "deny": [9 "Bash(rm -rf*)", "Bash(git push*)",10 "Edit(.env*)", "Edit(secrets/*)"11 ]12 }13}
Otomatik onaylanacak şeyler için test: bu yanlış giderse, geri alması ne kadar zor? Geri alması ucuz → otomatik onayla.
Geri alması pahalı (force-push, dosyaları silme, sırlara dokunma) → her zaman reddet veya sor. Orta yol, eğer günlüğe kaydediyorsanız otomatik onaylamak için uygundur.
07. Alt-ajanlar: kirli işler için izole bağlam.
Bir alt-ajan, ana ajandan başlatılan bağımsız bir Claude oturumudur - kendi bağlam penceresi, kendi araç listesi. Amaç, sırf paralellik değildir. Amaç, ana bağlamdaki gürültüyü uzak tutmaktır.
40 dosya okuyan bir araştırma görevi, yeni bir bakış açısı gerektiren bir inceleme geçişi, bir sürü günlük üreten bir değerlendirme çalıştırması - bunlar, ana iş parçacığını kirletmemeleri için bir alt-ajana aittir.
GIF
Herhangi bir harness'teki en değerli alt-ajan, ana ajanın yaptığı işi kontrol edendir. Bir modelin kendi çıktısını incelemesi kendisine karşı çok yumuşaktır;
Yeni bir bağlam penceresine sahip ayrı bir inceleyici, yazarın kendini ikna ettiği şeyleri yakalar. Bu, harness'ın üzerindeki her döngüyü güvenilir kılan yazar-kontrolcü ayrımıdır.
08. Skill'ler: ajanın yeniden kullandığı prosedürler.
Skill, ajanın çalıştırdığı bir SKILL.md dosyasıdır - ya /skill-adı ile çağırdığınızda ya da görev, açıklamasıyla eşleştiğinde otomatik olarak.
Bir alt-ajandan farklı olarak, aynı bağlam penceresinde çalışır. Oturumun bir parçası haline gelen, yeniden kullanılabilir talimatlardır.
Bir tane oluşturma tetikleyicisi: kendinizi her yeni konuşmaya aynı talimatları yapıştırırken bulursunuz. Bu, oluşturulmayı bekleyen bir skill'dir. Bir PR kontrol listesi, bir değerlendirme prosedürü, bir yayınlama süreci - bir kere yazılır, sonsuza kadar çağrılır.
Ve skill'ler yeniden kullanılabilir birim olduğu için, harness'in zamanla iyileşmesini sağlarlar: prosedür yeni bir şekilde başarısız olduğunda, dersi skill'e eklersiniz ve bir sonraki çalıştırma bunu devralır.
09. Hook'lar: modelin halüsinasyon göremeyeceği deterministik kurallar.
Şimdiye kadarki her şey, modelin talimatlarınızı anlamasına bağlıdır. Hook'lar buna bağlı değildir.
Hook, ajan yaşam döngüsünde sabit bir noktada tetiklenen bir kabuk komutudur - bir araç çalışmadan önce, bir dosya değiştikten sonra, oturum sona erdiğinde - ve çıkış kodu eylemi engelleyebilir. Hook'lar zorunluluktur, CLAUDE.md ise öneridir.
Neredeyse her harness'te yerini hak eden iki hook:
- Tehlikeli komutları deterministik olarak engelleyen bir PreToolUse kapısı — rm -rf, .env okuma, main'e push yapma. Çıkış kodu 2, çağrıyı gerçekleşmeden durdurur. Model bunu geçmek için kendini kandıramaz.
- Her düzenlemeden sonra linter'ınızı veya biçimlendiricinizi çalıştıran bir PostToolUse biçimlendiricisi. Ajan asla biçimlendirilmemiş kod göndermez çünkü harness onu otomatik olarak biçimlendirir.
1"hooks": {2 "PreToolUse": [{3 "matcher": "Bash",4 "command": "./.claude/hooks/block-dangerous.sh"5 // çıkış 2 = çağrıyı çalışmadan önce engelle6 }],7 "PostToolUse": [{8 "matcher": "Edit|Write",9 "command": "prettier --write \"$CLAUDE_FILE_PATH\""10 }]11}
Hook'ları, olması veya asla olmaması gereken herhangi bir şey için kullanın - güvenlik, biçimlendirme, denetim günlüğü.
Bunları karar verme durumları için kullanmayın; bunun için model vardır. İyi bir harness'in bir veya iki keskin hook'u vardır, yirmi tane değil.
Bölüm 3 · Birikmesini Sağlayın
10. Bir döngü ekleyin. Artık harness bir zamanlayıcıda çalışır.
Yapılandırılmış bir harness hala yazmanızı bekler. Bir döngü, onun kendi kendine çalışmasını sağlar. En basit versiyonu Claude Code'da /loop'dur - bir döngüde yinelenen bir istem.
Bunu /goal ile eşleştirin ve döngü, ajanın kendini değerlendirmesinden ziyade bağımsız bir değerlendirici tarafından kontrol edilen nesnel bir koşul doğru olana kadar devam eder.
1> /loop 30m /goal Tüm testler geçiyor ve lint temiz.2 Yeni hataları triyajla, claude/ dallarında düzeltme taslakları hazırla.34▲ Claude, oluşturduğunuz harness'i kullanır:5 - kurallar için rules/6 - her düzeltmeyi kontrol etmek için inceleyici alt-ajanı7 - PreToolUse hook'u main'e push'ları engeller8✓ Döngüleniyor. Bağımsız değerlendirici "bitti" kararını verir.
Az önce ne olduğuna dikkat edin: döngü zeka eklemedi. Harness'teki her şeyi yeniden kullandı - kurallar, inceleyici alt-ajanı, güvenlik hook'u. İyi bir harness, bir döngüyü önemsiz hale getirir. Önce temeli inşa etmenin bütün amacı budur.
11. Dinamik iş akışları ekleyin. Harness kendi orkestrasyonunu yazar.
Tek bir döngü için çok karmaşık görevler için - kitlesel paralel, son derece yapılandırılmış, çekişmeli - Claude anında kendi JavaScript harness'ini yazabilir.
Bu dinamik bir iş akışıdır: oluşturmak için agent(), dallanmak için parallel(), akışa almak için pipeline(). Harness'inizin tanımladığı alt-ajanları, dallan-ve-sentezle veya çekişmeli doğrulama gibi desenlerde birleştirir.
Harness mühendisliğiyle bağlantısı: dinamik bir iş akışı, ancak çağırabileceği alt-ajanlar ve skill'ler kadar iyidir.
Harness'inizin keskin bir inceleyici alt-ajanı ve iyi yazılmış bir değerlendirme skill'i varsa, iş akışının orkestra edecek iyi parçaları vardır. Harness boşsa, iş akışının çalışacak hiçbir şeyi yoktur.
İş akışı orkestra şefidir, harness'iniz orkestradır.
12. Bellek ekleyin. Ajanın unuttuğunu, harness hatırlar.
Bu, yapılandırılmış bir harness'i gerçekten iyileşen bir sisteme dönüştüren adımdır. Ajan, çalıştırmalar arasında her şeyi unutur. Harness'in unutması gerekmez.
Bir durum dosyası - agent-memory/ içinde bir işaretleme dosyası veya bir Linear panosu - neyin denendiğini, neyin işe yaradığını, neyin başarısız olduğunu, hangi kuralların hayatta kaldığını kaydeder.
Belleği biriktiren desen, en güçlü ajanların onu nasıl kullandığından alınmıştır:
- Uzaklaşmadan önce yazın. Her çalıştırma, durum dosyasını güncelleyerek sona erer - öğrenilen dersler, doğrulanan bilgiler, sıradaki.
- Başlangıçta okuyun. Her çalıştırma, durum dosyasını ve ilgili skill'leri okuyarak başlar, böylece yeniden başlatmak yerine kaldığı yerden devam eder.
- Skill'lere damıtın. Bir ders genel olduğunda ("Windows çalıştırıcılarının PowerShell değil bash'a ihtiyacı vardır"), durum dosyasından bir skill'e terfi eder ve burada gelecekteki her proje için geçerli olur.
1# Proje belleği23## Doğrulanan bilgiler # bunlar hakkında tahmin yürütmeyi bırak4- prc dolar cinsindendir, sent değil (SELECT MIN/MAX ile kontrol edildi)5- auth middleware sırası: rate_limit -> jwt -> rbac67## Öğrenilen dersler # genel olanları skill'lere damıt8- Windows CI çalıştırıcıları TLS 1.2'de PowerShell'de başarısız olur — bash kullan9- 1 milyon satırdan büyük tablolardaki migrasyonlar 10k'lik gruplar halinde yapılmalıdır1011## Son oturum # yeniden başlatma, kaldığın yerden devam et122026-06-11 · 3 düzeltme birleştirildi, 2 iletildi. Sıradaki: rate-limit düzeltmesini doğrula.
13. Döngüyü kapatın. Çıktı → ders → skill → daha iyi çıktı.
İşte üç katmanın, kendini geliştiren bir şey halinde kilitlendiği yer. Her çalıştırma çıktı üretir. İnceleyici alt-ajanı (adım 7) onu kontrol eder.
Sonuç - neyin geçtiği, neyin başarısız olduğu, neyin öğrenildiği - belleğe yazılır (adım 12). Genel dersler skill'lere (adım 8) damıtılır.
Bir sonraki çalıştırma, daha keskin skill'leri ve daha zengin belleği devralır.
Bütün kendini geliştiren döngü budur ve tamamen harness parçalarından oluştuğuna dikkat edin:
- Alt-ajan çalışmayı derecelendirir - nesnel kontrol, taze bağlam.
- Bellek kararı kaydeder - çalıştırmalar arasında hayatta kalır.
- Skill'ler bunu biriktirir.
- Döngü onu tekrar çalıştırır - artık son çalıştırmanın öğrendiği her şeyle birlikte.
Model asla değişmedi. Etrafındaki harness keskinleşti. "Kendini geliştirme"nin dürüstçe anlamı budur - öğrenen bir model değil, biriken bir harness.
14. Harness'i dağıtın. Paketleyin. Paylaşın. Yeniden kullanın.
Bir projede çalışan bir harness bir varlıktır.
Skill'leri, alt-ajanları ve kuralları bir eklentiye paketleyin ve tüm ekibiniz aynı kurulumu tek adımda yüklesin - aynı kurallar, aynı güvenlik hook'ları, aynı inceleyici.
Harness, kişisel kurulumunuz olmaktan çıkar ve paylaşılan bir altyapı haline gelir.
İnşa etme sırası, son bir kez, çünkü sıra derstir: temiz bir harness üzerinde tek bir manuel çalıştırmayı güvenilir hale getirin.
Bağlamı ve izinleri ekleyin. Bir inceleyici alt-ajanı ekleyin. Bellek ekleyin. Ancak ondan sonra bir döngüye sarın. İyi bir harness üzerindeki döngü birikir. Kötü bir harness üzerindeki döngü sadece daha hızlı kanar.
§ Her Döngüyü Daha Kötü Yapan Harness Hataları
- Varsayılan üzerinde çalıştırmak. Bağlam, kural veya bellek yok - ajan projenizi her oturumda yeniden keşfeder.
- Şişmiş bir CLAUDE.md. Sabit bağlama tıkıştırılmış prosedürler, her çalıştırmayı şişirir. Bunları skill'lere taşıyın.
- CLAUDE.md'de hook'lar yerine zorunluluk. Model bir öneriyi görmezden gelebilir. Çıkış kodu 2 olan bir hook'u görmezden gelemez.
- Tek bir ajanın kendi çalışmasını yazıp derecelendirmesi. Yeni bir bağlam penceresine sahip bir inceleyici alt-ajanı ekleyin.
- Bellek yok. Her çalıştırma sıfırdan başlar. Durum dosyası, yarının kaldığı yerden devam etmesini sağlar.
- Kötü bir harness'in etrafına bir döngü sarmak. Döngü sadece daha hızlı kalitesiz çıktı üretir. Önce temeli inşa edin.
- Yirmi hook. Bir veya iki keskin hook, kimsenin anlamadığı bir yığından daha iyidir.
- Bir harness'i taramadan dağıtmak. Sızdırılmış sırlar ve aşırı geniş izinler, onu kuran herkese yayılır.
Sonuç:
Döngü şanı alır. İşi harness yapar.
Döngü mühendisliği heyecan verici kısımdır - ajanın kendi kendine istem vermesi, siz uyurken çalışması. Ancak bir döngü, sadece zamanlayıcıdaki bir harness'tir.
Çıktının iyi mi yoksa kalitesiz mi olduğuna karar veren her şey bir kat aşağıda yaşar, seçtiğiniz modelde, izin verdiğiniz araçlarda, yazdığınız bağlamda, eklediğiniz inceleyicide, tuttuğunuz bellekte.
O katı iyi inşa edin ve üzerindeki her şey birikir: döngü alt-ajanlarınızı yeniden kullanır, iş akışı skill'lerinizi orkestra eder, bellek her çalıştırmayı bir öncekinden daha keskin yapar.
Kendini geliştirme hiçbir zaman modelin bir özelliği olmadı. Etrafına inşa ettiğiniz harness'in bir özelliğidir.
Yapmadığınız bir şeyi seçin - muhtemelen bir inceleyici alt-ajanı, bir güvenlik hook'u veya bir durum dosyası - ve bugün ekleyin. Harness'i açıklayabileceğiniz kadar küçük tutun. Ardından üstüne bir döngü koyun ve temelin işi yapmasını izleyin.
