AI Ajanı Oturumlar Arası Hafıza: Oturum Devri, PROGRESS.md ve Başlangıç Sözleşmesi
AI kodlama ajanı projeyi oturumlar arasında nasıl hatırlar: sıkıştırma ile bağlam sıfırlama farkı, oturum devri (session handoff), PROGRESS.md, git kontrol noktaları, karar günlüğü, ılık başlangıç ve init.sh.
- Süreklilik artefaktlarını devreye alacak ve tekrar keşif için harcanan süreyi neredeyse sıfıra indireceksiniz.
- Ajansının hazır olup olmadığını tahmin etmeye değil, doğrulamaya dayanan bir bootstrap sözleşmesi tasarlayacaksınız.
- Kurtarma maliyetini önce ve sonra ölçecek — farkı rakamlarla göreceksiniz.
விரிவுரையின் தொடக்கம்
Dünü hatırlamak için on beş dakika
- Mühendis sabaha tamamen silinmiş bir hafızayla gelir
- Dahi, ama dünkü kararları hatırlamıyor
- Kodu yeniden okuması ve geçmişi çözmesi gerekiyor
- Bağlamını kaybeden ajan da aynı şekilde davranır
Her sabah işe, düne ait hafızası tamamen silinmiş olarak gelen bir mühendis düşünün. Dahi ama dün hangi mimari seçeneğin seçildiğini, diğerlerinin neden elendiğini, hangi dosyaların yeniden yazıldığını ve testlerin hangi durumda olduğunu hatırlamıyor. Kodu baştan okuması, geçmişi çözmesi gerekiyor; ancak ondan sonra işe devam edebiliyor. Bağlamını kaybeden ajan da tam olarak böyle davranır: on beş-yirmi dakika keşifle geçer, kararlar yeniden alınır — çoğu zaman dünkü çalışmaların tersine.
Ajan keşfi tekrarlar ve geçmiş kendisiyle tartışır
- Otuz dakikalık çalışma — ve bağlam tükendi
- Yeni oturum kararları, değiştirilen dosyaları, test durumunu bilmiyor
- On beş dakika tekrarlayan keşfe gidiyor
- İlacı hafızayı büyütmek değil, seyir defteri tutmak
Otuz dakikalık çalışma — ve ajan artık kendi kendisiyle tartışıyor. Özelliğin büyük bölümünü tamamladı, bağlam tükendi; yeni oturum hangi kararların alındığını, neden B seçeneğinin tercih edildiğini, hangi dosyaların değiştirildiğini ve testlerin hangi durumda olduğunu hatırlamıyor. On beş dakikayı tekrarlayan keşfe harcıyor ve büyük olasılıkla önceki yaklaşımla ters düşüyor. Buradaki doğru model, her sabah tam bir amneziyle uyanan dahi bir mühendistir. Ve bunun ilacı ajanın hafızasını büyütmek değil, bir seyir defteri tutmak: oturumlar arasındaki durumu sabitleyen bir dosya seti.
Bağlam penceresinin büyümesi sorunu neden çözmez
- Zor görevler bir milyon tokeni bile tüketir
- Kod, karar geçmişi, araç çıktıları, diyalog — hepsi büyüyor
- İhtiyaçlar, pencerelerin büyümesinden daha hızlı artıyor
- Bu bir hacim meselesi değil, mimari bir sorun
Bir sınav düşünün: ne kadar çok saat ayırırsanız ayırın, gerçekten zor bir soru yine de son dakikaya kadar vaktinizi yer. Ajanın bağlam penceresi de böyle: ona bir milyon token bile verin, zor bir görev onu da tüketir. Ajan kod tabanını okur, karar geçmişi biriktirir, araç çıktılarını alır ve tüm diyaloğu belleğinde tutar; bütün bunlar modellerin pencerelerinden daha hızlı büyür. Güvenilirlik, token limitini artırarak satın alınamaz — er ya da geç bu sınavın süresi dolacaktır. Mesele bunun gelecek olup olmadığı değil; o ana kadar ne hazırladığınızdır.
முழு விரிவுரை சந்தா மூலம் கிடைக்கும்
முழு பதிப்பில் மேலும் 24 ஸ்லைடுகள் உள்ளன.
உள்நுழைந்து சந்தா பெற்ற பிறகு வீடியோ, அனைத்து ஸ்லைடுகள், குறிப்புகள், தேர்வுகள், AI ஆசிரியர் மற்றும் நேர்காணல் திறக்கும்.
உள்நுழை அல்லது பதிவு செய் சந்தா பெறுவிரிவுரை உள்ளடக்கம்
- Dünü hatırlamak için on beş dakika
- Ajan keşfi tekrarlar ve geçmiş kendisiyle tartışır
- Bağlam penceresinin büyümesi sorunu neden çözmez
- Sıkıştırma 'neyi' korur, 'neden'i kaybeder
- Bağlam kaygısı: ajan, zil çalmadan önceki öğrenci gibi acele eder
- ❓ Dur-kontrolü: Sıkıştırmak mı, sıfırlamak mı?
- Sıkıştırmanın koruduğu, sıfırlamanın kökten sildiği
- Pratik ölçüt: pencerenin yüzde altmışı
- 💡 Analiz: yüzde kırk ve tek oturum — bu bir kompaksiyon
- Sürekliliğin dört artefaktı
- PROGRESS.md — şu anda nerede olduğumuz
- DECISIONS.md — neden böyle
- Git commit'leri: ücretsiz kontrol noktaları
- AGENTS.md'de vardiya protokolü: geliş ve gidiş
- On beş dakikaya karşı üç: amneziye ödediğiniz bedeli hesaplayın
- Tam bir handoff için yeterli olan dört alan
- Sıradaki: başlatmayı ayrı bir aşama olarak ele almak
- 🛠 'Arama ekle' deyince — ajan yarım saattir projeyle boğuşuyor
- Uygulama ve başlatma farklı şeyleri optimize eder
- Tuzaklar: doğrulanmadan biriken kod
- Bootstrap sözleşmesi: hazırlığın dört koşulu
- Mit: başlatma, başlangıçta zaman kaybıdır
- Mit: başlatma, başlangıçta zaman kaybıdır
- A yaklaşımı ile B yaklaşımı: dört oturumda kazanan kim?
- A yaklaşımı ile B yaklaşımı: dört oturumda kazanan kim?
- Uçtan uca proje: üçüncü adım — ödeme backend'inin seyir defteri
- Amneziden disipline — ve oradan kapsama
இந்தப் பாடம் தொடர்பான கட்டுரைகள்
- CLAUDE.md மற்றும் AGENTS.md: அவை என்ன, அவற்றில் என்ன எழுத வேண்டும், முகவர் விதிகளைப் புறக்கணிப்பது ஏன்
- Harness engineering என்றால் என்ன: AI முகவரை பயனுள்ள வேலைக் கருவியாக மாற்றுவது எப்படி
- AI முகவரை நம்பகமாக்குவது எப்படி: அளவீட்டிலிருந்து தானியங்கி வேலை வரை படிப்படியான திட்டம்
- முகவர் «முடிந்தது» என்றது, ஆனால் அம்சம் வேலை செய்யவில்லை: ஏன் நடக்கிறது, AI முகவரின் வேலையை எப்படிச் சரிபார்ப்பது
- Harness எதிர் context engineering: harness, prompt மற்றும் context engineering இடையிலான வேறுபாடு
இந்தப் படிப்பின் அனைத்து விரிவுரைகள்
- Harness Engineering Nedir? AI Kodlama Ajanı Modelden Değil, Ortamdan Neden Çöker
- AI Ajanında Hata Birikimi: Adım Başına %95 Doğruluk Neden 10. Adımda Başarısız Olur
- AI Ajan Güvenilirlik Metrikleri: MTBF, MTTR, Patlama Yarıçapı ve Little Yasası
- AI Ajanı Üretimde Neden Çöker: Beş Hata Katmanı ve Teşhis Döngüsü
- AI Ajan Harness'ı Neyden Oluşur: Talimatlar, Araçlar, Ortam, Durum, Geri Bildirim
- AI Kodlama Ajanları İçin Depo Haritası: Oturumlar Arası Hafızasız Proje Yapısı
- AGENTS.md En İyi Uygulamaları: Dev Talimat Dosyası Neden Çalışmaz, Yönlendirici Nasıl Kurulur
- AI Ajanı Oturumlar Arası Hafıza: Oturum Devri, PROGRESS.md ve Başlangıç Sözleşmesi
- AI Ajanları İçin feature_list.json: WIP=1, Özellik Durumları ve verify.sh Doğrulaması
- Ajan 'Hazır' Dedi, Özellik Çalışmıyor: Doğrulama Boşluğu ve Definition of Done
- Tüm Testler Yeşil, Özellik Bozuk: AI Ajanları İçin E2E Testler ve Mimari Kurallar
- AI Ajanı Gözlemlenebilirliği: Sprint Sözleşmesi, Değerlendirici Rubriği ve Temiz Oturum Çıkışı
- AI Ajanını Saatlerce Denetimsiz Çalıştırmak: Loop Engineering ve Durdurma Koşulları
- AI Ajanları İçin Graph Engineering: Tek Döngü Yetmediğinde Görev Grafiği
- AI Ajan Harness'ını Sıfırdan Kurmak: AGENTS.md, feature_list.json, verify.sh ve Otonom Döngü