Ocak 2026'nın sonlarında, Andrej Karpathy, Claude'un kod yazma şekliyle ilgili şikayet ettiği bir başlık paylaştı. Üç başarısızlık modu: sessiz yanlış varsayımlar, aşırı karmaşıklık, dokunmaması gereken kodda ortogonal hasar.
Forrest Chang başlığı okudu, şikayetleri tek bir CLAUDE.md dosyasında 4 davranış kuralına paketledi ve GitHub'a koydu. İlk günde 5.828 yıldız aldı. İki haftada 60.000 yer imi. Bugün 120.000 yıldız. 2026'nın en hızlı büyüyen tek dosyalı reposu.
Sonra 6 hafta boyunca 30 kod tabanında test ettim.
4 kural işe yarıyor. Eskiden ~%40 oranında olan hatalar, güçlü oldukları görevlerde %3'ün altına düştü. Ancak şablon, Ocak ayındaki kod yazma hatalarını düzeltmek için oluşturulmuştu.
Mayıs 2026'daki Claude Code ekosisteminin farklı sorunları var — ajan kavgaları, hook basamakları, beceri yükleme çakışmaları, oturumlar arasında bozulan çok adımlı iş akışları.
Bu yüzden 8 kural daha ekledim. Aşağıda: 12 kurallı tam CLAUDE.md, her birinin yerini nasıl hak ettiği ve orijinal Karpathy şablonunun sessizce bozulduğu 4 yer.
Açıklamaları atlayıp sadece yapıştırmak isterseniz, tam dosya sonda.
Bu neden önemli
Claude Code'un CLAUDE.md'si, tüm AI kodlama yığınındaki en az kullanılan dosyadır. Çoğu geliştirici ya:
- Sahip oldukları her tercihi boşaltıp 4.000+ token'a şişirir, uyum %30'a düşer
- Tamamen atlar ve her seferinde komut verir — 5 kat token israfı, oturumlar arasında tutarlılık olmaz
- Bir şablonu bir kere kopyalar ve unutur. İki hafta çalışır, sonra kod tabanı değiştikçe sessizce bozulur
Resmi Anthropic belgeleri açık: CLAUDE.md tavsiye niteliğindedir. Claude bunu yaklaşık %80 oranında takip eder. 200 satırın ötesinde, önemli kurallar gürültüye gömüldüğü için uyum keskin bir şekilde düşer.
Karpathy'nin şablonu bunu tek bir dosyada, 65 satırda, 4 kuralla çözdü. Bu taban.
Tavan daha yüksek. Aşağıda inceleyeceğim 8 kural daha ile, yalnızca Karpathy'nin şikayet ettiği Ocak 2026 kod yazma sorunlarını değil, aynı zamanda şablon yazıldığında henüz var olmayan Mayıs 2026 ajan orkestrasyon sorunlarını da kapsıyorsunuz.
Orijinal 4 kural
Forrest Chang'in reposunu okumadıysanız, taban:
**Kural 1 — Kodlamadan Önce Düşün.
**Sessiz varsayımlar yok. Ne varsaydığınızı belirtin. Ödünleşimleri ortaya koyun. Tahmin etmeden önce sorun. Daha basit bir yaklaşım olduğunda geri adım atın.
**Kural 2 — Önce Basitlik.
**Sorunu çözen minimum kod. Spekülatif özellikler yok. Tek kullanımlık kod için soyutlamalar yok. Kıdemli bir mühendis aşırı karmaşık derse — basitleştirin.
**Kural 3 — Cerrahi Değişiklikler.
**Yalnızca gerektiği kadar dokunun. Bitişik kodu, yorumları veya biçimlendirmeyi "iyileştirmeyin". Bozuk olmayanı yeniden düzenlemeyin. Mevcut stille eşleşin.
**Kural 4 — Hedef Odaklı Yürütme.
**Başarı kriterlerini tanımlayın. Doğrulanana kadar döngü yapın. Claude'a hangi adımları izleyeceğini söylemeyin, başarının neye benzediğini söyleyin ve yinelemesine izin verin.
Bu dört kural, denetimsiz Claude Code oturumlarında gördüğüm başarısızlık modlarının ~%40'ını kapatıyor. Kalan ~%60, aşağıdaki boşluklarda yaşıyor.
Eklediğim 8 kural (ve nedenleri)
Bunların her biri, Karpathy'nin 4 kuralının yetersiz kaldığı gerçek bir andan geldi. Anı, ardından kuralı göstereceğim.
Kural 5 — Modeli dil dışı işler için kullanmayın
Karpathy'nin kuralları bu konuda sessiz. Model, deterministik kod olması gereken şeylere karar veriyor: bir API çağrısını yeniden denemek, bir mesajı nasıl yönlendirmek, ne zaman yükseltmek. Her hafta farklı kararlar. Token başına 0,003$'dan dengesiz if-else.
1## Kural 5 — Modeli yalnızca muhakeme gerektiren durumlar için kullanın2Claude'u şunlar için kullanın: sınıflandırma, taslak oluşturma, özetleme, yapılandırılmamış metinden çıkarım.3Claude'u şunlar için KULLANMAYIN: yönlendirme, yeniden denemeler, durum kodu işleme, deterministik dönüşümler.4Bir durum kodu soruyu zaten yanıtlıyorsa, düz kod soruyu yanıtlar.
An: "503'te yeniden deneyip denemeyeceğimize karar vermek" için Claude'u çağıran kod iki hafta boyunca harika çalıştı, ardından model karar için bağlam olarak istek gövdesini okumaya başladığı için aksamaya başladı. Yeniden deneme politikası rastgeleydi çünkü komut rastgeleydi.
Kural 6 — Sert token bütçeleri, istisna yok
Bütçesiz CLAUDE.md, boş bir çek gibidir. Her döngünün 50.000 token'lık bir bağlam dökümüne dönüşme şansı vardır. Model kendi kendine durmaz.
1## Kural 6 — Token bütçeleri tavsiye niteliğinde değildir2Görev başına bütçe: 4.000 token.3Oturum başına bütçe: 30.000 token.4Bir görev bütçeye yaklaşıyorsa, özetleyin ve sıfırdan başlayın. Zorlamayın.5İhlali bildirmek > sessizce aşmak.
An: Bir hata ayıklama oturumu 90 dakika sürdü. Model, aynı 8 KB'lık hata mesajı üzerinde yineleme yapmaktan gayet memnundu ve yavaş yavaş hangi düzeltmeyi denediğini unutuyordu. Sonunda, 40 mesaj önce reddettiğim düzeltmeleri öneriyordu. Token bütçesi onu 12. dakikada durdururdu.
Kural 7 — Çakışmaları ortaya çıkarın, ortalamasını almayın
Kod tabanının iki kısmı aynı fikirde olmadığında, Claude ikisini de memnun etmeye çalışır. Sonuç tutarsızdır.
1## Kural 7 — Çakışmaları ortaya çıkarın, ortalamasını almayın2Kod tabanındaki iki mevcut desen çelişiyorsa, bunları harmanlamayın.3Birini seçin (daha yeni / daha çok test edilmiş), nedenini açıklayın ve diğerini temizlik için işaretleyin.4Her iki kuralı da karşılayan "ortalama" kod, en kötü koddur.
An: Bir kod tabanında iki hata işleme deseni vardı — biri açık try/catch ile async/await, diğeri global bir hata sınırlayıcı ile. Claude her ikisini de yapan yeni kod yazdı. İki kat hata işleyici. Hataların neden iki kez yutulduğunu anlamam 30 dakikamı aldı.
Kural 8 — Yazmadan önce okuyun
Karpathy'nin "Cerrahi Değişiklikler" kuralı, Claude'a bitişik koda dokunmamasını söyler. Önce bitişik kodu anlamasını söylemez. Bu olmadan Claude, 30 satır ötedeki mevcut kodla çakışan yeni kod yazar.
1## Kural 8 — Yazmadan önce okuyun2Bir dosyaya kod eklemeden önce, dosyanın dışa aktarımlarını, doğrudan çağıranı ve bariz paylaşılan yardımcı programları okuyun.3Mevcut kodun neden bu şekilde yapılandırıldığını anlamıyorsanız, ona eklemeden önce sorun.4"Bana ortogonal görünüyor" bu kod tabanındaki en tehlikeli ifadedir.
An: Claude, okumadığı mevcut özdeş bir fonksiyonun yanına bir fonksiyon ekledi. Her iki fonksiyon da aynı şeyi yapıyordu. İçe aktarma sırası nedeniyle yenisi öncelik kazandı. Eskisi 6 aydır gerçeğin kaynağıydı.
Kural 9 — Testler isteğe bağlı değildir, ancak amaç değildir
Karpathy'nin Hedef Odaklı Yürütme kuralı, testleri başarı kriteri olarak ima eder. Pratikte Claude, "testlerin geçmesini" tek amaç olarak ele alır ve sığ testleri geçen ancak diğer her şeyi bozan kod yazar.
1## Kural 9 — Testler amacı doğrular, sadece davranışı değil2Her test, davranışın NEDEN önemli olduğunu kodlamalıdır, sadece NE yaptığını değil.3`expect(getUserName()).toBe('John')` gibi bir test, fonksiyon sabit kodlanmış bir ID alıyorsa değersizdir.4İş mantığı değiştiğinde başarısız olacak bir test yazamıyorsanız, fonksiyon yanlıştır.
An: Claude, bir kimlik doğrulama fonksiyonu için 12 test yazdı. Hepsi geçti. Kimlik doğrulama üretimde bozuktu. Testler, fonksiyonun bir şey döndürüp döndürmediğini test ediyordu, doğru şeyi döndürüp döndürmediğini değil. Fonksiyon bir sabit döndürdüğü için geçti.
Kural 10 — Uzun süreli işlemler kontrol noktaları gerektirir
Karpathy'nin şablonu, tek seferlik etkileşimleri varsayar. Gerçek Claude Code çalışması çok adımlıdır — 20 dosyada yeniden düzenleme, bir oturumda özellik oluşturma, birden çok commit'te hata ayıklama. Kontrol noktaları olmadan, tek bir yanlış dönüş tüm ilerlemeyi kaybettirir.
1## Kural 10 — Her önemli adımdan sonra kontrol noktası oluşturun2Çok adımlı bir görevde her adımı tamamladıktan sonra: ne yapıldığını, neyin doğrulandığını, neyin kaldığını özetleyin.3Bana geri tanımlayamayacağınız bir durumdan devam etmeyin.4Yönünüzü kaybederseniz, durun ve yeniden ifade edin.
An: 6 adımlı bir yeniden düzenleme 4. adımda yanlış gitti. Fark ettiğimde, Claude bozuk durumun üzerine 5. ve 6. adımları da yapmıştı. Çözmek, her şeyi yeniden yapmaktan daha uzun sürdü. Kontrol noktaları bunu 4. adımda yakalardı.
Kural 11 — Gelenek, yenilikten üstündür
Yerleşik desenlere sahip bir kod tabanında, Claude kendi desenlerini tanıtmayı sever. Kendi yolu "daha iyi" olsa bile, iki desenin tanıtılması, her iki desenden de ayrı ayrı daha kötüdür.
1## Kural 11 — Kod tabanının kurallarına uyun, aynı fikirde olmasanız bile2Kod tabanı snake_case kullanıyorsa ve siz camelCase'i tercih ediyorsanız: snake_case.3Kod tabanı sınıf tabanlı bileşenler kullanıyorsa ve siz hook'ları tercih ediyorsanız: sınıf tabanlı.4Anlaşmazlık ayrı bir konuşmadır. Kod tabanının içinde, uyum > zevk.5Geleneğin gerçekten zararlı olduğunu düşünüyorsanız, bunu ortaya çıkarın. Sessizce çatallamayın.
An: Claude, sınıf tabanlı bir kod tabanına React hook'ları ekledi. Çalıştılar. Ayrıca, componentDidMount'u varsayan kod tabanının test desenlerini de bozdular. Kaldırmak ve yeniden yazmak yarım gün sürdü.
Kural 12 — Görünür şekilde başarısız olun, sessizce değil
En pahalı Claude başarısızlıkları, başarı gibi görünenlerdir. Bir fonksiyon "çalışır" ancak yanlış veri döndürür. Bir geçiş "tamamlanır" ancak 30 kaydı atlar. Bir test "geçer" ancak yalnızca iddia yanlış olduğu için.
1## Kural 12 — Yüksek sesle başarısız olun2Bir şeyin çalıştığından emin olamıyorsanız, bunu açıkça söyleyin.3"Geçiş tamamlandı", 30 kayıt sessizce atlandıysa yanlıştır.4"Testler geçti", herhangi birini atladıysanız yanlıştır.5"Özellik çalışıyor", sorduğum uç durumu doğrulamadıysanız yanlıştır.6Varsayılan olarak belirsizliği ortaya çıkarmak, gizlemek değildir.
An: Claude, bir veritabanı geçişinin "başarıyla tamamlandığını" söyledi. Bir kısıtlama ihlaline takılan kayıtların %14'ünü sessizce atlamıştı. Atlama günlüğe kaydedilmiş ancak bildirilmemişti. Sorun, raporlar yanlış görünmeye başladığında 11 gün sonra keşfedildi.
Rakamlar
Aynı 50 temsili görev setini 6 hafta boyunca 30 kod tabanında takip ettim. Üç yapılandırma:
Hata oranı = görevin amaca uyması için düzeltme veya yeniden yazma gerektirmesi. Sayımlar: sessiz yanlış varsayım, aşırı mühendislik, ortogonal hasar, sessiz başarısızlık, kural ihlali, çakışma ortalaması, kaçırılan kontrol noktası.
Uyum = Claude'un ilgili kuralın uygulanabilir olduğu durumlarda onu görünür şekilde ne sıklıkta uyguladığı.
İlginç sonuç, %41'den %3'e olan büyük düşüş değil. 4 kuraldan 12 kurala çıkmanın neredeyse hiç uyum yükü eklememesi (%78 -> %76) ancak hata oranını 8 puan daha düşürmesidir. Yeni kurallar, orijinal 4'ün ele almadığı başarısızlık modlarını kapsar — aynı dikkat bütçesi için rekabet etmezler.
Karpathy'nin şablonunun sessizce bozulduğu yerler
Orijinal 4 kurallı şablonun, yeni kurallar eklenmeden önce bile yetersiz kaldığı dört yer:
**1. Uzun süreli ajan görevleri.
*Karpathy'nin kuralları, Claude'un kod yazdığı anı hedefler. Claude'un çok adımlı bir ardışık düzen çalıştırdığında* ne olduğu konusunda sessizdir. Bütçe kuralı yok. Kontrol noktası kuralı yok. "Yüksek sesle başarısız ol" kuralı yok. Ardışık düzenler sürüklenir.
**2. Çoklu kod tabanı tutarlılığı.
**"Mevcut stille eşleş" tek bir stil varsayar. 12 hizmetli bir monorepoda, Claude hangi stili seçeceğine karar vermelidir. Orijinal kurallar ona nasıl yapacağını söylemez. Rastgele seçer veya ortalamasını alır.
**3. Test kalitesi.
*Hedef Odaklı Yürütme, "testlerin geçmesini" başarı olarak ele alır. Testlerin anlamlı* olması gerektiğini söylemez. Sonuç, hiçbir şeyi test etmeyen ancak Claude'u kendinden emin yapan testlerdir.
**4. Üretim ve prototip.
**Üretim kodunu aşırı mühendislikten koruyan aynı 4 kural, bir yön bulmak için meşru olarak 100 satır spekülatif iskeleye ihtiyaç duyan prototipleri de yavaşlatır. Karpathy'nin "Önce Basitlik" kuralı, erken aşama kodda aşırı tepki verir.
Eklenen 8 kural, Karpathy'nin 4 kuralının yerini almaz. Onun Ocak 2026 modeli, otomatik tamamlama tarzı kodlamanın, Mayıs 2026'nın ajan odaklı, çok adımlı, çoklu kod tabanlı çalışmasıyla eşleşmediği boşlukları yamarlar.
İşe yaramayan şeyler
12 kurala karar vermeden önce denediğim şeyler:
- Reddit / X'te gördüğüm kuralları eklemek. Çoğu ya Karpathy'nin 4 kuralının farklı kelimelerle yeniden ifadeleriydi ya da genellemeyen alana özgü kurallardı ("her zaman Tailwind sınıfları kullan"). Onları kestim.
- 12'den fazla kural. 18'e kadar test ettim. 14 kuralın ötesinde uyum %76'dan %52'ye düştü. 200 satırlık tavan gerçektir. Bunun ötesinde Claude, kuralları fiilen okumadan "kurallar var"a kalıp eşleştirmeye başlar.
- Var olmayabilecek araçlara bağlı kurallar. "Her zaman eslint kullan", eslint yüklü olmadığında bozulur. Kural sessizce başarısız olur. Yetenekten bağımsız ifadelerle değiştirildi: "eslint kullan" yerine "kod tabanının uyguladığı stille eşleş."
- CLAUDE.md'de kurallar yerine örnekler. Örnekler kurallardan daha ağırdır. Üç örnek, ~10 kural kadar bağlam maliyeti çıkarır ve Claude onlara aşırı uyum sağlar. Kurallar soyuttur, örnekler belirli. Kuralları kullanın.
- "Dikkatli ol" / "iyice düşün" / "gerçekten odaklan." Tamamen gürültü. Bunlara uyum, test edilebilir olmadıkları için ~%30'a düştü. Somut emirlerle değiştirildi ("varsayımları açıkça belirtin").
- Claude'a "kıdemli" olmasını söylemek. İşe yaramıyor. Claude zaten kıdemli olduğunu düşünüyor. Uyum açığı, düşünme ve yapma arasındadır. Emir kuralları açığı kapatır; kimlik komutları kapatmaz.
Tam 12 kurallı CLAUDE.md (kopyala-yapıştır için hazır)
1# CLAUDE.md — 12 kurallı şablon23Bu kurallar, açıkça geçersiz kılınmadıkça bu projedeki her görev için geçerlidir.4Önyargı: önemsiz olmayan işlerde hız yerine dikkat. Önemsiz görevlerde muhakeme kullanın.56## Kural 1 — Kodlamadan Önce Düşün7Varsayımları açıkça belirtin. Emin değilseniz, tahmin etmek yerine sorun.8Belirsizlik olduğunda birden çok yorum sunun.9Daha basit bir yaklaşım olduğunda geri adım atın.10Kafanız karıştığında durun. Neyin net olmadığını adlandırın.1112## Kural 2 — Önce Basitlik13Sorunu çözen minimum kod. Spekülatif hiçbir şey yok.14İstenenin ötesinde özellik yok. Tek kullanımlık kod için soyutlamalar yok.15Test: kıdemli bir mühendis bunun aşırı karmaşık olduğunu söyler mi? Evetse, basitleştirin.1617## Kural 3 — Cerrahi Değişiklikler18Yalnızca gerektiği kadar dokunun. Yalnızca kendi karışıklığınızı temizleyin.19Bitişik kodu, yorumları veya biçimlendirmeyi "iyileştirmeyin".20Bozuk olmayanı yeniden düzenlemeyin. Mevcut stille eşleşin.2122## Kural 4 — Hedef Odaklı Yürütme23Başarı kriterlerini tanımlayın. Doğrulanana kadar döngü yapın.24Adımları takip etmeyin. Başarıyı tanımlayın ve yineleyin.25Güçlü başarı kriterleri, bağımsız olarak döngü yapmanızı sağlar.2627## Kural 5 — Modeli yalnızca muhakeme gerektiren durumlar için kullanın28Beni şunlar için kullanın: sınıflandırma, taslak oluşturma, özetleme, çıkarım.29Beni şunlar için KULLANMAYIN: yönlendirme, yeniden denemeler, deterministik dönüşümler.30Kod yanıtlayabiliyorsa, kod yanıtlar.3132## Kural 6 — Token bütçeleri tavsiye niteliğinde değildir33Görev başına: 4.000 token. Oturum başına: 30.000 token.34Bütçeye yaklaşıyorsanız, özetleyin ve sıfırdan başlayın.35İhlali bildirin. Sessizce aşmayın.3637## Kural 7 — Çakışmaları ortaya çıkarın, ortalamasını almayın38İki desen çelişiyorsa, birini seçin (daha yeni / daha çok test edilmiş).39Nedenini açıklayın. Diğerini temizlik için işaretleyin.40Çelişen desenleri harmanlamayın.4142## Kural 8 — Yazmadan önce okuyun43Kod eklemeden önce, dışa aktarımları, doğrudan çağıranları, paylaşılan yardımcı programları okuyun.44"Ortogonal görünüyor" tehlikelidir. Kodun neden bu şekilde yapılandırıldığından emin değilseniz, sorun.4546## Kural 9 — Testler amacı doğrular, sadece davranışı değil47Testler, davranışın NEDEN önemli olduğunu kodlamalıdır, sadece NE yaptığını değil.48İş mantığı değiştiğinde başarısız olamayacak bir test yanlıştır.4950## Kural 10 — Her önemli adımdan sonra kontrol noktası oluşturun51Ne yapıldığını, neyin doğrulandığını, neyin kaldığını özetleyin.52Bana geri tanımlayamayacağınız bir durumdan devam etmeyin.53Yönünüzü kaybederseniz, durun ve yeniden ifade edin.5455## Kural 11 — Kod tabanının kurallarına uyun, aynı fikirde olmasanız bile56Kod tabanının içinde uyum > zevk.57Bir geleneğin gerçekten zararlı olduğunu düşünüyorsanız, bunu ortaya çıkarın. Sessizce çatallamayın.5859## Kural 12 — Yüksek sesle başarısız olun60"Tamamlandı", herhangi bir şey sessizce atlandıysa yanlıştır.61"Testler geçti", herhangi biri atlandıysa yanlıştır.62Varsayılan olarak belirsizliği ortaya çıkarmak, gizlemek değildir.
Repo kökünüze CLAUDE.md olarak kaydedin. 12 kuralın altına projeye özel kurallar ekleyin (yığın, test komutları, hata desenleri). Toplamda 200 satırı geçmeyin, bunun ötesinde uyum düşer.
Nasıl kurulur
İki adım:
1# 1. Karpathy'nin 4 kurallı temelini CLAUDE.md dosyanıza ekleyin2curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md34# 2. Bu makaleden 5-12 arası kuralları aşağıya yapıştırın
Repo kökünüze kaydedin. >> önemlidir, mevcut CLAUDE.md dosyanızın üzerine yazmak yerine, varsa projeye özel kurallarınızın sonuna ekler.
Zihinsel model
CLAUDE.md bir istek listesi değildir. Gözlemlediğiniz belirli başarısızlık modlarını kapatan bir davranış sözleşmesidir.
Her kural şu soruyu yanıtlamalıdır: bu hangi hatayı önlüyor?
Karpathy'nin 4 kuralı, Ocak 2026'da gördüğü başarısızlık modlarını önler: sessiz varsayımlar, aşırı mühendislik, ortogonal hasar, zayıf başarı kriterleri. Temeldirler. Onları atlamayın.
Eklediğim 8 kural, Mayıs 2026'da ortaya çıkan başarısızlık modlarını önler: bütçesiz ajan döngüleri, kontrol noktasız çok adımlı görevler, test etmeyen testler, sessiz başarısızlıkları gizleyen sessiz başarılar. Ek niteliğindedirler.
Sizin deneyiminiz farklı olabilir. Çok adımlı ardışık düzenler çalıştırmıyorsanız, Kural 10 önemli değildir. Kod tabanınız linting ile uygulanan tutarlı bir stile sahipse, Kural 11 gereksizdir. 12 kuralı okuyun, gerçekten yaptığınız hatalarla eşleşenleri saklayın, gerisini atın.
Gerçek başarısızlık modlarınıza göre uyarlanmış 6 kurallı bir CLAUDE.md, asla ihtiyacınız olmayacak 6 kuralı olan 12 kurallı bir CLAUDE.md'den daha iyidir.
S O N
Karpathy'nin Ocak 2026 başlığı bir şikayetti. Forrest Chang bunu 4 kurala dönüştürdü. 120.000 geliştirici sonucu yıldızladı. Çoğu hala bugün 4 kuralı çalıştırıyor.
Model gelişti. Ekosistem değişti. Çok adımlı ajanlar, hook basamakları, beceri yükleme, çoklu kod tabanlı çalışma — Karpathy başlığını yazdığında bunların hiçbiri yoktu. 4 kural bunları ele almaz. Yanlış değiller; eksikler.
8 kural daha. 30 kod tabanında 6 haftalık test. Hata oranı %41'den %3'e.
Bunu yer imlerine ekleyin ve 12 kuralı bu gece CLAUDE.md dosyanıza yapıştırın. Sizi bir haftalık Claude yanlış yönelmelerinden kurtardıysa tekrar paylaşın.
Günlük claude optimizasyon ipuçları için Telegram:
