# دراسة تقيس ترهّل الكود: كود الـ agents ضعف كود البشر في مقياسين

> **المغزى:** الكود المترهل يعمل ويجتاز الاختبارات والمراجعة، لكن تكلفته تظهر في التعديل التالي لا في الـ PR الحالي، ولذلك يصعب رصدها دون مقياس.

- المصدر: المغزى (https://almaghza.com/a/2026-09-12-measuring-agent-code-sloppiness/)
- التاريخ: 1 ربيع الآخر - 12 سبتمبر 2026 (2026-09-12)
- القسم: برمجيات
- الوسوم: مراجعة الكود، AI Agents، Vibe Coding

نُشرت في 10 سبتمبر 2026 على موقع earendil.com مقالة تقترح مقياسين لما يوصف عادة بترهّل الكود، بدل الاكتفاء بالحديث عنه انطباعيًا. وطُبّق المقياسان على بيانات SlopCodeBench، فجاء كود الـ agents قرابة ضعف كود المستودعات البشرية في كليهما.

المقياس الأول اسمه Verbosity، ويقيس نسبة الأسطر المكررة أو الزائدة عن الحاجة إلى مجموع الأسطر. ويُحسب باستخدام AST-Grep وأدوات كشف الاستنساخ. وكانت النتيجة 0.15 للمستودعات البشرية، مقابل 0.33 لكود الـ agents.

والمقياس الثاني، وهو الأهم، اسمه Erosion. ويقيس مقدار تعقيد المشروع المتكدس في دوال كبيرة، أي نسبة الكود الموجود داخل دوال يتجاوز تعقيدها الدوري 10. والتعقيد الدوري مقياس لعدد المسارات المستقلة داخل الدالة، وكلما ارتفع صعب فهمها واختبارها. وجاءت النتيجة 0.31 للمستودعات البشرية، مقابل 0.68 للـ agents. أي أن ثلثي تعقيد المشروع يقع في الدوال الأصعب صيانة.

ويشير الكاتب إلى أن أبسط مقياس ممكن، وهو مجرد الفرق في عدد الأسطر، كان فعالًا على نحو مفاجئ. لكن عيبه أنه يتحول إلى هدف بمجرد أن يبدأ الفريق في قياسه.

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

أي أن التكلفة لا تظهر في الـ pull request الحالي، بل في الذي يليه. ومع اتساع حصة الـ agents في كتابة الكود، يصبح وجود مقياس لهذا النوع من الدَّين التقني شرطًا لرؤيته قبل أن يتراكم، لأن المراجعة التقليدية القائمة على صحة السلوك لن تلتقطه.

## المصادر

- [المقالة كاملة بطريقة القياس والأرقام](https://earendil.com/posts/measuring-code-sloppiness/)
- [AST-Grep، أداة قياس الـ verbosity](https://ast-grep.github.io/)
- [النقاش على Hacker News](https://news.ycombinator.com/item?id=49658311)
