ملفات السياق: CLAUDE.md وAGENTS.md

Project Context Files

درسمتوسط12 دقيقة

ملف تعليمات في جذر المشروع يقرؤه الوكيل في كل جلسة: الأوامر، والأسلوب، والقواعد التي لا يجوز كسرها.

12 دقيقةمدة القراءة
متوسطالمستوى

ستتعلم في هذا الدرس

  • إنشاء ملف تعليمات دائم للمشروع
  • تقليل تكرار التعليمات وأخطاء النسيان

الفكرة

يقرأ 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.

المصادر

  1. Claude Code: إدارة الذاكرة وملف CLAUDE.md
  2. AGENTS.md: صيغة مفتوحة لتعليمات وكلاء البرمجة