CLAUDE.md هو الملف الوحيد الذي يشكّل كيف يفهم Claude مشروعك. ملف مكتوب جيداً يعني تصحيحات أقل وكود أفضل ووكلاء يعرفون فعلاً ما يعملون عليه.
هذا الدليل يمشيك عبر كل قسم من ملف CLAUDE.md، من إعلانات المجموعة التقنية إلى تلميحات خاصة بالوكلاء. تابع وابنِ ملفك خطوة بخطوة.
CLAUDE.md ملف ماركداون تضعه في جذر مشروعك. عندما يبدأ Claude Code جلسة، يقرأ هذا الملف أولاً. كل ما فيه يصبح جزءاً من سياق Claude: مجموعتك التقنية وهيكل ملفاتك واصطلاحات فريقك وأي تعليمات محددة تريد من كل وكيل اتباعها.
فكّر فيه كوثيقة إحاطة. بدونه، يضطر Claude للتخمين كيف مشروعك منظم. مع ملف جيد، يعرف Claude مسبقاً أين الأشياء وأي أنماط يتبع وما يتجنب. الفرق في جودة المخرجات كبير.
“استثمار 10 دقائق في CLAUDE.md يوفر ساعات من تصحيح كود مولّد بالذكاء الاصطناعي لا يتطابق مع أنماط مشروعك.”
ملاحظة عبر مئات مشاريع Claude Code
هيكل ودقة CLAUDE.md يؤثران مباشرة على مدى أداء Claude في قاعدة كودك.
CLAUDE.md منظم جيداً يغطي هذه المجالات الست. كل منها يمنح Claude معلومات ملموسة يمكنه التصرف بناءً عليها فوراً.
ادرج أطر العمل والمكتبات وإصداراتها بوضوح. أضف مدير الحزم وإصدار Node وأي متطلبات تشغيل. Claude يستخدم هذا لتوليد كود متوافق بدون تخمين.
صف مجلداتك الرئيسية وما يوجد في كل منها. المكونات والمتاجر والخدمات ومسارات API والأنواع. رسم شجري قصير مع وصف بسطر واحد لكل مجلد يعمل جيداً.
وثّق أنماط التسمية (camelCase للملفات، PascalCase للمكونات)، نهج معالجة الأخطاء، ترتيب الاستيرادات، وأي قواعد خاصة بالمشروع. هذا يبقي مخرجات Claude متسقة مع كودك الحالي.
أضف أوامر التطوير والبناء والاختبار والفحص. عندما يحتاج Claude للتحقق من أن شيئاً يعمل أو اقتراح سكربت، سيستخدم الأوامر الدقيقة التي يتوقعها مشروعك.
إذا تستخدم عدة وكلاء (ضمان جودة، واجهة أمامية، خلفية، عمليات)، أضف قسماً يصف ما يجب أن يركز عليه كل دور. هذا مفيد خصوصاً مع إعداد AgentsRoom متعدد الوكلاء.
أخبر Claude بما لا يفعل. لا تعدّل ملفات الإعداد، لا تغيّر نظام المصادقة، لا تعد هيكلة طبقة قاعدة البيانات. الحدود الصريحة تمنع الوكلاء من إجراء تغييرات غير مرغوبة.
لا تحتاج لكتابة كل شيء دفعة واحدة. ابدأ بالأساسيات ووسّع كلما اكتشفت ما يحتاج Claude لمعرفته.
افتح package.json وادرج كل إطار عمل ومكتبة وأداة يستخدمها مشروعك. سجّل الإصدارات. تحقق من متطلبات التشغيل (إصدار Node، إصدار Python، قاعدة البيانات). هذا يصبح قسم المجموعة التقنية.
package.json + إصدارات التشغيل + قاعدة البيانات
نفّذ tree سريع لمجلد src. حدد المجلدات العلوية واكتب وصفاً بسطر واحد لكل منها. ركّز على أين المكونات والمتاجر والخدمات والأنواع ومسارات API.
شجرة src/ مع توضيحات الغرض
انظر لكودك الحالي وسجّل الأنماط: كيف تسمّي الملفات، كيف تعالج الأخطاء، كيف تنظم الاستيرادات، هل تستخدم تصديرات افتراضية أم مسماة. اكتبها كقواعد قصيرة.
التسمية، الاستيرادات، معالجة الأخطاء، التصديرات
إذا تعمل مع وكلاء متخصصين، أضف مجالات تركيز لكل دور. وكيل الواجهة الأمامية يجب أن يعرف مكتبة مكوناتك. وكيل العمليات يجب أن يعرف خط نشرك. وكيل ضمان الجودة يجب أن يعرف إطار اختبارك.
مجالات تركيز لكل دور + مناطق تجنب
AgentsRoom مبني حول CLAUDE.md كمفهوم أساسي، وليس فكرة لاحقة.
عدّل CLAUDE.md مباشرة داخل AgentsRoom مع تلوين الصيغة والحفظ المباشر. لا حاجة للتبديل لمحرر نصوص أو بيئة تطوير.
شاهد كيف يفسّر كل وكيل CLAUDE.md في الوقت الفعلي. راقب مخرجات الطرفية للتحقق من أن الوكلاء يتبعون اصطلاحاتك ويحترمون مناطق التجنب.
كل مشروع في AgentsRoom له CLAUDE.md خاص. انتقل بين المشاريع وكل وكيل يحمّل تلقائياً ملف السياق المناسب لتلك القاعدة البرمجية.
أدوار الوكلاء الـ 14 في AgentsRoom تتقارن مباشرة مع أقسام CLAUDE.md. حدد مجالات تركيز ومناطق تجنب لكل دور، وكل وكيل يلتقط بالضبط التعليمات المخصصة له.
حمّل AgentsRoom واستخدم محرر CLAUDE.md المدمج لمنح وكلائك السياق الذي يحتاجونه. تعليمات أفضل، كود أفضل.
التطبيق المرافق: تابع وكلاءك أينما كنت
متوافق مع أي خطة Claude (Free، Pro، Max، Team، Enterprise)