Claude Dosya Hiyerarşisi

```html

DevLog

Yazılar Rehberler Sistem Mimarisi

Yapılandırma Rehberi

Anatomy of the .claude/ Folder

Projelerinizde Claude AI asistanının davranışlarını, yetkilerini ve iş akışlarını yapılandırmak için kullanılan hiyerarşik dosya sisteminin teknik incelemesi.

Dizin Haritası

your-project/

CLAUDE.md

CLAUDE.local.md

.claude/

settings.json

settings.local.json

commands/

review.md

fix-issue.md

deploy.md

rules/

code-style.md

testing.md

skills/

security-review/

SKILL.md

agents/

code-reviewer.md

security-auditor.md

Temel Talimatlar

Proje kök dizininde yer alan ve asistanın temel bağlamını belirleyen dosyalar.

CLAUDE.md (Takım Geneli)

Sürüm kontrolüne (Git) eklenir. Tüm takım için bağlayıcıdır.

Doğru Örnek

"UI bileşenleri için her zaman Tailwind CSS kullan. Servis katmanında Singleton pattern uygula."

CLAUDE.local.md (Kişisel)

Sürüm kontrolünden dışlanır (.gitignore). Sadece yerel ortamınızı bağlar.

Doğru Örnek

LOCAL_DB_PATH="C:/dev/dbs/test.sqlite3"

İzinler: settings.json

Asistanın sistem üzerindeki okuma ve yazma yetkilerini yapılandırır.

Yanlış Kullanım

Tüm sisteme kısıtlamasız erişim vermek güvenlik açığı oluşturur.

{
  "permissions": {
    "read": ["/"],
    "write": ["/"]
  }
}

Doğru Kullanım

Sadece gerekli dizinlere özel izinler verilmelidir (Minimum Yetki Prensibi).

{
  "permissions": {
    "read": ["./src", "./docs"],
    "write": ["./src/components"]
  }
}

Özel Komutlar (commands/)

Chat arayüzünde manuel olarak tetiklenebilen / (slash) komutlarını tanımlar. Dosya adı, komut adını belirler.

deploy.md

/project:deploy

İçerik Örneği: "Projeyi production ortamı için derle, statik dosyaları oluştur ve testleri çalıştırarak rapor ver."

Otomasyon: Skills

İnsan müdahalesi olmadan, belirli tetikleyicilerle çalışan arka plan görevleridir.

Örnek Senaryo: security-review/SKILL.md

Geliştirici yeni bir Pull Request açtığında, bu yetenek (skill) otomatik tetiklenir. Kodu SQL Injection ve XSS açıklarına karşı tarar, bulguları PR yorumu olarak ekler.

İzole Roller: Agents

Ana asistanın bağlamından ayrıştırılmış, spesifik uzmanlıklara sahip alt asistanlardır. Görev ayrılığı (Separation of Concerns) sağlar.

security-auditor.md

"Sen sadece bir güvenlik denetçisisin. Kodun iş mantığıyla ilgilenme, sadece zafiyetleri raporla."

code-reviewer.md

"Sen kıdemli bir yazılım mimarısın. Kodun SOLID prensiplerine uygunluğunu denetle ve refactoring önerileri sun."

© 2026 DevLog. Sistem Mimarisi Notları.

```

Projeyi bu mimariye göre yapılandırması ve yönetmesi için yapay zekaya şu komut verilebilir:

"Sen bu projenin yapılandırma asistanısın. Bundan sonraki tüm iş akışlarını ve kuralları .claude/ hiyerarşisine göre oluşturup yöneteceksin.

Genel bağlamı ve takım kurallarını CLAUDE.md dosyasında tut. İzinleri ve ayarları .claude/settings.json içinde minimum yetki prensibiyle sınırla. Yeni bir manuel komut istendiğinde .claude/commands/, yeni bir kodlama standardı belirlendiğinde .claude/rules/, otomatik bir iş akışı gerektiğinde .claude/skills/ ve spesifik bir alt rol tanımlandığında .claude/agents/ dizini altına ilgili Markdown veya JSON dosyasını oluştur. Kuralları birbirine karıştırma ve her talimatı kendi modülünde izole et."