Verdent Docs
En iyi uygulamalar

Bağlam yönetimi

Daha iyi sonuçlar için bağlamı etkili yönetme


Etkili bağlam yönetimi, Verdent uygulamasının doğru bilgiye doğru zamanda sahip olmasını sağlarken, bağlam aşırı yüklenmesinden kaynaklanan performans düşüşünü önler.

Neler öğreneceksiniz

  • Bağlam pencerelerini ve sınırlarını anlama
  • Optimum bağlam için dosyaları stratejik olarak seçme
  • Bağlam aşırı yüklenmesini tanıma ve buna yanıt verme
  • Daha iyi performans için bağlamı ne zaman sıfırlamalı
  • Çalışma alanı düzeninin bağlamı nasıl etkilediği

Bağlam pencerelerini anlama

Verdent for VS Code uygulamasının bağlam penceresi boyutu, kullanılan modele bağlıdır.

Çoğu model standart 200K bağlam pencereleri kullanır:

  • Claude 4.5 Sonnet - Karmaşık görevler için dengeli
  • Claude 4.5 Haiku - Hızlı ve verimli
  • GPT-5 - Akıl yürütme için mükemmel (Beta)
  • GPT-5-Codex - Kodlama için optimize edilmiş (Beta)

Kapasite:

  • ~200,000 token toplam bellek kapasitesi
  • Çoğu geliştirme görevi ve orta boyutlu proje için yeterli

Neler dahil:

  • Konuşmadaki tüm mesajlar
  • Bağlama yüklenen dosya içerikleri
  • Araç çıktıları ve yanıtlar
  • Sistem istemleri ve talimatlar
  • MCP sunucu tanımları

Performans:

  • Sınırlara yaklaşıldığında önemli ölçüde düşer
  • Bağlam aşırı yüklenme belirtilerine dikkat edin (daha yavaş yanıtlar, daha az doğru çıktılar)
  • Optimum performans için bağlamı daha sık sıfırlayın

Claude Sonnet 4.5, açıkça seçildiğinde veya giriş 200K token'ı aştığında genişletilmiş bağlam (1M token) sunar.

Kapasite:

  • 1,000,000 token toplam bellek
  • Standart modellerden 5 kat daha büyük

Avantajlar:

  • Tüm büyük kod tabanlarını parçalara ayırmadan yüklemek için mükemmel
  • Büyük projeler için çoğu bağlam yönetimi endişesini ortadan kaldırır
  • Bağlam sınırlarına ulaşmadan önce daha uzun süre çalışın
  • Daha az oturum sıfırlamasına ihtiyaç duyulur

Ne zaman kullanılır:

  • 1000+ dosyalı büyük kod tabanları
  • Tüm projeler genelinde karmaşık çok dosyalı yeniden düzenleme
  • Birden çok ilgili görevi kapsayan uzun geliştirme oturumları
  • Bağlam yönetimi yükünü en aza indirmek istediğinizde

Stratejik dosya seçimi

Bağlam kullanımını optimize etmek ve sınırlara ulaşmaktan kaçınmak için dosya seçiminde stratejik olun.

Daha az dosyayla başlayın ve yalnızca gerektiğinde daha fazlasını ekleyin; Verdent konuşma sırasında her zaman ek dosyaları okuyabilir.

Açık dahil etme için @-mention kullanın

@filename.js

Verdent ilgili dosyaları otomatik yükler, ancak @-mentions tam bağlamı garanti eder. Seçici olun; yalnızca mevcut görevle doğrudan ilgili dosyaları dahil edin.

Bağlam kullanımını izleyin

  • Oturumlar uzadıkça performans düşüşüne dikkat edin
  • Konuşma uzunluğu ve dosya sayısının farkında olun
  • Mümkün olduğunda gereksiz dosyaları bağlamdan çıkarın

Bağlam aşırı yüklenmesinden kaçının

  • Büyük görevleri, görev başına daha az dosyayla daha küçük parçalara bölün
  • Yalnızca ilgili dosyalara odaklanın; tüm kod tabanını bir kerede yüklemeyin
  • Kullanılmayan entegrasyonları devre dışı bırakmak için MCP sunucu yönetimini kullanın

