mirror of
https://github.com/affaan-m/ECC.git
synced 2026-08-17 21:15:40 +02:00
fd1b11cfc7
Model-routing guidance across the rules, skills, and harness-steering docs still recommends Sonnet 4.6 / Opus 4.5-4.6 by name. Readers on the current generation have to map those onto Sonnet 5 / Opus 5 themselves, and the recommendation reads as pinned to a superseded generation. Renames the recommended models in guidance tables and updates two pinned model IDs in code samples: - rules/steering guidance: .cursor, .kiro, and the seven translated performance.md copies (ja-JP, zh-CN, zh-TW, ko-KR, pt-BR, es, tr) - skills/prompt-optimizer complexity-routing table (+ zh-CN copy) - skills/cost-aware-llm-pipeline MODEL_SONNET constant (+ zh-CN, ja-JP) - docs/examples project-guidelines template, which pinned the invalid ID claude-sonnet-4-5-20250514 (+ zh-TW, ja-JP copies) Deliberately left alone: - The "Pricing Reference (2025-2026)" table in cost-aware-llm-pipeline. Renaming those rows while keeping the existing per-token figures would assert Claude 5 pricing this change has not verified. - Executable model config (.opencode/opencode.json, agent.yaml). Those pins change real agent behavior and belong in their own reviewed change. - Historical and illustrative references: the-shortform-guide session transcripts, the ECC-PRO roadmap log entry, gan-style-harness's "Opus 4.5-class"/"Opus 4.6-class" capability tiers, and strategic-compact's deliberately generic "400k Opus 4.x" example. - docs/ATLAS-CLOUD-GUIDE.md, which lists a third-party provider's catalog. Documentation wording only; no behavioral change. Co-authored-by: Phumchai Tanonsi <274848436+phumchai1515-prog@users.noreply.github.com>
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.