Yapay zeka ajan orkestrasyonu: 5 kalıp ve araçlar

Kodlamada yapay zeka ajan orkestrasyonu, birden fazla kodlama ajanının birbirinin ayağına basmadan tek bir iş üzerinde çalışmasını sağlamanın yoludur. Her kurulum üç soruya cevap verir: işi kim bölüyor (siz, bir lider ajan ya da bir planlayıcı), ajanlar durumu nasıl paylaşıyor (çağırana dönen sonuçlar, ortak bir görev listesi ya da doğrudan mesajlar) ve değişiklikler nasıl bir araya geliyor (tek bağlamda, bir git merge ile ya da bir incelemeyle). Bu üçünü seçtiğinizde kalıbınızı da seçmiş olursunuz; araç ikinci sırada gelir.

Bu yazıda kodlama ajanları için önemli olan beş orkestrasyon kalıbını, her birinde neyin ters gittiğini ve Ekim 2026 itibarıyla bunları hangi araçların uyguladığını anlatıyoruz: Claude Code alt ajanları ve ajan ekipleri, Codex cloud, Conductor, Claude Squad, Vibe Kanban ve AgentVera. Bu blogu AgentVera yayımlıyor, bu yüzden diğer araçların nerede daha uygun olduğunu da söylüyoruz. Üçüncü taraf bilgileri her aracın kendi dokümanından ya da deposundan kontrol edildi.

Araç karşılaştırması arıyorsanız paralel yapay zeka kodlama ajanı araçları yazısına bakın. Bu yazı onların altındaki mimariyle ilgili.

Her kurulumun arkasındaki üç karar

Kalıplara geçmeden önce hareketli parçaları adlandırmak işe yarar:

• Bölme: “Faturalandırma ekle” işini görevlere kim çeviriyor. Elle bölen bir insan yavaş ama öngörülebilirdir; planlayan bir ajan hızlıdır ama işi yanlış yerden bölebilir.
• Ortak durum: B ajanı A’nın ne yaptığını nereden öğreniyor. En sıkıdan en gevşeğe seçenekler şunlar: çağırana dönen sonuç, bağımlılıkları olan ortak bir görev listesi ve ajanlar arası serbest mesajlar.
• Birleştirme: Kod nasıl yerine oturuyor. Salt okuyan işler yalnızca metin döndürür. Yazan ajanlar ya tek klasörü paylaşır (riskli) ya da dalları sonradan birleştirilen ayrı git worktree’lerinde çalışır.

Orkestrasyon hatalarının çoğu bunlardan birinin örtük bırakılmasından çıkar; örneğin router dosyasının sahibi olduğunu düşünen iki ajan.

Beş orkestrasyon kalıbı

1. Orkestratör ve işçiler

Bir ajan konuşmayı elinde tutar ve odaklı işleri işçilere gönderir. Her işçi temiz bir bağlamla başlar, tek bir iş yapar ve bir özet döndürür. Çağıran ajan işçinin tüm dökümünü görmez, yalnızca sonucunu görür.

• İyi olduğu yer: Araştırma, kod arama, inceleme, test analizi. İşçinin çok okuyup az raporladığı her iş.
• Zayıf olduğu yer: Paralel yazma. İşçiler genelde çağıranla aynı çalışma kopyasında düzenleme yapar.
• Örnek: Claude Code alt ajanları.

2. Lider ve ortak görev listeli ekip

Lider ajan bağımlılıkları olan görevler oluşturur; ekip üyeleri görevleri üstlenir, bitirir ve birbirine doğrudan mesaj atar. Durum tek bir ajanın kafasında değil görev listesinde durur; bu sayede bir üye bir dakika önce önü açılan görevi alabilir.

• İyi olduğu yer: İlerledikçe değişen işler; test eden ajanın bir hatayı sizin aktarmanıza gerek kalmadan geliştiriciye geri gönderdiği durumlar.
• Zayıf olduğu yer: Maliyet ve dosya güvenliği. Aynı klasörü paylaşan üyeler birbirinin üzerine yazabilir.
• Örnek: Claude Code ajan ekipleri; AgentVera’nın ajanlar arası mesajlaşması ve görev listesi.

3. Worktree’lerde dağıt, sonra birleştir

Bir planlayıcı tek bir değişikliği bağımsız parçalara böler. Her parça kendi worktree’sinde ve dalında çalışır; biten dallar birer birer bir entegrasyon dalına birleştirilir ve sonda testler çalışır.

