Claude 5 modelleri için yeni bağlam mühendisliği kuralları

• Claude Opus 5 ve Claude Fable 5’te, Claude Code’un sistem istemi %80’den fazla azaltılmasına rağmen kodlama değerlendirmelerinde ölçülebilir bir performans düşüşü görülmedi
• Geçmiş modellerde en kötü durumları önlemeye yarayan ayrıntılı kurallar; sistem istemi, Skills, CLAUDE.md ve kullanıcı isteği arasında çakışmalara yol açabildiğinden, güncel modellerde çevre bağlamı ve kendi muhakemesini kullanmasına izin vermek daha iyi
• Tüm yönergeleri ve araç örneklerini baştan vermek yerine, ifade gücü yüksek arayüzler ve ihtiyaç duyulan anda bilgi/araçları çağıran kademeli açımlama (progressive disclosure) uygulanıyor
• CLAUDE.md’de yalnızca deponun tuzaklarını kısa biçimde kaydetmek, uzun yönergeleri Skills’e ayırmak ve şartnameler, test paketleri, HTML maketleri, kod ve değerlendirme rubrikleri gibi zengin referans materyallerinden yararlanan bir yapı öneriliyor
• /doctor ve claude doctor ile Skills ve CLAUDE.md’nin boyutu ayarlanabilir; güncel modellerin bağlamı tekrarları ve aşırı kısıtları azaltacak ve gerektiğinde ilgili bilgiyi bulacak şekilde yapılandırılmalı

---

İstemlerin ötesinde bağlam mühendisliği

• Claude bir mesajı işlerken kullanıcı istemi toplam bağlamın yalnızca bir parçasıdır; geri kalanı sistem istemi, Skills, CLAUDE.md, bellek vb. üzerinden birleştirilir
• Bağlam mühendisliği birden fazla isteğe ortak uygulandığı için tekil istemler kadar spesifik yazılması zordur, ancak Claude Code ve özel ajanların sonuçları üzerinde büyük etkisi vardır
• Kullanıcı isteğini önceden bilmeden genel istemler ve yönergeler tasarlamak gerekir; Claude’un yetenekleri geliştikçe uygun yöntem de değişir
• Claude Opus 5 ve Claude Fable 5’te, Claude Code sistem isteminin %80’den fazlasını silmek kodlama değerlendirmelerinde ölçülebilir bir performans düşüşüne yol açmadı
• Bu en iyi uygulamalar claude doctora yansıtıldı; Claude Code’da /doctor ile Skills ve CLAUDE.md uygun boyuta getirilebilir

Modeli aşırı kısıtlardan serbest bırakmak

• Mevcut Claude Code, yalnızca sistem isteminde değil CLAUDE.md ve Skills içinde de aşırı fazla kısıtlamaya maruz kalıyordu
  • Tek bir istekte “uygun dokümantasyon bırak” ile “yorum ekleme” gibi yönergeler sistem istemi, Skills ve kullanıcı isteği üzerinden çakışabiliyordu
  • Claude kullanıcı niyetini yorumlayabilse bile, örtüşen veya çakışan yönergeler nedeniyle nasıl davranacağına karar vermeden önce daha dikkatli düşünmek zorunda kalıyordu
• Geçmişte en kötü durumları önlemek için bu kısıtlamalar gerekliydi; ancak güncel modellerde birçok kısıt kaldırılıp çevredeki bağlam ve kendi muhakemesinden yararlanması sağlanabilir
• Claude Code’un kullanabileceği araçlar da arttı
  • Geçmişte CLAUDE.md bellek, bilgi ve yönergelerin ana deposuydu
  • Bugün bellek, artifacts ve Skills aracılığıyla oturumlar arasında bağlam çağrılabilir ve paylaşılabilir

Sabit kurallar yerine bağlama dayalı muhakemeden yararlanmak

• İlk Claude Code’da dosya silme gibi en kötü durumları önlemek için her zaman uygun olmayan güçlü yönergeler yer alıyordu
• Önceki sistem istemi, kodda varsayılan olarak yorum yazılmamasını, birden fazla paragraftan oluşan docstring’leri veya çok satırlı yorumları yasaklamayı ve kullanıcı istemedikçe plan, karar alma ya da analiz dokümanları oluşturulmamasını gerektiriyordu
• Bu kurallar bazı isteklerde uygunsuz olabilir
  • Kullanıcının ayrı dokümantasyon tercihleri olabilir
  • Karmaşık kodun belirli bölümlerinde çok satırlı yorumlar gerekebilir
• Eski modeller, koruma önlemleri olmadığında sıkça hatalı yorumlar yazdığı için bu ödünler gerekliydi; güncel modeller ise açık kurallar olmadan da ilgili kararları daha iyi yönetiyor
• Yeni sistem istemi, “çevredeki kod gibi okunan kod yaz; yorum yoğunluğunu, adlandırmayı ve deyimsel kullanımları eşleştir” şeklinde bağlama dayalı yönergeler kullanıyor

Örnekler yerine ifade gücü yüksek arayüzler tasarlamak

• Geçmişte araç kullanımındaki temel kural, Claude’a kullanım örnekleri vermekti
• Güncel modellerde örnekler keşif alanını belirli bir bölgeyle sınırlayabildiğinden, araçların, betiklerin ve dosyaların arayüzü ile parametre ifade gücüne öncelik verilmeli
• Todo aracının status değerini pending, in_progress, completed enum’u olarak tanımlamak, kullanım biçimini doğal olarak ima edebilir
• Yalnızca bir öğenin in_progress olarak tutulması yönergesi, istenen davranışı arayüz düzeyinde somutlaştırır

Bilgiyi gereken anda açan kademeli açımlama

