লেকচারের অংশ

AI Ajanları İçin feature_list.json: WIP=1, Özellik Durumları ve verify.sh Doğrulaması

AI kodlama ajanını aynı anda tek göreve sınırlamak (WIP=1): özellik durumlarıyla feature_list.json, görev granülerliği, passing durumunun tek kapısı olan scripts/verify.sh ve katı ile zayıf doğrulama.

WIP=1 görev granülaritesi (ayrıntı düzeyi) feature_list. özelliğin sonlu durum makinesi gate bekçisi (gate guard)
এই লেকচারে আপনি কী শিখবেন
  • WIP=1 kuralını uygulayacak ve tamamlanmamış paralel değişiklik sayısının nasıl düştüğünü gözlemleyeceksiniz.
  • Ajanın kendi kendine raporlaması yerine dürüst bir sonlu durum makinesiyle çalışan feature_list. yapısını kuracaksınız.
  • 'Passing' durumunu koyma yetkisine sahip tek script olan verify.sh dosyasını yazacaksınız.

লেকচারের শুরু

On iki dosya, sekiz yüz satır, sıfır hazır özellik

  • Talep tekti: “kayıt sistemini kur”
  • Ajan yolunda “bu arada” e-posta doğrulamasını, bcrypt'i ve middleware yeniden düzenlemesini de devreye aldı
  • Ortaya çıkan kod sıkı bağlı ama hiçbir senaryo baştan sona çalışmıyor
  • Sonraki oturum bu karmaşayı sıfırdan açıyor

Talep tam olarak tekti: kayıt sistemini kurmak. Peki pratikte nasıl altı ayrı yöne yayıldı? Ajan önce kullanıcı modelini oluşturuyor, sonra e-posta doğrulaması gerektiğine karar verip e-posta servisini bağlıyor, parola hash'lemeyi hatırlıyor, ayrı bir kütüphane çekiyor, tutarsız hata yönetimini fark ediyor ve middleware'i yeniden düzenliyor; bir yandan da test yapısını derli toplu hale getiriyor. Altı yön, her biri yarım, hepsi birbirine sıkı bağlı — ve tek bir uçtan uca koşum yok. Sonraki oturum bu kodu açıyor ve nereden başlayacağını bilmiyor.

Metafor değil, aritmetik

  • C — ajanın kullanılabilir bağlam kapasitesi
  • k — aynı anda aktif görev sayısı
  • Her göreve yaklaşık C/k oranında akıl yürütme kaynağı düşer
  • C/k minimum seviyenin altına düştüğü an — hiçbir görev sonuna kadar götürülemez

Bu bir metafor değil, aritmetik. Ajanın kullanılabilir bağlam kapasitesini C harfiyle, aynı anda aktif görev sayısını ise k harfiyle gösterelim. Her göreve yaklaşık C'nin k'ye bölümü kadar akıl yürütme kaynağı düşer. Bu değer, tek bir görevi sonuna kadar götürmek için gereken asgari eşiğin altına düştüğü anda, hiçbir görev tamamlanmaz. Ajan aynı anda ne kadar çok görev tutarsa, en az birinin gerçekten tamamlanma ihtimali o kadar azalır.

Tuzak: tek talep altı projeye dönüşüyor

  • ❌ Ajan, “bu arada şunu da düzeltelim” demeyi bedava bir işlem olarak görür ve çoğu zaman tam olarak böyle yapar: e-posta servisi, bcrypt, middleware yeniden düzenlemesi, testlerin yeniden yapılandırılması — hepsi tek bir görevin kapsamında
  • ✅ Tek talep = tek iş dalı; yol boyunca fark edilen her şey BACKLOG.md'ye yazılır, mevcut kapsama değil

“Bu arada şunu da düzeltirim” — bir ajanın sözlüğündeki en pahalı cümle. Kayıt sistemi isteniyor; ajan da zaten kodun içinde olduğu için bu arada hata yönetimini düzeltiyor, bu arada e-posta doğrulamasını bağlıyor, bu arada testleri derli toplu hale getiriyor. Bu “bu arada”ların her biri ajana neredeyse bedava görünüyor. Üstüne sürekli basılan tuzak tam olarak bu: kapsamı genişletmek ajana neredeyse sıfır token'a mal oluyor, ama proje için bedeli gerçek. Doğru hamle başka: tek talep, tek iş dalı; geri kalan fark edilenler ayrıca kaydedilir ve dokunulmaz.

পূর্ণ লেকচার সাবস্ক্রিপশনে পাওয়া যায়

