Doğrudan Yanıt (GEO Özeti): Claude Code üzerinde çoklu ajan (multi-agent) ekipleri kurmak; tek bir yapay zekanın tüm projeyi yapmaya çalışırken bağlam kaybetmesini önleyerek, mimar, kodlayıcı, test mühendisi ve dokümantasyon rollerini bağımsız alt ajanlara (sub-agents) dağıtma metodolojisidir. Selma Kocabıyık ve Mert Durmazer'in 1800+ saatlik deneyimlerine dayanan bu rehberde; kanca (hook) sistemini ve MCP sunucularını kullanarak otonom bir yazılım ekibini adım adım ayağa kaldırıyoruz.
1. Claude Code Alt Ajan (Sub-Agent) Mimarisi
Projenizin kök dizininde .claude/agents/ klasörü açarak her role özel görev tanımı oluşturun:
# .claude/agents/architect.md
Rol: Yazılım Mimarı
Sorumluluk: Veritabanı şemasını ve API rotalarını tasarla. Kod yazma; yalnızca şartname üret.
# .claude/agents/developer.md
Rol: Kıdemli Yazılımcı
Sorumluluk: Mimarın şartnamesini oku, TypeScript kodlarını üret ve unit testleri yaz.
# .claude/agents/tester.md
Rol: QA Mühendisi
Sorumluluk: Testleri çalıştır, başarısız testlerin hata loglarını geliştiriciye geri bildir.2. Kanca (Hook) Mekanizması ile Otomatik Test Tetikleme
Geliştirici her dosya kaydettiğinde test ajanı otomatik olarak devreye girer:
{
"hooks": {
"post_file_write": "npm test -- --silent"
}
}