AGENTS.md Dosyası Değil, Yazım Tarzınız Sorun: AI Agent’ların Gerçek Sınavı

Geçtiğimiz hafta, OpenAI topluluğunda bir gönderi dikkat çekti: “No AGENTS.md → baseline. Bad AGENTS.md → worse. Good AGENTS.md → better. The file isn’t the problem, your writing is.” Bu cümle, sadece bir teknik yorum değil, yapay zekâ dünyasında bir felsefi darbe. Bir dosya adı değil, o dosyanın içeriğini yazan insanoğlunun dili, AI agent’ların başarısını belirliyor. Bu, teknolojinin değil, iletişim kurallarının yeniden tanımlanması demek.

Reddit’de paylaşılan bu görsel, ArXiv’de yayınlanan 2402.11988 başlıklı çalışmaya dayanıyor. Çalışma, farklı versiyonlarda yazılmış AGENTS.md dosyalarının (yani AI agent’ların görev tanımlarını içeren metin dosyalarının) LLM’lere (büyük dil modellerine) nasıl etki ettiğini test ediyor. Sonuç şaşırtıcı: Dosya adı değişse de, içeriğin kalitesi değişmedikçe agent’ların performansı neredeyse aynı kalıyor. Ama dosya adı aynı kalıp, yazım tarzı iyileştirildiğinde — yani daha net, yapılandırılmış, bağlam zengin hale getirildiğinde — agent’ların görev başarı oranı %47 arttı.

Neden Bu Kadar Önemli?

AI agent’lar, artık sadece komutları yorumlayan robotlar değil. Kendi hedeflerini belirleyen, çevreden öğrenen, karmaşık görevleri adım adım çözen dijital ortaklar. Bu sistemlerin “zihni”, onlara verilen talimatlarla şekilleniyor. Ama bu talimatlar, sadece “bir dosya” değil, bir niyetin ifadesi. İşte burada insan yazıcının rolü, kod yazan mühendisten daha kritik hale geliyor.

Örneğin, bir AGENTS.md dosyasında yazılan “Task: research climate change” gibi bir ifade, bir AI agent’ı yüzlerce belge arasında kaybolmaya zorlar. Ama “Task: Identify three peer-reviewed studies from 2020–2024 that quantify the economic impact of coastal flooding in Southeast Asia, with emphasis on policy recommendations for Indonesia. Use only open-access journals.” gibi bir tanım, agent’ın hedefe odaklanmasını sağlıyor. İlginç olan, bu ikinci versiyonun kodla ilgili hiçbir değişikliği yok. Sadece yazım değişti.

Yazım, Yeni Bir Programlama Dili

2020’lerin başında, yazılım geliştiriciler “prompt engineering” terimini popülerleştirdi. Şimdi, “prompt writing” bile yeterli değil. “Agent writing” adı verilen yeni bir disiplin doğuyor. Bu, sadece kelimeleri seçmek değil, mantıksal yapıyı, bağlamı, sınırları ve beklentileri insansı bir dille kodlamak.

Reddit’deki yorumlarda bir kullanıcı şunu yazıyor: “Bir dil modeli, bir şair gibi yazamazsa, bir doktor gibi düşünemez. Bir hukukçu gibi yapılandırılamazsa, bir avukat gibi yargılanamaz.” Bu, AI agent’ların “yazım yeteneği”ne bağlı olarak farklı roller üstlenebileceğini gösteriyor. İyi yazılmış bir AGENTS.md, bir AI agent’ı bir araştırma asistanından, bir strateji danışmanına dönüştürebilir.

Yanlış Anlaşılan İnanç: Dosya Adı Hataları

Yeni başlayanlar, agent’ların başarısızlığını genellikle dosya isimlerinde, format hatalarında veya kod eksikliklerinde arar. Ama bu çalışma, bu inancın tamamen yanıltıcı olduğunu gösteriyor. Bir AGENTS.md dosyasının adı “bad_agents.md” olsa bile, içeriği iyiysa agent başarılı olur. Tersine, “perfect_agents.md” adlı bir dosya, içeriği belirsizse, agent’ı yanlış yola çıkarır. Bu, yazılım dünyasında bir dönüm noktası. Sistemler artık sadece “ne yazıldığını” değil, “nasıl yazıldığını” anlıyor.

Gelecek: Yazıcılar, AI Mühendislerinin Yeni Ortakları

Bu keşif, teknoloji endüstrisindeki iş rollerini kökten değiştirecek. AI mühendisleri artık sadece Python ve prompt’larla uğraşmayacak. Yazılım geliştiricilerin yanında, “AI yazıcılar” adı verilen yeni bir meslek grubu doğacak: dil bilgisi, mantık, psikoloji ve teknik bilgiyi birleştirenler. Bu kişiler, agent’ların nasıl düşündüğünü, nasıl karar verdiği ve hangi bağlamda ne beklediğini anlayacak.

Örneğin, bir sağlık AI agent’ı için yazılmış bir AGENTS.md, sadece “hasta verilerini analiz et” demekle yetinmez. “Hastanın tıbbi geçmişi, alerjileri ve sosyoekonomik durumu göz önünde bulundurarak, en düşük yan etki riskine sahip üç ilacı sırala. Her ilacın alternatifleriyle karşılaştır, hasta için en uygun olanı neden önerdiğinizi açıkla.” Bu, bir doktorun muayene notunu yazarken kullandığı dil. Ve şimdi, bu dil, AI agent’ların yaşamını şekillendiriyor.

Gelecekte, bir AI agent’ın başarısı, kodunuzun ne kadar iyi olduğuna değil, ne kadar insani olduğuna bağlı olacak. Yani teknoloji, en sonunda insan dilinin en derin yapısını anlamaya başlıyor. Ve bu, sadece bir yazılım güncellemesi değil — bir uygarlık değişikliği.

Sonuç: Dosya Değil, Düşünce

AGENTS.md dosyası sadece bir dosya değil. Bir düşünce, bir niyet, bir iletişim aracı. Bu çalışmanın en büyük mesajı şudur: AI agent’lar, ne kadar güçlü olursa olsun, sadece iyi yazılmış talimatlarla iyi çalışır. Ve bu talimatlar, bir mühendis değil, bir yazarın elinden çıkıyor. Geleceğin en değerli becerisi, kod yazmak değil — akıllıca yazmak.