تقارب الأعراف عبر البيئات
كيف يُبقي Apothem سير عمل المشغِّل الواحد متسقًا عبر سبع عشرة بيئة، رغم اختلاف صيغ التهيئة وأسطح التطبيق بين الموردين.
سبع عشرة بيئة، وسبعة عشر رأيًا حول أين تعيش التهيئة وأي شكل تتخذه. مهمة Apothem هي جعل سير عمل المشغِّل يبدو متطابقًا عبرها جميعًا — تكتب الأعراف مرة واحدة، فتتصرف بالطريقة نفسها سواء لجأت إلى Claude Code أو Cursor أو Gemini CLI. تتناول هذه التدوينة الاختلافين اللذين يوفِّق بينهما Apothem: صيغة التهيئة وسطح التطبيق.
اختلاف الصيغة
تقرأ كل بيئة قواعدها من شكل ملف مختلف. يحتفظ ملف تعريف Apothem بنيّة المشغِّل في شكل محايد واحد؛ ويُحوِّل كل محوِّل تلك النيّة إلى الشكل الذي تتوقعه بيئته.
| الشكل | البيئات (أمثلة) | ما يُخرجه Apothem |
|---|---|---|
ملفات قواعد .md مسطّحة في دليل | claude-code وwindsurf وtrae | ملفات قواعد خام تُنسَخ إلى شجرة قواعد البيئة |
قواعد Cursor بصيغة .mdc | cursor | مجموعة قواعد .mdc تحمل ترويسة بيانات التعريف التي يتوقعها Cursor |
| مستند تعليمات بملف واحد | codex وgemini-cli وgithub-copilot وzed | مستند واحد مُسلسَل —AGENTS.md وGEMINI.md وcopilot-instructions.md و.rules— مُجمَّع من مجموعة قواعد ملف التعريف |
تأخذ بيئة .md المسطّحة القواعد حرفيًا. تحتاج بيئة .mdc إلى لفّ ترويسة بيانات
تعريف Cursor حول كل قاعدة. تحتاج بيئة الملف الواحد إلى تسطيح مجموعة
القواعد كاملةً في مستند واحد بترتيب أقسام ثابت، حتى يقرأ المشغِّل الأعراف نفسها
بالتسلسل نفسه أيًّا كان الهدف. ملف التعريف المحايد هو مصدر الحقيقة الوحيد؛ ويعيش
الاختلاف بالكامل في خطوة التحويل داخل كل محوِّل.
ترتيب الأقسام هو مرساة التقارب
تسطيح قواعد كثيرة في مستند واحد يخاطر بخلطها بين البيئات، فتحطّ الأعراف نفسها
بترتيب في AGENTS.md يختلف عن ترتيبها في GEMINI.md. يثبِّت Apothem
الترتيب على مستوى ملف التعريف: لمجموعة القواعد تسلسل مُعلَن، ويجتازه كل محوِّل ملف
واحد بذلك الترتيب. والمشغِّل الذي يحفظ في بيئة أن «أعراف التسمية تأتي قبل أعراف
الالتزام» يجد التسلسل نفسه في كل بيئة أخرى. التقارب ليس مصادفة في التحويل — بل خاصية
يثبِّتها ملف التعريف.
اختلاف التطبيق
صيغة التهيئة هي النصف المرئي. النصف الأصعب هو التطبيق: كيف يُحاسَب على عرف ما في اللحظة التي يتصرف فيها المشغِّل (أو العميل).
خطّافات PreToolUse الأصلية
تكشف claude-code وcodex وqwen-code عن أسطح خطّافات أصلية. يُطلَق خطّاف PreToolUse قبل تنفيذ استدعاء الأداة، ويفحصه، ثم يحظره أو يعيد كتابته. هذا تطبيق آنيّ: قاعدة تمنع كتابة مخرجات التخطيط في موضع عام تصبح خطّافًا يرفض الكتابة قبل أن تمسّ القرص. يُحوِّل Apothem هذه الخطّافات مباشرة إلى تهيئة خطّافات البيئة، فيطبِّق زمن تشغيل البيئة العرف.
انضباط قائم على التغليف في غيرها
لا تكشف البيئات المتبقية عن سطح خطّاف ما قبل التنفيذ المكافئ الذي يملكه Apothem. لا يستطيع Apothem تركيب بوابة زمن تشغيل حيث لا تقدّم البيئة مأخذًا لها. وبدلًا من ذلك، يُحمَل العرف بوصفه نص تعليمات داخل التهيئة المُحوَّلة — يقرأ العميل القاعدة ويلتزم بها، لكن لا توجد آلية زمن تشغيل تعترض فعلًا مخالفًا. يجعل Apothem الفرق صريحًا بدلًا من ادّعاء وجود تكافؤ: العرف المدعوم بخطّاف والعرف المدعوم بتعليمات ليسا ضمانة واحدة، ويرى المشغِّل أي البيئات تطبِّق في زمن التشغيل وأيها يعتمد على انضباط التعليمات.
ما يعنيه التقارب عمليًّا
يكتب المشغِّل عرفًا واحدًا. يُحوِّله Apothem إلى سبع عشرة صيغة، ويُرفق به أقوى تطبيق تدعمه كل بيئة — خطّاف أصلي حيث يوجد السطح، ونص تعليمات حيث لا يوجد. يتقارب سير العمل؛ وتُذكَر الضمانات بصدق لكل بيئة.
ولهذا يهمّ apothem verify على كل الجبهات: حيث لا يستطيع أي خطّاف زمن تشغيل التقاط
الانحراف، يُشغِّل المشغِّل verify لرصد تهيئة بيئة انحرفت عن ملف التعريف. أمر
verify هو شبكة أمان التقارب لكل بيئة تفتقر إلى التطبيق الأصلي.
اقرأ سطح التطبيق لكل بيئة في البيئات، وميكانيكا المحوِّلات في التحليل المعمَّق لتصميم المحوِّلات.