أعطِ وكلاء البرمجة السياق الصحيح (وليس المزيد منه)

جملة واحدة تطلب نقطة نهاية تسجيل الدخول ليست كافية. لا يزال الوكيل بحاجة إلى معرفة تنسيق الخطأ لديك، وتخطيط المجلدات، ومكتبة المصادقة، ونمط التحقق، وكيف يبدو «done». تجعل فيديو IBM Technology القصير لـ Legare Kerrison Context-Aware Coding: Give AI Agents the Right Context (نُشر في 2 نوفمبر 2026) النقطة ملموسة وعملية للفرق التي تستخدم بالفعل وكلاء البرمجة.

هذا ليس مقالاً آخر عالي المستوى حول الاختناقات. إنه قائمة قصيرة من المدخلات التي تغير المخرجات فعليًا.

المدخلات التي تهم

1. الملفات والهيكل. يمكن للوكلاء الأقوياء البحث وفتح الملفات بأنفسهم. مهمتك هي توجيههم في الاتجاه الصحيح («اتبع النمط في README») ويفضل إعطاؤهم خريطة مستودع مضغوطة للملفات والرموز حتى يروا الشكل دون قراءة كل سطر.

2. إصدارات التبعيات الدقيقة. معرفة أنك تستخدم مكتبة ليست كافية. يسجل ملف القفل الإصدارات المحلولة (بما في ذلك العابرة) وبالتالي أي واجهات برمجة التطبيقات موجودة فعليًا. العديد من الوظائف «المهلوسة» هي ببساطة عدم تطابق في الإصدار.

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

4. الاتفاقيات والقيود. ضع أوامر البناء، ومعايير الترميز، والقواعد الصعبة («لا تلمس هذا الدليل») في ملف AGENTS.md مسجل في التحكم بالإصدار (أو المكافئ الذي يقرأه أداتك بالفعل). هذا يصبح واجهة فريق مشتركة.

5. النية. الإنسان فقط يعرف ماذا يعني done، وما هي القيود، وما لا يجب على الوكيل فعله. لا يمكن للوكيل اكتشاف هذا بقراءة المستودع.

ثلاث حركات قبل كتابة أي كود

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

لا تغرق المستودع بأكمله

لا تولي النماذج اهتمامًا متساويًا لكل شيء في سياق طويل. تميل المعلومات في البداية والنهاية إلى أن تُستخدم بشكل أفضل من المواد المدفونة في الوسط («lost in the middle»). كل ملف غير ذي صلة يتنافس مع ذي صلة. لتغيير تدفق تسجيل الدخول يحتاج الوكيل إلى وحدة المصادقة واختباراتها والاتفاقيات — وليس خدمة الفوترة أو سجلات البناء البالغة من العمر ثلاثة أسابيع.

العواقب العملية:

• ابدأ جلسة جديدة لكل مهمة جديدة.
• أشر إلى ملفات محددة ونظف الضوضاء عندما تنمو الجلسة.
• فضل منسقًا يطلق مهام فرعية مركزة بسياق نظيف على محادثة واحدة مثقلة.

الهدف ليس المزيد من السياق. إنه السياق الصحيح، مع إنسان لا يزال يتخذ القرارات.

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

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