everything-claude-code/docs/tr/CONTRIBUTING.md

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
• Hızlı Başlangıç
• Skill'lere Katkıda Bulunma
• Agent'lara Katkıda Bulunma
• Hook'lara Katkıda Bulunma
• Command'lara Katkıda Bulunma
• MCP ve dokümantasyon (örn. Context7)
• Cross-Harness ve Çeviriler
• 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ıç

# 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

---
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

---
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ı

{
  "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

// 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

// 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

---
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ı

## Ö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
• X/Twitter: @affaanmustafa

---

Katkıda bulunduğunuz için teşekkürler! Birlikte harika bir kaynak oluşturalım.