Özellik detayı · 5 / 8

9 Türkçe Subagent

Her biri izole context'te çalışan uzman ekip.

Kanka 9 uzman agent ile birlikte gelir — her biri kendi sistem prompt'una, izole context'ine, uzmanlık alanına sahip. Türkçe rapor verir, paralel veya sequential çalışabilir.

TL;DR

▸9 agent: kasif, planlayici, isci, gozden-geciren, mimar, hata-avcisi, test-yazari, refactorcu, docs-yazari
▸Her biri izole context — ana sohbet şişmiyor
▸Sequential chain veya paralel async (3x wall-clock)
▸delege tool veya /yap, /plan-yap chain workflow'lar
▸Kendi agent'ını ~/.kanka/agents/<isim>.md ile ekleyebilirsin

9 ajan

Agent	Görevi	Tipik kullanım
🔍 kasif	Hızlı kod keşif, sıkıştırılmış context	Yeni codebase'e bakarken
📋 planlayici	Uygulama planı çıkar (hiç değişiklik yapmaz)	'Önce ne yapayım?'
⚙️ isci	Genel amaçlı uygulamacı, tam yetki	Hemen kodu yaz
🔎 gozden-geciren	Code review, kalite/güvenlik	PR review öncesi
🏛️ mimar	Sistem mimarisi, trade-off analizi	'Microservice mi monolith mi?'
🐛 hata-avcisi	Bug analizi, root cause, stack trace	'Bu neden patlıyor?'
🧪 test-yazari	Test senaryoları + test kodu	Coverage artırma
♻️ refactorcu	Davranış koruyarak refactor	Code smell temizleme
📖 docs-yazari	README, JSDoc, API docs, Mermaid	Dokümantasyon eksikse

İzole context — neden önemli?

Subagent çağırdığında, o agent KENDİ context'inde çalışır. Ana sohbet şişmez:

Context flow· text

Ana agent (40K token context)
  └─> delege({ agent: "kasif", task: "frontend keşif" })
        └─> kasif KENDİ context'inde (200K+ kullanabilir)
              ↓ derinlemesine inceler
              ↓ tool call'lar
              ↓ analiz yapar
              ↓
              └─> Ana agent'a SADECE 500 TOKEN ÖZET döner

Sonuç: kasif istediği kadar derin gitsin, ana sohbet 40K kalır.

✓

Tasarruf

İzole context olmasa: kasif'in 200K token'i ana sohbete eklenir. Sonraki turn'de hepsi tekrar gönderilir → 200K cost her turn. İzolasyon ile 500 token cost (sadece özet).

Sequential chain

Tek komutla birden fazla agent sırayla — her biri öncekinin çıktısını alır:

/yap chain

>/yap kullanıcı kayıt formu ekle, validation + test

↞ Chain başlatıldı: kasif → planlayici → isci

→🔍 kasif — frontend dosyaları taranıyor...

✓kasif: 4 component analiz edildi (auth, forms, validation)

→📋 planlayici — implementation planı çıkarılıyor...

✓planlayici: 3 adımlı plan hazır

1. RegisterForm component

2. validation schema (zod)

3. test cases (happy + error)

→⚙️ isci — uygulanıyor...

✓isci: 5 dosya oluşturuldu, 2 dosya düzenlendi

Chain tamamlandı — toplam 8K token, 12 saniye.

Hazır chain workflow'lar

/yap <görev>kasif → planlayici → isci

/plan-yap <görev>kasif → planlayici (sadece plan, kod yazmaz)

/yap-ve-incele <görev>isci → gozden-geciren → isci (review feedback'i uygular)

/hata-ayikla <bug>kasif → hata-avcisi (root cause)

/refactor-incele <hedef>kasif → refactorcu → gozden-geciren

Paralel async

3 agent aynı anda farklı görevlerde çalışsın — wall-clock 3x hız, toplam token aynı:

Programatik paralel· ts

// SDK üzerinden
await delege({
  tasks: [
    { agent: "kasif",          task: "frontend keşif" },
    { agent: "test-yazari",    task: "backend test'leri yaz" },
    { agent: "gozden-geciren", task: "PR review" },
  ],
  concurrency: 3,
});

// Sonuç: 3 görev paralel
//   kasif         done in 8s
//   test-yazari   done in 12s
//   gozden-geciren done in 10s
//   Wall-clock: 12s (uzun olan kadar)
//   Sequential olsaydı: 30s

Worktree ile dosya izolasyonu

3 agent paralel çalışıyorken aynı dosyaya yazmak isterse conflict olur. Git worktree ile her agent kendi izole dosya sisteminde çalışır:

await delege({
  tasks: [
    { agent: "isci", task: "auth refactor" },
    { agent: "isci", task: "logging upgrade" },
    { agent: "isci", task: "test coverage" },
  ],
  worktree: true,  // Her agent ayrı git worktree'de
});

// Her görev kendi dalında, conflict yok.
// Sonunda merge stratejisi sen seç.

Kendi agent'ını ekle

~/.kanka/agents/devops.md· markdown

---
name: devops
description: CI/CD, Docker, Kubernetes uzmanı. Pipeline yazar, infra debug eder.
tools: bash, read, write, edit
---

# devops agent

Sen DevOps konusunda uzman bir agent'sın. Görevin:
- CI/CD pipeline yazımı (GitHub Actions, GitLab CI, CircleCI)
- Dockerfile + docker-compose optimizasyonu
- Kubernetes manifests, Helm charts
- Infrastructure as Code (Terraform, Pulumi)

## Çalışma tarzın
- Production-grade önerirsin (security, secrets, env separation)
- Minimal Docker image (alpine, scratch tercih)
- Health check + readiness probe ekle
- Cost-aware (k8s resource limits)

💡

Restart sonrası /ekip ile yeni agent'ın listede gözükür. delege({ agent: 'devops', task: '...' }) veya doğal dilde 'devops çağır' diyebilirsin.

Sıkça Sorulanlar

Subagent ana agent'ın hangi context'ini alır?

Hiç. Her subagent boş context'le başlar. Sadece sen verdiğin 'task' string'i ile. Bu sayede izolasyon ve token tasarrufu sağlanır.

Subagent kendisi de subagent çağırabilir mi?

Evet, sınır yok. Ama dikkat — recursive subagent'lar exponential maliyet yaratabilir. Maks 2-3 derinlik öner.

Paralel async sırasında hangi agent hata verirse?

Diğerleri devam eder. Promise.allSettled() pattern'i — her tasks[i] için ayrı success/error döner.