يوم كامل مع Claude Code: كيف تغيّر يوم المهندس عندنا من الجذور

هذه ليست مقالة عن «مستقبل البرمجة». هذه يوميات فريق حقيقي، في شركة حقيقية، خلال أسبوع عمل عادي. منذ أن أصبح Claude Code أداة أساسية عندنا، لم يعد السؤال «هل يكتب الذكاء الاصطناعي الكود؟» بل «كيف نُدير مهندساً لا ينام ولا يملّ ولا يخجل من السؤال؟».

الثامنة صباحاً: التذكرة تُفتح على الطرفية لا على المحرّر

أول تغيير محسوس: لم نعد نبدأ اليوم بفتح الملفات. نبدأ بفتح الطرفية وكتابة نية واضحة: «عندنا تسريب ذاكرة في الـ webhook الخاص بـ WhatsApp في مشروع أرحب، ابحث عن السبب، اقترح إصلاحاً، ولا تلمس قاعدة البيانات». الوكيل يقرأ الشجرة، يتتبّع الاستدعاءات، ويعود بخريطة قبل أن يكتب سطراً واحداً. المهندس يراجع الخريطة، لا الكود — وهذا فرق جوهري في نوعية الانتباه.

العاشرة: الـ CLAUDE.md هو العقد الحقيقي

أكثر ما تعلّمناه أن جودة الوكيل تساوي جودة الملف الذي يقرأه أولاً. في موقع سمارت ليد تك نفسه، ملف CLAUDE.md يشرح بنية الأقسام، قواعد الـ RTL، وشروط «متى تعتبر الصفحة منتهية». حين كتبناه بدقّة، انخفضت المراجعات المرفوضة إلى النصف. الوكيل لا يخمّن أسلوبك؛ هو يطبّقه إن كتبته.

الظهر: المراجعة تصبح حواراً لا محاكمة

القاعدة عندنا: الوكيل يفتح الـ Pull Request، لكن الإنسان هو من يكتب كلمة Approve. لا استثناء.

ما تغيّر هو محتوى المراجعة. بدلاً من ملاحظات «سمّ المتغيّر بشكل أفضل»، صارت المراجعات عن القرارات: لماذا اخترنا هذا التوقيت للـ cache؟ هل هذا الـ fallback آمن لو سقط الـ API؟ الوكيل يجيب بأدلّة من الكود، ويُعدّل أثناء النقاش.

الثالثة عصراً: المهام المملّة تختفي

• كتابة اختبارات Playwright لكل مسار في SLT OCR بعد أي تعديل على الواجهة.
• ترجمة مفاتيح i18n الجديدة للعربية والإنجليزية بنبرة متسقة مع الموجود.
• تحديث DESIGN-STATUS.md بعد كل قسم يُنجز — وثيقة كانت تموت دائماً من الإهمال.

الخامسة: ما الذي لم يتغيّر؟

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

الخلاصة بلغة الأرقام

خلال ربع سنة: وقت الوصول من التذكرة إلى PR قابل للمراجعة انخفض بنحو 40%، وعدد الأخطاء التي تصل للإنتاج لم يرتفع. لم يُستغنَ عن أحد؛ ارتفع سقف ما يستطيع الفريق الصغير إنجازه. وهذا، في شركة تبني خمسين منتجاً عبر ثماني دول، هو الفرق بين «نعتذر عن المشروع» و«نبدأ الأسبوع القادم».