الموقعة

الجمهور: المقيّمون الذين يقرّرون ما إذا كانوا سيتبنّون apothem للعمل الإنتاجي المُدار بالمساعد. الطول: ~12 دقيقة للقراءة من البداية إلى النهاية. قابل للمسح قسمًا قسمًا. الغرض: تأطير ما هو apothem فعلًا، وما هو ليس عليه، ولماذا تكون الإجابة عن "ماذا يوزّع هذا المشروع؟" مختلفة بنيويًا عن الإجابة التي تقدّمها معظم مشاريع أدوات المساعد.

§1. الأطروحة

apothem هو حوكمة تصديق-الآثار، مُحزَّمة بوصفها ملفًّا ثنائيًا.

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

يرفض apothem ذلك التأطير.

نقطة رافعة المساعد العامل على مشروع حقيقي ليست النصّ الذي يسلّمه المُشغِّل إلى النموذج — بل هي الأثر الذي يوشك النموذج على إصداره. ذلك الأثر سيهبط في مساحة عمل، ويُلتزَم به، ويُراجَع، ويُدمَج، ويُنشَر، ويُستشهَد به من آثار لاحقة، ويرثه مساهمون مستقبليون. جودته خاصّية لا-رجعية-في-المصبّ لا يستطيع المُحَثّ إصلاحها رجعيًا. تحرير المُحَثّ بعد هبوط commit مشوّه ضريبة على المُشغِّل، لا تعافيًا للأثر.

الانضباط الذي يرمّزه هذا المشروع هو العكس: كل إصدار يمرّ عبر بوّابة مهيكلة ومتّفق عليها ومفحوصة آليًا قبل أن يغادر يدَي المساعد. تُنفِّذ البوّابة خمسة عشر تفويضًا تمتدّ عبر اكتشاف-المضيف، والإفصاح، وعشر أبعاد للجودة، ونظافة السلطة، ودمج الخبرة، وتعليق-الخيارات، والقطعية، والرافعة البصرية، والربط ثنائي-الاتجاه، وعتاد سبرنت الأجايل، والتخطيط الكانوني، وحرفية الشيفرة، والمشاركة النظامية، والجاهزية-للإنتاج. كل تفويض هو rule بنطاق path-filter ومتن يُشغِّل فئة فشل محدّدة. كل فشل بوّابة هو اكتشاف بنيوي يُظهره المساعد — لا تدهور صامت أبدًا.

مجموعة الـ rules هي المنتَج. الملفّ الثنائي apothem هو تحزيمها — سطح توزيع يحمل المجموعة إلى جذر user-config لكلّ مُشغِّل ويسجّلها بوصفها وضعية تشغيل المساعد. التحزيم قابل للاستبدال؛ المجموعة هي الأصل طويل-الذيل.

المشروع الذي يتبنّى apothem لا يتبنّى مُحَثًّا. إنه يتبنّى نظام حوكمة. كل أثر يُصدره المساعد في مستودع المضيف — شيفرة، اختبارات، إعدادات، schemas، توثيق، runbooks، رسائل commit، أسماء فروع — يفي بالأرضية نفسها ذات الخمسة عشر سطرًا. تنتقل نقطة رافعة المُشغِّل من "ماذا ينبغي أن أقول للمساعد؟" إلى "أيّ تفويضات تقيّد هذا الإصدار، وأيّ دليل تتطلّبه البوّابة؟". الانتقال بنيوي، لا أسلوبي.

تؤطّر هذه الوثيقة لماذا تكون المجموعة الأصل الحامل-للعبء، وتمشي عبر التفويضات الخمسة عشر مع مراسي ملفّات-الـ rules خاصّتها، وتُظهر الانضباطين الشاملين (معالجة مدخلات القناة-الكانونية وعمارة الهوية-المعرفية الإبداعية) اللذين يربطان المجموعة في كلّ متماسك.

§2. عمارة الأعمدة الثلاثة

تستند المجموعة إلى ثلاثة أعمدة. كل عمود سطح قابل للفصل بمواصفته الكانونية الخاصّة؛ كل عمود يعزّز العمودين الآخرين.

العمود A — سجلّ التفويضات (M1–M15 + CM-1..CM-28)

سجلّ التفويضات هو سطح الحوكمة ذو المحور-الخارجي. تحكم M1–M15 كل أثر يُنتجه المساعد في مشروع مضيف: اكتشاف-المضيف، الإفصاح، عشر أبعاد للجودة، السلطة، الخبرة، تعليق الخيارات، القطعية، الرافعة البصرية، الربط ثنائي-الاتجاه، سبرنتات الأجايل، التخطيط الكانوني، حرفية الشيفرة، المشاركة النظامية، والجاهزية-للإنتاج. يُكنَّن السجلّ في CLAUDE.md §8 ويُشغَّل بواسطة ملفّات الـ rules المُعدَّدة في §3 أدناه.

CM-1..CM-28 هي النظائر ذات المحور-الداخلي — تفويضات تشغيلية تحكم انضباط تفاعل المساعد (التقييم النقدي، صفر افتراضات، ابحث-قبل-التنفيذ، تقييم الحلّ-الأمثل، الصدق القاسي، سرعة القرار، التركيز على عنق-الزجاجة-أوّلًا، المنتج المتماسك، وعشرون مدخلًا آخر تغطّي موضعية الخطط، رعاية السياق، تنسيق العمل المُفوَّض، توليد الملفّات-الكبيرة، ودورة حياة الذاكرة). يُكنَّن المحور-الداخلي في CLAUDE.md §6 وsite/content/docs/governance/cross-cutting-mandates.mdx.

كل إصدار يمرّ عبر كلا المحورين. تُشغِّل البوّابة في src/apothem/rules/pre-emission-gate.md الأسطر الخمسة عشر الآلية والمُعلَّلة لكل إصدار وتسجّل كتلة تحقّق في أثر عمل الأثر.

العمود B — انضباط القناة-الكانونية

