SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-10-26

لماذا يتجاهل وكيل البرمجة تعليماتك؟

إذا قال ملف التعليمات «توقّف» واستمر الوكيل، تعرّف إلى الأسباب الأربعة، وافحص نافذة السياق والـharness قبل إعادة صياغة القاعدة.

لماذا تتجاهل وكلاء البرمجة تعليماتك

يتجاهل وكلاء البرمجة تعليماتك لأربعة أسباب، ولا يكمن أيٌّ منها في أنك كنت مهذباً أكثر من اللازم. قد لا تكون القاعدة موجودة أصلاً في نافذة السياق. أو قد تكون غامضة بدرجة تمنع التحقق من الإجراء في ضوئها. وقد يتعارض معها شيء آخر في السياق، وغالباً ما يكون ذلك هو الشيفرة التي قرأها الوكيل للتو. أو قد تظل القاعدة محمّلة، لكنها تكون بعيدة خلف الدور الحالي، فيعمل الوكيل اعتماداً على ما هو قريب منه.

لكل سبب إصلاحه الخاص، ولذلك تتمثل المهمة الأولى في التمييز بينها. استخدام الأحرف الكبيرة وكلمة IMPORTANT لا يقدّم تشخيصاً. تستخدم الآليات أدناه Claude Code مثالاً تطبيقياً، لأن سلوك التحميل والضغط فيه موثّق بالتفصيل حتى October 2026. وتختلف الأدوات الأخرى في التفاصيل، لكنها تتصرف بالطريقة نفسها عموماً.

لنوضّح مصطلحين أولاً. نافذة السياق هي كتلة النص التي يراها النموذج في دور معيّن: system prompt، وملفات التعليمات الخاصة بك، والمحادثة، وكل ملف قرأه الوكيل. أما harness فهو البرنامج المحيط بالنموذج، أي البرنامج الذي يقرأ الملفات من القرص ويجمع تلك الكتلة. وتقريباً، كل شكوى في هذا المنشور هي في الواقع شكوى من harness، لا من النموذج.

ملف التعليمات رسالة وليس إعداداً

ملف التعليمات ليس ملف إعدادات. لا يقرأ أي مكوّن في وقت التشغيل CLAUDE.md ويفرضه. يقرأ الـharness الملف من القرص ويلصق النص في المحادثة. في Claude Code، يُرسل هذا المحتوى في رسالة مستخدم توضع بعد system prompt، ولذلك يرى النموذج قواعدك بالطريقة نفسها التي يرى بها أي نص آخر كتبته.

ينتج عن ذلك أثر غير مريح. تتنافس قواعدك مع كل جزء آخر من النص في نافذة السياق على قدم المساواة. القاعدة ادعاء. أما الملف الذي فتحه الـagent للتو فهو دليل. عندما يتعارضان، يفوز الدليل غالباً، ولا يظهر أي خطأ لأن شيئاً لم يجرِ بشكل خاطئ من وجهة نظر النموذج.

توضح الوثائق الرسمية ذلك صراحةً: تُعامل ملفات التعليمات كسياق، ولا تُفرض بوصفها إعدادات. لمنع إجراء ما بغض النظر عما يقرره النموذج، تحتاج إلى hook، لا إلى جملة. احتفظ بهذه الفكرة. معظم الإصلاحات في نهاية هذا المنشور هي تطبيق لهذه الفكرة على حالة محددة.

ما ملفات التعليمات التي تُحمَّل، ومتى؟

يصعد Claude Code عبر شجرة الأدلة بدءاً من الدليل الذي شغّلته فيه. تُحمَّل كل ملفات CLAUDE.md وCLAUDE.local.md من جذر نظام الملفات وصولاً إلى دليل العمل بالكامل عند بدء التشغيل. وتُدمج هذه الملفات بهذا الترتيب، لذلك يُقرأ الملف الأقرب إلى الدليل الذي شغّلت فيه Claude Code أخيراً. وداخل الدليل نفسه، يُلحَق ملف .local بالملف الرئيسي.

