Audit de Contexte Agent : Quand Votre Propre Gouvernance Devient le Problème — et Comment la Réparer sans Rien Perdre

30 Nisan 2026, 16.00. Tam bir oturumun ortasındayım`magic-stick`, Linux canlı ISO derleme projem. Opencode ajanı Eager dosyalarımı her zamanki gibi otomatik olarak yükledi —AGENT.adoc, PROMPT_REPRISE.adoc, .agents/INDEX.adoc. Her şey normal.

Ancak yanıtlar cansız. Ajanın akıl yürütmesi iki saniye daha uzun sürüyor. Üç mesaj önce gözünün önünde olan bir ayrıntıyı unutuyor. Bu bir çökme değil, bir hata değil — yavaş bir bozulma, hemen fark edilmeyen türden.

Bunu 048 numaralı oturumda zaten yaşamıştım; yönetişim dosyalarının toplamda 5200 satır olduğunu keşfettiğimde. O zaman Hot/Warm/Cold mekanizmasını, 10 oturumluk kayan penceresi, aynı soğuk dalgaları ve iki tetikleyicili sensörüyle kavramsallaştırmıştım. Sorun çözülmüştü. Teoride.

Ama şu an 051. oturumdayız. Yedek rotasyonu gerçekten gerçekleşti — EAGER dosyaları 2087’den 500 satıra indi. Yine de bağlam hâlâ ağır. Bir şeyi kavrayamıyorum.

Bir terminal açıyorum ve şunu yazıyorum:

1414 satır. Yedekleme rotasyonu INDEX, SESSIONS_HISTORY ve COMPLETED_TASKS içinde iyi budama yapmış — temizler. Ama odada göremediğim bir fil var:627 satırtek bir dosyada.AGENT_MODUS_OPERANDI.adoc.

Bu dosya, Eager/Lazy stratejisini belgelemek için 1. oturumda yazdığım dosya. Yöntemin el kitabı bu. Ve tek başına EAGER bağlamının %44’ü haline geldi.

İroni tam. Bağlamdan tasarruf etmek için tasarlanan dosya, bağlamın başlıca tüketicisi hâline geldi. Sanki arabanızın kullanım kılavuzu motordan daha ağır.

Bölüm bölüm bir denetim yapmaya karar verdim. Silmek için değil — neyin EAGER’da olmayı hak ettiğini ve neyin bilgi kaybı olmadan başka bir yerde yaşayabileceğini anlamak için.

İşte …​ tam yapısı`AGENT_MODUS_OPERANDI.adoc`ve orada bulduğum şey:

Hüküm kesindir:

627 satır üzerinde,382 tanesi gürültü. Ve bu 382 satır her oturum başında yükleniyor, ajan tarafından tüketiliyor ve ben merhaba demeden önce bile dikkatini seyreltiyor.

Bu diyagram her şeyin anahtarıdır. Yinelenenler (sarı) saf gürültüdür — ajan onları iki farklı dosyada iki kez okur. Hiç başvurulmayan (kırmızı) ölü dokümantasyondur — özenle yazılmış, hiç kullanılmamış. Yalnızca yeşil, ajanın başka yerde bulamayacağı bilgiyi içerir.

Bu aşamada, apaçık olan gözlerimin önünde: azaltmalıyım`AGENT_MODUS_OPERANDI.adoc`. Ama tereddüt ediyorum.

Bu dosyayı elle yazdım. Her bölüm, gerçek bir oturumda öğrenilen bir dersin sonucudur. P3 kısmı bir`rm -rf`üzerinde kazara`bakery-plugin`bana gerçek Firebase token’larına mal olan. P4 kısmı, arşivlemeyi unuttuğum ve ipin ucunu kaçırdığım on beş oturumun sonucudur. 6 adımlı prosedür bir kitaptan çıkmadı — acıdan çıktı.

Bu bölümleri silmek, kendi mühendisliğimin geçmişini çöpe atmak olur. Onları üreten dersler, onları keşfettiğim oturumlar, bir daha asla yapmak istemediğim hatalar. Bu metin değil — kristalleşmiş deneyim.

İşte tam burada çözüme yön verecek olan ilkeyi formüle ediyorum:

_ Asla silme. Her zaman yeniden konumlandır.Bilginin projeden kaybolmasına gerek yok. Sadece gereksiz olduğunda otomatik olarak yüklenmemesi yeterli. _

Önerdiğim model basit ve Vikipedi’nin nasıl büyüdüğünden ilham alıyor: Bir madde çok uzun hale geldiğinde onu kesmeyiz — ayrıntılı bir madde oluştururuz ve ana maddede bir özet tutarız.

için`AGENT_MODUS_OPERANDI.adoc`, bu şunu verir:

Ad`encyclopedies/`önemsiz değildir. Bir ansiklopedi arşiv dosyası değildir — o, düzenlenmiş bir bilgi koleksiyonudur; başvurulabilir ama taşınabilir değildir. Metroda Encyclopédie Universalis okunmaz. Onu kütüphanede tutarız ve belirli bir sorumuz olduğunda oraya gideriz.

Bu dosyanın rolü tam olarak şudur: ajanın otomatik olarak dokunmadığı, soğuk, yapılandırılmış, kapsamlı bir referans kütüphanesi.

Yeni dosya somut olarak şöyle görünüyor`LAZY_EAGER_ESSENTIALS.adoc`, P1 ve P2’den çıkarılmış ve sıkıştırılmış:

