سجلّ المطابقة الخارجية — عند العمل على المشاريع المُضيفة
سجلّ التفويضات الخمسة عشر (M1–M15) الذي يحدّد متطلّبات المطابقة لجميع الآثار المُولَّدة في المشاريع المُضيفة، مع تخطيط متقاطع للتفويضات الداخلية للنظام البيئي.
مرافق كانوني لِـ
CLAUDE.md§12. يحمل هذا المستند سجلّ التفويضات الخمسة عشر الكامل (M1–M15)، وإقرار عتبة التافه-مقابل-غير-التافه، وسياسة التخطيط المتقاطع M↔CM، وبروتوكول إدخال التفويض. يحتفظCLAUDE.mdبسطر المرساة + المؤشّر؛ أمّا التعدادات الجوهرية فتعيش هنا.
عندما يُولّد هذا النظام البيئي أيّ أثر في مشروع مُضيف أو يُحرّره أو يُعيد صياغته أو يُحدّثه بأثر رجعي أو يُوسّعه أو يُزيله (هدف الاستدعاء الخاص بالمشغّل — مستودع git، شجرة وثائق، مجموعة بحثية، بيان بنية تحتية، مسوّدة)، فإنّ كل أثر مُنتَج يستوفي حاجز التفويضات الخمسة عشر (M1–M15) المُعلَن أدناه. هذا أمر غير قابل للتفاوض ويسري على كل سطح من النظام البيئي (skill، assistant، command، hook، استجابة، 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 | لاأدريّة المشروع المُضيف | اكتشف stack المُضيف / formatter / linter / layout / الاصطلاحات؛ التزم بها؛ اعرض الصمت كاستفسار وفق 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 | السباقات الرشيقة | يجري العمل غير-التافه متعدّد-الخطوات بوصفه سباقات منضبطة (الهدف / قائمة الأعمال / تعريف الجاهزية / تعريف الإنجاز / المراجعة / الاسترجاع) | src/apothem/rules/agile-sprints.md |
| M12 | تقارير الأطوار والتخطيط الكانوني | العمل متعدّد-الأطوار يُصدِر تقارير لكلّ طور-فرعي + تجميعًا على مستوى الطور؛ المخرجات في التخطيط الكانوني | src/apothem/rules/canonical-layout.md |
| M13 | إتقان الشيفرة | تعليقات لماذا-لا-ماذا؛ أسماء كاشفة للنيّة بوحدات؛ معالجة استثناءات مُصنَّفة؛ ثوابت مُسمّاة؛ التزم بـ lint / format / type-check الخاص بالمُضيف | src/apothem/rules/code-craft-{python,shell,markdown,conventions}.md (لكلّ لغة) |
| M14 | نَظْميّة النظام البيئي | المكوّنات الجديدة تُعلِن المنبع / المصبّ / الأقران / المُنفِّذين؛ مُفهرسة في سجلّات المُضيف؛ لا صوامع، ولا أيتام مُدخَلة | src/apothem/rules/systemic-participation.md |
| M15 | الصيغة الجاهزة للإنتاج | تُشحَن تغييرات الشيفرة مع اختبارات + وثائق + إدخال CHANGELOG + رسالة commit مطابِقة + CI خضراء في مجموعة-التغيير نفسها | src/apothem/rules/production-ready-prs.md |
1. عتبة التافه-مقابل-غير-التافه (مستقرّة)
العتبة التي تفصل العمل التافه عن غير التافه — العمل غير التافه يُفعِّل جهاز M11 + M12 — هي هجين عدد-الأسطر + النطاق: يكون التغيير تافهًا حين يكون تحريرًا لملفّ واحد بـ ≤ 5 أسطر وَلا يُدخِل أيّ تغيير على سطح API العامّ وَلا أيّ تحوّل سلوكي. أيّ شيء آخر غير تافه. مستقرّ مرّةً واحدةً وفق انضباط الاستقرار-مرّةً-واحدةً M5؛ تعيش العتبة هنا في نطاق المشغّل ولا تُتجاوَز إلّا بإعلان صريح على نطاق المشروع يحترم اكتشاف-المُضيف M1 (مثل <project>/.claude/CLAUDE.md لـ Claude Code، أو السطح المُكافئ لكلّ مشروع لِـ harness آخر).
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: الخاصة بمخطّط برهان-الإصدار الصفّ، وتُسجَّل مجموعة-التغيير في سجلّ الإفصاح مع استشهاد القاعدة-المُستوعِبة. يحفظ الخفض ثابتة كل-المكوّنات-أو-لا-مكوّن نفسها.
سجلّ الاستفسار السلطوي — الفئات المطلوبة
سبع فئات استفسار مطلوبة واستثناءات القرار-التلقائي التي تحكم ما يجب على المساعد أن يستفسر عنه مقابل ما يجوز له أن يقرّره عند العمل على المشاريع المُضيفة.
سياسة هندسة الإصدار
خمس سياسات كانونية لإدارة الإصدارات، ووسم الإصدارات، ودورات الإهمال، والتغييرات الكاسرة، وإجراءات التراجع.