تتصرف الملفات الموجودة في الأدلة الفرعية أسفل دليل العمل بطريقة مختلفة. فهي لا تُحمَّل عند بدء التشغيل. بل تُحمَّل عندما يقرأ الوكيل ملفاً موجوداً في ذلك الدليل. وينطبق الأمر نفسه على القواعد المقيّدة بمسار في .claude/rules/ التي تحتوي على حقل frontmatter هو paths:: تدخل هذه القواعد إلى السياق عند قراءة ملف مطابق، وليس في كل دورة. وبدءاً من الإصدار v2.1.309، تخضع الملفات التي تُحمَّل بهذه الطريقة أيضاً لحد أقصى لحجم كل ملف، وهو 40,000 حرف عند استخدام نافذة سياق بحجم 200K. لذلك لا يتلقى الوكيل إلا بداية الملف الأطول، وقد لا تصل القواعد الموجودة قرب نهاية ملف متداخل كبير إلى السياق.

يفسّر هذا الاختلاف نسبة كبيرة من حالات الفشل المُبلّغ عنها. تضع قاعدة في packages/api/CLAUDE.md، ثم تطرح سؤالاً عن API، فيجيب الوكيل من دون أن يفتح أي ملف داخل packages/api/. لم تُهمَل القاعدة، بل لم تكن موجودة في السياق أصلاً. إذا كان مستودعك يوزّع الإرشادات على ملفات تعليمات لكل حزمة في monorepo، فتحقق من ذلك أولاً في كل مرة.

تؤثر مشكلة تحميل أخرى في المستودعات التي اعتمدت معيارياً على AGENTS.md. منذ الإصدار v2.1.277، يقرأ Claude Code ملف AGENTS.md باعتباره تعليمات مشروعك تلقائياً، ولكن فقط عندما لا يوجد CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في دليل العمل أو أي دليل أعلى منه. ولا يُحتسب ملف ~/.claude/CLAUDE.md الشخصي ضمن ذلك. إذا أضفت أي واحد من هذه الملفات، حتى ملف CLAUDE.local.md للملاحظات الشخصية، فسيقرأ Claude Code ملفات CLAUDE.md بدلاً منها، ويستبعد AGENTS.md بالكامل. لتحميل الملفين معاً، عيّن تعليمات المشروع إلى claude-md-and-agents-md في /config. في الإصدارات الأقدم من v2.1.277، أو عندما تريد الاحتفاظ بملف CLAUDE.md، استخدم ملف CLAUDE.md يكون سطره الأول @AGENTS.md. يستورد هذا السطر الملف عند بدء التشغيل، ويمكنك وضع أي ملاحظات خاصة بـClaude تحته. ويعمل الرابط الرمزي أيضاً عندما لا يكون لديك شيء إضافي تريد إضافته. أما تحديد ما ينتمي إلى هذا الملف من الأساس فهو سؤال منفصل، وتتناوله تجزئة تعليمات الوكيل عن توثيق البشر.

تحقّق من تحميل الملف قبل إعادة صياغته

لا تغيّر الصياغة قبل أن تتأكد من أن الوكيل يستطيع رؤية الملف. هناك فحصان، ويأتي الفحص الأبسط أولاً.

شغّل /context داخل الجلسة. يعرض هذا الأمر النافذة الحالية مقسّمة حسب الفئة، وتسرد قائمة ملفات الذاكرة كل ملف تعليمات تم تحميله عند بدء التشغيل. إذا لم يظهر ملف في هذه القائمة، فهذا يعني أنه لم يُحمّل عند بدء التشغيل، ولذلك لا يمكن لأي شيء تكتبه داخله أن يؤثر ما لم يُحمَّل الملف بطريقة أخرى. لا يظهر الملف المتداخل في دليل فرعي هناك لأنه يُحمّل عند الطلب؛ وعند تحميله، يظهر سطر Loaded يتضمن مساره في الطرفية. يعرض /memory مواقع الملفات ويفتحها للتحرير، بما في ذلك الملفات التي لم تُنشأ بعد.

للحصول على إجابة أكثر دقة، سجّل عمليات التحميل. يعمل حدث الخطاف InstructionsLoaded في كل مرة يدخل فيها CLAUDE.md أو ملف قواعد إلى السياق، ويبيّن المطابق سبب حدوث التحميل: session_start أو nested_traversal أو path_glob_match أو include أو compact. أضف ما يلي إلى .claude/settings.json:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

