ตัวอย่างบทเรียน

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 ติวเตอร์ และการสัมภาษณ์จะเปิดหลังเข้าสู่ระบบและสมัครสมาชิก

เข้าสู่ระบบหรือลงทะเบียน สมัครสมาชิก

เนื้อหาบทเรียน

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