Karpathy'nin Gözlemlerinden Doğan CLAUDE.md Dosyası GitHub'u Salladı

Yapay zeka dünyasının tanınan ismi Andrej Karpathy, Ocak 2026'da X'te bir gönderi paylaştı: son yirmi yılın en büyük iş akışı değişikliği yaşadığını, kodun %80'ini artık Claude Code gibi ajan tabanlı araçlarla yazdığını anlattı. Ve bu süreçte AI'ın tekrar tekrar düştüğü dört büyük hatayı sıraladı.

Geliştirici Forrest Chang, bu gönderiyi okuyunca harekete geçti ve Karpathy'nin tespit ettiği dört hata kalıbını makine tarafından okunabilir bir CLAUDE.md dosyasına dönüştürdü. Dosya, Claude Code'un her oturumda otomatik okuduğu bir talimat belgesi — modele nasıl davranması gerektiğini söylüyor.

İki farklı repoda yayınlanan dosya, birleşik olarak 220.000'den fazla yıldız topladı ve GitHub tarihinin en hızlı büyüyen repolarından biri oldu.

4 Kural:

Kod yazmadan önce düşün. Varsayımlarını açıkça belirt, emin değilsen sor, tahmin ederek ilerleme.

Önce sadelik. Problemi çözen en küçük çözümü yaz. Kimsenin istemediği soyutlamalar ekleme.

Sadece gereken yeri değiştir. İstekle ilgisi olmayan koda dokunma.

Hedefi netleştir. Belirsiz istekleri, kod yazmadan önce ölçülebilir başarı kriterlerine çevir.

Karpathy'nin kendi ifadesiyle: "Modeller adına yanlış varsayımlar yapıyor ve kontrol etmeden ilerliyor. Kendi kafalarının karışıklığını yönetmiyorlar, açıklama istemiyorlar, tutarsızlıkları yüzeye çıkarmıyorlar." Bu 4 kural tam da bu sorunu çözmeye odaklanıyor.

65 satır. 4 kural. Büyük fark.