كيف تبقي وكيل البرمجة بالذكاء الاصطناعي على المسار: استكشف، خطّط، ثم ابنِ

عندما يستخدم الناس لأول مرة أداة برمجة وكيلية مثل Claude Code أو Cursor، فإنهم يميلون إلى كتابة طلب من سطر واحد والأمل. أحياناً ينجح. وغالباً يبني الوكيل بثقة الشيء الخاطئ — حلّاً لمشكلة لم تسأل عنها، أو لمس ملفات لم تتوقعها، أو تخطّي الحالة الحدّية التي كانت تهمّ فعلاً.

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

لماذا يفشل القفز مباشرة إلى الكود

يعمل وكيل الذكاء الاصطناعي داخل نافذة سياق محدودة — السجل الجاري لمحادثتك إضافة إلى كل ملف يقرأه وكل أمر يشغّله. يحدث خطآن عندما تتخطّى التخطيط:

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

فصل التفكير عن الفعل يلتقط الافتراض الخاطئ بينما لا يزال إصلاحه رخيصاً — جملة تصحيح بدلاً من التراجع عن 12 ملفاً.

الخطوة 1: استكشف في وضع للقراءة فقط

معظم الوكلاء الجادّين لديهم الآن وضع يستطيعون فيه القراءة والتحليل لكن لا يمكنهم تغيير أي شيء. في Claude Code يُسمّى plan mode: حالة للقراءة فقط يقرأ فيها الوكيل الملفات ويجيب عن الأسئلة دون تعديل، أو تشغيل أوامر تغيّر الحالة، أو عمل commit.

ابدأ بأن تطلب من الوكيل فهم الكود، لا تغييره:

Read /src/auth and explain how we handle sessions and login.
Also look at how we manage environment variables for secrets.

أنت تبني سياقاً مشتركاً وتتحقق من أن الوكيل يفهم فعلاً قاعدة كودك قبل أن تثق به ليعدّلها.

الخطوة 2: اطلب خطة، ثم اضغط عليها

بمجرد أن يستكشف الوكيل، اطلب خطة ملموسة قبل أي كود:

I want to add Google OAuth login. What files need to change?
What's the session flow? Write a step-by-step plan — don't write code yet.

يعيد الوكيل خطة مرقّمة: أي ملفات سيلمس، وتدفق الجلسة الجديد، وأين سيخزّن الرموز (tokens). الآن لا تقبل المسودة الأولى. هذه أرخص لحظة لتصحيح المسار. اضغط على الثغرات:

• "ماذا يحدث إذا فشل رد نداء OAuth (callback) في منتصف الطريق؟"
• "لدينا بالفعل مساعد refreshToken في src/auth/tokens.ts — أعد استخدامه بدلاً من كتابة واحد جديد."
• "اقصر هذا على تدفق تسجيل الدخول فقط. لا تلمس كود إعادة تعيين كلمة المرور الموجود."

بضع دقائق في تنقيح الخطة هنا توفّر ساعة من حلّ تشابك تنفيذ خاطئ لاحقاً.

الخطوة 3: ابنِ مع وسيلة للتحقق

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

Implement the OAuth flow from your plan. Write a test for the callback
handler covering the failure case, run the test suite, and fix any failures.

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

الخطوة 4: اعرف متى تتخطّى الخطة

للتخطيط عبء، وهو لا يستحقّ دائماً. إذا كان التغيير صغيراً ونطاقه واضحاً — إصلاح خطأ مطبعي، أو إضافة سطر سجل (log)، أو إعادة تسمية متغيّر — فاطلب من الوكيل ببساطة فعله مباشرة. قاعدة عامة جيدة من دليل Anthropic: إذا استطعت وصف الـ diff في جملة واحدة، فتخطَّ الخطة. احتفظ بدورة استكشف-خطّط-ابنِ للعمل الذي يمتد عبر ملفات متعددة، أو يستخدم نهجاً لست متأكداً منه، أو يلمس كوداً لا تعرفه جيداً.

شبكة أمان: صحّح المسار مبكراً واستخدم نقاط التحقق

حتى مع خطة جيدة، ينحرف الوكلاء. عادتان تُبقيانك في السيطرة:

• قاطِع اللحظة التي ينحرف فيها عن المسار. لا تنتظر حتى ينهي الوكيل نهجاً خاطئاً. في Claude Code، يوقفه Esc في منتصف الفعل مع الحفاظ على السياق حتى تتمكن من إعادة توجيهه.
• استخدم نقاط التحقق (checkpoints) للتجربة بحرية. يلتقط Claude Code صوراً لملفاتك قبل كل تغيير، فيمكنك أن تطلب من الوكيل تجربة شيء محفوف بالمخاطر، وإذا لم ينجح، تراجع (Esc Esc أو /rewind) وجرّب نهجاً مختلفاً. (تتبّع نقاط التحقق تعديلات الوكيل نفسه، لا العمليات الخارجية — فهي وسيلة راحة، لا بديل عن git.)

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

الخلاصة

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