Graf mühendisliği: ne demek, ne zaman kullanılır, ne zaman kullanılmaz

Graf tam olarak nedir, yapay zekanı anında hızlandıran tek test, karşılığını veren tek desen, nerede sessizce kırılır ve Claude Code'da birkaç dakikada nasıl kurulur.

Hızlı not: Bu fikrin kökeni yeni değil. Süreci diyagram olarak çizip verimli hale getirmek onlarca yıldır mühendisliğin işi. Yeni olan tek şey, artık aynı şeyi tek cümleyle kurabiliyor olman.

1. Bu iş nereden çıktı?

Bir ay önce herkes döngüleri konuşuyordu. Sonra biri "hâlâ döngü mü konuşuyoruz, graflara geçtik mi?" diye yazdı ve daha döngüleri yeni öğrenmiş bir kesim, bunu bir gecede eski moda ilan etti.

Şaka tuttu çünkü yarısı doğruydu. Döngü, tek bir ajanın tek bir şeyi tekrar tekrar iyileştirmesi: dene, kontrol et, düzelt, tekrar git. Geçen ayın becerisi buydu.

Herkesin geçtiği şey daha iyi bir döngü değil. Döngülerden oluşan bir ağ: tek ajanın tek sayıyı kovalaması yerine, birbirini izleyen ve düzelten döngüler.

Mühendisler saatler içinde itiraz etti: bu, yeni bir isim giymiş onlarca yıllık bir fikir. Haklılar ve bu iyi haber. Otuz yıldır kritik sistemleri çalıştıran bir desen, işini emanet etmek isteyeceğin şeydir.

2. Graf tam olarak nedir?

Graf, yapay zeka işinin görünür hale getirilmiş planıdır. İki soruya cevap verir: hangi işlerin yapılması gerekiyor ve hangi iş hangisini beklemek zorunda?

Sadece iki parçası var. Kutuya düğüm deniyor: tek iş, tek ajan, bir girdi ve bir çıktı. Bir rakibi araştırmak. Bir taslak yazmak. Bir iddiayı kontrol etmek.

Oka ise kenar deniyor. Anlamı şu: bir iş, diğerinin ürettiğine ihtiyaç duyuyor, o yüzden bekliyor. Ve ok ancak üstünden gerçek bir şey geçtiğinde sayılır.

Düğümler düşünür. Kenarlar sonucu taşır. Sözlük bu kadar.

Bir düğümü grafta kullanılabilir yapan şey ise sözleşmesidir: sınırları belli tek bir iş, tanımlı girdi, tanımlı çıktı. Çıktısı bir metin yığını olan düğümü sadece insan okuyabilir. Çıktısının biçimi sabit olan düğümü ise bir sonraki düğüm tahmin etmeden tüketebilir. Bütün mesele bu.

▸ DÜĞÜM SÖZLEŞMESİ
İŞ     : bir rakibin fiyatlandırmasını araştır (tek iş, başka bir şey değil)
GİRDİ  : { rakip: "isim", url: "https://..." }   ← dışarıdan verilir, varsayılmaz
ÇIKTI  : { fiyat: sayı, plan: metin, kaynak: url, tarih: "YYYY-AA-GG" }
ŞEMA   : zorunlu. ajan serbest metin döndürürse reddedilir ve tekrar denenir
NEDEN  : tanımlı çıktı, bir sonraki düğümün bunu araya insan girmeden
         okuyabilmesini sağlar. bağlanabilir olmasının sebebi budur.

3. Sahte kenarları bulan test

Bugün kullandığın akışa bak ve adım adım yürü. Her adımda tek şey sor: bu adımın, bir öncekinin sonucuna gerçekten ihtiyacı var mı?

Cevap evetse kenar gerçektir, sırayı koru. Hayırsa kenar yoktur ve o bekleme boşa gitmiştir. O iki iş aynı anda çalışabilir.

