Qoder Better Harness ne yapıyor? Kodlama ajanı iş akışlarını yalnızca çıktıya değil, kanıta göre değerlendiriyor

Kodlama ajanının ürettiği tek bir yanıt ya da kod farkı, iş akışının ne kadar güvenilir olduğunu tek başına göstermez. Qoder’ın açık kaynak Better Harness projesi tam bu noktaya odaklanıyor: Ajanın çalıştığı proje talimatlarını, denetimleri, doğrulama yollarını, yapılandırmasını ve desteklenen ortamlarda gerçek oturum kayıtlarını inceliyor. Amaç, iş akışındaki eksikleri saptamak, sınırlı kapsamlı bir düzeltme önermek ve sonraki çalıştırmada bu düzeltmenin kontrol edilebilmesini sağlamak. 124

Dönemin haberlerine göre Qoder, Better Harness’ı 28 Temmuz 2026’da GitHub’da açık kaynak olarak yayımladı. 5

Odak noktası model değil, ajanın çalıştığı düzen

Bir kodlama ajanı tek başına çalışmaz. Depo yönergeleri, teknik gereksinimler, araçlar, yetkiler, betikler, testler, inceleme kuralları, yayın kontrolleri ve insan devralma adımlarıyla çevrilidir. Qoder bu çalışma çevresini harness olarak adlandırıyor. Dokümantasyona göre bu çevre; depo talimatları, kurallar, beceriler, kancalar (hooks), eklentiler, bağlayıcılar, betikler, test komutları, yayın kontrolleri ve insan inceleme adımlarını kapsayabilir. 2

Bu ayrım önemli: Güçlü bir model, belirsiz veya yeterince gözlemlenemeyen bir süreçte yine de güvenilmez sonuçlar verebilir. Örneğin projede bir test komutu bulunabilir, ancak ajanın bunu ne zaman çalıştıracağı net olmayabilir. Bir kural dosyası vardır ama ajan tarafından hiç kullanılmıyordur. Ya da başarısız görevlerden edinilen dersleri kalıcı proje bilgisine dönüştürecek bir mekanizma yoktur. Better Harness, yalnızca yapılandırma dosyasının varlığına bakmak yerine bu operasyonel kopuklukları görünür kılmayı amaçlıyor. 145

Üç katmanlı çerçeve nasıl işliyor?

Better Harness, mühendislik uygulamalarını, bir değerlendirme modelini ve çalıştırılabilir uygulamayı birbirine bağlayan üç katmanlı bir çerçeve olarak sunuluyor. 5

1. Harness Engineering uygulamaları

İlk katman, ajanın çalışma biçimini belirleyen pratik mekanizmaları kapsıyor: oturum ve komut satırı (CLI) kalıpları, gözlemlenebilirlik, kurallar, beceriler, MCP yapılandırması, bellek, kancalar ve otomasyon. 5

Bu katman esasen şu sorulara yanıt arıyor:

• Ajan; hedefleri, kısıtları ve depo bağlamını açık biçimde alıyor mu?
• Çalıştırma yolları ve yetkileri yeterli ölçüde denetleniyor mu?
• Testler, kontroller ve incelemeler ajanın yaptığı işle bağlantılı mı?
• Yararlı dersler, oturumla kaybolmak yerine sürdürülebilir proje varlıklarına dönüşebiliyor mu?

Better Harness ilk olarak mevcut düzeni haritalıyor: hedefler, bağlam, çalıştırma giriş noktaları, geri bildirim döngüleri, teslim mekanizmaları ve öğrenilenlerin kaydı. 1

2. Agent Work Loop değerlendirmesi

İkinci katman, bu uygulamaları birbirine bağlı beş teslim boyutunda değerlendiriyor. Qoder’ın materyallerinde bunlar; görevi anlama, kontrollü yürütme, değişikliği doğrulama, güvenilir teslim ve öğrenilenleri kaydetme olarak tanımlanıyor. 14

