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.
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
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ışSorun
Aynı isteği tekrar anlatma, bağlamı büyütme ve erken teslim sorunlarını ayır.
Derste oku: SorunFikir: şirket gibi kur
Yöneten, yapan ve yargılayan rollerini kendi işine göre belirle.
Derste oku: Fikir: şirket gibi kurZincir
İsteği plan, emir, uygulama, ayrı göz ve kullanıcı kararı arasında taşı.
Derste oku: ZincirPlan işin boyunda
Küçük işe kısa plan yaz; planı olmayan emri kapıda durdur.
Derste oku: Plan işin boyundaYapan yargılamaz
Yapanın sunduğu sonucu ayrı gözün aynı kanıtla incelemesini sağla.
Derste oku: Yapan yargılamazModlar ve maliyet
İşin güçlüğüne göre model ve çalışma biçimini değerlendir; sonucu da hesaba kat.
Derste oku: Modlar ve maliyetHafıza ve defter
Kalıcı kuralı, güncel isteği ve parçaların yerini ayrı kaydet.
Derste oku: Hafıza ve defterSen 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ınKapanış
Tek bir isteğin kayıttan kabule izini takip ederek düzenini geliştir.
Derste oku: Kapanış
Üç gerçek vaka
- Önbellek: “yapmadın” sandım. Kaynak değişse de kullanıcının eski sonucu görmesi kabulü durdurur. Vakayı derste oku.
- “Var” ile “görünüyor” farkı. Kapalı bir bölümdeki öğe ilk ekranda görünür sayılmaz. Vakayı derste oku.
- Çizimde var, işte yok. Plan adımlarının gerçekten işletildiğini kayıtla kontrol et. Vakayı derste oku.
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ışı
| Kim | Ne yapar | Ne teslim eder |
|---|---|---|
| Sen | Hedefi ve kabulü belirlersin. | İstenen sonuç. |
| Komutan | Planı çıkarır, görevi verir. | Emir ve inceleme özeti. |
| Yapan | Sınırı belli dosyayı değiştirir. | Hazır fark ve gerçek kanıt. |
| Denetçi | Aynı farkı kabul ölçütüyle karşılaştırır. | Bulgu ve eksikler. |
| Sen | Sonucu 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.jsonCLAUDE.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.
0/6 adım tamamlandı
- 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. - 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. - 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. - İ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. - İ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. - 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
- Ayrıntılı orkestrasyon dersi: video sırası ve gerçek vakalar.
- Claude Code: Hooks reference: PreToolUse, Agent eşleyicisi, çıkış 2 ve proje kökü.
- Claude Code: Create custom subagents: alt ajan tanımı ve araçlar.
Son doğrulama: 2026-11-14