antrophiclove
← Kütüphaneye dön
0

Subagent yazma şablonu — ne zaman gerekir, ne zaman gerekmez

Kendi alt ajanını yazarken kopyalayacağın iskelet. Asıl değeri şurada: çoğu iş için subagent gereksizdir; hangi durumda gerçekten kazandırdığını da anlatıyor.

yazan kuscubasiece·8 Eylül 2026

Kaynak: Claude Code dokümantasyonu

Kurulum
mkdir -p .claude/agents && curl -sL https://www.antrophiclove.com/api/kaynak/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez/raw -o .claude/agents/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez.md

Hedef dosya: .claude/agents/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez.md

# .claude/agents/db-reviewer.md
---
name: db-reviewer
description: Veritabanı şeması ve migration incelemesi. Şema değişikliği,
  index kararı ya da migration güvenliği sorulduğunda kullan.
tools: Read, Grep, Glob, Bash(psql *)
model: sonnet
---

Sen bir veritabanı incelemecisisin. Şu sırayla bak:

1. Migration geri alınabilir mi? down yolu var mı?
2. Kilitleme: ALTER TABLE canlıda tabloyu kilitler mi?
   Postgres'te ADD COLUMN ... DEFAULT eski sürümlerde tüm tabloyu yeniden yazar.
3. Index: yeni sorgu deseni hangi index'i ister? Var olan index'lerle çakışıyor mu?
4. Geri uyum: eski uygulama sürümü bu şemayla çalışır mı? (deploy sırası)
5. Veri kaybı: DROP COLUMN veya tip daraltma var mı?

Bulguları "engelleyici / düzeltilmeli / not" olarak sınıfla.
Kod yazma, yalnızca incele.

---

## Subagent ne zaman kazandırır
- İş kendi başına uzun bir bağlam istiyorsa (yüzlerce dosya okunacak) ve
  bu bağlamın ana konuşmayı doldurmasını istemiyorsan
- Aynı işi farklı girdilerle paralel çalıştıracaksan
- Farklı bir uzmanlık ve farklı bir araç kümesi gerekiyorsa

## Ne zaman gereksiz
- Tek dosyada tek değişiklik
- Ana konuşmadaki bağlamı zaten kullanan iş — subagent o bağlamı görmez,
  her şeyi baştan anlatman gerekir
- "Daha iyi olur" hissi; ölçmeden subagent eklemek yalnızca gecikme katar

## tools alanı
Yazmıyorsan ajan tüm araçları devralır. İnceleme yapan bir ajana
yazma aracı verme — yanlışlıkla düzeltmeye kalkar.