Tüm sayılar
Sistem Bülteni · Sayı 2

Tek asistana her şeyi yükleme — küçük bir ajan kadrosu kur

 
Kaan Doğan Hüdhüd logosu  

Kaan Doğan.

Haftalık Bülten

Sayı 2 · 14 Temmuz 2026

Merkezdeki bir figürün, her biri tek iş yapan küçük ajan modüllerini yönettiği pixel-art illüstrasyon

Sayı 2 · Haftanın Sistemi

Tek asistana her şeyi yükleme — küçük bir ajan kadrosu kur

Geçen hafta gelen kutunu senin yerine okuyan asistanı kurduk. Bu hafta bir adım öteye geçiyoruz: o asistanı yalnız bırakmayıp yanına ekip arkadaşları koyuyoruz. Çünkü tek bir asistana her işi yüklediğinde er ya da geç aynı duvara çarparsın — bu sayıda o duvarı ve etrafından dolanmanın yolunu kuracağız.

Şu senaryo tanıdık gelecek: Claude'a tek bir dev talimat yazmışsın — “maillerime bak, sonra haftalık özetimi çıkar, bu arada şu metni de düzelt, bir de rakamları kontrol et.” İlk gün harika çalışıyor. Bir hafta sonra çıktı bozuluyor: bir işte başarılı, ötekini atlıyor. Neyi neden yaptığını takip edemiyorsun, talimatı düzeltmek istediğinde de nereye dokunacağını bilemiyorsun. Tek asistan büyüdükçe güvenilmez oluyor.

Sistemin fikri tek nefeste: Bir mutfak düşün. Tek bir aşçının hem kesip hem pişirip hem servis yapması yerine; biri sadece hazırlık, biri sadece ocak, biri sadece servis yapıyor. Sen şefsin — işi bölüyor, kimin ne yaptığına bakıyorsun. Ajan kadrosu tam bu: her biri tek iş yapan, kendi yazılı tanımı olan küçük asistanlar. Sen “her şeyi yapan tek asistan” kurmuyorsun; ince işleri ayrı ayrı, güvenilir parçalara bölüyorsun.

Kurulum — 4 adım

1. İşi tek-görevli parçalara böl. Şu an tek asistana yaptırdığın işi kağıda dök: kaç ayrı iş var? Örneğin “haftalık özet” aslında üç iş: (a) ham notları topla, (b) özete dök, (c) gelecek hafta aksiyonlarını çıkar. Her ayrı iş = bir ajan adayı. Kural: bir ajan tek cümleyle tanımlanamıyorsa, hâlâ çok büyüktür — ikiye böl.

2. Her ajan için tek bir tanım dosyası yaz. Her ajanın kendi yazılı “görev kartı” olur. Claude'da her ajan için ayrı bir Proje aç (veya Claude Code kullanıyorsan ayrı bir tanım dosyası) ve şu iskeleti doldur:

GÖREV: [tek iş — ör. “ham haftalık notları 3 başlıklı özete çevir”]
GİRDİ: Sana ne vereceğim [ör. “bir metin bloğu ham notlar”]
ÇIKTI: Ne üreteceksin [ör. “3 başlık: önemli gelişmeler / rakamlar / aksiyonlar”]
KURALLAR: Sınırların [ör. “veride olmayan rakamı ekleme; eksikse ‘eksik’ yaz; bu görevin dışına çıkma”]
BİTİNCE: Ne yap [ör. “çıktıyı ver ve dur, başka iş önerme”]

Bu beş satır senin kalıcı ajan tanımın. Bir kez yazıyorsun, dosyada duruyor; hangi asistana verirsen ver aynı şekilde çalışır. Her yeni ajan için aynı iskeleti kopyalayıp GÖREV satırını değiştiriyorsun.

3. Kadroyu 2 ajanla başlat, tek tek test et. Baştan on ajan kurma. En çok tekrar eden iki işini seç, ikisinin tanımını yaz, her birini ayrı ayrı çalıştır. Test: her ajana sadece kendi girdisini ver, çıktısı tanımdaki ÇIKTI satırına uyuyor mu bak. Bir ajan yan işe kayıyorsa (istemediğin şeyi de yapıyorsa) KURALLAR satırına “yalnızca şunu yap” ekle. İkisi güvenilir çalışana kadar üçüncüyü ekleme.

