Add Turkish (tr) docs and update README (#744)

* Add Turkish (tr) docs and update README Add a full set of Turkish documentation under docs/tr (agents, changelog, CLAUDE guide, contributing, code of conduct, and many agents/commands/skills/rules files). Update README to include a link to the Turkish docs and increment the supported language count from 5 to 6. This commit adds localized guidance and references to help Turkish-speaking contributors and users. * Update docs/tr/TROUBLESHOOTING.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * Update docs/tr/README.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * docs(tr): fix license link and update readmes Update Turkish docs: change license badge link to point to repository root (../../LICENSE), increment displayed language count from 5 to 6, and remove two outdated related links from docs/tr/examples/README.md to keep references accurate. * Update docs/tr/commands/instinct-import.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> * Update docs/tr/commands/checkpoint.md Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> --------- Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
2026-04-05 16:53:29 +08:00 · 2026-03-23 01:37:04 +03:00
parent bb1efad7c7
commit fd2a8edb53
139 changed files with 26670 additions and 2 deletions
--- a/docs/tr/rules/common/agents.md
+++ b/docs/tr/rules/common/agents.md
@@ -0,0 +1,50 @@
+# Agent Orkestrasyonu
+
+## Mevcut Agent'lar
+
+`~/.claude/agents/` dizininde bulunur:
+
+| Agent | Amaç | Ne Zaman Kullanılır |
+|-------|---------|-------------|
+| planner | Uygulama planlaması | Karmaşık özellikler, refactoring |
+| architect | Sistem tasarımı | Mimari kararlar |
+| tdd-guide | Test odaklı geliştirme | Yeni özellikler, hata düzeltmeleri |
+| code-reviewer | Kod incelemesi | Kod yazdıktan sonra |
+| security-reviewer | Güvenlik analizi | Commit'lerden önce |
+| build-error-resolver | Build hatalarını düzeltme | Build başarısız olduğunda |
+| e2e-runner | E2E testleri | Kritik kullanıcı akışları |
+| refactor-cleaner | Ölü kod temizliği | Kod bakımı |
+| doc-updater | Dokümantasyon | Dokümanları güncelleme |
+| rust-reviewer | Rust kod incelemesi | Rust projeleri |
+
+## Anlık Agent Kullanımı
+
+Kullanıcı istemi gerekmez:
+1. Karmaşık özellik istekleri - **planner** agent kullan
+2. Kod yeni yazıldı/değiştirildi - **code-reviewer** agent kullan
+3. Hata düzeltmesi veya yeni özellik - **tdd-guide** agent kullan
+4. Mimari karar - **architect** agent kullan
+
+## Paralel Görev Yürütme
+
+Bağımsız işlemler için DAIMA paralel Task yürütme kullan:
+
+```markdown
+# İYİ: Paralel yürütme
+3 agent'ı paralel başlat:
+1. Agent 1: Auth modülü güvenlik analizi
+2. Agent 2: Cache sistemi performans incelemesi
+3. Agent 3: Utilities tip kontrolü
+
+# KÖTÜ: Gereksiz sıralı yürütme
+Önce agent 1, sonra agent 2, sonra agent 3
+```
+
+## Çok Perspektifli Analiz
+
+Karmaşık problemler için split role sub-agent'lar kullan:
+- Factual reviewer
+- Senior engineer
+- Security expert
+- Consistency reviewer
+- Redundancy checker
--- a/docs/tr/rules/common/coding-style.md
+++ b/docs/tr/rules/common/coding-style.md
@@ -0,0 +1,48 @@
+# Kodlama Stili
+
+## Immutability (KRİTİK)
+
+DAIMA yeni nesneler oluştur, mevcut olanları ASLA değiştirme:
+
+```
+// Pseudocode
+YANLIŞ:  modify(original, field, value) → original'i yerinde değiştirir
+DOĞRU: update(original, field, value) → değişiklikle birlikte yeni kopya döner
+```
+
+Gerekçe: Immutable veri gizli yan etkileri önler, debug'ı kolaylaştırır ve güvenli eşzamanlılık sağlar.
+
+## Dosya Organizasyonu
+
+ÇOK KÜÇÜK DOSYA > AZ BÜYÜK DOSYA:
+- Yüksek kohezyon, düşük coupling
+- Tipik 200-400 satır, maksimum 800
+- Büyük modüllerden utility'leri çıkar
+- Type'a göre değil, feature/domain'e göre organize et
+
+## Hata Yönetimi
+
+Hataları DAIMA kapsamlı bir şekilde yönet:
+- Her seviyede hataları açıkça ele al
+- UI'ye yönelik kodda kullanıcı dostu hata mesajları ver
+- Server tarafında detaylı hata bağlamı logla
+- Hataları asla sessizce yutma
+
+## Input Validasyonu
+
+Sistem sınırlarında DAIMA validate et:
+- İşlemeden önce tüm kullanıcı girdilerini validate et
+- Mümkün olan yerlerde schema tabanlı validasyon kullan
+- Açık hata mesajlarıyla hızlıca başarısız ol
+- Harici verilere asla güvenme (API yanıtları, kullanıcı girdisi, dosya içeriği)
+
+## Kod Kalitesi Kontrol Listesi
+
+İşi tamamlandı olarak işaretlemeden önce:
+- [ ] Kod okunabilir ve iyi adlandırılmış
+- [ ] Fonksiyonlar küçük (<50 satır)
+- [ ] Dosyalar odaklı (<800 satır)
+- [ ] Derin iç içe geçme yok (>4 seviye)
+- [ ] Düzgün hata yönetimi
+- [ ] Hardcoded değer yok (sabit veya config kullan)
+- [ ] Mutasyon yok (immutable pattern'ler kullanıldı)
--- a/docs/tr/rules/common/development-workflow.md
+++ b/docs/tr/rules/common/development-workflow.md
@@ -0,0 +1,38 @@
+# Geliştirme İş Akışı
+
+> Bu dosya [common/git-workflow.md](./git-workflow.md) dosyasını git işlemlerinden önce gerçekleşen tam özellik geliştirme süreci ile genişletir.
+
+Feature Implementation Workflow geliştirme pipeline'ını tanımlar: araştırma, planlama, TDD, kod incelemesi ve ardından git'e commit.
+
+## Feature Uygulama İş Akışı
+
+0. **Araştırma & Yeniden Kullanım** _(her yeni implementasyondan önce zorunlu)_
+   - **Önce GitHub kod araması:** Yeni bir şey yazmadan önce mevcut implementasyonları, şablonları ve pattern'leri bulmak için `gh search repos` ve `gh search code` çalıştır.
+   - **İkinci olarak kütüphane dokümanları:** Uygulamadan önce API davranışını, paket kullanımını ve versiyona özgü detayları doğrulamak için Context7 veya birincil vendor dokümanlarını kullan.
+   - **İlk ikisi yetersiz olduğunda Exa:** GitHub araması ve birincil dokümanlardan sonra daha geniş web araştırması veya keşif için Exa kullan.
+   - **Paket kayıtlarını kontrol et:** Utility kodu yazmadan önce npm, PyPI, crates.io ve diğer kayıtları ara. Kendi çözümlerinden ziyade test edilmiş kütüphaneleri tercih et.
+   - **Adapte edilebilir implementasyonlar ara:** Problemin %80+'sını çözen ve fork'lanabilir, port edilebilir veya wrap edilebilir açık kaynak projeler ara.
+   - Gereksinimi karşıladığında sıfırdan yeni kod yazmak yerine kanıtlanmış bir yaklaşımı benimsemeyi veya port etmeyi tercih et.
+
+1. **Önce Planla**
+   - Uygulama planı oluşturmak için **planner** agent kullan
+   - Kodlamadan önce planlama dokümanları oluştur: PRD, architecture, system_design, tech_doc, task_list
+   - Bağımlılıkları ve riskleri belirle
+   - Fazlara ayır
+
+2. **TDD Yaklaşımı**
+   - **tdd-guide** agent kullan
+   - Önce testleri yaz (RED)
+   - Testleri geçmek için uygula (GREEN)
+   - Refactor et (IMPROVE)
+   - %80+ coverage'ı doğrula
+
+3. **Kod İncelemesi**
+   - Kod yazdıktan hemen sonra **code-reviewer** agent kullan
+   - CRITICAL ve HIGH sorunları ele al
+   - Mümkün olduğunda MEDIUM sorunları düzelt
+
+4. **Commit & Push**
+   - Detaylı commit mesajları
+   - Conventional commits formatını takip et
+   - Commit mesaj formatı ve PR süreci için [git-workflow.md](./git-workflow.md) dosyasına bak
--- a/docs/tr/rules/common/git-workflow.md
+++ b/docs/tr/rules/common/git-workflow.md
@@ -0,0 +1,24 @@
+# Git İş Akışı
+
+## Commit Mesaj Formatı
+```
+<type>: <description>
+
+<optional body>
+```
+
+Types: feat, fix, refactor, docs, test, chore, perf, ci
+
+Not: Attribution ~/.claude/settings.json aracılığıyla global olarak devre dışı bırakıldı.
+
+## Pull Request İş Akışı
+
+PR oluştururken:
+1. Tam commit geçmişini analiz et (sadece son commit değil)
+2. Tüm değişiklikleri görmek için `git diff [base-branch]...HEAD` kullan
+3. Kapsamlı PR özeti taslağı hazırla
+4. TODO'ları içeren test planı ekle
+5. Yeni branch ise `-u` flag'i ile push et
+
+> Git işlemlerinden önce tam geliştirme süreci (planlama, TDD, kod incelemesi) için
+> [development-workflow.md](./development-workflow.md) dosyasına bakın.
--- a/docs/tr/rules/common/hooks.md
+++ b/docs/tr/rules/common/hooks.md
@@ -0,0 +1,30 @@
+# Hooks Sistemi
+
+## Hook Tipleri
+
+- **PreToolUse**: Tool yürütmeden önce (validasyon, parametre değişikliği)
+- **PostToolUse**: Tool yürütmeden sonra (auto-format, kontroller)
+- **Stop**: Session bittiğinde (final doğrulama)
+
+## Auto-Accept İzinleri
+
+Dikkatli kullan:
+- Güvenilir, iyi tanımlanmış planlar için etkinleştir
+- Keşifsel çalışmalar için devre dışı bırak
+- Asla dangerously-skip-permissions flag'i kullanma
+- Bunun yerine `~/.claude.json` içinde `allowedTools` yapılandır
+
+## TodoWrite En İyi Uygulamalar
+
+TodoWrite tool'unu şunlar için kullan:
+- Çok adımlı görevlerdeki ilerlemeyi takip et
+- Talimatların anlaşıldığını doğrula
+- Gerçek zamanlı yönlendirmeyi etkinleştir
+- Detaylı implementasyon adımlarını göster
+
+Todo listesi şunları ortaya çıkarır:
+- Sıra dışı adımlar
+- Eksik öğeler
+- Fazladan gereksiz öğeler
+- Yanlış detay düzeyi
+- Yanlış yorumlanmış gereksinimler
--- a/docs/tr/rules/common/patterns.md
+++ b/docs/tr/rules/common/patterns.md
@@ -0,0 +1,31 @@
+# Yaygın Pattern'ler
+
+## Skeleton Projeler
+
+Yeni fonksiyonellik uygulanırken:
+1. Test edilmiş skeleton projeler ara
+2. Seçenekleri değerlendirmek için paralel agent'lar kullan:
+   - Güvenlik değerlendirmesi
+   - Genişletilebilirlik analizi
+   - İlgililik puanlaması
+   - Uygulama planlaması
+3. En iyi eşleşmeyi temel olarak klonla
+4. Kanıtlanmış yapı içinde iterate et
+
+## Tasarım Pattern'leri
+
+### Repository Pattern
+
+Veri erişimini tutarlı bir arayüz arkasında kapsülle:
+- Standart işlemleri tanımla: findAll, findById, create, update, delete
+- Concrete implementasyonlar storage detaylarını ele alır (database, API, file, vb.)
+- Business logic storage mekanizması yerine abstract interface'e bağlıdır
+- Veri kaynaklarının kolay değiştirilmesini sağlar ve mock'larla testi basitleştirir
+
+### API Response Formatı
+
+Tüm API yanıtları için tutarlı bir zarf kullan:
+- Success/status göstergesi ekle
+- Data payload ekle (hata durumunda nullable)
+- Hata mesajı alanı ekle (başarı durumunda nullable)
+- Sayfalandırılmış yanıtlar için metadata ekle (total, page, limit)
--- a/docs/tr/rules/common/performance.md
+++ b/docs/tr/rules/common/performance.md
@@ -0,0 +1,55 @@
+# Performans Optimizasyonu
+
+## Model Seçim Stratejisi
+
+**Haiku 4.5** (Sonnet kapasitesinin %90'ı, 3x maliyet tasarrufu):
+- Sık çağrılan hafif agent'lar
+- Pair programming ve kod üretimi
+- Multi-agent sistemlerinde worker agent'lar
+
+**Sonnet 4.6** (En iyi kodlama modeli):
+- Ana geliştirme çalışması
+- Multi-agent iş akışlarını orkestrasyon
+- Karmaşık kodlama görevleri
+
+**Opus 4.5** (En derin akıl yürütme):
+- Karmaşık mimari kararlar
+- Maksimum akıl yürütme gereksinimleri
+- Araştırma ve analiz görevleri
+
+## Context Window Yönetimi
+
+Context window'un son %20'sinden kaçın:
+- Büyük ölçekli refactoring
+- Birden fazla dosyaya yayılan özellik implementasyonu
+- Karmaşık etkileşimleri debug etme
+
+Daha düşük context hassasiyeti olan görevler:
+- Tek dosya düzenlemeleri
+- Bağımsız utility oluşturma
+- Dokümantasyon güncellemeleri
+- Basit hata düzeltmeleri
+
+## Extended Thinking + Plan Mode
+
+Extended thinking varsayılan olarak etkindir ve dahili akıl yürütme için 31,999 token'a kadar ayırır.
+
+Extended thinking kontrolü:
+- **Toggle**: Option+T (macOS) / Alt+T (Windows/Linux)
+- **Config**: `~/.claude/settings.json` içinde `alwaysThinkingEnabled` ayarla
+- **Budget cap**: `export MAX_THINKING_TOKENS=10000`
+- **Verbose mode**: Thinking çıktısını görmek için Ctrl+O
+
+Derin akıl yürütme gerektiren karmaşık görevler için:
+1. Extended thinking'in etkin olduğundan emin ol (varsayılan olarak açık)
+2. Yapılandırılmış yaklaşım için **Plan Mode**'u etkinleştir
+3. Kapsamlı analiz için birden fazla kritik tur kullan
+4. Çeşitli perspektifler için split role sub-agent'lar kullan
+
+## Build Sorun Giderme
+
+Build başarısız olursa:
+1. **build-error-resolver** agent kullan
+2. Hata mesajlarını analiz et
+3. Aşamalı olarak düzelt
+4. Her düzeltmeden sonra doğrula
--- a/docs/tr/rules/common/security.md
+++ b/docs/tr/rules/common/security.md
@@ -0,0 +1,29 @@
+# Güvenlik Kuralları
+
+## Zorunlu Güvenlik Kontrolleri
+
+HERHANGİ bir commit'ten önce:
+- [ ] Hardcoded secret yok (API anahtarları, şifreler, token'lar)
+- [ ] Tüm kullanıcı girdileri validate edildi
+- [ ] SQL injection önleme (parametreli sorgular)
+- [ ] XSS önleme (sanitize edilmiş HTML)
+- [ ] CSRF koruması etkin
+- [ ] Authentication/authorization doğrulandı
+- [ ] Tüm endpoint'lerde rate limiting
+- [ ] Hata mesajları hassas veri sızdırmıyor
+
+## Secret Yönetimi
+
+- Kaynak kodda ASLA secret'ları hardcode etme
+- DAIMA environment variable'lar veya secret manager kullan
+- Başlangıçta gerekli secret'ların mevcut olduğunu validate et
+- İfşa olmuş olabilecek secret'ları rotate et
+
+## Güvenlik Yanıt Protokolü
+
+Güvenlik sorunu bulunursa:
+1. HEMEN DUR
+2. **security-reviewer** agent kullan
+3. Devam etmeden önce CRITICAL sorunları düzelt
+4. İfşa olmuş secret'ları rotate et
+5. Benzer sorunlar için tüm kod tabanını incele
--- a/docs/tr/rules/common/testing.md
+++ b/docs/tr/rules/common/testing.md
@@ -0,0 +1,29 @@
+# Test Gereksinimleri
+
+## Minimum Test Coverage: %80
+
+Test Tipleri (HEPSİ gerekli):
+1. **Unit Tests** - Bireysel fonksiyonlar, utility'ler, component'ler
+2. **Integration Tests** - API endpoint'leri, database işlemleri
+3. **E2E Tests** - Kritik kullanıcı akışları (framework dile göre seçilir)
+
+## Test Odaklı Geliştirme
+
+ZORUNLU iş akışı:
+1. Önce test yaz (RED)
+2. Testi çalıştır - BAŞARISIZ olmalı
+3. Minimum implementasyon yaz (GREEN)
+4. Testi çalıştır - BAŞARILI olmalı
+5. Refactor et (IMPROVE)
+6. Coverage'ı doğrula (%80+)
+
+## Test Hatalarında Sorun Giderme
+
+1. **tdd-guide** agent kullan
+2. Test izolasyonunu kontrol et
+3. Mock'ların doğru olduğunu doğrula
+4. Testleri değil implementasyonu düzelt (testler yanlış olmadıkça)
+
+## Agent Desteği
+
+- **tdd-guide** - Yeni özellikler için PROAKTİF olarak kullan, test-önce-yaz'ı zorlar