পূর্ণ সংস্করণে আরও 23 টি স্লাইড আছে।

সাইন ইন ও সাবস্ক্রাইব করার পর ভিডিও, সব স্লাইড, নোট, পরীক্ষা, AI টিউটর ও ইন্টারভিউ খুলে যাবে।

সাইন ইন বা নিবন্ধন করুন সাবস্ক্রাইব করুন

লেকচারের বিষয়সূচি

  1. On iki dosya, sekiz yüz satır, sıfır hazır özellik
  2. Metafor değil, aritmetik
  3. Tuzak: tek talep altı projeye dönüşüyor
  4. Mit: daha çok kod, daha çok ilerleme
  5. Ajanın frenleri yok
  6. Kural #1: AGENTS.md'de zorunlu WIP=1
  7. BACKLOG.md — “bu arada” dürtüsü için emniyet ventili
  8. “Bitti” bir komuttur, his değil
  9. Kapsam dışarıya, dosyaya
  10. VCR: ajanı dizgininde tutan metrik
  11. ❓ Sıra sizde: “sepet oluştur”u WIP=1 kuantalarına bölün
  12. 💡 Ne çok geniş ne çok dar: özelliğin doğru boyutu
  13. Özellik = oturum = commit = senaryo: boyut testi
  14. WIP=1 devrede. Ama neyin bittiğini kim hatırlıyor?
  15. 📖 “Sepet neredeyse hazır ama buglar var” — kimin için neredeyse?
  16. Özellik listesi — harness'ın omurgası, bir hatırlatma notu değil
  17. Üç alan: bunlar olmadan özellik kaydı yalnızca boş söz
  18. Bir özelliğin yalnızca dört durumu var — ve fazladan tek bir geçiş bile yok
  19. passing kapısı: ajan talep edebilir ama ilan edemez
  20. Özellik listesi kuralları da AGENTS.md'de
  21. İki seviyeli kontrol: önce genel, sonra özel
  22. İki seviyeli kontrol: önce genel, sonra özel
  23. «Fonksiyon mevcut» demek, onun çalıştığı anlamına gelmez
  24. Bir özelliğin kuyruktan passing'e uzanan yolu: takılıp kalınabilecek üç nokta
  25. Frenleri agent değil, harness basıyor
  26. Frenleri agent değil, harness basıyor

এই লেকচারের সম্পর্কিত নিবন্ধ

এই কোর্সের সব লেকচার

  1. Harness Engineering Nedir? AI Kodlama Ajanı Modelden Değil, Ortamdan Neden Çöker
  2. AI Ajanında Hata Birikimi: Adım Başına %95 Doğruluk Neden 10. Adımda Başarısız Olur
  3. AI Ajan Güvenilirlik Metrikleri: MTBF, MTTR, Patlama Yarıçapı ve Little Yasası
  4. AI Ajanı Üretimde Neden Çöker: Beş Hata Katmanı ve Teşhis Döngüsü
  5. AI Ajan Harness'ı Neyden Oluşur: Talimatlar, Araçlar, Ortam, Durum, Geri Bildirim
  6. AI Kodlama Ajanları İçin Depo Haritası: Oturumlar Arası Hafızasız Proje Yapısı
  7. AGENTS.md En İyi Uygulamaları: Dev Talimat Dosyası Neden Çalışmaz, Yönlendirici Nasıl Kurulur
  8. AI Ajanı Oturumlar Arası Hafıza: Oturum Devri, PROGRESS.md ve Başlangıç Sözleşmesi
  9. AI Ajanları İçin feature_list.json: WIP=1, Özellik Durumları ve verify.sh Doğrulaması
  10. Ajan 'Hazır' Dedi, Özellik Çalışmıyor: Doğrulama Boşluğu ve Definition of Done
  11. Tüm Testler Yeşil, Özellik Bozuk: AI Ajanları İçin E2E Testler ve Mimari Kurallar
  12. AI Ajanı Gözlemlenebilirliği: Sprint Sözleşmesi, Değerlendirici Rubriği ve Temiz Oturum Çıkışı
  13. AI Ajanını Saatlerce Denetimsiz Çalıştırmak: Loop Engineering ve Durdurma Koşulları
  14. AI Ajanları İçin Graph Engineering: Tek Döngü Yetmediğinde Görev Grafiği
  15. AI Ajan Harness'ını Sıfırdan Kurmak: AGENTS.md, feature_list.json, verify.sh ve Otonom Döngü