Fragmento de la lección

AGENTS.md En İyi Uygulamaları: Dev Talimat Dosyası Neden Çalışmaz, Yönlendirici Nasıl Kurulur

Ajanlar devasa AGENTS.md veya CLAUDE.md dosyasını neden yok sayar: talimat bozulmasının dört nedeni, talimat SNR metriği, yönlendirici → dokümanlar → çalıştırılabilir kontroller üç katmanlı mimari ve kural pasaportu.

yönlendirici mimarisi talimat SNR'ı üç katmanlı mimari kural pasaportu

Lo que aprenderás en esta lección

Talimat dosyanızı bir yönlendiriciye ve tematik belgelere ayıracaksınız.
Talimatlarınızın SNR değerini hesaplayacak ve neyin silinmesi gerektiğini tespit edeceksiniz.
Kural pasaportunu kullanarak neyin talimatlara girmeye, neyin ise teste girmeye değer olduğunu belirlemeyi öğreneceksiniz.

Inicio de la lección

Üç aylık düzeltmeler, ve ajan daha kötü hale geldi

Ajanın her hatası → AGENTS.md'ye yeni bir kural
Dosya 600 satıra kadar büyüdü — ve ajan daha sık hata vermeye başladı
Kritik güvenlik kuralı, dosyada olmasına rağmen göz ardı ediliyor

Her şey mantıklı başladı: ajan hata yaptı — siz bir kural eklediniz. Yine hata yaptı — bir kural daha eklediniz. Üç ay sonunda AGENTS.md'de 600 satır var ve gurur duyuyorsunuz: artık her şey tarif edildi. Ama basit bir hata düzeltmesi sırasında ajan nedense burayla hiçbir ilgisi olmayan dağıtım talimatlarını okuyor. Oysa 300. satırdaki güvenlik kuralı — yani her şeyin asıl amacı olan o kural — sanki hiç yokmuş gibi görmezden geliniyor. Üstelik birbiriyle çelişen üç stil kuralı, her çalıştırmada farklı, rastgele davranışlara yol açıyor.

Bu sistemsel bir arıza, tek seferlik bir ajan hatası değil

Basit bir hata düzeltmesi → ajan gereksiz yere dağıtım talimatlarını okuyor
300. satırdaki kritik güvenlik kuralı — sanki görünmez
Birbiriyle çelişen üç stil kuralı → rastgele davranış

Bu tek seferlik bir ajan hatası değil — sistematik bir belirti. Talimat dosyası kontrolsüzce büyüdüğünde hep aynı şey olur: ilgili bilgi, alakasızların arasında kaybolur; önemli olan, görsel olarak ikincilden ayırt edilemez hale gelir; çelişkiler birikir, çünkü silmekten korkulur. Bu dersin devamında bu tablonun ortaya çıkmasına yol açan dört bağımsız nedeni, sorunun kendi dosyanızdaki boyutunu gösteren bir metriği ve eski kuralların üzerine yeni bir kural eklemek yerine sorunu kökten çözen mimariyi inceleyeceğiz.

Mit: AGENTS.md'de ne kadar çok kural varsa, o kadar güvenli

🤔 Mit / Sık karıştırılan:
Her yeni kural ajanı daha güvenilir kılar
600 satırlık dosya = maksimum kontrol
✅ Aslında:
Satır sayısı fazla artar artmaz ajanın performansı düştü
Kritik kural, ikincil kuralların arasında kayboldu
📌 Akılda tutun: sinyal, hacimden önemlidir — satır sayısını değil SNR'yi ölçün

Mantıklı görünüyor: ne kadar çok kural yazarsanız, ajan o kadar güvenli olur. Uygulamada ise tam tersi. Belirtideki örnekte dosya 600 satıra kadar büyüdü — ve tam da o anda kritik güvenlik kuralına uyulmaz oldu. Mesele kural sayısında değil; ajan, 600 satırın her birine eşit dikkat göstermeyi fiziksel olarak başaramıyor. Talimat hacmi, etkinliği anlamına gelmez. Devamında, talimat dosyasının büyümesinin ajanın güvenilirliğini neden artırmayıp azalttığını dört bağımsız nedenle ele alacağız.

La lección completa es de suscripción

22 diapositivas más en la versión completa.

El vídeo, todas las diapositivas, apuntes, tests, tutor de IA y entrevista se desbloquean al iniciar sesión y suscribirte.

Iniciar sesión o registrarse Suscribirse

Contenido de la lección

Üç aylık düzeltmeler, ve ajan daha kötü hale geldi
Bu sistemsel bir arıza, tek seferlik bir ajan hatası değil
Mit: AGENTS.md'de ne kadar çok kural varsa, o kadar güvenli
Dört bağımsız neden — ve hepsi aynı anda etkisini gösteriyor
Dosyadaki 600 satır, bağlam bütçesinin şimdiden %10'u
300. satırdaki kural — modelin kör kaldığı nokta
Tüm kurallar aynı görünüyor — ajanın sinyal alacağı hiçbir yer yok
Neden kimse AGENTS.md'den bir satır silmeye cesaret edemiyor
Tek bir nedeni düzeltmek neden hiçbir şeyi değiştirmiyor
❓ Şifre ayda iki kez loglarda — üstelik kural 210. satırda duruyor
💡 Sorun kuralın kelimelerinde değil, dosyadaki konumunda
SNR: dosyadaki gürültüyü dürüstçe gösteren sayı
Kendi dosyanızın SNR'sini nasıl hesaplarsınız
Tek devasa dosya yerine üç seviye
Router'ın tam beş görevi var — fazlası yok
Ajanın her zaman değil, yalnızca gerektiğinde açtığı belgeler
Yazılmasına gerek olmayan talimat: o zaten kodda
2. seviyeye doğru bağlantı: koşulla birlikte, salt yol değil
🛠 Hikâye: pasaportsuz kalan, az kalsın unutulacak kural
Kuralın pasaportu: üç öznitelik, yoksa kural ölümsüz olur
Konum belirleyicidir: kural nereye, hata notu nereye?
Pratik: planlı revizyon ve üç soru
AGENTS.md'den satırlar neden neredeyse hiçbir zaman silinmez?
Uygulama: Talimat dosyanızı bugün router ve belgelere ayırın
Router, ansiklopediyi yener