Ajan takımı kurmak

Hedef şu: bir ajan spec'i yazar, ikincisi kodu yazar, üçüncüsü test eder. Test kırılırsa iş kod yazan ajana geri döner. En sonda bir lead (yönetici ajan) ne yapıldığını size özetler. Önce hangi işin takım gerektirdiğine bakalım.

Önce desen, sonra araç

Anthropic'in ajan rehberi iki şeyi ayırıyor. Workflow, adımları önceden belli olan, kodla ya da prompt'la sabitlenmiş bir akıştır. Ajan ise adımlarına kendisi karar verir.¹ Ajan takımı da bilinen birkaç desenin birleşimidir:¹

Rehberin ana tavsiyesi: işe yarayan en basit çözümü bulun, karmaşıklığı ancak sonucu ölçülebilir şekilde iyileştiriyorsa ekleyin.¹ Tek ajanın plan modu ve bir test komutu çoğu işe yeter.

Rolleri yazmak

Her rol bir subagent dosyasıdır (bkz. Agentic kodlama). Claude Code'da .claude/agents/ altına yazılır. Rolü asıl belirleyen tools alanıdır: neye dokunabileceği.²

---
name: frontend-dev
description: Implements UI tasks from SPEC.md. Use after the spec is approved or when tests fail.
tools: Read, Edit, Write, Bash
---

Sen bir React ve Tailwind geliştiricisisin. SPEC.md'deki göreve göre kodu yaz.
Mevcut bileşenleri kullan, yeni paket ekleme. Test dosyalarına dokunma.
Bitince değiştirdiğin dosyaları ve çalıştırdığın komutları listele.

---
name: qa-tester
description: Writes and runs tests against SPEC.md acceptance criteria. Use after frontend-dev finishes.
tools: Read, Write, Bash
---

SPEC.md'deki her kabul kriteri için Vitest veya Playwright testi yaz ve çalıştır.
Uygulama koduna dokunma. Sonucu test-report.md'ye yaz:
geçen ve kırılan testler, kırılanların hata çıktısı.

Diğer iki rol aynı kalıpla yazılır:

Rollerin birbirine dosya üzerinden iş vermesi önemlidir. Ajanlar konuşmaları değil SPEC.md ve test-report.md'yi paylaşır, böylece her biri temiz bir bağlamla başlar.

Lead: hattı kurmak

Lead ayrı bir dosya değildir, ana oturumunuzdur. Subagent'lar sonucu ona döner, o da bir sonrakine aktarır.² Anthropic'in kendi çoklu ajan sistemindeki ders: lead her işçiye amacı, çıktı biçimini, kullanacağı araçları ve sınırları açıkça vermeli. Belirsiz talimat, aynı işin iki kez yapılmasına ya da boşluk kalmasına yol açıyor.³

Sepete kupon kodu özelliğini şu hatla yap:

1. spec-writer: kullanıcıyla netleştirip SPEC.md yaz. Onayımı bekle.
2. frontend-dev: SPEC.md'deki görevleri uygula.
3. qa-tester: kabul kriterlerini test et, test-report.md yaz.
4. Kırılan test varsa raporu frontend-dev'e ver ve 2. adıma dön.
   En fazla 3 tur. 3 turda geçmezse dur ve bana sor.
5. reviewer: diff'i SPEC.md'ye göre incele. Yalnızca doğruluğu ve
   kriterleri etkileyen bulguları raporla.
6. Bana özet ver: değişen dosyalar, test sonucu, tur sayısı, açık kalanlar.

Tur sınırı döngünün sonsuza gitmesini önler. İnceleyiciye "yalnızca doğruluğu etkileyenleri raporla" demek de gereksiz düzeltme turlarını keser.⁴ Testlerin gerçekten geçtiğini ajanın sözüne bırakmak istemiyorsanız Hooks ve izin modları dersindeki Stop hook'unu ekleyin.

Agent teams

Subagent'lar yalnızca lead'e rapor verir. Claude Code'un agent teams özelliğinde ise her üye ayrı bir oturumdur, ortak bir görev listesinden iş alır ve birbirine doğrudan mesaj atar.⁵

Özellik deneyseldir ve varsayılan olarak kapalıdır. Ayarlarda CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS değişkenini 1 yaparak açılır.⁵ Doküman en güçlü kullanımları şöyle sıralıyor: araştırma ve inceleme, birbirinden bağımsız modüller, rakip hipotezlerle hata ayıklama (üyeler birbirinin teorisini çürütmeye çalışır).⁵ Başlangıç için 3-5 üye öneriliyor. İki üyenin aynı dosyayı düzenlemesi üzerine yazmaya yol açar, bu yüzden işi dosya sahipliğine göre bölün.⁵

PR #42'yi incelemek için üç üyeli bir takım kur:
biri güvenliğe, biri performansa, biri test kapsamına baksın.
Bulgularını birbirine sorgulatıp bana tek liste ver.

Ne zaman gerekmez?

Anthropic'in ölçümünde ajanlar sohbetin yaklaşık 4 katı, çoklu ajan sistemleri yaklaşık 15 katı token harcıyor.³ Aynı yazı, ajanlar arasında çok bağımlılık olan ve az paralelleşen işlerin çoklu ajana uygun olmadığını, çoğu kodlama işinin de bu gruba girdiğini söylüyor.³

Cursor'da da aynı hat kurulabilir. Subagent'lar .cursor/agents/ altına yazılır ve Cursor .claude/agents/ klasörünü de okur.⁶

Kendin dene

• frontend-dev ve qa-tester dosyalarını yazın, lead prompt'unu küçük bir özellikle çalıştırın. Kaç turda testler geçti?

• qa-tester'ın tools listesinden Write'ı çıkarın. Rapor dosyası yazamayınca ne oluyor?

• Bir kabul kriterini kasıtlı olarak test edilemez yazın. qa-tester bunu nasıl raporluyor?

• Agent teams'i açıp aynı PR'ı üç üyeye inceletin, sonra tek bir subagent'a inceletin. Bulgular ne kadar farklı?

Detaylı öğrenmek için

• Yazı: Anthropic, "Building effective agents"; zincir, yönlendirme, paralel, orkestratör-işçi ve değerlendirici desenleri.¹

• Yazı: Anthropic, "How we built our multi-agent research system"; lead'in görev dağıtması, token maliyeti ve çoklu ajanın sınırları.³

• Resmi doküman: Claude Code "Agent teams"; üyeleri yönetme, görev listesi, kalite hook'ları ve sınırlamalar.⁵