Files
everything-claude-code/docs/tr/rules
konstapukarifastnetfi 8b24f63ede fix: refresh stale technical content in agents, rules, and skills (#2168)
Several published examples contained APIs that no longer exist, code that
does not run, or model versions that drifted from reality:

- agents/performance-optimizer.md used the web-vitals v3 API
  (getCLS/getFID/getLCP/getFCP/getTTFB) and reported FID. web-vitals v4
  renamed the imports to onCLS/onINP/onLCP/onFCP/onTTFB and FID was
  replaced by INP (target < 200ms)
- rules/common/performance.md pinned stale model versions in the
  model-selection guidance; refresh to the versions the repo itself uses
  (agent.yaml pins claude-opus-4-6) and add the PowerShell variant for
  MAX_THINKING_TOKENS next to the bash export
- skills/python-patterns/SKILL.md: both get_value examples referenced
  default_value without declaring the parameter (NameError); add
  default_value: Any = None to the EAFP and LBYL signatures
- skills/frontend-patterns/SKILL.md: the custom useQuery example rebuilt
  refetch whenever callers passed inline fetchers/options, re-triggering
  the effect after every state update (infinite fetch loop). Keep the
  latest fetcher/options in refs so refetch stays referentially stable.
  The PASS-labelled useMemo example mutated its input with in-place sort;
  copy before sorting
- skills/coding-standards/SKILL.md repeated the same PASS-labelled
  in-place-sort-in-useMemo example; same fix
- rules/typescript/security.md used a vendor-specific OPENAI_API_KEY in
  generic guidance; switch to a neutral API_KEY

Every hand-maintained copy of the affected content is synced in the same
change: locale mirrors (ja-JP, ko-KR, pt-BR, tr, zh-CN, zh-TW - each only
where it carries the affected file) and the .agents/.kiro/.cursor harness
mirrors. Two structural divergences are left alone and noted here:
.kiro/steering/performance.md has no extended-thinking control list to
carry the PowerShell variant, and docs/zh-TW/rules/performance.md keeps an
older condensed thinking section without the budget-cap line.
rules/zh/performance.md is intentionally untouched - the rules/zh tree is
being retired in a separate change
2026-06-07 13:26:01 +08:00
..

Kurallar (Rules)

Claude Code için kodlama kuralları ve en iyi uygulamalar.

Dizin Yapısı

Common (Dile Bağımsız Kurallar)

Tüm programlama dillerine uygulanan temel kurallar:

  • agents.md - Agent orkestrasyonu ve kullanımı
  • coding-style.md - Genel kodlama stili kuralları (immutability, dosya organizasyonu, hata yönetimi)
  • development-workflow.md - Özellik geliştirme iş akışı (araştırma, planlama, TDD, kod incelemesi)
  • git-workflow.md - Git commit ve PR iş akışı
  • hooks.md - Hook sistemi (PreToolUse, PostToolUse, Stop)
  • patterns.md - Yaygın tasarım pattern'leri (Repository, API Response Format)
  • performance.md - Performans optimizasyonu (model seçimi, context window yönetimi)
  • security.md - Güvenlik kuralları (secret yönetimi, güvenlik kontrolleri)
  • testing.md - Test gereksinimleri (TDD, minimum %80 coverage)

TypeScript/JavaScript

TypeScript ve JavaScript projeleri için özel kurallar:

  • coding-style.md - Tip sistemleri, immutability, hata yönetimi, input validasyonu
  • hooks.md - Prettier, TypeScript check, console.log uyarıları
  • patterns.md - API response format, custom hooks, repository pattern
  • security.md - Secret yönetimi, environment variable'lar
  • testing.md - Playwright E2E testing

Python

Python projeleri için özel kurallar:

  • coding-style.md - PEP 8, type annotation'lar, immutability, formatlama araçları
  • hooks.md - black/ruff formatlama, mypy/pyright tip kontrolü
  • patterns.md - Protocol (duck typing), dataclass'lar, context manager'lar
  • security.md - Secret yönetimi, bandit güvenlik taraması
  • testing.md - pytest framework, coverage, test organizasyonu

Golang

Go projeleri için özel kurallar:

  • coding-style.md - gofmt/goimports, tasarım ilkeleri, hata yönetimi
  • hooks.md - gofmt/goimports formatlama, go vet, staticcheck
  • patterns.md - Functional options, küçük interface'ler, dependency injection
  • security.md - Secret yönetimi, gosec güvenlik taraması, context & timeout'lar
  • testing.md - Table-driven testler, race detection, coverage

Kullanım

Bu kurallar Claude Code tarafından otomatik olarak yüklenir ve uygulanır. Kurallar:

  1. Dile bağımsız - common/ dizinindeki kurallar tüm projeler için geçerlidir
  2. Dile özgü - İlgili dil dizinindeki kurallar (typescript/, python/, golang/) common kuralları genişletir
  3. Path tabanlı - Kurallar YAML frontmatter'daki path pattern'leri ile eşleşen dosyalara uygulanır

Orijinal Dokümantasyon

Bu dokümantasyonun İngilizce orijinali rules/ dizininde bulunmaktadır.