Böylece soru, “Ajan makul görünen kod üretti mi?” olmaktan çıkıyor. Yerine daha işlevsel bir test geliyor: Uçtan uca iş akışı; anlaşılabilir, kontrollü, doğrulanmış, teslim edilebilir ve önceki çalışmalardan beslenen değişiklikleri tekrar tekrar üretebiliyor mu?

Model; eksik bir mekanizma, bağlantısı kurulmamış bir entegrasyon, hiç yürütülmemiş bir adım veya sonuca ilişkin yetersiz kanıt gibi döngüdeki kırılma noktalarını belirlemeyi hedefliyor. 1

3. Çalıştırılabilir uygulama

Üçüncü katman, uygulamaları ve değerlendirme modelini yalnızca rehber niteliğinde bırakmak yerine gerçek projelerde yürütülebilir hâle getiriyor. Better Harness bir kodlama ajanı üzerinden çalışıyor; desteklenen durumlarda proje ve oturum kanıtlarını topluyor, ardından doğrulanabilir ve önceliklendirilmiş sonraki adımlar üretiyor. 4

Qoder’ın güncel proje materyalleri 10 ana ortam bağdaştırıcısından söz ederken, lansman dönemindeki haberlerde desteklenen kodlama ajanı ortamları arasında Claude Code, Codex, Qoder ve Cursor özellikle anıldı. 56

Bağdaştırıcı kapsamı zaman içinde değişebilir; belirli bir ortamla entegrasyon iddiası için projenin güncel bağdaştırıcı dokümantasyonu kontrol edilmeli. Sağlanan kaynaklar, özellikle OpenClaw desteğini doğrulamıyor.

Kanıtlar üç ayrı bakış açısından toplanıyor

Yaklaşımın belirgin yönlerinden biri, kanıt toplama sürecini nihai değerlendirmeden ayırması. Qoder’a göre ana analiz akışı ham verileri topluyor, ardından sonuçlar birleştirilmeden önce bunları üç bağımsız ve salt-okunur alt ajana iletiyor. 1

Bu üç bakış açısı şöyle:

• Project Harness: Depodaki talimatlar, betikler, kontroller ve teslim denetimleri gibi mühendislik temelleri.
• Agent Customization: Ajana özgü kurallar, beceriler, kancalar ve diğer yapılandırmalar.
• Session Evidence: Kanıtın mevcut olduğu yerlerde, ajanın gerçek çalışma sırasında fiilen ne yaptığına ilişkin kayıtlar.

Bu yapı, hedeflenen süreç ile gözlemlenen süreci ayırmaya yardımcı oluyor. Proje ve yapılandırma kanıtları bir yeteneğin mevcut olduğunu gösterebilir; oturum kanıtı ise o yeteneğin gerçek bir görevde uygun biçimde kullanılıp kullanılmadığını anlamaya yardımcı olabilir. 14

“Var olması”, “işe yaraması” demek değil

Çerçevenin temel ilkesi şu: Bir aracın veya belgenin varlığı, etkin çalıştığının kanıtı değildir.

Örneğin bir depoda otomatik test paketi bulunması, potansiyel bir doğrulama kapasitesi olduğunu gösterir. Ancak bu tek başına ajanın değişiklikten sonra ilgili testleri çalıştırdığını, sonucu doğru yorumladığını veya çıktıyı hatalı teslimatı engellemek için kullandığını kanıtlamaz. Aynı durum kurallar, kancalar, beceriler ve onay kapıları için de geçerli. 15

Bu nedenle Better Harness kanıt zincirini açık tutmaya çalışıyor. Raporlar, desteklenen eksikleri; etki, beklenen çıktı, sınırlı kapsamlı onarım ve kabul kontrolleriyle önceliklendirilmiş bulgulara dönüştürüyor. Eksik kanıt ise sessizce kesin bir puana çevrilmek yerine görünür kalıyor. 46