يتلقى الخطاف بياناته بصيغة JSON عبر الإدخال القياسي، لذلك يضيف cat السجل كاملاً. راقبه باستخدام tail -f /tmp/instructions-loaded.log أثناء العمل. يتم تجاهل حالة الخروج لهذا الحدث، ولذلك لا يستطيع الخطاف سوى المراقبة ولا يمكنه حظر العملية. إذا لم يظهر ملفك المتداخل مطلقاً في هذا السجل أثناء جلسة توقعت فيها تحميله، فتوقف عن إعادة الصياغة. المشكلة في موضع الملف. الاستثناء الوحيد هو AGENTS.md الذي يقرأه Claude Code مباشرة؛ فهذا لا يشغّل الحدث، ولذلك ابحث عن مساره في /memory بدلاً من ذلك. أما AGENTS.md المستورد من CLAUDE.md فيشغّل الحدث كالمعتاد.

ماذا تفعل الجلسة الطويلة بقواعدك

ينطبق تأثيران منفصلان هنا، ويحتاج كل منهما إلى استجابة مختلفة.

البُعد. إلى أن يحدث الضغط، تظل القاعدة التي ذكرتها في الدور 1 موجودة في نافذة السياق عند الدور 90، لكنها تنافس الآن 90 دوراً من النص الأحدث والأكثر تحديداً لما تفعله حالياً. بعد حدوث الضغط، قد لا تكون القاعدة التي كتبتها في المحادثة موجودة في النافذة إطلاقاً. تحذّر وثائق Claude Code نفسها من احتمال فقدان التعليمات الواردة في بداية المحادثة، وهذا هو التأثير الثاني أدناه. لا يمكنك تعطيل تأثير البُعد بالإعدادات، لكن يمكنك قياسه. نفّذ المهمة نفسها في جلسة جديدة. إذا التزمت القاعدة هناك وفشل الالتزام بها بعد التعمق في جلسة طويلة، فالبُعد أو الضغط هو السبب.

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

رتّب تعليماتك وفقاً لذلك الجدول، وسيتضح ترتيب الهشاشة. القاعدة التي كتبتها في المحادثة فقط هي أكثر عناصر الجلسة هشاشة؛ إذ لا تستمر إلا إذا احتفظ بها الملخص مصادفةً. تليها القاعدة الموجودة في packages/api/CLAUDE.md، لأنها حُمّلت مرة واحدة ثم أزيلت بالملخص، ولا تعود إلا عند القراءة التالية في ذلك الدليل. أما القاعدة الموجودة في ملف جذر المشروع فهي الأكثر دواماً، لأنها تُقرأ من القرص مرة أخرى في كل مرة.

لذلك، إذا كان يجب أن تظل التعليمات سارية طوال الجلسة، فضعها في ملف جذر المشروع من دون واجهة أمامية paths:. وكل ما عدا ذلك هو مفاضلة ينبغي أن تختارها عن قصد. يشرح إدارة ما يبقى في نافذة السياق /compact باستخدام حجة التركيز، و/clear بين المهام غير المرتبطة، وهذان العاملان يغيران عدد المرات التي يقرر فيها الملخّص ما كانت قواعدك.

لماذا يتغلب الكود المحيط على القاعدة

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

تصف القاعدة تفضيلاً. أما الكود فيعرض مثالاً على تطبيقه. عندما يفتح الوكيل ثلاثة ملفات في الوحدة التي يستعد لتعديلها، وتستدعي الملفات الثلاثة ORM مباشرة، فسيجد في السياق جملة تجريدية واحدة في جانب، وثلاثة أمثلة ملموسة وحديثة ومطابقة للمهمة في الجانب الآخر. يكون نسخ النمط المحلي هو السلوك الصحيح عادةً. لكنه خاطئ هنا فقط لأنك تعرف شيئاً لا يعرفه السياق: هذه الملفات قديمة.

لذلك، اكتب هذه المعلومة في القاعدة. تصمد القواعد التي تذكر الأدلة المضادة لها عند التعامل مع مستودع حقيقي. أما القواعد التي تذكر تفضيلاً مجرداً فلا تصمد.

