👨‍👩‍👧 Bu derste 'ajan' ve 'yardımcı robot (subagent)' kavramları takım metaforuyla anlatılır. Claude Code, büyük bir işi küçük parçalara bölüp her parçayı ayrı bir yardımcıya (subagent) verebilir; bunlar paralel çalışır. /agents komutuyla yönetilir. Çocuğunuz iki özelliğin aynı anda eklenmesini izleyecek. Komutlar kopyalanabilir.
Bu derste yapacağımız etkinlik: Bıdık'a aynı anda iki yardımcı çağırtın: biri 'Uyut 😴' butonu + enerji çubuğu eklesin, diğeri besle/oyna seslerini eklesin. İki işin paralel ilerlediğini izleyin, sonra ikisini de tarayıcıda deneyin.
Modül 2 · A — Beceri Ekle · ⏱ 9 dk

Gün 3: Yardımcı Robotlar (Agents & Subagents)

Day 3: Helper Robots (Agents & Subagents)

Bu derste neler öğreneceksin

  • Bir ajanın (agent) ne olduğunu ve Bıdık'ın kendisinin bir ajan olduğunu anlamayı
  • Subagent'ın (yardımcı robot) ne işe yaradığını ve neden işi paylaştırdığını kavramayı
  • /agents komutuyla yardımcıları görmeyi ve özel bir yardımcı tanımlamayı
  • Örnek projede iki yardımcıyı paralel çalıştırıp iki yeni özelliği aynı anda eklemeyi

Bıdık Tek Başına Değil

Şimdiye kadar hep tek bir Bıdık’la çalıştık. Ama büyük bir iş geldiğinde, bir kişi her şeyi tek tek yapmak zorunda kalırsa yavaş olur. Gerçek takımlar işi paylaşır: biri mutfağı, biri salonu toplar; iş aynı anda biter.

Bıdık de aynısını yapabilir. Büyük bir işi küçük parçalara böler ve her parça için bir yardımcı robot çağırır. Bunlara subagent (yardımcı robot) denir.

Bıdık = takım kaptanı. Büyük işi parçalara böler, her parçayı bir yardımcıya verir, yardımcılar aynı anda çalışır, kaptan sonuçları toplar. Tek kişinin saatlerce yapacağı iş, takımla dakikalar sürer.

Ajan (Agent) Nedir?

Önce bir kelime: ajan (agent). Ajan, “kendi başına iş yapabilen yardımcı” demek. Aslında Bıdık’ın kendisi bir ajandır — ona bir hedef verirsin, o düşünür, dosya açar, kod yazar, test eder, bitirir. Sürekli “şimdi ne yapayım?” diye sormaz; hedefe kadar kendi gider.

Ajan = hedefe kadar kendi giden yardımcı. Sen “evcil hayvana uyku özelliği ekle” dersin; ajan gerisini kendi halleder — hangi dosya, hangi satır, nasıl test, hepsini kendi çözer.

Subagent: Kaptanın Çağırdığı Yardımcılar

Subagent, Bıdık’ın çağırdığı küçük yardımcı ajanlardır. Bıdık büyük bir işi bölünce, her parça için bir subagent görevlendirir. Her yardımcının kendi görevi vardır ve diğerlerinden bağımsız çalışır.

Neden işe yarar?

  • Hız: İki iş aynı anda yapılır, sıra beklenmez.
  • Düzen: Her yardımcı sadece kendi işine odaklanır, kafası karışmaz.
  • Temizlik: Bir yardımcı küçük bir işi bitirir, ana Bıdık’ın kafası dağılmaz.

İki özellik birbirinden bağımsızsa (mesela “uyku butonu” ile “ses efekti” — biri diğerini beklemez), Bıdık ikisini iki ayrı yardımcıya verip aynı anda yaptırabilir.

Yardımcıları Yönet: /agents

Bıdık’ın hangi yardımcı tipleri var, görmek için şu komutu yaz:

/agents

Bir liste çıkacak. Burada hazır yardımcı tiplerini görür, hatta kendi özel yardımcını bile tanımlayabilirsin (örneğin “tasarım uzmanı yardımcı” ya da “hata avcısı yardımcı”).

● Yardımcı robotların (agents):

  • genel-yardımcı   — her türlü işi yapar
  • arama-yardımcısı — dosyalarda bir şey arar
  • (yeni bir özel yardımcı ekleyebilirsin)

/agents = “Bıdık, hangi yardımcıları çağırabilirsin göster.” İstersen kendi uzman yardımcılarını da burada tanımlarsın.

Şimdi Dene: İki Yardımcı, Aynı Anda

Örnek oyunumuza iki yeni şey eklemek istiyoruz ve bunlar birbirinden bağımsız:

  1. “Uyut 😴” butonu + bir Enerji çubuğu.
  2. Besle ve oyna butonlarına ses efekti (tıklayınca küçük bir “pıt” sesi).

Bunlar birbirini beklemez, yani Bıdık ikisini paralel yaptırabilir. Şu komutu ver:

Bu iki işi iki ayrı yardımcıya (subagent) ver, paralel yapsınlar:

