أول CLAUDE.md لك

لعلّك لاحظت الآن أنك تكرّر بعض الأشياء. «هذا المشروع يستخدم pnpm، لا npm.» «الـ dev server هو npm run dev.» «من فضلك لا تلمس مجلّد legacy/.» تقولها، فيستمع Claude، وتُنجز عملك — ثم في الغد تفتح محادثة جديدة وتقولها كلّها من جديد.

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

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

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

ماذا يوضع فيه

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

# CLAUDE.md

This is a recipe-sharing app. Astro frontend, small Node backend.

## Commands
- `npm run dev` — start the local server on port 4321
- `npm test` — run the tests
- `npm run build` — build for production

## Conventions
- Use pnpm, not npm.
- Don't edit anything in `legacy/` — it's being deleted next month.
- Prefer small, focused changes over big rewrites.

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

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

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

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

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

اصنع واحدًا الآن

لست بحاجة إلى مشروع حقيقي لتشعر كم أن الأمر بسيط. في الـ terminal التدريبي الذي تجلس فيه، أنت داخل تطبيق صغير اسمه taskly. اكتب CLAUDE.md فيه بأمر واحد:

echo "Use pnpm, not npm. The dev server is npm run dev." > CLAUDE.md

علامة > تأخذ ما كان echo سيطبعه وتسقطه في ملف بدلاً من طباعته على الشاشة — الـ redirect نفسه الذي قابلته في المستوى الأول. اقرأه من جديد لتثبت أنه موجود فعلًا:

cat CLAUDE.md

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

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

ما التالي

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