محرّك القواعد الذكي

يحوّل محرّك القواعد الذكي ملف MORAYA.md الخاص بقاعدة معرفتك إلى نظام سياق فعّال يُحمّل عند الطلب لمساعد الذكاء الاصطناعي — بحيث لم تعد ملفات القواعد الكبيرة تُقتطع بشكل قاسٍ أو تُحتسب كاملةً في كل رسالة.

المشكلة التي يحلّها

في السابق، كان ملف MORAYA.md يُحقن في موجّه نظام الذكاء الاصطناعي بحدّ أقصى ثابت من الأحرف. وقد سبّب ذلك ثلاث مشكلات: قد تُقطع القواعد في منتصف الجملة، وترفع الملفات الكبيرة تكاليف الرموز في كل طلب، وكان على الذكاء الاصطناعي أن يخمّن متى يعيد قراءة الملف.

يستبدل محرّك القواعد “اقتطاع الملف الواحد” بـ التقسيم التلقائي + التحميل المفهرس عند الطلب. لا تزال تحتفظ بملف واحد؛ ويقوم Moraya بترجمته إلى مقاطع قواعد لا يحمّلها الذكاء الاصطناعي إلا عند صلتها بالموضوع.

كيف يعمل

عند حفظ MORAYA.md، يقارن Moraya بصمة تجزئة لمحتواه. وإذا تغيّر، يُقسَّم الملف حسب عناوينه من المستوى الأعلى إلى مقاطع ضمن دليل مشتق .moraya/rules/:

• مقاطع موسومة بأنماط glob — المقطع المشروح بـ <!-- globs: ... --> يُحمّل تلقائياً كلما حرّرت ملفاً مطابقاً (تحميل شرطي عالي الأولوية).
• مقاطع غير موسومة — مفهرسة حسب العنوان؛ يقرأ الذكاء الاصطناعي المقطع الكامل عند الطلب عبر أدوات الملفات لديه.
• بلا بنية عناوين — يعود الملف إلى حقن الملف كاملاً (السلوك القديم دون تغيير)، وتقترح الواجهة إضافة عناوين.

يحمل موجّه النظام عندئذٍ فهرساً مضغوطاً بالإضافة إلى محتوى أي مقطع مطابق لنمط glob، بدلاً من الملف بأكمله.

مبادئ التصميم

إضافة قواعد شرطية

لتحديد نطاق قاعدة لملفات معيّنة، أضِف تعليق glob تحت عنوانها:

## API documentation style
<!-- globs: docs/api/**/*.md -->

- Every endpoint must document its error responses.
- Use `snake_case` for JSON field names.

الآن يُحقن هذا المقطع فقط عندما تحرّر ملفاً ضمن docs/api/. أما المقاطع دون تعليق glob فتبقى في الفهرس ويسحبها الذكاء الاصطناعي عندما تكون ذات صلة بالمحادثة.

نصائح

• احتفظ بكل قاعدة تحت عنوان واضح ووصفي — يصبح العنوان مدخل الفهرس الذي يطابقه الذكاء الاصطناعي.
• اجمع القواعد واسعة التطبيق (النبرة، المصطلحات) دون أنماط glob؛ وحدّد نطاق القواعد الضيّقة (أعراف لكل مجلد) بأنماط glob.
• من الآمن حذف الدليل المشتق .moraya/ — فهو يُعاد بناؤه عند الحفظ التالي.