En iyi uygulamalar

  • Yalnızca değiştirilmesi veya başvurulması gereken dosyaları dahil edin
  • Örnek dosyaları yüklemek yerine mevcut kalıplara başvurun
  • Büyük kod tabanları için her seferinde bir modül üzerinde çalışın
  • Birçok dosya yüklemek yerine proje belgelerini (AGENTS.md) kullanın
  • Bellek yoğun görevler için bağlam penceresinin son beşte birinden kaçının

Genişletilmiş bağlam (1M token) için

Dosya seçimi çok daha az kritik hale gelir; genellikle tüm proje depolarını sınırlara ulaşmadan yükleyebilirsiniz.


Bağlam aşırı yüklenmesini tanıma

Belirtiler:

  • Daha az doğru veya eksik yanıtlar
  • Konuşmanın başlarındaki önemli ayrıntıların kaçırılması
  • Uzun oturumlarda tutarlılığı korumada zorluk
  • Son değişiklikler veya bağlam hakkında kafa karışıklığı

Somut örnekler:

  • Oturumun başında zaten reddettiğiniz çözümleri önerir
  • 20 mesaj önce belirlediğiniz kodlama kurallarını göz ardı eder
  • Konuşmanın başında yapılan değişikliklerle çakışan kod üretir
  • Daha önce tartışılan proje mimarinizle eşleşmeyen uygulamalar önerir

Birincil sinyal: Verdent yanıtları daha az doğru veya tutarsız hale gelir

Belirtiler:

  • Belirgin şekilde daha yavaş yanıt süreleri
  • Yanıtlar başlamadan önce daha uzun işleme gecikmeleri
  • Mesajlar arasında artan gecikme

Somut örnekler:

  • Normalde 5-10 saniye süren yanıtlar artık 30+ saniye sürüyor
  • Bir mesaj gönderdikten sonra yazıyor göstergesi görünmeden önce görünür gecikme
  • Akış halindeki yanıtlar her zamankinden çok daha yavaş başlar
  • Araç yürütme (dosya okumaları, aramalar) belirgin şekilde daha uzun sürer

Birincil sinyal: Yanıtlar her zamankinden önemli ölçüde daha uzun sürer

Belirtiler:

  • Zaten sağlanan bilgileri açıklama istekleri
  • Daha önce belirlenen kalıpları veya kuralları unutma
  • Daha önce tartışılan dosyalara veya koda başvuramama
  • Proje yapısı hakkında gereksiz sorular

Somut örnekler:

  • 30 mesaj önce React kullandığınızı belirttiğinizde "Hangi çerçeveyi kullanıyorsunuz?" diye sorar
  • Zaten birden çok kez @-mentioned dosya yollarını ister
  • Oturumun başında belirlediğiniz adlandırma kuralını hatırlamaz
  • Gerekçeleriyle birlikte zaten reddettiğiniz kavramları veya yaklaşımları yeniden açıklar

Birincil sinyal: Verdent zaten tartışılan şeyleri sorar

Belirtiler:

  • 200K token sınırının son beşte birine yaklaşma (~160K+ token kullanıldı)
  • Birçok dosya okuması ve araç çıktısı içeren uzun konuşmalar
  • Ağır araç tanımlarıyla birden çok MCP sunucusunun etkinleştirilmesi
  • Büyük dosyaların bağlama tekrar tekrar yüklenmesi

Somut örnekler:

  • Oturum 100+ mesajla 2+ saattir çalışıyor
  • Konuşma boyunca @-mentions ile 20+ dosya yüklediniz
  • Birden çok büyük dosya (her biri >1000 satır) bağlamda
  • Kapsamlı araç tanımlarıyla 5+ MCP sunucusu etkinleştirilmiş
  • Konuşma birçok grep/arama sonucu ve dosya okuması içeriyor

Birincil sinyal: Kapsamlı dosya/araç kullanımıyla çok uzun oturumlar