يمر الوصول الجديد إلى قاعدة البيانات عبر app/repositories/. ما زالت الملفات ضمن app/legacy/ تستدعي ORM مباشرةً. هذا كود قديم، وليس النمط المعتمد. لا تنسخه.

الجملة الثانية هي التي تؤدي العمل. فهي تخبر الوكيل بما سيجده وكيف يفسّره قبل أن يعثر عليه. وينطبق الإصلاح نفسه على أي قاعدة يناقضها مستودعك بوضوح: أسلوب كتابة commits لا يتبعه سجلّك، أو تنظيم اختبارات يتجاهله نصف مجموعة الاختبارات، أو اصطلاح imports ينطبق على الكود الجديد فقط. عندما يخالف الكود ما يرد في الملف، اذكر هذا الخلاف في الملف.

القاعدة الغامضة لا يمكن التحقق منها، ولذلك لا يمكن اتباعها

"اكتب تعليمات برمجية نظيفة." "لا تبالغ في هندسة الحل." "اجعل الحل بسيطاً." "توخَّ الحذر عند تنفيذ عمليات الترحيل." لا يمكن اختبار أي من هذه العبارات مقابل إجراء محدد، سواء من قِبل الوكيل أو من قِبلك. عندما تُعطى الوكيل قاعدة لا يستطيع التحقق منها مقابل مخرجاته، فإنه يخمّن، وأنت تقيّم التخمين بالانطباع.

طبّق الاختبار التالي على كل سطر في ملفك. اكتب أمر shell ينتهي بحالة غير صفرية عند مخالفة القاعدة. إذا لم تتمكن من كتابة هذا الأمر، فالقاعدة غير قابلة للتحقق. قارن بين الأزواج التالية:

  • غير قابلة للتحقق: "اجعل الدوال صغيرة." قابلة للتحقق: "تحتاج الدالة التي يزيد طولها عن 60 سطراً إلى تعليق فوقها يشرح السبب."
  • غير قابلة للتحقق: "اختبر تغييراتك." قابلة للتحقق: "شغّل npm test والصق عدد حالات الفشل قبل اعتبار المهمة مكتملة."
  • غير قابلة للتحقق: "نظّم الملفات." قابلة للتحقق: "توجد معالجات HTTP في src/api/handlers/. لا يوضع أي شيء آخر في ذلك الدليل."
  • غير قابلة للتحقق: "نسّق التعليمات البرمجية بطريقة صحيحة." قابلة للتحقق: "استخدم مسافة بادئة بمقدار مسافتين في ملفات .ts."

"لا تبالغ في هندسة الحل" هي أول قاعدة يتخلى عنها الناس عادةً، لأن إصلاحها لا يتمثل في صياغة أقصر، بل في صياغة أطول: توضيح ما يعنيه فعلياً أصغر تغيير ناجح يمنح الوكيل معايير يستطيع مقارنتها بالتغييرات التي أجراها بنفسه.

الحجم هو المشكلة نفسها في صورة مختلفة. تستهدف إرشادات Claude Code ملفات التعليمات التي يقل طولها عن 200 سطر، وتذكر مباشرةً أن الملفات الأطول تقلل الالتزام. الملف الذي يتكون من 700 سطر ليس تعليمات أكثر حزماً. بل هو 700 سطر من الادعاءات التي تزيد معها فرص التناقض، كما تُحتسب ضمن نافذة السياق في كل دور، وهو ما يظهر مباشرةً في استخدامك للرموز المميزة. تنظيم الملف بحيث توضع كل قاعدة تحت عنوان يمكن للقارئ استعراضه مشمول في كتابة ملف تعليمات يستطيع الوكيل تنفيذه. والأفضل من ذلك حذف الأجزاء التي تصف بدلاً من أن توجّه: فالجولة التعريفية في الدليل التي توضّح أماكن معالجات الطلبات والنماذج هي بنية يستطيع الوكيل البحث عنها عند الحاجة من خلال خريطة محللة للمستودع، بدلاً من إبقائها في نافذة السياق في كل دور.

