يقرأ Claude Code ملف CLAUDE.md في بداية كل جلسة ليعرف كيف يُشغَّل المشروع ويُختبر. فإن ذكر الملف أمرًا لم يعد موجودًا بنى الوكيل عمله على معلومة خاطئة، وإن غاب الملف أو اكتفى بنصائح عامة عاد الوكيل إلى التخمين. وفي الحزمة أمران لذلك: الأول يكتب الملف من الأوامر الموجودة فعلًا في مستودعك، والثاني يقيّم ملفًا قائمًا ويتحقق من كل أمر يذكره.
الأمران يعملان داخل Claude Code وحده. أما القالبان والأمثلة فملفات Markdown عادية: يقرأ Codex ملف AGENTS.md، ويمكنك لصق القالب في تعليمات مشروع (Project) على claude.ai.
أمر الإنشاء: claude-md-new
- لا يستبدل CLAUDE.md أو AGENTS.md موجودًا في جذر المستودع، بل يقترح أمر المراجعة، إلا إذا طلبتَ إعادة الكتابة صراحةً.
- يفحص ملفات الإعداد مثل package.json وpyproject.toml وCargo.toml وgo.mod وMakefile، وملفات CI في
.github/workflows، ولا يكتب أمرًا لم يجده فيها أو في README. وإن غاب أمر الاختبار كتب ذلك بدل أن يخمّنه. - يستهدف ملفًا بين 30 و80 سطرًا، ثم يعرض ملخصًا من ثلاثة أسطر وما لم يستطع تحديده.
أمر المراجعة: claude-md-audit
يفتح ملفات الإعداد وCI ليتأكد أن كل أمر في ملف القواعد موجود، ويمنح درجة من 100 على ستة معايير: الأوامر (25)، وخريطة المستودع (20)، والأعراف غير البديهية (20)، وطريقة إثبات أن التعديل يعمل (15)، والإيجاز (10)، وحداثة المسارات والسكربتات (10). ويسلّم بعدها إصلاحات مرتبة من الأسوأ مع نص بديل جاهز للصق، وجدولًا بكل أمر في الملف وهل وُجد أم لا.
مثال: أمر اختبار لم يعد موجودًا
افترض أن ملف CLAUDE.md في مشروعك يذكر make test، وأن المشروع لم يعد فيه Makefile. تكتب في الجلسة /claude-md-kit:claude-md-audit، والمنتظر بحسب نص الأمر أن يظهر make test في الجدول على أنه غير موجود، وأن تنخفض درجة معيار الأوامر، وأن تضم الإصلاحات سطرًا بديلًا. وإن كان ملف القواعد خارج الجذر فاكتب مساره بعد الأمر.
القوالب والأمثلة المرفقة
- CLAUDE.starter.md: قالب بأقواس تملؤها بأوامر التشغيل والاختبار، والبنية، والأعراف، وما لا يُلمس، ومعه خمس قواعد ذهبية جاهزة.
- AGENTS.starter.md: الفكرة نفسها لمن يستخدم أكثر من أداة، مثل Cursor وCodex وCopilot.
- أربعة أمثلة مكتملة: لوحة SaaS بـ Next.js، وأداة سطر أوامر بـ Python مع uv وpytest، وخدمة Rust مع axum وsqlx، ووكيل يعمل دون إشراف بقواعد صارمة وذاكرة في ملف STATE.md وسقف للإنفاق.
- FIELD-GUIDE.md: سبع عادات لإدارة وكلاء البرمجة، يقيس عليها أمر المراجعة.
التشغيل
- فك ضغط الملف مع إبقاء الملفات المخفية، فتعريف الإضافة في المجلد
.claude-plugin. - من مجلد مشروعك شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بمسار فك الضغط الفعلي، والتحميل هنا للجلسة الحالية فقط. - استدعِ كل أمر باسمه الكامل:
/claude-md-kit:claude-md-newأو/claude-md-kit:claude-md-audit. - للقالب وحده انسخ CLAUDE.starter.md إلى جذر المستودع باسم CLAUDE.md، واملأ ما بين الأقواس المربعة.
ما يلزمك وحدود الحزمة
- يلزمك تثبيت Claude Code وتسجيل الدخول إليه، ويُحتسب استهلاك النموذج من حسابك.
- الأمران تعليمات يتبعها النموذج لا برنامج ثابت، فالدرجة تقدير منه تحتاج مراجعتك.
- لا يقيّد الأمران أدواتهما، فيعملان بصلاحيات جلستك، وأمر الإنشاء يكتب ملفًا في جذر المستودع.
- القوالب بالإنجليزية، والحزم المدفوعة المذكورة في README الأصلي ليست ضمن الملف.
أرفقتُ دليلًا عربيًا بخطوات التشغيل وفهرسًا بمسار كل أمر.
الترخيص: MIT. ألّفت Fabler Labs هذه الملفات ونشرتها في claude-md-templates، وأرفقتُ نسختها 1.0.0 دون تعديل.
