AGENTS.md ووكلاء الكود: العُدّة الجديدة للمطوّر

من الإكمال التلقائي إلى الوكيل

في سنوات قليلة، تغيّرت طبيعة المساعدة في الكود: من الاقتراح سطراً بسطر، انتقلنا إلى وكلاء قادرين على قراءة قاعدة شيفرة بأكملها، وتشغيل الاختبارات، وفتح pull request. لم تعد المشكلة «توليد الكود»، بل منح الوكيل السياق الصحيح — أوامر البناء، والأعراف، والمعمارية.

AGENTS.md: معيار مفتوح، بصيغة Markdown

هذا بالضبط ما يحلّه AGENTS.md: ملف Markdown بسيط في جذر المشروع، يشرح لأي وكيل كيفية العمل هنا — أوامر البناء والاختبار، وأسلوب الكود، والأُطر، وقرارات المعمارية. لا مخطّط مفروض، ولا أداة تُثبَّت: كل وكيل يقرؤه يستفيد فوراً.

جرى إضفاء الطابع الرسمي على الصيغة في أغسطس 2025، ثم التبرّع بها لمؤسسة Agentic AI Foundation التابعة لـ Linux Foundation في ديسمبر 2025. بحلول نهاية 2025، اعتمده أكثر من 60 ألف مشروع مفتوح المصدر، وتدعمه أكثر من عشرين أداة — GitHub Copilot (دعم أصيل منذ أغسطس 2025)، وOpenAI Codex، وCursor، وGemini وJules، وWindsurf، وZed، وغيرها. علامة على العصر: صار Next.js 16.2 يولّد AGENTS.md في create-next-app.

لماذا هو أكثر من موضة

الوكيل بلا سياق يكتشف المشروع من جديد في كل مرة: يخمّن الأوامر، ويتجاهل أعرافك، وينتج كوداً يحتاج إعادة عمل. AGENTS.md مكتوب جيداً يُزيل مرحلة الاكتشاف هذه: الكود المولَّد يحترم معاييرك منذ البداية، وتتقلّص جولات المراجعة ذهاباً وإياباً.

إنها في جوهرها الفكرة نفسها لتوثيق إعداد جيّد — إلا أن الوافد الجديد هنا آلة تقرأ بسرعة ولا تنسى شيئاً.

موقفي

أقولها كثيراً: الذكاء الاصطناعي جزء من أدواتي، لا من أسسي. الوكيل المجهَّز جيداً يُسرّع البحث والنمذجة والمهام الميكانيكية. لكن المطوّر هو من يكتب AGENTS.md، ومن يقرّر المعمارية، ومن يراجع ويعتمد. الأداة لا تحلّ محلّ الحُكم: بل تضاعفه.

الوكيل بقدر ما تمنحه من سياق. AGENTS.md هو هذا السياق، مُدارٌ بالإصدارات مع الكود.