كيفية تشخيص المشكلة خلال عشر دقائق

نفّذ هذه الخطوات بالترتيب. يؤدي الانتقال مباشرة إلى الخطوة الأخيرة إلى إنشاء ملف طويل من القواعد المكتوبة بنبرة حادة، مع أن المشكلة لا تُحل.

  1. تأكد من تحميل الملف. نفّذ /context واقرأ قائمة Memory files، أو ابحث عن السطر Loaded في الطرفية إذا كان الملف متداخلاً. إذا لم يكن الملف موجوداً، أصلح الموقع وتوقف. لا تنطبق أي خطوة أخرى في هذه القائمة بعد.
  2. أعد إنتاج المشكلة في جلسة جديدة. ابدأ جلسة جديدة ونفّذ أصغر مهمة يُفترض أن تؤدي إلى تطبيق القاعدة. إذا نجحت القاعدة هنا وفشلت في جلسة طويلة، فالمشكلة تشير إلى طول السياق أو إلى عملية الضغط. وإذا فشلت هنا أيضاً، فالمشكلة في القاعدة نفسها.
  3. أزل المنافسة. اطلب التغيير نفسه في مجلد تتبع شفرته الحالية القاعدة بالفعل. إذا عاد الالتزام بالقاعدة، فهذا يعني أن الشفرة المحيطة كانت تتغلب على عبارتك.
  4. ابحث عن تعارض. وجود ملفين يقدمان إرشادات مختلفة للسلوك نفسه هو فشل موثق. قد يختار النموذج أحدهما عشوائياً، ولن يخبرك بأنه فعل ذلك.
  5. اجعل التحقق ممكناً ثم أعد الاختبار. أعد كتابة القاعدة باستخدام مسار محدد وشرط واضح. إذا ارتفع مستوى الالتزام بها كثيراً، فكانت صياغتها سبب المشكلة.

الخطوة 4 عبارة عن أمر واحد. ابحث في كل مصادر التعليمات عن الموضوع، وليس في الملف الذي كنت تعدّله فقط:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

وجود نتائج في ملفين يقدمان توجيهات مختلفة هو سبب المشكلة. احذف أحدهما. لا تحاول ترتيب أولوية هذه الملفات باستخدام صياغة أقوى، لأنه لا يوجد محرك لترتيبها يمكنك الرجوع إليه. في Claude Code v2.1.283 أو الإصدارات الأحدث، ينفّذ /doctor prompt-audit نسخة أوسع من هذا البحث عبر ملفات التعليمات والقواعد والمهارات، ويعرض التعارضات مع تعديلات مقترحة دون تغيير أي شيء إلى أن تطلب منه ذلك.

الإصلاحات مرتبة حسب قوة تأثيرها

تمنحك كل خطوة أدناه تأثيراً أكبر من الخطوة السابقة، لكنها تتطلب جهداً أكبر للإعداد. ابدأ من الأعلى عندما يكون من السهل إعادة صياغة القاعدة. انتقل إلى الأسفل فورما تصبح القاعدة مهمة إلى حد لا يسمح بتكرار تجاهلها أحياناً.

  1. اجعل القاعدة محددة. اذكر مساراً أو أمراً أو شرطاً. أضف الأدلة المخالفة التي سيجدها الوكيل في المستودع، كما هو موضح سابقاً. لا تكلف هذه الخطوة شيئاً، وتعالج نسبة مفاجئة من الحالات.
  2. قرّب القاعدة من الشيء الذي تحكمه. استخدم CLAUDE.md متداخلاً، أو قاعدة محددة النطاق لمسار في .claude/rules/، أو تعليقاً في أعلى الملف نفسه. عندئذ تُقرأ القاعدة مع الشيفرة التي تنطبق عليها. اقبل المقابل: أي محتوى يُحمّل بهذه الطريقة يختفي عند عملية الضغط التالية ويعود عند القراءة المطابقة التالية.
  3. انقل التنفيذ إلى hook. يطلب النص النثري. أما hook فيحسم القرار. تعمل hooks كشيفرة عند أحداث دورة حياة محددة، وتُطبَّق بصرف النظر عن استنتاج النموذج.
  4. سلّم القاعدة إلى أداة حتمية واحذف النص النثري. مثل التنسيق، وترتيب الاستيرادات، وطول الأسطر، والاستيرادات المحظورة، وبنية رسالة commit. استخدم ruff format أو prettier --write أو eslint أو hook من نوع pre-commit. يكون formatter صحيحاً في كل مرة ولا يستهلك أي tokens. أما الجملة فتكون صحيحة في معظم الأوقات، وتستهلك tokens في كل دور.

