مطور Python يقيّد Claude Code: تهيئة مضادة للتراجعات متاحة للعامة

قضى مطور من شركة CREATMAN عدة أسابيع في دراسة التوثيق والنقاشات على Reddit والإعدادات الأخرى لتجميع تكوين Claude Code بحماية حقيقية ضد الانحدار. والنتيجة هي مستودع مفتوح يحتوي على ملفات جاهزة للاستخدام الفوري.

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

يعمل Claude Code بقوة، لكن بدون التكوين الصحيح يتصرف بشكل مستقل جداً. سيناريو نموذجي لمطور وحيد:

• طلب إضافة المصادقة — أعاد الوكيل كتابة نصف المشروع
• طلب إصلاح دالة واحدة — حصل على اختبارات محذوفة وتبعية غير مطلوبة
• بنى نموذجاً عاملاً في ساعة واحدة — قضى ثلاث ساعات في تنظيف "التحسينات" التي أجراها الوكيل

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

مما تتكون التكوين

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

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

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

لماذا يعمل العقد بشكل أفضل من القيد

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

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

أن ينشئ مشاكل جديدة"، يشرح الكاتب المهمة.

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

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

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

التكوين غير مرتبط بمكدس معين. يعمل الكاتب مع خادم Python، لكن المبادئ تنطبق على أي مشروع حيث تحتاج إلى إبقاء الوكيل ضمن حدود المهمة المعطاة.

ماذا يعني هذا

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