CLAUDE.md'nin Doğru Kullanım Şekli

CLAUDE.md, projenizin kök dizinine yerleştirilen ve AI asistanlarına (Claude gibi) projenizle ilgili temel bilgileri aktarmak için kullanılan özel bir dosyadır. Bu dosyayı doğru bir şekilde yazmak, AI'nın projenizi daha iyi anlamasını ve size daha iyi yardımcı olmasını sağlar.

Neden CLAUDE.md'ye İhtiyaç Duyulur?

Yeni bir iş arkadaşınızın geldiğini ve projenizi anlaması için ne kadar süre harcamanız gerektiğini hayal edin. CLAUDE.md, AI'nın hızlı bir şekilde projeye adapte olmasını sağlayan "proje kılavuzu"dur.

CLAUDE.md'nin Beş Temel İçeriği

1. Proje Özeti

Bu projenin ne yaptığını, hangi sorunu çözdüğünü ve hangi kullanıcılara yönelik olduğunu basitçe açıklayın.

# Proje Özeti Bu, ürünleri, siparişleri ve kullanıcıları yönetmek için kullanılan bir e-ticaret arka ofis yönetim sistemidir.

2. Teknoloji Yığını (Tech Stack)

Projede kullanılan ana teknolojileri ve framework'leri listeleyin.

`# Teknoloji Yığını

Frontend: React + TypeScript
Backend: Node.js + Express
Veritabanı: PostgreSQL
Dağıtım: Docker + Kubernetes`

3. Dosya Yapısı

Ana dizinlerin rollerini açıklayın.

# Dosya Yapısı /src /components - UI bileşenleri /pages - Sayfalar /utils - Yardımcı fonksiyonlar /api - API çağrıları

4. Yaygın Komutlar

Geliştirme sırasında yaygın olarak kullanılan komutları listeleyin.

# Yaygın Komutlar npm run dev - Geliştirme sunucusunu başlat npm run build - Üretim sürümünü oluştur npm run test - Testleri çalıştır

5. Kurallar

AI'nın kod yazarken uyması gereken kuralları tanımlayın.

`# Kodlama Kuralları

Fonksiyonel bileşenler kullanın
ESLint yapılandırmasına uyun
Bileşen adlandırmasında PascalCase kullanın
Değişken adlandırmasında camelCase kullanın`

Tam Bir Örnek

`# Proje Adı: Görev Yöneticisi

Proje Özeti

Basit bir görev yönetimi uygulaması, görev oluşturma, düzenleme, silme ve sınıflandırmayı destekler.

Teknoloji Yığını

React 18
TypeScript
Tailwind CSS
Vite

Dosya Yapısı

/src /components - UI bileşenleri /hooks - Özel Hooks /types - TypeScript tür tanımları /utils - Yardımcı fonksiyonlar

Yaygın Komutlar

npm run dev: Geliştirme sunucusunu başlat
npm run build: Üretim sürümünü oluştur
npm run lint: Kod denetimi

Kodlama Standartları

Bileşenler fonksiyonel olarak yazılır
Stil için Tailwind CSS kullanılır
Her bileşen ayrı bir klasöre yerleştirilir`

İpuçları

Kısa tutun: Çok uzun yazmayın, AI da "yorulur"
Düzenli olarak güncelleyin: Proje değiştiğinde CLAUDE.md'yi güncellemeyi unutmayın
Örneklere öncelik verin: Somut kod örnekleri, soyut açıklamalardan daha etkilidir
Ağrı noktalarına odaklanın: Hata yapmaya yatkın alanları vurgulayın

CLAUDE.md'yi doğru bir şekilde yazın ve AI'nın güvenilir yardımcınız olmasını sağlayın!