إطار مفتوحالإصدار ١٫٠محدَّث لـ Fable 5.1 وOpus 5.5إعداد

دستور الوكيل

عشرة مبادئ تجعل ملفات التعليمات ترفع أداء وكيلك بدل أن تربكه، ونصٌّ جاهز تلصقه في وكيلك فيراجع ملفاتك ويحدّثها بنفسه، بأمان.

النص الجاهز المستودع على GitHub شارك على X

المواد العشر

الوسم توثيق يعني أن المبدأ منصوص عليه في توثيق Anthropic الرسمي، والوسم تجربة يعني أنه درس تكرر في مشاريع حقيقية.

  1. اكتب دليل تشغيل، لا موسوعة توثيق

    اكتب الملف لنموذج يدخل مشروعك لأول مرة: أوامر البناء والاختبار، القرارات المعمارية، والفخاخ غير البديهية. احذف ما يعرفه من قراءة الكود، وما هو بديهي مثل «اكتب كوداً نظيفاً». واسأل عن كل سطر: هل سيخطئ الوكيل لو حذفته؟

    لماذا: التوثيق يوصي بأقل من ٢٠٠ سطر للملف الواحد، لأن الملف الطويل يُضيع القواعد المهمة. المعرفة الخاصة بمجلد معيّن مكانها .claude/rules/، لكنها لا تُحمَّل إلا حين تُفتح ملفات ذلك المجلد. فما يلزم في عمل لا يلمس ملفاً، كأمر SQL مباشر أو رسالة أو فحص موقع حي، يبقى في الملف الرئيسي. والإجراء الطويل المتكرر مكانه مهارة (skill) تُحمَّل عند الحاجة.

  2. مع كل قاعدة كلمة «لأن» توثيق

    بدل «لا تستخدم X» اكتب «لا تستخدم X لأنه يسبب Y». جملة سبب واحدة تكفي.

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

  3. تكلّم بصوت عادي توثيق

    احذف CRITICAL وMUST بالأحرف الكبيرة، وعبارة «لا تكن كسولاً». واكتب المتطلبات الحقيقية بصيغة أمر صريحة، بدل «حاول» و«إن أمكن».

    لماذا: هذا الصراخ كُتب لنماذج قديمة كانت تتكاسل. أما Fable 5.1 وOpus 5.5 فيتبعان التعليمات بدقة، فيدفعهما الصراخ إلى الإفراط والتصلب. وكلمة «حاول» تُقرأ عندهما إذناً بالتقصير.

  4. أعطه الهدف والقيود، لا الخطوات توثيق

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

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

  5. لا أرقام من الذاكرة تجربة

    كل معلومة تتغير، كعدد العناصر والأسعار وأسماء الأعمدة والإصدارات، تُكتب في جدول «مصدر الحقيقة»: نوع المعلومة ← الأمر أو الملف الذي يحسبها في لحظتها. وعلّم أي مرجع قديم منجرف بعبارة «مرجع قديم — لا يُصدَّق».

    لماذا: الرقم المكتوب في ملف التعليمات يتقادم بصمت، فيكرره الوكيل بثقة كاملة. وأخطر الأخطاء ما بدا صحيحاً.

  6. «تم» تحتاج دليلاً توثيقتجربة

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

    لماذا: هذا أكثر ما يؤكد عليه توثيق Claude Code. وفي التجربة، ما يُعلَن منجزاً بلا فحص حي هو أكثر ما يعود عطلاً في الإنتاج. وفي الأعمال الحساسة كالدفع والمصادقة، المراجع المستقل بسياق نظيف أدق من النقد الذاتي.

  7. كل خطأ دفعت ثمنه يصير سطراً تجربة

    خصّص قسم «أخطاء مسمّاة» بصيغة ثابتة: الخطأ (ما سيفعله وكيل هنا) ← السبب (الآلية في جملة) ← القاعدة. وأضف السطر في نفس التغيير الذي أصلح الخطأ.

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

  8. حدّد متى يسأل، بالضبط تجربةتوثيق

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

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

  9. ذاكرة ذرّية تُراجَع توثيقتجربة

    درس واحد في كل ملف، وفي أوله سطر يلخّصه، وفهرس بسطر واحد لكل ملف. سجّل التصحيحات والأساليب التي نجحت، ومع كل منها السبب. حدّث الملف القائم بدل أن تكرره، واحذف ما ثبت خطؤه، ولا تحفظ ما يسجله الكود أو git أصلاً.

    لماذا: التوثيق يذكر أن Fable 5.1 يتحسن أداؤه بوضوح حين يملك مكاناً يدوّن فيه ما تعلّمه. لكن الذاكرة لقطة من الماضي: أي معلومة فيها تُتحقق من الكود قبل الاعتماد عليها، وتُصحَّح من مصدرها لا من ذاكرة أخرى.

  10. النموذج المناسب، والجهد المناسب توثيقتجربة

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

    لماذا: ملف التعليمات سياق يُستأنس به لا إلزام، أما الـ hook فيُنفَّذ في كل مرة. وتفاصيل الجهد والنماذج في القسم التالي.