Basit bir örnek: "A dosyasını hatalara karşı incele, sonra B dosyasını incele." Sıralı gibi okunuyor ama B'nin incelemesi A'nın döndürdüğüne hiç bakmıyor. Sadece sen o sırayla yazdığın için art arda çalışıyorlar. Yan yana çalıştırınca iş, ikisinin toplamı kadar değil, yavaş olan dosya kadar sürüyor.

Çizdiğin neredeyse her akışta bu sahte kenarlardan iki üç tane bulacaksın. Her biri, bedavaya attığın zaman.

4. Şu anki kurulumun zaten bir graf

Bir ajana "önce A, sonra B, sonra C, sonra D yap" diye yazdığında teknik olarak zaten bir graf çizmişsin. Sadece mümkün olan en üzgün hali: her düğümün bir girişi ve bir çıkışı olan düz bir zincir.

Doğru çalışır. Ama yavaş çalışır ve kolay kırılır, çünkü zincirin yedeği yoktur. C takılırsa D hiç olmaz ve A'nın işi yukarıda mahsur kalır.

Graf mühendisliğinin ilk gerçek becerisi o zinciri yeniden çizmektir. Her ok için sahte kenar sorusunu sor. Veri taşımayan okları kes, çizgi genişler: aynı anda çalışabilen birkaç bağımsız iş ve hepsine birden ihtiyaç duyan tek bir iş.

Bunun sebebi kozmetik değil. 40 adımlık düz bir akışta 40 tane sıralı kırılma noktası ve 40 adımın toplamı kadar gecikme vardır. Aynı 40 iş graf olarak çizildiğinde gerçekte var olan kadar bağımlılık kalır, genelde üç ile beş arası, ve iş toplam süre kadar değil en yavaş katman kadar sürer. Beş dakika ile on beş saniye arasındaki fark budur; hem de aynı işi yaparak.

Darboğaz hiçbir zaman model değildi. Senin çizdiğin çizgiydi.

5. Karşılığını veren tek desen: elmas

Yüz tane şekle ihtiyacın yok. Ciddi bir ajan sistemini izle, hep aynı resim çıkıyor: iş bölünüyor, birkaç işçi yan yana kazıyor, bir şey bulduklarını kontrol ediyor ve her şey tek cevapta birleşiyor.

Bu resmin adı elmas ve bu yılın öğrenmen gereken neredeyse tek deseni. Resmî adı da ezberlemeye değer: dağıt, sadeleştir, sentezle. Genişlik için dağıt, düz kodla sıkıştır, son bir ajanla cevabı yazdır.

Claude'un içindeki araştırma özelliği tam olarak bunu üretimde çalıştırıyor: bir lider açıları planlıyor, işçiler paralel topluyor, bulgular kontrol ediliyor ve ancak ondan sonra tek rapor sana ulaşıyor. Elması görmeye başladığında "ajanıma nasıl daha çok adım attırırım" diye sormayı bırakıp "bölünme nerede, birleşme nerede" diye sormaya başlıyorsun. Ölçeklenen soru ikincisi.

Kaputun altında elmas şuna benziyor. Sen "workflow" dediğinde Claude bu tarz kısa bir betiği kendisi yazıyor ve koordinasyonu kod olarak çalıştırıyor. Ajanlar arasında sonuç taşımanın ekstra bağlam harcamamasının sebebi de bu.

// pazar taraması grafı: "workflow" dediğinde Claude'un yazdığı elmas

const acilar = [
  "ilk 3 rakibe karşı fiyatlandırma",
  "yorumlarda alıcıların şikayet ettiği şeyler",
  "kategorideki özellik boşlukları",
  "pazarın önümüzdeki 12 ayda gideceği yön",
];

// DAĞIT — her açıya bir araştırmacı, hepsi aynı anda
const ham = await parallel(
  acilar.map(a => () => agent({
    task: `araştır: ${a}. her iddianın kaynak linki + tarihi olsun.`,
    schema: Bulgu,          // doğrulanmış çıktı, serbest metin değil
    model: "ucuz",          // sıkıcı düğüm → ucuz model
  }))
);

