اصطدمت CLAUDE الخاصة بـ Karpathy بـ 126 ألف نجمة: ملخص 12 قاعدة متقدمة في إصدار المجتمع

في 13 أبريل/نيسان، أفاد موقع ABMedia بأن Forrest Chang قام بترتيب شكاوى Karpathy من كتابة الشيفرة عند Claude في يناير/كانون الثاني إلى «4 قواعد لـ CLAUDE.md»، وكان عدد النجوم على GitHub في ذلك الوقت قد بلغ 15,000 نجمة. في 12 مايو/أيار، تجاوز عدد النجوم في ذلك المستودع 126,000 نجمة، ونما 8 أضعاف خلال أقل من شهر واحد. تبع ذلك ظهور العديد من المحاولات «الموسّعة»، ومن بينها منشور المهندس Mnilax (الملقب بـ @Mnimiy) في 9 مايو/أيار، بعنوان «أضف 8 قواعد على الأساس المكوّن من 4 قواعد لتصبح النسخة الكاملة من 12 قاعدة»، والذي حصد 5,968 إعجاباً، وهو أحد أكثر المحتويات الفردية تداولا في نقاشات مجتمع Claude Code مؤخراً.

استعراض لقواعد الـ 4: Forrest Chang يحوّل شكاوى Karpathy إلى قوالب قابلة للتنفيذ

القواعد الأصلية الأربعة لـ Forrest Chang (كل قاعدة تقابل نمط الفشل الذي أشارت إليه Karpathy في يناير على X):

Think Before Coding（فكّر قبل أن تكتب）：لا تفترض افتراضات ضمنية؛ اذكر بوضوح ما الذي تفترضه؛ عند وجود trade-off اعرضها للنقاش؛ إن كنت غير متأكد فاسأل مباشرة، ولا تخمّن؛ إذا وُجدت طريقة أبسط، اعترض على الحلول المعقّدة

Simplicity First（الأولوية للبساطة）：اكتب أقل كمية من الشيفرة التي تحل المشكلة؛ لا تكتب وظائف تخمينية؛ ولا تنشئ طبقات تجريد لشفرة مرة واحدة؛ سيقول المهندسون ذوو الخبرة إن التصميم شديد التعقيد يجب تبسيطه

Surgical Changes（تغييرات جراحية）：غيّر ما يجب تغييره فقط، ولا «تحسّن» الكود المتاخم عن طريق الخطأ، ولا تكتب تعليقات أو تغيّر التنسيق بلا داعٍ؛ لا تعيد هيكلة الأشياء غير المعطوبة؛ التزم بالأسلوب الموجود مسبقاً

Goal-Driven Execution（تنفيذ موجه بالهدف）：حدّد معيار النجاح وكرّر حتى التحقق؛ لا تخبر Claude الخطوات، بل أخبرها «كيف يبدو النجاح» كي تقوم بالدوران بنفسها loop

توضح وثائق Anthropic الرسمية الحقيقة جلياً: ملف CLAUDE.md هو ملف «إرشادي» (advisory)، وغالباً ما يلتزم Claude به بنسبة تقارب 80%. بعد تجاوز 200 سطر، تنخفض نسبة الالتزام بسرعة كبيرة، لأن القواعد المهمة تُغرقها الضوضاء. خطة Forrest Chang تقوم على ضغط القواعد إلى 65 سطراً، 4 قواعد، لتصل إلى «floor» (الحد الأدنى).

الـ 8 قواعد التي أضافها Mnilax: استكمال أنماط الفشل الجديدة في عصر الـ agent في 2026/5

يرى Mnilax أن شكوى Karpathy في يناير/كانون الثاني كانت تتركز على سيناريو «كتابة Claude للشيفرة»، لكن بيئة Claude Code في مايو/أيار تطورت إلى تعاون عبر عدة agents، وربط hooks، وتعارضات تحميل المهارات، وسير عمل متعدد الخطوات يمتد عبر session—ما يستدعي إضافة قواعد. فيما يلي الـ 8 قواعد التي أضافها (مرتبة بحسب ترتيب النص الأصلي):

Rule 5：استخدم Claude فقط للمهام التي تتطلب اتخاذ قرار (التصنيف، الصياغة، التلخيص، الاستخراج)، أما القرارات الحتمية (إعادة المحاولة عند 503، التوجيه، التعامل مع status code، التحويلات الحتمية) فليتم التعامل معها عبر شيفرة عادية

Rule 6：ميزانية الرموز ليست مجرد اقتراح—حد أقصى 4,000 token لكل مهمة و30,000 token لكل session، وعند الاقتراب من الميزانية أعد التشغيل بملخص بشكل استباقي، ولا تتجاوزها بصمت

Rule 7：عند وجود نمطين شيفرة متعارضين، «حدّد أيهما سيتم اختياره» (الأحدث أو الأكثر وجوداً للاختبارات)، واشرح سبب اختيارك، وعلّم الآخر ليتم تنظيفه لاحقاً؛ مزج النمطين هو أسوأ خيار

