Claude Code لا يقرأ AGENTS.md إلا مع تفعيل القياس عن بُعد

أضاف Claude Code 2.1.277 دعماً لملف AGENTS.md: في مشروع لا يحتوي على CLAUDE.md يُفترض أن يقرأ الأداة ملف التعليمات البديل. ويرى تحقيق نُشر على blog.szypowi.cz أن هذا الدعم يعتمد بصمت على تفعيل التليمتري وغيره من الحركة الشبكية غير الضرورية.

المُحمِّل ينتظر راية عن بُعد

يأتي مُحمِّل AGENTS.md كإضافة مدمجة باسم agents-md. وفي حزمة 2.1.280 يضبط تسجيلها قيمة isOnByDefault على false، ويحدد الإتاحة عبر راية ميزة عن بُعد تُسمى tengu_agents_md_mod، وقيمتها الاحتياطية false. وعندما يتعذّر جلب الراية تصبح الإضافة غير متاحة ولا يُقرأ الملف المحلي أبداً، مع أن قراءة ملف markdown من مجلد العمل لا تحتاج إلى الشبكة إطلاقاً. وتتبّع الكاتب السبب إلى القضية #95690 على GitHub وأضاف قياساته الخاصة.

اختبارات بكلمة دالة مع إيقاف التليمتري

كان الاختبار بسيطاً: مجلد فارغ لا يحوي سوى AGENTS.md بكلمة دالة، وطلب إلى الأداة أن تذكر الكلمة دون قراءة الملفات. وأُعيد تشغيل كل إعداد مرتين، لأن الجلسة الأولى تجلب الراية فقط.

مع ضبط CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 أو DISABLE_TELEMETRY=1 لم يُحمَّل الملف قط، وتوجّب مسح المتغيّرين معاً. وضبط أيّ منهما على 0 لا يساعد، لأن أي قيمة تُحتسب. ولم يكن لكتلة env في ملف .claude/settings.json الخاص بالمشروع أي أثر، أي لا سبيل إلى تفعيل الميزة لمستودع واحد. أما التجاوز على مستوى الجلسة عبر --settings فيعمل ابتداءً من الجلسة الثانية. ولا يُطبع أي تحذير في أي من هذه الحالات. وتواجه البوابات الخارجية وBedrock وVertex المشكلة نفسها، لأن الراية لا يمكن أن تصبح true هناك أيضاً.

الحل البديل

يدعم CLAUDE.md استيراد @path، وهي غير مرتبطة بالراية. فسطر واحد في CLAUDE.md بجوار AGENTS.md يحمّله حتى مع إيقاف التليمتري، إذ يعيد الاختبار نفسه الكلمة. الثمن ملف إضافي واحد لكل مستودع، وهو بالضبط العبء الذي كان من المفترض أن يزيله دعم AGENTS.md.

لماذا يُعدّ الصمت الأسوأ

يرى الكاتب أن إيقاف التليمتري يجب أن يكلّف التشخيص فقط ولا شيء غيره، وأن مفتاحاً عن بُعد لا معنى له في ميزة مصدرها الوحيد موجود على القرص. وتصيب الراية أكثر من يهمّهم AGENTS.md: من يحتفظون بملف تعليمات واحد لعدة وكلاء، والفرق التي توقف الحركة غير الضرورية بحكم السياسة. ولأن لا شيء يُسجَّل، سيستنتج معظمهم أن النموذج تجاهل تعليماتهم. ويطالب بتحذير عند التشغيل حين يوجد AGENTS.md لكنه متجاوَز، وبملف AGENTS.md على مستوى المستخدم ودعم أصلي لمسار .agents/skills المشترك الذي يقرأه Codex أصلاً. وإلى ذلك الحين يستخدم سطر CLAUDE.md الواحد وارتباطاً رمزياً للمهارات.