Ajan 40 dosyayı değiştirdi, şimdi ne olacak? Whiteboard ile kod incelemesi

Sorun

Kodlama ajanına bir görev verdin, o da 40 dosyayı değiştirip “bitti” dedi. Şimdi elinde ham bir diff var. Neyin neden değiştiğini, ajanın hangi kararları kendi başına aldığını bu diff’ten çıkarmak zor. Whiteboard’un README’sindeki gerekçe de bu: Kodu üretmek hızlandı, anlamak yavaş kaldı.

Whiteboard ne yapıyor?

Whiteboard, MIT lisanslı, macOS, Windows ve Linux’ta çalışan bir masaüstü uygulaması. Claude Code, Codex gibi ajanlara bağlanıyor. Ajana bir SDK veriyor, ajan da yaptığı işi bu uygulamadaki bir tuvale çiziyor. Better Stack videosu bunu Claude Code ile deniyor.

Öne çıkan parçalar:

• Diyagramlar koda bağlı. Sıra diyagramı (sequence diagram) ya da varlık-ilişki şeması gibi görsellere tıklayınca ilgili koda gidiyorsun.
• Anlamsal diff. Rust ile yazılmış, sözdizimi ağacını (AST) bilen bir diff görüntüleyici var. Büyük yeni fonksiyonlar sözde kod olarak özetleniyor, testler ve dokümantasyon değişiklikleri katlanıyor. Bunu WASM tabanlı eklentilerle özelleştirebiliyorsun.
• Karar günlüğü. Senin koyduğun gereksinimleri, bunların nasıl uygulandığını ve ajanın kendi başına verdiği kararları bir arada gösteriyor. Ajanla yaptığın konuşmadan bir alıntıya tıklayıp o konuşmaya dönebiliyorsun.
• Yerelde çalışıyor. Kendi bilgisayarındaki depolarla çalışıyor. Yapımcılar anonim telemetri olduğunu, kodunu, diff’lerini ya da prompt’larını içermediğini ve kapatılabildiğini söylüyor.

Videoda ayrıca Mermaid, CodeRabbit ve Graphite gibi araçlarla karşılaştırma yapıldığı belirtiliyor. Bu karşılaştırma videonun görüşü, biz bağımsız olarak doğrulamadık.

Sınırlar

README’de açıkça yazıyor:

• Whiteboard içinde dosya düzenleyemiyorsun, sadece inceliyorsun.
• Tek incelemede birden fazla depoyla çalışmak iyi desteklenmiyor.
• Paylaştığın bir incelemede sonradan yapılan güncellemeler diğerlerine yansımıyor, yeniden paylaşman gerekiyor.
• Takımlar için barındırılan bir sürüm “yakında” olarak duyuruluyor, henüz yok.

Senin için anlamı

• Bu tür bir aracı denemesen bile fikir işe yarar: Ajandan sadece kod değil, “ne yaptın, neden, hangi kararı sen verdin?” özeti de iste.
• Ajanın kendi anlatımı gerçeğin tamamı olmayabilir. Diyagramlar koda bağlı olduğu için, iddiayı kodda kontrol etmek kolaylaşıyor, ki asıl değer de burada.
• Bir ajanın yaptığı işi dosya dosya incelemek yerine sonucu doğrulama alışkanlığı, güvenle ajan kullanmanın parçası.

Değişiklikten önce kod tabanının haritasını çıkaran bir araç için Understand-Anything yazımıza bakabilirsin.

Düşün

• Ajanın değiştirdiği kodu bugün nasıl inceliyorsun: satır satır mı, sadece testlere bakarak mı?
• Ajanın “bu kararı ben verdim” diye işaretlediği yerler senin için en değerli kısım olur muydu?

Kendi cümlelerimizle yazılmış bir özettir, çeviri değildir. Tüm kaynaklar yukarıda.