// SADELEŞTİR — düz kod, model yok, token yok
const bulgular = kaynagaGoreTekille(ham.flat().filter(Boolean));

// DOĞRULA — her bulguya TEMİZ bağlamlı ayrı bir şüpheci, çürütmeyi dener
const hayattaKalanlar = await parallel(
  bulgular.map(b => () => agent({
    task: "bunu çürütmeye çalış. tut | at + gerekçe döndür.",
    input: b,
    freshContext: true,     // araştırmacının sohbetini asla tekrar kullanma
    model: "guclu",         // karar düğümü → güçlü model
  }))
).then(v => bulgular.filter((_, i) => v[i].karar === "tut"));

// SENTEZLE — tek ajan, hayatta kalanlardan cevabı yazar
return agent({ task: "güven sırasına göre tek rapor, kaynaklar ekli.",
               input: hayattaKalanlar, model: "guclu" });

Bir kez okuduğunda zanaatın tamamı görünüyor: işin bağımsız olduğu yerde dağıtım, bedava kodla sadeleştirme, temiz bağlamda doğrulama, sıkıcı düğümlerde ucuz model, kararın olduğu yerde güçlü model ve sonda tek sentez. Pazar taramasının da, kod incelemesinin de, araştırma raporunun da iskeleti aynı. Sadece açıları ve istemleri değiştiriyorsun.

6. Asıl numara kontrolcüde

Şimdi neredeyse herkesin atladığı kısım geliyor ve gerçek grafı pahalı bir oyuncaktan ayıran şey bu.

Yapay zekanın kendi kendini incelemesi üzerine yapılan her ciddi test aynı şeyi söylüyor: modeller kendi hatalarının çoğunu göremiyor. Kendi işine not veren model kendine fazlasıyla cömert davranıyor.

Yani işi yapan ajanın işi kontrol etmesine asla izin verme. Kenarın üstüne ayrı bir düğüm koy. Tek görevi, bulgu ileri gitmeden onu öldürmeye çalışmak. Hayatta kalırsa geçer, kalmazsa orada ölür.

Kimsenin söylemediği püf noktası da şu: o kontrolcünün temiz bir bağlama ihtiyacı var. İşçinin sohbetini ona verirsen hiçbir şey kontrol etmiyor, sadece başka bir yazı tipinde kendi kendine onay veriyor.

Tek bağlamı paylaşan ajanlardan oluşan bir graf, kılık değiştirmiş tek bir döngüdür. Aynı şekilde kırılır, sadece daha geç ve daha pahalı.

Doğrulayıcıyı taze tut. Kendi bağlamı olsun. "Ajan bitti dedi mi" değil, "test gerçekten geçiyor mu" gibi gerçek bir sinyali kontrol etsin. Sonra kontrolü üçe böl: doğru mu, güncel mi, kaynak gerçek mi? Üç farklı mercek, birbirinin aynısı on tanenin kaçırdığını yakalıyor.

▸ DOĞRULAYICI DÜĞÜM
GİRDİ    : bir işçiden gelen tek bulgu (sadece bulgu, işçinin sohbeti asla)
BAĞLAM   : taze ve boş. yargıladığı işi hiç görmemiş
KONTROL  : üç şüpheci paralel çalışır, her birinin sorusu farklı
  1. doğru mu?      → iddia gerçekten ayakta duruyor mu
  2. güncel mi?     → kaynak yeni mi, bayat mı
  3. kaynak gerçek mi? → link, atfedildiği iddiaya gerçekten çıkıyor mu
GEÇER    : şüphecilerin çoğunluğu hayatta bırakırsa bulgu kalır
KALIR    : nihai cevaba ulaşmadan elenir

Akılda tutulacak kural: bir işçi ile onun doğrulayıcısı asla aynı bağlamı paylaşmamalı. Paylaştıkları anda yine tek bir döngü kendi ödevine not veriyor demektir, sadece faturası daha büyük.

7. Graflar gerçekte nerede kırılıyor?

1. Bağlam çökmesi