Bu yaklaşım, genel bir tavsiyeden daha denetlenebilir bir bulgu ortaya koyuyor. Bir ekip şunları inceleyebilmeli:

1. Projede, yapılandırmada veya oturum kaydında ne gözlemlendiği,
2. Bunun teslim döngüsü için neden önemli olduğu,
3. Kural, beceri, kanca, betik, otomasyon veya insan onayı gibi hangi dar kapsamlı düzeltmenin önerildiği,
4. Düzeltmenin uygulama sonrasında nasıl doğrulanacağı.

İyileştirme döngüsü: İncele, düzelt, yeniden ölç

Better Harness bir kerelik denetim olarak konumlandırılmıyor. İşleyişi yinelemeli:

1. Mevcut çalışma düzenini haritalamak,
2. İş akışı kırılmalarını ve kanıt açıklarını belirlemek,
3. Desteklenen bir bulgu için sınırlı bir düzeltme görevi oluşturmak,
4. Düzeltmeyi tanımlı kabul kontrolleriyle doğrulamak,
5. Güncellenen kanıtları incelemek için değerlendirmeyi yeniden çalıştırmak. 14

Sürekli iyileştirme iddiasının dayanağı bu döngü. Araç, iş akışının değiştiğini ve yeni kanıtların daha güçlü bir değerlendirmeyi destekleyip desteklemediğini gösterebilir. Ancak tek başına, her düzeltmenin her projede veya her ana ortamda ajan performansını iyileştirdiğini kanıtlamaz. Qoder’ın materyalleri, puan değişimlerini nedensellik kanıtı saymak yerine gözlemlenen kanıtları ve açık sınırlılıkları öne çıkarıyor. 46

30 GitHub projesiyle yapılan ilk inceleme ne anlatıyor?

Lansman haberlerinde, çerçevenin ilk uygulamasında 30 gerçek GitHub projesinin incelendiği belirtildi. 5 Bu çalışma, Better Harness’ın farklı depolardaki tekrarlayan düzen eksiklerini ortaya çıkarabildiğini gösteren keşif niteliğinde bir uygulama olarak okunmalı; her kodlama ajanını veya her depoyu geliştirdiğini ispatlayan kontrollü bir çalışma olarak değil.

Mevcut birincil dokümantasyon, aracın kanıt modeli, bulgu yapısı ve yinelemeli onarım sürecini destekliyor. Buna karşılık sağlanan kaynaklarda 30 projelik örneklemin seçimi, puanlama protokolü veya toplam sonuçları bağımsız biçimde değerlendirmeye yetecek birincil ayrıntı yok. Better Harness’ı resmî kıyaslamalarla karşılaştırırken veya geniş performans iddialarında bulunurken bu sınır önemli. 14

Yapay zekâ destekli yazılım geliştirme için ölçülebilirlik arayışı

Qoder’ın daha geniş savı, Harness Engineering’in yapay zekâ destekli yazılım geliştirmede bir kalite altyapısına dönüşmesi gerektiği yönünde: İş akışı denetimleri için ortak bir dil, gözlemlenebilir kanıtlar, karşılaştırılabilir teslim boyutları ve tekrarlanabilir iyileştirme döngüleri. 12

Better Harness bu fikrin pratik bir karşılığını sunuyor. Ekiplerin desteklenen farklı ana ortamlarda ajan çalışmasının çevresindeki koşulları incelemesine, izlenimlerden çok kanıt üzerinden konuşmasına ve önerilen bir iş akışı düzeltmesinin sonraki çalıştırmalarda geçerliliğini sınamasına olanak tanıyor. Değeri, her düzeltmenin sonuçları mutlaka iyileştireceği vaadinde değil; ajan iş akışlarını incelenebilir, gözden geçirilebilir ve yanlışlanabilir hâle getiren daha disiplinli bir yöntem sunmasında. 46