Ajan eskiye takılıyorsa
Kaldırttığım, değiştirdiğim ya da artık işe yaramayan şeyi ajanım bırakmadığında yaşadığım ve çözdüğüm durumlar. Seninkini bul, kararı ajanına ver.
Bir katmanın kalması için ajana onu dışarıdan zorlayan şeyi dosya ve satırıyla yazdırıyorum: o biçimde veri veren bir dış kaynak, ölçülmüş bir hız farkı ya da onu çağıran dış bir okuyucu. Kendi yazdığımız başka bir fonksiyonun onu beklemesi neden sayılmıyor. Nedeni yazılamayan katman tersiyle birlikte siliniyor, çağıranlar asıl değeri doğrudan alıyor.
önceneyi koruduğunu söyleyen arka plan mekanizması 73'te 1 (20 Ekim)
sonra133'te 57 · ara kopyalar yalnız katmansız yoldan aynı çıktıyı daha hızlı verince kaldı (5'te 5)
kaldırttığın değerin geçtiği her çeviriciye ve sarmalayıcıya dış nedenini dosya:satırıyla yazdır; yazılamayanı o yoldan sil, çıktının değişmediğini aynı girdiyle gösterAjana giden metin · 24 satır
Durum: ajanına bir şeyi kaldırmasını ya da sadeleştirmesini söyledin. Kaldırmak yerine üstüne bir katman daha ekledi: bir çevirici, hemen ardından tersi, bir uyumluluk sarmalayıcısı ya da «eski» diye işaretlenip yerinde bırakılmış bir fonksiyon. Kod çalışıyor ama değer kullanıldığı yere varana kadar birkaç kez biçim değiştiriyor ve her yeni istekte bir katman daha geliyor. Neden: ajan var olan çağrıları kırmamak için en güvenli hamleyi seçer: dokunduğu yerin önüne bir uyarlayıcı koyar. «Uyumluluk katmanı yazma» diye yazılmış kural bunu çoğu zaman durdurmuyor: anthropics/claude-code#2901 kuralı açıkça yazmış birinin aynı şikâyetidir. Ajan bir katmanın neden var olduğunu sormadan onu kaldıramaz; sorulunca da çoğu katmanın tek nedeni projenin kendi başka bir fonksiyonu çıkar, dışarıdan gelen bir zorunluluk değil. Bende 20 Ekim'de 73 arka plan mekanizmasının 72'si neyi koruduğunu söylemiyordu. Yap: (<değer> yerine kaldırttığın şeyin koddaki adını yaz. Komutlar git deposunun kökünde koşar.) 1. Değerin yolunu bul: dışarıdan girdiği yerden kullanıldığı yere kadar geçtiği her fonksiyon. Değer birden çok yerden giriyorsa (argüman, API yanıtı, dosya) her giriş ayrı bir yoldur. git grep -nEi '<değer>' Bu satırlarda değerin geçtiği her fonksiyonun tanımını ve çağrılarını adıyla bul: git grep -nw '<fonksiyonun adı>'. Her yolu tek satıra yaz: giriş (dosya:satır) → katman → katman → kullanım (dosya:satır). Değeri dışarıdan okuyan fonksiyon giriştir; basan, kaydeden ya da hesapta kullanan fonksiyon kullanımdır; yalnız aradakiler katmandır. 2. Her yolun yanına girişte okunan biçimi (API'nin döndüğü birim, okunan dosyanın biçimi, kullanıcının girdiği alan) ve kullanımın dışarı verdiği biçimi (ekrana basılan birim, yazılan dosya, başkasının çağırdığı yayımlanmış arayüz) dosya:satırıyla yaz. İkisi farklıysa o yolun sınırında tek bir çevirici kalır, dış nedeni bu iki satırdır; aynıysa o yoldaki bir katmanın tek dış nedeni ölçülmüş bir hız farkı olabilir. 3. Çıktıyı silmeden önce kaydet: projenin bu değeri kullanan çıktısını veren komutu (testler ya da programın kendisi) koş. <çıktı komutu> > "$(git rev-parse --git-dir)/once.txt" 2>&1 Komutun bu yolları koştuğunu sına: 1. adımda yazdığın her kullanım dosya:satırında değeri bilerek 1000 ile çarp, 5. adımın satırını koş → diff bir fark basar (basmıyorsa değeri gerçekten basan bir komut seç), sonra geri al: git checkout -- <kullanım dosyaları> 4. Dış nedeni yazılamayan katmanı o yoldan sil: çağıranlar asıl değeri doğrudan alır. Silinen katman için yorum, «kaldırıldı» notu ya da talimat dosyasına satır yazma: geçmiş git'te durur. 5. Aynı komutu yeniden koş ve iki çıktıyı karşılaştır: G=$(git rev-parse --git-dir); <çıktı komutu> > "$G/sonra.txt" 2>&1; diff "$G/once.txt" "$G/sonra.txt" && echo "çıktı aynı" 6. 5. adım «çıktı aynı» bastıysa tek commit'le; fark bastıysa silinen katmanlardan birinin dış nedeni vardı: git checkout -- <değiştirdiğin dosyalar> ile geri al, nedenini 2. adıma yaz ve 4. adımdan yeniden koş. git add -A && git commit -m "<değer>: <silinen katmanların adları> silindi, dış nedeni yok" Doğrula: - 5. adımın satırı «çıktı aynı» basar. Yapma: - Katmanı «deprecated» diye işaretleyip yerinde bırakma: ajan onu yeniden çağırır.
Bir şeyi kaldırınca onu anan her satırı (yorum · ajan talimatı · not) aynı commit'te siliyorum; ne zaman ve neden kaldırıldığını commit mesajı taşıyor. Ajanın tarih ya da eski hâlin sayısını taşıyan yorum yazmasını yazdığı anda reddediyorum.
öncekaldırma notu bayatlayınca ajan 10 koşunun 10'unda notu izledi, 9'unda çevirici yazdı
sonraaynı kod, not silinmiş: 0/10
kaldırdığın şeyi anan her notu (CLAUDE.md · AGENTS.md · kod yorumu) sil; neden kaldırıldığını commit mesajına yazAjana giden metin · 23 satır
Durum: ajana bir özelliği kaldırttın. Ajan kodu sildi ama CLAUDE.md'ye, AGENTS.md'ye ya da koda «X kaldırıldı · artık Y» diye bir not bıraktı. Sonradan kod yine değişti; ajan şimdi yeni koda o eski nota göre davranıyor: olmayan bir kurala uyuyor, aradaki farkı kapatmak için çevirici ya da uyumluluk katmanı ekliyor. Neden: ajan talimat dosyasını koddan önce ve daha yüksek öncelikle okur. Not yazıldığı gün doğrudur, kod değişince yalana döner; ajan yalanı kodun önüne koyar. Bende ölçtüm (Claude Sonnet, aynı küçük proje, aynı istek, kol başına 10 koşu): - kod Y'yi kullanıyor, CLAUDE.md'de «X desteği kaldırıldı, her şey Y» notu olsa da olmasa da: X'i anan 0/10 - kod sonradan X'e dönmüş: not yerindeyken Y'yi anan 10/10, X'i Y'ye çeviren satır yazan 9/10; not yokken 0/10 Not taze kaldıkça zararsız; kod bir kez daha değişince ajan onu koda tercih ediyor. Georgia Tech ∧ UC Boulder'ın 320 koşuluk çalışmasında da (Claude Code ∧ Codex CLI) ajanlar koda aykırı eski CLAUDE.md ∨ AGENTS.md satırını seçimlerin %90,1'inde izledi. Yap: 1. Proje kökünde izlenen notları bul. Talimat dosyaları: git grep -nEi 'kald(ı|i)r(ı|i)l|kald(ı|i)rd|sil(in|d)|(ç|Ç|c)(ı|i)kar(ı|i)l|art(ı|i)k|eskiden|removed|deleted|dropped|deprecated|no longer|used to|replaced by' -- ':(glob)**/CLAUDE*.md' ':(glob)**/AGENTS.md' ':(glob).claude/**' Kod yorumları: git grep -nEi '((^|[[:space:]])(//|#|--|;|/\*|<!--)|^[[:space:]]*\*).*(kald(ı|i)r(ı|i)l|kald(ı|i)rd|sil(in|d)|(ç|Ç|c)(ı|i)kar(ı|i)l|art(ı|i)k|eskiden|removed|deleted|dropped|deprecated|no longer|used to|replaced by)' 2. Her satırın andığı şeyi kodda ara; 1. adımın bulduğu satırlar sayılmaz. Kod satırın kuralıyla duruyorsa (not «X kaldırıldı, her şey Y» ∧ kodda X yok) kuralı şimdiki zamanla yaz: «Her şey Y.» Durmuyorsa ∨ satır yalnız geçmiş anlatıyorsa sil. 3. İzlenen CLAUDE.md'ye (ya da AGENTS.md'ye) şu satırı ekle, ajan bundan sonra kaldırırken not bırakmasın: Bir şeyi kaldırınca onu anan her satır (yorum · bu dosya · test · doküman) aynı commit'te gider; nedeni commit mesajında durur. 4. Yalnız 2. ∧ 3. adımda değiştirdiğin dosyaları tek commit'te topla, nedenini mesaja yaz: git commit -m "kaldırma notlarını sil: not bayatlayınca ajan onu koda tercih ediyor" -- <o dosyalar> Doğrula: - 1. adımın iki komutunu yeniden koş → kaldırılanı ya da eski hâli anlatan satır kalmadı. Yapma: - Notu silmek yerine yanına «bu artık geçerli değil» yazma: ikinci not birincinin bayatlamasını taşır. - Bütün yorumları toptan silme: kodun söyleyemediği kuralı ve nedenini taşıyan yorum kalır, yalnız geçmiş anlatan gider.
Kararımı değiştirince yenisini dosyanın bir yerine eklemiyorum: eski satırı ya siliyorum ya da yalnız hâlâ tuttuğu yere daraltıyorum («eskisini yalnız eski içe aktarıcı okur»). Eski hâl git geçmişinde kalıyor.
önceeski satır başka bölümde duruyor: Opus 12 koşunun 6–7'sinde kodu eski karara göre yazdı
sonraeski satır koşuluna daraldı ∨ silindi: 0–2/12
kural dosyandaki eski kararın her satırını ya sil ya da yalnız tuttuğu yere daralt; yenisini eskinin yanına eklemeAjana giden metin · 14 satır
Durum: bir kararı değiştirdin (birim, kütüphane, biçim) ve yenisini kural dosyana (CLAUDE.md, AGENTS.md) yazdın, ama ajan hâlâ eskisine göre kod yazıyor ya da ikisini karıştırıyor. Koduna «CLAUDE.md conflicts», «kurallar çelişiyor» gibi yorumlar düşüyor. Neden: ajan dosyadaki iki satırı da kural sayar; hangisinin yeni olduğunu bilmez ve birini seçer. Bende altı karar değişikliğiyle, git'siz bir klasörde araçsız ölçtüm: eski satır bir bölümde, yeni satır başka bölümde dururken Opus üç ölçümde 12 koşunun 6–7'sinde, Sonnet 12'nin 7'sinde, Haiku 18'in 8'inde kodu eski karara göre yazdı. Eski satır yalnız hâlâ tuttuğu yere daraltılınca ya da silinince Opus ve Sonnet 12'nin en çok 2'si, Haiku 0/18. Yap: 1. Eski kararın kelimesini ve kısaltmasını proje kökünde ara (ESKI yerine onları yaz, aralarına | koy: kelime|kısaltma): grep -rniIE --exclude-dir=.git --exclude-dir=node_modules 'ESKI' . 2. Kural dosyasında (CLAUDE.md, AGENTS.md) eski kararı söyleyen her satırı sil; aramada eski kararı hâlâ kullanan kod satırı (yorum değil) çıktıysa o kural satırını silme, kodun dosyasına daralt, örnek: «<eski> yalnız <dosya>; başka her yerde <yeni>». Doğrula: - 1. adımın aramasını yeniden koş: CLAUDE.md ve AGENTS.md satırlarında eski karar ya hiç geçmiyor ya da yalnız daralttığın satırda geçiyor. Yapma: - Yeni kararı başka bölüme ekleyip eski satırı bırakma.
Bir satırı sezgiyle tutmuyorum: o satırın değiştirmesi gereken hamleyi isteyen kısa bir sahne yazıyorum, aynı sahneyi satırlı ve satırsız dosyayla bağlamsız bir ajana birkaç kez koşturup doğru hamleyi sayıyorum. Satırsız da aynı hamleyi yapıyorsa satır çıkıyor, onsuz hamle düşüyorsa kalıyor.
önceher işte yüklenen kural dosyası 181.567 bayt
sonra159.361 bayt · ajanın doğru hamlesi 32/32 → 32/32
CLAUDE.md'deki bir satırı silmeden önce satırlı ve satırsız iki kopyayla aynı sahnede üçer kez koştur; satırsız da aynı hamleyi yapıyorsa silAjana giden metin · 28 satır
Durum: CLAUDE.md zamanla yüzlerce satıra çıktı. Hangi satırın ajanın davranışını hâlâ değiştirdiğini, hangisinin modelin zaten yaptığı bir şeyi tekrarladığını bilmiyorsun; yeni model gelince de aynı soru yeniden doğuyor.
Neden: CLAUDE.md her oturumun başında bütünüyle okunur; her satır her istekte bağlam yer ve öteki satırlarla dikkat için yarışır. Modelin zaten yaptığı şeyi söyleyen satır hiçbir hamleyi değiştirmez. Bir satırın gerekip gerekmediği okuyan modele de bağlıdır: tahminle değil, o modelle sayarak bilinir. Bende (16 Kasım) her işte yüklenen kural dosyasından 129 alıntı satırı çıktı: 181.567 → 159.361 bayt, bağlamsız okuyucunun (Opus) ayırt edici dört sahnede doğru hamlesi 32/32 → 32/32. Aynı gün çıkarmayı düşündüğüm 27 satırın 3'ü kaldı: onlarsız doğru hamle 3/3 → 1/3'e düştü.
Yap (her satır için ayrı; her claude -p bir model çağrısıdır, satır başına 6 çağrı):
1. Tek satır seç ve numarasını bul (grep -n 'yalnız pnpm' CLAUDE.md). Bütün dosyayı birden kesme.
2. O satırın değiştirmesi gereken hamleyi isteyen bir sahne yaz ve cevabı tek satıra zorla; doğru hamlenin başını bir desenle yaz. Örnek, «paket kurmak için yalnız pnpm kullan» satırı için:
S='Bu projeye lodash bağımlılığını ekle. Hiçbir komut koşma, dosyaya dokunma. Cevabın tek satır olsun: koşacağın komut, açıklamasız.'
D='^`?pnpm add'
3. Proje kökünden boş bir geçici klasöre iki kopya kur: biri satırlı, biri satırsız. N silinecek satırın tek numarasıdır:
N=7
B=$(mktemp -d); mkdir "$B/ile" "$B/siz"
cp CLAUDE.md "$B/ile/CLAUDE.md"
sed "${N}d" CLAUDE.md > "$B/siz/CLAUDE.md"
CLAUDE.md başka dosyaları @ ile içe alıyorsa onları da iki klasöre aynı yola kopyala. Aşağıdaki diff tam iki satır basmalı: «7d6» (N=7 ise) ∧ altında «< » ile silmek istediğin satır; boş ∨ fazlaysa N yanlış, 4'e geçme:
diff "$B/ile/CLAUDE.md" "$B/siz/CLAUDE.md"
4. Aynı sahneyi iki kopyada üçer kez koştur ve say (2 ve 3'teki S, D, B aynı kabukta tanımlı olmalı):
for d in ile siz; do for i in 1 2 3; do (cd "$B/$d" && claude -p "$S") > "$B/$d-$i.txt" 2>&1; done; done
grep -H . "$B"/ile-*.txt "$B"/siz-*.txt; echo "ile $(grep -lE "$D" "$B"/ile-*.txt | wc -l | tr -d ' ') / 3 · siz $(grep -lE "$D" "$B"/siz-*.txt | wc -l | tr -d ' ') / 3"
5. Önce basılan cevapları oku: D doğru bir cevabı saymıyor ∨ yanlış bir cevabı sayıyorsa D'yi düzelt ∧ yalnız 4'ün son satırını yeniden koş. Sonra yukarıdan ilk tutanla:
siz 3/3 → sil · ile 0/3 ∨ 1/3 → satır metin olarak işlemiyor: yanlış komutu reddeden bir kancaya taşı · öteki her sayım → kalır.
6. Bir satırı sildiysen sıradakini silinmiş dosyayla ölç: satırın gerekliliği dosyanın geri kalanına bağlıdır (bende «Testler için `pnpm test` koş.» satırı dururken pnpm satırı silinince ajan yine 3/3 pnpm add yazdı).
Doğrula: yöntemin ayırdığını önce bilinen bir satırla gör: yeni bir B=$(mktemp -d) altında ile/CLAUDE.md'ye yalnız «Bu projede paket kurmak için yalnız pnpm kullan.» yaz, siz/CLAUDE.md boş kalsın, 2'deki S ve D ile 4'ü koş → ile 3/3 · siz 0/3 (bende Claude Code 2.1.325'te) çıkmadan gerçek satırlara geçme.
Yapma:
- Bütün dosyayı birden kesip ölçme: düşen hamlenin hangi satırdan geldiğini bilemezsin (bende 27 satırı birden çıkarmak üç sahnede hamleyi düşürdü).
- Birinin açıkça istediği bir satırı yalnız sayıma bakıp silme: önce o kişiye sor.