سجلّ المطابقة الخارجية — عند العمل على المشاريع المُضيفة
سجلّ التفويضات الخمسة عشر (M1–M15) الذي يحدّد متطلّبات المطابقة لجميع الآثار المُولَّدة في المشاريع المُضيفة، مع تخطيط متقاطع للتفويضات الداخلية للنظام البيئي.
سجلّ كانوني للتفويضات الإنتاجية الخمسة عشر. يحمل هذا المستند سجلّ التفويضات الخمسة عشر الكامل (M1–M15)، وإقرار عتبة التافه-مقابل-غير-التافه، وسياسة التخطيط المتقاطع M↔CM، وبروتوكول إدخال التفويض؛ وتعيش التعدادات الجوهرية هنا، وتُفعَّل بواسطة ملفات القواعد الخاصة بكل تفويض.
عندما يُولّد هذا النظام البيئي أيّ أثر في مشروع مُضيف أو يُحرّره أو يُعيد صياغته أو يُحدّثه بأثر رجعي أو يُوسّعه أو يُزيله (هدف الاستدعاء الخاص بالمشغّل — مستودع git، شجرة وثائق، مجموعة بحثية، بيان بنية تحتية، مسوّدة)، فإنّ كل أثر مُنتَج يستوفي حاجز التفويضات الخمسة عشر (M1–M15) المُعلَن أدناه. هذا أمر غير قابل للتفاوض ويسري على كل سطح من النظام البيئي (skill، assistant، command، خطّاف، استجابة، diff، رسالة). الإنفاذ هو بوّابة ما قبل الإصدار (راجع site/content/docs/governance/pre-emission-gate-registry.mdx)؛ يعيش إنفاذ الجزء-الآلي في src/apothem/conformity/*-grep.py بتنسيق من src/apothem/conformity/gate.py.
تعمل التفويضات الخمسة عشر جنبًا إلى جنب مع تفويضات CM-N وفق سياسة المفردات-المتوازية (راجع site/content/docs/governance/cross-cutting-mandates.mdx)؛ M وCM بُعدان حوكميان متعامدان (M هو المحور الخارجي — آثار المشروع المُضيف؛ CM هو المحور الداخلي — الآثار الداخلية للنظام البيئي). كل قاعدة مدرجة أدناه هي البيت الكانوني لتفويضها؛ وهذا السجلّ هو الفهرس.
| المُعرِّف | التفويض | ملخّص سطر واحد | القاعدة الكانونية |
|---|---|---|---|
| M1 | حياد المشروع المُضيف | اكتشف المكدّس التقني للمُضيف وأداة التنسيق وأداة الفحص والتخطيط والاصطلاحات؛ التزم بها؛ اعرض الصمت كاستفسار وفق M5 مع وصم M7 | src/apothem/rules/host-discovery.md |
| M2 | الانضباط التحريري | أفصِح عن كل تعديل / توسعة / صقل مع المبرّر؛ لا امتثال زائد صامت، ولا تجاوز صامت للنطاق | src/apothem/rules/disclosure-ledger.md |
| M3 | أبعاد الجودة العشرة | يجتاز كل مُنتَج فحص الأشرطة العشرة (الصرامة، والتماسك، وقابلية الإعداد، وقابلية القراءة، واليُتْم، والبنيوية، والمعمارية، والتسمية، والإسناد العلمي، والأمثلة / الاختبارات / الوثائق) | src/apothem/rules/ten-dimension-check.md |
| M4 | التطبيق الذاتي | شغّل بوّابة ما قبل الإصدار ذات الخمسة عشر شريطًا قبل كل إصدار ذي نطاق ذي معنى؛ وسجّل نتيجة البوّابة | src/apothem/rules/pre-emission-gate.md |
| M5 | مبدأ السلطة | استفسِر، لا تخترع؛ بيانات الهوية / النطاق / التفضيل / الأمن / التسمية / البنية التحتية / تثبيت الإصدار لا تُلفَّق أبدًا | src/apothem/rules/authority-inquiry.md |
| M6 | دمج الخبرة | اقرأ النيّة، وعدِّل استباقيًّا، ووسّع عند الثغرات المجاورة، واصقُل بمبرّر مُستشهَد به، واستبق العواقب من الدرجة الثانية | src/apothem/rules/expertise-posture.md |
| M7 | وصم الخيارات | كل اختيار متعدّد الخيارات يحمل وصمًا مُوصًى به مع مبرّر مرتبط بالمبدأ؛ والانتقاءات الصامتة محظورة في المجال السلطوي | src/apothem/rules/option-annotation.md |
| M8 | القطعية والإحكام | لا تحوّط حيث يكون الوصف الملزِم ممكنًا؛ ولا «يعتمد على الحال» دون فروع مُعدَّدة؛ ولكل عقد شروط قبلية وبعدية وشروط إخفاق | src/apothem/rules/definitiveness.md |
| M9 | الرافعة البصرية | المادة ذات الطابع البنيوي تحمل مخططًا يعكس الواقع الراهن (Mermaid افتراضيًّا) مع المنشأ وتاريخ التحقّق | src/apothem/rules/visual-leverage.md |
| M10 | الربط ثنائي الاتجاه | العناصر البنيوية الجوهرية تُعلِن روابط متبادلة (Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔) | src/apothem/rules/bidirectional-binding.md |
| M11 | السباقات الرشيقة | يجري العمل غير التافه متعدّد الخطوات بوصفه سباقات منضبطة (الهدف / قائمة الأعمال / DoR / DoD / المراجعة / الاستعراض الاسترجاعي) | src/apothem/rules/agile-sprints.md |
| M12 | تقارير المراحل والتخطيط الكانوني | يُصدِر العمل متعدّد المراحل تقارير لكل مرحلة فرعية وتجميعًا على مستوى المرحلة؛ والمخرجات في التخطيط الكانوني | src/apothem/rules/canonical-layout.md |
| M13 | حِرفة الشيفرة | تعليقات لماذا-لا-ماذا؛ أسماء كاشفة للنيّة مع وحداتها؛ معالجة استثناءات مُصنَّفة الأنواع؛ ثوابت مُسمّاة؛ التزم بـlint / التنسيق / فحص الأنواع الخاص بالمُضيف | src/apothem/rules/code-craft-{python,shell,markdown,conventions}.md (لكلّ لغة) |
| M14 | المنظومية البيئية | المكوّنات الجديدة تُعلِن المنبع / المصبّ / الأقران / المُنفِّذين؛ وتُفهرَس في سجلّات المُضيف؛ لا صوامع، ولا أيتام مُدخَلة | src/apothem/rules/systemic-participation.md |
| M15 | الصيغة الجاهزة للإنتاج | تُشحَن تغييرات الشيفرة مع اختبارات + وثائق + إدخال CHANGELOG + رسالة كوميت مطابِقة + CI خضراء في مجموعة التغيير نفسها | src/apothem/rules/production-ready-prs.md |
1. عتبة التافه-مقابل-غير-التافه (مستقرّة)
العتبة التي تفصل العمل التافه عن غير التافه — العمل غير التافه يُفعِّل جهاز M11 + M12 — هي هجين عدد-الأسطر + النطاق: يكون التغيير تافهًا حين يكون تحريرًا لملفّ واحد بـ ≤ 5 أسطر وَلا يُدخِل أيّ تغيير على سطح API العامّ وَلا أيّ تحوّل سلوكي. أيّ شيء آخر غير تافه. مستقرّ مرّةً واحدةً وفق انضباط الاستقرار-مرّةً-واحدةً M5؛ تعيش العتبة هنا في نطاق المشغّل ولا تُتجاوَز إلّا بإعلان صريح على نطاق المشروع يحترم اكتشاف-المُضيف M1 (مثل <project>/.claude/CLAUDE.md لـ Claude Code، أو السطح المُكافئ لكلّ مشروع لإطار عمل آخر).
2. التخطيط المتقاطع M↔CM
يُعلِن متن كل قاعدة من ذوات الترقيم M تخطيطها المتقاطع CM-N ضمنيًّا (في رابط Cross-bound with ↔ الخاص بها) باستخدام سياسة المفردات-المتوازية: حيث يكون لتفويض M أقربُ نظير CM-N، تسري كلتا القاعدتين حيث تسري كلتاهما (لا استبدال). التخطيطات جوهرية في متون القواعد؛ ويُلخِّص هذا السجلّ سياسة المحور دون تكرار جدول التخطيط.
3. بروتوكول إدخال التفويض
إضافة تفويض جديد مُرقَّم بـ M (مثل M16 مستقبليّ) هي تغيير مُجمَّع. لا تبلغ الحزمة السجلّ إلّا حين يكون كل مكوّن أدناه حاضرًا في مجموعة-التغيير نفسها. الإضافات الصامتة — صفّ M جديد في جدول السجلّ دون الحزمة الداعمة — تُنتِج انحراف-محور-التفويض وهي غير مطابِقة وفق المشاركة النظامية M14.
| المكوّن المطلوب | الغرض | حيث يحطّ |
|---|---|---|
| صفّ التفويض في جدول السجلّ | يُسمّي التفويض وملخّصه ذا السطر الواحد وقاعدته الكانونية | جدول هذا السجلّ أعلاه |
| خلية التخطيط المتقاطع CM-N | تُعلِن أقرب نظير CM-N (أو تَسِم (no direct CM-N analog) بوصفه محورًا جديدًا) وفق سياسة المفردات-المتوازية في §2 | سطر Cross-bound with ↔ للقاعدة الجديدة |
| متن القاعدة الكانونية | المواصفة الجوهرية للتفويض (الشروط القبلية / السلوك المطلوب / سطح الإفصاح / علامات الإخفاق / الروابط خماسية الاتّجاه) | src/apothem/rules/<mandate-name>.md |
| صفّ بوّابة ما قبل الإصدار | يُسمّي نوع فحص الشريط (آلي / استدلالي / مختلط) وFailure → action الخاص به | جدول سجلّ بوّابة ما قبل الإصدار (site/content/docs/governance/pre-emission-gate-registry.mdx) |
| سطح الإنفاذ | إمّا grep آلي في src/apothem/conformity/<name>-grep.py بتنسيق من gate.py، أو إعلان شريط استدلالي صريح مع مرساة الفحص-الذاتي للمشغّل | src/apothem/conformity/ (آلي) أو صفّ البوّابة الموسوم بـ reasoned (فحص ذاتي للمشغّل) |
| تثبيتة المطابقة | تثبيتة تحت tests/conformity-scenarios/fixtures/F-<N>-<name>/ تُمارِس أنماط إخفاق التفويض؛ تُحدَّث قائمة-تفويضات المُتحقِّق لتشمل الشريط الجديد | tests/conformity-scenarios/ |
| تحديث مخطّط نتيجة البوّابة | تكتسب كتلة bars: الخاصة بنتيجة البوّابة الصفّ الجديد؛ وتعامل كتل نتيجة البوّابة للقِطَع القائمة الصفّ الجديد بوصفه n/a (with reason: pre-mandate-N artifact) حتى إعادة التدقيق | مخطّط §1 في site/content/docs/governance/pre-emission-gate-registry.mdx |
| إدخال سجلّ الإفصاح | يُسجّل إدخال التفويض بمبرّر متجذّر في دافع ملموس (تكرار نمط مُلاحَظ؛ ثغرة أمنية مكشوفة؛ قدرة لا تغطّيها الخمسة عشر القائمة) | متن commit الخاص بمجموعة-التغيير أو وصف PR وفق src/apothem/rules/disclosure-ledger.md |
انضباط التطبيق. يُرفَض اقتراح تفويض يصل دون الحزمة عند المراجعة؛ يُكمِل المُقترِح الحزمة أو يُخفِّض الاقتراح إلى توسعة لتفويض قائم. تبنّت التفويضات الخمسة عشر القائمة معًا بوصفها المحور الخارجي للمواصفة؛ تحترم الإضافات المستقبلية كادنس التبنّي ذاته القائم على كل-المكوّنات-أو-لا-مكوّن بدلًا من الحطّ على دفعات.
بروتوكول الخفض / الإحالة على التقاعد. حين يُوجَد تفويض M-N مُرسَّخ مكرّرًا مع CM-N قائم أو مع M-N آخر (تُظهِر خريطة تغطية التخطيط المتقاطع في متن القاعدة-المُجسِّدة تجاورًا direct في كلا الاتّجاهين)، يكون الخفض هو العكس المتماثل: يُحال صفّ السجلّ على التقاعد، ويُحال صفّ البوّابة على التقاعد، وتُحال القاعدة الكانونية على التقاعد (مع طيّ المحتوى في القاعدة المُستوعِبة وفق src/apothem/rules/clean-room-generation.md §3 بروتوكول إعادة-الكتابة)، وتُحال تثبيتة المطابقة على التقاعد، وتُسقِط كتلة bars: الخاصة بمخطّط نتيجة البوّابة الصفّ، وتُسجَّل مجموعة-التغيير في سجلّ الإفصاح مع استشهاد القاعدة-المُستوعِبة. يحفظ الخفض ثابتة كل-المكوّنات-أو-لا-مكوّن نفسها.
سجلّ الاستفسار السلطوي — الفئات المطلوبة
سبع فئات استفسار مطلوبة واستثناءات القرار-التلقائي التي تحكم ما يجب على المساعد أن يستفسر عنه مقابل ما يجوز له أن يقرّره عند العمل على المشاريع المُضيفة.
سياسة هندسة الإصدار
خمس سياسات مرجعية لترقيم النسخ، ووسم الإصدارات، ودورات الإهمال، والتغييرات الكاسرة، وإجراءات التراجع.