cn claudenews Ara /

Lesson 07 · 9 dk okuma

İlk sub-agent kullanımı

Sub-agent'ın izole context'i, dispatch akışı, Explore agent ile codebase taraması.

Öğreneceklerin

  • Sub-agent dispatch akışını kavra
  • Explore agent ile büyük repo nasıl taranır gör
  • Hangi durumda sub-agent, hangi durumda direkt çalışırsın anla

Sub-agent, ana agent’ın izole bir alt-claude oturumu dispatch etmesi. Kendi context’inde çalışır, kendi tool seti vardır, görev bittiğinde sonucu kısa özet olarak ana agent’a verir.

Ana agent büyük resmi tutar; sub-agent dar bir görevi izole context'te yapar ve özetle döner.

Neden sub-agent?

Üç ana sebep:

1. Context kirlenmesin — Bir codebase taraması yaparken Claude 50 dosya okur. Bu 50 dosya ana context’e girerse asıl görev için kalan token azalır. Sub-agent kendi context’inde okur, geriye sadece “şu 3 dosyada şu pattern var” özeti döner.

2. Sınırlı tool seti — Bir review agent’ına Bash veya Write vermeye gerek yok; sadece Read ve Grep yeter. Yan etkiler en aza iner.

3. Paralellik — Birden fazla bağımsız soru varsa N sub-agent paralel dispatch edilir, hepsi aynı anda çalışır.

Built-in: Explore

Claude Code’un default sub-agent’ı Explore. Sen tetikleme demediğin sürece, “büyük taramalar için” otomatik kullanılır.

Manuel tetikleme:

Use the Explore subagent to find every place that calls `parseDate()` and group them by directory.

Claude’un yanıtı:

  • Sub-agent dispatch oluyor (sen tool çağrısı görürsün: Task tool)
  • Sub-agent kendi context’inde grep + read yapıyor
  • Sentez geliyor: “12 yer, 4 dizin: …”

Ne zaman sub-agent kullanma

  • Kısa, tek dosya işi — overhead’a değmez
  • Sıralı, bağımlı adımlar — sub-agent yardımcı olamaz çünkü sıralı bilgi akışı lazım
  • Yazma gerektiren iş — sub-agent yazabilir ama izolasyon yararlı değil

Custom sub-agent

.claude/agents/<name>.md dosyası. Frontmatter + sistem promptu:

---
name: code-reviewer
description: Use when reviewing pull requests for security issues
tools: Read, Grep
model: claude-sonnet-4-6
---

Sen güvenlik odaklı bir code reviewer'sın.
Verilen dosyaları oku ve şu kategorilere göre güvenlik sorunlarını listele:
1. Input validation
2. Authentication / authorization
3. Sensitive data handling
4. Injection (SQL, command, XSS)

Her bulgu için: dosya:satır, kategori, etki.
Sorun yoksa "no issues found" dön.

Artık ana agent’a “use code-reviewer subagent on src/auth/” dediğinde dispatch edilir.

Sıradaki

Mini-proje: kendi /standup slash command’ını yazıp test edeceksin. Bu lesson’da öğrendiğin pattern’leri uygulayacaksın.