Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents

تخيل أن لديك مكتبة قديمة ومغبرة مليئة بآلاف الكتب المكتوبة بخط اليد. تحتوي هذه الكتب على قواعد إدارة بنك، لكنها مكتوبة بلغة لم يعد أحد يتحدث بها (مثل لغة COBOL)، والحبر فيها باهت، ولا توجد لها جداول محتويات أو فهارس. المؤلفون الأصليون رحلوا منذ زمن بعيد، والوحيدون الذين يعرفون كيفية قراءتها هم عدد قليل من أمناء المكتبة المسنين الذين يستعدون للتقاعد.

الآن، تخيل أنك تريد توظيف فريق من الروبوتات فائقة الذكاء والسرعة (وكلاء الذكاء الاصطناعي - AI agents) لإعادة كتابة هذه القواعد بلغة حديثة (مثل لغة Go) حتى يتمكن البنك من العمل على أجهزة كمبيوتر جديدة. المشكلة هي أنه إذا قلت للروبوتات فقط: "اذهبوا وأصلحوا هذا"، فقد يخطئون في التقدير. قد يظنون أن قاعدة ما تعني شيئاً، بينما هي في الواقع تعني شيئاً آخر، مما قد يؤدي إلى انهيار البنك.

تقدم هذه الورقة البحثية Reversa، وهو إطار عمل جديد صُمم لحل هذه المشكلة تحديداً. لا تنظر إلى Reversa كعصا سحرية تترجم الكود فوراً، بل كـ "مصنع متخصص للتوثيق العكسي".

إليك كيف يعمل، باستخدام تشبيهات بسيطة:

١. المشكلة: النظام القديم "الصامت"

الأنظمة البرمجية القديمة تشبه منزلاً غادر صاحبه منذ ٢٠ عاماً. الأضواء لا تزال تعمل، والثلاجة تصدر طنيناً، ولكن لا أحد يعرف لماذا تم توصيل ضوء المطبخ بباب المقدمة، أو ماذا سيحدث إذا قمت بتشغيل الفرن أثناء تشغيل الغسالة. القواعد مخفية داخل الجدران (الكود). إذا حاولت تجديد المنزل دون معرفة هذه القواعد الخفية، فقد تفصل الكهرباء عن الحي بأكمله عن طريق الخطأ.

٢. الحل: فريق من المحققين الآليين المتخصصين

بدلاً من طلب روبوت واحد لقراءة المنزل بالكامل وتخمين القواعد، يرسل Reversa فريقاً من الوكلاء المتخصصين، لكل منهم وظيفة محددة، مثل خط الإنتاج:

• المستكشف (The Scout): يتجول في المنزل أولاً. "حسناً، هناك ٥ غرف، وقبو، وباب غريب في المطبخ". (يرسم خريطة لسطح المشروع).
• عالم الآثار (The Archaeologist): يحفر داخل الجدران. "لق Bl وجدت مخططاً هنا يقول إن هذا الأنبوب يتصل بذلك الصمام". (يحلل الوحدات البرمجية - Modules).
• المحقق (The Detective): يبحث عن الأدلة. "لماذا تم توصيل الضوء بالباب؟ آه، الملاحظات تقول إنه ميزة أمنية". (يستخرج قواعد العمل الخفية).
• المهندس المعماري (The Architect): يرسم خريطة جديدة بناءً على ما تم العثور عليه. "إذاً، المطبخ هو قلب المنزل، والقبو يحتوي على المياه". (يصيغ الهيكلية).
• الكاتب (The Writer): يكتب القواعد بوضوح. "القاعدة رقم ١: إذا فُتح الباب، يضيء النور". (يكتب المواصفات).
• المراجع (The Reviewer): وهو الأهم. يقوم بمراجعة عمل الكاتب. "انتظر، هل وجدنا ملاحظة عن الضوء؟ لا؟ إذاً لا يمكننا الجزم بذلك. لنضع علامة 'ربما' أو 'نحتاج إلى بشر للتحقق من هذا'". (يراجع مستوى الثقة والفجوات).

٣. السر الخفي: "الثقة" و"الفجوات"

معظم أدوات الذكاء الاصطناعي تحاول أن تبدو واثقة بنسبة ١٠٠٪، حتى عندما تكون مجرد تخمين. أما Reversa فهو مختلف؛ حيث يستخدم نظام إشارات المرور لكل قاعدة يجدها:

• 🟢 الأخضر (مؤكد): وجدنا هذا في الكود. إنها حقيقة.
• 🟡 الأصفر (مُستنتج): لم نجد ملاحظة مباشرة، لكن النمط يوحي بذلك. إنه تخمين ذكي، لكن كن حذراً.
• 🔴 الأحمر (فجوة): ليس لدينا أدنى فكرة. الكود يفتقر لهذه المعلومة. توقف! نحتاج إلى بشري يأتي إلى هنا ويخبرنا بما يجب فعله.

هذا أمر بالغ الأهمية، لأنه يمنع الروبوتات من ارتكاب أخطاء بثقة عمياء. إنه يخبر الإنسان: "نحن نعرف ٩٧٪ من القواعد، ولكن إليكم الـ ٣٪ التي نحتاج فيها إلى مساعدتكم".

٤. النتيجة: "عقد" للروبوتات

المخرج ليس مجرد دليل ممل للقراءة البشرية، بل هو "عقد تشغيلي" لوكلاء الذكاء الاصطناعي. يقول العقد:

• "إليك ما يفعله النظام".
• "إليك الدليل (أي ملف في الكود القديم وجدنا فيه هذه القاعدة)".
• "إليك ما لا نعرفه بعد".

هذا يسمح لوكلاء الذكاء الاصطناعي بإعادة كتابة النظام القديم بأمان (التحول من COBOL إلى Go) لأن لديهم خريطة واضحة ويعرفون تماماً أين تقع "ضبابية الحرب" (عدم اليقين).

٥. الاختبار الواقعي: آلة الصراف الآلي (ATM)

اختبر المؤلفون هذا على مشروع حقيقي (ولكن بسيط): آلة صراف آلي قديمة مكتوبة بلغة COBOL كانت بحاجة لإعادة بناء بلغة Go.

• العملية: قاموا بتشغيل مسار عمل Reversa.
• المخرجات: أنتج النظام ٥١٧ "ادعاءً" (قاعدة). حدد ٤٩٠ منها كحقائق، و٢٤ كتخمينات، ووجد ٣ قطع مفقودة (فجوات).
• دور البشر: تدخل البشر لحل القطع المفقودة و"التخمينات".
• النتيجة: وضعوا خطة لإعادة بناء الصراف الآلي وكتبوا ٥٣ سيناريو اختبار (مثل: "إذا وضعت ٢٠ دولاراً، يجب أن أستلم ٢٠ دولاراً"). نجحوا في بدء عملية إعادة البناء، وأكملوا ٩ من أصل ١١ مهمة رئيسية.

ما لا تدعيه هذه الورقة البحثية

من المهم معرفة ما لا تدعيه هذه الورقة:

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

باختمُ الخلاصة

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