يفتح مساعدك الذكي مستودعك لأول مرة. يمسح هيكل الملفات والمتعلقات، ربما ملف README. ثم يقترح تكوين جهاز توجيه يكسر نظام الرسم الحالي لديك، ويستورد حزمة أسقطتها قبل ثلاث فترات عمل، ويكتب اختبارات بأسلوب تخلت عنه فريقك السنة الماضية. المساعد ليس غبياً — إنه أعمى. Claude Code و Cursor و Copilot و Cody — كل شريك برمجي ذكي يصطدم بنفس الجدار: لا يمكنه قراءة سياق فريقك من السجلات الملتزمة وحدها. ملف CLAUDE.md واحد في جذر مشروعك يغير ذلك. إنه الفرق بين مساعد يحارب اتفاقياتك وبين واحد يوسعها مثل مطور أول قام بالشحن معك لأشهر. لكن معظم الفرق تكتب ملفات CLAUDE.md التي لا يمكن للذكاء الاصطناعي فعلاً استخدامها.

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

جدول المحتويات

ما هو CLAUDE.md ولماذا يهم

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

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

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

كيف يقرأ Claude Code سياق مشروعك

Claude Code لديها تسلسل محدد لتحميل السياق. فهم هذا مهم لأنه يؤثر على كيفية تنظيم ذاكرة مشروعك.

ترتيب تحميل السياق

  1. ~/.claude/CLAUDE.md — تفضيلاتك العامة (تطبق على كل مشروع)
  2. ./CLAUDE.md — ملف مستوى المشروع في جذر مستودعك
  3. ./subdirectory/CLAUDE.md — جوانب السياق المحددة للمجلد
  4. .claude/settings.json — صلاحيات الأدوات المحددة للمشروع والإعدادات
  5. سياق الجلسة — ما تخبر به Claude في المحادثة الحالية

ملف CLAUDE.md على مستوى المشروع هو حيث ستقضي معظم وقتك. الملف العام جيد للتفضيلات الشخصية ("أفضل المكونات الوظيفية" أو "استخدم دائماً الوضع الصارم TypeScript")، لكن القيمة الحقيقية تكون في السياق لكل مشروع.

إليك ما هو حاسم: يقرأ Claude Code CLAUDE.md في بداية كل جلسة، لكن لديه أيضاً مساحة نافذة سياق محدودة. إذا كان CLAUDE.md الخاص بك يحتوي على 5000 كلمة من التوثيق العشوائي، فإنك تحرق الرموز التي يمكن استخدامها للاستدلال الفعلي على الكود. كن موجزاً. كن محدداً. كل سطر يجب أن يكسب مكانه.

تشريح ملف CLAUDE.md الرائع

بعد كتابة وتحسين ملفات CLAUDE.md عبر العشرات من المشاريع — تطبيقات Next.js و Astro والمواقع وعمليات دمج CMS بلا رأس وخدمات API — وصلت إلى هيكل متسق يعمل.

الهيكل المثالي

# اسم المشروع

## نظرة عامة
فقرة واحدة توضح ما يفعله هذا المشروع ومن الفئة المستهدفة.

## مجموعة التقنيات
الإصدارات الدقيقة والأطر.

## العمارة
كيف تناسب القطع معاً.

## الاتفاقيات الرئيسية
معايير الترميز وأنماط الأسماء وقواعد تنظيم الملفات.

## الأوامر الشائعة
الإنشاء والاختبار والنشر وأوامر dev.

## السياق المهم
أشياء ليست واضحة من الكود.

## المشاكل المعروفة / المزالق
الألغام الأرضية التي يجب تجنبها.

## لا تفعل
أشياء صريحة لا يجب أن يفعلها الذكاء الاصطناعي.

لننقر في كل قسم.

تقسيم القسم إلى قسم

نظرة عامة

حافظ على هذا إلى جملتين إلى ثلاث جمل كحد أقصى. Claude لا يحتاج إلى خريطة الطريق للمنتج — يحتاج إلى فهم المجال حتى يتمكن من اتخاذ قرارات مناسبة السياق.

