AGENTS.md'yi öneriden icra edilebilir kurala çevirmek

AGENTS.md, kod ajanlarının bir projenin derleme komutlarını, stil kurallarını ve sınırlarını öğrendiği yaygın bir kongre haline geldi; 60 binden fazla açık kaynak proje bu dosyayı kullanıyor. Ancak formatın kendi FAQ'ı bile bunun sadece markdown olduğunu ve ajanın metni ayrıştırdığını söylüyor: hiçbir mekanizma iddiaların doğru olup olmadığını kontrol etmiyor, ajan kuralı yok saydığında da hiçbir şey başarısız olmuyor. Sonuç, yalan söyleyen bir belgenin doğru söyleyenle tamamen aynı göründüğü bir durum.

getff projesi, AGENTS.md'yi "icra edilebilir" kılmak için üç mekanik özellik öneriyor: her denetlenebilir iddianın hangi araç zincirinde hangi kapı tarafından uygulandığını ve durumunu (canlı doğrulanmış ✅ ya da açık bir hata koduyla "burada ifade edilemez") gösteren bir satır taşıması; iddiaların sadece belirtilmek değil, gerçek testlerle canlı olarak ateşlenmesi (negatif örneğin kuralı tetiklemesi, pozitif örneğin sessiz kalması); ve belge gövdesinin kaynaktan otomatik üretilip byte düzeyinde kilitlenmesi, öyle ki her push'ta en ufak bir sapma kapıyı kırıyor.

Bu yaklaşım getff'in kendi kök AGENTS.md dosyasında somut örneklerle gösteriliyor: process.env'e doğrudan erişimi yasaklayan bir kural, gerçek ESLint kuralına karşı çalışan bir testle doğrulanıyor; kural tablosu ise bir üretim betiğiyle disk üzerindeki kurallarla senkron tutuluyor ve pre-push kancasına bağlanıyor. Kural silindiğinde veya değiştirildiğinde, make self-audit komutu hangi iddianın artık gerçeklikle uyuşmadığını isim vererek bildiriyor; bu da belgenin kontrolleri tarif etmesi yerine kontrollerin belgeyi üretmesi anlamına geliyor.

Dürüst bir uyarı da eşlik ediyor: bu disiplin şu an sadece getff'in kendi deposunda çalışıyor durumda; herhangi bir ekibin kendi kurallarından otomatik icra edilebilir bir AGENTS.md üretmesi henüz teslim edilmiş bir özellik değil, gelecekteki bir kilometre taşı.