Daha önce, Claude 5 modellerinin en yeni neslini nasıl en iyi şekilde yönlendireceğiniz ve ne inşa etmek istediğinizi keşfetmek için onlarla yinelemeli olarak nasıl çalışacağınız hakkında yazmıştım.
Ancak Claude'a bir mesaj gönderdiğinizde, prompt, aldığı bağlamın yalnızca küçük bir parçasıdır. Bağlamınızın büyük bir kısmı, sistem promptunuz, Yetenekleriniz, CLAUDE.md dosyalarınız, hafızanız ve diğer kaynaklardan derlenir. Buna bağlam mühendisliği diyoruz ve Claude Code kullanırken veya kendi aracılarınızı oluştururken ürettiğiniz sonuçlar üzerinde büyük bir etkiye sahiptir.
Bir prompttan farklı olarak, bağlam genellikle birçok istekte genel olarak kullanılır, bu nedenle çok spesifik olamaz. Claude için bu genel promptları ve yönergeleri, özellikle de bir kullanıcının promptunun ne olabileceğini bilmediğinizde nasıl oluşturursunuz?
Claude'un kendi yetenekleri geliştikçe bu şaşırtıcı derecede zor olabilir. En son olarak, en yeni nesil Claude modellerini yönlendirme şeklimizde büyük bir sıçrama fark ettik. Claude Opus 5 ve Claude Fable 5 gibi modeller için Claude Code'un sistem promptunun %80'inden fazlasını, kodlama değerlendirmelerimizde ölçülebilir bir kayıp olmadan kaldırdık.
İşte bu yeni model sınıfını yönlendirme konusunda öğrendiklerimiz ve bağlam mühendisliğinizi güncellemek için bunu nasıl kullanabileceğiniz. Bu en iyi uygulamaları claude doctor'a koyduk, Claude Code'da becerilerinizi ve CLAUDE.md dosyalarınızı doğru boyutlandırmak için /doctor komutunu kullanın.
Claude'u Özgürleştirmek
Genel olarak, Claude Code'u hem sistem promptumuz hem de CLAUDE.md dosyalarımız ve becerilerimiz aracılığıyla aşırı kısıtladığımızı gördük.
Örneğin, Claude Code'un kendi dahili kullanımımıza ait dökümleri okuduğumuzda, sistem promptumuz, becerilerimiz ve kullanıcı isteklerinin birbiriyle çatışması sonucu tek bir istekte "belgelendirmeyi uygun şekilde bırakın" veya "yorum eklemeyin" gibi birbiriyle çelişen birkaç mesaj görüyoruz.
Genel olarak, Claude doğru cevaba ulaşmak için kullanıcının niyetini yorumlayabilir, ancak Claude'un ne yapacağına karar vermeden önce bu örtüşen ve çelişen mesajlar hakkında daha dikkatli düşünmesi gerekir.
Ve bu kısıtlamalar bir zamanlar en kötü senaryolardan kaçınmak için gerekli olsa da, o zamandan beri birçoğunu silebileceğimizi ve bunun yerine modelin çevresel bağlamı ve muhakemesini kullanmasına izin verebileceğimizi gördük.
Ayrıca, Claude Code'un artık çok daha fazla aracı var. Claude eskiden bir hafıza, bilgi ve rehberlik kaynağı olarak CLAUDE.md'ye güveniyordu. Artık, Claude'un bağlamı oturumlar arasında yükleme ve paylaşmanın yeni yollarını oluşturmak için kullanabileceği hafıza, yapay nesneler ve becerilerimiz var.
Eskiden ve Şimdi
Daha önceki birçok bağlam mühendisliği en iyi uygulaması efsane haline gelmişti. Bunlar şunları içeriyor:
**
Eskiden: Claude'a kurallar verin
Şimdi: Claude'un muhakeme kullanmasına izin verin
**Claude Code'u ilk kullanıma sunduğumuzda, Claude'un dosya silmek gibi en kötü senaryolardan kaçındığından emin olmamız gerekiyordu. Bu, her zaman doğru olmayabilecek özellikle güçlü yönergeler vermemiz anlamına geliyordu. Örneğin, sistem promptunda şöyle derdik:
Kodda: varsayılan olarak yorum yazmayın. Asla çok paragraflı docstring'ler veya çok satırlı yorum blokları yazmayın — en fazla bir kısa satır. Kullanıcı istemedikçe planlama, karar veya analiz belgeleri oluşturmayın — ara dosyalardan değil, sohbet bağlamından çalışın.
Ancak belirli bir prompt alt kümesi için bu yönerge yanlış olurdu. Dokümantasyon söz konusu olduğunda, kullanıcının kendi tercihleri olabilir veya çok karmaşık kodun belirli kısımları çok satırlı yorum blokları gerektirebilir.
Yine de, eski modeller için bu korumalar olmadan, Claude'un yazdığı yorumlar birçok durumda yanlış olurdu ve bu takası kabul etmek zorundaydık. Ancak daha yeni modeller daha iyi muhakemeye sahiptir ve bu kararları açık kurallar olmadan iyi bir şekilde yönetebilir.
Yeni sistem promptunda şöyle diyoruz: Çevreleyen kod gibi okunan kod yazın: yorum yoğunluğunu, adlandırmayı ve deyimi eşleştirin.
**Eskiden: Claude'a örnekler verin
Şimdi: Arayüzler tasarlayın
**Araç kullanımı için bir numaralı kural, Claude'a bunların nasıl kullanılacağına dair örnekler vermekti. En yeni modellerimizle, örnek vermenin aslında onları belirli bir keşif alanına sınırladığını gördük.
Örnekler kullanmak yerine, araçlarınızın, betiklerinizin ve dosyalarınızın tasarımı hakkında daha fazla düşünün — Claude'un hangi parametreleri var ve bunlar nasıl daha anlamlı hale getirilebilir?
Örneğin, Todo aracı örneğinde, durumu yalnızca pending, in_progress ve completed arasında bir numaralandırma olarak listelemek, Claude'a onu nasıl kullanacağına dair ipucu verir. Bir öğeyi in_progress'te tutma talimatı, istenen davranışı tanımlamaya yardımcı olur.
**Eskiden: Hepsini en başta koyun
Şimdi: Aşamalı açıklama kullanın**
Claude Code kodlamaya odaklandığından, sistem promptumuz kod incelemesi ve doğrulamasının nasıl yapılacağına dair ayrıntılı bilgiler içeriyordu. Bunlar her zaman gerekli değildi, ancak gerekli olduklarında çok önemli bilgilerdi.
O zamandan beri, Claude Code aşamalı açıklamayı kullanma konusunda oldukça yetkin hale geldi — doğru bağlamı doğru zamanda yükleme. Örneğin, doğrulama ve kod incelemesini, Claude Code'un seçerek çağırabileceği kendi becerilerine taşıdık.
Ancak aşamalı açıklama yalnızca beceriler için değil, aynı zamanda araçlar için de geçerlidir. Bazı araçlarımız 'ertelenmiş yükleme'dir, yani aracı kullanmadan önce tam tanımlarını ToolSearch kullanarak araması gerekir. Bu, ihtiyaç duyulana kadar bağlamı işgal etmeyen daha fazla araca (Görev araçlarımız gibi) sahip olmamızı sağlar.
Aynısı kendi CLAUDE.md ve Skill.md dosyalarınız için de uygulanabilir. Yaygın bir efsane, bunları, karşılaşabileceğiniz her bilinen uygulama için merkezi bir depo haline getirmek istemenizdir, çünkü Claude aksi takdirde onu bulamaz. Bunun yerine, doğru zamanda yüklenebilecek bir dosya ağacına sahip olmayı düşünün.
**Eskiden: Kendinizi tekrarlayın
Şimdi: Basit araç açıklamaları**
Önceki Claude modelleri bazen tekrarlanan talimatlara ihtiyaç duyabiliyor veya talimatları bağlam pencerelerinin başındakinden ziyade sonundakilere daha fazla uyma olasılığı gösterebiliyordu. Bu, sistem promptumuzun bazen ana sistem promptunda araçlara yapılan atıfların yanı sıra araç açıklamasındaki talimatları da içerdiği anlamına geliyordu.
Bu tekrarlanan örnekleri silebileceğimizi ve araçların nasıl kullanılacağına dair talimatları sistem promptu yerine araç açıklamalarına koyabileceğimizi gördük.
**Eskiden: CLAUDE.md dosyalarında hafıza
Şimdi: Otomatik hafıza**
Eskiden kullanıcıları, # kısayolunu kullanarak otomatik olarak CLAUDE.md dosyalarına yazmak suretiyle bir şeyleri Claude'un hafızasına kaydetmeye teşvik ediyorduk. Bunun yerine, Claude artık çalışmayla ve sizinle ilgili olan hafızaları otomatik olarak kaydediyor.
**Eskiden: Basit şartnameler
Şimdi: Zengin referanslar**
Plan modunda, Claude Code büyük ölçüde planlar içeren markdown dosyalarına güveniyordu. Bu dosyaları plan olarak depolamak, Claude'un gerektiğinde onlara başvurmasına yardımcı oluyordu. Diğer bir benzer en iyi uygulama da, Claude'un daha uzun projeler üzerinde çalışırken başvurması için şartnameleri kod tabanında depolamaktı.
Ancak Claude'un giderek daha karmaşık referansları işleyebildiğini gördük. Basit markdown dosyaları yerine Claude, yeni yapay nesne özelliğimiz tarafından oluşturulan HTML yapay nesnelerine başvurabilir.
Ayrıca Claude'a kod biçiminde referanslar verebilirsiniz. Bir şartname, ayrıntılı bir test paketi veya Claude'un taşıyabileceği farklı bir kod tabanındaki bir işlev de olabilir.
Değerlendirme tabloları (rubric'ler), başka bir referans biçimidir. Değerlendirme tabloları, Claude'un belirli bir alandaki zevkinizi doğrulamaya çalışmasına (örneğin, iyi bir API tasarımı nasıl görünür) dinamik iş akışları kullanarak ve bu değerlendirme tablolarıyla doğrulayıcı aracılar başlatarak olanak tanır.
Bunu bağlamınıza uygulama
Tüm bunları bir araya getirdiğimizde, bağlamınızı birleştirirken bu nasıl görünüyor?
**Sistem Promptu
**Bir sistem promptu, ürün bağlamına sıkı sıkıya bağlıdır. Claude'a hangi üründe çalıştığını ve ne yaptığını söyler. Claude Code için bunu muhtemelen asla değiştirmeyeceksiniz, ancak kendi aracı kabloğunuzu oluşturuyorsanız, zamanınızın çoğunu burada harcamanız gerekir.
**CLAUDE.md
**CLAUDE.md dosyanızı hafif tutun ve deponuzun ne için olduğunu kısaca açıklayın, ancak belirteçlerin çoğunu kod tabanındaki tuzaklara (gotchas) ayırın. Örneğin, kodunuzu türleri tek bir büyük dosyada ve başka hiçbir yerde tutacak şekilde düzenleyebilirsiniz. Claude'un dosya sisteminize veya deponuza bakarak bilmesi gereken 'bariz' şeyleri belirtmekten kaçının.
Daha fazla ayrıntı için aşamalı açıklama kullanın; örneğin, çalışmanızı nasıl doğrulayacağınıza dair birkaç benzersiz talimatınız varsa, bir doğrulama becerisi oluşturun ve CLAUDE.md dosyanızdan buna referans verin.
**Beceriler
**Becerileri, gerektiğinde Claude'un bilgi bulmasına izin veren hafif kılavuzlar olarak düşünün. Son derece önemli alanlar dışında, onları aşırı kısıtlayıcı hale getirmekten kaçının.
Uzun beceriler için, mümkün olduğunca aşamalı açıklama kullanmaya çalışın — bunu birçok dosyaya bölün ve ayırın.
Becerilerin, size, ekibinize veya ürününüze özgü belirli görüşleri, bilgileri veya en iyi uygulamaları kodlaması en iyisidir.
**Referanslar
**Bunları referans olarak dahil etmek için dosyalardan @mention ile bahsedebilirsiniz. Referanslar, Claude'un mevcut plan hakkında derinlemesine bilgilere başvurmasına olanak tanır.
Bu, şartname dosyalarında, maketlerde veya hatta tüm kod tabanlarında olabilir. Genel olarak, Claude'un çok iyi bildiği bir dilde net, yüksek doğrulukta talimatlar sağladığı için kod biçimindeki dosyaları tercih etmelisiniz. Örneğin, bir tasarımın HTML maketi, genellikle tasarımın bir açıklamasından veya ekran görüntüsünden daha iyi sonuçlar verecektir.
Basitleştirmeyi deneyin
Sistem promptunuz, becerileriniz ve CLAUDE.md dosyalarınız genelinde, tıpkı bizim yaptığımız gibi basitleştirmeniz gerekebilir. claude doctor adında, bunu otomatik olarak yapmanıza yardımcı olacak yeni bir komut kullanıma sunduk. Daha gelişmiş modelleri özel olarak yönlendirme hakkında daha fazla ayrıntı için Fable saha rehberimize göz atın.