## نظرة عامة
هذا هو موقع التسويق لأكمي، وهي منصة SaaS B2B لإدارة سلسلة التوريد. يتم إنشاء الموقع بشكل ثابت مع المسارات الديناميكية للواجهة الخلفية للتعامل مع النماذج والتقاط الرصاص. يتم إدارة المحتوى من خلال Sanity CMS بواسطة فريق التسويق.

مجموعة التقنيات

كن دقيقاً. لا تقول فقط "React" — حدد الإصدار والإطار واستراتيجية العرض. يمنع هذا Claude من اقتراح الأنماط التي تعمل في React 18 ولكن تنكسر في React 19، أو التوصية بـ Pages Router عندما تكون على App Router.

## مجموعة التقنيات
- **الإطار**: Next.js 15.1 (App Router و RSC بشكل افتراضي)
- **اللغة**: TypeScript 5.7 (الوضع الصارم)
- **التنسيق**: Tailwind CSS v4 مع تكوين يركز على CSS
- **CMS**: Sanity v3 مع معاينة مباشرة
- **النشر**: Vercel (بيئات الإنتاج والمعاينة)
- **مدير الحزم**: pnpm 9.x
- **Node**: v22 LTS
- **الاختبار**: Vitest + Playwright
- **إدارة الحالة**: Zustand (الحد الأدنى، فقط لحالة واجهة المستخدم من جانب العميل)

العمارة

هذا هو المكان الذي يكتب فيه معظم الناس القليل جداً أو الكثير جداً. أنت لا تكتب وثيقة تصميم الأنظمة. أنت تعطي Claude نموذجاً عقلياً.

## العمارة
- `app/` — صفحات وتخطيطات App Router في Next.js
- `app/api/` — مسارات API (تقديم النماذج والخطافات)
- `components/` — مكونات واجهة المستخدم المشتركة (التصميم الذري: atoms/ و molecules/ و organisms/)
- `lib/` — وظائف الأدوات وعملاء API وتعريفات النوع
- `lib/sanity/` — عميل Sanity والاستعلامات (GROQ) وتوليد النوع
- `content/` — ملفات MDX لمشاركات المدونة (موضوعة بجانب المقدمة)
- `public/` — الأصول الثابتة (فضل next/image لجميع الصور)

تدفق البيانات: Sanity CMS → استعلامات GROQ في lib/sanity/queries.ts → مكونات الخادم → مكونات العميل (فقط عند الحاجة إلى التفاعلية)

يتم إنشاء جميع الصفحات بشكل ثابت في وقت الإنشاء باستثناء /blog/[slug]/preview الذي يستخدم وضع المسودة.

الاتفاقيات الرئيسية

هذا القسم يوفر معظم الوقت. بدونها، سيتبع Claude الممارسات الفضلى العامة التي قد تتعارض مع خيارات فريقك.

## الاتفاقيات الرئيسية
- المكونات مسماة PascalCase، مكون واحد في الملف
- استخدم التصديرات المسماة، لا تصديرات افتراضية (باستثناء الصفحات/التخطيطات)
- جميع جلب البيانات يحدث في مكونات الخادم — لا تستخدم useEffect أبداً لجلب البيانات
- أنواع استجابة API تعيش في lib/types/ ويتم إنشاؤها تلقائياً من مخطط Sanity
- استخدم الأداة `cn()` (lib/utils.ts) لدمج فئات شرطية، وليس الحرفيات القالبة
- حدود الخطأ تلتف حول كل قسم صفحة رئيسي، وليس الصفحة بأكملها
- يستخدم كل معالجة نموذج react-hook-form + مخططات التحقق من صحة zod
- رسائل الالتزام تتبع الالتزامات التقليدية (feat: و fix: و chore:)

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

هذا يبدو أساسياً، لكن Claude Code فعلاً يقوم بتشغيل هذه الأوامر. إذا لم يكن يعرف الأوامر الصحيحة، فسوف يخمن، وغالباً ما يخمن بشكل خاطئ.

## الأوامر الشائعة
- `pnpm dev` — خادم تطوير البداية (المنفذ 3000)
- `pnpm build` — إنشاء الإنتاج
- `pnpm lint` — فحص ESLint + Prettier
- `pnpm test` — تشغيل اختبارات Vitest الوحدة
- `pnpm test:e2e` — تشغيل اختبارات Playwright E2E
- `pnpm sanity:typegen` — إعادة إنشاء أنواع Sanity بعد تغييرات المخطط
- `pnpm db:migrate` — تشغيل هجرات Drizzle ORM

