الطريقة الصحيحة لفتح CLAUDE.md

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

لماذا نحتاج إلى CLAUDE.md؟

تخيل أن لديك زميلًا جديدًا، كم من الوقت تحتاج حتى تجعله يفهم مشروعك؟ CLAUDE.md هو "دليل المشروع" الذي يسمح للذكاء الاصطناعي بالبدء بسرعة.

المحتويات الخمسة الأساسية لـ CLAUDE.md

1. نظرة عامة على المشروع

وصف بسيط لما يفعله هذا المشروع، وما هي المشاكل التي يحلها، وما هي الفئة المستهدفة من المستخدمين.

# نظرة عامة على المشروع هذا نظام إدارة خلفية للتجارة الإلكترونية، يستخدم لإدارة المنتجات والطلبات والمستخدمين.

2. المكدس التقني (Technical Stack)

قائمة بالتقنيات والأطر الرئيسية المستخدمة في المشروع.

`# المكدس التقني

• الواجهة الأمامية: React + TypeScript
• الواجهة الخلفية: Node.js + Express
• قاعدة البيانات: PostgreSQL
• النشر: Docker + Kubernetes`

3. هيكل الملفات

شرح وظيفة الدلائل الرئيسية.

# هيكل الملفات /src /components - مكونات واجهة المستخدم /pages - الصفحات /utils - دوال الأدوات /api - استدعاءات API

4. الأوامر الشائعة

قائمة بالأوامر الشائعة المستخدمة في التطوير.

# الأوامر الشائعة npm run dev - بدء تشغيل خادم التطوير npm run build - بناء نسخة الإنتاج npm run test - تشغيل الاختبارات

5. القواعد

تحديد القواعد التي يجب على الذكاء الاصطناعي اتباعها عند مساعدتك في كتابة التعليمات البرمجية.

`# قواعد الترميز

• استخدام مكونات دالة
• اتباع تكوين ESLint
• استخدام PascalCase لتسمية المكونات
• استخدام camelCase لتسمية المتغيرات`

مثال كامل

`# اسم المشروع: Task Manager

نظرة عامة على المشروع

تطبيق بسيط لإدارة المهام، يدعم إنشاء المهام وتحريرها وحذفها وتصنيفها.

المكدس التقني

• React 18
• TypeScript
• Tailwind CSS
• Vite

هيكل الملفات

/src /components - مكونات واجهة المستخدم /hooks - Hooks مخصصة /types - تعريفات أنواع TypeScript /utils - دوال الأدوات

الأوامر الشائعة

• npm run dev: بدء تشغيل خادم التطوير
• npm run build: بناء نسخة الإنتاج
• npm run lint: فحص الكود

قواعد الترميز

• استخدام كتابة دالة للمكونات
• استخدام Tailwind CSS للتصميم
• وضع كل مكون في مجلد منفصل`

نصائح

• حافظ على الإيجاز: لا تكتب طويلاً جدًا، فالذكاء الاصطناعي "سيتعب أيضًا"
• التحديث بانتظام: تذكر تحديث CLAUDE.md عند تغيير المشروع
• الأولوية للأمثلة: إعطاء أمثلة محددة للتعليمات البرمجية أكثر فعالية من الوصف المجرد
• التركيز على نقاط الضعف: شرح الأماكن المعرضة للخطأ بشكل خاص

اكتب CLAUDE.md بشكل جيد، واجعل الذكاء الاصطناعي مساعدك القوي!