Yapay zeka kodlama çevrelerinde şöyle bir iddia dolaşıyor: kodlama ajanlarınıza komut vermeyi bırakın ve onlar adına komut verecek döngüler tasarlamaya başlayın. Yeni olan her şey gibi, bu da sık sık tekrarlanıyor ama nadiren açıklanıyor. İşte pratik versiyonu: ajan döngüsü nedir, neden önemlidir ve üretimde nasıl görünür.
Aşağıda, öğrencilerimiz, teknik kurucular, yapay zeka mühendisleri ve girişimlerle yaptığım bazı deneyler, araştırmalar ve konuşmalardan (Claude'un yardımıyla yazılmış) bazı düşüncelerimi okuyabilirsiniz.
Tüm bunlar için iyi bir başlangıç noktası olarak "Otonom Uzun Süreli Kodlama Ajanları" başlıklı son canlı oturumumuzu da faydalı bulabilirsiniz.
İddia Nereden Geliyor
"Artık kodlama ajanlarına komut vermemelisiniz. Ajanlarınıza komut verecek döngüler tasarlamalısınız."Peter Steinberger (
@steipete ), 7 Haziran 2026. 2,2 milyon görüntülenme.
Claude Code'un yaratıcısı Boris Cherny de aynı noktaya diğer taraftan değiniyor.
"Artık Claude'a komut vermiyorum. Çalışan döngülerim var. Onlar Claude'a komut veriyor ve ne yapacağını belirliyor. Benim işim döngüler yazmak."Boris Cherny (
@bcherny ).
Mesele, prompt mühendisliğinin öldüğü değil. Döngü mühendisliği ile iş bir üst seviyeye taşınıyor: kodu yazmaktan, kodu yazan sistemi yazmaya. Bu yolda en ileride olan geliştiriciler, bir IDE açmadan, her satırı ajan tarafından yazılmış yüzlerce PR'ı gönderdikleri aylar olduğunu bildiriyor.
Bir Döngü Aslında Nedir
Bir döngü, dört şey yapan küçük bir programdır:
- sizin için kodlama ajanına komut verir,
- ürettiği şeyi okur,
- bitip bitmediğine karar verir,
- ve bitmediyse, hatayla veya sonraki adımla tekrar komut verir.
Döngünün içinde oturup komut yazmayı bırakırsınız; döngüyü siz yazarsınız ve model onun çağırdığı bir alt rutin haline gelir.
Şekil her zaman aynıdır: bir hedef belirle, harekete geç, kontrol et, hatayı geri besle ve kontrol geçene veya döngü kendini durdurana kadar tekrarla.
"Döngü" En Az Beş Şey Demek
Anlaşmazlığın büyük kısmı, insanların beş farklı fikir için tek bir kelime kullanmasından kaynaklanıyor. İşte en eskiden en yeniye doğru ilerleme.
- ReAct (2022). Orijinal araştırma modeli: akıl yürüt, harekete geç, gözlemle, tekrarla.
- AutoGPT (2023). Kendi kendine komut veren bir hedef döngüsü; ne zaman duracağını bilememesiyle ünlü.
- ralph döngüsü. Ajanın kendi geçmişinde boğulmaması için yinelemeler arasında kasıtlı bir bağlam sıfırlaması.
- /loop ve /goal. Ritim ve tamamlanma koşulları, durumu turlar arasında taşıyarak ajanın içine yerleşiktir.
- orkestrasyon. Bir yazar, GitHub'ınızı, Slack'inizi ve sohbetinizi okuyan ve sırada ne inşa edileceğine karar veren birçok ajanı dallara ayırır.
Gerçekten Birleştirdiğiniz Parçalar
Bu ilerleme, insanların döngü ile neyi kastettiğini açıklar; işte bir döngünün neyden inşa edildiği. Aynı altı parça her seferinde karşımıza çıkar ve çoğu artık sizin kendi bakımınızı yaptığınız özel komut dosyaları yerine kodlama araçlarının içinde yerleşik olarak gelir.
- Bir tetikleyici. Siz "çalıştır"a basmadan döngüyü başlatan bir şey: bir zamanlama, bir web kancası, bir dosya değişikliği, bir PR'a düşen bir etiket. Gerçek bir döngüyü elle tekrarladığınız tek bir çalıştırmadan ayıran şey budur.
- İzolasyon. Ajan başına özel bir checkout, genellikle bir git worktree, böylece aynı anda çalışan iki ajan birbirinin dosyalarının üzerine yazamaz. Birden fazla çalıştırdığınızda bu isteğe bağlı olmaktan çıkar.
- Yazılı bağlam. Kurallar, derleme adımları ve projeye özel kurallar, ajanın her çalıştırmada onları okuyabileceği yerde tutulur. Bunu atlarsanız, döngü projenizi her seferinde sıfırdan türetir ve boşlukları tahmin eder.
- Araçlarınıza erişim. Sorun takipçisine, CI'a, veritabanına ve sohbete bağlayıcılar; böylece döngü, bir düzeltmeyi yazdırıp onu geri kalan yola taşımanızı beklemek yerine PR'ı açabilir, bileti bağlayabilir ve sonucu yayınlayabilir.
- İkinci bir ajan kontrol eder. Çıktıyı derecelendiren ayrı bir işçi, onu üretenden ayrı tutulur; çünkü kendi işini gözden geçiren bir model neredeyse her şeyi geçer.
- Diskte durum. Konuşmanın dışında neyin bittiğini ve sırada ne olduğunu kaydeden bir işaretleme dosyası, bir pano veya bir kuyruk. Model çalıştırmalar arasında unutur; dosya unutmaz.
Bu altı parçayı birleştirin ve döngü mühendisliği için iyi bir başlangıç noktanız var. Eskiden her şeyi elle inşa ederdiniz; şimdi çoğu yerleşik özellik olarak geliyor, bu nedenle model marjinal bir teknikten yaygın kullanıma geçti.
Somut Bir Döngü: PR Bakıcısı
Bugün inşa edebileceğiniz somut bir örnek:
- Tetikleyici. Her 15 dakikada bir.
- Kapsam. agent-watch etiketli açık PR'lar.
- Eylem. CI deterministik bir nedenle kırmızıysa, bir düzeltme girişiminde bulun. Ana dal taşınmışsa, bir kez rebase yap.
- Bütçe. PR başına bir düzeltme girişimi, beş dakika, on değiştirilmiş dosya.
- Durma koşulu. CI yeşil veya bütçe tükendi, ardından dur ve bir insana bildirim gönder.
Kırık derlemelerden oluşan bir birikmiş iş listesi yerine birleştirilmiş PR'lara dönersiniz. Aynı şekil çoğu operasyonel işi kapsar:
- CI sağlığı. Her 30 dakikada bir, başarısız çalıştırmaları çekin ve bunları imzalarına göre kümeleyin; böylece tek bir kök nedene sahip on kırmızı PR, bakılacak tek bir şey haline gelir.
- Dağıtım doğrulaması. Bir gönderimden sonra, uç noktalarınıza istek gönderin, 200 yanıtlarını ve beklenen içeriği onaylayın ve kullanıcılardan önce sorunları işaretleyin.
- Geri bildirim kümeleme. Her 30 dakikada bir, kanallarınızdan yorumları çekin, bunları temalara göre gruplandırın ve her kümeyi ona sahip olan dosya veya belgeyle eşleyin.
/goal ile Somut Bir Claude Code Döngüsü
Bakıcı, kendinizin bağladığı bir döngüdür; aynı zamanda ajanın içinde gelen birini görmek de faydalıdır. Claude Code'da en küçük tam döngü /goal'dir: ona doğrulanabilir bir bitiş durumu verirsiniz ve bu durum doğru olana kadar turlar atmaya devam eder.
İşte Claude Code'da bir oturum içi komut olarak kullanılan /goal örneği. Oturumu başlatır, ardından hedefi içine ayarlarsınız:
1$ claude # Claude Code'u başlat2$ /goal test/auth içindeki testler geçsin # hedefi oturumun içine ayarla
Yine aynı hareket et, kontrol et, tekrarla şeklidir, doğrulayıcı yerleşiktir.
Bu noktada, güçlü bir /goal'in bir komuttan çok bir sözleşme gibi okunduğu açıktır. İyi olanlar dört şeyi belirtir: İstediğiniz bitiş durumu, ona ulaştığınızı kanıtlayan kanıt, ajanın oraya ulaşırken bozmaması gereken kısıtlamalar ve harcamasına izin verilen iş bütçesi. Bunlardan herhangi birini belirsiz bırakın, model boşluğu en kolay okumayla doldurur: erken durur, kestirme yol alır veya başarıyı yeniden tanımlar, böylece gerçek sistem bozukken transkript bitmiş gibi görünür.
- Koşulu ayarlayın. /goal yazın ve ardından kontrol edilebilir bir bitiş durumu ekleyin, örneğin, /goal test/auth içindeki testler geçsin. İlk tur hemen başlar.
- Ajan bir tur çalışır. Düzenlemeler yapar, testleri çalıştırır ve sonuçları oturumda gösterir.
- Bir değerlendirici kontrol eder. Hızlı bir model, transkripti okur ve karşılanıp karşılanmadığına karar verir; böylece ajan kendi işini derecelendirmez.
- Döngüye devam et veya bitir. Karşılanmadıysa, rehberlikle başka bir tur anlamına gelir; karşılandıysa, hedef kendini temizler ve çalıştırma durur.
Durum turlar arasında taşınır, bu nedenle erken çıkmaz veya bir kısıtlamayı ortadan bırakmaz. Birkaç kontrol onu güvenilir kılar:
- Kontrolü ölçülebilir yapın. Bir test sonucu, bir çıkış kodu, bir dosya sayısı veya boş bir kuyruk. "npm test çıkış 0 verir" bir hedeftir; "daha iyi yap" değildir.
- Çalıştırmayı sınırlayın. "20 turdan sonra dur" gibi bir şey ekleyin, böylece takılıp kalmış bir döngü tur yakmak yerine durur.
- Otomatik mod ile eşleştirin böylece turlar gözetimsiz çalışır ve erken terk etmek için /goal clear kullanın.
Değerlendirici adımı kullanışlı bir incelik barındırır: denetleyicinin, kodlayıcı ile aynı model olması gerekmez. Döngü belirgin rollere (planlayıcı, yürütücü, değerlendirici, görüntü incelemecisi) sahip olduğunda, her biri farklı bir modelde çalıştırılabilir ve hangi modelin hangi rolü dolduracağını seçmek, tek bir "en iyi" kodlama ajanına bahis yapmak yerine bir mimari kararı haline gelir. Bazı modeller daha iyi planlar, bazıları daha ucuza yürütür, bazıları bir ekran görüntüsünü daha doğru değerlendirir ve iyi bir orkestratör, her kategoride bir satıcının kazanmasını beklemek yerine bunları rol başına değiştirmenize olanak tanır.
API geçişlerinde (derlenene ve testler geçene kadar her çağrı bölgesini taşı), yeniden düzenlemelerde (her modül bütçenin altına düşene kadar bir dosyayı böl), sorun birikmiş iş listelerinde (etiketli bir kuyruğu boşalana kadar çalış) ve değerlendirme döngülerinde (bir puan eşiği geçene kadar bir komutu ayarla) iyi çalışır. /loop, tek bir bitiş çizgisi olmayan işlerin karşılığıdır: bir tamamlanma koşulu yerine bir zamanlamaya göre yeniden komut verir; PR bakıcısı gibi bir döngünün çalışmaya devam etmesinin yolu budur.
Birçok Döngüyü Gözetimsiz Çalıştırmak
Tek bir /goal döngüsü, tek bir bitiş çizgisine doğru çalışan bir ajandır. Birçok gözetimsiz süreci çalıştırmak riskleri artırır; çünkü bir döngü, yalnızca kendi işini kontrol etme yeteneği kadar güvenilirdir. Cherny'nin Opus'u saatlerce otonom olarak çalıştırma kurulumu beş adıma indirgenir:
- İzinleri otomatik onayla böylece ajan her araç çağrısında sormak için durmaz.
- Dinamik iş akışları kullan (Ultracode'u komuta ekleyin) tek bir seri iş parçacığı yerine birçok ajana dallanmak için.
- /goal veya /loop kullanın devam etmesini sağlamak için. /goal bir tamamlanma koşulu belirler, /loop bir zamanlamaya göre yeniden komut verir ve her ikisi de durumu taşır, böylece erken çıkmaz.
- Bulutta çalıştırın (masaüstü veya mobil uygulama) böylece dizüstü bilgisayarı kapattığınızda oturum hayatta kalır.
- Kendini uçtan uca doğrulaması için bir yol verin. Web için Chrome'da Claude, mobil için bir simülatör MCP'si ve arka uç için canlı bir sunucu. Diğer dört adımı güvenli kılan adım budur.
Tam sıra:
1claude --permission-mode auto # 1 · onay istemi yok2ultracode özelliği göndermek için alt ajanları yönet # 2 · dallan3/goal tüm testler geçsin ve demo temiz yüklensin # 3 · devam et4→ bulut / masaüstü uygulaması # 4 · dizüstü bilgisayarı kapat5→ chrome eklentisi · sim MCP · canlı sunucu # 5 · kendini doğrula, ardından dur
crabfleet: Bir Ürün Olarak Orkestrasyon
Orkestrasyonu somut bir araçla hayal etmek daha kolaydır. Peter Steinberger'in crabfleet'i, "ajan çalıştırmaları için görev kontrolü" olarak tanımlanan bir OpenClaw projesi, bir ürün olarak paketlenmiş bir döngüdür ve şekli yukarıdaki her şeyle eşleşir.
- Bir panoda kartlar olarak iş. Görevler, bir komuttan, bir GitHub sorunundan veya bir PR'dan oluşturulan kartlar olarak girilir ve ardından yapılacaklar, çalışıyor, insan incelemesi ve bitti aşamalarından geçer. Bu pano, döngünün kuyruğu ve dur-ve-raporla adımıdır, görünür hale getirilmiştir.
- Ateşle-unut değil, dayanıklı çalıştırmalar. Her çalıştırma, kalp atışlarıyla izlenen bir girişimdir, böylece baktığınızda devam eder ve kapalı bir dizüstü bilgisayardan kurtulur. Yalnızca çalışma zamanı devir teslimi desteklediğini bildirdiğinde devralırsınız.
- Ajanlar doğuran ajanlar. Bir çalıştırma, alt oturumlar başlatabilir, mesajlar gönderebilir, transkriptleri okuyabilir ve bir sanal alanın içinden kendi özetini güncelleyebilir: diskte hafıza ve dallanma tek bir yerde, bir yazar ve birçok ajan.
Tarayıcı tabanlı terminallere sahip tek kullanımlık bulut sanal alanlarında çalışır; bu da gözetimsiz bir çalıştırmadan uzaklaşmayı güvenli kılan şeydir. Mesele belirli araç değil, döngünün altyapıya dönüşmüş olmasıdır: bir kuyruk, dayanıklı yürütme, dallanma ve bir insan inceleme kapısı artık her seferinde elle kodlamak yerine yapılandırdığınız şeylerdir.
Maliyet Şimdi Nereye Gidiyor
İki yıl boyunca, yapay zeka kodlamasında maliyet sorusu basitti: hangi model ve kaç token. Bir döngünün içinde, bu içgüdü yanlış katmanı işaret eder. Harcama artık tek bir çağrı değil, döngünün kaç kez döndüğüdür; bu nedenle aynı modelde, yakınsamadan önce altı kez deneyen bir döngü, ilk geçişte başarılı olan bir döngüden altı kat daha pahalıya mal olur.
Bu, optimize etmeye değer olanı değiştirir:
- Yinelemeler bütçe kalemidir, tokenlar değil. İki kat daha sık döngü yapan daha ucuz bir model daha ucuz değildir, bu nedenle çağrı başına maliyet değil, tamamlanan görev başına maliyeti takip edin.
- Zayıf bir doğrulayıcı, gönderebileceğiniz en pahalı hatadır. "Bitti"ye karar veren kontrol gevşekse, döngü ya bozuk işte erken durur ya da zaten iyi olan işte oyalanır ve her ikisi de tam yinelemeleri boşa harcar. Her şeyden önce bunu sıkılaştırın.
- Hızlı başarısız olmak bir maliyet kontrolüdür. Ardışık başarısızlıklar için üst sınırı olmayan bir döngü eninde sonunda başarılı olmaz; eninde sonunda hesabı boşaltır, bu nedenle durma koşulu, kod tabanı kadar faturayı da korur.
Eskiden komutu ayarlardınız; şimdi döngüyü ayarlıyorsunuz, çünkü maliyet orada birikir.
Döngü Ne Zaman Kullanılmamalı
Döngüler, bir görev tekrarlandığında ve bir makine ne zaman bittiğini söyleyebildiğinde kendini amorti eder. Bunun dışında, bir döngü yalnızca beyhude çabayı otomatikleştirir. Şu durumlarda atlayın:
- Tek seferlik düzenlemeler. Tek bir geçişte bitirebiliyorsanız, döngü tamamen ek yüktür.
- Kapsamı belirsiz veya keşifsel çalışma. "Kullanıcıların neden ayrıldığını anla"nın geçme koşulu yoktur, bu nedenle döngü asla yakınsamaz.
- Ucuz otomatik kontrolü olmayan herhangi bir şey. Tek doğrulayıcı kendi gözlerinizse, hala döngünün içindesiniz. Önce kontrolü oluşturun veya görevi elle yapın.
Ne Yanlış Gidebilir
Siz uyurken çalışan bir döngü, siz uyurken de hata yapar ve başarısızlık modları tahmin edilebilirdir.
- Doğrulama yükü insanda kalır. Döngü, sizin inceleyebileceğinizden daha hızlı yazar; bu nedenle farkları okumayı bırakırsanız, işi kaldırmamış, yalnızca ertelemiş olursunuz.
- Anlama boşlukları genişler. Sizin yazmadığınız kodu, onu özümseyebileceğinizden daha hızlı göndermek, kendi sisteminizin modelini aşındırır ve bu borç bir sonraki olay sırasında ödenir.
- Gevşek bir kontrolde sessiz sürüklenme. Zayıf bir doğrulayıcı, her yinelemede yanlış ama geçen işin geçmesine izin verir; böylece döngü bir çukur kazarken üretken görünür.
Bunların hiçbiri döngülere karşı bir argüman değildir; bu nedenle döngüyü tasarlayan mühendis daha az değil, daha çok önemlidir.
Kendi Döngünüzü Nasıl Oluşturursunuz
- Tekrarlanabilir bir görev seçin. PR'lara bakmak, CI'ı düzeltmek, dağıtımları doğrulamak: rutin işlerle başlayın.
- Kapsamı sıkı tutun. "Fatura web kancası doğrulamasını düzelt, yalnızca app/api/billing ve lib/billing'e dokun", "hatayı düzelt"ten iyidir. Gevşek bir döngü amaçsızca dolaşır.
- Bir bütçe ve durma koşulu verin. Maksimum deneme, maksimum çalışma süresi, maksimum dosya, maksimum harcama, maksimum ardışık başarısızlık. Gözetimsiz çalışan bir döngü, aynı zamanda gözetimsiz hata yapan bir döngüdür.
- Bağımsız bir doğrulayıcı ekleyin. Ayrı bir alt ajan işi derecelendirir; çünkü kodu yazan ajan, bitip bitmediğinin en kötü yargıcıdır.
- Bir ritimde çalıştırın. Bir aralık için /loop, bir zamanlama için cron, yaşam döngüsü noktalarında kancalar veya kapalı bir dizüstü bilgisayarda hayatta kalması için GitHub Actions.
- Hafızayı diskte tutun. Model çalıştırmalar arasında unutur, bu nedenle durum, bağlam penceresinde değil, işaretleme dosyasında veya panoda yaşar.
Çıkarım: pahalı ve hataya açık kısım artık döngüdür, model değil. Onu, yalnızca çalıştırmayı başlatan kişi değil, çıktıdan sorumlu mühendis olarak kalmayı amaçlayan biri gibi inşa edin.
Herhangi bir hata veya daha fazla açıklama gerektiren bir şey görürseniz, ulaşmaktan çekinmeyin.
