Çoğu insan Claude Code'u kullanırken, yapay zekanın herhangi bir göreve başlamadan önce her zaman okuduğu dosyayı göz ardı ediyor.
Bu dosyanın adı "CLAUDE.md".
Anthropic'in resmi dokümantasyonu açıkça belirtiyor: eğer klasörde bir CLAUDE.md dosyası varsa, Claude Code çalışmaya başlamadan önce her zaman onu yükler – siz istemeseniz bile.
Başka bir deyişle, buraya yazdıklarınız yapay zekanın başlangıçtaki davranışını %100 değiştirir. Siz her seferinde yeni komutlar yazmak zorundayken, CLAUDE.md bir kez yazıldığında tüm konuşmalarda geçerlidir.
Buradaki etki bambaşka bir seviyede.
Tersine, bu dosyayı düzenlemediğiniz sürece, komutlarınızı ne kadar cilalarsanız cilalayın, fayda neredeyse sıfır olacaktır. Yapay zeka her seferinde sapacaktır. Varsayımları her seferinde yeniden açıklamak zorunda kalacaksınız. Aynı görev için bile kalite günden güne değişecektir. Bunun sebebi model veya sizin komut yazma beceriniz değil – bu dosyadır.
Bugün, CLAUDE.md dosyasına "ne ve nasıl yazılacağını", kopyala-yapıştır yapabileceğiniz örneklerle birlikte tam olarak açıklayacağım.
Performansı düşük olanlar için CLAUDE.md sadece bir "not"tur
Açıkçası, ben de başlangıçta zorlandım.
Bir süre X'te "klasör içeriği önemlidir" veya "CLAUDE.md önemlidir" diyen birçok yazı vardı. Onları gördüm ve klasörlerimi açtım.
İçerikler berbattı.
Neyin nerede olduğunu bilmiyordum. Benzer veriler her yere dağılmıştı. Yapay zeka ihtiyaç duyduğu bilgiyi bulamıyor ve her çıktı ürettiğinde istediğim cevap olmuyordu.
CLAUDE.md de aynıydı. Neyin nereye kaydedileceğine dair kurallar netleşmemişti. CLAUDE.md'in ne olduğunu bile tam olarak anlamamıştım. Bu yüzden, aklıma geldikçe en üstten talimatlar eklemeye devam ettim.
Sonuç olarak, 300-400 satıra ulaştı. Kolayca 200 satırı geçti.
CLAUDE.md'in en fazla 200 satır olması önerilir.
Çok uzun bir CLAUDE.md, "yapay zekanın neyin önemli olduğunu bilmediği uzun bir metin" haline gelir.
Bu durumda, yapay zeka her seferinde dosyanın tamamını yeniden okur ve "Peki, bu görevin hangi kısmı geçerli?" diye tahmin etmeye çalışır. İşin içine tahmin girince, tutarsızlık da kaçınılmaz olarak gelir.
CLAUDE.md bir "not defteri" değildir. Yapay zekanın her seferinde başvurduğu bir "karar haritasıdır". Bu algınızı değiştirmek işin yarısıdır.
CLAUDE.md'e sadece bu 5 şeyi yazın
Karmaşıklaştırmanıza gerek yok. Güçlü bir komuta merkezi her zaman şu beş unsuru içerir:
- ① Öncelik Kuralları: Herhangi bir çıktıdan önce uyulması gereken temel bildirim
- ② Anahtar Kelime → Konum Yönlendirme Tablosu: Hangi işler nereye gider
- ③ Konumlar için Karar Ağacı: Tabloda olmayan öğeler nasıl değerlendirilir
- ④ Görev Yönetimi: Yapılması gerekenler nasıl ve nereye kaydedilir
- ⑤ Gizli Bilgi Yönetimi: Paylaşılmaması gerekenlerin sınırını çizmek
Bu beşi yerinde olduğunda, yapay zeka "tahmin etmeyi" bırakır ve "referans almayı" başlar. Tutarsızlığın kökü ortadan kalkar.
Şimdi, her birinin gerçek örneklerle nasıl yazılacağına bakalım.
Ayar ① En üste "Öncelik Kuralları"nı bildirin
Yazılacak ilk şey, yapay zekanın ilk hareketini sabitleyen bir bildirimdir. Bu bir uyarıdır: "Düşünmeden önce, önce aşağıdaki kurallara uy."
▼ Yazma Örneği
Öncelik: Herhangi bir şeyi çıktılamadan veya kaydetmeden önce, harekete geçmeden önce her zaman aşağıdaki kuralları kontrol et. Konumlar, aşağıdaki "Anahtar Kelime Tablosu" ve "Karar Ağacı" kullanılarak belirlenmelidir. Karar veremezseniz, kendi başınıza ilerlemeyin; bir soru sorun.
Bunu en üste koymakla, yapay zeka "sadece ellerini oynatmayı" bırakır. Harekete geçmeden önce her seferinde kuralları kontrol etmeye başlar. Bu, başlangıç noktasını sabitler.
Ayar ② Bir "Anahtar Kelime → Konum" eşleme tablosu ekleyin
Bir sonraki en etkili şey bir iş dağıtım tablosudur. "Bu talep gelirse, bunu buraya koy/şuraya bak" bağlantısını anahtar kelimeler kullanarak kurun.
▼ Yazma Örneği
Anahtar Kelime → Konum ・Blog/Yazılar → Yayıncılık/Blog/ ・Giderler/Makbuzlar → Muhasebe/Evraklar/ ・Tutanaklar/Toplantı Notları → Kayıtlar/Tutanaklar/
İşin püf noktası, bunu normalde kullandığınız kelimelerle yazmaktır. Yapay zeka tablodaki kelimelere bakar ve konumu tereddüt etmeden seçebilir.
Dağıtım ekseni için ipucu, "iş" yerine "fonksiyon (görev)" ile kesmektir. Bu şekilde, işler veya ürünler artsa bile tablo bozulmaz.
Ayar ③ Kaybolduğunda kullanılacak bir "Karar Ağacı" ekleyin ← Bu en etkilisi
Beşi arasında en büyük etkiye sahip olan budur. Tabloda olmayan veya belirsiz şeylerin nasıl ele alınacağı.
Hem insanlar hem de yapay zeka kaybolduklarında dururlar. Kayboldukları için saparlar. Bu yüzden, sadece tereddüt alanını ortadan kaldırın. En baştan bir EVET/HAYIR yolunu izlemelerini sağlayın.
▼ Yazma Örneği
Kaydetmeden önce, şu adımları sırayla izleyin: S1. Gizli bilgi mi (API anahtarları/şifreler)? → EVET: .env dosyasına git. İşlem tamam. S2. Dışarıdan yeni indirilmiş ham veri mi? → EVET: Assets/ klasörüne git. S3. Hangi işe ait? → Şunlardan birine git: Yayıncılık / Satış / Muhasebe / Kayıtlar. → Sonunda tek bir konum belirlenemezse, ilerleme; tam olarak 2 soru sor.
Peki, karar ağacı eklemeden önce ve sonra davranış nasıl değişir? Spesifik olarak, iki şekilde.
Değişim 1: Aynı talep için her seferinde aynı eylemi gerçekleştirir.
Claude Code olasılık üzerine çalışır. Sohbet değiştiğinde önceki konuşmayı hatırlamaz. Bu nedenle karar ağacı olmadan, aynı "tutanağı kaydet" talebi için bile dalgalanır.
Karar Ağacı Olmadan:
- 1. sefer → Meeting/ klasörüne kaydedildi
- 2. sefer → Memo/Tutanaklar/
- 3. sefer → Nedense Assets klasörüne
Karar Ağacı İle:
- Her seferinde aynı yolu izler: S1→S2→S3 → Her zaman aynı yer
Davranış, "olasılıksal dalgalanma"dan "sabit bir prosedür"e dönüşür. Tekrarlanabilirlik, üzerine inşa edebileceğiniz anlamına gelir.
Değişim 2: Kaybolduğunda aşırı güvenle hata yapmayı durdurur.
Yapay zekanın en korkutucu davranışı, "kendinden emin bir şekilde yanlış olmasıdır". Örneğin, bir video kaydını ve ondan çıkarılan tutanakları aynı yere atmak.
- Tahmin ederek zorlama → ❌
- Durup 2 soruyla kontrol etme → ✓
Son satır gizlice etkilidir. Sadece "Karar veremezsen, acele etme, sor" yazarak, hedef dışı teslimatların seri üretimini yapısal olarak azaltırsınız.
Yapay zeka ne kadar akıllıysa, tam özgürlük yerine bir "şablon" verildiğinde o kadar iyi performans gösterir.
Ayar ④ ve ⑤ Görev Yönetimi ve Gizlilik
Kalan ikisi kısa olabilir. Ama yazılmaları gerekir.
④ Görevlerin "nerede ve nasıl bırakılacağını" sabitleyin. Bu olmadan, yapılacak işler her konuşmada dağılır.
▼ Yazma Örneği
Görev Yönetimi ・Tüm yapılacakları tek bir "tasks.md" dosyasında topla. ・İş bittiğinde silme; "Tamamlandı" bölümüne taşı ve 1 satırlık sonuç bırak.
⑤ Gizli bilgi sınırlarını net bir şekilde yazın. Bu, kazaları önlemek için bir cankurtarandır.
▼ Yazma Örneği
Gizli Bilgiler ・API anahtarlarını/şifreleri sadece .env dosyasına yaz. ・Bunları asla sohbetlere, kodlara veya kayıtlara yapıştırma.
Bu ikisiyle, görevler dağılmaz ve dışarı çıkmaması gereken şeyler içeride kalır. İki savunma kalkanınız olarak çalışırlar.
CLAUDE.md'i "200 satırın altında" tutun. Taşarsa, başka bir dosyaya taşıyın.
Bazılarınız fark etmiş olabilir: Her şeyi CLAUDE.md'e yazarsanız, giderek uzar.
Bu doğru. Bu önemli. CLAUDE.md'i çok uzun yaparsanız, aslında daha az etkili olur. Yapay zeka bunu her seferinde baştan sona okuduğu için, çok uzunsa "neyin önemli olduğu" duygusu sulanır.
Kılavuz 200 satırın altıdır.
Sığmazsa, ayrıntılı kuralları ayrı bir dosyaya taşıyın (örneğin, "kurallar_detay.md"). Ardından, CLAUDE.md'in en üstüne "ne zaman okunacağına" dair talimat verin.
▼ Yazma Örneği (En üstteki bildirime sadece bir satır ekleyin)
Öncelik: Çıktılamadan/kaydetmeden önce her zaman aşağıdaki kurallara uy. "kurallar_detay.md" dosyasını yalnızca bir blog yazısı yazarken oku.
Buradaki püf nokta, "her zaman oku" yerine "yalnızca... olduğunda" gibi bir koşul eklemektir. Bu şekilde, yapay zeka ilgisiz görevler için o dosyayı açmaz, ancak gerekli görevler için "CLAUDE.md → kurallar_detay.md" yolunu izler.
Bu, ana gövdeyi ince tutarken istediğiniz kadar ayrıntılı kural eklemenize olanak tanır. Önemli olan, bunu bir talep üzerine çağrı (call-on-demand) sistemi haline getirmektir.
CLAUDE.md "Giriş ve Komutan", ayrıntılar ise "Ayrı dosyalarda çağrılan" öğelerdir. Bu rol dağılımını hatırlarsanız, kurallarınız ne kadar artarsa artsın çökmez.
Açıkçası, bir anda bambaşka bir canavara dönüşmeyecek
Burada dürüst olacağım.
300-400 satırlık bir karmaşayı 5 bloğa yeniden düzenledim. Ondan sonra hissettiğim ilk şey "çarpıcı bir değişim" değildi.
İlk başta, sadece kaybolmayı bıraktı. Hepsi bu.
Dünya bir anda değişmez. Yavaş yavaş etkisini gösterir. Aynı talep için aynı hareketi döndürür, hedef dışı sonuçlar azalır ve bilgi birikir. Farkına varmadan, bambaşka bir canavar gibi hareket etmeye başlar. İşte böyle çalışır.
Gösterişli bir sihir bekliyorsanız hayal kırıklığına uğrayacaksınız. Ancak tekrarlanabilirlik kesinlikle artacaktır.
Özet: Her şeyi yapmayı angarya bulanlar için
Fazla düşünmeyin. Bugün yapmanız gereken şey, CLAUDE.md dosyanızı açmak (yoksa oluşturmak). Hepsi bu.
Her şeyi yapmayı angarya bulanlar için, işte zaman tahminleriyle birlikte öncelik listesi:
- İlk 5 dk: ③ Karar Ağacı için 3 soru yazın (En büyük etki)
- +7 dk: ① Öncelik Kuralları ve ② Yönlendirme Tablosu ekleyin
- +3 dk: ④ Görev ve ⑤ Gizlilik sınırlarını ekleyin
Toplam 15 dakika. Bu, onları ①→②→③→④→⑤ sırasına göre hizalayacaktır. 200 satırı geçecek gibi görünüyorsa, ayrıntıları ayrı bir dosyaya taşıyın ve en üstten okumasını sağlayın. Hepsi bu.
Tıkıştırmanıza gerek yok. Sadece düzenleyin. Bununla bile, dün kullandığınız aynı Claude Code, tamamen farklı bir şeymiş gibi hareket etmeye başlayacak.
Claude Code'un performansını artırmak isteyen insanlar her zaman komut teknikleri ararlar. Ancak gerçek etki daha yukarı akıştadır. Yapay zekanın her seferinde ilk okuduğu tek dosyadır.
İlk %5 ile kalan %95 arasındaki fark yetenek veya komut yazma becerisi değildir. Sadece bir CLAUDE.md dosyasını düzenleyip düzenlememiş olmalarıdır.
Bu makaledeki 3 karar ağacı sorusunu kopyalayıp yapıştırarak başlayın.
Son Olarak
Son olarak, bir itirafta bulunayım.
Genellikle yayınladığım slaytların tamamı yapay zeka tarafından yapılıyor. Artık tek bir slaytı bile elle yapmıyorum.
Ve bugün, bunları tam olarak aynı kalitede yapabilen yapay zekayı ücretsiz olarak veriyorum.
Buraya kadar okuduysanız, muhtemelen fark etmişsinizdir. Bu makalede bahsettiğim her şey tek bir şeye indirgeniyor:
"Yapay zekanın kaybolmasına izin vermeyin."
Yapay zeka yeteneği düşük olduğu için başarısız olmaz. Kaybolduğu için başarısız olur.
Ona bağlam verin. Talimatları tasarlayın. Yapay zekanın kafa karıştırmasına yer bırakmayın. Başka bir deyişle, onu bir sekreter gibi yetiştirin. Bu makalede bunu Claude Code ile yaptık.
Dağıtacağım şey bir ChatGPT GPTs. Sadece emin olmak için: ana metin Claude Code ile ilgiliydi ve bu bir ChatGPT GPTs. Araçlar farklı.
Ancak temel aynı. İhtiyaç duyulan şey teknoloji değil. Yapay zekanın kaybolmasına izin vermeyen bir tasarım.
Bu GPTs, bu felsefeyi "slayt oluşturma" konusunda sınıra kadar zorlayan bitmiş bir üründür. Bağlamı tasarlama işini zaten tamamen bitirdim.
Garanti ediyorum. Tek yaptığınız temayı yazmak. Ondan sonra, titizlikle tasarlanmış GPTs hiç tereddüt etmeden slaytları çıkaracak.
Bu GPTs'i ilk tanıtan makale 400.000 gösterim aldı. Bu, "bu farklı" diyen kaç kişi olduğunu gösteriyor.
https://x.com/masaki_aihack/status/2068646555524223366
Ve sınırlı bir süre için, bu GPTs dahil "20 bonus"tan oluşan bir paket veriyorum.
Alma yöntemi basit. Aşağıdaki LINE Açık Sohbet'e katılarak başlayın.
Dürüst olacağım: bu GPTs bir seferde bitmedi. 50'den fazla başarısız oldum. Sonunda "herkesin kullanabileceği" bir noktaya gelmesi bir hafta sürdü. İşte o kılavuzu olduğu gibi veriyorum.
Bir kez daha söyleyeyim. İhtiyaç duyulan şey teknoloji değil. Yapay zekanın kaybolmasına izin vermemek için sadece bir maharet.
Neden slayt yapma yorgunluğuna bugün son vermiyorsunuz?