مستوى الجهد: الإعداد الذي يُنسى

في النماذج الجديدة يُضبط عمق التفكير بإعداد اسمه effort، لا بعبارة في البرومبت.

مستويات الجهد من الأدنى إلى الأعلى:

  1. low
  2. افتراضي Opus 5.5
    medium
  3. افتراضي Fable 5.1
    high
  4. xhigh
  5. max

الافتراضي في Opus 5.5 صار medium، أي أقل بدرجة من Opus 5. فإن نقلت إعداداتك القديمة كما هي، سيعمل بجهد أقل مما تظن، فاضبطه صراحة. أما Fable 5.1 فابدأ فيه بـ high، وجرّب medium وlow للأعمال الروتينية، فكثيراً ما تتفوق على المستويات العالية في النماذج السابقة. وقبل أن تكتب «فكّر أقل» أو «فكّر أكثر»، غيّر الجهد.

أي نموذج لأي عمل
Sonnet 5العمل الواضح المحدود الذي يمكن التحقق منه: تعديلات ميكانيكية، اختبارات، توثيق، بحث في المستودع.
Opus 5.5التنفيذ الصعب: تتبّع الأعطال المعقدة، التغييرات العابرة لعدة طبقات، الحالة والتزامن.
Fable 5.1المعمارية، والغموض، والأمن والمصادقة والفوترة، والهجرات الهادمة، والمهام الطويلة المستقلة، وكل ما يكون ثمن الخطأ فيه عالياً.

النص الجاهز: الصقه في وكيلك

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

مهمتك: أن تراجع ملفات التعليمات الخاصة بي وتحدّثها لتعمل نماذج Claude الأحدث (Fable 5.1 وOpus 5.5 وSonnet 5) بأفضل أداء. اعمل على مراحل، ولا تعدّل أي ملف قبل أن أوافق.

## المرحلة ١ — الجرد (قراءة فقط)
- ابحث عن: ~/.claude/CLAUDE.md، وفي المشروع الحالي: CLAUDE.md و.claude/CLAUDE.md وCLAUDE.local.md وAGENTS.md و.claude/rules/*.md و.claude/agents/*.md و.claude/skills/*/SKILL.md، ومجلد ذاكرة المشروع إن وُجد.
- اقرأ ملفات إعداد المشروع (package.json أو pyproject أو Makefile أو README أو إعدادات CI) لتعرف أوامر البناء والفحص والاختبار الحقيقية.
- إن كان git متاحاً، راجع آخر ٥٠ رسالة commit وابحث عن fix وrevert وhotfix. هذه أخطاء دُفع ثمنها وتستحق قاعدة. وافحص git status والفروع: إن كانت جلسة أخرى تعمل في المستودع، فلا تعدّل فرعها ولا ملفاتها.
- اعرض لي قائمة بما وجدته، مع عدد أسطر كل ملف وحجمه.

