26. Uzun Bağlam ve Büyük Belge Yönetimi

26.1 Üç Ayrı Sınır

"Bağlam sınırı" tek bir şey değildir. Uzun bir çalışmada birbirinden bağımsız üç sınırla karşılaşılır ve bunları ayırt etmemek yanlış çözüm üretir.

Birincisi Bölüm 1.7'de, ikincisi Bölüm 3.4'te ele alınmıştı. Üçüncüsü bu kitabın üretiminde defalarca yaşandı ve en az bilinen olanıdır.

Şekil 26.1 — Üç sınır farklı kaynaklardan doğar ve farklı çözüm gerektirir.

26.2 Pencere Sınırı

Güncel üst ve orta katman modellerde bağlam penceresi bir milyon token düzeyine ulaşmıştır. Bu, birkaç yüz sayfalık bir belgenin tek seferde işlenebilmesi demektir.

Ancak pencerenin büyük olması, doldurulması gerektiği anlamına gelmez. Bölüm 24.5'teki ilke geçerlidir: hedef, beklenen davranışı tanımlayan en küçük bilgi kümesidir.

Pencerede Ne Var?

Pencere yalnızca sizin yazdıklarınızı taşımaz. İçinde şunlar bulunur: sistem talimatı, proje talimatları ve belgeleri, sohbet geçmişi, yüklenen dosyalar, araç çağrılarının sonuçları ve üretilecek yanıt.

26.3 Dikkat Sınırı

Bölüm 1.7'de belirtildiği gibi, çok uzun bağlamlarda modelin ortalarda kalan bilgiye gösterdiği dikkat zayıflayabilir. Pencerede bulunmak, görülmek anlamına gelmez.

Pratik Önlemler

• Kritik talimatları başa veya sona koyun. Ortaya gömülmüş bir kural gözden kaçabilir.
• Uzun belgeyi bölün ve odaklı sorular sorun. Elli sayfalık bir belgeye tek soru sormak yerine, ilgili bölümü verip sorun.
• Uzun oturumda kritik kuralı tekrarlayın. Bu bir zayıflık değil, bilinen bir davranışa karşı önlemdir.

26.4 Oturum Sınırı: Bu Projeden Bulgular

Bu, kitabın üretiminde en somut biçimde yaşanan sınırdır ve iki farklı kalıcılık katmanı olduğunu ortaya çıkarmıştır.

Ne Oldu?

Proje boyunca çalışma ortamı en az iki kez sıfırlandı. Birinci sıfırlanmada ortak biçim modülü ve üretim betikleri kayboldu; modül yeniden yazıldı. İkinci sıfırlanmada 3B modelleme oturumu boşaldı; model yeniden kuruldu.

Ölçülen Durum

Bölüm yazılırken çalışma dizini ile sunulan çıktılar karşılaştırıldı.

Neden Betikler Kayboldu Ama Belgeler Kalmadı?

Belgeler kayboldu değil — sunulmuş oldukları için korundular. Kaybolan, sunulmamış ara ürünlerdi: üretim betikleri, geçici görüntüler, dönüştürülmüş PDF'ler.

Bunun pratik sonucu Bölüm 18'deki bulguyla aynıdır: kod, ürettiği çıktıdan daha kalıcı bir varlık olabilir — ancak yalnızca kalıcı bir yerde saklanırsa. Bu projede ilk yedi bölümün metni duruyor, ama onları üreten betikler yok. Yani o bölümler yeniden üretilemez; yalnızca elle düzenlenebilir.

26.5 Kalıcılık Katmanları

Uzun bir projede neyi nerede saklayacağınız bir tasarım kararıdır.

26.6 Büyük Belgelerle Çalışma

Uzun bir belgeyi modele vermenin üç yolu vardır ve seçim belgenin ne kadar sık kullanılacağına bağlıdır.

Bölme Stratejisi

Bir belgeyi bölmek yalnızca boyut sorunu için değildir; dikkat sınırı için de yapılır. Elli sayfalık bir rapordan tek bir ayrıntıyı sormak yerine, ilgili on sayfayı verip sormak daha güvenilir sonuç verir.

Bölme yaparken bölümlerin kendi başına anlamlı olması gerekir. Cümlenin ortasından kesilmiş bir parça, bağlamsız kalır.

26.7 Uzun Oturum Yönetimi

Bu kitap yirmi altı gün ve çok sayıda oturum boyunca üretildi. Aşağıdaki düzen, o süreçten çıkmıştır.

• Yapıyı dışarıda tut. Kitabın bölüm planı ve kuralları, sohbetin içinde değil, ayrı bir belgede tutuldu.
• Her bölümü bağımsız üret. Bölümler birbirine atıf yapıyor ama üretimleri bağımsız; biri bozulunca diğerleri etkilenmiyor.
• Ortak kuralları modüle al. Biçim kuralları tek bir dosyada toplandı; değişiklik bir yerden yapıldı.
• Her adımı sun. Ara ürünler kullanıcıya verildi ve böylece korundu.
• Durumu dışarıda izle. İlerleme, sohbet geçmişinden değil ayrı bir araçtan takip edildi.
• Bağlamı temizle. İlgisiz görevler arasında yeni oturum açmak, eski bağlamı taşımaktan iyidir.

Beşinci madde, Bölüm 8'de üretilen takip panosunun gerekçesidir: uzun bir projede ilerlemeyi sohbet geçmişinden hatırlamaya çalışmak güvenilmezdir.

26.8 Bir Uyarı: Uzun Oturumda Tutarlılık

Uzun oturumlarda sinsi bir risk vardır: erken alınan bir karar, ilerledikçe unutulur veya farklı uygulanır.

Bu projede buna karşı üç önlem alındı. Birincisi, kurallar ayrı bir belgede tutuldu ve her oturum başında yeniden okundu. İkincisi, biçim tek bir modülde toplandı, böylece tutarsızlık teknik olarak zorlaştı. Üçüncüsü, her bölüm üretildikten sonra görsel olarak denetlendi.

26.9 Bölüm Özeti

• Bağlam sınırı tek değil üçtür: pencere, dikkat ve oturum.
• Pencerenin büyük olması doldurulması gerektiği anlamına gelmez.
• Uzun ajan oturumlarında bağlamı en çok araç sonuçları doldurur.
• Pencerede bulunmak görülmek anlamına gelmez; kritik talimat başa veya sona konmalıdır.
• Sunulan çıktılar kalıcıdır; çalışma ortamı değildir.
• Bu projede ilk yedi bölümün üretim betikleri kaybolmuştur — sunulmadıkları için.
• Üretim betikleri de ürün sayılmalı ve saklanmalıdır.
• Uzun belge bölünürken parçalar kendi başına anlamlı olmalıdır.
• İlerleme sohbet geçmişinden değil, ayrı bir araçtan izlenmelidir.
• Uzun oturumda tutarlılık önlemle değil, düzenli denetimle sağlanır.

Güncellik kontrolü: Bu bölümdeki bulgular bu kitabın 12 Ağustos – 7 Eylül 2026 arasındaki üretim sürecinden alınmıştır. Dosya durumları bölüm yazılırken fiilen denetlenmiştir. Bağlam penceresi büyüklükleri ve ortam davranışları değişebilir.