Berat Aras

Software Engineer

Blog

Testler geçiyor ama ben yine de bu kodu istemiyorum

2 dk okuma

Bir agent birkaç dakika içinde yüzlerce satır kod yazıyor. Testler geçiyor, TypeScript hata vermiyor, build başarıyla tamamlanıyor.

Sonra diff’i açıyorum. Basit bir özellik için yeni bir service oluşturulmuş. Service’in arkasına bir repository eklenmiş. Tek yerde kullanılacak bir işlem generic helper’a taşınmış. Üç dosyada çözülebilecek iş yedi dosyaya dağılmış. Kod muhtemelen çalışıyor. Ama ben hâlâ merge butonuna basmak istemiyorum.

AI ile kod yazarken yaşadığım temel problem kodun doğruluğu değil. Çoğu zaman agent’ın ürettiği kod gerçekten çalışıyor. Sorun çalışan kodun gereğinden fazla karmaşık olması ve bu karmaşıklık ucuz code review skill’leriyle çözülmüyor.

Testler bir fonksiyonun doğru sonucu üretip üretmediğini söyleyebilir. Fakat aynı fonksiyonun neden dört farklı abstraction ile oluşturulduğunu söylemez. Lint kuralları hatalı syntax’ı yakalayabilir ama basit bir işin gereksiz yere küçük bir framework’e dönüştürülmesini engelleyemez.

Kod kalitesinin önemli bir bölümü ölçülebilir değildir. Okunabilirlik, sadelik ve bir sonraki değişikliğin ne kadar kolay yapılabileceği hâlâ insan yargısına ihtiyaç duyar.

Agent’ların gereksiz abstraction üretmesi tesadüf değil. Onlardan “iyi tasarlanmış” veya “scalable” bir çözüm istediğimizde, bu kelimeleri çoğu zaman daha fazla katman, daha fazla interface ve daha fazla esneklik olarak yorumluyorlar.

Çünkü abstraction üretmek kolaydır. Zor olan, abstraction’a henüz ihtiyaç olmadığını fark etmektir.

Deneyimli bir mühendis bazen üç satır kod yazar ve orada bırakır. Aynı ihtiyaç ikinci kez ortaya çıktığında ortak yapıyı görür. Üçüncü kez ortaya çıktığında abstraction oluşturur.

Agent ise daha ilk kullanımda gelecekte yaşanabilecek bütün ihtimalleri çözmeye çalışabilir. Teknik olarak etkileyici görünen ama zihinsel olarak pahalı bir sistem ortaya çıkar. Bu yüzden “agent’ın yazdığı kodu okumaya gerek yok” fikri bana tam olarak doğru gelmiyor.

Dillere destan Opus ile servis oluştururken beni şaşırtan basit bir abstraction:

const getUserId = (req: Request) => {
  return req.params.id;
};
const id = getUserId(req);

Halbuki tek gereken:

const id = req.params.id;

Her satırı aynı dikkatle okumak verimsiz olabilir. Bunu kabul ediyorum. Bir agent bizden çok daha hızlı kod üretebilir ve insan okuma hızı bir noktadan sonra gerçek bir darboğaza dönüşebilir. Fakat çözüm, anlamadığımız kodu production’a göndermek olmamalı.

Çünkü production’da bir hata çıktığında sorumluluk agent’a ait olmayacak. Altı ay sonra bu kodu değiştirmesi gereken kişi de büyük ihtimalle yine biz veya ekipten başka bir insan olacak.

Benim için doğru sınır:

Kodun her ayrıntısını ezbere bilmek zorunda değilim. Ama sistemin nasıl çalıştığını, verinin nereden gelip nereye gittiğini ve kullanılan yapıların neden var olduğunu anlayabilmeliyim.

Bir abstraction’ın neden gerekli olduğunu açıklayamıyorsam, muhtemelen gerekli değildir. Bir değişikliği anlamak için agent’a tekrar tekrar soru sormam gerekiyorsa, kod yeterince açık değildir. Bir özelliğin çalışma akışını kafamda kuramıyorsam, testlerin yeşil olması beni rahatlatmaz.

AI agent’lar kod yazma maliyetini büyük ölçüde düşürdü. Fakat kodu anlamanın, değiştirmenin ve sahiplenmenin maliyetini ortadan kaldırmadı.