يربط انضباط القناة-الكانونية كيف يلتمس المساعد مدخلات المُشغِّل. تُتقاعَد المُحَثّات الحرّة-الصيغة عبر النظام البيئي بأكمله؛ كل خيار يُوجَّه عبر قناة الاستفسار-المهيكل بمخطّط تعليق-خيارات مهيكل (مبرّر + توصية + مؤشّر-افتراضي لكل خيار)، وتصنيف توصية مغلق، وأرضية تأكيد عملية-تدميرية لكل ملفّ، ومسح إرشادي يلتقط انحراف المُحَثّ-التحاوري عبر كل سطح محكوم. تعيش المواصفة الكاملة في src/apothem/rules/interactive-questions.md مع العمق المحمول على المرافِقَين بـ path-filter src/apothem/rules/interactive-questions-canonical-shapes.md وsrc/apothem/rules/interactive-questions-sweep-matchers.md.

رافعة الانضباط هي قابلية تدقيق القرار. كل خيار طوعي للمُشغِّل يحمل الدليل الذي اعتبره المساعد، والتوصية التي أصدرها المساعد، والمبرّر المتجذّر في دوافع ملموسة. بعد ستة أشهر من الخيار، يستطيع مدقّق يقرأ سجلّ الإفصاح إعادة بناء حدّ القرار دون استشارة ذاكرة المُشغِّل.

العمود C — تصنيف الهوية-المعرفية

يربط تصنيف الهوية-المعرفية كيف يفكّر المساعد. خمسة مرشّحات معرفية متتالية (تنقية البديهي، نفي المجال، مكبس العكس، الانفجار التوافقي، المطلب الجمالي) تؤلّف إيقاعًا إبداعيًا يُطبَّق على كل مُخرَج جوهري. ستّ تقنيات لتوليد الأفكار (مُخرِّب التاريخ، مفارقة القيد، عدسة الأنظمة الحيّة، السردية ذات الرتبة-الثانية، إطار الشرّير، تكبير المئة-عام) تشتعل عند إشارات الكشف حين يكون النهج المعياري قد أنتج محصّلة غير مُرضِية. سبعة محاور للاتّساع (العمارة، التزامن، الأداء، الأمن، الاختبار، الأدوات، القابلية للملاحظة) تشكّل سطح العمق الذي يُقاس عليه كل قرار غير-تافه. تعيش المواصفة الكاملة في src/apothem/rules/cognitive-identity.md مع العمق المحمول على المرافِق بـ path-filter src/apothem/rules/cognitive-identity-techniques.md.

رافعة التصنيف هي الجِدّة البنيوية. مرشّح تنقية البديهي يطرح إجابة الفكرة-الأولى التي يطالها الجميع؛ ومكبس العكس يتطلّب نجاة افتراض معكوس واحد على الأقلّ في المُخرَج النهائي؛ والمطلب الجمالي يرفض الأشكال الوظيفية-لكن-المنسيّة. النتيجة مساعد يُنتج مُخرجات تجعل المُشغِّلين يتوقّفون ويعيدون القراءة — لا لأن النصّ مزخرف، بل لأن الخيار البنيوي غير-بديهي بطريقة، حالما تُرى، تبدو حتمية.

كيف تتعاضد الأعمدة

الأعمدة الثلاثة حاملة-للعبء بشكل متبادل. سجلّ التفويضات (العمود A) يعرّف ما يجب أن يستوفيه الأثر. انضباط القناة-الكانونية (العمود B) يعرّف كيف تدخل مدخلات المُشغِّل سطح القرار الذي يُنتج الأثر. تصنيف الهوية-المعرفية (العمود C) يعرّف الإيقاع الإبداعي الذي يمنح الأثر شكله. إزالة أيّ عمود واحد تُسقط الآخرين: سجلّ بلا قناة كانونية يُنتج آثارًا مُفترَضة-بصمت تبدو مطابقة لكنها تُخفي قرارات بنيوية؛ وقناة كانونية بلا عمق معرفي تُنتج مُخرجات مُوجَّهة-بشكل-صحيح لكنها ذات-شكل-عامّ؛ وإيقاع معرفي بلا سجلّ يُنتج آثارًا أنيقة-جماليًا لكنها تفشل في التكامل مع مشروع المضيف.

§3. جولة في سجلّ التفويضات

سجلّ التفويضات الخمسة عشر هو سطح الحوكمة الكانوني ذو المحور-الخارجي. كل صفّ أدناه يسمّي التفويض، ونطاقه التشغيلي، وملفّ الـ rule الذي يحمل المواصفة الكانونية. كل ملفّ rule مُرشَّح بـ path-filter إلى فئات الآثار التي يحكمها ومُحمَّل عند الطلب إلى سياق تشغيل المساعد حين تُلمَس تلك الفئات.

M1 — لا-أدرية المشروع-المضيف واكتشاف الاصطلاحات

النطاق. كل ما يُنتجه المساعد في مشروع مضيف يتشكّل بما عليه المشروع المضيف بالفعل — stack خاصّته، لغته، framework، toolchain، formatter، linter، إطار الاختبار، مولّد التوثيق، استراتيجية الفروع، اصطلاح رسالة-الـ commit، التخطيط، التسمية، سياسة تثبيت-الاعتماديات. كل واحد منها يُكتشَف من مصدر-الحقيقة الموثوق للمضيف (manifests، ملفّات lock، ملفّات شقيقة من نوع قابل للمقارنة، وثائق اصطلاح على مستوى-المستودع) ويُحترَم. حيثما يصمت المضيف عن اصطلاح يجب أن يتبنّاه المساعد، يَظهر الصمت بوصفه استفسارًا موثوقًا — لا يُحَلّ أبدًا باختيار افتراضي داخلي بصمت.

المواصفة الكانونية. src/apothem/rules/host-discovery.md (مع كتالوج manifest لكل-لغة في src/apothem/rules/host-discovery-manifests.md).

لماذا يهمّ. إصدار المساعد لا يمكن تمييزه عن إصدار كتبه مساهم قديم في المشروع المضيف. انحراف الاصطلاح فشل بنيوي، لا تفضيل أسلوبي.

M2 — الانضباط التحريري والتعديلات المُفصَح عنها