Ne zaman harekete geçmeli: Performans düşüşü birincil sinyalinizdir. Verdent yanıtları daha az doğru, daha yavaş veya tutarsız hale gelirse, yeni bir oturum başlatın veya bağlam yönetimi stratejileri kullanın.

Verdent yanıtları belirsiz veya tekrarlayıcı hale gelirse, bağlam aşırı yüklenmesi yaşanıyor olabilir. Tam performansı geri yüklemek için konuşmayı sıfırlayın.

Not: 1M token bağlamıyla (Claude Sonnet 4.5), bu sorunlar çok daha az yaygındır.


Bağlamı ne zaman sıfırlamalı

  • Belirgin şekilde daha yavaş yanıt süreleri
  • Daha az doğru veya tutarsız yanıtlar
  • Verdent önceki bağlamı veya kalıpları unutuyor
  • Bağlam penceresi sınırlarına yaklaşma (düşüş belirtilerine dikkat edin)

Eylem: Kalite düştüğünde yeni oturum başlatın

  • İlgisiz özellikler veya modüller arasında geçiş yapma
  • Bir yapılacak işi tamamlayıp bir sonrakine geçme
  • Bellek yoğun görevlerden sonra (büyük yeniden düzenlemeler, mimari çalışma)
  • Araştırma aşamasından uygulama aşamasına geçme

Eylem: Yeni ana görev için yeni oturum

  • Tamamlanan özellikleri sürüm denetimine commit ettikten sonra
  • Geliştirme iş akışındaki mantıksal kontrol noktaları arasında
  • Test-doğrulama-commit döngülerini takiben

Eylem: Commit → test → yeni oturum

  • Büyük yeni özellikler başlatmadan önce
  • Konuşma geçmişi çok uzadığında
  • Çok dosyalı değişiklikleri tamamladıktan sonra
  • Farklı çalışma türleri arasında (hata ayıklama → özellik geliştirme)

Eylem: Bağlam düşmeden önce proaktif olarak yeni oturum başlatın

En iyi uygulama iş akışı: Atomik iş birimini tamamla → test et → commit et → bağlamı temizle → bir sonraki görev için yeniden başla.

Not: Bağlamı sıfırlamak için yeni bir oturum başlatın. 1M token bağlamlarında temizleme çok daha az sıklıkta gerekir.


Çalışma alanı düzeninin etkisi

Çalışma alanı düzeni, bağlamın ne kadar verimli kullanıldığını ve Verdent kod tabanınızda ne kadar kolay gezinebileceğini doğrudan etkiler.

Daha küçük, odaklı dosyalar:

  • Birçok küçük dosya, az sayıda büyük dosyaya göre bağlamı daha verimli kullanır
  • Yalnızca ilgili modülleri yüklemek daha kolay
  • Bağlamda nelerin olduğu üzerinde daha ince ayrıntılı denetim
  • Tüm büyük dosyaları yükleme ihtiyacını azaltır

Net dizin yapısı:

  • Mantıksal düzen, Verdent ilgili dosyaları bulmasına yardımcı olur
  • Özellik tabanlı veya modül tabanlı düzen, bağlam hedeflemeyi iyileştirir
  • İlgisiz kodu yükleme ihtiyacını azaltır

Documentation in AGENTS.md:

  • Proje belgeleri, birçok örnek dosyayı yükleme ihtiyacının yerini alır
  • Mimari kalıplar bir kez açıklanır, tekrar tekrar başvurulur
  • Kodlama standartları merkezi olarak belgelenir
  • Keşif amaçlı dosya okumalarından kaynaklanan bağlam yükünü azaltır

Avantajlar:

  • Tüm kod tabanını yüklemeden izole modüller üzerinde çalışın
  • Net sınırlar odaklı oturumları mümkün kılar
  • İşi parçalara ayırma, modül sınırları boyunca doğal hale gelir

Sorunlar:

  • Monolitik dosyalar, tüm büyük bağlamları yüklemeye zorlar
  • Belirsiz yapı, mimariyi anlamak için birçok dosyayı yüklemeyi gerektirir
  • Aynı dosyalardaki karışık endişeler, ilgisiz koda bağlam harcar