YARDIMCI 1: Oyuna "Uyut 😴" butonu ekle ve bir "Enerji" çubuğu yap.
"Uyut" butonuna basınca Enerji 15 artsın, çubuğu güncelle.

YARDIMCI 2: "Besle" ve "Oyna" butonlarına kısa, neşeli bir ses efekti
ekle (butona basınca çalsın). Tarayıcının kendi ses özelliğini kullan,
dışarıdan dosya indirme.

İki yardımcı bitince bana ikisinin de ne yaptığını özetle.

Bıdık takım kaptanı gibi davranacak ve iki yardımcıyı aynı anda görevlendirecek:

● İki yardımcı çağırıyorum (paralel çalışacaklar)...

  ┌─ Yardımcı 1: Uyut butonu + Enerji çubuğu .... çalışıyor
  └─ Yardımcı 2: Besle/Oyna ses efekti .......... çalışıyor

  ✓ Yardımcı 1 bitti: app.js'e enerji mantığı, index.html'e "Uyut"
    butonu ve Enerji çubuğu eklendi.
  ✓ Yardımcı 2 bitti: app.js'e küçük bir "bip" ses fonksiyonu eklendi,
    Besle ve Oyna butonlarına bağlandı.

  İki iş de tamam. Tarayıcıyı yenile!

Tarayıcıyı yenile. Artık üç buton var (Besle, Oyna, Uyut), üç çubuk var (Açlık, Mutluluk, Enerji) ve butonlara basınca ses geliyor. İki özellik aynı anda eklendi — tek tek yapsaydın iki kat beklerdin.

Dikkat: İki iş birbirinden bağımsızsa paralel iyidir. Ama bir iş diğerine muhtaçsa (mesela “önce butonu yap, sonra butona ses ekle”), o zaman sırayla yapılır. Bıdık bunu genelde kendi anlar; emin değilsen “bunları sırayla yap” diyebilirsin.

Ne Zaman Yardımcı Çağrılır?

Her iş için yardımcı çağırmaya gerek yok. Küçük işleri Bıdık tek başına yapar. Yardımcılar şunlar için harika:

  • Büyük iş, birçok parça: “Beş sayfayı da baştan tasarla” → her sayfaya bir yardımcı.
  • Bağımsız işler: Birbirini beklemeyen işler → paralel.
  • Araştırma: “Şu hatayı üç farklı yoldan araştır” → üç yardımcı, üç fikir.

Hayat kuralı: Büyük işi küçük parçalara böl, paralel yapılabilenleri paralel yap. Bu, hem yazılımda hem de gerçek hayatta (ev temizliği, proje ödevi) işe yarar.

Kontrol Noktası ✅

  • /agents yazıp yardımcı listesini gördüm.
  • “Ajan, hedefe kadar kendi giden yardımcıdır” cümlesini anlatabiliyorum.
  • Bıdık’a iki yardımcıyı paralel çağırttım.
  • Tarayıcıda hem “Uyut” butonu + Enerji çubuğu hem de ses efekti çalışıyor.

Bugün Ne Öğrendin?

  • Ajan (agent), hedefe kadar kendi giden yardımcıdır; Bıdık’ın kendisi de bir ajandır.
  • Subagent (yardımcı robot), Bıdık’ın çağırdığı küçük, görevli yardımcılardır.
  • /agents ile yardımcıları görür, kendi özel yardımcını tanımlarsın.
  • Bağımsız işler paralel yapılır; bağımlı işler sırayla.

Ebeveyn Notu

Agent ve subagent, Claude Code’un en güçlü ölçeklenme araçlarıdır: ana ajan bir görevi alt görevlere böler ve her birini ayrı bir bağlamda, çoğu zaman paralel olarak çalıştırır. Bu, hem hızı artırır hem de her yardımcının odağını korur. Çocuğunuz “böl ve paylaştır” (divide and conquer) prensibini somut olarak görür — bilgisayar biliminin temel bir fikri. Paralel ile sıralı işin farkı (bağımsız vs. bağımlı görevler) günlük hayatta da değerli bir muhakeme becerisidir.

Etkinlik (Elle Yapılacak)

Bir kağıda “Takım Görev Dağılımı” çizin. Bir aile işini (örn. akşam yemeği hazırlığı) ele alın:

  • Kaptan (Bıdık): İşi kim böler?
  • Yardımcı 1: Hangi iş? (örn. sofra kur)
  • Yardımcı 2: Hangi iş? (örn. salata yap)
  • Paralel mi, sırayla mı? Hangi işler aynı anda olur, hangileri birbirini bekler?

Bu etkinlik, çocuğunuzun “bağımsız işler paralel, bağımlı işler sıralı” muhakemesini günlük hayata taşımasını sağlar.

Yarın

Yarın M — Harita Çiz modülüne geçiyoruz. Artık Bıdık’ın bütün güçleri var (kurallar, hafıza, plan modu, yetenek kartları, alet çantası, yardımcılar). Sıra büyük bir uygulamanın haritasını çizmekte — define haritası gibi: başlangıç, varış ve aradaki bütün duraklar!