mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 21:53:28 +08:00
fd2a8edb53
* 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>
81 lines
3.2 KiB
Markdown
81 lines
3.2 KiB
Markdown
# Refactor Clean
|
||
|
||
Her adımda test doğrulaması ile ölü kodu güvenle tanımla ve kaldır.
|
||
|
||
## Adım 1: Ölü Kodu Tespit Et
|
||
|
||
Proje türüne göre analiz araçlarını çalıştır:
|
||
|
||
| Araç | Ne Bulur | Komut |
|
||
|------|--------------|---------|
|
||
| knip | Kullanılmayan export'lar, dosyalar, bağımlılıklar | `npx knip` |
|
||
| depcheck | Kullanılmayan npm bağımlılıkları | `npx depcheck` |
|
||
| ts-prune | Kullanılmayan TypeScript export'ları | `npx ts-prune` |
|
||
| vulture | Kullanılmayan Python kodu | `vulture src/` |
|
||
| deadcode | Kullanılmayan Go kodu | `deadcode ./...` |
|
||
| cargo-udeps | Kullanılmayan Rust bağımlılıkları | `cargo +nightly udeps` |
|
||
|
||
Hiçbir araç yoksa, sıfır import'lu export'ları bulmak için Grep kullanın:
|
||
```
|
||
# Export'ları bul, sonra herhangi bir yerde import edilip edilmediklerini kontrol et
|
||
```
|
||
|
||
## Adım 2: Bulguları Kategorize Et
|
||
|
||
Bulguları güvenlik katmanlarına göre sırala:
|
||
|
||
| Katman | Örnekler | Aksiyon |
|
||
|------|----------|--------|
|
||
| **GÜVENLİ** | Kullanılmayan yardımcılar, test yardımcıları, dahili fonksiyonlar | Güvenle sil |
|
||
| **DİKKAT** | Component'ler, API route'ları, middleware | Dinamik import'ları veya harici tüketicileri olmadığını doğrula |
|
||
| **TEHLİKE** | Config dosyaları, giriş noktaları, tip tanımları | Dokunmadan önce araştır |
|
||
|
||
## Adım 3: Güvenli Silme Döngüsü
|
||
|
||
Her GÜVENLİ öğe için:
|
||
|
||
1. **Tam test paketini çalıştır** — Baseline oluştur (tümü yeşil)
|
||
2. **Ölü kodu sil** — Cerrahi kaldırma için Edit aracını kullan
|
||
3. **Test paketini yeniden çalıştır** — Hiçbir şeyin bozulmadığını doğrula
|
||
4. **Testler başarısız olursa** — Hemen `git checkout -- <file>` ile geri al ve bu öğeyi atla
|
||
5. **Testler geçerse** — Sonraki öğeye geç
|
||
|
||
## Adım 4: DİKKAT Öğelerini İdare Et
|
||
|
||
DİKKAT öğelerini silmeden önce:
|
||
- Dinamik import'ları ara: `import()`, `require()`, `__import__`
|
||
- String referansları ara: route isimleri, config'lerdeki component isimleri
|
||
- Public paket API'sinden export edilip edilmediğini kontrol et
|
||
- Harici tüketici olmadığını doğrula (yayınlanmışsa bağımlıları kontrol et)
|
||
|
||
## Adım 5: Duplikatları Birleştir
|
||
|
||
Ölü kodu kaldırdıktan sonra şunları ara:
|
||
- Neredeyse aynı fonksiyonlar (%80'den fazla benzer) — birinde birleştir
|
||
- Gereksiz tip tanımları — birleştir
|
||
- Değer eklemeyen wrapper fonksiyonlar — inline yap
|
||
- Amacı olmayan re-export'lar — yönlendirmeyi kaldır
|
||
|
||
## Adım 6: Özet
|
||
|
||
Sonuçları raporla:
|
||
|
||
```
|
||
Ölü Kod Temizliği
|
||
──────────────────────────────
|
||
Silindi: 12 kullanılmayan fonksiyon
|
||
3 kullanılmayan dosya
|
||
5 kullanılmayan bağımlılık
|
||
Atlandı: 2 öğe (testler başarısız)
|
||
Kazanç: ~450 satır kaldırıldı
|
||
──────────────────────────────
|
||
Tüm testler geçiyor ✅
|
||
```
|
||
|
||
## Kurallar
|
||
|
||
- **Önce testleri çalıştırmadan asla silmeyin**
|
||
- **Bir seferde bir silme** — Atomik değişiklikler geri almayı kolaylaştırır
|
||
- **Emin değilseniz atlayın** — Üretimi bozmaktansa ölü kodu tutmak daha iyidir
|
||
- **Temizlerken refactor etmeyin** — Endişeleri ayırın (önce temizle, sonra refactor et)
|