• İyi olduğu yer: Ayrılabilir parçaları olan büyük değişiklikler: API, arayüz, migration.
• Zayıf olduğu yer: Gizlice birbirine bağlı parçalar. Çakışma düzenleme anında değil merge anında ortaya çıkar.
• Örnek: Conductor, Claude Squad ve Vibe Kanban size worktree’leri verir; AgentVera’nın paralel ekibi buna planlayıcıyı ve birleştirmeyi ekler. Arka plan için git worktree ile paralel geliştirme.

4. Zincirleme devir

Planlayıcı uygulayıcıya, uygulayıcı inceleyiciye devreder. Her adım bir önceki adımın çıktısını alır, başka bir şey almaz. Çoğu kişinin ilk denediği planlayıcı-uygulayıcı-inceleyici kurulumu budur.

• İyi olduğu yer: Kod yazılmadan önce planı okumak istediğiniz, tekrar eden işler.
• Zayıf olduğu yer: Hız. Hiçbir şey paralel çalışmaz ve tek bir belirsiz devir sonraki tüm adımları bozar.
• Örnek: Yapay zeka ajan iş akışı ve yapay zeka ajan ekibi yazılarında ayrıntılı anlatılıyor.

5. Best-of-N

Aynı görev birkaç denemeye gider; en iyisini siz ya da inceleyen bir ajan seçer. Hiç koordinasyon yoktur, mesele de tam olarak budur.

• İyi olduğu yer: İlk cevabın çoğu zaman en iyisi olmadığı zor hatalar ve belirsiz arayüz işleri.
• Zayıf olduğu yer: Maliyet, kabaca N kat token, bir de inceleme süresi.
• Örnek: codex cloud exec --attempts ya da ayrı worktree’lerde aynı istemle çalışan iki farklı CLI.

Kalıplar yan yana

Neler ters gider, her birinin çaresi

Çakışmalar

Tek klasördeki iki ajan er geç aynı dosyayı düzenler. Çareler üst üste konur: yazan her ajana bir worktree, işi özelliğe göre değil klasöre göre bölmek, açık dosya sahipliği ve ikinci birleştirmenin birinciyi görmesi için dalları birer birer en güncel uca birleştirmek. Birleştirme kuyruğu bu son adımın düzgün yapılmış hâlidir.

Maliyet

Her ajan ihtiyaç duyduğu kodu yeniden okur ve ajanlar arasındaki her mesaj ek token demektir. Anthropic’in dokümanları ajan ekiplerinin tek oturumdan belirgin biçimde fazla token harcadığını söylüyor ve 3 ile 5 üyeyle başlamayı öneriyor. Ajan sayısını düşük tutun, dokümanın izin verdiği yerde işçilere daha ucuz bir model verin ve bir döngünün günlük bütçeyi yakmaması için ajan başına bir sınır koyun.

Sapma ve döngüler

Bir ajan plandan sapabilir, aynı başarısız komutu yirmi dakika boyunca tekrar deneyebilir ya da iki ajan birbirine aynı soruyu sorup durabilir. Görev başına net kabul ölçütleri, açık bir “bitti” ya da “takıldım” sinyali, mesaj hız sınırları ve tekrarlanan komutları fark eden bir gözetmen bunların çoğunu yakalar.

Ajanlar arası güven

Ajanlar birbirine mesaj atabiliyorsa, başka bir ajandan gelen mesaj sizden gelen mesaj değildir. Onu izin değil girdi olarak ele alın: bir ajan, başka bir ajan istedi diye bir dalı silmemeli ya da main’e push etmemeli.

Araçlar ve karşılık geldikleri kalıplar

Claude Code alt ajanları (orkestratör ve işçiler)

Alt ajanlar, .claude/agents/ (proje) ya da ~/.claude/agents/ (kullanıcı) içinde YAML frontmatter’lı Markdown dosyalarıdır. Her biri kendi bağlam penceresinde çalışır ve sonucunu çağırana döndürür; kullanımı aynı limitlerden düşer. Bir alt ajanı tools ya da disallowedTools ile kısıtlayabilir, model ile modelini seçebilirsiniz. Ekim 2026 itibarıyla alt ajanlar varsayılan olarak üç seviyeye kadar kendi alt ajanlarını açabiliyor; bunu CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH belirliyor (iç içe açmayı kapatmak için 1 yapın).

---
name: test-triager
description: Başarısız testleri çalıştırır ve kök nedeni raporlar. Kırmızı bir CI koşusundan sonra kullan.
tools: Read, Grep, Glob, Bash
model: sonnet
---
Başarısız testleri çalıştır, ilk gerçek hatayı bul ve dosya, satır ve nedeni 15 satırı geçmeden raporla. Dosya düzenleme.

Claude Code ajan ekipleri (lider ve görev listesi)