Etki:

  • Sık bağlam sınırı sorunları
  • İlgisiz koda harcanan token'lar
  • İşi belirli modüllere izole etmede zorluk
  • Daha sık oturum sıfırlama ihtiyacı

Yaygın anti-kalıplar:

  • Birden çok endişeli tek 5000+ satırlık dosyalar
  • Kökte 100+ dosyalı düz dizin yapısı
  • Özellikler/modüller arasında net ayrım yok
  • Merkezi belge eksikliği

Yeniden düzenleme yaklaşımları:

  • Büyük dosyaları daha küçük, odaklı modüllere bölün
  • Dosya türüne göre değil, özelliğe veya alana göre düzenleyin
  • Net bir dizin hiyerarşisi oluşturun
  • Paylaşılan kodu ayrı modüllere ayıklayın

Belgeleme:

  • Mimari kalıplarla AGENTS.md oluşturun
  • Kodlama standartlarını merkezi olarak belgeleyin
  • Modül başına README dosyaları tutun
  • Tasarım kararlarını belgelenmiş halde tutun

Bağlam etkisi: Standart 200K token bağlamları için, düzenli çalışma alanları sınırlara sık veya nadir ulaşma arasındaki farkı yaratır. 1M token bağlamları için düzen daha az önemlidir ancak yine de verimliliği artırır.


Bağlam optimizasyon stratejileri

Etkili bağlam optimizasyonu, izleme, stratejik planlama ve teknik yapılandırmayı bir araya getirir.

Performans belirtilerine dikkat edin:

  • Oturumlar boyunca yanıt kalitesini ve hızını izleyin
  • Yanıtların ne zaman yavaşladığını veya daha az doğru hale geldiğini fark edin
  • Konuşma uzunluğunu ve dosya sayısını elle takip edin
  • Yeni oturum başlatma konusunda proaktif olun

Neyi izlemeli:

  • Yanıt doğruluğu ve tutarlılığı
  • İlk yanıt süresi (yazıyor göstergesi gecikmesi)
  • Genel yanıt tamamlanma süresi
  • Önceki konuşma ayrıntılarının hatırlanması

Alt aracı yönetimi:

  • Gerekmediğinde kullanılmayan özel alt aracıları devre dışı bırakın
  • Etkinleştirilen her alt aracı, sistem yüküne tanımlar ekler
  • Yalnızca aktif olarak kullanılan alt aracıları etkin tutun
  • Belirli görevler için gerektiğinde yeniden etkinleştirin

Eylem eşiği: 2-3 düşüş sinyallerini fark ettiğinizde, yeni bir oturum başlatma zamanıdır.

Bağlam sağlığının öncü göstergesi olarak yanıt kalitesini izleyin; düşen yanıtlar sıfırlama zamanının geldiğini gösterir.

Parçalara ayırma yaklaşımı:

  • Büyük görevleri daha küçük parçalara bölün
  • İlgili işleri odaklı oturumlarda tamamlayın
  • Uzun konuşmalarda farklı görev türlerini karıştırmaktan kaçının
  • Bellek yoğun çalışma için bağlam penceresinin son beşte birinden kaçının

Oturum yönetimi:

  • Ana görevler arasında yeni oturum başlatın
  • Commit'lerden sonra bağlamı temizleyin: test → doğrula → commit → yeni oturum
  • Çok adımlı planlama için yapılacaklar listesi kullanın
  • Yapılacak öğeleri ayrı odaklı oturumlarda işleyin

En iyi uygulama kalıbı:

  1. Görevi Plan Mode'da planlayın
  2. Odaklı uygulamayı yeni bir oturumda yürütün
  3. Değişiklikleri test edin ve doğrulayın
  4. Sürüm denetimine commit edin
  5. Bir sonraki görev için yeni oturum başlatın

Görev izolasyonu: Hata ayıklamayı özellik geliştirmeden, araştırmayı uygulamadan ayrı tutun.

Stratejik dahil etme:

  • @-mentions yalnızca gerektiğinde açık dosya dahil etme için kullanın
  • Birçok dosya yüklemek yerine AGENTS.md belgelerinden yararlanın
  • Büyük projeler için her seferinde bir modül üzerinde çalışın
  • Büyük dosyaları daha küçük, odaklı bileşenlere bölün