Rule 8：قبل كتابة الشيفرة عليك فهم المسألة أولاً—اقرأ الملفات exports، ومن استدعِي مباشرة caller، والأدوات utility المشتركة؛ إن كانت العبارة «تبدو غير ذات صلة» (looks orthogonal) فهي على الأرجح أكثر صياغة خطرة؛ وإذا لم تكن متأكداً فاسأل

Rule 9：يجب أن تختبر الاختبارات «النية»، لا مجرد «السلوك»—اختبار يعتبر صالحاً إذا تمكن من الفشل عند تغيير منطق العمل؛ وإلا فهو مجرد جعل Claude واثقاً دون حماية فعلية

Rule 10：المهام متعددة الخطوات يجب أن يكون لها checkpoint—بعد كل خطوة لخص «ما الذي قمت به، وما الذي تحققت منه، وما الذي بقي»؛ إذا لم تستطع وصف الحالة بوضوح فلا تتابع

Rule 11：التزم بعادات قاعدة الكود الحالية حتى لو كنت لا توافق—snake_case تبقى snake_case، وclass component تبقى class component؛ إذا لم توافق اعتبر ذلك نقاشاً ثانوياً، ولا تتشعب منفرداً

Rule 12：اجعل الفشل مسموعاً—«اكتملت migration» غير صحيح إذا كنت تخطيت 30 ورقة، و«اجتازت الاختبارات» غير صحيح إذا تخطيت أي حالة واحدة؛ افترض «الكشف الاستباقي عن عدم اليقين»، ولا «تخفي عدم اليقين»

يزعم Mnilax أنه طبّق هذه 12 قاعدة عبر 30 قاعدة كود خلال 6 أسابيع، وأن معدل الخطأ انخفض من 41% إلى 3%، مع انخفاض طفيف فقط في نسبة الالتزام (78% → 76%). ملاحظات هذا الوسيط: هذه الأرقام هي نتائج اختبار معلنة ذاتياً من المؤلف ولم تُتحقق بشكل مستقل؛ لكن محتوى القواعد الـ 8 نفسها متين، ويتطابق مع نقاط الألم المقابلة لسيناريوهات استخدام Claude Code متعددة الوكلاء في الوقت الحالي (مثل إدارة الـ session متعددة داخل Agent View، وMulti-Agent Layer ضمن بنية من ست طبقات).

حالات تطبيق وتوصيات عملية

يُشير Mnilax بشكل مباشر إلى أشياء لا ينبغي تجربتها:

أكثر من 14 قاعدة: تنخفض نسبة الالتزام إلى 52% (من 76% هبوط حاد)، والحد الأقصى الفعلي يبلغ 200 سطر

استخدام الأمثلة بدل القواعد: تكلفة tokens لثلاثة أمثلة تساوي تكلفة 10 قواعد، وClaude يسهل عليه الإفراط في التكيّف مع مثال واحد فقط

تعليمات تجريدية مثل «Be careful / think hard / really focus»: قابلية التحقق منخفضة، ونسبة الالتزام لا تتجاوز 30% فقط

إخبار Claude أنه «مهندس معماري/كبير»: prompt لهوية (identity prompt) لا يغيّر السلوك عند تغيير الفعل، ولا تفيد سوى التعليمات القائمة على القواعد

الاعتماد على أدوات محددة: عبارة مثل «استخدم eslint دائماً» ستفشل بصمت إذا لم يكن eslint مثبتاً، ويُستبدل ذلك بصياغات محايدة القدرات مثل «الالتزام بالأسلوب الموجود في قاعدة الكود»

التبني العملي الذي يقترحه هذا الوسيط: اجعل CLAUDE.md «عقداً سلوكياً» لا قائمة أمنيات—يجب أن تجيب كل قاعدة عن «ما الخطأ المحدد الذي تمنعه هذه القاعدة». إذا لم تكن وظيفتك تتضمن pipeline متعدد الخطوات، فإن Rule 10 (checkpoint) ليست ذات صلة؛ وإذا كانت قاعدة الكود تحتوي بالفعل على lint يفرض أسلوباً واحداً، فإن Rule 11 (الالتزام بالعادات) تكون زائدة. بعد قراءة القواعد الـ 12، احتفظ بالنسخة التي تتوافق مع «المطبات التي اصطدت بها فعلياً»، ويمكن حذف الباقي.

من الأحداث التي يمكن تتبعها لاحقاً: ما إذا كانت Anthropic الرسمية ستقوم بنسخ قواعد CLAUDE.md وإضفاء طابع «مُقنّن» عليها (حالياً هي مجرد «advisory»)، وما إذا كان مستودع Forrest Chang سيدخل في القوالب الموصى بها رسمياً، وما إذا كان المجتمع سيطرح إصدارات مخصصة لمجالات محددة (الواجهة الأمامية/الخلفية/هندسة البيانات)، وما إذا كان تحديث إصدار نموذج Claude سيؤثر على نسبة الالتزام.

هذه المقالة تدفع CLAUDE.md الخاص بـ Karpathy نحو 126 ألف نجمة: تجميع قواعد متقدمة من 12 قاعدة بنسخة مجتمعية. ظهرت لأول مرة في ABMedia على شكل أخبار مرتبطة بالـ链新闻.