Düz bir metin dosyası, geliştiricilerin yapay zeka kodlamasını kullanma şeklini sonsuza dek değiştirdi.
Yeni bir model değil.
Pahalı bir IDE değil.
Başka bir "AI ajanı" girişimi değil.
Sadece bir dosya:
CLAUDE.md
Ve sessizce GitHub'daki en hızlı büyüyen geliştirici kurulumlarından biri haline geldi.
82.000'den fazla yıldız.
Binlerce fork.
Startuplardan kurumsal ekiplere kadar mühendisler, onu bir gecede projelerine kopyalıyor.
Çünkü geliştiriciler nihayet bir şeyi fark etti:
Claude Code, model zayıf olduğu için başarısız olmuyor.
Her oturum hafıza kaybıyla başladığı için başarısız oluyor.
Claude Code'u her açtığınızda, şunları unutuyor:
• sizin stack'inizi
• mimari kararlarınızı
• adlandırma kurallarınızı
• kodlama standartlarınızı
• geçen hafta neyin başarısız olduğunu
• ASLA değiştirilmemesi gereken şeyleri
• neden bir framework'ü diğerine tercih ettiğinizi
• hangi dosyalara dokunmanın çok riskli olduğunu
Bu yüzden model, bağlam olmadan her AI'ın yaptığını yapıyor:
Tahmin ediyor.
Ve bu tahminler inanılmaz derecede pahalıya mal oluyor.
Bir fonksiyonu düzeltmesini istiyorsunuz.
Üç dosyayı yeniden yazıyor.
Bilinçli olarak seçtiğiniz değişkenleri yeniden adlandırıyor.
Çalışan kodu yeniden düzenliyor.
Mimarinizle uyumsuz araçlar öneriyor.
"Temizlik için" bir şeyleri siliyor.
Kimsenin dokunmasını istemediği biçimlendirmeyi değiştiriyor.
Sonra bir sonraki saati bu "yardımı" geri almakla geçiriyorsunuz.
İşte bu, kimsenin bahsetmediği AI kodlamanın gizli vergisi.
Bir mühendislik yöneticisi, ekiplerinin her hafta neredeyse 8 saatini sadece şunlarla kaybettiğini tahmin etti:
→ proje bağlamını yeniden açıklamak
→ yetkisiz değişiklikleri geri almak
→ yanlış varsayımları düzeltmek
→ mimari kararları yeniden öğretmek
→ kapsam genişlemesini durdurmak
Bu bir AI sorunu değil.
Bu bir hafıza sorunu.
Ve CLAUDE.md bunu mümkün olan en basit şekilde çözüyor.
Projenizin köküne yerleştirilen düz bir metin dosyası.
Ancak Claude, her oturumun başında onu otomatik olarak okuyor.
Yani AI'ınız nihayet kaos yerine bağlamla başlıyor.
Fark çok büyük.
CLAUDE.md olmadan:
"AI asistanı"
CLAUDE.md ile:
"Projenizi zaten bilen mühendis."
Dosya genellikle 3 katman içerir.
━━━━━━━━━━━━━━━
- VARSAYILAN KURALLAR ━━━━━━━━━━━━━━━
Bu bölüm, Claude'a nasıl çalıştığınızı öğretir.
Yanıtlar ne kadar detaylı olmalı.
Stack'iniz neye benziyor.
Nasıl iletişim kuruyorsunuz.
Ne kadar bağlam bildiğiniz.
Hangi yazım stilini kullanacağınız.
Ne YAPMAMANIZ gerektiği.
Şunlar gibi:
→ dolgu ifadeleri kullanma
→ yanıtları görev karmaşıklığına göre ayarla
→ varsayımlarda bulunmadan önce sor
→ temel kavramları asla fazla açıklama
→ kodlama stilimi birebir eşle
→ proje kısıtlamalarını otomatik olarak takip et
Küçük görünüyor.
Ama yüzlerce istem üzerinden?
Bu, büyük tekrarları ortadan kaldırıyor.
Çoğu geliştirici, farkında olmadan her gün 20-40 dakikasını AI'a bağlamı yeniden öğreterek harcıyor.
Her. Tek. Oturumda.
Şimdi bunu bir mühendislik ekibine yayın.
Bu, sadece kendinizi tekrarlayarak ayda binlerce dolar boşa harcamak anlamına geliyor.
━━━━━━━━━━━━━━━
- DAVRANIŞ KONTROLÜ
━━━━━━━━━━━━━━━
Bu, geliştiricilerin aylar önce sahip olmayı diledikleri bölüm.
Çünkü burada Claude'un "yaratıcı bir şekilde yıkıcı" olmasını engelliyorsunuz.
Kesin sınırlar tanımlıyorsunuz:
→ yalnızca görevle doğrudan ilgili dosyalara dokun
→ ilgisiz kodu asla yeniden düzenleme
→ bir şeyi silmeden önce sor
→ yıkıcı eylemlerden önce onay al
→ onay olmadan mevcut yapıyı yeniden yazma
→ tam olarak neyin değiştiğini her zaman göster
→ otomatik olarak dağıtma veya migrasyon çalıştırma
Bu tek bölüm, çoğu AI kodlama korku hikayesini önlüyor.
Artık sürpriz yeniden yazımlar yok.
Artık mimari sapması yok.
Artık "Bunu senin için temizledim" felaketleri yok.
AI tahmin edilebilir hale geliyor.
Mühendislerin tam olarak istediği şey de bu.
━━━━━━━━━━━━━━━
- HAFIZA + PROJE BEYNİ
━━━━━━━━━━━━━━━
İşte burada işler gerçekten güçleniyor.
Geliştiriciler, CLAUDE.md'yi şu gibi dosyalarla eşleştirmeye başladı:
MEMORY.md
ERRORS.md
Artık Claude şunları hatırlayabiliyor:
• ekibinizin daha önce aldığı kararlar
• başarısız olan yaklaşımlar
• reddedilen araçlar
• üretim olayları
• teknik kısıtlamalar
• mimari ödünleşimler
• müşteriye özel kurallar
Yani AI, aylar önce elediğiniz şeyleri önermeyi bırakıyor.
Unutmayı bırakıyor.
Bu her şeyi değiştiriyor.
Çünkü AI kodlamadaki gerçek darboğaz artık kod üretimi değil.
Kalıcı bağlam.
Ve çoğu insan bunu hâlâ fark etmedi.
━━━━━━━━━━━━━━━
VİRAL OLMASINI SAĞLAYAN 4 KURAL
━━━━━━━━━━━━━━━
Geliştiriciler, Andrej Karpathy'nin AI sistemleriyle çalışma yaklaşımından ilham alan 4 basit kuralı paylaşmaya başladıktan sonra bu düzen patladı.
Aldatıcı derecede basit görünüyorlar:
- Varsaymadan önce sor.
- Önce en basit çözümü kullan.
- İlgisiz koda dokunma.
- Belirsizliği hemen bildir.
Bu kadar.
Ancak bu 4 kural, çoğu AI kodlama hatasını çözüyor.
Çünkü en büyük hasar genellikle AI'ın yeterli bağlam olmadan kendinden emin bir şekilde hareket etmesinden kaynaklanıyor.
En iyi sonuçları alan geliştiriciler "daha fazla AI" kullanmıyor.
Belirsizliği azaltıyorlar.
Ve bunu bir kez gördüğünüzde, artık görmemezlikten gelemezsiniz.
━━━━━━━━━━━━━━━
AI KODLAMADA GERÇEK AYRIM
━━━━━━━━━━━━━━━
Şu anda Claude Code kullanan temelde iki tür geliştirici var.
Grup 1:
Her oturuma sıfırdan başlar.
Bağlamı her gün tekrarlar.
İstenmeyen değişiklikleri temizler.
Sürekli kapsam genişlemesiyle savaşır.
AI'a geçici bir otomatik tamamlama gibi davranır.
Grup 2:
Kalıcı talimatlar kullanır.
Davranış kurallarını kilitler.
Proje hafızasını korur.
Kapsamı sıkı bir şekilde kontrol eder.
AI'a uzun vadeli bir mühendislik işbirlikçisi gibi davranır.
Aynı model.
Tamamen farklı sonuçlar.
Bu yüzden bu dosya çok hızlı yayıldı.
Çünkü Claude bir kez:
• kurallara
• hafızaya
• stack farkındalığına
• davranışsal kısıtlamalara
• proje bağlamına
sahip olduğunda…
…bir sohbet robotu gibi hissettirmeyi bırakıyor.
Ve bir altyapı gibi hissettirmeye başlıyor.
━━━━━━━━━━━━━━━
BURADAN BAŞLAYIN
━━━━━━━━━━━━━━━
Projenizi açın.
Şu ada sahip bir dosya oluşturun:
CLAUDE.md
Ardından önce şu 4 kuralı yapıştırın:
• Varsaymadan önce sor
• Önce en basit çözüm
• İlgisiz koda dokunma
• Belirsizliği açıkça bildir
Bu tek başına Claude'un davranışını hemen iyileştirecektir.
Ardından zamanla genişletin:
→ stack'iniz
→ kodlama standartları
→ mimari kurallar
→ yasaklanmış eylemler
→ karar günlükleri
→ proje hafızası
Çoğu geliştirici bunu hâlâ yapmadı.
Bu, ortalama AI destekli kodlama ile elit AI destekli kodlama arasındaki farkın modellerle ilgili olmaktan çıktığı anlamına geliyor…
…ve daha çok bağlamı kimin doğru şekilde yapılandırmayı bildiğiyle ilgili hale geliyor.
Bunu kaydedin.
Çünkü altı ay sonra, kalıcı AI proje hafızası muhtemelen bugün GitHub depoları kadar normal hissettirecek.