Dosya seçim ilkeleri:

  • Yalnızca değiştirme veya doğrudan başvuru gerektiren dosyaları dahil edin
  • Örnek dosya yüklemesi yerine belgeleri tercih edin
  • Artık gerekmediğinde dosyaları bağlamdan çıkarın
  • Dosyaları önceden değil, tam zamanında yükleyin

Büyük dosya işleme:

  • 500 satırın üzerindeki dosyaları bölmeyi düşünün
  • Yardımcı programları ve yardımcıları ayrı dosyalara ayıklayın
  • Net modül sınırları kullanın
  • Dosya ilişkilerini AGENTS.md içinde belgeleyin

Optimizasyon iş akışı:

Performansı izle → Oturum şişmesini belirle → Kullanılmayan alt aracıları devre dışı bırak → Proaktif olarak yeni oturum başlat → Görev kalitesine odaklan

Günlük uygulama:

  • Her ana özelliğe yeni bağlamla başlayın
  • Sık commit yapın ve commit'ler arasında sıfırlayın
  • Oturumları tek bir hedefe odaklı tutun
  • Doğal kesme noktalarında bağlam kullanımını gözden geçirin

For Extended Context (1M tokens): Claude Sonnet 4.5'in daha büyük bağlam penceresiyle, optimizasyon daha az kritik hale gelir; agresif bağlam yönetimi yerine görev kalitesine odaklanın. Ancak iyi uygulamalar yine de verimliliği ve düzeni artırır.


SSS

200K ve 1M bağlam pencereleri arasındaki fark nedir?

Standart modeller (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) çoğu görev için yeterli 200K token bağlam penceresine sahiptir. Claude Sonnet 4.5, 1000+ dosyalı büyük kod tabanları, karmaşık çok dosyalı yeniden düzenleme veya uzun geliştirme oturumları için genişletilmiş 1M token bağlam (5 kat daha büyük) sunar. 1M bağlam, giriş 200K token'ı aştığında otomatik olarak etkinleşir veya açıkça seçilebilir.

Bağlamı elle mi sıfırlamalıyım yoksa Verdent otomatik olarak mı yapar?

Bağlamı sıfırlamak için elle yeni bir oturum başlatmanız gerekir; Verdent bağlamı otomatik olarak temizlemez. En iyi uygulama: atomik bir iş birimini tamamladıktan, test ettikten ve sürüm denetimine commit ettikten sonra sıfırlayın. 1M token bağlamları için sıfırlama çok daha az sıklıkta gerekir.

Bağlama güvenle kaç dosya yükleyebilirim?

Sabit bir dosya sınırı yoktur; dosya boyutlarına ve toplam token sayısına bağlıdır. 200K bağlamları için 20+ büyük dosya (her biri >1000 satır) yüklemekten kaçının. Mevcut görevinizle doğrudan ilgili dosyalara odaklanın. @-mentions öğesini seçici kullanın ve birçok örnek dosya yüklemek yerine AGENTS.md belgelerinden yararlanın. 1M bağlamıyla dosya seçimi çok daha az kritik hale gelir.

Bağlam penceremde neler sayılır?

Oturumunuzdaki her şey: konuşmadaki tüm mesajlar, bağlama yüklenen dosya içerikleri, araç çıktıları (grep/arama sonuçları, dosya okumaları), sistem istemleri ve talimatlar ve MCP sunucu tanımları. Bunların her biri toplam bağlam kapasitenizden token tüketir.

Bağlamı sıfırlamak işimi kaybettirir mi?

Hayır; bağlamı sıfırlamak yalnızca konuşma geçmişini ve yüklenen dosyaları bellekten temizler. Gerçek kod değişiklikleriniz, commit'leriniz ve dosya değişiklikleriniz korunur. Güvenlik için bağlamı sıfırlamadan önce işinizi her zaman sürüm denetimine commit edin. Sıfırla → yeni oturum başlat → bir sonraki görevde çalışmaya devam et.


Ayrıca bkz.