Bu hafta sonu oturup tüm Claude kurulumumu silmeyi değerlendirdim. Revize etmeyi değil, silmeyi değerlendirdim. CLAUDE.md, kancalar (hook), beceriler (skill), kötü geçen her oturumdan sonra yazdığım 6 aylık talimatlar. Eğitimde anlattıklarımın tam tersi !
Bunun nedeni, Boris Cherny, Claude Code’u yapan adamın Y Combinator Startup School 2026’da Diana Hu ile yaptığı söyleşide bunu söylemesi.
Boris Cherny ne söyledi?
Bu söyleşide Claude Code’un nasıl kurulduğunu ve Opus 5 sonrası ürün geliştirmenin nasıl değiştiğini anlattı. Söyledikleri arasında en çarpıcısı ve beni etkileyen:
“Sistem promptunun %80’ini sildik.”
Yani ürünün içinde çalışan CLAUDE.md dosyamız. “Opus 5 ve Fable 5 için beşte dördü kesildi. Model daha iyi çalıştı” dedi.
“Ajan tabanlı ürün geliştirmiyor ama Claude Code kullanıyorsan, her 6 ayda bir Claude MD dosyanı sil. Becerilerini sil. Kancalarını sil. Modelin ne yaptığına bak, seni şaşırtabilir.” diye tavsiyede bulundu.
Bu benim Claude ayarlarımı sorgulamam için ciddi bir değerlendirme oldu. Daha yeni ikinci beyni oluşturmuştum.
İkinci Beynini Kurmak
Geçen cuma kendime Yapay Zeka ile çalışan bir genel sekreter kurdum; 40 dakika sürdü.
Peki bu hafta sonu ne yaptım ve ne yapmadım?
Önce terminolojiyi anlayalım
Basit anlatacağım, çünkü bu kelimeler herkes zaten biliyormuş gibi uzun zamandır ortalıkta dolaşıyor.
CLAUDE.md, Claude Code’un her oturumun başında okuduğu proje veya kullanıcı talimat dosyasıdır.
Genelde yapılan hata, ne işe yaradığını yanlış kurmak ve burayı her şeyin yaşadığı yer olarak kullanmak. Bütün kuralları, hafızayı, talimatları bu dosya içine koymak. Oysa orası dosya dolabı değil, danışma masası.
Unutma: CLAUDE.md → sade sabit özet. Claude bunu sen tek kelime yazmadan, her oturumda okur ve sen hiçbir zaman tetiklemezsin. /init ile kur, sonra kendin için düzenle.
Benim CLAUDE.md dosyam 94 satır. İçinde kim olduğum, şu an yürüyen işlerim, kullandığım araçların özeti, Claude’dan beklediğim işler, bana nasıl cevap vereceği ve benim için değişmez kurallar ve aslalar var. 200 satırın altında olması önemli.
Boris’in söylediği bu dosya zamanla şunlarla dolabilir:
Eski model davranışlarına göre yazılmış kurallar.
Artık geçerli olmayan klasör ve komut yolları.
“Her zaman temiz kod yaz”, “her şeyi iki kez kontrol et” gibi genel talimatlar.
Birbiriyle çelişen veya gereksiz derecede uzun yönergeler.
Daha yeni modellerin zaten iyi yaptığı işleri tekrar tarif eden kurallar.
Dolayısıyla amaç dosyayı körü körüne yok etmekten çok, içeriğini temizlemek.
Henüz kurmadın mı?
En hızlı yol Boris’inkiyle başlamak.
Şunu yapıştır:
CLAUDE.md dosyamı sıfırdan kurmama yardım et. Boris Cherny'nin CLAUDE.md dosyasını başlangıç şablonu olarak kullan. Bana işimi, sesimi, yasaklı kelimelerimi, varsayılan çıktı formatımı ve seninle nasıl çalışmak istediğimi sor. Son dosyayı ~/CLAUDE.md konumuna kaydet.Claude, seninle röportaj yapar, sen cevaplarsın ve dosyayı o yazar.
Claude’a bir şeyin yanlış olduğunu söylediğimde, bunu CLAUDE.md dosyama değil kendi hafızasına yazıyor. Oturum sonunda çalıştırdığım bir skill de o düzeltmeleri doğru hafıza dosyasına yerleştiriyor. Bu, ona bir şey söylediğinde her seferinde büyüyen bir metin dosyası.
Şimdi elindekini denetle
Hadi denetlemeye başlayalım. Önce modeli seçiyoruz.
/model Opus 5
Aşağıdaki promptu yapıştır. Bu prompt, önce Anthropic’in güncel prompt rehberini çekiyor, seçtiğin modelin güçlü olduğu yerleri buluyor, dosyanı buna göre güncelliyor.
Prompt:
Claude talimatlarım eski modeller için yazıldı. Anthropic'in güncel rehberine göre denetle ve neyi silmem gerektiğini söyle.
1. ÖNCE CANLI KURALLARI ÇEK. Anthropic'in prompt en iyi uygulamalar sayfasını ve kullandığım modelin sayfasını oku. Bugün yayınlanmış olanı kullan, hatırladığını değil.
2. SATIR SATIR GİT. Her talimat için tek karar: SİL, KORU ya da YENİDEN YAZ, gerekçesi sade Türkçeyle.
3. KAYNAĞINI ALINTILA. Her SİL kararı, onu gerekçelendiren cümleyi Anthropic'in rehberinden alıntılasın. Bulamıyorsan karar KORU olur. Asla kaynak uydurma.
4. "İKİ KEZ DOĞRULA" KURALINI İŞARETLE. "Her zaman işini doğrula", "cevap vermeden önce iki kez kontrol et" gibi. Model zaten kendini düzeltiyor. Bunlar işi iki kez yaptırıyor ve ikisinin de parasını ben ödüyorum.
5. "SADECE BÜYÜK SORUNLARI BİLDİR" KURALINI İŞARETLE. Kelimesi kelimesine uygulanıyor, sonuçta istediğimden az bilgi alıyorum. Şununla değiştir: her şeyi bildir, filtrelemeyi ben yaparım.
6. HER "FAZLA DÜŞÜNME" KURALINI İŞARETLE. Düşünmeyi engelleyen kurallar, iç etiketlerin cevaba sızmasına yol açıyor. Kes.
7. ROL DOLGUSUNU İŞARETLE. "20 yıllık deneyime sahip bir uzmansın" bir zamanlar iyi tavsiyeydi. Artık isteğe bağlı. Rolü sadece çıktıyı gerçekten değiştirdiği yerde bırak.
8. ESKİ ÖRNEKLERİ İŞARETLE. Eski model için yazılmış örnekler eski alışkanlık öğretiyor. Bir güncel örnek, on bayat örnekten iyidir.
9. DOĞRULUK KURALINA DOKUNMA. "Sadece doğruladığın şeyi iddia et" bir önem filtresi değil, uydurma bilgiyi engelliyor. Başka ne giderse gitsin bu tür kurallar kalır.
10. EKSİK OLANI SÖYLE. Yeni modeller eskilerin ihtiyaç duymadığı beş talimata ihtiyaç duyuyor: cevapları kısa tut, doküman uzunluğuna sınır koy, çalışırken beni nasıl bilgilendireceğini söyle, görev kapsamını koru, açacağın yardımcı ajan sayısını sınırla.
SONRA BANA ŞUNLARI VER:
- Tablo halinde her talimat için bir satır: benim satırım, karar, gerekçe ve Anthropic'in cümlesi.
- Eksik beş talimatın her biri için yapıştırılacak tam metin.
- Dürüst sayım. "307 satır girdi. 4 silme, 4 yeniden yazma, 5 ekleme."
- Kontrol edemediklerin, ÇALIŞTIRILMADI olarak işaretli. Doğru olmayan temiz raporu asla verme.
VE DÜRÜST OL:
- Dosyamın çoğu gitmeli ise bunu açıkça söyle. En çok gurur duyduğum yapı büyük ihtimalle ilk kurban olacak.
Talimatlarım aşağıda. Başla.Senin tek bir satırını yargılamadan önce Anthropic’in canlı dokümanlarını okuyor.
Sonra bir plan veriyor. Bu benimki: Denetim çıktısı: 94 satır girdi, 2 silme, 4 yeniden yazma, 3 ekleme
Yapıştırdığın anda hiçbir şey silinmiyor. Önce .claude klasörünü yedekliyor, iki yol da sana onaylayacağın bir plan veriyor. Evet demeden önce önerilerini lütfen tam oku.
Beceriler (Skill) → kaydettiğin bir iş akışı
Beceriler, kaydedip isim verdiğin bir prompt. İş akışını bir kez yazıyorsun, sonra tüm promptu tekrar yazmak yerine tek bir eğik çizgi komutu yazıyorsun. Her sohbette, her klasörde.
Bende 195 tane vardı. Öylece durdukları için hiçbir maliyetleri yok, çünkü sadece çağırdığın yükleniyor. Sorun hiçbir zaman kaç tane olduğu değil. Kaç tanesinin aynı işi yaptığı.
Bunu çözen prompt aşağıdaki denetimin içinde.
İlk çalıştıracağım prompt bu:
Skill klasörümü çakışma ve gereksiz skiller için denetle. Hiçbir şey silme.
1. Her skill'i adıyla ve ne yaptığını kısaca anlatan listeyi oluştur.
2. Onları isimlerine göre değil, YAPTIKLARI İŞE göre grupla. Aynı işi farklı kelimelerle yapan skill'ler aynı skill'dir.
3. İki veya daha fazla üyeli her grup için hangisini tutacağımı ve nedenini söyle, diğerlerinde olup onda olmayanı tam olarak yaz.
4. Hiç kullanmadığım skill'i işaretle.
5. Sadece artık var olmayan bir dosya ya da klasör sayesinde çalışan her skill'i işaretle.
Sonra en büyük grubun TEK birleştirilmiş versiyonunu, kaydedilmeye hazır şekilde tam olarak yaz. Birleştirince neyi kaybettiğimi söyle.Skill’lerini geziyor, aynı işi yapanları buluyor, hangisini tutacağını söylüyor. Hiçbir şey silmiyor.
Kancalar (hook) → otomatik tetikleyici
Bu beni uzun süre yanılttı.
CLAUDE.md’deki bir kural rica ise, “hook” Claude canı istese de istemese de çalışan kuraldır. Kurabileceğin en basit hali: “LinkedIn” kelimesini söylediğimde bana bir LinkedIn postu yaz. İşte bu bir hook. Ona hiçbirşey söylemiyorum. Sadece kelimeyi söylüyorum.
Hook ile skill’in buluştuğu yer burası. Kelime “hook”; gidip getirdiği şey “skill”. Bu eşleşmeyi Claude içinde hiçbir yerde göremiyorsun, zaten bir sürüsüne sahip olduğumu anlamamın bu kadar uzun sürmesinin sebebi de bu.
Neyi tekrarladığını bularak başla. Şunu yapıştır:
Neyi hook'a çevirmem gerektiğini bulmama yardım et.
Son sohbetlerimize bak ve şunları bul:
1. Aşağı yukarı aynı kelimelerle tekrar tekrar istediğim şeyler.
2. Sana zaten bilmen gereken bir şeyi söylemek zorunda kaldığım anlar.
3. Bir kereden fazla düzeltmek zorunda kaldığım şeyler.
Her biri için bana şunu söyle:
- onu istediğimde gerçekten söylediğim kelime ya da ifade
- o kelimeyi söylediğim anda gidip okuman ya da yapman gereken şey
- o kelimenin kazara tetiklenmeyecek kadar benzersiz olup olmadığı
Bana en iyi üçünü, en iyisi başta olacak şekilde sıralı ver. Henüz hiçbir şey kurma.Sonra Claude’a en üsttekini hook’a çevirmesini söylüyorsun. Özel bir komut ya da konfigürasyon gerekmiyor. Sen tarif ediyorsun, o kuruyor ve kaydetmeden önce sana gösteriyor.
Hazır oradayken CLAUDE.md dosyana şunu da eklemeye değer:
Bir oturumda aynı şeyi senden üç kez istersem, bana söyle ve bunu bir hook olarak öner.Birkaç tane biriktiğinde de denetle. Bu, eklentilerle gelenler dahil hepsini listeliyor:
Kurduğum her hook'u denetle. Hiçbir şeyi değiştirme ya da silme.
1. Hepsini listele. Her biri için: neyin tetiklediği, ne zaman çalıştığı ve gerçekte ne yaptığı kısaca anlat.
2. HER mesajda çalışanları söyle. Pahalı olanlar onlar, ya gerekçelerini isterim ya da giderler.
3. Fazla yaygın olan her tetikleyici kelimeyi işaretle. Normal konuşmada geçen bir kelime varsa, hook ben istemediğim anda çalışır.
4. Aynı anda çalışabilecek iki hook'u işaretle ve çalıştıklarında ne olduğunu söyle.
5. Artık var olmayan bir dosyayı ya da klasörü işaret eden her hook'u işaretle.
6. Kurduğumu muhtemelen unuttuğum hangileri, söyle.
Sonra bana tablo ver: tut, düzelt ya da kaldır, her biri için tek satır gerekçe. Ben söyleyene kadar hiçbir şeye dokunma.İnsanların çoğunun yaptığı hata
Azaltmak yerine sürekli daha fazla talimat ekliyoruz. Bu, Claude’unun uzun vadeli kapasitesine zarar veriyor.
Ne kadar çok talimat yazarsan, CLAUDE.md o kadar büyüyor; model zamanla karışıyor ve daha fazla token tüketiyorsun. Birbiriyle çelişen kurallar rastgele çözülüyor ve hangisinin kazandığını hiç görmüyorsun.
Anthropic bunun için bir tavan yayınlıyor ve muhtemelen bunu bilmiyordun:
“
CLAUDE.mddosyası başına 200 satırın altını hedefleyin. Daha uzun dosyalar daha çok bağlam tüketir ve uyumu düşürür.”
Ana dosyan bilgiyi tutmamalı, bilgiyi işaret etmeli; işaret etme işini de başka bir şey senin yerine yapmalı. Ama her şey gibi bunun da zamanla bakıma ve takviyeye ihtiyacı var. Hiçbir şey bakım olmadan sonsuza kadar yalın ve verimli kalmıyor. Kısaca, bu hafta sonu benimkini silmedim, bakımını yaptım.
Bu hafta sen de seninkini yap. Çok güzel bir hafta diliyorum.