Elli satır. Ajanın mekanizmayı anlamak için ihtiyaç duyduğu tek şey bu. Geri kalan her şey — derslerin geçmişi, ayrıntılı benzetmeler, adım adım prosedürler, ekler — ansiklopedide yaşıyor.

Ve en önemlisi:hiçbir şey silinmedi. 627 mühendislik hattı hâlâ orada, içinde`.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc`. Onlar sadece çalışma tezgâhının üzeri yerine kitaplığa yerleştirilmiş.

Split’ten önce:

Split sonrasında:

En büyük tüketici (AGENT_MODUS_OPERANDI, 627 satır) 50 satırlık bir dosyayla değiştirildi. Kazanç anında: 577 satır bağlam serbest bırakıldı. Ajan nefes alıyor.

Ve içinde`.agents/encyclopedies/`, 627 satırlık orijinal dosya bekliyor. Eksiksiz. Tüm bölümleriyle — kopyalar da dahil, hiç kullanılmamış olanlar da dahil. Çünkü bir gün, daha iyi bir model ya da insan bir veri bilimci bu açıları, bu kabul edilmiş yinelemeleri, bu öğrenilmiş dersleri çaprazlamak isteyecek. Ve o gün, ham madde orada olacak.

Adın seçimi kozmetik değildir. Mekanizmanın felsefesini kodlar.

Bir arşiv (archives/) kronolojik olarak düzenlenmiş tarihsel veriler içerir — aylık COMPLETED_TASKS gibi. Bir yedek (backup/) zaman damgalı bir anlık görüntüdür — geçmiş bir durumun yedek kopyası.

Bir ansiklopedi başka bir şeydir. O, konuya göre yapılandırılmış, kapsamlı ama doğrusal olmayan bir tematik bilgi koleksiyonudur. Bir ansiklopedi baştan sona okunmaz. Belirli bir soruyu yanıtlamak için içine dalınır.

Bu, tam olarak bu dosyanın sözleşmesidir:

Bu ayrım, her şeyin bir araya tıkılmasını önler. Her dosya, ne içerdiğine göre nerede bulunması gerektiğini bilir; ne zaman oluşturulduğuna göre değil.

İlk iki makaleyi okuduysanız, üç parçanın nasıl birbirine oturduğu şöyle:

İlk makale yapıyı inşa etti. İkincisi yaşlanma mekanizmasını ekledi. Üçüncüsü içeriği denetliyor — ve metodolojinin kendisinin sorun hâline geldiğini keşfediyor.

Geriye dönüp baktığımda, başlangıçtaki tasarım hatasını görüyorum.`AGENT_MODUS_OPERANDI.adoc`tek bir belge olarak oluşturuldu — bir manifesto. Düşünceyi biçimselleştirmek için doğru yaklaşımdı. Ancak düşünce biçimselleştirildikten sonra belge hemen bölünmeliydi: temel kısım EAGER’da, kapsamlı kısım cold’da.

Bunu yapmadım çünkü belgeden gurur duyuyordum. Elle yazılmış 627 satır saf mühendislik, her bölüm bir oturum dersinin ürünü. Bu benim eserimdi. Ve her yazar gibi, onu bölmekte zorlandım.

Ders:Bir belgenin iyi olması, otomatik olarak yüklenmesi gerektiği anlamına gelmez.. İçeriğin kalitesinin, ajanın anlık bağlamına uygunluğuyla hiçbir ilgisi yoktur.

Bugün kural basit: EAGER bağlamında 100 satırdan uzun her belge bir şüphelidir. Bir denetimi hak eder. Mahkûmiyet değil — bir denetim. Ve soru asla « silinmeli mi? » değil, « her oturumda yüklenmeli mi? » olur.

İlk iki makaleyi takip ettiyseniz ve kendi Eager/Lazy yönetişiminizi kurduysanız, işte beş adımlı bir denetim prosedürü:

Bu prosedür 15 dakika sürer. 50 oturumluk bir projede, gelecekteki her oturumda yüzlerce token tasarrufu sağlar. ROI hemen kendini gösterir.

Bu üç makalelik dizinin bana öğrettiği şey, ajan yönetişiminin tamamlanmış bir ürün olmadığıdır. Bu bircanlı organizma. O, projeyle birlikte büyür. Büyüme hastalıklarına yakalanır. Düzenli kontroller gerektirir.

Oturum 048 arşivlerin şiştiğini ortaya çıkardı. Oturum 051 metodolojinin kendisinin şiştiğini ortaya çıkardı. Oturum 060 muhtemelen başka bir şeyi ortaya çıkaracak. Bu normal. Bu sağlıklı. Kendini asla sorgulamayan bir yönetişim ölü bir yönetişimdir.

Devreye alınan üç mekanizma — Eager/Lazy, Hot/Warm/Cold, ansiklopedik bölme — bağlam doygunluğuna karşı derinlemesine bir savunma sistemi oluşturur. Hiçbiri tek başına yeterli değildir. Birlikte birbirlerini tamamlarlar:

Bu üç katmanla, ajan bağlamı üzerinde`magic-stick`2087 satırdan (herhangi bir optimizasyondan önce) yaklaşık 800 satıra indi — 2,6’ya bölünme. Tek bir dokümantasyon satırını, tek bir oturum arşivini, tek bir öğrenilmiş dersi bile kaybetmeden.

Her şey burada. Sadece daha düzenli.

Bilginin yok olması gerekmiyor. Sadece gerekli olmadığında yüklenmemesi yeterli.