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-08 18:33:28 +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/CONTRIBUTING.md
+++ b/docs/tr/CONTRIBUTING.md
@@ -0,0 +1,461 @@
+# Everything Claude Code'a Katkıda Bulunma
+
+Katkıda bulunmak istediğiniz için teşekkürler! Bu repo, Claude Code kullanıcıları için bir topluluk kaynağıdır.
+
+## İçindekiler
+
+- [Ne Arıyoruz](#ne-arıyoruz)
+- [Hızlı Başlangıç](#hızlı-başlangıç)
+- [Skill'lere Katkıda Bulunma](#skilllere-katkıda-bulunma)
+- [Agent'lara Katkıda Bulunma](#agentlara-katkıda-bulunma)
+- [Hook'lara Katkıda Bulunma](#hooklara-katkıda-bulunma)
+- [Command'lara Katkıda Bulunma](#commandlara-katkıda-bulunma)
+- [MCP ve dokümantasyon (örn. Context7)](#mcp-ve-dokümantasyon-örn-context7)
+- [Cross-Harness ve Çeviriler](#cross-harness-ve-çeviriler)
+- [Pull Request Süreci](#pull-request-süreci)
+
+---
+
+## Ne Arıyoruz
+
+### Agent'lar
+Belirli görevleri iyi yöneten yeni agent'lar:
+- Dile özgü reviewer'lar (Python, Go, Rust)
+- Framework uzmanları (Django, Rails, Laravel, Spring)
+- DevOps uzmanları (Kubernetes, Terraform, CI/CD)
+- Alan uzmanları (ML pipeline'ları, data engineering, mobil)
+
+### Skill'ler
+Workflow tanımları ve alan bilgisi:
+- Dil en iyi uygulamaları
+- Framework pattern'leri
+- Test stratejileri
+- Mimari kılavuzları
+
+### Hook'lar
+Faydalı otomasyonlar:
+- Linting/formatlama hook'ları
+- Güvenlik kontrolleri
+- Doğrulama hook'ları
+- Bildirim hook'ları
+
+### Command'lar
+Faydalı workflow'ları çağıran slash command'lar:
+- Deployment command'ları
+- Test command'ları
+- Kod üretim command'ları
+
+---
+
+## Hızlı Başlangıç
+
+```bash
+# 1. Fork ve clone
+gh repo fork affaan-m/everything-claude-code --clone
+cd everything-claude-code
+
+# 2. Branch oluştur
+git checkout -b feat/my-contribution
+
+# 3. Katkınızı ekleyin (aşağıdaki bölümlere bakın)
+
+# 4. Yerel olarak test edin
+cp -r skills/my-skill ~/.claude/skills/  # skill'ler için
+# Ardından Claude Code ile test edin
+
+# 5. PR gönderin
+git add . && git commit -m "feat: add my-skill" && git push -u origin feat/my-contribution
+```
+
+---
+
+## Skill'lere Katkıda Bulunma
+
+Skill'ler, Claude Code'un bağlama göre yüklediği bilgi modülleridir.
+
+### Dizin Yapısı
+
+```
+skills/
+└── your-skill-name/
+    └── SKILL.md
+```
+
+### SKILL.md Şablonu
+
+```markdown
+---
+name: your-skill-name
+description: Skill listesinde gösterilen kısa açıklama
+origin: ECC
+---
+
+# Skill Başlığınız
+
+Bu skill'in neyi kapsadığına dair kısa genel bakış.
+
+## Temel Kavramlar
+
+Temel pattern'leri ve yönergeleri açıklayın.
+
+## Kod Örnekleri
+
+\`\`\`typescript
+// Pratik, test edilmiş örnekler ekleyin
+function example() {
+  // İyi yorumlanmış kod
+}
+\`\`\`
+
+## En İyi Uygulamalar
+
+- Uygulanabilir yönergeler
+- Yapılması ve yapılmaması gerekenler
+- Kaçınılması gereken yaygın hatalar
+
+## Ne Zaman Kullanılır
+
+Bu skill'in uygulandığı senaryoları açıklayın.
+```
+
+### Skill Kontrol Listesi
+
+- [ ] Tek bir alan/teknolojiye odaklanmış
+- [ ] Pratik kod örnekleri içeriyor
+- [ ] 500 satırın altında
+- [ ] Net bölüm başlıkları kullanıyor
+- [ ] Claude Code ile test edilmiş
+
+### Örnek Skill'ler
+
+| Skill | Amaç |
+|-------|---------|
+| `coding-standards/` | TypeScript/JavaScript pattern'leri |
+| `frontend-patterns/` | React ve Next.js en iyi uygulamaları |
+| `backend-patterns/` | API ve veritabanı pattern'leri |
+| `security-review/` | Güvenlik kontrol listesi |
+
+---
+
+## Agent'lara Katkıda Bulunma
+
+Agent'lar, Task tool üzerinden çağrılan özelleşmiş asistanlardır.
+
+### Dosya Konumu
+
+```
+agents/your-agent-name.md
+```
+
+### Agent Şablonu
+
+```markdown
+---
+name: your-agent-name
+description: Bu agent'ın ne yaptığı ve Claude'un onu ne zaman çağırması gerektiği. Spesifik olun!
+tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
+model: sonnet
+---
+
+Siz bir [rol] uzmanısınız.
+
+## Rolünüz
+
+- Birincil sorumluluk
+- İkincil sorumluluk
+- YAPMADIĞINIZ şeyler (sınırlar)
+
+## Workflow
+
+### Adım 1: Anlama
+Göreve nasıl yaklaşıyorsunuz.
+
+### Adım 2: Uygulama
+İşi nasıl gerçekleştiriyorsunuz.
+
+### Adım 3: Doğrulama
+Sonuçları nasıl doğruluyorsunuz.
+
+## Çıktı Formatı
+
+Kullanıcıya ne döndürüyorsunuz.
+
+## Örnekler
+
+### Örnek: [Senaryo]
+Girdi: [kullanıcının sağladığı]
+Eylem: [yaptığınız]
+Çıktı: [döndürdüğünüz]
+```
+
+### Agent Alanları
+
+| Alan | Açıklama | Seçenekler |
+|-------|-------------|---------|
+| `name` | Küçük harf, tire ile ayrılmış | `code-reviewer` |
+| `description` | Ne zaman çağrılacağına karar vermek için kullanılır | Spesifik olun! |
+| `tools` | Sadece gerekli olanlar | `Read, Write, Edit, Bash, Grep, Glob, WebFetch, Task`, veya agent MCP kullanıyorsa MCP tool isimleri (örn. `mcp__context7__resolve-library-id`, `mcp__context7__query-docs`) |
+| `model` | Karmaşıklık seviyesi | `haiku` (basit), `sonnet` (kodlama), `opus` (karmaşık) |
+
+### Örnek Agent'lar
+
+| Agent | Amaç |
+|-------|---------|
+| `tdd-guide.md` | Test odaklı geliştirme |
+| `code-reviewer.md` | Kod incelemesi |
+| `security-reviewer.md` | Güvenlik taraması |
+| `build-error-resolver.md` | Build hatalarını düzeltme |
+
+---
+
+## Hook'lara Katkıda Bulunma
+
+Hook'lar, Claude Code olayları tarafından tetiklenen otomatik davranışlardır.
+
+### Dosya Konumu
+
+```
+hooks/hooks.json
+```
+
+### Hook Türleri
+
+| Tür | Tetikleyici | Kullanım Alanı |
+|------|---------|----------|
+| `PreToolUse` | Tool çalışmadan önce | Doğrulama, uyarı, engelleme |
+| `PostToolUse` | Tool çalıştıktan sonra | Formatlama, kontrol, bildirim |
+| `SessionStart` | Oturum başladığında | Bağlam yükleme |
+| `Stop` | Oturum sona erdiğinde | Temizleme, denetim |
+
+### Hook Formatı
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"rm -rf /\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[Hook] ENGELLENDİ: Tehlikeli komut' && exit 1"
+          }
+        ],
+        "description": "Tehlikeli rm komutlarını engelle"
+      }
+    ]
+  }
+}
+```
+
+### Matcher Sözdizimi
+
+```javascript
+// Belirli tool'ları eşleştir
+tool == "Bash"
+tool == "Edit"
+tool == "Write"
+
+// Girdi pattern'lerini eşleştir
+tool_input.command matches "npm install"
+tool_input.file_path matches "\\.tsx?$"
+
+// Koşulları birleştir
+tool == "Bash" && tool_input.command matches "git push"
+```
+
+### Hook Örnekleri
+
+```json
+// tmux dışında dev server'ları engelle
+{
+  "matcher": "tool == \"Bash\" && tool_input.command matches \"npm run dev\"",
+  "hooks": [{"type": "command", "command": "echo 'Dev server'lar için tmux kullanın' && exit 1"}],
+  "description": "Dev server'ların tmux'ta çalışmasını sağla"
+}
+
+// TypeScript düzenledikten sonra otomatik formatla
+{
+  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.tsx?$\"",
+  "hooks": [{"type": "command", "command": "npx prettier --write \"$file_path\""}],
+  "description": "TypeScript dosyalarını düzenlemeden sonra formatla"
+}
+
+// git push öncesi uyar
+{
+  "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
+  "hooks": [{"type": "command", "command": "echo '[Hook] Push yapmadan önce değişiklikleri gözden geçirin'"}],
+  "description": "Push öncesi gözden geçirme hatırlatıcısı"
+}
+```
+
+### Hook Kontrol Listesi
+
+- [ ] Matcher spesifik (aşırı geniş değil)
+- [ ] Net hata/bilgi mesajları içeriyor
+- [ ] Doğru çıkış kodlarını kullanıyor (`exit 1` engeller, `exit 0` izin verir)
+- [ ] Kapsamlı test edilmiş
+- [ ] Açıklama içeriyor
+
+---
+
+## Command'lara Katkıda Bulunma
+
+Command'lar, `/command-name` ile kullanıcı tarafından çağrılan eylemlerdir.
+
+### Dosya Konumu
+
+```
+commands/your-command.md
+```
+
+### Command Şablonu
+
+```markdown
+---
+description: /help'te gösterilen kısa açıklama
+---
+
+# Command Adı
+
+## Amaç
+
+Bu command'ın ne yaptığı.
+
+## Kullanım
+
+\`\`\`
+/your-command [args]
+\`\`\`
+
+## Workflow
+
+1. İlk adım
+2. İkinci adım
+3. Son adım
+
+## Çıktı
+
+Kullanıcının aldığı.
+```
+
+### Örnek Command'lar
+
+| Command | Amaç |
+|---------|---------|
+| `commit.md` | Git commit'leri oluştur |
+| `code-review.md` | Kod değişikliklerini incele |
+| `tdd.md` | TDD workflow'u |
+| `e2e.md` | E2E test |
+
+---
+
+## MCP ve dokümantasyon (örn. Context7)
+
+Skill'ler ve agent'lar, sadece eğitim verilerine güvenmek yerine güncel verileri çekmek için **MCP (Model Context Protocol)** tool'larını kullanabilir. Bu özellikle dokümantasyon için faydalıdır.
+
+- **Context7**, `resolve-library-id` ve `query-docs`'u açığa çıkaran bir MCP server'ıdır. Kullanıcı kütüphaneler, framework'ler veya API'ler hakkında sorduğunda, cevapların güncel dokümantasyonu ve kod örneklerini yansıtması için kullanın.
+- Canlı dokümantasyona bağlı **skill'lere** katkıda bulunurken (örn. kurulum, API kullanımı), ilgili MCP tool'larının nasıl kullanılacağını açıklayın (örn. kütüphane ID'sini çözümle, ardından dokümantasyonu sorgula) ve pattern olarak `documentation-lookup` skill'ine veya Context7'ye işaret edin.
+- Dokümantasyon/API sorularını yanıtlayan **agent'lara** katkıda bulunurken, agent'ın tool'larına Context7 MCP tool isimlerini ekleyin (örn. `mcp__context7__resolve-library-id`, `mcp__context7__query-docs`) ve çözümle → sorgula workflow'unu belgeleyin.
+- **mcp-configs/mcp-servers.json** bir Context7 girişi içerir; kullanıcılar `documentation-lookup` skill'ini (`skills/documentation-lookup/` içinde) ve `/docs` command'ını kullanmak için bunu harness'lerinde (örn. Claude Code, Cursor) etkinleştirir.
+
+---
+
+## Cross-Harness ve Çeviriler
+
+### Skill alt kümeleri (Codex ve Cursor)
+
+ECC, diğer harness'ler için skill alt kümeleri içerir:
+
+- **Codex:** `.agents/skills/` — `agents/openai.yaml` içinde listelenen skill'ler Codex tarafından yüklenir.
+- **Cursor:** `.cursor/skills/` — Cursor için bir skill alt kümesi paketlenmiştir.
+
+Codex veya Cursor'da kullanılabilir olması gereken **yeni bir skill eklediğinizde**:
+
+1. Skill'i her zamanki gibi `skills/your-skill-name/` altına ekleyin.
+2. **Codex**'te kullanılabilir olması gerekiyorsa, `.agents/skills/` altına ekleyin (skill dizinini kopyalayın veya referans ekleyin) ve gerekirse `agents/openai.yaml` içinde referans verildiğinden emin olun.
+3. **Cursor**'da kullanılabilir olması gerekiyorsa, Cursor'un düzenine göre `.cursor/skills/` altına ekleyin.
+
+Beklenen yapı için bu dizinlerdeki mevcut skill'leri kontrol edin. Bu alt kümeleri senkronize tutmak manuel bir işlemdir; bunları güncellediyseniz PR'ınızda belirtin.
+
+### Çeviriler
+
+Çeviriler `docs/` altında bulunur (örn. `docs/zh-CN`, `docs/zh-TW`, `docs/ja-JP`). Çevrilmiş agent'ları, command'ları veya skill'leri değiştirirseniz, ilgili çeviri dosyalarını güncellemeyi veya bakımcıların ya da çevirmenlerin bunları güncelleyebilmesi için bir issue açmayı düşünün.
+
+---
+
+## Pull Request Süreci
+
+### 1. PR Başlık Formatı
+
+```
+feat(skills): add rust-patterns skill
+feat(agents): add api-designer agent
+feat(hooks): add auto-format hook
+fix(skills): update React patterns
+docs: improve contributing guide
+```
+
+### 2. PR Açıklaması
+
+```markdown
+## Özet
+Ne eklediğiniz ve neden.
+
+## Tür
+- [ ] Skill
+- [ ] Agent
+- [ ] Hook
+- [ ] Command
+
+## Test
+Bunu nasıl test ettiniz.
+
+## Kontrol Listesi
+- [ ] Format yönergelerini takip ediyor
+- [ ] Claude Code ile test edildi
+- [ ] Hassas bilgi yok (API anahtarları, yollar)
+- [ ] Net açıklamalar
+```
+
+### 3. İnceleme Süreci
+
+1. Bakımcılar 48 saat içinde inceler
+2. İstenirse geri bildirimlere cevap verin
+3. Onaylandığında, main'e merge edilir
+
+---
+
+## Yönergeler
+
+### Yapın
+- Katkıları odaklanmış ve modüler tutun
+- Net açıklamalar ekleyin
+- Göndermeden önce test edin
+- Mevcut pattern'leri takip edin
+- Bağımlılıkları belgeleyin
+
+### Yapmayın
+- Hassas veri eklemeyin (API anahtarları, token'lar, yollar)
+- Aşırı karmaşık veya niş config'ler eklemeyin
+- Test edilmemiş katkılar göndermeyin
+- Mevcut işlevselliğin kopyalarını oluşturmayın
+
+---
+
+## Dosya Adlandırma
+
+- Tire ile küçük harf kullanın: `python-reviewer.md`
+- Açıklayıcı olun: `tdd-workflow.md` değil `workflow.md`
+- İsim, dosya adıyla eşleşsin
+
+---
+
+## Sorularınız mı var?
+
+- **Issue'lar:** [github.com/affaan-m/everything-claude-code/issues](https://github.com/affaan-m/everything-claude-code/issues)
+- **X/Twitter:** [@affaanmustafa](https://x.com/affaanmustafa)
+
+---
+
+Katkıda bulunduğunuz için teşekkürler! Birlikte harika bir kaynak oluşturalım.