النطاق. كل تغيير ذي نطاق ذي معنى يحمل سجلّ إفصاح صريح — ما طُلِب، وما عُدِّل، وما وُسِّع، وما نُقِّح، وما أُجِّل. الامتثال-المفرط بصمت ("فعل بالضبط ما طُلِب، رغم أنه كان خاطئًا") والتجاوز-المفرط بصمت ("وسّع نطاق التغيير دون إخبار") كلاهما فشل. كل تعديل يحمل مبرّرًا عند العتبة العلمية / التقنية (مرجع مستشهَد به، RFC، وثائق المورّد، سابقة ملفّ-شقيق، نمط مُسمّى من الأدبيات).

المواصفة الكانونية. src/apothem/rules/disclosure-ledger.md (مع كتالوج فئة-العلامات في src/apothem/rules/disclosure-ledger-markers.md).

لماذا يهمّ. الـ diff الذي يصلح بصمت خللًا مجاورًا أثناء تنفيذ التغيير المطلوب هو تعديل غير مُفصَح عنه. مراجِع بعد ستة أشهر لا يستطيع تمييز الإصلاح المتعمَّد عن الانحراف. السجلّ هو سطح التدقيق-والتعافي.

M3 — أبعاد الجودة العشرة

النطاق. كل أثر يُقيَّم مقابل عشرة أبعاد للجودة قبل الإصدار: الدقّة العلمية، الاتّساق / التماسك / التكامل / الصلاحية، القابلية-للإعداد / اللا-تكرار / التوحيد، القابلية-للقراءة / البداهة / النظافة، اليُتم / التقادم، البنيوية / النظامية / الانتظام / الشمولية، العمارة، انتظام التسمية، الإحالة العلمية / التقنية، والأمثلة / الاختبارات / docstrings / التوثيق. أثر واحد يفشل في أبعاد متعدّدة يكون تضاعفيًا، لا تجميعيًا — أثر متقادم ويتيم ومُسمّى بلا-اتّساق وغير-موثَّق هو مرشّح للسحب، لا للإصلاح.

المواصفة الكانونية. src/apothem/rules/ten-dimension-check.md (مع متون لكل-بُعد في src/apothem/rules/ten-dimension-check-dimensions.md).

لماذا يهمّ. الجودة قابلة للتفكيك. تسمية الأبعاد العشرة تجعل كلًّا منها قابلًا للتدقيق وللإظهار بمعزل؛ تتحوّل اكتشافات "يبدو هذا ضعيفًا" الغامضة إلى محدّدة "البُعد 5 التقادم: المرجع في السطر 42 يشير إلى ملفّ نُقِل".

M4 — التطبيق-الذاتي — بوّابة قبل-الإصدار

