إذا كنت تستخدم أكثر من وكيل برمجة بالذكاء الاصطناعي (Copilot، Cursor، Claude Code، Codex…)، فغالبًا واجهت فوضى الإعدادات: كل أداة لها ملفها الخاص. الحل الذي فرض نفسه في 2026 هو AGENTS.md — ملف واحد قابل للقراءة آليًا يخبر أي وكيل كيف يعمل مشروعك: أوامر البناء، أسلوب الكود، قواعد الاختبار، والحدود الممنوعة. صار الآن معيارًا تحت مظلة Linux Foundation وتبنّاه أكثر من 60,000 مشروع. في هذا المقال نشرح ما هو، ولماذا ظهر، وكيف تكتب واحدًا فعّالًا.

ما هو AGENTS.md؟

ملف AGENTS.md: المعيار الذي يوحّد توجيه وكلاء البرمجة في 2026 — برمجة وتطوير

هو ملف Markdown منظّم ومُدار بالإصدارات (version-controlled)، يوفّر لوكلاء الذكاء الاصطناعي سياقًا ثابتًا خاصًا بمشروعك. ببساطة: بدل أن تشرح للوكيل في كل مرة كيف تبني وتختبر وتنسّق الكود، تكتبها مرة واحدة في هذا الملف، فيقرأها أي وكيل يدعم المعيار.

لماذا ظهر؟

المشكلة كانت تعدّد الصيغ: Aider استخدم CONVENTIONS.md، وCline استخدم مجلدات .clinerules، وClaude Code استخدم CLAUDE.md، وهكذا. الفرق الذي يشغّل عدة وكلاء كان يحافظ على إعدادات مكرّرة ومتضاربة. AGENTS.md وحّدها في مصدر حقيقة واحد.

التبنّي والحوكمة (2025–2026)

  • دعم واسع: يدعمه أكثر من 25 أداة بينها Codex وCopilot وCursor وWindsurf.
  • حوكمة محايدة: صار تحت مظلة Linux Foundation (معيار مجتمعي لا تملكه شركة).
  • تبنٍّ ضخم: أكثر من 60,000 مشروع مفتوح المصدر اعتمده.

الأثر المقاس

حلّلت GitHub أكثر من 2,500 مستودع ووجدت أن معدلات نجاح الوكلاء تقفز بشكل كبير مع وجود توجيه مناسب. لكن القيمة الأعمق للمؤسسات ليست معدل النجاح فقط، بل التوحيد عبر الأدوات وتجنّب الارتباط بمورّد واحد: بملف واحد تقدر تبدّل بين Claude وCopilot ونموذج ذاتي الاستضافة بسهولة.

كيف تكتب AGENTS.md فعّالًا؟

ثلاثة أقسام أساسية:

  1. ابدأ بالأوامر: اسرد كل أمر يحتاجه مطوّر (بشري أو AI) للبناء والاختبار والفحص (Lint) والنشر — بدقّة، مع الأعلام (Flags) ومتغيرات البيئة والمتطلّبات.
  2. مثال كود لكل اصطلاح: لا تصف أسلوبك، أظهره — مثال جيّد وآخر سيّئ لكل نمط مهم.
  3. قائمة "ممنوع" (Never Do): فكّر في الأخطاء التي تسبّب ضررًا حقيقيًا: كشف الأسرار، حذف الاختبارات، تعديل إعدادات الإنتاج، عمليات قاعدة بيانات مدمّرة. هذه حدودك الصارمة.

للمؤسسات، يُنصح بهيكل قيود من ثلاث طبقات:

الطبقة المعنى
Always do افعل دائمًا
Ask first اسأل قبل التنفيذ
Never do ممنوع تمامًا

نصيحة عملية: اجعله مختصرًا ومتسقًا. الدراسات تُظهر أن ملفات AGENTS.md الجيدة معتدلة الحجم (وسيط ~335 كلمة) بتسلسل عناوين ضحل — عنوان H1 واحد، و6–7 أقسام H2 — لا تعشيش عميق.

الامتدادات الهرمية

بعض المقترحات توسّع AGENTS.md إلى نظام متتالٍ (Cascading): من العام → المشروع → المجلد. قواعد عامة للمستخدم، ثم اصطلاحات أساسية للمشروع، ثم تعليمات نشطة للمهمة، وأخيرًا قواعد اختيارية على مستوى المجلد — كلها بملف واحد وصيغة موحّدة.

أسئلة شائعة

هل أحتاج AGENTS.md حتى لو أستخدم وكيلًا واحدًا؟ نعم مفيد؛ فهو يوثّق سياق مشروعك ويرفع جودة مخرجات الوكيل، ويسهّل الانتقال لأي أداة لاحقًا دون إعادة إعداد.

أين أضعه؟ في جذر المستودع عادةً، ويمكن إضافة ملفات على مستوى مجلدات فرعية للقواعد الخاصة بها (النظام المتتالي).

هل يغني عن التوثيق التقليدي؟ لا يلغيه، لكنه يوجّه الوكلاء تحديدًا. اعتبره "دليل تشغيل" موجّهًا للـ AI بجانب توثيقك للبشر.

الخلاصة

AGENTS.md هو خطوة نحو مستقبل يتعاون فيه البشر والوكلاء بسلاسة: أي وكيل يستنسخ المستودع ويفهم فورًا سياقه واصطلاحاته وحدوده. مع دعم +25 أداة وحوكمة Linux Foundation وتبنّي عشرات آلاف المشاريع، صار كتابته ممارسة أساسية. ابدأ بملف بسيط (أوامر + مثال لكل اصطلاح + قائمة ممنوعات)، وطوّره تدريجيًا — فملف واحد جيّد يوفّر عليك فوضى إعدادات كل أداة على حدة.

#AGENTS.md#وكلاء البرمجة#أدوات المطورين#معايير#الذكاء الاصطناعي