CLAUDE.md

Bu dosya, bu depoda çalışırken Claude Code (veya diğer yapay zekâ kod asistanlarına) rehberlik sağlar.

Projenin Amacı

Bu depo, Claude AI ve Claude Code için kapsamlı bir beceriler kütüphanesidir - alan uzmanlığını, en iyi uygulamaları, analiz araçlarını ve stratejik çerçeveleri bir araya getiren yeniden kullanılabilir, üretime hazır beceri paketleridir. Kütüphane, ekiplerin doğrudan kendi iş akışlarına indirip uygulayabileceği modüler beceriler sunar.

Mevcut Kapsam: 16 alanda üretime hazır 338 beceri; 533 Python otomasyon aracı, 676 referans rehberi, 51+ ajan (cs-* + 7 persona) ve 87+ eğik çizgi komutu (slash commands), 62 pazaryeri eklentisi olarak dağıtılmıştır.

Ana Fark: Bu klasik bir yazılım uygulaması değildir. Kullanıcıların kendi yapay zeka iş akışlarına dahil etmeleri için tasarlanmış modüler beceri paketlerinden oluşan bir kütüphanedir.

Dosya ve Klasör Yapısı

Her beceri paketi şu standart yapıyı takip eder:

beceri-adi/
├── SKILL.md              # Ana dokümantasyon ve talimatlar
├── scripts/              # Python CLI araçları (üçüncü parti bağımlılık barındırmayan, standart kütüphaneyle yazılmış)
├── references/           # Uzmanlık ve referans bilgi belgeleri
└── assets/               # Kullanıcı şablonları

Tasarım Felsefesi: Beceriler kendi kendine yetebilen modüler paketlerdir. Bilgi akışı references/ (referanslar) klasöründen başlar, SKILL.md üzerindeki iş akışlarına akar, scripts/ altındaki Python betikleriyle yürütülür ve assets/ altındaki şablonlarla pratik olarak uygulanır.

Geliştirme Standartları ve Kurallar

1. Beceriler birer üründür: Her beceri klasörü bağımsız olarak çalıştırılabilir ve kurulabilir olmalıdır.
2. Belge odaklı tasarım: Becerilerin başarısı, anlaşılır, net ve uygulanabilir kılavuzlara sahip olmasına bağlıdır.
3. LLM yerine deterministik algoritmalar tercih edilmelidir: Otomasyon betikleri oluştururken doğrudan LLM API çağrıları yerine standart Python kodlarıyla deterministik hesaplamalar ve analizler yapılmalıdır.
4. Şablon ağırlıklı altyapı: Kullanıcıların kolayca özelleştirebileceği esnek markdown şablonları sunulmalıdır.
5. Bağımlılık kısıtı: Python betiklerinde ek kütüphaneler (pip install) yerine sadece Python standart kütüphaneleri kullanılmalıdır.

Sürüm ve Yol Haritası

Mevcut sürüm: v2.9.0 (Yerelleştirilmiş ve Türkçe sürüm için başlangıç).

Bu depo, orijinal alirezarezvani/claude-skills projesinden Mogerinho/Clause-Skills-Turkish adına çatallanmış (fork) ve Türkçeleştirilmiştir.