Codex’in AGENTS.md talimatını kullanmamasında ilk kontrol dosyanın konumu ve oturumun hangi klasörden başladığıdır. Talimat zinciri genel ayarlardan proje köküne, oradan çalışma klasörüne doğru kurulur. Aynı yerde AGENTS.override.md bulunması, beklediğiniz AGENTS.md yerine farklı metnin yüklenmesine neden olabilir.
Talimat yüklendiği halde sonuç yanlışsa sorun dosya keşfi olmayabilir. Kuralın somutluğunu, görevin kapsamını ve mevcut kodun örneklerini birlikte değerlendirin.
Talimat ile izin ayarını ayırın
AGENTS.md projede nasıl çalışılacağını anlatır; dosya erişimi veya komut iznini kendiliğinden açmaz. Örneğin “testleri çalıştır” talimatı yüklenebilir, fakat gerekli çalışma zamanı kurulu değilse test yine başlayamaz. Böyle bir durumda talimat okunmadı sonucuna hemen varmayın.Yükleme sorununu daraltın
- Dosya adını kontrol edin. AGENTS.md adının yanlış uzantıyla, örneğin AGENTS.md.txt olarak kaydedilmediğini doğrulayın. Dosyanın boş olmadığından emin olun.
- Çalışma klasörünü doğrulayın. Talimatın hangi proje için olduğunu ve Codex’i hangi klasörden başlattığınızı karşılaştırın. Ayrı çalışma kopyaları aynı dosyaları paylaşmak zorunda değildir.
- Override dosyalarını inceleyin. Aynı dizindeki AGENTS.override.md ve üst düzey genel talimatlar içinde çelişen bir kural olup olmadığını kontrol edin. Başka projeye ait genel kuralı yerel sorun sanmayın.
- Yeni oturumla deneyin. Talimat keşfi oturum başlangıcına bağlı olduğundan dosyayı düzenledikten sonra yeni bir çalıştırma yapın. Dosyanın varlığını ve ilgili kuralı özetlemesini isteyin.
- Kısa, ölçülebilir bir deneme verin. “Yeni arayüz metni Türkçe olmalı” gibi gözlenebilir kuralı küçük bir değişiklikte kontrol edin. Uygulandığını dosya farkıyla doğrulayın.
Uzun talimatı neden bölmeli?
Çok uzun dosyada önemli kural diğer ayrıntıların arasında kaybolabilir ve toplam talimat boyutu sınırına takılabilir. Genel çalışma biçimini kökte tutup yalnız bir alt modüle ait ayrıntıyı o modülün talimatına yerleştirmek daha anlaşılırdır. Aynı kuralı birden çok yerde farklı sözcüklerle yazmak yerine tek yetkili açıklama bırakın.Talimat yüklendiği halde sonuç yanlışsa sorun dosya keşfi olmayabilir. Kuralın somutluğunu, görevin kapsamını ve mevcut kodun örneklerini birlikte değerlendirin.