ماذا نمنع؟ سياسة الفريق، والأرقام التي تثبت أنها نجحت

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

القائمة أقصر مما تظن

ما يجوز للوكيل أن يمسّه، وما هو محظور. الكود القديم ما لم تنصّ المهمة على migrate، والكود المولَّد، وكل ما يمسّ الامتثال (compliance). سطر واحد لكل استبعاد.

ما يتضمنه كل طلب دمج (pull request) يُنجَز بمساعدة الذكاء الاصطناعي. المهمة التي نفّذها، وحجم الـ diff، والأوامر التي نجحت. وإذا لم يستطع طلب الدمج أن يحدّد ملف المهمة الذي جاء منه، فهو لم يأتِ من أي ملف مهمة.

ما لا يدخل في برومبت أبداً. بيانات العملاء، وبيانات الاعتماد (credentials)، وكل ما يخضع لاتفاقية عدم إفصاح (NDA).

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

أين تُكتب الاستثناءات. ستعرف كل قاعدة مما سبق استثناءً: خاصية @Input() تقليدية تبقى على مكوّن AngularJS جرت ترقيته، وسكريبت لمرة واحدة معفى من سقف الحجم، وعيّنة بيانات اصطناعية يُسمح بإدخالها في برومبت لأن لا شيء فيها حقيقي. ويُسجَّل كل استثناء في ADR قصير ومؤرَّخ يذكر السبب، و AGENTS.md يشير إلى المجلد، فيقرأها الوكيل أيضاً.

“

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

هذه هي السياسة. صفحة واحدة. تحتاج كتابتها إلى ظهيرة واحدة من وقت الفريق، وهي الظهيرة التي تحدّد هل يكون العام المقبل عام الفريق الأسرع أم عام المشروع الميت.

الأرقام، وإلا بقيت إحساساً

لدى الإدارة اليوم رقم واحد: العرض التوضيحي استغرق ظهيرة. أما الفريق فلا رقم لديه، والإحساس بالسرعة ليس رقماً: ففي إحدى التجارب مطلع 2025، توقّع مطوّرون متمرّسون أن يجعلهم الذكاء الاصطناعي أسرع بنسبة 24%، فإذا به يجعلهم أبطأ بنسبة 19%.¹ لذلك فالنصف الثاني من السياسة خمسة أرقام، لكل وحدة، تُتابَع للطريقة السريعة ولطريقة الفريق جنباً إلى جنب:

المقياس	كيف تحصل عليه	لماذا يهم الإدارة
زمن الدورة لكل تغيير	من فتح التذكرة إلى الدمج، بأيام العمل (وليس مقياس lead time لدى DORA، من الـ commit إلى النشر2)	يستبدل ظهيرة العرض برقم حقيقي
إعادة العمل في المراجعة	الأسطر المغيّرة في المراجعة مقسومة على أسطر أول طلب دمج	كم من "السريع" أُعيد عمله
حِمل المراجعة	التعليقات وساعات المراجعة لكل طلب دمج	الكلفة الخفية للـ diff الكبير
العيوب المتسربة	الأخطاء في الوحدة خلال 30 يوماً بعد الإصدار	ينهي جدال "يعمل على الشاشة"
حجم طلب الدمج	الملفات والأسطر لكل طلب دمج	الرافعة التي يتحكم فيها الفريق مباشرة

وقد رأت فرق أخرى هذا النمط في الطريقة السريعة. ففي دراسة شملت 10,000 مطوّر، اقترن الاعتماد الواسع على الذكاء الاصطناعي بزيادة 98% في طلبات الدمج التي اكتمل دمجها، وبطلبات أكبر حجماً بنسبة 154%، ومراجعات أطول بنسبة 91%.³ والتغييرات الصغيرة تتلقى أولى تعليقات المراجعة بسرعة أكبر⁴، ووجدت DORA أن العمل على دفعات صغيرة يعزّز الأثر الإيجابي للذكاء الاصطناعي على المنتج.⁵

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

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

اقرأ AGENTS.md، و package.json (السكريبتات فيه)، وإعدادات lint وإعدادات حدود المكتبات، و docs/tasks/TEMPLATE.md، وأوصاف آخر عشرة طلبات دمج إن وُجدت في المستودع (gh pr list). صِغ سياستنا للذكاء الاصطناعي في صفحة واحدة تحت هذه العناوين: ما يجوز للوكيل أن يمسّه؛ ما يتضمنه كل طلب دمج بمساعدة الذكاء الاصطناعي؛ ما لا يدخل في برومبت أبداً؛ الأداة المعتمدة وأين توضع إضافاتها؛ أين تُسجَّل الاستثناءات. حيث ينصّ المستودع على قاعدة أصلاً، استشهد بالملف واذكر هل تفرضها أداة أم يكتفي نص بذكرها. وحيث لا توجد القاعدة إلا في أذهان الناس، اكتب "UNWRITTEN" واقترح السطر. لا تخترع قواعد لا يلمّح إليها المستودع.

قائمة "UNWRITTEN" هي الحصيلة الحقيقية. إنها الفجوة بين السياسة التي يعتقد الفريق أنه يملكها والسياسة التي يستطيع الوكيل أن يقرأها.

السؤال الذي يحسم الأمر

حين يُقدَّم العرض التوضيحي أمام الإدارة، وسيُقدَّم حتماً، يكفي سؤال واحد لحسم معظم الاجتماع:

“

هل تريد أن يعمل هذا هذه السنة فقط، أم تريده آمناً ومُصاناً بعد خمس سنوات؟

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

مع بداية الأسبوع

• اكتب سياسة الصفحة الواحدة. ظهيرة واحدة، الفريق كله، العناوين الخمسة أعلاه.
• ابدأ تتبّع الأرقام الخمسة في الوحدة التالية، بالطريقتين، بصدق.
• ضع السياسة في المستودع بجانب AGENTS.md، حتى يقرأها الوكيل أيضاً.

التمرين: شغّل البرومبت أعلاه على المستودع التجريبي. فملف AGENTS.md وإعدادات lint و docs/tasks/TEMPLATE.md تغطي أصلاً معظم العناوين.

المصادر

1. METR, Measuring the Impact of Early-2025 AI on Experienced Open-Source Developer Productivity, يوليو 2025
2. DORA, DORA's software delivery performance metrics
3. Faros AI, The AI Productivity Paradox Report 2025, يوليو 2025
4. Sadowski وآخرون, Google, Modern Code Review: A Case Study at Google, ICSE-SEIP 2018
5. DORA, Introducing DORA's inaugural AI Capabilities Model, سبتمبر 2025
6. DORA, How to measure the business value of generative AI, يونيو 2026

---

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