تقارب الأعراف عبر أُطُر العمل
كيف يُبقي Apothem سير عمل المشغِّل الواحد متسقًا عبر سبعة عشر إطار عمل، رغم اختلاف صيغ التهيئة وأسطح التطبيق بين الموردين.
سبعة عشر إطار عمل، وسبعة عشر رأيًا حول أين تعيش التهيئة وأي شكل تتخذه. مهمة Apothem هي جعل سير عمل المشغِّل يبدو متطابقًا عبرها جميعًا — تكتب الأعراف مرة واحدة، فتتصرف بالطريقة نفسها سواء لجأت إلى Claude Code أو Cursor أو Gemini CLI. تتناول هذه التدوينة الاختلافين اللذين يوفِّق بينهما Apothem: صيغة التهيئة وسطح التطبيق.
اختلاف الصيغة
يقرأ كل إطار عمل قواعده من شكل ملف مختلف. يحتفظ ملف تعريف Apothem بنيّة المشغِّل في شكل محايد واحد؛ ويُحوِّل كل محوِّل تلك النيّة إلى الشكل الذي يتوقعه إطار عمله.
| الشكل | أُطُر العمل (أمثلة) | ما يُخرجه Apothem |
|---|---|---|
ملفات قواعد .md مسطّحة في دليل | claude-code | ملفات قواعد خام تُنسَخ إلى شجرة قواعد إطار العمل |
| ملف قواعد مدموج واحد في دليل قواعد | windsurf وtrae | ملف apothem-rules.md واحد بالبيانات الأمامية للتفعيل التي يقرؤها إطار العمل |
قواعد 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 هو شبكة أمان التقارب لكل إطار عمل يفتقر إلى التطبيق الأصلي.
اقرأ سطح التطبيق لكل إطار عمل في أُطُر العمل، وميكانيكا المحوِّلات في التحليل المعمَّق لتصميم المحوِّلات.