Claude Kodu ve İmleç için %50 bağlam kuralı: bir oturumun ne zaman temizleneceği ve bir görevin nasıl devredileceği
Uzun bir oturumda ne olur?
Bir özellik üzerinde bir temsilciyle bir saat çalışıyorsunuz. Başlangıçta anlaşmıştık: genel API'ye dokunmayın, testleri Vitest'te yazın, mevcut apiClient'u kullanın. Oturumun sonunda aracı yeni bir fetch sarmalayıcısı oluşturur, dışa aktarılan işlevin imzasını kırar ve Jest'te bir test yazar. İnsani anlamda "unutulmamıştır": İlk talimatlar hala bağlam içindedir, ancak artık onbinlerce günlük belirteci, fark ve okuma dosyasıyla çevrelenmiştir.
Bunun bir araştırma temeli var. Ortada Kayıp (Liu ve diğerleri, 2023), modellerin uzun bir bağlamın ortasındaki bilgileri başından ve sonundan daha kötü kullandığını göstermektedir. Ayrıca bağlamda çöp birikir: dosyaların güncel olmayan sürümleri, iptal edilen yaklaşımlar, zaten düzeltilmiş hata mesajları. Model onları mevcut durumla aynı seviyede görüyor.
“%50 kuralı” ölçülmüş bir eşik değil, buluşsal bir yöntemdir. Önemli olan, aracının hata yapmasını veya otomatik sıkıştırmanın devreye girmesini beklemek yerine, bağlamı önceden yönetmektir.
Doluluk nasıl görüntülenir?
Claude Kodunda, /context komutu ne kadar meşgul olduğunu ve ne olduğunu gösterir: sistem talimatları, CLAUDE.md gibi hafıza dosyaları, MCP araçlarının açıklamaları, mesaj geçmişi. Son nokta genellikle beklenmedik bir şekilde ortaya çıkıyor: Düzinelerce araca sahip bağlı MCP sunucuları, ilk mesajdan önce bile pencerenin gözle görülür bir bölümünü kaplıyor.
İmleç'te, sohbetteki bağlam göstergesine ve kendi işaretlerinize odaklanın: aracı, daha önce açmış olduğu dosyaları yeniden okur, reddedilen seçeneği tekrarlar, adları karıştırır.
Yarım pencere için prosedür
- 1.Temsilciden durumu yazmasını isteyin. Görüşmenin yeniden anlatımı değil, çalışan bir belge:
Запиши в docs/handoff/feature-export.md: - цель задачи в одном абзаце; - принятые решения и почему (с путями к файлам); - что сделано и проверено (какие тесты проходят); - что осталось, в порядке выполнения; - ограничения: что нельзя трогать; - открытые вопросы. Не включай историю попыток, которые мы отбросили.
- 2.Belgeyi kendiniz kontrol edin. Yeni oturumda neler olacağını kontrol edebileceğiniz tek yer burasıdır. Yanlış olanı kaldırın, unutulmuş kısıtlamaları ekleyin.
- 3.Oturumu temizleyin. Claude Kodunda -
/clear, İmleçte - yeni sohbet.
- 4.Dosyayla başlayın. "docs/handoff/feature-export.md dosyasını okuyun ve bir sonraki noktadan devam edin."
Claude Kodundaki ilk üç adımın alternatifi, neyin kaydedileceğini gösteren /compact adımıdır: /compact сохрани решения по API экспорта и список оставшихся шагов, логи тестов не нужны. Daha hızlıdır ancak son çıktıyı dosya kadar net göremezsiniz.
Diyalogun dışında tutulması gerekenler
Kalıcı proje kuralları mesaj geçmişinde yer almamalıdır. Bunlar CLAUDE.md (Claude Kodu) veya .cursor/rules (İmleç) içine aittirler: her yeni oturumda yüklenirler. Güzel CLAUDE.md kısa:
# Проект Next.js 15, App Router, PostgreSQL через Drizzle. # Команды - pnpm test — Vitest - pnpm lint — ESLint + tsc --noEmit # Правила - HTTP-запросы только через lib/api-client.ts. - Публичные функции в lib/public/* не меняют сигнатуру без явной просьбы. - Перед завершением задачи запускай pnpm lint и pnpm test.
Uzun referans kitaplarını (veritabanı şeması, API açıklaması) her zaman indirmek yerine ayrı dosyalarda tutmak ve gerektiğinde bunları bağlamak daha iyidir.
Bağlamı şişirmemek nasıl
- Dizinin tamamını okumayı istemeyin. Belirli dosyaları belirtin veya öncelikle arama yaparak ihtiyacınız olanı bulmayı isteyin.
- Binlerce satıra bölünmüş tam günlük yerine komut çıktısını kırpın.
pnpm test 2>&1 | tail -50. - Araştırmayı bir alt aracıya yerleştirin. Claude Kodunda alt aracılar ayrı bir bağlamda çalışır ve yalnızca çıktı döndürür. "Eski istemcinin çağrıldığı tüm yerleri bulma" görevi iyi bir şekilde devredilmiştir: ana oturum yirmi dosyanın içeriğini değil bir liste alacaktır.
- Tek oturum - tek görev. "Aynı anda başlıktaki stilleri düzeltin" seçeneğine geçmek ilgisiz dosyaları bağlama sürükler.
Daha erken temizlik zamanının geldiğini gösteriyor
- Temsilci, birkaç adım önce reddettiğiniz bir çözüm sunuyor.
- Düzenlediği dosyayı tekrar okur ve içeriği karşısında şaşırır.
- Bir hatayı düzeltmek, daha önce düzelttiği yerde başka bir hatayı yaratır.
- Cevaplar uzar ve fark küçülür.
Böyle bir durumda aynı oturumda devam etmek genellikle aktarım dosyası üzerinde birkaç dakika harcamaktan daha pahalıdır.
Bir kurala ihtiyaç duyulmadığında
Bir düzine mesaja sığan kısa görevler herhangi bir prosedür gerektirmez. Çok büyük pencereli modellerde eşik hareket ettirilebilir ancak iptal edilen denemelerden kaynaklanan kalıntılar kaybolmaz. Yüzdeye değil, temsilcinin davranışına odaklanın: 50 sayısı, en azından düşünmeniz gereken noktadır.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.