Ajan ekipleri Ekim 2026 itibarıyla deneysel ve varsayılan olarak kapalı. Bir oturum lider olur; her ekip üyesi kendi bağlamı olan ayrı bir Claude Code örneğidir. Üyeler bekleyen, devam eden ve tamamlanan durumları ile bağımlılıkları olan ortak bir görev listesini paylaşır, görevleri kendileri üstlenir ve birbirine doğrudan mesaj atar. settings.json içinde açılır:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Üyeler varsayılan olarak süreç içinde, isterseniz tmux ya da iTerm2 ile bölünmüş panellerde görünür. Dokümanlar gerçek sınırları sıralıyor: süreç içi üyelerde oturum devam ettirme yok, görev durumu gecikebilir, oturum başına tek ekip var, iç içe ekip yok ve lider sabit. Aynı dosyayı düzenleyen iki üyenin birbirinin üzerine yazacağı uyarısı da var; işi dosyaya göre bölün. TeammateIdle, TaskCreated ve TaskCompleted hook’ları kural koymanızı sağlar; çıkış kodu 2 eylemi engeller.

Codex cloud (dağıtım ve best-of-N, uzakta)

Codex cloud görevleri sizin kurduğunuz bir bulut ortamında, her birini kendi çalışma alanında çalıştırır ve dizüstü bilgisayarınız uykudayken de devam eder. Diff’i incelersiniz, ek istekte bulunursunuz, sonra PR açar ya da yerelde uygularsınız. codex cloud komutu Ekim 2026 itibarıyla deneysel olarak işaretli:

codex cloud exec --env ENV_ID --attempts 3 "billing/ içindeki kararsız tarih testini düzelt"
codex cloud list --env ENV_ID
codex apply TASK_ID   # diff'i yerelde uygular; git apply başarısız olursa sıfır olmayan kodla çıkar

--attempts 1 ile 4 arası değer alır ve elde edebileceğiniz en basit best-of-N’dir. İşin sizin makinenizden çıkmasını istiyorsanız Codex cloud daha iyi seçimdir; yalnızca Codex çalıştırır.

Conductor (dağıtım, Mac)

Conductor; Claude Code, Codex, Cursor ve OpenCode’u paralel çalıştırır. Her görev kendi dalı, terminali ve diff’i olan ayrı bir çalışma alanında yürür; ardından inceleme, PR, merge ve arşiv gelir. Yalnızca Mac’te çalışır. Ekim 2026 itibarıyla planlar: Free, aylık 50 dolarlık Pro ve kullanıcı başına aylık 60 dolarlık Teams. Bütün ekibiniz macOS kullanıyorsa ve cilalı bir dağıtım arayüzü istiyorsanız güçlü bir seçenek.

Claude Squad (dağıtım, terminal)

Claude Squad; Claude Code, Codex, Gemini, Aider, OpenCode ya da Amp’i tmux içinde ayrı worktree’lerde çalıştıran bir terminal arayüzü. AGPL-3.0 lisanslı, tmux ve GitHub CLI istiyor; Windows’ta WSL içinde çalışıyor.

brew install claude-squad
cs              # varsayılan olarak Claude Code
cs -p "codex"   # başka bir ajan

n oturum başlatır, Enter bağlanır, Ctrl-q ayrılır, s commit edip push eder. Terminalde yaşıyorsanız en hafif seçenek bu.

Vibe Kanban (dağıtım, pano)

Vibe Kanban görevleri kartlara dönüştürür; her kart kendi dalı, terminali ve geliştirme sunucusu olan bir çalışma alanı alır. Diff yorumları ajana geri gider ve ajan PR açabilir. Claude Code, Codex, Gemini CLI, Copilot, Amp, Cursor, OpenCode, Droid, CCR ve Qwen Code’u destekliyor. README artık projenin kapandığını söylüyor; Ekim 2026 itibarıyla onu topluluk tarafından sürdürülen bir proje olarak düşünün (Apache-2.0, npx vibe-kanban).

AgentVera (beşi birden, yerelde)

AgentVera, birçok kodlama CLI’ını yan yana çalıştıran macOS, Windows ve Linux masaüstü uygulaması; bu yüzden tek bir kalıp yerine hepsine ev sahipliği yapabiliyor:

• Orkestratör ve işçiler: Ajan açan ajanlar (varsayılan olarak açık) özelliğiyle bir ajan spawn_agent, wait_agent, agent_status, message_agent ve stop_agent araçlarıyla yardımcı açar. Yardımcı yüklü herhangi bir CLI olabilir, oto/… dalında kendi worktree’sinde çalışabilir ve ebeveyninin altında görünür. Varsayılan olarak her ajan 3 yardımcı açabilir ve toplamda 6 yardımcı çalışabilir; yardımcılar kendi ajanlarını açamaz.
• Lider ve görev listesi: Ajanlar arası mesajlaşma her ajana send_message, reply_message, wait_reply ve ortak bir görev listesi verir (atanan kişi ve bağımlılıklarla task_add, task_claim, task_done, task_release). Bir görevin bağımlılıkları bitince görev hazır olur ve atanana haber verilir. CLI’lar arasında çalışır; Claude Code bir görevi Codex’e devredebilir.
• Dağıt ve birleştir: Paralel ekip (Pro ve Team planları) bir işi her birinin kabul ölçütleri ve beklenen dosyaları olan en fazla 8 parçaya böler, parçaları kendi worktree’lerinde varsayılan olarak 3’er, en fazla 6’şar çalıştırır ve bir entegrasyon dalına birleştirir. Kontrol projenin test komutudur; çakışmaları ve hataları bir entegrasyon ajanı düzeltir, iki düzeltme turundan sonra kontrol hâlâ kırmızıysa ekip durur.
• Hata türlerine karşı korumalar: Dosya sahipliği, sahibinin yolları dışındaki Claude Code düzenlemelerini bir hook ile reddeder; birleştirme kuyruğu dalları birer birer en güncel uca birleştirir; token bütçeleri (varsayılan olarak kapalı) bir ajanı tur ve gün başına sınırlar; gözetmen de aynı komutu 15 dakikada 5 kez tekrarlayan, aynı hatayı üst üste 3 turda alan ya da 20 dakika dosya değiştirmeyen ajanı işaretler.

Bu özellikler yalnızca yerelde çalışır: ajanların açtığı yardımcılar ve mesajlaşma SSH ajanlarını kapsamaz. Dizüstünüz kapalıyken görevlerin bulutta sürmesini istiyorsanız Codex cloud daha uygun.

Kalıp nasıl seçilir

1. İş okuma ağırlıklı mı? Orkestratör ve işçiler kullanın. Alt ajanlar yeterli.
2. Birden fazla ajan aynı anda kod mu yazacak? Worktree’lerde dağıtıp bir birleştirme adımı ekleyin. Klasör paylaştırmayın.
3. Görevler öğrendikçe değişiyor mu? Ortak görev listeli bir lider kullanın ve ekibi 3 ile 5 ajanda tutun.
4. Aynı işi her hafta mı çalıştırıyorsunuz? Kod adımından önce onay olan bir devir zinciri kurun.
5. Problem zor ve cevap belirsiz mi? Best-of-N kullanın ve bedelini bilerek ödeyin.

Sonra aracı platforma göre seçin: Conductor yalnızca Mac’te, terminal istiyorsanız Claude Squad, iş uzakta çalışacaksa Codex cloud, her işletim sisteminde tek masaüstü uygulamada birden fazla CLI ve kalıp istiyorsanız AgentVera.

Bugün deneyebileceğiniz küçük bir orkestrasyon

İşe yarayan en küçük dağıtım için git ve iki CLI’dan başka bir şey gerekmez:

git worktree add ../app-api -b feat/api
git worktree add ../app-ui -b feat/ui
(cd ../app-api && claude "/invoices endpoint'ini ekle. Yalnızca src/api/ içine dokun.")
(cd ../app-ui && codex "/invoices sözleşmesine göre fatura sayfasını yap. Yalnızca src/ui/ içine dokun.")
git checkout -b integrate/invoices
git merge feat/api && npm test
git merge feat/ui && npm test

Bunu çalıştıran kurallar istemlerin içinde: her ajana bir klasör, aralarında üzerinde anlaşılmış bir sözleşme ve her merge’den sonra bir test koşusu. Bir aracın üstüne eklediği her şey (planlama, görev listeleri, gözetmen, kuyruk) bu satırlardan birini otomatikleştirir. Claude Code ile Codex’i yan yana çalıştırmanın ayrıntıları paralel kodlama ajanları yazısında.

Son söz

Kodlamada yapay zeka ajan orkestrasyonu araçtan çok üç seçimle ilgili: işi kim bölüyor, ortak durum nerede duruyor ve kod nasıl yerleşiyor. Orkestratör ve işçiler okumaya, görev listesi değişen işlere, dağıt ve birleştir büyük ve ayrılabilir değişikliklere, devir zincirleri tekrar eden işlere, best-of-N de zor problemlere uyar. Hangisini seçerseniz seçin, çakışma, maliyet ve sapmaya karşı korumaları ilk günden koyun.

Birkaç kalıbı tek yerde denemek isterseniz AgentVera’yı indirin ve paralel ekibi açmadan önce iki ajan ve ortak bir görev listesiyle başlayın.