تضمين قواعد المشروع في ملفات Claude.md

يتيح لك نظام CLAUDE.md في Claude Code دمج تعليمات خاصة بالمشروع مباشرةً داخل مستودعك. فبدلًا من تعريف Claude بمجموعة تقنياتك واصطلاحات التسمية وإجراءات البناء في كل مرة تبدأ فيها جلسة جديدة، تنشئ ملف Markdown بسيطًا يقرأه Claude تلقائيًا.

للبدء، شغّل الأمر /init داخل Claude Code. سيقوم هذا الأمر بتحليل قاعدة الشيفرة الموجودة لديك وإنشاء ملف CLAUDE.md أوّلي يتضمن السياق ذا الصلة. يمكنك بعد ذلك تعديل هذا الملف ليشمل: أوامر البناء والاختبار، ومعايير البرمجة، والقرارات المعمارية، وبنية المجلدات، واصطلاحات التسمية. خزّنه في الجذر باسم ./CLAUDE.md وأضفه إلى نظام التحكم بالإصدارات - سيستفيد فريقك بأكمله من السياق نفسه.

يعيش الملف داخل المستودع ويتزامن عبر git، بحيث يتلقى كل مطور يعمل على المشروع (وكذلك Claude Code نفسه) التعليمات ذاتها. ويحمّل Claude ملفات CLAUDE.md من دليل العمل لديك ومن جميع الأدلة الأصلية، ويدمجها بالترتيب، بحيث يمكنك ترتيب القواعد على مستوى المشروع مع قواعد على مستوى الفريق مع التفضيلات الشخصية.

على سبيل المثال، إذا كنت تعمل على مشروع TypeScript/React، فقد يحدّد ملف CLAUDE.md الخاص بك: "استخدم دائمًا وضع TypeScript الصارم، واكتب اختبارات وحدة باستخدام Vitest قبل التنفيذ، واتبع بنية المجلدات في ./docs/architecture.md، واستخدم رسائل إيداع تقليدية." وبمجرّد الحفظ، يحمّل Claude Code هذا في كل جلسة دون تكرار التعليمات.

أبقِ الملف أقل من 300 سطر - فـ Claude يقرأه في بداية كل جلسة والرموز مهمة. ركّز على المعايير عالية التأثير بدلًا من الشروحات المطوّلة.