Yapay zekayı kod yazmak için kullandığımı sanıyordum.
Aslında sadece daha hızlı yazıyordum.
İşte farkı — ve her şeyi değiştiren 7 ajanlı sistem.
Bunu kaydet. Aylarını kurtarır.
KİMSENİN KONUŞMADIĞI SORUN
Üretken gibi görünen ama olmayan döngü:
→ Claude'dan bir özellik yapmasını iste → Kod üretir → Bir şey bozulur → Hatayı geri yapıştır → Düzeltir → Başka bir şey bozulur → Tekrar iste
- Gün: bu sihir gibi geliyor.
- Gün: Eskiden kod yazmaya harcadığından daha fazla zamanı yapay zekayı denetlemeye harcıyorsun.
Aynı mantık 3 farklı yerde karşısına çıkıyor.
Claude, iki hafta önce belirlediğin kuralı unutuyor.
Yeni özellikler eskilerini bozuyor.
Testler eksik veya yüzeysel.
Uyanıyorsun ve fark ediyorsun: başarısız olan yapay zeka değil.
Senin iş akışın.
Asıl sorun yapısal.
Claude Code'a "bu özelliği yap" yazdığında, tek bir yapay zeka oturumundan şunları yapmasını istiyorsun:
→ Ürün analisti → Mimar → Backend mühendisi → Frontend mühendisi → Test mühendisi → Kod incelemecisi
Hepsi aynı anda.
Aynı dağınık konuşmada.
Plandaki yanlış varsayımlar, yanlış veritabanı modellerine dönüşür.
Yanlış veritabanı modelleri, yanlış API'lere dönüşür.
Yanlış API'ler, yanlış arayüzlere dönüşür.
Fark ettiğinde, hata her yere yayılmış olur.
Buna vibe coding deniyor.
Ve bunun sert bir tavanı var.
DÖNÜŞÜM: VIBE CODING'DEN BİR YAZILIM FABRİKASINA
Her şeyi gerçekten değiştiren şey:
Gerçek mühendislik ekipleri tek bir büyük konuşmada çalışmaz.
Farklı kişiler farklı işlere sahiptir:
→ Biri kullanıcı sorununu netleştirir → Biri mimariyi düşünür → Biri API'yi kurar → Biri arayüzü kurar → Biri uç durumları düşünür → Biri inceleme yapar
Bunların hepsini tek bir yapay zeka oturumuna sıkıştırdığında, hatalar sessizce birikir.
Çözüm, işi uzmanlaşmış ajanlar arasında bölmektir.
Her ajan şunları alır: → Tek bir odaklı iş → Kendi temiz bağlam penceresi → Yalnızca gerçekten ihtiyaç duyduğu araçlar → Dokunamayacağı şeylerle ilgili katı kurallar
Sonuç: bir yazılım fabrikası.
Bir geliştirici + yedi odaklı ajan = koordineli bir ekip.
İşte bunu mümkün kılan yedi ajan.
7 AJAN
Ajan 1: Kod Tabanı Araştırmacısı
Geliştiricilerin yapay zeka ile yaptığı en büyük hata mı?
İlk hamle olarak kod istemek.
Yapay zeka istemi kabul eder, boşlukları doldurmak için tahminler yapar ve üretmeye başlar.
İşte o zaman kötü tasarımlar sızar.
Kod Tabanı Araştırmacısı bunu düzeltir.
Tek işi: tek bir satır kod yazılmadan önce kod tabanını incelemek ve işlerin nasıl yürüdüğünü açıklamak.
Yaptıkları: → İlgili dosyaları ve rollerini haritalar → Takip edilecek mevcut kalıpları belgeler → Halihazırda oluşturulmuş benzer özellikleri bulur → Riskleri işaretler (saat dilimi, çok kiracılı, yeniden deneme mantığı) → Hangi testlerin güncellenmesi gerektiğini listeler
Yapamayacakları: → Dosyaları düzenlemek (yalnızca salt okunur erişim) → Durumu değiştiren herhangi bir komutu çalıştırmak → Varsayımlarda bulunmak — bunun yerine sorar
Araçlar: Yalnızca Oku, Grep, Glob.
Kural: her seferinde, inşa etmeden önce keşfet.
Araştırmacı önce çalışır. Her zaman.
Ajan 2: Hikaye Yazarı
Çoğu özellik, kod yanlış olduğu için başarısız olmaz.
Ama sorun asla net bir şekilde tanımlanmadığı için.
Hikaye Yazarı, herhangi bir teknik karar verilmeden önce kaba bir özellik fikrini gerçek bir kullanıcı hikayesine dönüştürür.
Aldığı girdi: → Kaba özellik tanımın → Araştırmacının bulguları
Ürettikleri:
Bir kullanıcı hikayesi:"Bir [rol] olarak, [davranış] istiyorum, böylece [sonuç]."
Kabul kriterleri:Bir testin doğrudan doğrulayabileceği ifadeler. Mutlu yol. Başarısızlık yolları. İş kuralları.
Uç durumlar:Sınırlar, yeniden denemeler, çok kiracılı endişeler.
Kapsam dışı:Açıkça inşa EDİLMEYEN şeyler.
Açık sorular:Gerçekten bilmediği şeyler — asla tahmin etmez.
Yapamayacakları: → İş kuralları icat etmek → Herhangi bir kod veya teknik tasarım yazmak → Bir şey gerçekten net değilse ilerlemek
Araçlar: Yalnızca oku.
Kural: başka hiçbir şey olmadan önce bu hikayeyi okur ve onaylarsın.
Bu, aşağı akıştaki her şeyi kurtaran insan kontrol noktasıdır.
Ajan 3: Şartname Yazarı
Hikaye onaylandıktan sonra, Şartname Yazarı onu bir teknik brife dönüştürür.
Bu, her inşa ajanının takip ettiği plandır.
Aldığı girdi: → Onaylanmış kullanıcı hikayen → Araştırmacının bulguları → Projenin CLAUDE.md kuralları
Ürettikleri:
→ Veri modeli değişiklikleri (alanlar, türler, geçişler) → Arka plan akışı / süreç akışı → API değişiklikleri (uç noktalar, istek/yanıt şekilleri) → Frontend değişiklikleri (bileşenler, sayfalar, hook'lar) → Gerekli testler (başarı, başarısızlık, uç durumlar) → Riskler ve açık sorular → Değişecek her dosya
Yapamayacakları: → Herhangi bir dosyayı düzenlemek → Yeni altyapı icat etmek — bunun yerine açıkça belirtir → Kiracı izolasyonu veya saat dilimi endişelerini atlamak → Soruları cevapsız bırakmak
Araçlar: Yalnızca Oku, Grep, Glob.
Kural: bu brif, ikinci insan kontrol noktasıdır.
Tek bir dosyaya dokunulmadan önce onu okur ve onaylarsın.
"Kimlikleri bellekte sakla" görürsen — bu senin kırmızı bayrağın.
Şimdi yakala. 10 dosya değiştirildikten sonra değil.
Ajan 4: Backend Oluşturucu
Şimdi inşa başlıyor.
Backend Oluşturucu, özelliğin backend yarısını uygular — ve yalnızca backend yarısını.
Aldığı girdi: → Onaylanmış teknik brif → Araştırmacının bulguları → Projenin CLAUDE.md'si
İnşa ettikleri: → API rotaları → Servisler ve iş mantığı → Veritabanı erişimi ve geçişler → Arka plan işleri → Yazdığı her şey için birim testleri
Yapamayacakları: → React bileşenlerine, sayfalara veya istemci tarafı hook'larına dokunmak (bu Ajan 5'in işi) → Talimat olmadan yeni bağımlılıklar icat etmek → Kararlaştırılan kapsam dışındaki dosyaları değiştirmek → Typecheck, lint ve test paketini çalıştırmadan durmak
Bitirdikten sonra bir özet döndürür: → Eklenen veya düzenlenen her dosya → Yeniden kullanılan her mevcut yardımcı veya desen → Yardımcı olabilecek herhangi bir CLAUDE.md kuralı
Araçlar: Oku, Düzenle, Yaz, Bash — yalnızca backend klasörleriyle sınırlıdır.
Ayrım olayın özüdür.
Backend Oluşturucu asla yanlışlıkla frontend'i bozamaz. Asla.
Ajan 5: Frontend Oluşturucu
Frontend Oluşturucu, arayüz yarısını uygular — ve yalnızca arayüz yarısını.
Önce Backend Oluşturucu'nun özetini okur.
Bu önemlidir.
API'yi backend'in ürettiği gibi tüketir.
Yeni uç noktalar icat etmez.
API şekli arayüz için yanlışsa, uyumsuzluğu bir yama olarak değil, geri bildirim olarak yüzeye çıkarır.
Aldığı girdi: → Onaylanmış teknik brif → Araştırmacının bulguları → Backend Oluşturucu'nun özeti (API sözleşmesi)
İnşa ettikleri: → React bileşenleri ve sayfalar → İstemci tarafı hook'lar ve durum → Yükleme ve hata durumları → Yazdığı her şey için bileşen ve birim testleri
Yapamayacakları: → Servislere, API rotalarına, çalışanlara veya geçişlere dokunmak (bu Ajan 4'ün işi) → Uç noktalar veya yanıt şekilleri icat etmek → Talimat olmadan bağımlılık eklemek → Typecheck, lint ve test paketini çalıştırmadan durmak
Araçlar: Oku, Düzenle, Yaz, Bash — yalnızca frontend klasörleriyle sınırlıdır.
İki oluşturucu.
İki temiz bağlam penceresi.
Birinin diğerinin işini bozma şansı sıfır.
Ajan 6: Test Doğrulayıcı
Her iki oluşturucu da kendi kodları için birim testleri yazdı.
Bu yeterli değil.
Test Doğrulayıcı yalnızca bir şey yapar: özelliğin gerçekten kullanıcı hikayesinin söylediği gibi çalıştığını kanıtlamak.
Kabul testleri yazar.
Birim testleri değil.
Kabul testleri.
Bunlar özelliği dışarıdan test eder — gerçek bir kullanıcının deneyimleyeceği şekilde.
Aldığı girdi: → Onaylanmış kullanıcı hikayesi (tüm kabul kriterleriyle birlikte) → Onaylanmış teknik brif → Her iki oluşturucunun özetleri
Ürettikleri: → Her kabul kriterini kapsayan bir kabul test dosyası → Bir rapor: hangi kriterler geçti, hangileri kaldı, hangileri temiz bir şekilde kapsanamıyor
Yapamayacakları: → Herhangi bir backend veya frontend kodunu değiştirmek → Test edilemeyen kriterler için geçici çözümler icat etmek → Gerçekten kapsanmıyorsa bir kriteri kapsanmış olarak işaretlemek
Bir test başarısız olursa: özellik hikayeyi karşılamıyor demektir.
Tam olarak hangi kriterin başarısız olduğunu bildirir.
Kodu yamamaz.
Bu, doğru oluşturucuya geri gider.
Araçlar: Oku, Düzenle, Yaz (yalnızca test dosyaları), Bash.
Kural: kabul testleri geçene kadar bir özelliğin yok.
Ajan 7: Uygulama Doğrulayıcı
Bu, herkesin kaçırdığı her şeyi yakalayan ajandır.
Doğrulayıcı, mevcut uygulamayı onaylanmış hikaye ve brif ile karşılaştırır — ve boşlukları rapor eder.
Asla bir şeyi düzeltmez.
Sadece gerçeği söyler.
Her seferinde çalıştırdığı her kontrol:
→ Hikayedeki henüz uygulanmamış kabul kriterleri → Test kapsamı olmayan başarısızlık yolları → Güvenlik sorunları: eksik kimlik doğrulama kontrolleri, kiracı izolasyonu boşlukları, günlüklerdeki sırlar, istemcilere maruz kalan ham hatalar → Kararlaştırılan kapsam dışında değiştirilen dosyalar → CLAUDE.md veya mevcut kodla tutarsız desenler → Mevcut yardımcıları yeniden kullanması gereken yinelenen mantık → Sessizce atlanan brifteki saat dilimi veya çok kiracılı endişeler
Çıktı her zaman ciddiyete göre gruplandırılır:
Kritik — birleştirmeden önce düzeltilmelidir Önemli — birleştirmeden önce düzeltilmelidir Küçük — görüşe dayalı, incelemecinin kararı
Her bulgu, dosya yolunu ve satır numarasını içerir.
Yanlış bir şey yoksa, açıkça söyler.
Kapsamlı görünmek için sorunlar icat etmez.
Araçlar: Yalnızca Oku, Grep, Glob.
Bu ajan, fabrikanın güvenilir olmasının nedenidir.
Kendi kendine not verilen bir kağıt değersizdir.
Yalnızca diskte olanı gören bir doğrulayıcı — nasıl yazıldığını değil — dürüsttür.
ZİNCİR NASIL ÇALIŞIR
Tam akış — tek bir istem her şeyi başlatır:
Claude Code'u açarsın ve şunu yazarsın:
"7 günden uzun süredir ödenmemiş faturalar için fatura hatırlatıcıları oluşturun."
İşte başka bir şey yazmadan olanlar:
Adım 1 → Araştırmacı fatura, ödeme ve e-posta kodunu haritalar. İlgili dosyaları, mevcut desenleri, riskleri döndürür.
Adım 2 → Hikaye Yazarı kullanıcı hikayesini ve kabul kriterlerini üretir.
⏸ DURAKLAMA: Hikayeyi okur ve onaylarsın.
Adım 3 → Şartname Yazarı onaylanmış hikayeyi bir teknik brife dönüştürür.
⏸ DURAKLAMA: Brifi okur ve onaylarsın.(Tam burada "kimlikleri bellekte sakla" hatasını yakala.)
Adım 4 → Backend Oluşturucu servisi, API rotasını, BullMQ işini ve birim testlerini uygular. Döndürür: değiştirilen dosyalar, yeniden kullanılan desenler, tüm testler yeşil.
Adım 5 → Frontend Oluşturucu Backend Oluşturucu'nun API özetini okur, yönetici arayüzü karonunu ve hatırlatma düğmesini oluşturur, bileşen testlerini yazar. Tüm testler yeşil.
Adım 6 → Test Doğrulayıcı altı kabul kriterinin tümü için kabul testleri yazar. Raporlar: 7 geçti, 1 kaldı — manuel tetikleyici kiracı sahipliğini kontrol etmiyor.
Adım 7 → Doğrulayıcı onu bulur. Dosya yolu ve satır numarasıyla Kritik olarak raporlar.
→ Backend Oluşturucu'ya geri döngü. Düzeltme uygulandı. 8 kabul testinin tümü geçti. Doğrulayıcı tekrar çalışır. Temiz.
⏸ DURAKLAMA: İnceleyip PR'ı açarsın.
Üç insan kontrol noktası.
Diğer her şey kendi kendine çalışır.
TEMEL: AJANLAR ÇALIŞMADAN ÖNCE BUNA İHTİYACIN VAR
CLAUDE.md — her oturumda hayatta kalan bellek:
Claude Code'u her açtığında, sıfır bellekle başlar.
CLAUDE.md bunu düzeltir.
Depo kökünde bulunan ve her oturumda otomatik olarak yüklenen bir Markdown dosyasıdır.
Kalıcı proje bilgilerinin yaşadığı yerdir:
→ Yığının (Next.js App Router, Node.js, Prisma, BullMQ, Resend) → Komutların (npm run dev, npm test, npx prisma migrate dev) → Mimari kurallar ("İş mantığı servislerde yaşar. API rotaları ince kalır.") → Ne yapılmaması gerektiği ("Cron eklemeyin — BullMQ kullanın. Ham ödeme yüklerini günlüğe kaydetmeyin.") → Daha derin belgelere işaretçiler (docs/billing.md, docs/architecture.md)
100-300 satır arasında tut.
Yapay zeka seni şaşırtan bir hata yaptığında kendine sor: CLAUDE.md'deki bir kural bunu engeller miydi?
Kuralı ekle.
Birkaç hafta içinde, CLAUDE.md'in yapay zekanın yanlış anladığı her varsayımın bir kaydı haline gelir — ve oturumların gözle görülür şekilde iyileşir.
Bağlam kayması — sessiz katil:
Çoğu Claude Code oturumu dramatik bir şekilde başarısız olmaz.
Kayarlar.
Bağlama yanlış bir varsayım girer.
Model onun üzerine inşa etmeye devam eder.
Claude'dan abonelik yönetimi oluşturmasını istersin.
Tasarlar: Kullanıcı → Abonelik.
Hatırlarsın: abonelikler kullanıcıya değil, şirkete aittir.
Sadece "hayır, abonelikler şirketlere ait" dersen — Claude yama yapar.
Şimdi hem user.subscriptionId hem de company.subscriptionId ortalıkta dolaşıyor.
Kural:
→ Küçük yazım hatası mı? Satır içinde düzelt. → Yanlış mimari varsayım mı? Konuşmayı at ve doğru varsayımı ilk isteme yerleştirerek sıfırdan başla.
Doğru zihinsel modele sahip temiz bir oturum, yamalı bir oturumu her zaman yener.
SONUÇLAR: GERÇEKTEN DEĞİŞEN ŞEYLER
Fabrikadan önce:
→ Vibe coding döngüsü: istem → üret → hata → yama → tekrarla → Oturum bağlamı gürültüyle dolar → Yanlış varsayımlar bozuk özelliklere dönüşür → Bir mühendis aynı anda yalnızca bir şey yapabilir → Her özellik doğru kişinin müsait olmasını bekler
Fabrikadan sonra:
→ Yapılandırılmış zincir: araştırma → hikaye → brif → inşa → doğrula → onayla → Her ajan, yalnızca ihtiyacı olanla temiz bir bağlam penceresi alır → Yanlış varsayımlar, 10 dosyadan sonra değil, brif onayında yakalanır → Bir mühendis, tam bir dikey dilim gönderir: backend, frontend, testler, doğrulama → Ekibin en iyi bilgisi ajanlarda yaşar — insanlarda sıkışıp kalmaz
Gerçek değişim:
Ödeme uzmanı, bir ödeme entegrasyon ajanı oluşturur.
Artık ekipteki her mühendis, faturalamaya dokunan bir özellik gönderebilir.
Beklemeden.
Bir devir teslim olmadan.
Frontend liderinin bileşen desenleri, frontend oluşturucu ajanda yaşar.
DevOps mühendisinin CI kontrolleri bir hook'ta yaşar.
QA liderinin uç durumları, test doğrulayıcı kurallarında yaşar.
Uzman bilgisi, ajanlar olarak paylaşılır.
Müsaitlikte sıkışıp kalmaz.
BU HAFTA SONU KENDİNİNKİNİ NASIL KURARSIN
8 adımlı kurulum kontrol listesi:
1. Claude Code'u yükle → code.claude.com
2. Klasör yapısını oluştur: → .claude/agents/ → .claude/skills/feature-factory/ → .claude/skills/build-with-tests/ → .claude/hooks/
3. CLAUDE.md'ini yaz (100–300 satır: yığın, komutlar, mimari kurallar, yapılmayacaklar listesi)
4. Claude Code'da /agents komutunu kullanarak 7 ajanı oluştur. Her ajanın rolünü tanımla. Claude dosyayı yazar. Sen inceler ve kaydedersin.
5. Özellik fabrikası orkestratör becerisini oluştur. Claude'dan yazmasını iste — 7 ajan dosyanı okur ve zinciri bağlar.
6. Build-with-tests becerisini oluştur. Ekibinin nasıl inşa ettiğini açıklar: mevcut desenleri eşleştir, kodla birlikte test yaz, sonunda typecheck'i çalıştır.
7. Bir ön kayıt hook'u ekle. .env, .key, .pem veya secrets.json dosyalarını içeren kayıtları engeller. 5 dakika sürer. Felaketleri önler.
8. Tam zincirden geçen gerçek bir özellik çalıştır. Küçük bir şey seç. Nerede takıldığını izle. Kurallar ekle. Fabrika kendini ayarlar.
Toplam süre: 2–3 saat.
Ardından birkaç özellik çalıştır.
3-4'ten sonra fabrika kod tabanını tanır.
Denetlemeye daha az zaman harcayacaksın.
Sırada ne inşa edeceğine karar vermek için daha fazla zaman.
7 AJAN — HIZLI BAŞVURU
→ Araştırmacı — bir şey inşa edilmeden önce kodu haritalar (Yalnızca oku) → Hikaye Yazarı — fikri kabul kriterleriyle birlikte kullanıcı hikayesine dönüştürür (Yalnızca oku) → Şartname Yazarı — hikayeyi teknik brife dönüştürür (Yalnızca oku) → Backend Oluşturucu — API, servisler, işler, birim testleri oluşturur (yalnızca backend klasörleri) → Frontend Oluşturucu — bileşenler, sayfalar, hook'lar, arayüz testleri oluşturur (yalnızca frontend klasörleri) → Test Doğrulayıcı — kullanıcı hikayesine karşı kabul testleri yazar (yalnızca test dosyaları) → Doğrulayıcı — uygulamayı hikaye ve brif ile karşılaştırır, boşlukları rapor eder (Yalnızca oku)
3 insan kontrol noktası:→ Hikayeyi onayla → Brifi onayla → PR'ı onayla
Diğer her şey kendi kendine çalışır.
Claude Code kullanan çoğu geliştirici hala vibe coding yapıyor.
İstemek → üretmek → yamamak → ummak.
Bu yanlış değil.
Bu sadece bir tavan.
Fabrika seni süreçten çıkarmaz.
Seni sana ihtiyaç duyulmayan kısımlardan çıkarır.
Yargının önemli olduğu döngüde kalırsın:
Bu doğru sorun mu? Bu doğru tasarım mı? Bunu göndermek güvenli mi?
Ajanlar aradaki her şeyi halleder.
Yapay zekayı daha hızlı bir klavye olarak kullanmak ile —
yapay zekayı koordineli bir ekip olarak kullanmak arasındaki fark budur.
Bu faydalıysa:
→ Ağınla paylaşmak için tekrar paylaş → Daha fazla böyle dökümler için @sairahul1'i takip et → Bunu yer imlerine ekle — 7 ajana başvurmak isteyeceksin
Yapay zeka, ürün oluşturma ve sen uyurken çalışan sistemler hakkında yazıyorum.
