CLAUDE.md nedir, içine ne yazılır?
Terminalde çalışan yapay zekâ asistanlarının en çok işe yarayan özelliği, projeyi hatırlaması. Bunun yolu proje köküne konan bir metin dosyası: CLAUDE.md.
Dosya her oturumun başında okunuyor. Yani her yeni oturumda "bu proje şöyle çalışıyor" diye baştan anlatmak zorunda kalmıyorsun.
İskelet
Dört başlık yeterli: projenin ne olduğu (tek cümle), nasıl çalıştırıldığı (kurulum, geliştirme, test komutları), kurallar (neye dokunulmayacağı, neyin önce sorulacağı) ve bilinmesi gerekenler.
İlk üçünü herkes yazıyor. Dördüncüsü çoğu projede boş duruyor — oysa değerin büyük kısmı orada.
En değerli bölüm: bilinmesi gerekenler
Buraya kod okunarak anlaşılmayan şeyler yazılır. Neden böyle yapıldığı. Hangi çözümün daha önce denenip başarısız olduğu. Hangi kısmın göründüğünden riskli olduğu.
Bu bölüm zamanla projenin en pahalı bilgisini biriktiriyor: geçmiş hatalar. Yeni gelen bir insan da, asistan da aynı hatayı ikinci kez yapmıyor.
Kurallar bölümü: yasaklar isteklerden güçlü
"Yeni bağımlılık ekleme, önce sor." "Bu klasöre dokunma." "Değişiklikten sonra testleri çalıştır." Kısa, kesin, sayılabilir cümleler.
Uzun ve nazik yazılmış kurallar uygulanmıyor. Kural bir dilek değil, bir sınır olmalı.
Ne yazılmaz
Sır yazılmaz — anahtar, şifre, token. Dosya depoya giriyor ve depoya giren her şey bir gün başkasının eline geçiyor.
Kod tekrarı yazılmaz. Dosyanın işi kodu anlatmak değil, kodun anlatmadığını anlatmak.
Yazılımcı olmayanlar için
Bu dosyanın mantığı koda özel değil. Aynı şey bir içerik projesinde, bir araştırmada, bir işletme dosyasında da çalışıyor: "bu iş nasıl yapılır, neye dikkat edilir, geçmişte ne ters gitti".
İlk derste anlatılan bağlam kartı ne yapıyorsa, bu dosya onu proje düzeyinde yapıyor.
Bu konuyu baştan sona anlattığım ücretsiz ders: Claude Code 101 — 16 sayfa, PDF, e-posta istemiyorum.