ملف CLAUDE.md

الهدف

تكتب ملف CLAUDE.md احترافيًا لمشروعك، وتفهم مستوياته (مشروع، شخصي، فرعي)، وتخلّي كل جلسة تبدأ وهي تعرف قواعدك.

الشرح

كل مرة تفتح كلود كود، تعيد تشرح له مشروعك؟ لا. ملف CLAUDE.md في جذر المشروع يقرأه كلود كود تلقائيًا في بداية كل جلسة. حط فيه: وش المشروع، كيف يُشغَّل، وقواعدك.

الإنشاء

داخل الجلسة اكتب:

/init

يقرأ المشروع ويكتب مسودة CLAUDE.md. راجعها وعدّلها.

وش تحط فيه؟

# المشروع
متجر إلكتروني لمحل عطور، Next.js + Supabase، عربي RTL.

# التشغيل
- npm install ثم npm run dev
- الاختبارات: npm test
- قاعدة البيانات: supabase start

# القواعد
- التعليقات داخل الكود بالإنجليزية، والشرح لي بالعربية.
- لا تحذف ملفات بدون ما تسألني.
- كل ميزة جديدة = اختبار لها.
- استخدم المكوّنات الموجودة في components/ قبل إنشاء جديدة.
- لا تغيّر ملفات الإعدادات (.env, config) إلا بطلب صريح.

# الهيكل
- app/ الصفحات، components/ المكوّنات، lib/ الأدوات، supabase/ المخطط.

# القرارات المهمة
- الدفع عبر Stripe فقط.
- الصور في Supabase Storage.

قصير ومحدد أفضل من طويل وعام. كل سطر فيه يوفّر عليك تصحيحًا لاحقًا.

المستويات

• المشروع: CLAUDE.md في جذر المشروع (يُشارك مع الفريق عبر Git).
• الشخصي: ~/.claude/CLAUDE.md في مجلد المستخدم: قواعدك في كل المشاريع (مثل: اللغة، أسلوب التعليقات).
• المجلدات الفرعية: ملف CLAUDE.md داخل مجلد فرعي لقواعد خاصة بذلك الجزء.
• الخاص بك فقط: CLAUDE.local.md للملاحظات اللي ما تبي ترفعها مع الفريق.

إضافة قواعد أثناء الشغل

لما تصحّح كلود كود مرة («لا تستخدم هذي المكتبة»)، قل له: «أضف هذي القاعدة إلى CLAUDE.md». بكذا الملف ينمو من أخطاء حقيقية.

مع السكلز (الدرس ٦)

CLAUDE.md للقواعد العامة الدائمة. السكل للمهام المحددة اللي تتفعّل عند الحاجة. لا تحشر إجراءات طويلة في CLAUDE.md.

خطوة بخطوة

1. في جلسة كلود كود: /init.
2. راجع المسودة: احذف الزائد، أضف قواعدك.
3. أضف قسم «القرارات المهمة».
4. اختبر: افتح جلسة جديدة واطلب تعديلًا، لاحظ التزامه بالقواعد.
5. كل تصحيح = قاعدة جديدة في الملف.

برومبتات جاهزة

اقرأ المشروع واكتب CLAUDE.md مختصرًا (أقل من ٦٠ سطرًا) بالأقسام: المشروع، التشغيل، القواعد، الهيكل، القرارات المهمة. القواعد اللي أبيها: [اكتبها]. لا تضف شيئًا عامًا لا يخص هذا المشروع.

التعديل الأخير خالف قاعدة: [اذكرها]. صحّحه، ثم أضف القاعدة إلى CLAUDE.md بصياغة واضحة لا تحتمل تفسيرًا آخر.

أخطاء شائعة

• ملف عام يصلح لأي مشروع: بلا فائدة.
• ملف من ٣٠٠ سطر: يتجاهل أجزاءه. اختصر.
• قواعد بدون أمثلة عند الغموض: «اكتب كودًا نظيفًا» لا تعني شيئًا؛ «دوال أقل من ٤٠ سطرًا» تعني.

تمرين

أنشئ CLAUDE.md لمشروع حقيقي (أو لأداة الفواتير من الدرس ٢). أضف ٥ قواعد على الأقل. افتح جلسة جديدة واطلب تعديلًا يختبر إحدى القواعد. هل التزم؟

الخلاصة

CLAUDE.md = ذاكرة المشروع الدائمة: وش هو، كيف يُشغَّل، وقواعدك. /init يبدأه، وتصحيحاتك تكبّره. ومستوى شخصي لقواعدك في كل المشاريع.