Takımınızda beş geliştirici var ve her biri kendi CLAUDE.md dosyasını yazmış durumda. Alice "Üretime onay almadan veri gönderme" kuralını benimsemişken, Bob "Testleri otomatik çalıştır" diyor. Carlos açıklamaları dinlemeden kod yazarken, Diana da her yeni dosyaya TypeScript strict modunu zorunlu kılıyor. Elena ise hiçbir kural uygulamıyor — sadece "uçuşa bırakıyor".
Bu durumda kimse birbirinden farklı davranışlara sahip beş farklı AI ajanının farkında bile değil. Çünkü her geliştirici sadece kendi CLAUDE.md dosyasını okuyor.
CLAUDE.md Neden Bu Kadar Dağınık Hale Geliyor?
CLAUDE.md, global bir ayar dosyası değil — proje bazında ve geliştirici bazında çalışan yerel bir doküman. Claude Code başlangıçta bu dosyayı okuyor ve her geliştiriciye özgü yorumlama yetkisine sahip. Bu dosya, takım içinde paylaşılmıyor, kayıt altına alınmıyor ya da uygulanması zorlanmıyor. Sonuçta, beş farklı geliştiricinin beş farklı CLAUDE.md dosyası olması doğal bir süreç.
Ancak bu durum, yalnız çalışırken sorun yaratmasa da takım çalışması başladığında ciddi aksaklıklara yol açıyor. Kod tabanının davranışı AI ajanlarının yorumlarına göre şekillenirken, herkesin farklı kurallarla çalışması tutarsızlıklara neden oluyor.
Farklı CLAUDE.md Dosyaları Gerçek Hayatta Ne Gibi Sorunlara Yol Açıyor?
Senaryo 1: Davranış çatışması, kod çatışması değil
Alice ve Bob aynı özelliği geliştiriyor. Alice’in CLAUDE.md’si testleri çalıştırmadan önce onay istiyor, Bob’unkiyse otomatik olarak çalıştırıyor. Bu durumda yapılan PR incelemeleri ve commit geçmişleri taban tabana zıt olabiliyor. Kodlar aynı olsa da AI ajanlarının davranışı farklılaşıyor ve takım için güvenilir bir ortam oluşturulamıyor.
Senaryo 2: Kural eksikliği ve bilgi boşluğu
Takım TypeScript’te any türünü yasaklamaya karar veriyor. Alice kuralı kendi CLAUDE.md’sine ekliyor, Bob ise eklemiyor. Bob’un ajanı hâlâ any önermeye devam ediyor. Bob, Claude Code’un bozuk olduğunu düşünüyor — ama aslında sadece kuralı görmemiş. Bu da takım içinde iletişim kopukluğuna yol açıyor.
Senaryo 3: Kuralın esnekliği ve kontrol kaybı
Başlangıçta sadece iki kural vardı. Şimdi on iki kural var. Alice’in on ikisi de uygulamasına rağmen, Bob sadece sekizini benimsemiş, Carlos beşini. Geçen sprintteki üç kuralın hangisinin regresyona yol açtığını kimse bilemiyor. Kural kaosu, takımın verimliliğini ve güvenilirliğini ciddi şekilde tehdit ediyor.
Tutarsız CLAUDE.md Dosyalarının Gerçek Maliyeti
- AI ajanları, geliştiriciye göre farklı standartlar uyguluyor
- Bir geliştiricinin oturumunda ortaya çıkan hatalar, diğerinde yaşanmayabiliyor
- Yeni geliştiricilerin güvenilir bir başlangıç kural seti yok
- Uyumluluk sorunlarının nedeninin AI modeli mi yoksa kural seti mi olduğunu ayırt edemiyorsunuz
- Kod incelemeleri, artık "insan davranışını" değil, "ajan davranışını" değerlendirmek zorunda kalıyor
Bu durumda takımınızın tek bir AI aracı olduğunu söylemek yerine, aslında beş farklı ajanla çalıştığınızı kabul etmek gerekiyor.
Çözüm: Ortak Bir CLAUDE.md Temel Kurallar Seti
Çözüm, herkese aynı CLAUDE.md dosyasını zorunlu kılmak değil. Geliştiricilerin kişisel tercihleri vardır ve buna saygı gösterilmelidir. Çözüm, takım içinde ortaklaşa kabul edilen kuralları ayırmak ve geliştiriciye özel katmanları ayrı bir şekilde yönetmektir.
Katman 1: Ortak Temel Kurallar (depo içerisinde kayıtlı)
Bu kurallar tüm katkıda bulunanlar için zorunlu olmalı ve depo içerisinde yer almalıdır.
## Zorunlu Davranış Kuralları
- Üretime veri göndermeden önce mutlaka onay al
- Yıkıcı veritabanı işlemlerini gerçekleştirmeden önce mutlaka kuru çalıştır (dry run) yap
- Yapacağın işlemleri uygulamadan önce mutlaka açıklama yap
- Görev kapsamı dışındaki dosyaları değiştirme
- Şüphen varsa sormaktan çekinme, tahminde bulunma
## Kod Standartları
- TypeScript: Tüm yeni dosyalarda strict mod zorunlu, `any` türü kullanma
- Testler: Testleri atlama, mock kullanırken mutlaka etiketle
- Commitler: Konvansiyonel commit formatı zorunluKatman 2: Geliştiriciye Özel Katman (gitignore’a eklenmeli)
Bu katmanda takımın genel kurallarına ek olarak kişisel tercihler yer almalıdır. Bu dosya depo içerisinde yer almamalı ve yalnızca ilgili geliştirici tarafından yönetilmelidir.
# CLAUDE.md.local — Kişisel tercihler (depo dışında)
- Adım adım açıklamaları tercih ederim, özetlerden kaçınırım
- Test önerilerini uygulamadan önce sunarımKatman 3: Üç Ayda Bir Gözden Geçirme
Ortak CLAUDE.md dosyasından sorumlu bir kişi belirlenmeli. Her üç ayda bir takım üyeleri arasındaki davranış farklılıkları değerlendirilmeli ve temel kurallar güncellenmelidir. Bu sayede kurallar takımın gerçek ihtiyaçlarına göre şekillendirilebilir.
Kural Sıralamasının Önemi
Ortak CLAUDE.md dosyanızda en kritik güvenlik kurallarını en başa yerleştirin. Bu dosya yukarıdan aşağıya doğru okunuyor ve uzun oturumlarda alt kısımlardaki kurallar zayıflayabiliyor. Örneğin, "Üretime veri gönderme" kuralı yedinci sırada değil, ilk sırada olmalıdır.
Takım için CLAUDE.md Yönetim Araçları
Takımınız için hazırlanmış, yaygın hatalara karşı koruma sağlayan önceden yazılmış kural setlerini kullanabilirsiniz. Bu setler, kapsam kayırması, sessiz veri gönderimi, test atlama, yıkıcı işlemler ve belirsiz talimatlar gibi yaygın sorunlara karşı çözümler sunar.
- CLAUDE.md Rules Pack: Takımlar için yapılandırılmış bir şablon sunan ücretli bir paket
- Ücretsiz başlangıç seti: Temel yapıyı ve minimal bir ortak kural setini ücretsiz olarak indirip takımınızla test edebilirsiniz
Bu araçlar, takımınıza uygun şekilde özelleştirilebilir ve AI ajanlarınızın davranışını tutarlı hale getirmek için önemli bir adım oluşturur.
Geleceğe Bakış: Tutarlılık ve Verimlilik için Adımlar
Takımınız Claude Code kullanıyorsa, ortak bir CLAUDE.md temel kurallar seti oluşturmak, takımınızın AI destekli geliştirme sürecini daha güvenilir ve verimli hale getirecektir. Kural setini üç kata ayırarak yönetmek, takım içerisinde hem ortak standartları korurken hem de bireysel esnekliği sağlayacaktır.
Üç ayda bir yapılan gözden geçirmeler ve kural sıralamasının dikkatli bir şekilde yapılması, AI ajanlarınızın takımın ihtiyaçlarına uygun şekilde davranmasını sağlayacaktır. Bu sayede kod tabanınız daha tutarlı, incelemeler daha güvenilir ve geliştirme süreciniz daha sağlam temeller üzerine kurulmuş olacaktır.
Yapay zeka özeti
Takımınızda farklı CLAUDE.md dosyalarıyla çalışıyorsanız, kod tabanında tutarsızlıklar kaçınılmaz. Ortak temel kurallar, katmanlı yapı ve üç aylık gözden geçirmelerle AI ajanlarınızı güvenilir hale getirin.
