عندما تدخل مشروعًا برمجيًا كبيرًا، المشكلة ليست دائمًا كتابة الكود؛ بل معرفة أين تبدأ وكيف ترتبط مئات الملفات والدوال والخدمات ببعضها. مشروع Understand Anything المفتوح المصدر يحاول حل هذه المشكلة بتحويل الـCodebase إلى Knowledge Graph تفاعلي يمكنك استكشافه والبحث فيه وطرح الأسئلة عليه.
ما هو Understand Anything؟
المشروع يحلل الكود عبر Pipeline متعدد الوكلاء يجمع بين التحليل البنيوي وفهم السياق، ثم يبني خريطة معرفة للملفات والدوال والكلاسات والاعتماديات والعلاقات المعمارية. النتيجة Dashboard تفاعلية بدل أن تضطر لقراءة الملفات واحدًا تلو الآخر بحثًا عن الصورة الكاملة.
ماذا تستطيع أن تفعل به؟
- استكشاف الملفات والدوال والكلاسات وعلاقاتها بصريًا.
- البحث بالاسم أو بالمعنى داخل المشروع.
- قراءة شروحات مبسطة للعناصر ولماذا توجد داخل المعمارية.
- الحصول على Guided Tours مرتبة لفهم أجزاء النظام بالترتيب.
- تحليل أثر التغييرات ومعرفة الأجزاء التي قد تتأثر قبل الـCommit.
- إنشاء Onboarding Guide لمساعدة المطور الجديد على فهم المشروع.
كيف يعمل تحت الغطاء؟
وفق وثائق المشروع، يشغّل أمر التحليل مجموعة وكلاء متخصصة: وكيل لمسح المشروع واكتشاف اللغات والأطر، وآخر لاستخراج الدوال والكلاسات والاستيرادات، ومحلل للطبقات المعمارية، وباني جولات تعليمية، ومراجع للتحقق من اكتمال الرسم وسلامة العلاقات. ويمكن تشغيل تحليل إضافي لاستخراج مجالات العمل والـFlows والخطوات التجارية داخل النظام.
ليس حكرًا على Claude Code
رغم أن المشروع بدأ كإضافة أصلية لـClaude Code، فإن المستودع الحالي يوضح دعمه لمنصات أخرى، منها Codex وCursor وCopilot وGemini CLI وOpenCode وغيرها. هذا يجعله طبقة فهم للكود يمكن أن ترافق أكثر من مساعد برمجي بدل الارتباط ببيئة واحدة فقط.
سيناريو عملي
تخيل أنك استلمت مشروع متجر إلكتروني كبير وتريد تعديل تسجيل الدخول. بدل البحث يدويًا عن كل ملف متعلق بالمصادقة، تستطيع بناء الخريطة ثم السؤال عن مسار Authentication، استكشاف العقد المرتبطة، ومعرفة الخدمات والواجهات والدوال التي يعتمد عليها المسار. وعند تعديل جزء منه، يمكن استخدام تحليل الـDiff لاستكشاف الأثر المحتمل على بقية النظام.
ميزة مهمة للفرق
خريطة المعرفة تُحفظ كبيانات JSON ويمكن مشاركتها مع الفريق، ما يسمح للمطورين الآخرين بالاستفادة من الخريطة بدل إعادة بناء الفهم من الصفر. كما يدعم المشروع التحديث التدريجي بحيث يعيد تحليل الملفات التي تغيرت بدل إعادة تحليل المشروع كاملًا في كل مرة.
هل المشروع جاد؟
المستودع الرسمي على GitHub مفتوح المصدر بترخيص MIT، ويظهر حاليًا بأكثر من 83 ألف نجمة وآلاف الـForks. أرقام GitHub تتغير باستمرار، لذلك تعامل معها كمؤشر لحظي على الاهتمام بالمشروع لا كمعيار وحيد للجودة.
متى يكون مفيدًا فعلًا؟
الفائدة الأوضح تظهر مع المشاريع المتوسطة والكبيرة، الـLegacy Code، الانتقال إلى فريق جديد، مراجعة Pull Requests واسعة، أو عندما يستخدم وكيل برمجي يحتاج إلى Context معماري أوسع من الملفات المفتوحة أمامه. أما المشاريع الصغيرة جدًا فقد تكون الخريطة أكثر مما تحتاجه.
المصدر
المستودع الرسمي لـUnderstand Anything على GitHub
بحسب اهتمامك: هذه المقالة ضمن «مقالات Let’sDoAI ← برمجة»، حيث نجمع أدوات البرمجة بالذكاء الاصطناعي والوكلاء والمشاريع المفتوحة المصدر التي تستحق التجربة.