## المرحلة ٢ — التدقيق
صنّف كل سطر إلى: يبقى، أو تُعاد صياغته، أو يُنقل، أو يُحذف، أو يُضاف ما ينقص. استخدم هذه المبادئ:
1. الملف دليل تشغيل لنموذج يدخل المشروع لأول مرة، لا توثيق. أبقِ ما لا يُستنتج من الكود: الأوامر، والقرارات المعمارية، والفخاخ غير البديهية، وأسباب القيود. احذف ما يُعرف من قراءة الكود والبديهيات. واسأل عن كل سطر: هل سيخطئ النموذج لو حُذف؟
2. الحجم: الملف الرئيسي أقل من ٢٠٠ سطر تقريباً. المعرفة الخاصة بمجلد معيّن تنتقل إلى .claude/rules/<اسم>.md مع paths: في رأسه. والإجراء الطويل المتكرر يصير skill. وما يجب أن يحدث دائماً بلا استثناء اقترح له hook. تنبيه: القاعدة المقيّدة بمسار لا تُحمَّل إلا حين تُفتح ملفات ذلك المسار، فما يلزم في عمل لا يلمس ملفاً (SQL مباشر، رسالة، فحص موقع حي) يبقى في الملف الرئيسي، أو يُترك فيه مؤشر صريح يقول متى يُقرأ.
3. مع كل قاعدة سببها: أي قاعدة بلا «لأن» أضف لها سبباً في جملة واحدة إن كان واضحاً من السياق، وإلا علّمها لأراجعها. لا تخترع سبباً.
4. النبرة: حوّل CRITICAL وMUST وNEVER بالأحرف الكبيرة و«لا تكن كسولاً» إلى صياغة عادية هادئة. وحوّل «حاول» و«إن أمكن» المرتبطة بمتطلبات حقيقية إلى أمر صريح.
5. احذف السقالات القديمة: «فكّر خطوة بخطوة»، و«خطّط قبل التنفيذ»، ووسوم scratchpad، والخطوات المرقّمة للأعمال التي تحتاج حكماً، وقواعد «لا تستخدم النقاط أو العناوين»، و«لا تكتب تحديثات أثناء العمل». عمق التفكير يُضبط بمستوى الجهد (effort) لا بالنص. أبقِ الخطوات الحرفية للعمليات الهشة فقط: الحذف، وهجرة البيانات، والنشر، والمصادقة.
6. لا أرقام أو قوائم متغيرة مكتوبة من الذاكرة. حوّلها إلى جدول «مصدر الحقيقة»: نوع المعلومة ← الأمر أو الملف الذي يحسبها في لحظتها. وعلّم المراجع المنجرفة بعبارة «مرجع قديم — لا يُصدَّق».
7. أخطاء مسمّاة: اجمع الدروس المتناثرة في قسم بصيغة: الخطأ (ما سيفعله نموذج هنا) ← السبب (الآلية في جملة) ← القاعدة. لا تضف قاعدة من تعثّر حدث مرة واحدة إلا إن كان مكلفاً. وإن وجدت قاعدة خاطئة فأصلحها في مصدرها، ولا تضف قاعدة أخرى تحذّر منها.
8. التصعيد: قائمة مغلقة بالحالات التي تتوقف فيها وتسألني: حذف لا رجعة فيه، ودفع وفوترة، ورسائل تصل مستخدمين حقيقيين، وتعديل بيانات إنتاج، وأسرار ومصادقة، وتغيير قرار مقفل. وكل ما يُجاب من الكود أو البيانات تقرره وتوثّقه. ويكون السؤال واحداً: سطر سياق، ثم الخيارات وتكلفة كل منها، ثم توصيتك.
9. تعريف «تم»: بوابة تحقق لكل نوع عمل، بالأوامر الحقيقية التي وجدتها في المرحلة ١.
10. تضارب المصادر: رتّب الأولوية صراحة هكذا: الكود التنفيذي، ثم البيانات الحية، ثم القواعد المخصصة، ثم هذا الملف، ثم الذاكرة والتعليقات القديمة.
11. القرارات المحسومة (أسعار، نصوص معتمدة، اختيارات معمارية نهائية) تُجمع في قسم واحد، ويُكتب فيه أنها لا تُعاد مناقشتها إلا بتعليمات صريحة مني.
12. ما يجب أن يُمنع دائماً لأسباب أمنية لا يكفي فيه سطر تعليمات: اقترح له hook أو صلاحيات محدودة، ودَع التعليمات تشرح السبب.

## المرحلة ٣ — قسم «طريقة العمل»
أضف قسماً قصيراً، أو حدّث القائم، يغطي النقاط التالية بصياغتك وبلغة الملف:
- النطاق: نفّذ ما طُلب كاملاً، بلا ميزات أو إعادة هيكلة أو تجريدات لم تُطلب. وما تلاحظه خارج المهمة تذكره اقتراحاً في آخر ردك.
- حين أصف مشكلة أو أسأل أو أفكر بصوت عالٍ، فالمطلوب تقييمك. لا تُصلح حتى أطلب.
- قبل أي أمر يغيّر حالة النظام (حذف، إعادة تشغيل، تعديل إعدادات، push)، تأكد أن الدليل يدعم هذا الفعل بالذات.
- حين تكفي المعلومات، نفّذ. وحين تختار بين بدائل، قدّم توصية لا عرضاً لكل الخيارات. والأفعال القابلة للتراجع ضمن حدود الطلب لا تحتاج استئذاناً.
- قبل إنهاء دورك: إن كانت فقرتك الأخيرة خطة أو وعداً بعمل لم تنفّذه، فنفّذه الآن، ما لم يكن ضمن حالات التصعيد. تلك تذكرها في التقرير ولا تنفّذها.
- قبل أن تبلّغ عن أي تقدّم، طابق كل ادعاء بنتيجة أداة من هذه الجلسة، وصرّح بما لم تتحقق منه. وإن فشل اختبار فقل ذلك مع مخرجاته.
- الملخص الأخير يُكتب لقارئ لم يتابع العمل: النتيجة أولاً، بجمل كاملة، بلا اختصارات اخترعتها أثناء العمل. ويذكر: ما أُنجز، ودليل التحقق منه، وما بقي، وما تُرك عمداً دون مساس.
- عدّل الملفات تعديلاً موضعياً ولا تُعد كتابتها كاملة. ولا تحفظ سكربتات الفحص المؤقتة كاختبارات دائمة.
- المعلومات سريعة التغير، كأسماء النماذج والمكتبات والإصدارات، تحقق منها بالبحث أو من التوثيق قبل أن تعتمد على ذاكرتك.
- إن كانت أداتك تدعم الوكلاء الفرعيين: فوّض المهام المستقلة وواصل العمل، واختر النموذج حسب صعوبة المهمة لا حجمها. والتحقق من العمل الحساس بوكيل مستقل أدق من المراجعة الذاتية.