• Claude Code’un kodlamaya odaklandığı ilk dönemde, kod inceleme ve doğrulama yöntemleri sistem istemine ayrıntılı biçimde eklenmişti
• Bu bilgiler her zaman gerekli değildi, ancak belirli görevlerde önemliydi
• Artık gerekli anda uygun bağlamı çağıran kademeli açımlama kullanılabilir
  • Doğrulama ve kod inceleme yönergeleri ayrı birer Skill’e taşınıp Claude Code’un bunları seçerek çağırması sağlanır
  • Bazı araçlar gecikmeli yüklenir; ajan, kullanmadan önce ToolSearch ile tam tanımı aramalıdır
  • Task aracı gibi çok sayıda araç sunulurken, gerekene kadar bağlamda yer kaplamaması sağlanabilir
• CLAUDE.md ve Skill.md’yi olası tüm pratiklerin merkezi deposu hâline getirmeye gerek yoktur
• Bunun yerine gerektiğinde çağrılan bir dosya ağacı olarak yapılandırılabilir; bu yaklaşım göreve özel dinamik iş akışı harness’ı içinde de ele alınır

Tekrarlanan yönergeleri basit araç açıklamalarında birleştirmek

• Önceki Claude modellerinde aynı yönergeyi tekrar etmek gerekebiliyordu ve bağlamın başındaki yönergelerden çok sonundakilere daha iyi uyduğu durumlar olabiliyordu
• Bu nedenle aynı araç kullanım yönergeleri veya örnekleri hem sistem istemi metnine hem de araç açıklamalarına konuyordu
• Güncel modellerde tekrarlanan örnekler silinip araç kullanımı yalnızca araç açıklamasına yerleştirilebilir

CLAUDE.md’den otomatik belleğe geçiş

• Geçmişte # kısayoluyla bilgilerin otomatik olarak CLAUDE.md içine yazılması sağlanıyor ve kullanıcıların Claude’un belleğini doğrudan kaydetmesi teşvik ediliyordu
• Bugün Claude, görev ve kullanıcıyla ilgili bilgileri otomatik olarak belleğe alıyor

Basit şartnamelerin ötesinde zengin referans materyalleri

• Plan modundaki Claude Code, gerektiğinde tekrar başvurmak için Markdown plan dosyalarına büyük ölçüde dayanıyordu; uzun vadeli projelerde şartnameler kod tabanı içinde de saklanıyordu
• Güncel Claude, daha karmaşık biçimlerdeki referans materyallerini işleyebilir
  • Yeni artifact özelliğiyle oluşturulan HTML artifact’leri
  • Başka bir kod tabanından taşınacak işlevler gibi kodlar
  • Ayrıntılı test paketleriyle ifade edilen şartnameler
• Değerlendirme rubriği (rubric), belirli bir alandaki zevkleri veya kalite ölçütlerini Claude’un denemesi ve doğrulaması için başka bir referans biçimidir
  • İyi API tasarımının ne olduğu gibi ölçütler tanımlanabilir
  • Dinamik iş akışıyla bu değerlendirme rubriğini kullanan bir doğrulama ajanı oluşturulabilir

Bağlam bileşenlerinin rolleri

• Sistem istemi

  • Ürün bağlamıyla yakından bağlantılıdır ve Claude’a hangi ürün içinde ne tür bir iş yaptığını söyler
  • Claude Code kullanıcılarının bunu değiştirmesi nadiren gerekir; ancak özel bir ajan harness’ı oluşturuyorsanız çok zaman harcamanız gereken alandır

• CLAUDE.md

  • Hafif tutulmalı ve deponun amacı kısaca anlatılmalı; token’ların çoğu kod tabanı içindeki dikkat edilmesi gereken tuzakları kaydetmek için kullanılmalıdır
  • Tüm tipleri tek bir dosyada tutma gibi depo kuralları kayda değerdir
  • Dosya sistemi veya depoyu inceleyerek Claude’un anlayabileceği bariz bilgilerden kaçınılmalıdır
  • Görev doğrulaması için birden fazla özgün yönerge varsa bir doğrulama Skill’i oluşturup CLAUDE.md’den ona referans vererek kademeli açımlama uygulanır

• Skills

  • Claude’un gerektiğinde bilgiyi bulmasına yardımcı olan hafif kılavuzlar olarak yapılandırılır
  • Çok kritik bir alan değilse aşırı kısıtlardan kaçınılmalıdır
  • Uzun Skill’lerin birden fazla dosyaya bölünüp kademeli olarak çağrılması daha iyidir
  • Kişiye, ekibe veya ürüne özgü görüşleri, bilgiyi ve en iyi uygulamaları barındırırken en faydalıdır

• Referans materyalleri

  • Dosyalar @ ile mention edildiğinde Claude mevcut planla ilgili ayrıntıları kontrol edebilir
  • Şartname dosyaları, maketler ve tüm kod tabanı da referans materyali olabilir
  • Kod, Claude’un iyi bildiği bir dilde açık ve sadık yönergeler sağladığından genellikle kod biçimindeki dosyalara öncelik vermek daha iyidir
  • Tasarım açıklamaları veya ekran görüntülerine kıyasla HTML tasarım maketleri genellikle daha iyi sonuç üretir

Mevcut bağlamı basitleştirmek

• Sistem istemi, Skills ve CLAUDE.md genelinde gereksiz kurallar, tekrarlar ve bilgiler silinerek bağlam basitleştirilmelidir
• claude doctor komutu bu basitleştirme işini otomatik olarak destekler
• Gelişmiş modeller için istem yazma yöntemleri hakkında daha fazlası Claude Fable saha rehberi içinde bulunabilir