mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-31 06:03:29 +08:00
* 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>
1.6 KiB
1.6 KiB
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ı)