ACM Transactions on Software Engineering and Methodology· 2026Q1
Agent README'leri: Ajan Kodlaması için Bağlam Dosyalarının Ampirik Bir Çalışması
Agent READMEs: An Empirical Study of Context Files for Agentic Coding
- 2atıf
- Q1SCImago
- 2026yıl
Kısa özet
Ajan bağlam dosyaları (örn. AGENTS.md) statik belgeler değil, karmaşık ve gelişen artefaktlardır; geliştiriciler güvenlik (%14,8) gibi işlevsel olmayan gereksinimler yerine işlevsel bağlama (örn. test prosedürleri %75,9) öncelik verir.
Yapay zekâ ile başlık ve abstract'tan üretildi; tam metin okunmaz.
Ana noktalar
- Ajan bağlam dosyaları, statik belgelerden ziyade aktif olarak sürdürülen, gelişen artefaktlardır.
- Geliştiriciler, yapılandırma koduna benzer şekilde bu dosyalara sık sık küçük eklemeler yapmaktadır.
- Test prosedürleri (%75,9), uygulama detayları (%70,8) ve mimari (%68,1) gibi işlevsel bağlam önceliklendirilmektedir.
- Güvenlik (%14,8) ve performans (%14,5) gibi işlevsel olmayan gereksinimler önemli ölçüde yetersiz temsil edilmektedir.
Yapay zekâ ile başlık ve abstract'tan üretildi; tam metin okunmaz.
Özet (abstract)
Agentic coding tools receive goals written in natural language, break them down into specific tasks, and write or execute code with minimal human intervention. Central to this process are agent context files (e.g., AGENTS.md and CLAUDE.md) that provide persistent, project-level instructions. In this paper, we conduct the first large-scale empirical study of 2,303 agent context files from 1,925 repositories to characterize their structure, maintenance, and content. We find that these files are not static documentation but complex, difficult-to-read artifacts that evolve like configuration code through frequent, small additions. Our content analysis of 16 instruction types shows that developers prioritize functional context, such as test procedures (75.9%), implementation details (70.8%), and architecture (68.1%). We also identify a significant gap: non-functional requirements such as security (14.8%) and performance (14.5%) are rarely specified. These findings indicate that while developers use context files to make agents functional, they provide few guardrails to ensure that agent-written code is secure or performant, highlighting the need for improved tools and practices.
Yazarların özeti; kaynağından alınmıştır. ACM Transactions on Software Engineering and Methodology, 2026 · DOI ↗
Ücretsiz hesapla devam et
Makaleye Sor ile bu makaleye günde 3 soru ücretsiz; makaleyi kaydet, kaynakçasını al, ilgi alanına göre her gün yeni özetler. Çıkarımlar Premium.
Web'de ücretsiz devam etGoogle ya da Apple hesabınla giriş; kart istemez. Bu makaleye geri dönersin.
Telefonda:
Alan: Yapay Zeka
Artificial IntelligenceComputer Science