01 · Başlarken
Önce sıra bu: 3 adım
Talimat dosyanızı elle kısaltmaya kalkışmadan önce sırayı bozmayın. Claude'u yapan ekip, kendi kural kitabını küçültürken bu üç adımı izledi — siz de aynı sırayla başlayın.
1) ÖNCE > Claude Code'a /doctor yaz — talimat dosyalarını ve rehberlerini doğru boyuta getirir
2) SONRA > dosyanda birbirine ters düşen satırları ara ("açıklama bırak" ile "yorum ekleme" gibi)
3) SONRA > aşağıdaki 6 kuralla yukarıdan aşağı in — her satıra "sil mi, bırak mı?" sorİkinci adım boşuna değil: her çelişen çiftin bir bedeli var. Kurallar birbirine ters düşünce Claude, işi çözmeden önce kuralları çözmek için fazladan düşünmek zorunda kalıyor — bunu Claude'u yapan ekip kendi kayıtlarında görmüş.
02 · Kural 1
Yasağın yerine referans koy
Katı bir yasak bazen yanlışa döner: kullanıcının kendi tercihi olabilir, karmaşık bir iş gerçekten uzun açıklama isteyebilir. Yasak eskir; bir referans noktası her durumda çalışır.
sil
"Yorum yazma. Asla çok satırlı açıklama bloğu yazma; en fazla tek kısa satır."
bırak
"Etrafındaki koda uy: yorum sıklığına, adlandırmaya, üsluba."
Bu, Claude'u yapan ekibin kendi talimat dosyasında birebir yaptığı değişim. Kontrol sorusu: Bu satır bir yasak mı, bir referans noktası mı? Yasaksa referansa çevirin.
03 · Elle başlamadan önce
/doctor: silme korkusuna ilk cevap
Claude Code içinde /doctor yazarsınız; talimat dosyalarını ve rehberlerini "doğru boyuta getirir". Elle kısaltmaya başlamadan önceki en güvenli ilk adım — büyük bir temizlikten sonra kontrol için de kullanılır.
/doctor
# talimat dosyalarını ve rehberleri doğru boyuta getirirSilme korkunuza kanıt: Claude'u yapan ekip kendi kural kitabının %80'inden fazlasını sildi; kodlama testlerinde ölçülebilir kayıp sıfır çıktı. Aşağıdaki 6 kural bu temizliğin nasıl yapıldığını, tam sil/bırak örnekleriyle sizin dosyanıza taşıyor.
04 · Kural 2
Örnek verdikçe Claude'un alanı daralıyor
Eskiden bir aracı anlatmanın 1 numaralı yolu örnek vermekti. Ama örnek, Claude'un keşif alanını daraltıyor — onu kalıba sokuyor. Yeni yol: aracın veya dosyanın düzenini öyle kurun ki nasıl kullanılacağı kendinden belli olsun.
sil
Talimatınıza döşediğiniz uydurma kullanım örnekleri: "mesela şöyle yazarsın: ..." blokları.
bırak
Adı ve sırası kendini anlatan bir düzen — kaynağın kendi örneği: bir işi listelerken durumları BEKLİYOR → YAPILIYOR → BİTTİ diye sıralamak, nasıl kullanılacağını kendisi söylüyor.
"Aynı anda tek iş YAPILIYOR'da olur" cümlesi de istenen davranışı tek satırda tanımlıyor — ayrı bir örnek eklemeye gerek kalmıyor. Kontrol sorusu: Bu örneği silsem, adlar ve sıra işi kendi anlatıyor mu? Anlatmıyorsa örneği değil düzeni düzeltin.
05 · Kural 3
"Tek dosyaya doldur" bir mit
"Her bilgi tek dosyada olmalı, yoksa Claude bulamaz" — Claude'u yapan ekibin adını koyduğu bir mit bu. Doğrusu: doğru zamanda açılan bir dosya ağacı. Her parça lazım olunca yüklenir, baştan hiçbir şeyi yemez. Ayrıca Claude dosyalara bakınca aşikâr şeyleri zaten görüyor; dosyanın gücü yalnız sizin bildiğiniz şeylere harcanmalı.
sil
"Proje ne, hangi şey nerede" tipi tanıtım satırları (Claude bakınca zaten görüyor) + her konuyu tek dev dosyada tutma alışkanlığı.
bırak
Kısacık bir "bu depo ne" cümlesi + tuzaklar: kırılgan yerler, aldatıcı ayarlar, bakınca görünmeyen kendi tercihleriniz. Dev dosyayı konu başına küçük dosyalara bölün; uzun bir rehberi de çok dosyaya bölün.
Kontrol sorusu: Bu satırı Claude dosyalara bakarak kendisi görebilir mi? Görebilirse silin.
06 · Kural 4
Talimatını iki yerde tutmak artık bedava değil
Bu kural coursel gönderisinde hiç geçmedi — burada ilk kez tam anlatılıyor.
Eski modeller, bağlamın sonundaki talimata daha çok uyuyordu. Bu yüzden aynı kural hem talimat dosyanızda hem bir aracın/rehberin kendi tanımında tekrar tekrar yazılıyordu — tekrar, modelin unutmasına karşı bir sigortaydı. Yeni modellerde bu sigortaya gerek kalmadı; tekrar artık bedava değil, her satırın bir bedeli var (az önceki çelişen-çift örneğinde olduğu gibi: tekrar arttıkça çelişme riski de artıyor).
sil
Aynı talimatın ikinci ve üçüncü kopyaları — genel dosyanızda da, bir aracın/rehberin içinde de geçen her tekrar satır.
bırak
Talimatın ait olduğu tek yer: bir araçla ilgili kural aracın kendi tanımında, bir rehberle ilgili kural rehberin içinde — bir kez.
Pratik tarama: Dosyalarınızda aynı cümleyi arayın. Bir kuralı hem genel talimat dosyanızda hem başka bir dosyada (araç tanımı, rehber, alt-klasör notu) birebir veya yakın ifadeyle görüyorsanız, ikisinden birini silin — kuralın konusuyla en çok ilgili olan yerde bırakın.
Kontrol sorusu: Bu cümle başka bir dosyada da geçiyor mu? Geçiyorsa ait olduğu yerde bırakın, diğerlerini silin.
07 · Kural 5
Elindeki not defterini Claude devraldı
Bu kural da coursel gönderisinde hiç geçmedi.
Eskiden kullanıcı bir kısayolla her önemli şeyi talimat dosyasına elle not ediyordu: "bu API'nin adı böyle", "bu klasörü kullanma", "geçen sefer şunu istemiştim" gibi günlük bilgiler birikiyordu. Artık Claude, işe ve size dair ilgili şeyleri kendisi kaydediyor — not tutma işini elle yapmanıza gerek kalmadı.
sil
"Aklımda kalsın" diye elle biriktirdiğiniz günlük not satırları; her konuşmadan sonra dosyaya bir şey ekleme alışkanlığı.
bırak
Dosyada yalnız Claude'un kendi göremeyeceği kalıcı şeyler: tuzaklar + sizin kendi tercihleriniz (Kural 3'teki süzgeçle aynı) — gündelik hafızayı Claude'un kendi kaydına bırakın.
Bu ayrımı netleştiren çerçeve şu: dosyanız bir not defteri değil, salt bir kural kitabı da değil — bir tuzak haritası. Bir kere lazım olmuş, o günkü işe özel bir bilgiyse Claude zaten kendi kaydına alıyor; sizin elle eklemenize gerek yok.
Kontrol sorusu: Bu not bir kere lazım olmuş günlük bilgi mi, kalıcı bir tuzak/tercih mi? Günlükse silin.
08 · Kural 6
Anlatacağına ver: taslak, tariften iyi
Şaşırtıcı ama Claude'u yapan ekibin açık tercihi bu: bir tasarımın kaba bir taslağı (mesela basit bir HTML dosyası), o tasarımın yazılı tarifinden ve ekran görüntüsünden daha iyi sonuç veriyor. Kod, Claude'un en iyi bildiği dil. Bir istek artık zengin referans taşıyabiliyor: çalışan bir kod parçası, bir test, başka bir projedeki bir fonksiyon, hatta "iyi iş nasıl görünür"ü maddeleyen kısa bir puanlama ölçütü.
sil
Uzun bir tarif paragrafı yazıp sonucu şansa bırakmayın; "şöyle görünsün, böyle dursun" cümle yığınları.
bırak
Kaba ama çalışan bir taslak dosya, beğendiğiniz bir örneğin kendisi, bir test, ya da "iyisi nasıl görünür"ü maddeleyen kısa bir ölçüt listesi.
Kontrol sorusu: Bunu anlatmak yerine verebileceğim bir dosya var mı? Varsa onu verin.
Artefakt — 6 kuralı tek seferde uygula
Aşağıdaki listeyi kopyalayın, kendi talimat dosyanızı açıp yukarıdan aşağı her satıra sırayla sorun. İsterseniz listeyi doğrudan Claude'a da verebilirsiniz: "dosyamı bu listeye göre süz" deyin.
TALİMAT DOSYASI KONTROL LİSTESİ
[ ] Kural 1 - Bu satır bir yasak mı, bir referans noktası mı? Yasaksa referansa çevir.
[ ] Kural 2 - Bu örneği silsem, adlar ve sıra işi kendi anlatıyor mu? Anlatmıyorsa örneği değil düzeni düzelt.
[ ] Kural 3 - Bu satırı Claude dosyalara bakarak kendisi görebilir mi? Görebilirse sil.
[ ] Kural 4 - Bu cümle başka bir dosyada da geçiyor mu? Geçiyorsa ait olduğu yerde bırak, diğerlerini sil.
[ ] Kural 5 - Bu not bir kere lazım olmuş günlük bilgi mi, kalıcı bir tuzak/tercih mi? Günlükse sil.
[ ] Kural 6 - Bunu anlatmak yerine verebileceğim bir dosya var mı? Varsa onu ver.
Uygula: talimat dosyanı aç, yukarıdan aşağı her satıra bu 6 soruyu sor.
Kararsız kaldığın satırı Claude'a yapıştırıp "bu satır hangi kurala takılıyor, sil mi bırak mı" diye sorabilirsin.Bu tarz temizlik listelerini düzenli paylaşıyorum — takip edin, kaçırmayın: @kaandoganai