Claude Code Subagents and Agent Teams: A Practical Guide

"Subagents" kelimesini gördünüz, "Agent Teams" "orchestration" ve bir şey eksik olup olmadığını merak ediyorsunuz. Kısa cevap: görevlerinizin çoğu için, hayır. Ama büyük işlerde evet ve bu anlayışa değer.

Jargon olmadan onu açmayalım.

Bir subagent aslında nedir

Bir subagent kendi bağlamı, kendi hızlı ve kendi araç izni ile uzman bir asistandır.

Ana ajan iyi tanımlanmış bir alttask'a ulaştığında, onu bir subagent'a deletir. Bu subagent kendi bağlam penceresinde çalışır, işini yapar ve sadece sonucu döndürür. Ana ajan tam tarih anketini bağlamına almaz, sonuç alır.

Bu noktada: ana ajanın bağlamı temiz tut. Bir ajanın 50.000'den fazla dosya aramasında boğulması yerine, arama yapan ve üç yararlı hattı geri rapor eden bir subagent'a sahipsiniz.

Projenizin .claude/agents/ klasöründeki alt sınıflarınızı ilan edersiniz. Her birinin bir adı vardır, ne zaman kullanacağını söyleyen bir açıklama ve bir sistem çabuk.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams, bir sonraki adım

Agent Teams, Claude Code'ya inşa edilen çok disiplinli orkestradır. Yine de deneysel, varsayılan olarak devre dışı bırakılır, ancak sağlam bir giriş noktası.

Fikir: lider bir ajan büyük bir görev ayırıyor, her parçayı uzman bir ajana (kendi modeliyle, hızlı araçlar, araçlar), uzmanlar ortak bir dosya sistemi üzerinde paralel olarak çalışıyor ve sonuçlar ortaya çıkıyor.

Eğer "bir uzmana bırak" subagents gibi geliyorsa, bu normal. Agent Teams, bu fikir gerçekten paralel olarak birkaç ajan çalıştırmanın yolunu itti, sadece bir tane daha sonra değil.

İnşa edilenin ötesinde, Multiclaude ve Gas Town gibi üçüncü taraf orkestralar var. Onlar düşünülmüşler, hangi onları başlangıç noktalarında iyi başlangıç noktaları yapar: kendi alışkanlıklarınızı inşa edene kadar sizin için karar verirler.

İhtiyacınız olduğunda (ve ne zaman değilsiniz)

Açık olalım: multi-agent orkestrasyon, ajan destekli görevlerin% 95'i için anlamsızdır. Günlük çalışmanızın çoğu için tek bir ajan daha hızlı ve daha basit.

Şu anda, multi-agent hala büyük projelere saldırmak için pahalı ve deneysel bir yoldur.

Ne zaman ihtiyacınız var:

• Proje, farklı dosyaları dokunan gerçekten bağımsız parçalara bölünür.
• Tek bir bağlam penceresi tüm şeyi tutamaz.
• Geniş bir refaksiyon veya repo- çapında bir göç paralelleştirmek istiyorsunuz.

Bir hata için ihtiyacınız yok, odaklanmış bir özellik veya tek bir kafaya sığan herhangi bir şey.

Tuzak, bir ajanın beş dakika içinde yapacağı bir şey için on-agent "team" dan geçiyor. Bir paralellik için jetonlarda ve karmaşıklığı ödersiniz, görev asla sorulmuyor.

Gerçek sorun: görünürlük

İşte yeterince konuşmayacak olan şey. Birkaç altant veya bir Agent Ekibi çalıştırdığınız anda, konuyu kaybedersiniz.

Bir lider delegeleri beş uzmana yönlendirir. Hangi biri çalışıyor? Hangi bitti? Hangi bir karar bekliyor? Bir terminalde bir kaydırma metni duvarı görüyorsunuz ve kimin yaptığını söyleyemezsiniz.

Bu, bir görsel pano her şeyi değiştirir. AgentsRoom her ajanı ve her bir subagent'ı kendi çini olarak gösterir, statüsü ortaya çıktı. Delegasyonu izliyorsunuz, cevabınızı kimin beklediğini görüyorsunuz, kimin kaza yaptığını görüyorsunuz. Metin duvarı okunabilir bir harita haline gelir.

Bu görüş olmadan, multi-agent orkestrasyon, güne kadar güvenilmez bir gün olan etkileyici bir demoyu kalır. Bununla birlikte, aslında kullandığınız bir araç haline gelir.

Nerede başlayacak

Sekiz kişilik bir takıma doğrudan atmayın.

Kesin, tekrarlanan görevler için bir veya iki altajcı ile başlayın: Test eden biri, kodu destekleyen biri. Ana ajanınızın bağlamında kazancı hızla hissedeceksiniz.

Bu mechanic doğal hissettiğinde, Agent Teams'yu temizleyen işler için döndürür. Ne yaptığını kimin yaptığına bir göz tutun, infazdan önce planları onaylayın ve şu an gözden geçirin şişenck olur.

Multi-agent, başlamadan önce inşa eden insanları ödüllendirir. En çok ajanları başlatanlar değil.