مطوّر Python يروّض Claude Code: ملف إعدادات مفتوح المصدر ضد الانحدارات البرمجية

أمضى مطوّر من شركة CREATMAN عدة أسابيع في دراسة الوثائق ونقاشات Reddit وإعدادات مطوّرين آخرين، بهدف بناء تهيئة لـ Claude Code توفّر حماية فعلية من الانحدارات (regressions). والنتيجة مستودع مفتوح يضم ملفات جاهزة للاستخدام الفوري.

المشكلة التي يعرفها الجميع

يعمل Claude Code بقوة، لكنه يتصرف باستقلالية مفرطة إذا لم يُضبط كما ينبغي. وهذا المشهد مألوف لدى المطوّر المستقل:

• طلبتَ إضافة نظام مصادقة، فأعاد الوكيل كتابة نصف المشروع
• طلبتَ تعديل دالة واحدة، فحصلتَ على اختبارات محذوفة وتبعية (dependency) لم تطلبها
• بنيتَ نموذجًا أوليًا عاملًا في ساعة، ثم أمضيتَ ثلاث ساعات في تنظيف «تحسينات» الوكيل

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

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

مما تتكوّن الإعدادات

بعد أسابيع من قراءة الوثائق ومتابعة النقاشات في المنتديات وتحليل إعدادات الآخرين، حدّد المؤلف خمسة مكوّنات أساسية. وجميعها مجمّعة في مستودع claude-code-antiregression-setup وجاهزة للاستخدام:

• CLAUDE.md — ملف العقد الرئيسي: نطاق المهمة، ومحظورات صريحة على القرارات المستقلة، ومتطلب وصف التغييرات المقبلة قبل تنفيذها
• قواعد المجلدات — قيود على مستوى المجلدات كي لا يمسّ الوكيل ما لم يُطلب منه صراحةً
• قائمة تحقق إلزامية — يصف الوكيل خطته قبل أي تعديل، ويوافق عليها المطوّر أو يرفضها
• الخطافات (Hooks) — سكربتات آلية تعمل بعد كل إجراء ينفذه الوكيل وتتحقق من توافقه مع المهمة
• قوالب الأوامر النصية (Prompts) — صيغ جاهزة للطلبات تزيل الالتباس وتضيّق مجال التأويل

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

لماذا ينجح العقد أكثر من الحظر؟

الفكرة الأساسية هي منح الوكيل قواعد واضحة بدل الاكتفاء بتقييده. يقرأ Claude Code ملف CLAUDE.md في بداية كل جلسة. وإذا كُتب فيه صراحةً «لا تلمس الاختبارات دون طلب»، أو «التغييرات ضمن الملفات المحددة فقط»، أو «نبّه قبل إضافة تبعية» — فإن الوكيل يلتزم بذلك.

«أحتاج إلى وكيل ذكاء اصطناعي يساعدني على الإطلاق بسرعة أكبر

(shipping)، لا أن يخلق مشكلات جديدة»، هكذا يشرح المؤلف هدفه.

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

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

وCLAUDE.md ليس مجرد README للوكيل، بل وثيقة حيّة للمشروع. إذ تُدوَّن فيه القرارات المعمارية والوحدات الحرجة وقواعد التسمية. ويستخدم الوكيل هذا الملف سياقًا مع كل طلب، فيصبح فهمه للمشروع أدق، وتقلّ احتمالية «التحسينات» العشوائية.

ولا ترتبط الإعدادات ببيئة تقنية محددة. فالمؤلف يعمل على خلفية (backend) مبنية بـ Python، لكن المبادئ تنطبق على أي مشروع يتطلب إبقاء الوكيل ضمن حدود المهمة المطلوبة.

ماذا يعني ذلك

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