| typescript-reviewer | TypeScript/JavaScript kod incelemesi | TypeScript/JavaScript projeleri |
## Agent Orkestrasyonu
Agentları kullanıcı istemi olmadan proaktif olarak kullanın:
- Karmaşık özellik istekleri → **planner**
- Yeni yazılan/değiştirilen kod → **code-reviewer**
- Hata düzeltme veya yeni özellik → **tdd-guide**
- Mimari karar → **architect**
- Güvenlik açısından hassas kod → **security-reviewer**
- Çok kanallı iletişim önceliklendirme → **chief-of-staff**
- Otonom döngüler / döngü izleme → **loop-operator**
- Harness yapılandırma güvenilirliği ve maliyeti → **harness-optimizer**
Bağımsız işlemler için paralel yürütme kullanın — birden fazla agenti aynı anda başlatın.
## Güvenlik Kuralları
**HERHANGİ BİR committen önce:**
- Sabit kodlanmış sırlar yok (API anahtarları, şifreler, tokenlar)
- Tüm kullanıcı girdileri doğrulanmış
- SQL injection koruması (parametreli sorgular)
- XSS koruması (sanitize edilmiş HTML)
- CSRF koruması etkin
- Kimlik doğrulama/yetkilendirme doğrulanmış
- Tüm endpointlerde hız sınırlama
- Hata mesajları hassas veri sızdırmıyor
**Sır yönetimi:** Sırları asla sabit kodlamayın. Ortam değişkenlerini veya bir sır yöneticisini kullanın. Başlangıçta gerekli sırları doğrulayın. İfşa edilen sırları hemen döndürün.
**Güvenlik sorunu bulunursa:** DUR → security-reviewer agentini kullan → KRİTİK sorunları düzelt → ifşa edilen sırları döndür → kod tabanını benzer sorunlar için incele.
## Kodlama Stili
**Değişmezlik (KRİTİK):** Her zaman yeni nesneler oluşturun, asla değiştirmeyin. Değişiklikler uygulanmış yeni kopyalar döndürün.
**Dosya organizasyonu:** Az sayıda büyük dosya yerine çok sayıda küçük dosya. Tipik 200-400 satır, maksimum 800. Tipe göre değil, özelliğe/alana göre düzenleyin. Yüksek bağlılık, düşük bağımlılık.
**Hata yönetimi:** Her seviyede hataları ele alın. UI kodunda kullanıcı dostu mesajlar sağlayın. Sunucu tarafında detaylı bağlamı loglayın. Hataları asla sessizce yutmayın.
**Girdi doğrulama:** Sistem sınırlarında tüm kullanıcı girdilerini doğrulayın. Şema tabanlı doğrulama kullanın. Net mesajlarla hızlı başarısız olun. Harici verilere asla güvenmeyin.
**Kod kalite kontrol listesi:**
- 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, sabit kodlanmış değerler yok
- Okunabilir, iyi adlandırılmış tanımlayıcılar
## Test Gereksinimleri
**Minimum kapsama: %80**
Test tipleri (hepsi gereklidir):
1.**Unit testler** — Bireysel fonksiyonlar, yardımcı programlar, bileşenler
2.**Integration testler** — API endpointleri, veritabanı işlemleri
3.**E2E testler** — Kritik kullanıcı akışları
**TDD iş akışı (zorunlu):**
1. Önce test yaz (KIRMIZI) — test BAŞARISIZ olmalı
2. Minimal uygulama yaz (YEŞİL) — test BAŞARILI olmalı
3. Yeniden düzenle (İYİLEŞTİR) — %80+ kapsama doğrula
Başarısızlık sorunlarını giderin: test izolasyonunu kontrol edin → mocklarını doğrulayın → uygulamayı düzeltin (testleri değil, testler yanlış olmadıkça).
**PR iş akışı:** Tam commit geçmişini analiz edin → kapsamlı özet taslağı oluşturun → test planı ekleyin → `-u` bayrağıyla pushlayın.
## Mimari Desenler
**API yanıt formatı:** Başarı göstergesi, veri yükü, hata mesajı ve sayfalandırma metadatası içeren tutarlı zarf.
**Repository deseni:** Veri erişimini standart arayüz arkasında kapsülleyin (findAll, findById, create, update, delete). İş mantığı depolama mekanizmasına değil, soyut arayüze bağlıdır.
**Skeleton projeleri:** Savaş testinden geçmiş şablonları arayın, paralel agentlarla değerlendirin (güvenlik, genişletilebilirlik, uygunluk), en iyi eşleşmeyi klonlayın, kanıtlanmış yapı içinde yineleyin.
## Performans
**Bağlam yönetimi:** Büyük yeniden düzenlemeler ve çok dosyalı özellikler için bağlam penceresinin son %20'sinden kaçının. Daha düşük hassasiyet gerektiren görevler (tekli düzenlemeler, dokümanlar, basit düzeltmeler) daha yüksek kullanımı tolere eder.
**Build sorun giderme:** build-error-resolver agentini kullanın → hataları analiz edin → artımlı olarak düzeltin → her düzeltmeden sonra doğrulayın.
