أول CLAUDE.md لك

لعلّك لاحظت الآن أنك تكرّر بعض الأشياء. «هذا موقع plain HTML — من فضلك لا تضف framework.» «شغّله بـ npm start.» «لا تلمس messages.json — تلك رسائل حقيقية من نموذج التواصل.» تقولها، فيستمع Claude، وتُنجز عملك — ثم في الغد تفتح محادثة جديدة وتقولها كلّها من جديد.

هناك حلّ، وهو بسيط إلى حدّ يكاد يكون محرجًا.

ضع ملفًّا اسمه CLAUDE.md في مشروعك، فيقرأه Claude في بداية كل محادثة — تلقائيًّا، قبل أن تكتب كلمة واحدة.

إنه prompt تكتبه مرة واحدة بدلاً من إعادة كتابته في كل مرة.

ماذا يوضع فيه

أيّ شيء قد تجد نفسك تشرحه مرارًا وتكرارًا. الـ CLAUDE.md الجيّد للبداية يكون قصيرًا ومحدّدًا. إليك واحدًا للموقع الشخصي الذي تبنيه:

# CLAUDE.md

This is my personal website — plain HTML and CSS, no framework.

## Commands
- `npm start` — run the local site on port 3000

## Conventions
- Keep it plain HTML and CSS. No build step, no framework.
- Don't edit `messages.json` — those are real messages from the contact form.
- Prefer small, focused changes over big rewrites.

هذا كلّ شيء. لا سحر هنا. أنت ببساطة تدوّن الأشياء التي كنت ستقولها بصوتك، حتى لا تضطرّ إلى قولها مرّة أخرى.

إنه مجرّد markdown — وهذا ما يفوت الناس

يتوقّع الناس ملف config: مفاتيح، وقيم، وصيغة ما سيخطئون فيها. لا شيء من ذلك موجود.

CLAUDE.md هو لغة عربية بسيطة داخل ملف markdown. إنه ملاحظة لـ Claude، مكتوبة بالطريقة التي تكتب بها ملاحظة لزميل جديد في أول يوم له. إن كنت تستطيع كتابة قائمة مهامّ، فأنت تستطيع كتابة CLAUDE.md.

وهذا هو السبب الكامل في كونه أعلى الأشياء عائدًا في هذا المستوى: لا شيء لتتعلّمه سوى أنه موجود.

طريقتان لصنع واحد — كلتاهما تأخذان دقيقة

لست مضطرًّا لمغادرة التطبيق لفعل هذا. هناك مساران سهلان، ولا يتطلّب أيٌّ منهما أمرًا واحدًا.

الطريقة الكسولة — اطلب فحسب. افتح مشروعك في Claude Code Desktop واكتب هذا في المحادثة:

أنشئ ملف CLAUDE.md في أعلى هذا المشروع. إنه موقع شخصي مكتوب بـ plain HTML و
CSS، يُشغَّل بـ npm start. لاحظ أن messages.json يحوي رسائل حقيقية من نموذج
التواصل ويجب ألا يُعدَّل أبدًا.
Create a CLAUDE.md at the top of this project. It's a plain HTML and
CSS personal site, run with npm start. Note that messages.json holds
real contact-form messages and should never be edited.

يكتب Claude الملف ويعرض عليك الـ CLAUDE.md الجديد في عرض الفروق المرئي — لوحة القبول والرفض نفسها التي قابلتها حين يقترح Claude تغييرًا. اقرأه، وانقر اقبل، فيُحفظ. لقد صنعت أول CLAUDE.md لك دون أن تكتب مسارًا أو أمرًا.

الطريقة العملية — لوحة الملفات. تفضّل كتابته بنفسك؟ في لوحة الملفات داخل التطبيق (الشريط الجانبي الذي يسرد ملفات مشروعك)، أنشئ ملفًّا جديدًا باسم CLAUDE.md بالضبط في أعلى المشروع، اكتب ملاحظاتك فيه، واحفظ. الملف نفسه، والنتيجة نفسها — أنت فقط أنشأته مباشرةً بدلاً من أن تطلب من Claude أن يفعل ذلك.

في كلتا الحالتين، يكون فعل «إضافة CLAUDE.md» واحدًا: بضعة أسطر من اللغة البسيطة، في ملف واحد، في أعلى المشروع. الجزء السحري هو ما يحدث بعد ذلك — يقرأه Claude نيابةً عنك، تلقائيًّا، في بداية كل محادثة.

شاهد ذلك بنفسك: بعد حفظ الملف، ابدأ محادثة جديدة (محادثة جديدة، أو /clear) واسأل شيئًا لا يمكنه معرفته إلا من الملف، مثل «كيف أشغّل هذا المشروع؟» يجيبك Claude إجابة صحيحة دون أن تذكر CLAUDE.md على الإطلاق. تلك اللحظة — «مهلًا، لقد عرف ببساطة» — هي بيت القصيد. من الآن فصاعدًا، يرافق هذا السياق كل محادثة في المشروع، مجّانًا.

ما التالي

وضعت CLAUDE.md في المجلّد الأعلى من المشروع. لكن يتّضح أن هذا ليس سوى أحد ثلاثة أماكن يمكن أن يعيش فيها هذا الملف — والمكانان الآخران يفتحان أشياء لا يستطيع ملف المشروع فعلها. هذا هو التالي.