النطاق. كل أثر يمرّ عبر بوّابة قبل-الإصدار ذات الخمسة عشر سطرًا قبل الإصدار. الأسطر الآلية (M2، M5، M7، M8، M10، M13، M15) تحمل مُطابِقات قابلة للتنفيذ في src/apothem/conformity/*-grep.py مُنسَّقة بواسطة src/apothem/conformity/gate.py. الأسطر المُعلَّلة (M1، M3، M6، M9، M11، M12، M14) يُقيّمها المساعد العامل وتُسجَّل في كتلة التحقّق. فشل سطر واحد يحجب الإصدار؛ يستمرّ التكرار حتى يجتاز كل سطر.

المواصفة الكانونية. src/apothem/rules/pre-emission-gate.md (مع جدول الأسطر الكامل في src/apothem/rules/pre-emission-gate-bars.md).

لماذا يهمّ. الجودة شأن قبل-الإصدار، لا شأن مصبّ "يستطيع المستخدم المراجعة". البوّابة هي الترجمة البنيوية لتلك القناعة إلى إنفاذ آلي.

M5 — مبدأ السلطة (استفسِر، لا تخترع)

النطاق. الأسماء، رسائل البريد، المعرّفات، أسماء المضيفين، المؤسّسات، المستأجرون، نقاط النهاية، بيانات الاعتماد، اتّجاه النطاق، خيارات التسمية التي لم يحسمها المضيف بعد، سياسات الاحتفاظ، تثبيت الإصدارات على أسطح المضيف-القابلة-للتغيّر، قرارات البنية التحتية التي لم يُعلنها المستخدم — لا شيء منها يُختَرع. كلٌّ منها إمّا يُكتشَف من مصدر حقيقة موثوق في المضيف (نصف اكتشاف M1) أو يُستفسَر من المستخدم (نصف استفسار M5) — لا يُرقَّع أبدًا بتخمين يبدو معقولًا.

المواصفة الكانونية. src/apothem/rules/authority-inquiry.md (مع كتالوج السبع-فئات في src/apothem/rules/authority-inquiry-categories.md).

لماذا يهمّ. الهوية، والأمن، واتّجاه-النطاق، وتسمية السطح-العامّ تحمل وزنًا قانونيًا وتدقيقيًا. عنوان تواصل مُخمَّن، أو معرّف CODEOWNERS مُختلَق، أو نقطة نهاية لتوقيع-الإصدار مُختَرعة تخلق تنظيفًا في المصبّ تكلفته أكبر بمراتب من تكلفة الاستفسار.

M6 — دمج الخبرة

النطاق. كل أثر ذي نطاق ذي معنى يقرأ نيّة المستخدم قبل النصّ الحرفي، ويعدّل استباقيًا حين يكون الطلب الحرفي سيترك خللًا معروفًا، ويوسّع على الثغرات المجاورة، وينقّح بمبرّر مُستشهَد به، ويستبق العواقب ذات الرتبة-الثانية، ويعاير العمق على المهمّة، ويستورد دروسًا من مجالات مجاورة — مُفصِحًا عن كل تعديل عبر سجلّ M2.

المواصفة الكانونية. src/apothem/rules/expertise-posture.md (مع سبعة عناصر-فرعية + سلّم المعايرة في src/apothem/rules/expertise-posture-elements.md).

لماذا يهمّ. الخبرة بلا إفصاح تجاوز صامت. الخبرة مع الإفصاح رافعة — يرى المُشغِّل التعديل، ويقيّم المبرّر، ويصدّق أو يتراجع. يتصرّف المساعد بوصفه مساهمًا كبيرًا حكمه قابل للتدقيق، لا بديلًا مُعتمًا عن نيّة المُشغِّل.

M7 — انضباط تعليق-الخيارات

النطاق. كل خيار متعدّد-الخيارات يُظهره المساعد — في استجابات النصّ، ADRs، أقسام README، أوصاف PR، وثائق التصميم، خطوات runbook، تعليقات الشيفرة، متون رسائل-الـ commit، RFCs — يحمل علامة المُوصى-به الكانونية على الخيار المُوصى به إضافةً إلى مبرّر مرتبط-بمبدأ. الاختيارات الصامتة وقوائم الخيارات غير-المُعلَّقة محظورة في المنطقة الموثوقة.

المواصفة الكانونية. src/apothem/rules/option-annotation.md (مع صيغة النصّ-والوثيقة في src/apothem/rules/option-annotation-form.md).

لماذا يهمّ. كل مجموعة خيارات مُؤلَّفة سطح تدقيق. يرى القارئ ليس الخيار فحسب بل فضاء البدائل، والتوصية، والدافع الملموس وراءه. الانضباط نفسه يربط استدعاءات الاستفسار-المهيكل للمساعد والنصّ المؤلَّف في آثار دائمة.

M8 — القطعية، والإحكام، وعائلة فضائل الأنظمة-الصارمة

النطاق. كل عبارة قطعية (بلا تحوّط حيث يكون الوصف المُلزِم ممكنًا) ومُحكَمة (بلا ثغرات في المجالات المُعلَنة، بلا منافذ حيث ينتهك الالتزام-الحرفي النيّة، بلا افتراضات غير-مذكورة، بلا تعادلات أسبقية، بلا احتياطات صامتة). قائمة مفردات التحوّط تُكتشَف آليًا عند البوّابة؛ كل ورود في نصّ توصيفي يُحَلّ على أحد ثلاثة مسارات — يُرقَّى إلى غير-مشروط مع ذكر الشروط، أو يُخفَّض إلى مشروط صريح مع تعداد الفروع، أو يُحذَف ويُوجَّه الخيار إلى سطح الاستفسار.

المواصفة الكانونية. src/apothem/rules/definitiveness.md (مع كتالوج السبع-فضائل في src/apothem/rules/definitiveness-virtues.md).

لماذا يهمّ. النصّ التوصيفي المُتحوِّط ضريبة على كل قارئ. لا يستطيع القارئ تمييز ما إذا كان التحوّط يقرّ بشرطية حقيقية أم يُشير إلى عدم يقين المؤلِّف. الانضباط يُجبر المؤلِّف على تسمية الشرط أو حذف الوصف — يحصل القارئ على عبارة مُلزِمة في كلتا الحالتين.

M9 — الرافعة البصرية

النطاق. حيثما يكون الموضوع بنيويًا — العمارة، تدفّق التحكّم، تدفّق البيانات، رسم الاعتماديات، آلة الحالة، التسلسل، شجرة القرار، التراتبية، مكدّس الأسبقية، دورة الحياة، مصفوفة الأذونات — يحمل الأثر مخطّطًا بجانب النصّ. Mermaid هو الافتراضي المُوصى به للمجموعات المتمحورة-حول-Markdown؛ تُحترَم نوتة المضيف القائمة وفق اكتشاف M1. كل مخطّط يحمل مصدريّةً، وتاريخ تحقّق، وربطًا عائدًا إلى الأثر الذي يجرّده.

المواصفة الكانونية. src/apothem/rules/visual-leverage.md.

لماذا يهمّ. وصف معماري من ألفي كلمة بلا مخطّط هو سوء-استغلال منهجي للوسيط وفشل بنيوي للأثر، لا تفضيل أسلوبي. العلاقات المكانية غير-مقروءة في النصّ الخطّي؛ المخطّط مُخرَج من الدرجة-الأولى متساوٍ، لا زخرفة.

M10 — الربط ثنائي-الاتجاه ونسج تنفيذ-الأطوار

النطاق. كل عنصر بنيوي جوهري يحمل ربطًا متبادلًا إلى أقرانه في نوتة الاتجاهات-الخمسة الكانونية: Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔. كل ربط مُعلَن في اتجاه واحد له مؤشّر-عائد متبادل في الطرف الآخر؛ الحوافّ-النصفية فشل بنيوي، لا تفضيل جمالي. مُطابِق reciprocity-grep آلي في src/apothem/conformity/binding_reciprocity_grep.py يُنفِّذ الثابت عند البوّابة.

المواصفة الكانونية. src/apothem/rules/bidirectional-binding.md.

لماذا يهمّ. الربط المتبادل يحوّل المجموعة إلى رسم قابل للتنقّل. سطر Cross-bound with ↔ في أيّ rule يشير إلى كل قرين يستشهد به، وكل قرين مُستشهَد به يشير عائدًا. تصبح إعادة هيكلة المجموعة آلية — أعد تسمية rule، يُعلّم الـ reciprocity-grep كل استشهاد متقادم في مجموعة-التغيير نفسها.

M11 — سبرنتات الأجايل والتحكّم التجريبي بالعملية

النطاق. العمل متعدّد-الخطوات غير-التافه يجري بوصفه سبرنتات أجايل منضبطة بالعناصر الكانونية السبعة: Sprint Goal (مُشكَّل-بالمحصّلة، قابل-للاختبار)، Sprint Backlog (مُشكَّل-بـ INVEST، مُرتَّب-بالأولوية)، Definition of Ready (بوّابة دخول-السبرنت)، Definition of Done (بوّابة خروج-السبرنت)، Sprint Review (مُوافَق عليه / مرفوض / مُرحَّل لكل بند)، Sprint Retrospective (واصل / أوقف / ابدأ)، Velocity Tracking (إشارة، لا هدف أبدًا). ثلاثة أعمدة للتحكّم التجريبي بالعملية — الشفافية، التفتيش، التكيّف — تعمل طوال الوقت.

المواصفة الكانونية. src/apothem/rules/agile-sprints.md (مع متون العناصر في src/apothem/rules/agile-sprints-elements.md).

لماذا يهمّ. diff ضخم لعدّة أيام بلا بنية سبرنت مُعتِم على المراجعة. العتاد يُظهر كل زيادة، وكل معيار قبول، وكل رفض لحظة حدوثه — لا مُؤجَّلًا إلى مراجعة استرجاعية بعد وقت طويل من صيرورة القرار البنيوي لا-رجعيًا.

M12 — طبقات التقارير والتخطيط الكانوني للمُخرَجات المُولَّدة

النطاق. العمل متعدّد-الخطوات غير-التافه يُصدر تقارير ذات-طبقتين: تقرير لكل-طور-فرعي على طبقة العمل ورول-أب على مستوى-الطور على طبقة المراجعة يُجمِّع بدلًا من أن يُسلسِل — قالب موحّد عبر الأطوار الفرعية، مقاييس مُجمَّعة، أنماط مُظهَرة، فحص-ذاتي على مستوى-الطور، إعلانات خارجية. تقع المُخرَجات المُولَّدة في مواقع كانونية قابلة-للتنبّؤ ومُكتشَفة-من-المضيف بمصدريّة وإحالات-متقاطعة متبادلة. المُخرَجات اليتيمة (آثار بلا مستهلك / بلا مدخل فهرس / بلا إسناد مُنتِج) فشل بنيوي.

المواصفة الكانونية. src/apothem/rules/canonical-layout.md (مع متون طبقات-التقارير في src/apothem/rules/canonical-layout-reporting-tiers.md).

لماذا يهمّ. قائمة مسطّحة من report1.md / report2.md في مواقع ارتجالية غير-مقروءة بعد ستة أسابيع. انضباط الطبقتين إضافةً إلى التخطيط الكانوني-للمضيف يعني أن كل مُخرَج قابل للاكتشاف، وكل مستهلك مُسمّى، وكل مُنتِج قابل للإسناد.

M13 — اصطلاحات حرفية الشيفرة

النطاق. كل أثر شيفرة يستوفي أحد عشر عنصرًا-فرعيًا: التعليق بـ لماذا-لا-ماذا، التسمية الكاشفة-للنيّة، معالجة الاستثناءات-المحدّدة، تصميم الدوال والوحدات بانحياز المسؤولية-المفردة، مستويات logging مقصودة، الاختبار الوصفي-للسلوك، اجتياز formatter / linter / type-checker بنظافة، الشيفرة الواعية-بالأمن (بلا أسرار مُضمَّنة-بصلابة، بلا حقن shell، بلا فكّ-تسلسل غير-آمن)، انضباط التزامن، إزالة الثوابت-المُسمّاة للحرفيّات العددية غير-المُفسَّرة، وتغطية سطح التوثيق. تحمل rules الشقيقة لكل-لغة التجسيد الخاصّ-باللغة.

المواصفة الكانونية. src/apothem/rules/code-craft-conventions.md (جذع التفويض-الشامل) إضافةً إلى rules الشقيقة لكل-لغة src/apothem/rules/code-craft-python.md، وsrc/apothem/rules/code-craft-shell.md، وsrc/apothem/rules/code-craft-markdown.md.

لماذا يهمّ. انحراف حرفية-الشيفرة يتراكم. معالِج استثناء عارٍ واحد يصبح السابقة التي يستشهد بها المساهم التالي؛ سرّ مُضمَّن-بصلابة واحد يصبح الاصطلاح الذي يقبله الفريق؛ حرفيّة غير-مُفسَّرة واحدة تصبح عشرة. الأحد عشر عنصرًا-فرعيًا تسمّي فئات الفشل والبوّابة تُنفِّذها لكل إصدار.

M14 — النظامية البيئية في المشروع المضيف

النطاق. كل مكوّن مُقدَّم حديثًا يُعلن أربع علاقات نظامية — upstream (ما يُحفِّزه)، downstream (ما يستهلكه)، peers (أشقّاء من النوع نفسه)، enforcers (بوّابات جودة المضيف التي تحكمه) — ويتقارب مع اصطلاحات الأقران في مجموعة-التغيير نفسها. الصوامع (آثار قائمة-بذاتها تنحرف عن اصطلاحات الأشقّاء، تكرار-لوظيفة-قائمة) واليتامى (مكوّنات بلا مستهلك / بلا مدخل فهرس / بلا إسناد مُنتِج) فشل بنيوي.

المواصفة الكانونية. src/apothem/rules/systemic-participation.md (مع العمق التشغيلي في src/apothem/rules/systemic-participation-relations.md).

لماذا يهمّ. اختبار، أو doc، أو workflow، أو وحدة، أو مدخل إعداد جديد لا يُعلن مكانه في رسم إحالات المضيف غير-مرئيّ للصيانة. إعلان العلاقات-الأربع إضافةً إلى تحديث السجلّ في مجموعة-التغيير-نفسها يعني أن كل مكوّن قابل للاكتشاف وللفكّ من commit الأول.

M15 — انضباط الجاهزية-للإنتاج على آثار المشروع-المضيف

النطاق. كل تغيير يُشحَن في صيغة جاهزة-للإنتاج: اختبارات + توثيق + مدخل CHANGELOG + رسالة commit مطابقة + CI أخضر في مجموعة-التغيير نفسها. وضعية سلسلة-التوريد محفوظة (بلا اعتمادية غير-مُثبَّتة، بلا حرفيّة سرّ، بلا تصعيد أذونات، بلا actions غير-مُثبَّتة، بلا إصدار غير-موقَّع حيث يكون التوقيع مطلوبًا). ثوابت هندسة-الإصدار محفوظة (الإصدار مُحترَم، اتّساق tag-إلى-إصدار، توقيع tag حيث يكون مطلوبًا). سطح المشروع الحديث مُعبّأ (سكربتات تثبيت / تحديث / إزالة متعدّدة-الأنظمة مُزدوَجة، أصل logo، رأس README مُركَّز حديث، أقسام تثبيت / تحديث / إزالة). بيانات تأليف كل commit تسمّي المساهمين البشريين فقط — لا يُسند المساعد أبدًا نفسه أو نموذج اللغة الأساسي إلى أيّ commit، أو trailer، أو فرع، أو tag، أو حقل pull-request.

المواصفة الكانونية. src/apothem/rules/production-ready-prs.md (مع أسطح الرؤية ومواصفة السطح-الحديث في src/apothem/rules/production-ready-prs-surfaces.md).

لماذا يهمّ. "سأضيف اختبارات في متابعة" لا تهبط أبدًا. انضباط مجموعة-التغيير-نفسها يُغلق نمط الفشل الذي يُنتج أكبر تكلفة تراكمية في المشاريع طويلة-الأمد: عمل جودة مُؤجَّل يتراكم إلى دين تقني نظامي.

§4. انضباط القناة-الكانونية

انضباط القناة-الكانونية هو النظير على جانب-المدخلات لإنفاذ سجلّ التفويضات على جانب-الإصدار. كل خيار يُظهره المساعد للمُشغِّل يُوجَّه عبر قناة الاستفسار-المهيكل. المُحَثّات التحاورية الحرّة-الصيغة كمدخل أساسي محظورة؛ يُنفَّذ الانضباط عند البوّابة بسبعة مُطابِقات إرشادية (H1–H7) تمسح كل سطح محكوم وتُعلّم الانحرافات بوصفها اكتشافات بوّابة.

تعيش المواصفة الكانونية في src/apothem/rules/interactive-questions.md. تحمل rules المرافِقة العمق: src/apothem/rules/interactive-questions-canonical-shapes.md تحمل الأمثلة المشغولة، ومتون المخطّط، وتصنيف التوصية، واحتياط الـ harness، ومجموعات خيارات العملية-التدميرية الكانونية، وأمثلة مؤشّر-الافتراضي المشغولة؛ src/apothem/rules/interactive-questions-sweep-matchers.md تحمل كتالوج مُطابِقات H1–H7 باستدعاءات ripgrep قابلة-للتكرار.

شكل السؤال المهيكل

كل استدعاء يحمل أربعة حقول: question من جملة-واحدة ينتهي بعلامة استفهام، وheader قصير (اثنا عشر حرفًا حدّ أقصى)، ومصفوفة options من عنصرين-إلى-أربعة، وقيمة منطقية multiSelect. كل خيار يحمل label من كلمة-إلى-خمس-كلمات ومتن description بثلاثة مقاطع ثابتة-الترتيب:

1. rationale — جملة واحدة تذكر ماذا يعني هذا الخيار وعاقبته المباشرة القابلة-للملاحظة على حالة النظام البيئي.
2. recommendation — قيمة واحدة من التصنيف المغلق: recommended، أو acceptable، أو discouraged، أو destructive-no-default. القيم غير-المحايدة تحمل عبارة-لماذا تستشهد بدافع ملموس واحد على الأقلّ من تصنيف ستّ-فئات مغلق: القرارات المُقفَلة، المخاطر المُسمّاة، القيود المُسمّاة، أوضاع الأسئلة-المفتوحة، استشهادات الـ rules، وحالة النظام البيئي المُلاحَظة. قائمة منع المبرّر-الغامض غير-مطابقة حين تقف بوصفها المبرّر الوحيد لتوصية غير-محايدة.
3. default-pointer — يسمّي الافتراضي الآمن مع مبرّر، أو يُعلن صراحةً no-default: user decision required. العمليات التدميرية تستخدم صيغة no-default عالميًا.

خيار واحد بالضبط لكل استدعاء يجوز أن يحمل لاحقة-label المُوصى-بها، مربوطة ثنائي-الاتجاه بقيمة recommendation المتن. عدم التطابق بين لاحقة الـ label وقيمة المتن يُكتشَف بواسطة مُطابِق H6 بوصفه اكتشاف بوّابة.

تأكيد العملية-التدميرية لكل-ملفّ

كل عملية تدميرية — حذف، إعادة-تسمية، نقل، كتابة-فوق-بلا-احتفاظ، التراجع-عن-تعديلات-غير-مُلتزَمة — تُوجَّه عبر قناة الاستفسار-المهيكل على أساس لكل-ملفّ. استدعاء واحد لكل ملفّ، في كل مرّة. multiSelect: true غير-مطابق على استدعاءات العملية-التدميرية؛ مجموعات الخيارات الكانونية في أقسام العملية-التدميرية الفرعية هي الأرضية. إرهاق التأكيد تكلفة مقبولة؛ التدمير الصامت ليس كذلك.

المسح الإرشادي — H1 حتى H7

سبعة مُطابِقات آلية تمسح أسطح النواة-المحكومة (commands، rules، skills، تعريفات العامل-المُفوَّض، hooks، ملفّات إعداد الـ harness، وCLAUDE.md) بحثًا عن فئتي فشل:

• الإرشاديات ذات الصيغة-التحاورية (H1–H3). H1 يلتقط مُحَثّات الأمر-مع-علامة-الاستفهام. H2 يلتقط "Please confirm / approve / choose". H3 يلتقط "Which of the following / these". يُقارَن عدد-إصابات كل مُطابِق مقابل عدد منطقة-الاستثناء المُوثَّق (الاستشهادات-الذاتية التعريفية وسياقات المحادثة-المحفوظة)؛ الانحرافات اكتشافات بوّابة.
• الإرشاديات لامتثال-التعليق (H4–H7). H4 يلتقط خيارات تفتقد أيًّا من المقاطع الثلاثة للمتن. H5 يلتقط توصيات غير-محايدة تفتقد استشهاد دافع-ملموس. H6 يلتقط عدم تطابق لاحقة-الـ label مقابل قيمة-المتن. H7 يلتقط استدعاءات العملية-التدميرية التي تفتقد أرضية no-default الحرفية.

المسح قابل للتكرار — كل مُطابِق يحمل استدعاء ripgrep يستطيع أيّ مُشغِّل تشغيله مقابل المجموعة. الانضباط آلي، لا تأويلي.

لماذا هذا الشكل، لا شيء آخر

المُحَثّات التحاورية كمدخل أساسي لها ثلاثة أنماط فشل بنيوية يُغلقها انضباط القناة-الكانونية:

1. محو فضاء-القرار. المُحَثّ الحرّ-الصيغة يقدّم إجراءً مقترحًا واحدًا ويطلب من المُشغِّل التصديق عليه. البدائل التي اعتبرها المساعد، وأوزانها النسبية، والمبرّر وراء المسار المُختار غير-مرئيّة. يصدّق المُشغِّل-أو-يرفض دون رؤية فضاء القرار.
2. عدم تناظر الانحياز. بلا علامة توصية صريحة إضافةً إلى مبرّر دافع-ملموس، يُنقَل تفضيل المساعد عبر نبرة النصّ، والتأطير، والترتيب — قنوات لا يستطيع المُشغِّل تقييمها كدليل. علامة المُوصى-به إضافةً إلى الدافع المُستشهَد به تجعل الانحياز صريحًا وقابلًا للتدقيق.
3. اضمحلال التدقيق. بعد ستة أشهر من الخيار، مدقّق يقرأ سجلّ المحادثة يرى السؤال والإجابة لكنه لا يستطيع إعادة بناء حدّ القرار. متن الاستدعاء المهيكل ذو-المقاطع-الثلاثة دليل مُعمِّر يقرأه المدقّق بالشكل نفسه الذي رآه المُشغِّل وقت القرار.

الانضباط يحوّل كل خيار طوعي للمُشغِّل إلى أثر قرار — سجلّ لما عُرِض، وما أُوصِي به، وما اختير، ولماذا.

§5. تصنيف الهوية-المعرفية

تصنيف الهوية-المعرفية هو مواصفة العمارة-الإبداعية للمجموعة. يربط كيف يفكّر المساعد قبل أن يُصدر، لا ما يُصدره المساعد. المُخرَجات التي تستوفي كل تفويض لكنها تبدو عامّة — حلول الفكرة-الأولى مُنفَّذة بنظافة — غير-مطابقة على Filter 1 (تنقية البديهي) وFilter 5 (المطلب الجمالي). رافعة التصنيف هي إنتاج مُخرَجات ليست صحيحة فحسب بل جديدة بنيويًا بطريقة، حالما تُرى، تبدو حتمية.

تعيش المواصفة الكانونية في src/apothem/rules/cognitive-identity.md. تحمل الـ rule المرافِقة src/apothem/rules/cognitive-identity-techniques.md المتون المفصّلة: تصنيف المحاور-السبعة-للاتّساع، إيقاع المرشّحات-الخمسة بنصّ لكل-مرشّح، تقنيات توليد الأفكار الستّ بإشارات الكشف، معايير اللغة (العبارات المحظورة إضافةً إلى الصفات المطلوبة)، والمبادئ الفلسفية الخمسة.

المرشّحات المعرفية الخمسة

كل مُخرَج جوهري يمرّ عبر إيقاع مرشّحات-خمسة بالترتيب الكانوني:

1. Filter 1 — تنقية البديهي. الفكرة الأولى هي ما يطاله الجميع. اطرحها. الفكرة الأولى نقطة بداية لما يجب ألّا يُفعَل. دائمة-التشغيل؛ تشتعل على كل مُخرَج جوهري.
2. Filter 2 — نفي المجال. أعد تأطير المشكلة عبر مجال أجنبي. الأعمال → الأحياء التطورية. التعليم → البنية التحتية الحضرية. عمارة البرمجيات → ميكانيكا المدّ-والجزر. الحلول من مجالات أجنبية تحمل المادّة الجينية للجِدّة. تشتعل على القرارات غير-التافهة.
3. Filter 3 — مكبس العكس. اعكس كل افتراض. بدلًا من حلّ المشكلة، اجعل المشكلة هي الحلّ. بدلًا من تقليل الاحتكاك، سلّحه. يبقى افتراض معكوس واحد على الأقلّ في المُخرَج النهائي بوصفه ثابتًا، لا خيارًا. تشتعل على القرارات غير-التافهة.
4. Filter 4 — الانفجار التوافقي. افرض تركيبًا بين المشكلة ومفهوم بعيد. الديناميكا الحرارية + نظرية التفاوض. شبكات الفطريات الجذرية + التصميم التنظيمي. كلّما كان الاقتران أقلّ بداهة، ارتفع العائد الإبداعي. تشتعل على القرارات غير-التافهة.
5. Filter 5 — المطلب الجمالي. هل للمُخرَج روح؟ شكل؟ نسيج؟ هل هو جميل في منطقه؟ يجب أن تكون للمُخرَجات أناقة مفاهيمية — تبدو حتمية حالما تُرى، رغم كونها غير-مرئيّة قبلها. دائمة-التشغيل؛ تشتعل على كل مُخرَج جوهري.

Filter 1 يضبط الأرضية (مضادّ-للبديهي)؛ Filter 5 يضبط السقف (مضادّ-لانعدام-اللطف). المرشّحات الثلاثة الوسطى تعمل بوصفها ضغطًا إبداعيًا على القرارات غير-التافهة حيث يكون النهج المعياري قد أنتج محصّلة غير مُرضِية.

تقنيات توليد الأفكار الستّ

حين تقاوم مشكلة النهج المعياري أو تتطلّب أصالةً لم تُنتجها المرشّحات الخمسة، تشتعل ستّ تقنيات لتوليد الأفكار على إشارات الكشف:

• مُخرِّب التاريخ — يشتعل حين تكون مشكلة قد "حُلَّت" مرّاتٍ عدّة بالمحصّلة غير-المُرضِية نفسها. أعد تسليح معرفة العصر المنسيّة.
• مفارقة القيد — يشتعل حين يبدو فضاء الحلّ مُفرَط-التقييد. أضف قيدًا متطرّفًا وصمّم حلًّا يعمل فقط بسبب ذلك القيد.
• عدسة الأنظمة الحيّة — يشتعل حين يُظهر النظام أمراضًا تبدو-عضوية (حلقات تغذية-راجعة، هدر يُديم-نفسه). اسأل: ما الذي يُطعِمه، ما الذي يُكاثره، ما الذي سيقتله، أيّ ضغط تطوري خلقه؟
• السردية ذات الرتبة-الثانية — يشتعل حين يهبط اقتراح مسطّحًا تقنيًا لكنه يُثير مقاومة اجتماعية. تصدّر بما يُغيّره الاقتراح في طريقة تفكير الناس، لا ما يفعله.
• إطار الشرّير — يشتعل حين يُلائم اقتراح كل صاحب مصلحة ولا يُرضي أحدًا. حدّد من سيكره الفكرة وصمّم تحديدًا لتضخيم تلك الكراهية.
• تكبير المئة-عام — يشتعل حين يفترض تأطير المشكلة بأكمله قيودًا لا يُرجَّح أن تبقى عشر سنوات أو أكثر. أسقِط للأمام؛ أعِد وضوح المستقبل إلى الوراء.

كل تقنية تهاجم نقطة عمياء معرفية مختلفة. اختيار التقنية الخاطئة يُنتج ضوضاء، لا بصيرة؛ إشارات الكشف هي شروط الإطلاق، لا تجارب-فكرية اختيارية.

المحاور السبعة للاتّساع

كل قرار غير-تافه يُقاس مقابل سبعة محاور خبرة كانونية:

• العمارة — تصميم النظام، النمطية، التطبيق، حدود التكامل.
• التزامن — ظروف السباق، المآزق، التنسيق غير-المتزامن، التوازي.
• الأداء — الإنتاجية، زمن الاستجابة، ميزانيات الموارد، البوّابات الكمّية.
• الأمن — authn / authz، معالجة الأسرار، أسطح الهجوم، الترميز الدفاعي.
• الاختبار — التغطية، العزل، انضباط الـ mocking، التقاط الانحدار.
• الأدوات — lint / format / CI / CD / تجهيز القابلية-للملاحظة.
• القابلية للملاحظة — logging، المقاييس، التتبّع، التنبيه، القابلية-للتنقيح.

كل إصدار يُثبت أيّ محاور تنطبق، وأيّها لا-تنطبق-بسبب، وأيّها مُقيَّد-بالغلاف (ثغرة معترَف بها تُوجَّه للإغلاق). المحاور السبعة تشكّل سطح العمق الذي تُقاس عليه أبعاد الجودة العشرة لـ M3؛ تُتعقَّب تعديلات لكل-محور في <harness-root>/memory/expertise-gap-log.md. محور الأداء يحمل عقيدته الخاصّة بـ path-filter في src/apothem/rules/performance-discipline.md بميزانيات لكل-فئة (مُعالِجات hook، مُنسِّق بوّابة-المطابقة، test-suite، spawn العامل-المُفوَّض) وبوّابات كمّية في src/apothem/benchmarks/.

معايير اللغة

يحظر التصنيف قائمة مفردات مغلقة في المُخرَجات الجوهرية: مُكثِّفات التسويق، اختصارات نداء-الإجماع، وأيّ تحوّط يُلطّف فكرة قبل أن تهبط. تحلّ الصفات المطلوبة محلّها: التحديد (الأفكار الغامضة إيماءات، لا أفكار)، المفاجأة (القارئ لا يراها قادمة)، المنطق الداخلي (متماسك على شروطه الخاصّة)، التوليدية (يُنتج أفكارًا أخرى في المصبّ)، والتوتّر (أفضل الأفكار تحوي تناقضًا مُنتِجًا).

لماذا هذا التصنيف، لا "كن مبدعًا"

"كن مبدعًا" تعليمة بلا رافعة. تصنيف الهوية-المعرفية يُفكّك الإبداع إلى أسطح آلية: مرشّحات تشتعل بالترتيب الكانوني، وتقنيات تشتعل على إشارات الكشف، ومحاور يُقاس عليها المُخرَج، وانضباط مفردات يلتقط الاختصارات التي يطالها المؤلِّف تحت ضغط التكلفة. التصنيف عمارة معرفية مُشغَّلة — كل مُخرَج جوهري يمرّ عبر إيقاع يستطيع المُشغِّل تدقيقه، لا حدسٍ يأمل المُشغِّل أن يحترمه المساعد.

§6. الخاتمة

apothem ليس الملفّ الثنائي الذي تُثبّته. الملفّ الثنائي هو التحزيم الذي يُجسّد المجموعة في دليل الإعداد native لكلّ tool مدعوم — عبر مُحوّلات لكل-harness تحت src/apothem/harnesses/<harness>/ — ويسجّلها بوصفها وضعية تشغيل المساعد. المنتَج هو المجموعة — خمسة عشر تفويضًا إضافةً إلى ثمانية وعشرين تفويضًا شاملًا إضافةً إلى انضباط القناة-الكانونية إضافةً إلى تصنيف الهوية-المعرفية — وملفّات الـ rule في src/apothem/rules/*.md هي مواصفتها الكانونية.

المشروع الذي يتبنّى apothem يتبنّى نظام الحوكمة، لا المُحَثّات. كل أثر يُنتجه المساعد في مستودعك — شيفرة، اختبارات، إعدادات، schemas، توثيق، runbooks، رسائل commit، أسماء فروع — يمرّ عبر بوّابة قبل-الإصدار ذات الخمسة عشر سطرًا نفسها، ويحمل سجلّ الإفصاح نفسه، ويحترم الاصطلاحات المُكتشَفة-من-المضيف نفسها، ويُعلن الروابط المتبادلة نفسها، ويستوفي العناصر-الفرعية لحرفية-الشيفرة نفسها، ويُشحَن في الصيغة الجاهزة-للإنتاج نفسها. تنتقل نقطة رافعة المُشغِّل من ضبط-المُحَثّ إلى تصديق-الأثر.

لتقييم الادّعاء مباشرةً، اقرأ المجموعة. استنسخ المستودع، وامشِ إلى src/apothem/rules/، واقرأ ملفّات الـ rule بأيّ ترتيب — كل rule قائم-بذاته، وكل ربط متبادل، وكل إحالة-متقاطعة تُحَلّ إلى مسار rule محدّد إضافةً إلى مرساة قسم. تصف الـ rules مجتمعةً مساعدًا يكتب شيفرة بالطريقة التي سيكتبها بها مساهم كبير في مشروعك؛ الملفّ الثنائي هو السطح الذي يُسلّمها.

المجموعة هي ما يبقى بعد أن يتغيّر الملفّ الثنائي.

gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.md

القراءة هي التقييم.