اختبارات المواصفات تعالج الانجراف المعماري: الوكيل صحّح 637 حجم خط دفعة واحدة

هناك تجربة معروفة: تطلب من ChatGPT نسخ صورة نسخاً مطابقاً دون تغيير أي شيء، ثم تكرر ذلك 101 مرة. تنتهي صورة دواين جونسون بخليط كرتوني مشوّه. كل خطوة على حدة تكاد تكون أمينة، لكن المحصلة شيء مختلف تماماً.

الأمر نفسه يحدث مع الشيفرة التي يتولاها وكيل ذكاء اصطناعي. يسمّي كاتب التحليل ذلك الانجراف المعماري. ومثال الواجهة الأمامية هو الأوضح: الخط محدد وموحد في كل مكان، لكن الأحجام تختلف في كل صفحة، فينهار الأسلوب العام للموقع. والمبدأ عام في كل مجالات التطوير: يتشتت source of truth.

الحقيقة في المواصفات لا في الشيفرة

المؤلف لا يقرأ الشيفرة إطلاقاً، بل يراقب المواصفات فقط. المنطق: المواصفات هي المخطط، والشيفرة هي القطعة، وتُقارَن القطعة بالمخطط لا بقطعة أخرى. مصدران للحقيقة يعنيان الفوضى.

كل الوثائق موجودة في مجلد docs في جذر المشروع. حتى 5 نوفمبر 2026 يضم 7 478 ملف .md و11 مستوى من التداخل. في 95,3% من المجلدات لا يزيد عدد الملفات على 7، وفي 97,4% لا يزيد على 9. هذه قاعدة «7 زائد أو ناقص 2»: يسهل على الإنسان (وعلى الوكيل) فهم مكان كل شيء. المواصفات يكتبها ويقرؤها الوكلاء، بينما يطّلع عليها الإنسان في لوحة الإدارة بشكل مريح.

مثال: جميع قواعد الطباعة في ملف واحد هو typography.md. فيه 22 دوراً، ولكل دور عائلة خط، وحجم على سطح المكتب والجوال، ووزن ولون. فمثلاً فقرة المقال بخط Charis بقياس 21/30، والأساس بخط Inter بقياس 14/21. عائلتان فقط للموقع كله، وأوزان 400 و700 فقط. القاعدة الرئيسية: لا وجود لحالات خارج السجل، وأي توليفة جديدة تعني سطراً جديداً بعد الموافقة.

إجبار الوكيل على القراءة والتحقق بشكل حتمي

المواصفات بحد ذاتها تعمل احتمالياً: قد يتبعها الوكيل وقد لا يتبعها. لذلك توجد طبقتا حماية.

الأولى ملف AGENTS.md. فيه نصّ على أن الوكيل يقرأ قبل المهمة الوثائق من المجلد المعني. إذا لزم تدقيق في نفقات السحابة، يذهب إلى مجلد السحابة ويدرس جميع المزودين. وبتقدير المؤلف، لا تُنتهك القواعد في 9 حالات من 10.

الطبقة الثانية هي اختبارات المواصفات لـ«الحالة العاشرة». يقرأ الاختبار الجداول من typography.md، ويجمع أزواج الأحجام المسموحة، ثم يفحص الواجهة الأمامية كلها. أي زوج خارج المواصفات يُفشل البناء مع اسم الملف والسطر.

ما كشفه الاختبار

حتى 6 نوفمبر كان الاختبار قائمة سوداء من تسعة أزواج قديمة. وعندما أعدّ المؤلف المقال تبيّن أن في الشيفرة نحو 150 زوجاً خارج المواصفات. وفي جولة واحدة طابق الوكيل 637 استخداماً مع المواصفات، وأضاف إليها 4 أسطر ناقصة، وأعاد كتابة الاختبار كقائمة بيضاء. وهذا هو الدرس العملي الأهم: القائمة السوداء تلتقط ما تعرفه مسبقاً فقط، أما البيضاء فتلتقط كل ما عداه.

إذا تباعدت الوثائق والشيفرة رغم ذلك، يفيد هذا الترتيب: الاختبارات أولاً، ثم self-heal على بيئة الإنتاج (يعد المؤلف بمقال منفصل)، ثم الإنسان أخيراً. مهمته ليست اصطياد الخلل، بل فهم سبب مروره وسدّ هذه الثغرة.

القيود والخلاصة

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

الخلاصة العملية لمن يعمل مع الوكلاء: انقلوا القواعد إلى مواصفات مقروءة آلياً، واكتبوا في AGENTS.md قراءة إلزامية قبل المهمة، وحوّلوا أكثر الانحرافات تكراراً إلى اختبارات بقوائم بيضاء. وقد نشر المؤلف الهيكل نفسه (AGENTS.md وCLAUDE.md ومجلد docs بلا شيفرة) على GitHub، فيمكن البدء من قالب جاهز.