السياق المهم

هذا للأشياء التي لا يمكن لـ Claude معرفتها من قراءة الكود الخاص بك. منطق الأعمال والقيود الخارجية والأشياء التي ستستغرق مراجع بشري 30 دقيقة لشرحها.

## السياق المهم
- نستخدم ISR (revalidate: 3600) لجميع صفحات CMS. لا تستخدم `force-dynamic` أبداً إلا إذا كان ضروريا تماماً.
- خطاف Sanity في /api/revalidate يتعامل مع إعادة التحقق عند الطلب — لا تضيف منطق إعادة التحقق اليدوي.
- تحسين الصور يمر عبر CDN الخاص بـ Sanity (cdn.sanity.io)، وليس next/image لمحتوى CMS.
- يتم التعامل مع المصادقة بواسطة Clerk — لا تبني أبداً تدفقات مصادقة مخصصة.
- نقطة نهاية /api/leads لديها حد معدل عبر Upstash Redis. لا تزل وسيط الحد الأقصى للمعدل.

المزالق المعروفة

لكل مشروع أشياء غريبة. ضعها هنا حتى لا يتعثر Claude بها.

## المزالق المعروفة
- معرض النصوص المحمول الخاص بـ Sanity يحتوي على خلل في القوائم المتداخلة في v3.2. نستخدم محول مخصص في components/portable-text/list-fix.tsx
- لا يدعم Tailwind v4 التوجيه `@apply` في ملفات CSS الوحدة — استخدم الفئات المضمنة بدلاً من ذلك
- إعادة التوجيه vercel.json لـ /docs/* proxy إلى موقع Mintlify docs الخاص بنا. لا تعدل هذه دون التحقق مع الفريق.
- متغيرات البيئة ذات البادئة NEXT_PUBLIC_ هي الوحيدة المتاحة من جانب العميل. لا تعرض أبداً أسرار API بهذه الطريقة.

قسم "لا تفعل"

هذا يعتبر القسم الأكثر أهمية. التعليمات السلبية فعالة بشكل غير متناسب مع نماذج الذكاء الاصطناعي.

## لا تفعل
- لا تثبت متعلقات جديدة بدون السؤال أولاً
- لا تستخدم النوع `any` — ابحث عن أو أنشئ أنواعاً مناسبة
- لا تنشئ نقاط نهاية API جديدة للأشياء التي يمكن القيام بها في مكونات الخادم
- لا تعدل ملفات مخطط Sanity دون تأكيد خطة الهجرة
- لا تستخدم `"use client"` ما لم يحتاج المكون فعلاً إلى واجهات برمجية متصفح أو معالجات الأحداث
- لا تكتب ملفات CSS — كل شيء فئات أداة Tailwind
- لا تجعل الأوتار صلبة التي يجب أن تأتي من CMS

أمثلة CLAUDE.md الحقيقية

مثال: موقع تسويق Next.js

هذا نسخة مختصرة من CLAUDE.md التي نستخدمها في مشاريع العملاء، خاصة عند بناء مواقع Next.js مع خلفيات CMS بلا رأس.

# موقع Acme للتسويق

## نظرة عامة
موقع تسويق لـ Acme (acme.com). مبني بـ Next.js 15، منسق مع Tailwind v4، محتوى من Sanity CMS. الهدف: LCP أقل من ثانيتين على جميع الصفحات.

## مجموعة التقنيات
Next.js 15.1 | TypeScript 5.7 strict | Tailwind v4 | Sanity v3 | Vercel | pnpm

## العمارة
App Router مع RSC. جميع جلب البيانات في مكونات الخادم عبر استعلامات GROQ في lib/sanity/queries.ts. مكونات العميل فقط للعناصر التفاعلية (الطرائق و النماذج والرسوم المتحركة).

الصفحات: / (الصفحة الرئيسية) و /about و /pricing و /blog و /blog/[slug] و /contact

## الاتفاقيات
- تصديرات مسماة فقط (باستثناء page.tsx/layout.tsx)
- المكونات: PascalCase، واحد في الملف
- cn() لدمج الفئة
- مخططات Zod لجميع التحقق من صحة النموذج
- لا useEffect لجلب البيانات. أبداً.

## الأوامر
pnpm dev | pnpm build | pnpm lint | pnpm test

## لا تفعل
- أضف "use client" بدون تبرير
- ثبت الحزم بدون السؤال
- استخدم التصديرات الافتراضية للمكونات
- عدّل ملفات sanity/schema/ بدون تأكيد الهجرة
- استخدم أي نوع

مثال: موقع محتوى Astro

بالنسبة مشاريع Astro، يبدو CLAUDE.md مختلفاً قليلاً لأن نموذج العمارة مختلف.

# Tech Blog — Astro

## نظرة عامة
مدونة مطورين تضم أكثر من 500 مقالة. ثابت أولاً و بدون JS بشكل افتراضي. MDX للمحتوى مع المكونات المخصصة.

## مجموعة التقنيات
Astro 5.x | MDX | Tailwind v4 | نُشرت على Cloudflare Pages | Content Collections v2

## العمارة
src/content/ — مقالات MDX مع المقدمة المتحققة من Zod
src/components/ — مكونات Astro (بدون JS) وجزائر React (تفاعلية)
src/layouts/ — التخطيطات الأساسية
src/pages/ — التوجيه المستند إلى الملف

## القواعد الرئيسية
- القيمة الافتراضية على مكونات Astro (.astro). استخدم React فقط للجزائر التي تحتاج إلى تفاعل.
- client:visible للمكونات التفاعلية أسفل الطي
- client:idle للمكونات التفاعلية غير الحرجة
- لا تستخدم client:load إلا إذا كان ضروريا تماماً
- جميع الصور تستخدم مكون Astro Image مع عرض/ارتفاع مناسب
- تُنشئ خلاصة RSS تلقائياً من مجموعة المحتوى — لا تبني منطق الخلاصة اليدوي

## لا تفعل
- أضف مكونات React عندما يعمل مكون Astro
- استخدم التوجيه client:load
- تخطي أبعاد الصورة (يسبب CLS)
- عدّل مخطط مجموعة المحتوى دون تحديث المقدمة الموجودة

الأخطاء الشائعة التي تدمر سياق الذكاء الاصطناعي

لقد راجعت الكثير من ملفات CLAUDE.md في هذه النقطة. فيما يلي الأنماط التي تؤدي باستمرار إلى نتائج سيئة.

خطأ لماذا يضر الإصلاح
طويل جداً (أكثر من 2000 كلمة) يحرق رموز نافذة السياق و المعلومات الرئيسية تضيع ابق تحت 800 كلمة. اربط بالمستندات الخارجية للغطس العميق.
غامض جداً ("نستخدم React") يملأ Claude الفجوات بافتراضات كن محدداً: الإصدارات والأنماط والأدوات الدقيقة
لا توجد تعليمات سلبية يفعل Claude أشياء "معقولة" تنكسر اتفاقياتك أضف دائماً قسم "لا تفعل"
نسخ README.md الـ READMEs للبشر وليس لسياق الذكاء الاصطناعي اكتب CLAUDE.md من الصفر مع إطار عمل محدد للذكاء الاصطناعي
بما فيها البيانات الحساسة مفاتيح API و الأسرار في ملفات السياق لا تضع الأسرار في CLAUDE.md. مرجع .env.example بدلاً من ذلك
لا تحدثها أبداً المشروع يتطور و لا تتطور ملف السياق راجع CLAUDE.md في كل sprint أو إعادة صياغة رئيسية
تعليمات متناقضة "استخدم مكونات الخادم" + أمثلة مع جلب useEffect امتلك شخص واحد الملف و مراجعة للتناسق

CLAUDE.md مقابل ملفات سياق الذكاء الاصطناعي الأخرى

Claude Code ليست الأداة الوحيدة التي تقرأ ملفات سياق المشروع. إليك كيفية ظهور المناظر الطبيعية في 2026:

الملف الأداة القراءة التلقائية الدائرة
CLAUDE.md Claude Code نعم، في بداية الجلسة في جميع أنحاء المشروع
.cursorrules Cursor نعم، عند فتح الملف في جميع أنحاء المشروع
.github/copilot-instructions.md GitHub Copilot نعم، في Copilot Chat عبر المستودع
.windsurfrules Windsurf (Codeium) نعم في جميع أنحاء المشروع
AGENTS.md OpenAI Codex CLI نعم في جميع أنحاء المشروع
.ai/context.md اتفاقية مخصصة لا (مرجع يدوي) متغيرة

الخبر السار: معظم المحتوى قابل للنقل. إذا كتبت CLAUDE.md قوية، فإن تحويله إلى .cursorrules أو copilot-instructions.md يستغرق حوالي 5 دقائق. الهيكل والمعلومات متطابقان — فقط اسم الملف والتنسيق الطفيف مختلفان.

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

الأنماط المتقدمة للمشاريع الكبيرة

ملفات CLAUDE.md المتداخلة

بالنسبة monorepos أو قواعد الأكواد الكبيرة، يمكنك وضع ملفات CLAUDE.md في مجلدات فرعية. سيقرأ Claude Code الملف الأكثر تحديداً للمجلد الذي تعمل فيه.

project/
├── CLAUDE.md              # سياق المشروع العام
├── apps/
│   ├── web/
│   │   └── CLAUDE.md      # سياق تطبيق الويب المحدد
│   └── api/
│       └── CLAUDE.md      # سياق API المحدد
├── packages/
│   └── ui/
│       └── CLAUDE.md      # سياق نظام التصميم

يغطي ملف CLAUDE.md الجذر العمارة والاتفاقيات المشتركة. يضيف كل ملف متداخل تفاصيل محددة لتلك الحزمة.

السياق الديناميكي مع /compact

أمر /compact في Claude Code يلخص المحادثة الحالية ويحرر مساحة السياق. للجلسات الطويلة، وجدت نمطاً يعمل بشكل جيد:

  1. ابدأ مع تحميل CLAUDE.md تلقائياً
  2. العمل على ميزة
  3. تشغيل /compact عندما يصبح السياق ثقيلاً
  4. استمر — يحتفظ Claude بسياق CLAUDE.md بالإضافة إلى ملخص مضغوط

السياق المشترك بين الفريق مقابل السياق الشخصي

نحتفظ بـ CLAUDE.md في التحكم بالإصدار (يجب أن يتم الالتزام به). لكن المطورين الأفراد يستخدمون أيضاً ~/.claude/CLAUDE.md للتفضيلات الشخصية:

# التفضيلات الشخصية
- أفضل أسماء المتغيرات الحرة بدلاً من الاختصارات
- أظهر لي المنطق قبل كتابة الكود
- عند اقتراح التغييرات و أظهر الفارق الكامل للملف
- أستخدم VS Code مع مفاتيح ارتباط Vim (لا تقترح اختصارات محددة للـ IDE)

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

قياس التأثير

كيف تعرف أن CLAUDE.md الخاص بك يعمل؟ فيما يلي المقاييس التي نتابعها داخلياً:

  • دقة المحاولة الأولى: كم مرة يكون رد Claude الأول محتاجاً إلى تصحيحات صفرية؟ CLAUDE.md الجيد يحصل على هذا فوق 80%.
  • انتهاكات الاتفاقية: احسب عدد المرات التي ينتهك فيها Claude معايير الترميز الخاصة بك. يجب أن تميل نحو الصفر.
  • أسئلة السياق: إذا استمر Claude في السؤال "ما هو الإطار هذا؟" أو "هل يجب أن أستخدم App Router؟" فإن CLAUDE.md الخاص بك تفتقد المعلومات.
  • تكرار التراجع: كم مرة تضطر إلى رفض أو الرجوع عن تغييرات Claude. انخفاض أفضل.

أفادت فريق واحد في شركة ناشئة متوسطة الحجم بتقليل متوسط وقت المهام المدعومة بالذكاء الاصطناعي من 12 دقيقة إلى 4 دقائق بعد استثمار ساعة واحدة في CLAUDE.md الخاص بهم. هذا تحسن 3x من ملف واحد.

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

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

ما هو CLAUDE.md وأين يذهب؟ CLAUDE.md هو ملف markdown يوضع في جذر مستودع مشروعك. يقرأه Claude Code تلقائياً في بداية كل جلسة لفهم معمارة مشروعك والاتفاقيات والمكدس التقني والقيود. فكر فيه كمستند تكيف مكتوب خصيصاً لمساعد الترميز الذكي الخاص بك.

كم يجب أن يكون طول ملف CLAUDE.md؟ استهدف 300-800 كلمة. الملفات الأقصر تفتقد السياق الحرج و لكن أي شيء فوق 1000 كلمة يبدأ في تناول نافذة السياق — مساحة أفضل للاستخدام للاستدلال على الكود الفعلي. كن موجزاً وحدداً. كل جملة يجب أن تكسب مكانها. إذا كنت بحاجة إلى مزيد من العمق و ربط بالتوثيق الخارجي بدلاً من تضمينها.

هل يجب أن ألتزم بـ CLAUDE.md بالتحكم بالإصدار؟ قطعاً. يجب التعامل مع CLAUDE.md مثل أي توثيق مشروع آخر — مصدرة و مراجعة و محدثة. يستفيد فريقك بأكمله من سلوك AI متسق. التفضيلات الشخصية تذهب إلى ~/.claude/CLAUDE.md بدلاً من ذلك و التي تبقى محلية لجهاز كل مطور.

كيف يختلف CLAUDE.md عن .cursorrules؟ المحتوى متطابق تقريباً — كلاهما يوفر سياق المشروع لأداة ترميز ذكية. الفرق هو أي أداة تقرأها. CLAUDE.md مخصصة لـ Claude Code (أداة CLI الخاصة بـ Anthropic) و بينما .cursorrules مخصصة لـ Cursor IDE. إذا كنت تستخدم كلتا الأداتين و اجعل مصدراً واحداً للحقيقة ونسخه إلى كلا الملفات و اضبط أي تنسيق محدد للأداة.

ما هو أهم قسم في CLAUDE.md؟ قسم "لا تفعل". التعليمات السلبية فعالة بشكل غير متناسب مع نماذج الذكاء الاصطناعي. إخبار Claude بما يجب تجنبه — لا تستخدم أنواع any و لا تضيف "use client" بدون داع و لا تثبت الحزم الجديدة دون السؤال — يمنع الأخطاء الأكثر شيوعاً وإحباطاً. قائمة حظر جيدة توفر وقتاً أكثر من صفحات التعليمات الإيجابية.

هل يمكنني استخدام CLAUDE.md للمشاريع غير الكود؟ نعم. يعمل CLAUDE.md لأي مشروع تتفاعل فيه مع Claude Code. لقد رأيت ملفات فعالة لمستودعات التوثيق و مشاريع البنية الأساسية كرمز و حتى خطوط أنابيب تحليل البيانات. المبدأ هو نفسه: أعطِ Claude السياق الذي تحتاجه لاتخاذ قرارات جيدة حول مشروعك المحدد.

كم مرة يجب أن أحدث CLAUDE.md؟ راجعها في كل إعادة صياغة رئيسية وفي الحد الأدنى مرة واحدة لكل sprint. إذا قمت بترقية إصدار إطار عمل و تغيير تبعية رئيسية أو اعتمدت اتفاقية جديدة و حدّث الملف على الفور. السياق القديم أسوأ من عدم وجود سياق على الإطلاق لأنه يضلل الذكاء الاصطناعي فعلياً. بعض الفرق تضيف مراجعة CLAUDE.md إلى قائمة التحقق من PR الخاصة بهم لتغييرات البنية الأساسية.

هل يعمل CLAUDE.md مع Claude على الويب (claude.ai)؟ لا. CLAUDE.md محدد بقراءة Claude Code و أداة الترميز المستندة إلى CLI. إذا كنت تستخدم Claude من خلال واجهة الويب أو API و كنت بحاجة إلى لصق السياق يدوياً أو استخدام ميزة Projects لإرفاق ملف معرفة. التحميل التلقائي لـ Claude Code هو ما يجعل الملف قوياً جداً — احتكاك صفر و في كل جلسة.