Bin düğüme dağıt, sonra bin çıktının hepsini tek bir son adıma vermeye çalış: sentez başlamadan bağlam penceresini aşarsın. Çözüm, toplamayı katmanlamak: sonuçları gruplara böl, her grubu özetle, sonra özetleri birleştir. Asla ham yığını değil.

// katmanlı toplama — 1.000 ham çıktıyı asla tek adıma dökme
const gruplar = chunk(sonuclar, 40);              // 40'lık gruplar
const ozetler = await parallel(
  gruplar.map(g => () => agent({ task: "bu grubu özetle", input: g }))
);
return agent({ task: "özetlerden cevabı yaz", input: ozetler });
// son adım 1.000 ham çıktı değil, ~25 özet okur

2. Sahte bağımsızlık

İki düğüm bağımsız görünüyor çünkü istemleri birbirini hiç anmıyor, ama ikisi de aynı dosyaya yazıyor ya da aynı hız sınırlı servise vuruyor. Bu gizli bir kenardır. Bun ekibi büyük bir işi çok sayıda ajana ilk dağıttığında hepsi tek bir çalışma alanını paylaşmış ve birbirlerinin üstüne yazmışlar. Çözüm: her işçiye kendi izole alanını ver ve sadece paylaşılan veriyi değil, paylaşılan kaynakları da denetle.

// işçileri izole et — ortak dosya yok, ortak çalışma alanı yok
await parallel(dosyalar.map(d => () => agent({
  task: `${d} dosyasını yeniden düzenle`,
  worktree: true,        // her ajan kendi git worktree'sinde çalışır
})));
// birbirlerinin üstüne yazamazlar, sonuçlar temiz birleşir
// kural: aynı dosyaya yazan iki düğümün arasında kenar vardır, paralellik değil

3. Sessiz düğüm ölümü

Zincirde bir hata her şeyi durdurur; can sıkıcıdır ama bellidir. Grafta iki yüz düğümden biri ölür ve tamamlanmış görünen bir rapora sızar. Çözüm: her birleştirme adımı gelen girdi sayısını beklediği sayıyla karşılaştırsın ve farkı sessizce yutmak yerine işaretlesin.

// toplama koruması — sessizce ölen düğümü yakala
const sonuclar = (await parallel(isler)).filter(Boolean);   // düşen düğümler = null
if (sonuclar.length < isler.length) {
  flag(`UYARI: ${isler.length} düğümden ${isler.length - sonuclar.length} tanesi boş döndü`);
}
// eksik kümeyle sentez yapıp rapora "tamam" deme

8. Sana gerçekten gerekiyor mu?

Graf genişlik satın alır, daha iyi karar değil. Aynı anda yapılan bağımsız iş için bir araçtır. İş geniş değilse, sorun zaten çizgi değildi.

• İş küçük ya da tekilse. Tek fonksiyon eklemek, tek hata düzeltmek. Koordinasyon saf masraf; tek ajan daha hızlı ve daha ucuz.
• Her adımı onaylamak istiyorsan. Grafın bütün amacı sensiz genişlemek; kısa tasma tam tersine çalışır.
• Ne aradığını henüz bilmiyorsan. Keşif işi, plana kilitlenmiş bir filo değil, yönlendirebileceğin tek ajan ister.
• Adımlar gerçekten birbirine bağlıysa. Sıralı işe zorla graf giydirmek sıfır hızlanma karşılığında maliyet ekler.

Ölçüt yine sahte kenar testi. Aralarında kenar olmayan iki iş bulamıyorsan ortada graf yoktur. O bir döngüdür ve döngü gayet iyidir.

9. Kimsenin duymak istemediği kısım: çapalar

Burada daha derin bir tuzak var ve bu değişimin asıl dersi bu. Tam grafı kurduğunu düşün. Eşli kontrolcüler, denetim düğümleri, diğer düğümleri ayarlayan üst düğümler. Her düğüm başka bir düğümü izliyor ve hepsi bir rapor okuyor. Denetim, rakamları finans rakamlarıyla karşılaştırıyor; o rakamlar da zaten aynı sistemden geliyor.

