Git değişikliklerini 6 frontend inceleyicisinin aynı anda gördüğü Claude Code eklentisi

git diff veya tek bir dosyayı 6 farklı bakış açısından (React performansı / kod kalitesi / bug'lar / TypeScript / erişilebilirlik / güvenlik) eşzamanlı olarak inceleyen ve synthesizer ajanının sonuçları tek bir önceliklendirilmiş raporda birleştirdiği bir Claude Code eklentisi.

Yapılma nedeni

PR incelemesini bir LLM'e yaptırırken aynı bağlam içine her şeyi koyup “genel olarak incele” dediğinizde iki sorun ortaya çıkıyor.

• Akıl yürütme kirlenmesi: perf bakış açısının tonu, a11y bakış açısının tonunu etkiler.
• Mode collapse: diff içindeki en belirgin tek eksene doğru yanıt kayar.

Her kılavuz aslında “farklı bir soruya” yanıt verir. Perf için soru “hızlı mı”, a11y için “herkese ulaşabiliyor mu”, security için “veri sızıyor mu”, quality için “değiştirmesi kolay mı”dır. Bu yüzden her şeyi tek bir kişiye yaptırmak yerine, aynı değişiklik izole edilmiş alt ajan bağlamlarında inceleniyor; ardından yalnızca sonuçlar toplanıp birleştiriliyor.

6 varsayılan inceleyici (sektörde doğrulanmış kılavuzlar olduğu gibi)

• react-perf — Vercel React Best Practices
• quality — Toss Frontend Fundamentals (okunabilirlik/tahmin edilebilirlik/bağlılık/bağımlılık)
• bugs — React rules-of-hooks + ESLint/TS-ESLint doğruluk kuralları
• ts — Google TypeScript Style Guide + Effective TypeScript
• a11y — WCAG 2.2 + ARIA APG
• security — frontend güvenlik kalıpları (XSS, secret sızıntısı, güvensiz depolama vb.)

İnceleyiciler doğrudan eklenip değiştirilebilir (i18n, motion, design tokens vb.).

Kullanım

Claude Code içinde iki satırla kurulum:

/plugin marketplace add huurray/fe-review-agents
/plugin install fe-review-agents@fe-review-agents

İnceleme çalıştırma:

/fe-review-agents:diff-review # staged değişiklikler
/fe-review-agents:diff-review branch:main # main'e göre diff
/fe-review-agents:file-review src/App.tsx # tek dosyada derin inceleme

Seçenekler:

• lang=ko|en (varsayılan ko)
• severity_min=LOW|MED|HIGH|CRITICAL (bunun altındaki önem dereceleri rapora dahil edilmez)

Trade-off'lar

Token maliyeti, tek bir bağlama kıyasla yaklaşık 6 kat daha fazladır. Buna karşılık akıl yürütme kirlenmesi ve mode collapse olmadan çoklu bakış açısı kapsamı elde edilir. Maliyeti kısmaya çalışan ekiplerden çok, paradan önce kararlılığı önceliklendiren ekipler için uygun bir araçtır.

İlham

Toss'un şirket içinde kullandığı bilinen Compounding Engineering kalıbından (birden fazla LLM'in PR'ı paralel incelemesi) ilham alındı.

Geri bildirimler/issues/PR'lar memnuniyetle karşılanır. 🙏