CLAUDE.mdملف CLAUDE.md

تخيّل ورقة معلّقة على باب مكتب: «هنا نحفظ العقود في الخزانة الزرقاء. الاجتماعات يوم الأحد. لا تُرسل أي عرض سعر قبل أن يراجعه المدير. ورقم الصيانة في الدرج الأول». أي شخص يدخل لأول مرة يقرأ الورقة قبل أن يلمس شيئًا، فيعمل كما يعمل أهل المكان لا كما يخمّن.

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

وهو يأتي غالبًا في طبقتين:

• ملف عام في مجلد إعداداتك الشخصي، فيه ما يصح في كل مشروع: «اشرح بلغة بسيطة، فأنا لست مبرمجًا»، «اسألني إذا كان الطلب غامضًا».
• ملف خاص بالمشروع داخل مجلده، يشاركه كل من يعمل عليه، فيه قواعد هذا المشروع وحده.

يقرأ الوكيل الاثنين معًا، وعند التعارض تغلب عادة القاعدة الأكثر تحديدًا، أي قاعدة المشروع. والأدوات الأخرى لها ملفات بالفكرة نفسها وأسماء مختلفة، مثل AGENTS.md.

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

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