Her şey tutarlı. Hiçbir şey doğrulanmamış. Bu graf, tek döngünün kırıldığı gibi kırılır: sadece daha geç, daha pahalı ve yolda çok daha fazla yeşil ışık yakarak.

Topoloji tek başına doğruluk satın almıyor. Grafın çapalara ihtiyacı var: tartışılamayacak düğümler. Gerçekten çalışmış testler, "geçmesi lazım" değil geçmiş olanlar. Bankaya giren gelir. Gerçekten kalan müşteriler. Ve bazı kurallar dondurulmalı: bir optimize edicinin gevşetmeye en çok hevesleneceği kurallar, tam da bu yüzden dokunulmaz olmalı.

Graf, içindeki kıpırdamayı reddeden şeyler kadar dürüsttür. Sana cevap veremeyen sayılarla ölçersen yerde kalır; kendi raporuna not vermesine izin verirsen kendinden emin şekilde yanılır.

10. Claude Code'da kendin bir tane kur

Teori bu kadar. Gerçek bir grafı birkaç dakikada kurabilirsin, çünkü Claude Code bunu doğrudan yapan araçları getirdi: dinamik workflow'lar.

Her şey tek kelimeye bakıyor: workflow. Bunu isteminin içine koyduğunda Claude tek sıra halinde ilerlemeyi bırakıyor, kısa bir düzenleme betiği yazıp onu çalıştıracak koordineli bir alt ajan filosu başlatıyor.

Önemli kısım koordinasyonun sohbet değil kod olması. Ajanlar arasında sonuç geçirmek, sohbet devri gibi bağlamını yeniden harcamıyor. Tek bir koşunun oturumu boğmadan bütün bir filoya ölçeklenmesinin sebebi bu.

Bildiğin gerçek bir depoyu aç ve şunu yapıştır:

▸ GRAF ŞARTNAMESİ
HEDEF: src/routes/ altındaki her rota dosyasında eksik yetki kontrolü ara

DAĞIT   : dosya başına bir ajan, hepsi paralel
DOĞRULA : her bulguya temiz bağlamlı bağımsız bir kontrolcü
SINIR   : bu ilk koşuda 20 dosya
HATADA  : dönmeyen dosyayı işaretle, sessizce atlama
RAPOR   : yetkisi eksik rotaların tek birleşik listesi

(istemi "workflow" kelimesiyle başlat ki Claude grafı kursun)

Çalıştırınca şu oluyor: önce Claude normal sohbet yerine bir workflow kurduğunu bildiriyor ve hiçbir şey yapmadan planı gösteriyor. Sen okuyup onaylıyorsun. Sonra filo çalışıyor; dosya başına bir ajan, hepsi aynı anda, senin oturumun boyunca serbest kalıyor.

Sonunda eline yirmi ayrı sohbet değil tek rapor geçiyor. Ara sonuçlar betiğin içinde yaşadı, senin bağlamına hiç girmedi. Bir koşu iyi çıktığında kaydediyorsun ve o graf, adıyla tekrar çağırabileceğin tek bir komuta dönüşüyor.

O istemdeki "20 dosya" sınırını fark et. İlk koşunu ucuz tutuyor ve her demonun atladığı şeye işaret ediyor: fatura.

11. Hemen yapıştırabileceğin hazır graflar

Bunların hepsi aynı elmasın farklı işe çevrilmiş hali. Claude Code'u gerçek bir klasörde aç, köşeli parantezleri kendi işinle değiştir ve yapıştır. Son onay her zaman sende kalsın.

▸ GRAF ŞARTNAMESİ
HEDEF: [sorun] hakkında karar verilebilir seviyede araştırma

