DERS 2.1 CLAUDE.md: projenin anayasası

KAZANIM Bu dersin sonunda: bir projeye, yapay zekânın her oturumda uyacağı bir anayasa yazabilirsin.

1TanımCLAUDE.md = proje klasörünün köküne koyduğunuz, AI'ın her oturumda otomatik okuduğu kurallar dosyası.

2İşlev ve amaçSeviye 1'de öğrendiniz: oturuma söylenen kural, compaction'da buharlaşabilir. Kalıcı kuralın yeri dosyadır. CLAUDE.md, her yeni oturuma "bu projenin görgü kurallarını" sıfır maliyetle taşır — siz tekrarlamazsınız, AI unutmaz.

3Nasıl yapılırDosyaya NE yazılır: (1) proje tek cümlede ne, (2) çalıştırma/test/build komutları, (3) dokunulmayacak yerler ve yasaklar ("X klasörüne dokunma", "paket ekleme, önce sor"), (4) proje kararları ("tarih formatı şu", "dil Türkçe"). NE YAZILMAZ: uzun tarihçe, genel nasihat ("temiz kod yaz"), her detay. Ölçü: kısa tutun (bir-iki ekran) — anayasa maddeleri, roman değil. İlk taslağı AI'a çıkartabilirsiniz:

Bu projeyi incele ve bir CLAUDE.md taslağı çıkar: proje özeti, komutlar, riskli
bölgeler, uyulması gereken kararlar. Kısa ve emir kipinde yaz. Ben düzelteceğim.

...ama son hâli SİZ onaylarsınız — anayasayı müteahhit yazmaz, mal sahibi onaylar.

4Ne ters gider + çözümüHata 1: dosya şişer, AI önemli kuralı gürültüde kaçırır. Çözüm: her yeni kural eklerken eskimiş bir satır silin. Hata 2: kural yazılır ama muğlaktır ("dikkatli ol") — uygulanamaz. Çözüm: kuralları denetlenebilir yazın ("build geçmeden commit yok" gibi evet/hayır'ı belli olan cümleler).

5AlternatiflerTek seferlik kısıt → istemin içine (ders 1.1). Sizin kişisel tercihiniz ama projeyle ilgisiz → memory (Seviye 3.5). Proje kuralı → CLAUDE.md. Bu üçlü yönlendirme, "nereye yazacağım" sorusunun tam cevabıdır.

6Denetim penceresiKontrol: yeni bir oturum açın ve sorun: "Bu projenin CLAUDE.md'sindeki kuralları listele ve her birine uyup uymadığını nasıl anlayacağımı söyle." AI kuralları eksik sayıyorsa dosya ya karışık ya şişkin. Kırmızı bayrak: AI'ın bir kuralı sistematik delmesi — kural muğlak yazılmış demektir; suç uygulayanda değil, maddede.

7Mini egzersiz (KENDİ-PROJEN)Üret: düşük riskli bir projenize yukarıdaki istemle CLAUDE.md taslağı çıkartın, elden geçirip 15-20 satıra indirin. Denetle: temiz oturumda 6. bölümdeki kontrolü koşturun.

8Kontrol soruları(1) CLAUDE.md'ye ne yazılır, ne yazılmaz? (2) "Dikkatli ol" neden kötü bir kuraldır? (3) Kural nereye yazılır: tek seferlik / kişisel / proje kuralı için üç ayrı adres nedir?

9Mentor istemi

AI Maestro Seviye 2 Ders 2.1'in (CLAUDE.md yazımı) hocası ol. Bana kötü yazılmış 6 maddelik
örnek bir CLAUDE.md göster; hatalarını buldurup birlikte iyi versiyona çevirelim.
Sonunda 3 kontrol sorusunu sor ve değerlendir.