شرح CLAUDE.md:الملف الذي يمنع أخطاء الذكاء الاصطناعي

شرح CLAUDE.md: هو ملف نصي بسيط في جذر مشروعك تقرؤه أداة البرمجة بالذكاء الاصطناعي قبل كل رد — ويمنع نحو 90% من الأخطاء التي يرتكبها الذكاء الاصطناعي في كودك. إنه ليس كوداً. إنه كتاب القواعد: أنماط مشروعك، وثوابتك التي لا تقبل التفاوض، والأخطاء التي يجب ألا يكررها الذكاء الاصطناعي.

معظم من يبنون بالذكاء الاصطناعي لا يعلمون بوجوده. إليك ما هو، ولماذا يغيّر كل شيء، وماذا تضع في ملفك بالضبط.

شرح CLAUDE.md: تشبيه دليل الموظف

تخيّل أنك وظّفت مقاولاً لامعاً مصاباً بفقدان ذاكرة كامل بين الاجتماعات. كل صباح يصل وهو لا يعرف شيئاً عن طريقة عمل شركتك — معاييرك، ونظام أرشفتك، وقراراتك السابقة. كل صباح تشرح كل شيء من جديد، وكل صباح يرتكب الأخطاء نفسها حتى تفعل.

الآن تخيّل أنك سلّمته دليل موظف يعيد قراءته في بداية كل اجتماع. فجأة يحضر وهو يعرف قواعدك أصلاً.

هذا هو CLAUDE.md. تبدأ أدوات البرمجة بالذكاء الاصطناعي كل محادثة من الصفر — لا تتذكر تصحيحات الأمس. وCLAUDE.md هو الدليل الذي تقرؤه تلقائياً قبل الرد على أي شيء. فكّر فيه كدستور لقاعدة كودك: القواعد التي يجب أن يتبعها الذكاء الاصطناعي، والأنماط التي يجب أن يستخدمها، والأخطاء التي يجب ألا يرتكبها أبداً.

لماذا يكرر الذكاء الاصطناعي الأخطاء نفسها بدونه

إليك ما حدث لي. كنت أبني نظام مراجعة الطلبات لمنصتي — منطق تقييم معقد، وسير عمل متعدد الخطوات، وعشرات جداول قواعد البيانات. قلت لـ Claude: "ابنِ خدمة مراجعة الطلبات".

ولّد Claude كوداً. عمل. وكان خاطئاً من خمس نواحٍ:

• تجاهل البنية التي يتبعها كل جزء آخر من قاعدة كودي
• اخترع تعريفات بيانات لا تطابق قاعدة بياناتي الفعلية
• أضاف معالجة أخطاء تتعارض مع النظام الذي أملكه أصلاً
• استخدم مخرجات تصحيح سريعة وفوضوية بدل إعداد التسجيل عندي
• نسي تعدد المستأجرين — وسم العميل الذي يجب أن يكون على كل استعلام

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

الكتابThe Solopreneur Revolutionلويس غونسالفيس عن بناء مشروع رائد أعمال منفرد بالذكاء الاصطناعي دون ترك وظيفتك.احصل على الكتاب ←

ماذا يوضع في ملف CLAUDE.md

يضم CLAUDE.md الجيد سبعة أقسام. لا يتطلب أي منها كتابة كود — بل يتطلب بيان قرارات، وهو بالضبط عمل المعماري:

أقوى الأقسام هما الأخيران. الذكاء الاصطناعي آلة مطابقة أنماط: أرِه مثالاً حقيقياً واحداً لكود أُنجز بشكل صحيح فيحاكيه في كل مكان. أرِه الخطأ الدقيق الذي ارتكبه الأسبوع الماضي، موسوماً بـ"لا تفعل هذا أبداً"، فيختفي الخطأ.

ما الذي تغيّر بعد أن كتبت ملفي

