Özellik detayı · 6 / 8

Chain + Paralel Async

Pipeline kur, görevleri paralel çalıştır.

Tek komutla agent zinciri (sequential) veya N agent paralel (async). Wall-clock kazancı 3x'e kadar çıkar. Worktree ile dosya izolasyonu opsiyonel.

TL;DR

▸Sequential chain: A → B → C (her biri öncekinin output'unu alır)
▸Paralel async: A | B | C (aynı anda, 3x hız)
▸Worktree: paralel async + git worktree = filesystem izolasyonu
▸5 hazır workflow: /yap, /plan-yap, /yap-ve-incele, /hata-ayikla, /refactor-incele
▸SDK ile programatik delege call

Sequential vs Paralel

Sequential Chain

›A → B → C — sırayla
›B, A'nın output'unu alır
›C, B'nin output'unu alır
›Wall-clock = toplam süre
›Bağımlılık varsa kullan
›Örnek: kasif → planlayici → isci

Paralel Async

›A | B | C — aynı anda
›Hepsi bağımsız task
›Sonuçlar Promise.allSettled
›Wall-clock = en uzun task
›Bağımsız iş varsa kullan
›Örnek: frontend + backend + tests

Hazır chain'ler

Komut	Pipeline	Ne zaman?
/yap <görev>	kasif → planlayici → isci	Standart feature implementation
/plan-yap <görev>	kasif → planlayici	Sadece plan, kod yazma
/yap-ve-incele <görev>	isci → gozden-geciren → isci	Quality-first: review feedback uygulanır
/hata-ayikla <bug>	kasif → hata-avcisi	Root cause analizi
/refactor-incele <hedef>	kasif → refactorcu → gozden-geciren	Safe refactor + review

Paralel async — SDK örneği

3 agent paralel· ts

import { delege } from "@thorrangonak/kanka/sdk";

const results = await delege({
  tasks: [
    {
      agent: "kasif",
      task: "src/auth/* dosyalarını incele",
      model: "google/gemini-2.5-flash", // Ucuz + hızlı
    },
    {
      agent: "test-yazari",
      task: "src/payments/checkout.ts için test yaz",
      model: "anthropic/claude-sonnet-4-6",
    },
    {
      agent: "gozden-geciren",
      task: "Son 3 commit'i incele",
      model: "anthropic/claude-opus-4-7", // Kalite önemli
    },
  ],
  concurrency: 3,
});

// results.kasif         — frontend audit raporu
// results.test_yazari   — yeni test dosyaları
// results.gozden_geciren — review yorumları

💡

Task'a göre model

Her görev için farklı LLM kullan: ucuz keşif Gemini, derin reasoning Opus. Hibrit kullanım %50+ ek tasarruf sağlar.

Worktree ile filesystem izolasyonu

3 agent aynı anda dosya yazıyorsa conflict olur. Worktree ile her agent kendi git branch'inde, kendi dosya sisteminde çalışır:

await delege({
  tasks: [
    { agent: "isci", task: "auth refactor",     branch: "refactor/auth" },
    { agent: "isci", task: "logging upgrade",   branch: "refactor/log" },
    { agent: "isci", task: "test coverage",     branch: "refactor/test" },
  ],
  worktree: true,  // Her task kendi worktree'de
  base: "main",    // Kaynak branch
});

// Sonuç: 3 ayrı branch, conflict yok
// Sen merge stratejisini seç (sequential merge / PR / squash)

Custom chain yazımı

Kendi workflow'unu markdown ile tanımla — /komut olarak çalışır:

~/.kanka/prompts/api-yap.md· markdown

---
chain: [kasif, mimar, planlayici, isci, test-yazari, docs-yazari]
description: REST API endpoint'i sıfırdan yaz, test ve doc dahil
---

# /api-yap <endpoint>

Yeni REST API endpoint'i için tam pipeline:

1. **kasif** — mevcut API yapısını anla
2. **mimar** — endpoint için en uygun pattern (REST / RPC / GraphQL)
3. **planlayici** — adım adım plan
4. **isci** — endpoint + handler + middleware
5. **test-yazari** — integration test'ler
6. **docs-yazari** — OpenAPI/Swagger güncellemesi

User input: {{args}}

>/api-yap POST /api/orders

↞ Chain başlatıldı: 6 agent, sequential

...

✓6 agent tamamlandı — 18K token, 45 saniye

Benchmark

Sequential chain

Paralel async (3 agent)

Paralel + worktree (5 agent)

Conflict (worktree ile)

Sıkça Sorulanlar

Hangisi daha verimli — chain mi paralel mi?

Bağımlılık varsa chain. Görevler bağımsızsa paralel. Karışık durumlarda hibrit: önce paralel keşif, sonra sequential implementation.

Paralel'de kaç agent maksimum?

concurrency parametresi belirler (varsayılan 3, max 10 öneri). Çok yüksek olunca rate limit'e takılır.

Worktree olmadan paralel filesystem conflict olur mu?

Evet, olabilir. Aynı dosyaya yazan 2 agent → son yazan kazanır (race). Bağımsız klasörler dokunuyorsa sorun yok.