4. Şef sen ol: sıralı çağır. Ajanlar birbiriyle konuşmaz; sıralamayı sen kurarsın. Önce “topla” ajanını çalıştır, çıktısını al; onu “özetle” ajanına ver. Her adımda çıktıyı görüyorsun, nerede bozulduğunu anında yakalıyorsun. Elinde artık tek bir kara kutu değil, kontrol edebildiğin bir hat var.

Bugün 10 dakikada başla

Bugün tüm kadroyu kurma. Sadece 2. adımı yap: en çok tekrar eden tek işini seç, yukarıdaki beş satırlık iskeleti onun için doldur, bir Projeye kaydet. Yarın o tek ajanı bir kez çalıştırıp çıktısını gör. İlk ajanın güvenilir çalışınca ikincisini eklersin — kadro böyle büyür.

Ben kendi işimi tam bu şekilde yürütüyorum: her biri tek iş yapan bir ajan kadrom var — biri iki gelen kutumu tarayıp yalnızca cevap bekleyenleri özetliyor, bir diğeri bu bülteni editoryal kurallara göre üretiyor, bir başkası görsel tarafına bakıyor. Hepsi ayrı tanım dosyalarında duruyor; ben şef olarak işi bölüyorum, onlar tek işlerini yapıyor. Tek dev asistan kurmayı bıraktığım gün sistemin güvenilirliği gözle görülür arttı — bir ajan hata yaptığında tüm işi değil, sadece o kartı düzeltiyorum.

 

Bu hafta önemli 3 gelişme

01
 

Claude Code'da alt-ajanlar artık varsayılan olarak arka planda çalışıyor

1 Temmuz'daki sürümle alt-ajanlar arka planda çalışıyor: sen ana işine devam ederken onlar kendi görevini yürütüyor, bittiğinde haber veriyor. İşine etkisi: yukarıda kurduğun kadroda bir ajanı çalıştırıp beklemek zorunda değilsin — “topla” ajanın arka planda dururken sen “özetle” tarafını hazırlarsın, kadro paralel işler.

devamı →
02
 

Kadronun büyüklüğüne artık sınır koyabiliyorsun: “Dynamic workflow size” ayarı

6 Temmuz'da Claude Code'un /config ayarlarına “Dynamic workflow size” geldi: bir işte Claude'un kaç paralel ajan açacağını küçük/orta/büyük olarak yönlendiriyorsun. İşine etkisi: bu sayının altın kuralı “az ajanla başla”nın araç karşılığı bu — kadronun kontrolden çıkıp onlarca ajana dağılmasını baştan sınırlarsın.

devamı →
03
 

Ajan ekranı okunur hale geldi: her ajanın durumu ve tek satırlık başlığı

Bu hafta (6-10 Temmuz) “claude agents” ekranındaki her satır, ham komut metni yerine renkli bir durum kelimesi ve o ajanın ne yaptığını özetleyen tek satırlık bir başlık gösteriyor. İşine etkisi: kadron büyüdükçe “şef” olarak hepsine tek ekrandan bakıp hangisi çalışıyor, hangisi seni bekliyor bir bakışta görürsün — takip yükü düşer.

devamı →
 

30 saniyelik ipucu

Bir ajanın en sık bozulma sebebi: kendi görevinin dışına taşması — sen özet isterken bir de öneri, bir de yorum eklemesi. Her ajan tanımının sonuna şu tek satırı koy:

“Sadece bu görevi yap. İstenmeyen ekstra yorum, öneri veya başka iş ekleme. Görevin dışında bir şey gerekiyorsa yapma, tek cümleyle belirt ve dur.”

Bu cümle ajanı kendi şeridinde tutar — kadronun güvenilirliği buradan gelir. Ben her ajan tanımıma koyuyorum.

Bu kadroyu kurmaya başlayacaksan, ilk hangi işi ayrı bir ajana vereceğini bu maile cevap olarak yaz — tek dev asistanında en çok hangi iş bozuluyorsa ondan başla. Takıldığın adım varsa onu da ekle, birebir bakarım. Verdiğin cevaplar bir sonraki sayının konusunu da bana veriyor.

Haftaya görüşmek üzere,
Kaan Doğan

Ücretsiz · Haftada 1 mail

Sıradaki sayı gelen kutunda olsun.

E-postanı bırak; her Pazartesi bir sistem tarifi + haftanın AI gelişmeleri gelen kutunda olsun. Spam yok, istediğin an tek tıkla çıkarsın.

E-postanı kimseyle paylaşmam.

Kaydettim. Sıradaki sayı Pazartesi sabahı gelen kutunda olacak.