DAĞIT       : 5 farklı açıya böl, açı başına bir araştırmacı, paralel
KURAL       : her bulgunun kaynak linki ve tarihi olacak
DOĞRULA     : bir şüpheci her bulguyu çürütmeye çalışsın, düşenler elensin
BİRLEŞTİR   : hayatta kalanları güven sırasına göre tek rapora
KAYDET      : arastirma-raporu.md, sonra en güçlü bulguları göster
İNSAN KAPISI: ondan sonra bana sormadan hiçbir şeyi değiştirme

▸ GRAF ŞARTNAMESİ
HEDEF: [konu] için yayına hazır tek taslak

PARALEL İŞLER (aynı anda):
  1. şu an üst sıradaki sayfalar neyi kapsıyor
  2. insanların bu konuda gerçekten sorduğu sorular
  3. o sayfaların atladığı şeyler
BİRLEŞTİR   : üçünü bir taslak planına çevir, sonra tam metni yaz
DOĞRULA     : kaynağı olmayan her iddiayı işaretleyen bir denetçi
KAYDET      : taslaklar/ klasörüne, işaretli iddialar en üstte
İNSAN KAPISI: hiçbir şey yayınlama

▸ GRAF ŞARTNAMESİ
HEDEF: bütün repoda 100 satırdan uzun her fonksiyonu bul ve sadeleştirme öner

DAĞIT   : dosya başına bir ajan, paralel
DOĞRULA : her öneriye temiz bağlamlı bağımsız kontrolcü
TEKİLLE : önerileri daha önce görülenlere karşı ayıkla
SINIR   : ilk koşuda 50 dosya
RAPOR   : kaç dosyanın döndüğünü yaz, hiçbir şey sessizce düşmesin

Bir tanesini dar kapsamla çalıştır, ne tuttuğunu gör, sonra genişlet. İyi çıkan koşuyu kaydettiğinde her biri adıyla başlattığın tek komuta dönüşüyor.

12. Maliyet ve gözetim

Graf normal bir sohbetten pahalıdır. Hem de epey. Ucuzlayan şey koordinasyon, işin kendisi değil. Ajanlar hâlâ token yakıyor ve bir filo bunu yığınla yakıyor.

En net örnek herkese açık. Bir mühendis tam olarak bu kurguyla Bun çalışma zamanını yeniden yazdırdı: yaklaşık 535 bin satır bir dilden 1 milyon satırın üzerinde başka bir dile, yaklaşık 11 günde. Elle yapılsa bir yıla yakın iş.

Üstelik işi tasarlayan ve baştan sona izleyen bir insan gerekti; o kadar yapay zeka yazımı kodun güvenle incelenip incelenemeyeceği de ciddi biçimde eleştirildi.

İşin dürüst hali bu. Graf, bin ajana dağılıp tek bağlamın taşıyamayacağı bir işi çiğneyebilir. Yanlış işe yöneltirsen ya da çapaları atlarsan arka planda sessizce paranı da harcayabilir. Ağır sürüm; bütçesi, sınırları ve izlemesi olan ekipler için. Bu sen değilsen hiçbir şey kaçırmıyorsun: küçük başla, bir koşunun ne tuttuğunu gör, ancak hak edince genişlet.

13. Bu senin için ne anlama geliyor?

Resmin tamamı bu. Grafın ne olduğunu, nerede parladığını, nerede kırıldığını ve kimin için olduğunu biliyorsun. Gücü genişlik: aynı anda yapılan bağımsız iş. Zayıflığı ise genişlik satın alması, karar değil, ve yanlış işe yöneltilirse para harcaması.

Yani hamle her şeyi graflamak değil. İşin ne zaman graf gerektirecek kadar geniş olduğunu, ne zaman basit bir döngünün baştan beri doğru cevap olduğunu bilmek.

Benim önerim: sahte kenar testini bu akşam öğren. Şu an kullandığın akışı çiz, veri taşımayan kenarları bul ve sil. Tek başına bu hareket, yeni bir araca dokunmadan seni çoğu kişiden hızlı yapıyor.

Çoğu insan adımları sıraya dizmeye devam edecek. Grafı çizmeyi öğrenen birkaç kişi ise bir filo çalıştıracak.