Sorun

Monorepo'da Claude, çalışma dizininin üstündeki tüm CLAUDE.md dosyalarını yükler. apps/web içinde çalışırken kökteki ve başka takımların talimatları da bağlama girer: hem yer kaplar hem çelişki üretir.

1. Kuralları yola göre böl

.claude/rules/api.md

paths:

• "apps/api/**/*.ts"

---

API kuralları

• Her uç nokta girdi doğrulaması içerir
• Hata biçimi: { error: { code, message } }

.claude/rules/web.md

paths:

• "apps/web/**/*.{ts,tsx}"

---

Web kuralları

• Sunucu bileşeni varsayılan; "use client" gerekçesi yorum satırında
• Veri çekme sayfa seviyesinde, bileşen içinde değil

Bu kurallar yalnızca eşleşen dosyalara dokunulduğunda yüklenir.

2. İlgisiz CLAUDE.md'leri dışla

.claude/settings.local.json (kişisel, commit etme) { "claudeMdExcludes": [ "/monorepo/CLAUDE.md", "/Users/ben/monorepo/other-team/.claude/rules/" ] }

3. Kökte ne kalmalı

Kök CLAUDE.md yalnızca herkesi ilgilendiren şeyleri taşımalı:

• Depo düzeni (hangi paket ne işe yarar)
• Ortak komutlar (pnpm -w build, pnpm -F web dev)
• Sürüm ve dal politikası

Paket düzeyindeki her şey apps/<ad>/CLAUDE.md içine.

Ölçüt

/context çalıştır, "Memory files" listesine bak. Yüklenen dosyaların hepsi o an yaptığın işle ilgili değilse bölme zamanı gelmiştir. 200 satırın üstündeki bir CLAUDE.md uyumu düşürür.