Otonom kod incelemesi için çok ajanlı sürü: Planner, Implementer, Tester, Critic

Geliştirici blogu TormentNexus, kodu otonom olarak inceleyen çok ajanlı bir sürüyü anlatan pratik bir rehber yayımladı. Makale 26 Eylül'de Dev.to'da yeniden yayımlandı. Yazara göre tek bir yapay zekâ asistanı, olgun bir mühendislik ekibinin denetim ve denge mekanizmalarından yoksun: öneriler doğrulanmıyor, düzeltmeler yan etkilere karşı test edilmiyor ve tasarım sonuçları nadiren tartışılıyor.

Tek Asistan Neden Yetmiyor

Tek bir ajan, sözdizimsel olarak doğru ama mimari açıdan zayıf kod döndürebilir. Önerilen alternatif, güçlü bir ekibi modellemek: uzmanlaşmış ajanlar tek bir düzenlenmiş konuşma içinde etkileşir ve yalnızca bir yanıt değil, doğrulanmış ve iyileştirilmiş bir çözüm üretir.

Sürüdeki Dört Rol

Her ajan, kendi sistem istemine sahip ayrı bir LLM çağrısıdır. Planner teknik lider gibi çalışır: gelen kodu analiz eder ve güvenlik, performans ve okunabilirlik etrafında bir inceleme gündemi belirler. Implementer somut düzeltmeyi veya yeniden düzenlemeyi yazar. Tester, birim ve entegrasyon testleriyle ve güvenlik taramalarıyla değişiklikleri doğrular. Critic varsayımlara meydan okur, mimariyi sorgular ve sürdürülebilirliği denetler.

Örnek: Yapılandırma Yükleyicisini Sağlamlaştırmak

Örnekte, bir YAML dosyasını okuyup veritabanı bölümünü döndüren kısa bir Python fonksiyonu izleniyor. Planner gündemi belirler: path traversal ve veri güveni gibi güvenlik risklerini analiz et, eksik anahtarlar ve geçersiz YAML için hata yönetimini iyileştir, ardından tasarımı değerlendir. Implementer net ValueError mesajları üreten try/except blokları ekler; Tester ise yeni hata yollarını kapsayan bir pytest paketi yazar.

Critic kabul ettiğinden çok itiraz eder. Yalnızca config['database'] döndürmeyi, tüm yapılandırma bağlamını gizleyen bir anti-desen olarak niteler ve bir TOCTOU riskine dikkat çeker: dosya yolu kontrol ile kullanım arasında değiştirilebilir. Önerisi, tüm config'in döndürülmesi ve dosya açılmadan önce sembolik bağlantıların os.path.realpath ile çözülmesidir.

Uzlaşma ve Orkestrasyon

Implementer ile Critic anlaşmazlığa düştüğünde hakem Planner'dır. Örnekte Implementer'a tam config'i döndürmesini, Tester'a ise testleri güncelleyip sembolik bağlantı çözümü için bir güvenlik testi eklemesini söyler. Tüm döngü durum tutan bir sohbet odasında işler: tüm ajanların okuyup eklediği ortak bir mesaj listesi ve Planner'ın direktiflerine göre sırayı yöneten merkezi bir orkestratör.

Yazar kazanımları sıralıyor: daha derin kod analizi, daha az insan gözetimi, sohbet günlüğünde otomatik belgelenen tasarım kararları ve statik analizi sürece bağlamanın kolay yolu. Model genişletilebilir: konteyner önerileri için bir DevOps ajanı ya da satır içi dokümantasyon yazan bir Doc ajanı eklenebilir.