## المرحلة ٤ — الذاكرة
إن وُجدت ذاكرة: درس واحد في كل ملف وفي أوله سطر يلخّصه، وفهرس بسطر لكل ملف. ادمج المكرر، واحذف الخاطئ أو المتقادم، ولا تحفظ ما يسجله الكود أو git. وقبل تصحيح أي معلومة فيها، تحقّق منها من مصدرها (الكود، git، الأمر الحي). ثم أضف إلى الملف الرئيسي هذه القاعدة: «كل خطأ مكلف يُضاف سطراً في قسم الأخطاء المسمّاة ضمن نفس التغيير الذي أصلحه».

## المرحلة ٥ — التسليم
1. تقرير فيه لكل ملاحظة: الملف والسطر، والنص، والمبدأ الذي تخالفه، والإجراء المقترح، ودرجة ثقتك.
2. الملفات الجديدة أو التعديلات المقترحة (diff). لا تطبّق شيئاً حتى أوافق.
3. بعد موافقتي: خذ نسخة احتياطية من كل ملف قبل تعديله، ثم طبّق. حين تنقل محتوى بين الملفات انقله حرفياً ولا تُعِد صياغته، ثم تحقّق بسكربت أن كل سطر قديم موجود في مكانه الجديد، وأخبرني بالنتيجة.
4. للتعديلات الكبيرة: اطلب مراجعة من وكيل مستقل بسياق نظيف إن كانت أداتك تدعم ذلك، وطبّق ما يثبت من ملاحظاته بعد التحقق منها.
5. أعطني في النهاية: عدد الأسطر والحجم قبل التعديل وبعده، وما نُقل وإلى أين، وما بقي لقراري.

## حدود لا تُتجاوز
- لا تحذف أي قيد له سبب تجاري أو أمني أو قانوني، ولا أي معلومة لا توجد إلا في هذه الملفات. الحذف مسموح فقط لما تبرره المبادئ أعلاه. وإن لم تجد ما يستحق التغيير، فقل ذلك ولا تغيّر شيئاً.
- لا تضع أسراراً أو مفاتيح أو كلمات مرور في أي ملف تعليمات.
- لا تخترع أوامر أو مسارات. كل أمر تكتبه يجب أن تكون تحققت من وجوده.
- لا تنفّذ push ولا تنشر شيئاً.

النص نفسه كملف: العربية · English

  1. افتح وكيلك (Claude Code أو غيره) داخل مجلد مشروعك، والصق النص كاملاً.
  2. راجع التقرير والتعديلات المقترحة، واقبل ما تقتنع به وارفض الباقي. أنت صاحب القرار.
  3. كرّر المراجعة عند كل إصدار نموذج جديد، لأن التعليمات المكتوبة لنموذج قديم تصبح عبئاً على الجديد.

أربع إضافات سريعة

ابدأ من جديد

إن صحّحته مرتين في المسألة نفسها ولم ينجح، افتح جلسة جديدة (/clear) ببرومبت أوضح. الجلسة النظيفة تتفوق على جلسة مثقلة بالتصحيحات.

المهام الطويلة

قل له صراحة إنك لا تتابعه لحظياً، وإن الأسئلة من نوع «هل أكمل؟» ستوقف العمل، مع استثناء حالات التصعيد. فينجز حتى النهاية بدل أن يتوقف في منتصفها.

الواجهات

مع Opus 5.5، عبارة «تجنّب الشكل العام» لا تكفي. سمِّ الأنماط التي لا تريدها بالاسم: لون الخلفية، شكل الأزرار، ترقيم الأقسام.

أعطه السبب

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

التطبيق على مشروع حقيقي

كيف طُبّقت هذه المبادئ على ملفات تعليمات مشروع قائم، مع نص التدقيق كاملاً وأمثلة نقل القواعد والتحقق من الالتزام: خل Claude Code يلتزم بقواعدك بدل ما يتجاهلها، المقال الكامل على مُشَيِّد.

المصادر

توثيق Anthropic الرسمي، وآخر تحقق من الروابط في ٢٤ سبتمبر ٢٠٢٦.