Anla Dene

Kurslar · Uygulamalı başlangıç

AI agent orkestrasyonu

Bir isteği planla, yaptır ve kanıtıyla kabul et.

10 bölüm + 3 gerçek vaka + kendin kur

Video sırasını izle; kendi projen için küçük bir komutan ve işçi düzeni kur. Başlangıç planını kendi hızına göre uygula.

Örneklerle başla Kendin kur

Ayrıntılı anlatımın tek kaynağı 4.12 Ajan orkestrasyonu dersi. Burada bölüm özetlerini, kopyalanabilir uygulama örneklerini ve ilk kurulum planını bulursun.

Video sırasıyla bölümler

  1. Soğuk açılış

    Ajanın “bitti” demesinden başlayıp kabul kanıtının neden gerektiğini gör.

    Derste oku: Soğuk açılış
  2. Sorun

    Aynı isteği tekrar anlatma, bağlamı büyütme ve erken teslim sorunlarını ayır.

    Derste oku: Sorun
  3. Fikir: şirket gibi kur

    Yöneten, yapan ve yargılayan rollerini kendi işine göre belirle.

    Derste oku: Fikir: şirket gibi kur
  4. Zincir

    İsteği plan, emir, uygulama, ayrı göz ve kullanıcı kararı arasında taşı.

    Derste oku: Zincir
  5. Plan işin boyunda

    Küçük işe kısa plan yaz; planı olmayan emri kapıda durdur.

    Derste oku: Plan işin boyunda
  6. Yapan yargılamaz

    Yapanın sunduğu sonucu ayrı gözün aynı kanıtla incelemesini sağla.

    Derste oku: Yapan yargılamaz
  7. Modlar ve maliyet

    İşin güçlüğüne göre model ve çalışma biçimini değerlendir; sonucu da hesaba kat.

    Derste oku: Modlar ve maliyet
  8. Hafıza ve defter

    Kalıcı kuralı, güncel isteği ve parçaların yerini ayrı kaydet.

    Derste oku: Hafıza ve defter
  9. Sen nasıl başlarsın

    Kendi deneme projen için küçük kurulum ve ilk teslim akışını hazırla.

    Derste oku: Sen nasıl başlarsın
  10. Kapanış

    Tek bir isteğin kayıttan kabule izini takip ederek düzenini geliştir.

    Derste oku: Kapanış

Üç gerçek vaka

Kopyalanabilir örnekler

Örnek iş: iletişim sayfasındaki belirsiz cümleyi sadeleştir. Dosya ve görev adlarını kendi deneme projenle değiştir. Mevcut talimat veya ayar dosyan varsa içerikleri inceleyerek birleştir.

emir.json

{
  "id": "iletisim-metni",
  "PLAN": {
    "ne": "İletişim açıklamasındaki belirsiz cümleyi sadeleştir.",
    "sinir": "Yalnız iletisim.html; davranış ve yayın değişikliği yok.",
    "dogrulama": "Önce/sonra metnini karşılaştır ve sayfada görünen sonucu kontrol et."
  },
  "kabul": [
    "İstenen anlam korunur.",
    "Yalnız izinli dosya değişir.",
    "Görünen metin ile teslim aynı değişikliğe aittir."
  ],
  "teslim": "EMIR-TESLIM iletisim-metni | HAZIR | dosya, kontrol, gerçek sonuç, eksik"
}

PLAN ne yapılacağını, sınırı ve kontrolü taşır. Kabul listesi “bitti” sözünü ölçülebilir bir sonuca çevirir. Kimlik, emir ile teslimi eşler.

Komutan ve işçi akışı

KimNe yaparNe teslim eder
SenHedefi ve kabulü belirlersin.İstenen sonuç.
KomutanPlanı çıkarır, görevi verir.Emir ve inceleme özeti.
YapanSınırı belli dosyayı değiştirir.Hazır fark ve gerçek kanıt.
DenetçiAynı farkı kabul ölçütüyle karşılaştırır.Bulgu ve eksikler.
SenSonucu değerlendirirsin.Kabul veya düzeltme kararı.

Plan kapısı

Bu küçük Python örneği seçtiğin emir.json dosyasını denetler. Eksik planı standart hata çıktısıyla reddeder. Claude Code'un hazır plan özelliği değildir.

plan_kapisi.py

import json
import sys
from pathlib import Path

try:
    emir = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
    plan = emir.get("PLAN", {})
    for alan in ("ne", "sinir", "dogrulama"):
        if not isinstance(plan.get(alan), str) or not plan[alan].strip():
            raise ValueError("PLAN alanı eksik: " + alan)
    if not isinstance(emir.get("id"), str) or not emir["id"].strip():
        raise ValueError("Emir kimliği gerekli")
    kabul = emir.get("kabul")
    if not isinstance(kabul, list) or not kabul or not all(
        isinstance(k, str) and k.strip() for k in kabul
    ):
        raise ValueError("Kabul ölçütü listesi gerekli")
except (IndexError, OSError, ValueError, AttributeError) as hata:
    print("PLAN-RED:", hata, file=sys.stderr)
    sys.exit(2)
print("PLAN-GECTI:", emir["id"])

.claude/settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Agent",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/plan_kapisi.py\" \"$CLAUDE_PROJECT_DIR/emir.json\""
          }
        ]
      }
    ]
  }
}

PreToolUse araç çağrısından önce çalışır. Bu örnekte Agent eşleyicisi alt ajan çağrılarını hedefler; kapı çıkış 2 verirse çağrı durur. CLAUDE_PROJECT_DIR proje kökünü gösterir. Bu dar örnek yalnız bu giriş yolunu ve seçilen emir dosyasını denetler; içerik doğruluğunun veya bütün işlemlerin güvencesi değildir. Resmî hook belgesinde oku.

