ملفات السياق: CLAUDE.md وAGENTS.md
Project Context Files
ملف تعليمات في جذر المشروع يقرؤه الوكيل في كل جلسة: الأوامر، والأسلوب، والقواعد التي لا يجوز كسرها.
ستتعلم في هذا الدرس
- إنشاء ملف تعليمات دائم للمشروع
- تقليل تكرار التعليمات وأخطاء النسيان
الفكرة
يقرأ Claude Code ملف CLAUDE.md تلقائياً في بداية الجلسة، وتعتمد أدوات كثيرة صيغة AGENTS.md المفتوحة لنفس الغرض. هذا الملف ذاكرة دائمة للمشروع تغنيك عن تكرار التعليمات.
ماذا تكتب فيه؟
- أوامر البناء والتشغيل والاختبار.
- هيكل المجلدات وما يوجد في كل منها.
- قواعد الأسلوب والتسمية.
- ممنوعات صريحة: لا تعدّل ملفات معينة، لا تضف مكتبات دون سؤال، لا تضع أسراراً في الكود.
- تعريف «اكتمل العمل»: مثلاً يجب أن تنجح الاختبارات قبل إعلان الانتهاء.
مثال
# AGENTS.md
## Commands
- install: npm ci
- dev: npm run dev
- test: npm test
## Rules
- UI is Arabic RTL; never hardcode left/right, use logical CSS properties.
- Never commit .env or API keys.
- Run `npm test` before saying a task is done.