هذا الدليل مصمم ليكون مرجعاً داخلياً وتدريبياً لتحويل فريقك الهندسي من مجرد "كُتّاب للأكواد" إلى "مديرين لوكلاء الذكاء الاصطناعي" (AI Agents)، مما يفتح آفاقاً لمضاعفة الإنتاجية بمقدار 100 إلى 1000 مرة كما تمت مناقشته من قِبل خبراء وشركاء Y Combinator.
لاستخدام Claude Code بفعالية، يجب التخلي عن عادات هندسة البرمجيات التقليدية.
أنت مدير، ولست مبرمجاً: توقف عن قراءة كل سطر برمجي. وظيفتك هي تحديد البنية المعمارية، وتحديد السلوك المطلوب بدقة، ومراجعة نتائج الاختبارات، وإدارة الذكاء الاصطناعي لتنفيذ المهمة.
"قاعدة الـ 6 أشهر": لا تضيع وقتك في بناء هياكل معقدة أو واجهات مخصصة لإصلاح قصور النموذج الحالي. Anthropic تبني للنموذج الذي سيتوفر بعد 6 أشهر. إذا كان النموذج يعاني في قفزة منطقية معينة اليوم، فسيحلها التحديث الجذري القادم تلقائياً.
تقبّل الكود "الفضائي" (Alien Code): الذكاء الاصطناعي لا يكتب الكود كما يفعل البشر. إنه يتفوق في كتابة سياقات شديدة الكثافة وتعبيرات نمطية (RegEx) معقدة قد تكون "تعذيباً" للبشر. لا تجبر الذكاء الاصطناعي على كتابة كود بشري جمالي إذا كان كوده "الفضائي" أكثر أداءً ويجتاز الاختبارات.
ملف CLAUDE.md هو طريقتك لمنح Claude قواعد خاصة بمستودع الأكواد (Repository) الخاص بك. المبالغة في تعقيد هذا الملف هو السبب الأول لفشل Claude.
"منطقة الخطر 50%": إذا أصبح الملف طويلاً جداً واستهلك مساحة كبيرة من نافذة السياق، فسيتحول إلى قيد يُضعف ذكاء النموذج.
الحد الأدنى للمُوجّه: اجعله مختصراً للغاية. قم بتضمين آليات عمل الفريق المتكررة فقط. (مثال: "عند إنشاء طلب سحب PR، قم بتفعيل الدمج التلقائي وانشره في قناة Slack الخاصة بنا").
قاعدة "احذف وابدأ من جديد": عند بدء مشروع جديد أو إذا بدأ Claude بالتخبط، احذف ملف CLAUDE.md بالكامل. أضف التعليمات مرة أخرى واحدة تلو الأخرى فقط بعد أن يرتكب النموذج خطأً.
لا تحاول إخفاء مخرجات Claude خلف واجهة مستخدم رسومية نظيفة. الطرفية هي مساحة اللعب المطلقة لأنها تتيح لـ Claude استخدام الأدوات الأصلية (Bash, Git, نظام الملفات).
اقرأ التفاصيل (Verbosity): دع Claude "يعرض مسار عمله". مراقبة تنفيذه لعمليات البحث، وقراءة الملفات، ومواجهة الأخطاء تبني ثقتك في عمليته وتساعدك على ملاحظة انحرافه عن المسار.
للأخطاء المعقدة والمخيفة: استخدم وضع التخطيط. هذا يجبر Claude على البحث في الكود، وكتابة استنتاجاته، وتقديم حل خطوة بخطوة قبل تنفيذ أي أوامر مدمرة.
للتطوير السريع: تخطَّ وضع التخطيط. إذا كنت تعرف بالضبط ما يجب القيام به، أخبر Claude بالتنفيذ فوراً لتوفير الوقت. (ملاحظة: سيصبح وضع التخطيط قديماً مع تحسن النماذج).
إذا دخل Claude في دوامة وفشل في حل المشكلة، واستمررت في مطالبته بالمحاولة في نفس الجلسة، فإن نافذة السياق تتسمم بالمنطق الخاطئ.
لا تجادل الذكاء الاصطناعي: إذا فشل مرتين أو ثلاث، توقف.
بروتوكول "التلخيص وإعادة التشغيل":
توقف عن القيام بأعمال البنية التحتية و Git الروتينية يدوياً. استخدم Claude Code في:
أتمتة Git: "قم بدمج (Squash) آخر 5 التزامات (Commits)، واكتب رسالة وصفية بناءً على التغييرات، وارفعها إلى فرع جديد."
مهام الطرفية: دعه يكتب وينفذ أوامر Kubernetes، نصوص Bash، وتحديثات الحزم.
فحص الكود القديم: اطلب من Claude قراءة ملف قديم معقد وتتبع تاريخ git blame، وشرح السبب الذي دفع المؤلف الأصلي لكتابته بتلك الطريقة.
للمهام الضخمة (مثل بناء ميزة كاملة من الصفر)، لا تعتمد على أمر أو موجه واحد. يجب استخدام استراتيجية "سرب الوكلاء".
مدير المشروع ("Mama Claude"): افتح نافذة طرفية واحدة. زوده بالمواصفات الأساسية للمنتج. أخبر هذا الوكيل أنه "مدير المشروع".
إنشاء التذاكر (Tickets): اطلب من Mama Claude تقسيم المهام الكبيرة إلى تذاكر فردية قابلة للتنفيذ وإضافتها إلى أداة إدارة المشاريع (مثل Asana).
السرب ("Baby Claudes"): افتح عدة نوافذ طرفية جديدة. في كل نافذة، ابدأ جلسة Claude Code جديدة ونظيفة ("Baby Claudes"). اجعل Mama Claude يعين تذاكر محددة لكل وكيل صغير.
لماذا تنجح هذه الطريقة؟: يعمل الوكلاء الصغار بنوافذ سياق نظيفة تماماً، مما يتيح لهم تنفيذ مهام برمجية محددة بدقة دون تشتت بسبب المواصفات الكبيرة للمشروع بأكمله.
لا تقرأ السجلات يدوياً للبحث عن الأخطاء المعقدة (مثل تسرب الذاكرة).
بدلاً من قراءة (Heap Dump) بنفسك، أعطِ الملف لـ Claude وقل له: "لدي تسريب في الذاكرة. اقرأ هذا الملف."
دع Claude يبني أدواته الخاصة: إذا كان الملف ضخماً أو معقداً، أخبر Claude بصراحة: "اكتب نص Python/Bash مخصص لتحليل هذا الملف، قم بتشغيله، وأخبرني أين يقع التسريب."
نماذج الذكاء الاصطناعي موجهة نحو الأهداف بشدة.
قبل جعل Claude يكتب كود الميزة، دعه (أو اكتب بنفسك) مجموعة صارمة من اختبارات الوحدة (Unit Tests).
استخدم الاختبارات كأداة تقييم للذكاء الاصطناعي. قل لـ Claude: "استمر في تعديل الكود حتى تنجح جميع هذه الاختبارات."
عند اختيار أدوات أو قواعد بيانات أو واجهات برمجية، يجب أن تختار أدوات تفهمها نماذج اللغة الكبيرة (LLMs) جيداً بالفعل.
تأثير Supabase: يُنصح بأدوات مثل Supabase لأن توثيقاتها مفتوحة المصدر ونظيفة جداً ويسهل استيعابها.
سيكتب Claude Code كوداً أفضل وأسرع وبأخطاء أقل إذا استخدمت أدوات تمتلك "LLM SEO" عالٍ (أي أن النموذج تم تدريبه بشكل مكثف على توثيقاتها الممتازة). إذا اخترت أداة نادرة بتوثيق ضعيف، سيعاني Claude وقد يبدأ في الهلوسة.
المصادر المرجعية (YouTube):