الخطوة 3 بالتفصيل. افترض أن ملفات migration يجب ألا يعدّلها الوكيل مطلقاً. ضع ما يلي في .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

وضع ما يلي في .claude/hooks/guard-migrations.sh:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

شغّل chmod +x .claude/hooks/guard-migrations.sh، ثم ابدأ جلسة جديدة واطلب من الوكيل تعديل ملف ضمن migrations/. سيُرفض التعديل، وستعود رسالتك مع سبب الرفض. تؤدي حالة الخروج 2 في PreToolUse إلى حظر استدعاء الأداة قبل تشغيله، وتُسلَّم رسالة stderr إلى النموذج بوصفها رسالة الحظر. يحل ${CLAUDE_PROJECT_DIR} إلى جذر المشروع، لذلك يعمل hook بصرف النظر عن الدليل الذي يوجد فيه الوكيل. لا يحتاج الوكيل إلى الموافقة على القاعدة أو تذكّرها أو إبقائها ضمن السياق. لا يحدث التعديل.

بالنسبة إلى حظر مباشر لا يتضمن أي منطق، تؤدي permissions.deny في إعداداتك المهمة نفسها من دون script يجب صيانته، كما أن أوضاع الأذونات تحدد ما الذي يعمل من دون أن تطلب موافقتك أولاً. إذا كان يجب أن توجد التعليمات فعلاً على مستوى system prompt بدلاً من رسالة مستخدم، يضعها --append-system-prompt هناك، لكنه launch flag يجب تمريره مجدداً في كل جلسة جديدة، ولذلك يناسب scripts أكثر من العمل التفاعلي.

ما لا يمكنك معالجته بالتعليمات

كن واضحاً بشأن الجزء الواقع ضمن مسؤوليتك. الموضع، والصياغة، والتعارضات بين الملفات، وحجم الملف مشكلات تخص المؤلف، ولها إصلاحات يجريها المؤلف. أما الباقي فهو سلوك النموذج، ولن تزيله الصياغة الأفضل.

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

بعض العادات مستمرة. مثل إضافة التعليقات، وإضافة معالجة دفاعية للأخطاء، وكتابة ملخص ختامي، وتشغيل الأمر التالي الواضح. تعود هذه العادات عند وجود قاعدة تمنعها، ولكن بمعدل أقل لا يساوي صفراً. يمكنك قياس معدلك: نفّذ المهمة نفسها 10 مرات في جلسات جديدة، ثم احسب المخالفات. عندما يجب أن يكون هذا العدد صفراً، يجب أن تخرج القاعدة من المطالبة. إن إعلان انتهاء المهمة بينما لا يزال جزء منها غير مكتمل هو النمط نفسه من العادات، وإصلاحه بنيوي لا لفظي: تستبدل مهارة عدم التراخي الجملة بشجرة عمق وملفات بوابة يجب على الوكيل اجتيازها قبل أن يُسمح له بإعلان الإنجاز.

تصبح جلستك نفسها مثالاً. إذا خالف الوكيل القاعدة في الدور 12 وسمحت له بذلك، تصبح المخالفة الآن ضمن السياق بوصفها مثالاً، وتكون أحدث بكثير من القاعدة. صحّح المخالفة لحظة رؤيتها. فالمخالفة غير المصححة تعلّم بقية الجلسة.

ملف التعليمات ليس حدّاً أمنياً. فهو يوجّه السلوك ولا يفرضه. كل ما تكون كلفة الخطأ فيه مرتفعة، مثل بيانات الاعتماد أو الأوامر المدمّرة، يجب أن يخضع للصلاحيات أو لـhook. إبعاد الأسرار عن متناول الوكيل يطبّق المبدأ نفسه على البيانات: لا تطلب من الوكيل ألا يقرأ ملفاً، بل رتّب بحيث لا يكون الملف قابلاً للقراءة.