الطلب نفسه — "ابنِ خدمة مراجعة الطلبات" — بعد إضافة CLAUDE.md. قرأ Claude القواعد أولاً، ثم ولّد كوداً اتبع بنيتي، وطابق قاعدة بياناتي تماماً، ووسم كل استعلام لتعدد المستأجرين، وعالج الأخطاء على طريقتي، ووضع كل ملف في مكانه الصحيح. من المحاولة الأولى. بلا أي تصحيح.

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

بدون الملف، توقّع نحو 30 دقيقة من الإصلاحات على كل ملف مولّد — الأنماط الخاطئة، وضمانات مفقودة، وملفات في غير مكانها. اضرب ذلك في مئات الملفات يصبح CLAUDE.md الفرق بين الإنجاز والغرق.

كيف تبدأ ملفك اليوم

لا تكتب تحفة. ابدأ بخمس قواعد — الأخطاء الخمسة التي يظل ذكاؤك الاصطناعي يرتكبها في مشروعك — إضافة إلى سطر واحد يصف ما تبنيه وحزمة تقنياتك. هذا كل شيء.

ثم عامله كوثيقة حية. في كل مرة يرتكب الذكاء الاصطناعي خطأً جديداً أضف قاعدة. وفي كل مرة يولّد شيئاً رائعاً انسخ ذلك الكود إلى قسم الأمثلة. النقطة المثالية هي 200–400 سطر: أقل من 100 سطر يعطي سياقاً قليلاً جداً، وأكثر من 500 يغرق فيه الذكاء الاصطناعي.

حد يستحق المعرفة: يحمل CLAUDE.md قواعدك العامة الصحيحة دائماً. وللميزات الكبيرة المنفردة ستريد أيضاً موجزاً خاصاً بالمهمة بالمتطلبات والسياق الدقيقين لتلك الميزة — وهذه أداة مختلفة، هي منهجية PRP، والاثنان يعملان معاً: دستور لكل يوم، ومخطط لكل بناء.

12 أسبوعاًمسيرتك في الشركات لم تكن الخطة أبداًقدّم طلبك إلى Solopreneur Accelerator.قدّم الآن ←

الأسئلة الشائعة

ما هو ملف CLAUDE.md؟

ملف markdown (نصي بسيط) في جذر مشروعك يقرؤه Claude Code قبل كل رد. يحتوي على قواعد مشروعك وأنماطه وحزمة تقنياته وأمثلة كود حقيقية وأنماطه المضادة — فيتبع الذكاء الاصطناعي معاييرك من المحاولة الأولى بدل إعادة تدريبه في كل محادثة.

هل أحتاج إلى معرفة البرمجة لكتابته؟

لا. يُكتب الملف بلغة بسيطة: ما هو المنتج، والقواعد التي يجب أن تسري دائماً، وما يجب ألا يحدث أبداً. أما في قسم الأمثلة فتلصق كوداً ولّده الذكاء الاصطناعي نفسه حين أصاب. بيان القرارات عمل المؤسس؛ وتنفيذها عمل الذكاء الاصطناعي.

ما الطول المناسب لملف CLAUDE.md؟

ابدأ بخمس قواعد اليوم. ونمِّه نحو 200–400 سطر — طويل بما يكفي لحمل أنماطك، وقصير بما يكفي ليستخدمه الذكاء الاصطناعي كله فعلاً. أقل من 100 سطر نحيل جداً؛ وما بعد 500 قلّم. راجعه أسبوعياً: أضف أنماطاً جديدة، واحذف القواعد القديمة.

هل يكفي CLAUDE.md وحده لبناء الميزات؟

يغطي القواعد العامة — الأخطاء التي ستتكرر لولاه في كل ملف. وللميزة المعقدة تريد أيضاً مواصفة خاصة بالمهمة بمتطلبات تلك الميزة وبياناتها وخطوات التحقق منها. تلك هي منهجية PRP؛ وCLAUDE.md مع PRP هو كيف تُبنى الميزات بشكل صحيح من المرور الأول.