Claude Code 2.1.277 يضيف دعم AGENTS.md مع حدود علم الميزة

يقدم التحديث الصادر في 18 سبتمبر 2026 لبرنامج Claude Code (الإصدار 2.1.277) دعمًا أصليًا لتقليد AGENTS.md، وهو ملف Markdown يجمع سياق التطوير عبر المستودع، أوامر الاختبار وقواعد المساهمة.

إذا كان المشروع يفتقر إلى ملف CLAUDE.md، سيقوم Claude Code تلقائيًا بالاعتماد على قراءة AGENTS.md، مما يسمح للفرق بالحفاظ على مصدر واحد للبيانات التعليمية دون تكرار الملفات لكل أداة.

الإعداد والتحكم

يمكن للمشغلين التبديل بين CLAUDE.md وAGENTS.md عبر قائمة ‎/config. يُحفظ الاختيار محليًا، لكن التنفيذ الأساسي يُقدَّم عبر مكوّن إضافي مدمج يُفعَّل بواسطة علم مميز يُجلب عن بُعد، وفقًا لتقارير كوربن.

يعني هيكل علم الميزة أن تعطيل حركة المرور غير الأساسية أو جمع البيانات قد يمنع تحميل العلم. في هذه الحالة، يعود Claude Code بهدوء إلى السلوك السابق، متجاهلًا AGENTS.md دون أي خطأ ظاهر.

الحل الموثق هو الحفاظ على ملف CLAUDE.md بسيط يستورد AGENTS.md باستخدام الصيغة @AGENTS.md. يضمن ذلك عمل الاعتماد الاحتياطي حتى عندما لا يمكن جلب العلم.

مشهد التوافق

الإصدار الأولي لا يشمل التكامل مع Amazon Bedrock أو Google Vertex AI أو Microsoft Foundry. سيستمر مستخدمو هذه المنصات في الاعتماد على CLAUDE.md أو أدوات خارجية حتى يتم توسيع التغطية في تحديث مستقبلي.

عدد من المساعدين التطويريين الآخرين يدعمون بالفعل تقليد AGENTS.md، بما في ذلك Codex وGemini CLI وDevin وCursor وGitHub Copilot. يقلل الدعم الموجود من تكرار التعليمات عبر النظام البيئي.

قائمة تدقيق عملية للفرق

• التحقق من أن ‎/config يظهر AGENTS.md كمصدر التعليمات
• التأكد من وجود ملف CLAUDE.md فقط لاستيراد @AGENTS.md إذا كان علم الميزة قد يُحجب
• اختبار أن Claude Code يعرض بوضوح "تحميل تعليمات المشروع من AGENTS.md" في الواجهة
• ضمان عدم حظر إعدادات الخصوصية أو جمع البيانات لاسترجاع علم الميزة عن بُعد

يجب على الفرق أيضًا مراقبة أن رقم الإصدار وحده لا يكفي كدليل على الدعم. يجب أن تشير الواجهة صراحةً إلى أن تعليمات المشروع تم تحميلها من AGENTS.md؛ وإلا قد يفشل الاعتماد الاحتياطي بصمت.

نظرًا لاعتماد الاعتماد الاحتياطي على علم مميز عن بُعد، قد تحتاج المؤسسات ذات سياسات الشبكة الصارمة إلى إضافة نقطة النهاية للعلم إلى القائمة البيضاء أو تعديل إعدادات الخصوصية لضمان سلوك ثابت.

في الواقع، يبسط إضافة الاعتماد الاحتياطي على AGENTS.md عملية الانضمام للمساهمين الجدد، ويجعل Claude Code متوافقًا مع المساعدين الذكائيين الآخرين، ويقلل العبء الإداري للحفاظ على ملفات تعليمية متعددة متزامنة.

يُظهر التحليل أن الاعتماد على ملف AGENTS.md كمصدر احتياطي يُعطي مرونة أكبر للفرق التقنية، لكنه يضيف طبقة من التعقيد المرتبط بآلية تحميل علم الميزة عن بُعد. إذا فُشل جلب العلم بسبب قيود الشبكة أو سياسات الخصوصية، يتحول النظام إلى السلوك السابق دون إشعار واضح، ما قد يخلق فجوة بين توقعات المطورين والنتيجة الفعلية. لذا من الضروري توثيق سلوك الانتقال هذا داخل دليل التشغيل الداخلي لضمان أن جميع الأعضاء يدركون أن عدم ظهور رسالة التحميل لا يعني بالضرورة فشل القراءة، بل قد يكون مجرد إلغاء مؤقت للميزة بسبب عدم توفر العلم.

من ناحية أخرى، يفرض وجود علم مميز عن بُعد حدًا تقنيًا على إمكانية تفعيل الميزة في بيئات الحوسبة السحابية الكبيرة التي تُعطِّل جمع البيانات غير الضروري. هذا القيد يعني أن المؤسسات التي تستضيف مشاريعها على منصات سحابية مُدارة قد لا تستفيد من دعم AGENTS.md ما لم تُعيد تكوين إعدادات الخصوصية أو تُضيف نقطة النهاية للعلم إلى القوائم البيضاء. وبالتالي، يتطلب تطبيق الميزة مراجعة سياسات الشبكة وتحديث قواعد الجدار الناري لضمان استمرارية تحميل العلم دون تعريض البيانات الحساسة للخطر.

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

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

من الناحية العملية، تُظهر التجربة أن إظهار رسالة واضحة مثل "تحميل تعليمات المشروع من AGENTS.md" في واجهة المستخدم يُعد مؤشرًا حاسمًا للشفافية. دون هذه الإشارة، قد يظن المطورون أن النظام يستخدم ملف CLAUDE.md حتى وإن كان غير موجود، ما قد يؤدي إلى إهمال تعديل أو تحديث الملف الاحتياطي. لذا، يُنصح بتفعيل إعدادات السجل (logging) التي تُسجل كل عملية تحميل علم ومصدر التعليمات لتوفير مسار تدقيق يمكن الرجوع إليه عند الحاجة.

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

بالنسبة للمنظمات الناطقة بالعربية، فإن الأثر العملي هو تحسين سلاسة وشفافية سير العمل: يمكن للمطورين وضع جميع إرشادات المشروع ذات الصلة في ملف AGENTS.md واحد، وسيقوم Claude Code باحترامه تلقائيًا عندما لا يتوفر CLAUDE.md، ويمكن للفرق التحقق من السلوك عبر الواجهة وقائمة التحقق البسيطة أعلاه.