الخلاصة المختصرة: أثبت أن الملف قد حُمّل، واجعل القاعدة قابلة للتحقق، وانقلها بجوار الشيء الذي تحكمه، وعندما يظل معدل الإخفاق مهماً، أخرجها من النثر. القاعدة التي لا يستطيع الوكيل تجاهلها هي قاعدة لم تطلبها من الوكيل أصلاً.

FAQ

لماذا يتجاهل Claude Code ملف CLAUDE.md؟

تحقق أولاً من تحميله قبل افتراض أنه جرى تجاهله. شغّل /context وراجع قائمة Memory files؛ إذا لم يظهر الملف فيها، فلم يُحمَّل عند بدء الجلسة. تُرسَل ملفات التعليمات في رسالة مستخدم بعد موجه النظام، وتُعامل على أنها سياق وليست إعدادات مفروضة، لذلك لا يوجد ضمان صارم للامتثال. في معظم الحالات الفعلية، يكون السبب واحداً من أربعة: يوجد الملف في دليل فرعي لم يقرأ منه الوكيل، أو يتعارض ملفان واختار النموذج أحدهما عشوائياً، أو أن القاعدة غامضة أكثر من اللازم للتحقق من إجراء بالاستناد إليها، أو أن الشيفرة المحيطة توضّح سلوكاً مخالفاً لما تنص عليه القاعدة.

هل يؤدي تعديل ملف التعليمات أثناء الجلسة إلى تغيير شيء؟

ليس بالنسبة إلى النسخة الموجودة بالفعل في المحادثة. تُحمَّل الملفات الموجودة أعلى دليل العمل بالكامل عند بدء الجلسة، لذلك يكون النص الذي يحتفظ به النموذج هو النص الموجود وقت بدء الجلسة. لالتقاط التعديل، ابدأ جلسة جديدة، أو اطلب من الوكيل قراءة الملف باستخدام أدواته المعتادة للتعامل مع الملفات، ما يضع الإصدار الحالي في المحادثة على شكل رسالة جديدة. بعد إجراء compaction، يُعاد تحميل ملف جذر المشروع من القرص، ولذلك يصل الإصدار الجديد عند تلك النقطة أيضاً.

أي ملف تكون له الأولوية عندما يتعارض ملف CLAUDE.md في الجذر مع ملف متداخل؟

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

هل تبقى تعليماتي بعد /compact؟

يعتمد ذلك على طريقة تحميلها. يُعاد حقن ملف جذر المشروع CLAUDE.md والقواعد غير المقيّدة بنطاق وذاكرة auto من القرص بعد إجراء compaction. أما القواعد التي تحتوي على frontmatter من نوع paths: والملفات المتداخلة CLAUDE.md في الأدلة الفرعية، فتُفقد إلى أن يُقرأ ملف مطابق مرة أخرى. كل ما كتبته في الدردشة فقط يبقى إذا احتفظ به الملخّص بالصدفة. إذا كان يجب أن تستمر القاعدة طوال الجلسة، فضعها في ملف جذر المشروع من دون frontmatter من نوع paths:.

متى ينبغي تحويل القاعدة إلى hook بدلاً من كتابتها نثراً؟

عندما يكون التحقق حتمياً، وتكون تكلفة عدم اكتشاف الخطأ أعلى من تكلفة كتابة script صغير. تنطبق هذه الحالة على قيود مسارات الملفات، والأوامر المطلوبة قبل تنفيذ commit، واستدعاءات الأدوات المحظورة. يعمل hook من نوع PreToolUse يخرج بالحالة 2 على حظر استدعاء الأداة مباشرة، ويعيد نص stderr إلى النموذج باعتباره سبب الحظر، لذلك يظل فعالاً سواء بقيت القاعدة في السياق أم لا. يجب أن تكون أي قاعدة يستطيع formatter أو linter اتخاذ قرار بشأنها مملوكة لتلك الأداة، وأن تُحذف بالكامل من ملف التعليمات.

هل كان هذا المقال مفيدًا؟