mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-11 02:33:10 +08:00
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
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:
- Dile bağımsız -
common/dizinindeki kurallar tüm projeler için geçerlidir - Dile özgü - İlgili dil dizinindeki kurallar (typescript/, python/, golang/) common kuralları genişletir
- 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.