Önce kapıyı kendin dene: PLAN içindeki bir alanı boş bırakınca PLAN-RED; doldurunca PLAN-GECTI görmelisin.

python3 plan_kapisi.py emir.json

CLAUDE.md

# Küçük proje çalışma düzeni
Ana oturum komutandır: isteği inceler, PLAN ve kabul ölçütünü yazar.
Emir dosyasını planlamadan alt ajan çağırma.
Yapan yalnız emir sınırındaki dosyaya dokunur; kendini kabul etmez.
Denetçi aynı farkı ve kanıtı okuyup bulgu bildirir; dosya değiştirmez.
Teslim HAZIR demektir. KABUL ve yayın kararı kullanıcıdadır.

Talimat bir çalışma kuralıdır; izin kilidi değildir. Alt ajanların görev ve araçlarını ayrıca sınırla.

.claude/agents/yapan.md

---
name: yapan
description: Emirdeki küçük metin düzenlemesini hazırlar.
tools: Read, Grep, Glob, Edit, Write, Bash
isolation: worktree
---
Emrin kimliğini EMIR-ALINDI satırıyla bildir.
İletilen hedefi ve sınırı oku; belirsizse dur ve sor.
Yalnız izinli dosyada anlamı koruyan küçük değişikliği yap.
Çalışma kopyasını, farkı, kontrolü ve gerçek sonucu komutana ilet.
EMIR-TESLIM satırında HAZIR de; kendi çıktına KABUL yazma.

.claude/agents/denetci.md

---
name: denetci
description: Hazır teslimi kabul ölçütleriyle karşılaştırır.
tools: Read, Grep, Glob
---
Aynı değişikliğin önce/sonra metnini ve gönderilen kanıtı oku.
İstenen anlam, dosya sınırı ve ekranda görünen sonucu karşılaştır.
Kendin çalıştırmadığın kontrolü çalıştırmış gibi yazma.
Bulguyu ve eksik kanıtı komutana bildir; dosya değiştirme.
Son kabulü kullanıcıya bırak.

Yapan ayrı çalışma kopyasında çalışır. Komutan, denetçiye hangi dosya ve farkı okuyacağını açıkça iletir. Bu denetçi yalnız okur; gönderilen komut çıktısını kendisi çalıştırmış gibi raporlamaz.

Hazır teslim ile kabul ayrı

EMIR-ALINDI iletisim-metni
EMIR-TESLIM iletisim-metni | HAZIR
Dosya: iletisim.html
Kontrol: önce/sonra metni ve görünen sayfa
Sonuç: gerçekten gözlemlediğin sonucu yaz
Eksik: varsa açıkça yaz

DENETIM iletisim-metni | BULGU YOK veya BULGU VAR
Dayanak: incelenen aynı fark ve kanıt

KABUL iletisim-metni | kullanıcı kararı
Yayın: ayrıca karar verilmedi

“Hazır sunuyorum”, yapanın sorumluluğudur. “Kabul”, inceleme ve senin kararındır. Birbirinin yerine yazma. Gerçekte görmediğin sonucu örnek satırdan kopyalayıp başarılı sayma.

Kendin kur

Git, Python için python3 komutu ve Claude Code kullanabildiğin küçük bir deneme projesiyle başla. Bu bölüm bir başlangıç planıdır; adımları kendi hızına göre tamamla. Her adımı yaptığında işaretleyebilirsin.

  1. Proje talimatını yaz

    Ne yaparsın: Deneme projesinde CLAUDE.md içeriğini işine göre düzenle.
    Ne görürsün: Komutanın hedef, sınır ve kabul görevi açıkça yazılıdır.

  2. Yapan ve denetçiyi ayır

    Ne yaparsın: .claude/agents/yapan.md ve denetci.md dosyalarını örnekten oluştur.
    Ne görürsün: Yapan yazabilir, denetçi yalnız okuyabilir; görevler birbirine karışmaz.

  3. Plan kapısını bağla

    Ne yaparsın: plan_kapisi.py ve emir.json dosyalarını kaydet; hook ayarını ekle.
    Ne görürsün: Boş PLAN reddedilir, dolu PLAN yerel kontrolden geçer.

  4. İlk emri ver

    Ne yaparsın: Emir örneğini kendi küçük işinle doldur; ana oturumdan yapanı görevlendirmesini iste.
    Ne görürsün: EMIR-ALINDI satırı ile aynı görev kimliğini görürsün.

  5. İlk teslimi incelet

    Ne yaparsın: Hazır farkı ve gerçek kanıtı komutana ilet; denetçinin aynı farkı incelemesini iste.
    Ne görürsün: EMIR-TESLIM satırında dosya, kontrol, sonuç ve eksikler vardır.

  6. Kabulü sen ver

    Ne yaparsın: Denetçinin bulgularını ve kendi ekranındaki sonucu karşılaştır.
    Ne görürsün: KABUL veya düzeltme kararı ayrıdır; yayın otomatik başlamaz.

İlk görev istemi

Komutan olarak CLAUDE.md ve emir.json dosyalarını oku.
PLAN ve kabul ölçütünü kontrol et. Yalnız bu emri yapan alt ajanına ver.
Çalışma kopyasını, farkı ve gerçek kanıtı al.
Denetci alt ajanına aynı farkı ve kanıtı açıkça ilet.
Bulguları bana getir. Hazır teslimi kabul sayma.
Kabul ve yayın kararını bana bırak.

Alt ajan dosyalarını ilk kez oluşturduysan ve tanımlar görünmüyorsa oturumu yeniden aç. Kurulumun ayrıntılarını dersin Kendin kur bölümünde bulabilirsin.

Kaynak ve devam

Son doğrulama: 2026-11-14

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik