التموضع
افهم Apothem بوصفه حوكمة لتصديق المُنتَجات بخمسة عشر تفويضًا، وانضباط مدخلات عبر القناة المرجعية، ومعمارية إبداعية للهوية المعرفية للعمل الذي يقوده المساعد.
الجمهور: المقيّمون الذين يقرّرون ما إذا كانوا سيتبنّون
apothemللعمل الإنتاجي الذي يقوده المساعد. الطول: نحو 12 دقيقة للقراءة من البداية إلى النهاية. يمكن تصفّحه قسمًا قسمًا. الغرض: تأطير ما هوapothemفعلًا، وما ليس هو، ولماذا تختلف الإجابة عن سؤال «ماذا يوزّع هذا المشروع؟» بنيويًا عن الإجابة التي تقدّمها معظم مشاريع أدوات الحوكمة.
§1. الأطروحة
apothem هو حوكمة تصديق المُنتَجات، مُحزَّمة في ملف ثنائي.
التأطير التقليدي لأدوات المساعد هو ضبط المُوجِّهات: مُوجِّه نظام، واختيار نموذج، واستراتيجية لنافذة السياق، ومكتبة صغيرة من أوامر الشرطة المائلة، وكومة من فولكلور هندسة المُوجِّهات. وفي ظل ذلك التأطير تكون نقطة الرافعة لدى المُشغِّل هي النص الذي يسلّمه إلى النموذج. وحين يسيء النموذج التصرّف، يكون التعافي بتحرير النص. والمُنتَج الذي يوزّعه المشروع هو مجموعة المُوجِّهات.
يرفض apothem ذلك التأطير.
نقطة الرافعة لمساعد يعمل على مشروع حقيقي ليست النص الذي يسلّمه المُشغِّل إلى النموذج — بل هي المُنتَج الذي يوشك النموذج على إصداره. سيصل ذلك المُنتَج إلى مساحة عمل، ويُودَع، ويُراجَع، ويُدمَج، ويُنشَر، وتستشهد به مُنتَجات لاحقة، ويرثه مساهمون مستقبليون. وجودته خاصّية لا رجعة فيها في المصبّ لا يستطيع المُوجِّه إصلاحها بأثر رجعي. وتحرير المُوجِّه بعد وصول كوميت مشوّه ضريبةٌ على المُشغِّل، لا استعادة للمُنتَج.
الانضباط الذي يرمّزه هذا المشروع هو العكس: يمرّ كل إصدار عبر بوابة مهيكلة ومتّفق عليها ومفحوصة آليًا قبل أن يغادر يدَي المساعد. وتُنفِّذ البوابة خمسة عشر تفويضًا تمتدّ عبر اكتشاف المضيف، والإفصاح، وأبعاد الجودة العشرة، والتطبيق الذاتي، ونظافة السلطة، ودمج الخبرة، وتعليق الخيارات، والقطعية، والرافعة البصرية، والربط ثنائي الاتجاه، وجهاز سباقات أجايل، والتخطيط المرجعي، وحرفة الشيفرة، والمشاركة النظامية، والجاهزية للإنتاج. وكل تفويض هو قاعدة بنطاق مُرشَّح بالمسارات ومتن يُفعِّل فئة فشل محدّدة. وكل فشل في البوابة اكتشاف بنيوي يُظهره المساعد — وليس أبدًا تدهورًا صامتًا.
مدوّنة القواعد هي المنتَج نفسه. أما الملف الثنائي apothem فهو تحزيمها — سطح توزيع يحمل المدوّنة إلى جذر إعدادات المستخدم لدى كل مُشغِّل ويسجّلها بوصفها وضعية تشغيل المساعد. والتحزيم قابل للاستبدال؛ أما المدوّنة فهي الأصل طويل الأمد.
المشروع الذي يتبنّى apothem لا يتبنّى مُوجِّهًا. إنه يتبنّى نظام حوكمة. يفي كل مُنتَج يُصدره المساعد في مستودع المضيف — شيفرة، واختبارات، وإعدادات، ومخططات، ووثائق، وأدلة تشغيل، ورسائل كوميت، وأسماء فروع — بالأرضية نفسها ذات الأشرطة الخمسة عشر. وتنتقل نقطة الرافعة لدى المُشغِّل من «ماذا ينبغي أن أقول للمساعد؟» إلى «أيّ تفويضات تقيّد هذا الإصدار، وأيّ دليل تتطلّبه البوابة؟». والانتقال بنيوي، لا أسلوبي.
تؤطّر هذه الوثيقة لماذا تُعدّ المدوّنة الأصل الحامل للعبء، وتستعرض التفويضات الخمسة عشر مع مراسيها في ملفات القواعد، وتُظهر الانضباطين الشاملين (معالجة المدخلات عبر القناة المرجعية، والمعمارية الإبداعية للهوية المعرفية) اللذين يربطان المدوّنة في كلّ متماسك.
§2. معمارية الأعمدة الثلاثة
ترتكز المدوّنة على ثلاثة أعمدة. كل عمود سطح قابل للفصل له مواصفته المرجعية الخاصة؛ وكل عمود يعزّز العمودين الآخرين.
العمود A — سجلّ التفويضات (M1–M15 + CM-1..CM-28)
سجلّ التفويضات هو سطح الحوكمة ذو المحور الخارجي. تحكم M1–M15 كل مُنتَج يُنتجه المساعد في مشروع مضيف: اكتشاف المضيف، والإفصاح، وأبعاد الجودة العشرة، والتطبيق الذاتي، والسلطة، والخبرة، وتعليق الخيارات، والقطعية، والرافعة البصرية، والربط ثنائي الاتجاه، وسباقات أجايل، والتخطيط المرجعي، وحرفة الشيفرة، والمشاركة النظامية، والجاهزية للإنتاج. ويُعتمَد السجلّ مرجعيًا بوصفه سجلّ التفويضات الخمسة عشر، وتُفعِّله ملفات القواعد المُعدَّدة في §3 أدناه.
CM-1..CM-28 هي النظائر ذات المحور الداخلي — تفويضات تشغيلية تحكم انضباط تفاعل المساعد (التقييم النقدي، وصفر افتراضات، والبحث قبل التنفيذ، وتقييم الحلّ الأفضل، والصراحة القاطعة، وسرعة القرار، والتركيز على عنق الزجاجة أولًا، والمنتج المتّسق، وعشرين مدخلًا آخر تغطّي موضعية الخطط، ورعاية السياق، وتنسيق العمل المُفوَّض، وتوليد الملفات الكبيرة، ودورة حياة الذاكرة). ويُعتمَد المحور الداخلي مرجعيًا في قاعدة التفويضات التشغيلية وفي site/content/docs/governance/cross-cutting-mandates.mdx.
يمرّ كل إصدار عبر المحورين كليهما. وتُشغِّل البوابة في src/apothem/rules/pre-emission-gate.md الأشرطة الخمسة عشر الميكانيكية والاستدلالية لكل إصدار، وتسجّل كتلة تحقّق في تتبّع العمل الخاص بالمُنتَج.
العمود B — انضباط القناة المرجعية
يحكم انضباط القناة المرجعية كيف يلتمس المساعد مدخلات المُشغِّل. أُلغي استخدام المُوجِّهات حرّة الصيغة في المنظومة كلها؛ ويُوجَّه كل خيار عبر قناة الاستفسار المُهيكَل بمخطط مُهيكَل لتعليق الخيارات (مبرّر + توصية + مؤشّر افتراضي لكل خيار)، وتصنيف توصيات مغلق، وأرضية تأكيد للعمليات التدميرية على مستوى كل ملف، ومسح إرشادي يلتقط انحراف المُوجِّهات الحوارية عبر كل سطح محكوم. وتقع المواصفة الكاملة في src/apothem/rules/interactive-questions.md مع العمق في المرافقَين المُرشَّحَين بالمسارات src/apothem/rules/interactive-questions-canonical-shapes.md وsrc/apothem/rules/interactive-questions-sweep-matchers.md.
رافعة هذا الانضباط هي قابلية تدقيق القرار. يحمل كل خيار إرادي للمُشغِّل الدليل الذي نظر فيه المساعد، والتوصية التي أصدرها المساعد، والمبرّر المستند إلى دوافع ملموسة. وبعد ستة أشهر من الخيار، يستطيع مدقّق يقرأ سجلّ الإفصاح إعادة بناء حدّ القرار دون الرجوع إلى ذاكرة المُشغِّل.
العمود C — تصنيف الهوية المعرفية
يحكم تصنيف الهوية المعرفية كيف يفكّر المساعد. تؤلّف خمسة مرشّحات معرفية متتابعة (تنقية البديهي، ونفي المجال، ومكبس العكس، والانفجار التوافقي، والمطلب الجمالي) إيقاعًا إبداعيًا. ويُطبَّق المرشّحان الأول والأخير على كل مُخرَج جوهري؛ وتُطبَّق المرشّحات الثلاثة الوسطى على القرارات غير التافهة. وتُطلَق ست تقنيات لتوليد الأفكار (المخرِّب التاريخي، ومفارقة القيد، وعدسة الأنظمة الحيّة، والسرد من الدرجة الثانية، وإطار الشرّير، وتقريب 100 عام) عند إشارات الكشف حين يكون النهج المعتاد قد أفضى إلى نتيجة غير مُرضية. وتشكّل سبعة محاور للاتّساع (المعمارية، والتزامن، والأداء، والأمن، والاختبار، والأدوات، وقابلية الملاحظة) سطح العمق الذي يُثبِت كل قرار غير تافه توافقه معه. وتقع المواصفة الكاملة في src/apothem/rules/cognitive-identity.md مع العمق في المرافق المُرشَّح بالمسارات src/apothem/rules/cognitive-identity-techniques.md.
رافعة التصنيف هي الجِدّة البنيوية. يُسقِط مرشّح تنقية البديهي إجابة الفكرة الأولى التي يمدّ الجميع أيديهم إليها؛ ويشترط مكبس العكس أن يبقى افتراض معكوس واحد على الأقل في المُخرَج النهائي؛ ويرفض المطلب الجمالي الأشكال الوظيفية لكنها سهلة النسيان. والنتيجة مساعد ينتج مُخرَجات يتوقّف عندها المُشغِّلون ويعيدون قراءتها — لا لأن النص مزخرف، بل لأن الخيار البنيوي غير بديهي على نحو يبدو معه، حالما يُرى، حتميًّا.
كيف يعزّز كل عمود الآخرين
الأعمدة الثلاثة يحمل بعضها عبء بعض. يحدّد سجلّ التفويضات (العمود A) ما يجب أن يستوفيه المُنتَج. ويحدّد انضباط القناة المرجعية (العمود B) كيف تدخل مدخلات المُشغِّل إلى سطح القرار الذي يُنتج المُنتَج. ويحدّد تصنيف الهوية المعرفية (العمود C) الإيقاع الإبداعي الذي يمنح المُنتَج شكله. وإزالة أي عمود واحد تُسقِط العمودين الآخرين: سجلّ بلا قناة مرجعية ينتج مُنتَجات تُضبَط على قيم افتراضية بصمت تبدو مطابقة لكنها تُخفي قرارات بنيوية؛ وقناة مرجعية بلا عمق معرفي تنتج مُخرَجات موجَّهة توجيهًا صحيحًا لكنها عامّة الشكل؛ وإيقاع معرفي بلا سجلّ ينتج مُنتَجات أنيقة جماليًا لكنها تفشل في الاندماج مع المشروع المضيف.
§3. جولة في سجلّ التفويضات
سجلّ التفويضات الخمسة عشر هو سطح الحوكمة المرجعي ذو المحور الخارجي. يسمّي كل قسم فرعي أدناه التفويض، ونطاقه التشغيلي، وملف القواعد الذي يحمل المواصفة المرجعية. وكل ملف قواعد مُرشَّح بالمسارات إلى فئات المُنتَجات التي يحكمها، ويُحمَّل عند الطلب في سياق تشغيل المساعد حين تُمَسّ تلك الفئات.
M1 — الحياد تجاه المشروع المضيف واكتشاف الاصطلاحات
النطاق. كل ما ينتجه المساعد في مشروع مضيف تشكّله حقيقة ما عليه المشروع المضيف أصلًا — مكدّس تقنياته، ولغته، وإطار البرمجة، وسلسلة أدواته، والمُنسِّق، وأداة lint، وإطار الاختبار، ومولّد الوثائق، واستراتيجية الفروع، واصطلاح رسائل الكوميت، والتخطيط، والتسمية، وسياسة تثبيت الاعتماديات. وكل واحد منها يُكتشَف من مصدر الحقيقة المرجعي لدى المضيف (ملفات البيان، وملفات القفل، والملفات الشقيقة من النوع القابل للمقارنة، ووثائق الاصطلاح على مستوى المستودع) ويُحترَم. وحيث يصمت المضيف عن اصطلاح يجب أن يتبنّاه المساعد، يظهر الصمت بوصفه استفسارًا سلطويًا بموجب M5 — ولا يُحسَم أبدًا باختيار افتراض داخلي بصمت.
المواصفة المرجعية. src/apothem/rules/host-discovery.md (مع فهرس البيانات لكل لغة في src/apothem/rules/host-discovery-manifests.md).
لماذا يهمّ. إصدار المساعد لا يمكن تمييزه عن إصدار كان سيكتبه مساهم قديم العهد في المشروع المضيف. وانحراف الاصطلاح فشل بنيوي، لا تفضيل أسلوبي.
M2 — الانضباط التحريري والتعديلات المُفصَح عنها
النطاق. كل تغيير ذي نطاق معتبر يحمل سجلّ إفصاح صريحًا — ما طُلِب، وما عُدِّل، وما وُسِّع، وما نُقِّح، وما أُجِّل. والامتثال المفرط الصامت («فعل بالضبط ما طُلِب، مع أنه كان خاطئًا») والتجاوز المفرط الصامت («وسّع نطاق التغيير دون إخبار») كلاهما فشل. وكل تعديل يحمل مبرّرًا بمستوى علمي / تقني (مرجع مستشهَد به، أو RFC، أو وثائق المورّد، أو سابقة ملف شقيق، أو نمط مُسمّى من الأدبيات).
المواصفة المرجعية. src/apothem/rules/disclosure-ledger.md (مع فهرس فئات العلامات في src/apothem/rules/disclosure-ledger-markers.md).
لماذا يهمّ. الفرق الذي يُصلح بصمت خللًا مجاورًا أثناء تنفيذ التغيير المطلوب هو تعديل غير مُفصَح عنه. ولا يستطيع مراجِع بعد ستة أشهر أن يميّز الإصلاح المتعمَّد من الانحراف. والسجلّ هو سطح التدقيق والاسترداد.
M3 — أبعاد الجودة العشرة
النطاق. يُقيَّم كل مُنتَج مقابل عشرة أبعاد للجودة قبل إصداره: الصرامة العلمية، والاتّساق / التماسك / التكامل / الصلاحية، والقابلية للضبط بالإعدادات / عدم التكرار / التوحيد، والقابلية للقراءة / البداهة / النظافة، واليُتم / التقادم، والبنيوية / المنظومية / الانتظام / الشمول، والمعمارية، وانتظام التسمية، والإسناد العلمي / التقني، والأمثلة / الاختبارات / docstrings / الوثائق. وفشل المُنتَج الواحد في أبعاد متعدّدة تضاعفي، لا تراكمي — فالمُنتَج الذي هو متقادم ويتيم وغير متّسق التسمية وغير موثَّق في آنٍ واحد مرشّح للسحب لا للإصلاح.
المواصفة المرجعية. src/apothem/rules/ten-dimension-check.md (مع متون كل بُعد في src/apothem/rules/ten-dimension-check-dimensions.md).
لماذا يهمّ. الجودة قابلة للتفكيك. وتسمية الأبعاد العشرة تجعل كل بُعد قابلًا للتدقيق والإظهار بمعزل عن غيره؛ فتتحوّل ملاحظات «يبدو هذا ضعيفًا» الغامضة إلى ملاحظات محدّدة مثل «البُعد 5، التقادم: المرجع في السطر 42 يشير إلى ملف نُقل».
M4 — التطبيق الذاتي — بوابة ما قبل الإصدار
النطاق. يمرّ كل مُنتَج عبر بوابة ما قبل الإصدار ذات الخمسة عشر شريطًا قبل إصداره. وتحمل الأشرطة الميكانيكية (M5، M7، M8، M10، M13) مُطابِقات قابلة للتنفيذ في src/apothem/conformity/*-grep.py ينسّقها src/apothem/conformity/gate.py. أمّا الأشرطة M3 وM9 وM12 وM14 وM15 فهي ميكانيكية جزئيًا: تغطّي المُطابِقات القابلة للتنفيذ جزءًا من كل شريط، ويقيّم المساعد العامل الباقي. وتُقيَّم الأشرطة الاستدلالية (M1، M2، M4، M6، M11) ولا يكون لها مُطابِق، فيقيّمها المساعد العامل ويسجّلها في كتلة التحقّق. ويتحقّق الشريط M4 نفسه من وجود كتلة التحقّق في تتبّع العمل الخاص بالقِطعة. ويحجب فشلُ شريط واحد الإصدار؛ ويستمرّ التكرار حتى يجتاز كل شريط.
المواصفة المرجعية. 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، وأوصاف طلبات السحب، ووثائق التصميم، وخطوات أدلة التشغيل، وتعليقات الشيفرة، ومتون رسائل الكوميت، وطلبات التعليقات (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 ↔. وكل ربط مُعلَن في اتجاه واحد له مؤشّر عائد متبادل في الطرف الآخر؛ وأنصاف الحواف فشل بنيوي، لا تفضيل جمالي. ويفرض فحص grep ميكانيكي للتبادلية في src/apothem/conformity/binding_reciprocity_grep.py الثابتَ عند البوابة.
المواصفة المرجعية. src/apothem/rules/bidirectional-binding.md.
لماذا يهمّ. تحوّل الروابط المتبادلةُ المدوّنةَ إلى رسم بياني قابل للتنقّل. فصف Cross-bound with ↔ في أي قاعدة يشير إلى كل قرين يستشهد بها، ويشير كل قرين مُستشهَد به إلى القاعدة بدوره. وتصبح إعادة هيكلة المدوّنة ميكانيكية — غيّر اسم قاعدة، فيُعلِّم فحص 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).
لماذا يهمّ. الفرق الضخم الممتدّ لأيام عدّة بلا بنية سباق معتمٌ أمام المراجعة. ويُظهر الجهاز كل زيادة، وكل معيار قبول، وكل رفض لحظة حدوثه — لا مؤجَّلًا إلى مراجعة استرجاعية بعد زمن طويل من صيرورة القرار البنيوي غير قابل للرجوع عنه.
M12 — طبقات التقارير والتخطيط المرجعي للمُخرَجات المُولَّدة
النطاق. يُصدِر العمل غير التافه متعدّد الخطوات تقارير على طبقتين: تقريرًا لكل مرحلة فرعية على طبقة العمل، وتقريرًا تجميعيًا على مستوى المرحلة على طبقة المراجعة يُجمِّع ولا يَضمّ التقارير بعضها إلى بعض — قالب موحّد عبر المراحل الفرعية، ومقاييس مُجمَّعة، وأنماط مُظهَرة، وفحص ذاتي على مستوى المرحلة، وإعلانات خارجية. وتوجد المُخرَجات المُولَّدة في مواقع مرجعية قابلة للتنبّؤ يكتشفها المضيف، مع المنشأ وإحالات متقاطعة متبادلة. والمُخرَجات اليتيمة (مُنتَجات بلا مستهلك / بلا مدخل فهرس / بلا إسناد إلى منتِج) فشل بنيوي.
المواصفة المرجعية. src/apothem/rules/canonical-layout.md (مع متون طبقات التقارير في src/apothem/rules/canonical-layout-reporting-tiers.md).
لماذا يهمّ. تصبح قائمة مسطّحة من report1.md / report2.md في مواقع ارتجالية غير مقروءة بعد ستة أسابيع. وانضباط الطبقتين مع التخطيط المرجعي للمضيف يعني أن كل مُخرَج قابل للاكتشاف، وكل مستهلك مسمّى، وكل منتِج يمكن إسناده.
M13 — اصطلاحات حرفة الشيفرة
النطاق. يستوفي كل مُنتَج شيفرة أحد عشر عنصرًا فرعيًا: التعليق بمنطق «لماذا» لا «ماذا»، والتسمية الكاشفة عن النيّة، ومعالجة الاستثناءات المحدّدة، وتصميم الدوال والوحدات مع الميل إلى المسؤولية الواحدة، ومستويات التسجيل المقصودة، والاختبار الذي يصف السلوك، واجتياز المُنسِّق / أداة lint / مدقّق الأنواع بلا ملاحظات، والشيفرة الواعية بالأمن (بلا أسرار مُضمَّنة في الشيفرة، وبلا حقن صدفة، وبلا فكّ تسلسل غير آمن)، وانضباط التزامن، وإحلال الثوابت المسمّاة محل القيم العددية غير المفسَّرة، وتغطية سطح الوثائق. وتحمل القواعد الشقيقة الخاصة بكل لغة التجسيد الخاص باللغة.
المواصفة المرجعية. src/apothem/rules/code-craft-conventions.md (قاعدة مختصرة للتفويض الشامل) إضافةً إلى القواعد الشقيقة الخاصة بكل لغة src/apothem/rules/code-craft-python.md، وsrc/apothem/rules/code-craft-shell.md، وsrc/apothem/rules/code-craft-markdown.md.
لماذا يهمّ. يتراكم انحراف حرفة الشيفرة. يصبح معالج استثناء عارٍ واحد السابقةَ التي يستشهد بها المساهم التالي؛ ويصبح سرّ مُضمَّن واحد في الشيفرة الاصطلاحَ الذي يقبله الفريق؛ وتصبح قيمة عددية واحدة غير مفسَّرة اثنتي عشرة. وتسمّي العناصر الفرعية الأحد عشر فئات الفشل، وتفرضها البوابة عند كل إصدار.
M14 — المنظومية داخل منظومة المشروع المضيف
النطاق. يُعلن كل مكوّن مُستحدَث حديثًا أربع علاقات نظامية — المنبع (ما يُطلِقه)، والمصبّ (ما يستهلكه)، والأقران (الأشقاء من النوع نفسه)، والمُنفِّذون (بوابات الجودة لدى المضيف التي تحكمه) — ويتقارب مع اصطلاحات الأقران في مجموعة التغييرات نفسها. والصوامع (مُنتَجات قائمة بذاتها تنحرف عن اصطلاحات الأشقاء، أو تكرّر وظيفة قائمة) واليتامى (مكوّنات بلا مستهلك / بلا مدخل فهرس / بلا إسناد إلى منتِج) فشل بنيوي.
المواصفة المرجعية. src/apothem/rules/systemic-participation.md (مع العمق التشغيلي في src/apothem/rules/systemic-participation-relations.md).
لماذا يهمّ. الاختبار أو الوثيقة أو سير العمل أو الوحدة أو مدخل الإعداد الجديد الذي لا يُعلن موضعه في رسم الإحالات لدى المضيف غير مرئي للصيانة. وإعلان العلاقات الأربع مع تحديث السجلّ في مجموعة التغييرات نفسها يعني أن كل مكوّن قابل للاكتشاف وللتراجع عنه منذ أول كوميت له.
M15 — انضباط الجاهزية للإنتاج على مُنتَجات المشروع المضيف
النطاق. يُشحَن كل تغيير في صيغة جاهزة للإنتاج: اختبارات + وثائق + مدخل CHANGELOG + رسالة كوميت مطابقة + CI أخضر في مجموعة التغييرات نفسها. وتُحفَظ وضعية سلسلة التوريد (لا اعتمادية غير مثبَّتة، ولا قيمة سرّية حرفية، ولا تصعيد أذونات، ولا actions غير مثبَّتة، ولا إصدار غير موقَّع حيث يلزم التوقيع). وتُحفَظ ثوابت هندسة الإصدار (احترام ترقيم النسخ، واتّساق الوسم مع النسخة، وتوقيع الوسم حيث يلزم). ويُستوفى سطح المشروع الحديث (سكربتات تثبيت / تحديث / إزالة مزدوجة متعدّدة أنظمة التشغيل، وأصل الشعار، ورأس README حديث مُوسَّط، وأقسام التثبيت / التحديث / الإزالة). وتسمّي بيانات التأليف في كل كوميت المساهمين البشر فقط — فلا ينسب المساعد أبدًا نفسه ولا النموذج اللغوي الكامن إلى أي كوميت أو مذيّل أو فرع أو وسم أو حقل في طلب سحب.
المواصفة المرجعية. src/apothem/rules/production-ready-prs.md (مع أسطح الظهور ومواصفة السطح الحديث في src/apothem/rules/production-ready-prs-surfaces.md).
لماذا يهمّ. «سأضيف الاختبارات في متابعة لاحقة» لا يتحقّق أبدًا. وانضباط مجموعة التغييرات الواحدة يسدّ نمط الفشل الذي يولّد أكبر كلفة تراكمية في المشاريع طويلة الأمد: عمل جودة مؤجَّل يتراكم حتى يصير دَينًا تقنيًا نظاميًا.
§4. انضباط القناة المرجعية
انضباط القناة المرجعية هو النظير من جهة المدخلات لإنفاذ سجلّ التفويضات من جهة الإصدار. فكل خيار يعرضه المساعد على المُشغِّل يُوجَّه عبر قناة الاستفسار المُهيكَل. والمُوجِّهات الحوارية حرّة الصيغة بوصفها مدخلًا أساسيًا محظورة؛ ويُفرَض الانضباط عند البوابة بسبعة مُطابِقات إرشادية (H1–H7) تمسح كل سطح محكوم وتُعلِّم الانحرافات بوصفها اكتشافات في البوابة.
تقع المواصفة المرجعية في src/apothem/rules/interactive-questions.md. وتحمل القواعد المرافقة العمق: يحمل src/apothem/rules/interactive-questions-canonical-shapes.md الأمثلة التطبيقية، ومتون المخططات، وتصنيف التوصيات، والبديل الاحتياطي لإطار العمل، ومجموعات الخيارات المرجعية للعمليات التدميرية، وأمثلة المؤشّر الافتراضي التطبيقية؛ ويحمل src/apothem/rules/interactive-questions-sweep-matchers.md فهرس مُطابِقات H1–H7 مع استدعاءات ripgrep قابلة لإعادة الإنتاج.
شكل السؤال المُهيكَل
يحمل كل استدعاء أربعة حقول: question من جملة واحدة تنتهي بعلامة استفهام، وheader قصير (اثنا عشر حرفًا كحدّ أقصى)، ومصفوفة options من عنصرين إلى أربعة عناصر، وقيمة منطقية multiSelect. ويحمل كل خيار label من كلمة إلى خمس كلمات ومتن description من ثلاثة مقاطع ثابتة الترتيب:
- المبرّر — جملة واحدة تذكر ماذا يعني هذا الخيار وعاقبته المباشرة القابلة للملاحظة على حالة المنظومة.
- التوصية — قيمة واحدة من التصنيف المغلق: recommended، أو acceptable، أو discouraged، أو destructive-no-default. وتحمل القيم غير المحايدة عبارة «لماذا» تستشهد بدافع ملموس واحد على الأقل من تصنيف مغلق ذي ست فئات: القرارات المقفلة، والمخاطر المسمّاة، والقيود المسمّاة، ومواقف الأسئلة المفتوحة، واستشهادات القواعد، وحالة المنظومة المُلاحَظة. وعبارة من قائمة المنع الخاصة بالمبرّرات الغامضة غير مطابقة حين تقف مبرّرًا وحيدًا لتوصية غير محايدة.
- المؤشّر الافتراضي — يسمّي الافتراضي الآمن مع مبرّره، أو يُعلن صراحةً
no-default: user decision required. وتستخدم العمليات التدميرية صيغة no-default في كل الأحوال.
يحمل الاستدعاء أحادي الاختيار (multiSelect: false) خيارًا واحدًا على الأكثر بلاحقة التسمية الخاصة بعلامة التوصية؛ ويجوز أن يحمل الاستدعاء متعدّد الاختيار عدّة خيارات بهذه اللاحقة، أمّا الاستدعاء الذي لا خيار موصى به فيه فلا يحمل أيّ لاحقة. وكل لاحقة مربوطة ثنائيّ الاتجاه بقيمة التوصية في المتن. ويكتشف المُطابِق H6 حالات عدم التطابق بين لاحقة التسمية وقيمة المتن بوصفها اكتشافات في البوابة.
تأكيد العمليات التدميرية لكل ملف
تُوجَّه كل عملية تدميرية — الحذف، وإعادة التسمية، والنقل، والكتابة فوق الملف دون إبقاء نسخة، والتراجع عن التعديلات غير المُودَعة — عبر قناة الاستفسار المُهيكَل على أساس كل ملف على حدة. استدعاء واحد لكل ملف، في كل مرة. وmultiSelect: true غير مطابق في استدعاءات العمليات التدميرية؛ ومجموعات الخيارات المرجعية في الأقسام الفرعية للعمليات التدميرية هي الأرضية. وإرهاق التأكيد كلفة مقبولة؛ أما التدمير الصامت فلا.
المسح الإرشادي — من H1 إلى H7
تمسح سبعة مُطابِقات ميكانيكية أسطح النواة المحكومة (الأوامر، والقواعد، والمهارات، وتعريفات العاملين المُفوَّضين، والخطّافات، وملفات إعداد إطار العمل، وCLAUDE.md) بحثًا عن فئتَي فشل:
- الإرشاديات ذات الصيغة الحوارية (H1–H3). يلتقط H1 المُوجِّهات التي تجمع بين صيغة الأمر وعلامة الاستفهام. ويلتقط H2 «Please confirm / approve / choose». ويلتقط H3 «Which of the following / these». ويُقارَن عدد إصابات كل مُطابِق بعدد مناطق الاستثناء الموثَّق (الاستشهادات الذاتية التعريفية وسياقات المحادثة المحفوظة)؛ والانحرافات اكتشافات في البوابة.
- إرشاديات الامتثال للتعليق (H4–H7). يلتقط H4 الخيارات التي ينقصها أي من مقاطع المتن الثلاثة. ويلتقط H5 التوصيات غير المحايدة التي ينقصها استشهاد بدافع ملموس. ويلتقط H6 حالات عدم التطابق بين لاحقة التسمية وقيمة المتن. ويلتقط H7 استدعاءات العمليات التدميرية التي تنقصها أرضية no-default الحرفية.
المسح قابل لإعادة الإنتاج — يحمل كل مُطابِق استدعاء ripgrep يستطيع أي مُشغِّل تشغيله على المدوّنة. والانضباط ميكانيكي، لا تأويلي.
لماذا هذا الشكل لا غيره
للمُوجِّهات الحوارية بوصفها مدخلًا أساسيًا ثلاثة أنماط فشل بنيوية يسدّها انضباط القناة المرجعية:
- محو فضاء القرار. يعرض المُوجِّه حرّ الصيغة إجراءً مقترحًا واحدًا ويطلب من المُشغِّل التصديق عليه. أما البدائل التي نظر فيها المساعد وأوزانها النسبية والمبرّر وراء المسار المختار فخافية. فيصدّق المُشغِّل أو يرفض دون أن يرى فضاء القرار.
- اللاتناظر في الانحياز. من دون علامة توصية صريحة مع مبرّر قائم على دافع ملموس، يُنقَل تفضيل المساعد عبر نبرة النص وطريقة التأطير والترتيب — وهي قنوات لا يستطيع المُشغِّل تقييمها بوصفها دليلًا. أما علامة التوصية مع الدافع المستشهَد به فتجعل الانحياز صريحًا وقابلًا للتدقيق.
- تآكل التدقيق. بعد ستة أشهر من الخيار، يرى المدقّق الذي يقرأ سجلّ المحادثة السؤال والجواب لكنه لا يستطيع إعادة بناء حدّ القرار. أما متن الاستدعاء المُهيكَل ذو المقاطع الثلاثة فهو دليل دائم يقرؤه المدقّق بالشكل نفسه الذي رآه المُشغِّل وقت القرار.
يحوّل الانضباط كل خيار إرادي للمُشغِّل إلى مُنتَج قرار — سجلّ لما عُرِض وما أُوصي به وما اختير ولماذا.
§5. تصنيف الهوية المعرفية
تصنيف الهوية المعرفية هو مواصفة المعمارية الإبداعية في المدوّنة. وهو يحكم كيف يفكّر المساعد قبل أن يُصدر، لا ما يُصدره المساعد. والمُخرَجات التي تستوفي كل تفويض لكنها تبدو عامّة — حلول الفكرة الأولى المنفَّذة بنظافة — غير مطابقة في المرشّح 1 (تنقية البديهي) والمرشّح 5 (المطلب الجمالي). ورافعة التصنيف هي إنتاج مُخرَجات لا صحيحة فحسب بل جديدة بنيويًا على نحو يبدو معه، حالما يُرى، حتميًّا.
تقع المواصفة المرجعية في src/apothem/rules/cognitive-identity.md. وتحمل القاعدة المرافقة src/apothem/rules/cognitive-identity-techniques.md المتون التفصيلية: تصنيف المحاور السبعة للاتّساع، وإيقاع المرشّحات الخمسة مع نص لكل مرشّح، وتقنيات توليد الأفكار الست مع إشارات الكشف، ومعايير اللغة (العبارات المحظورة مع الصفات المطلوبة)، والمبادئ الفلسفية الخمسة.
المرشّحات المعرفية الخمسة
تعمل المرشّحات الخمسة بالترتيب المرجعي. ويُطبَّق المرشّحان 1 و5 على كل مُخرَج جوهري؛ وتُطبَّق المرشّحات من 2 إلى 4 على القرارات غير التافهة:
- المرشّح 1 — تنقية البديهي. الفكرة الأولى هي ما يمدّ الجميع أيديهم إليه. اطرحها. فالفكرة الأولى نقطة انطلاق لما لا ينبغي فعله. يُطلَق عند كل مُخرَج جوهري.
- المرشّح 2 — نفي المجال. أعِد تأطير المشكلة عبر مجال غريب. الأعمال ← علم الأحياء التطوري. التعليم ← البنية التحتية الحضرية. معمارية البرمجيات ← ميكانيكا المدّ والجزر. فالحلول المستمدّة من مجالات غريبة تحمل المادة الوراثية للجِدّة. يُطلَق عند القرارات غير التافهة.
- المرشّح 3 — مكبس العكس. اعكس كل افتراض. بدلًا من حلّ المشكلة، اجعل المشكلة هي الحلّ. وبدلًا من تقليل الاحتكاك، حوّله إلى سلاح. يبقى افتراض معكوس واحد على الأقل في المُخرَج النهائي بوصفه ثابتًا لا خيارًا. يُطلَق عند القرارات غير التافهة.
- المرشّح 4 — الانفجار التوافقي. افرض تركيبًا بين المشكلة ومفهوم بعيد. الديناميكا الحرارية + نظرية التفاوض. شبكات الميكورايزا + التصميم التنظيمي. وكلما قلّ وضوح الاقتران ارتفع العائد الإبداعي. يُطلَق عند القرارات غير التافهة.
- المرشّح 5 — المطلب الجمالي. هل للمُخرَج روح؟ شكل؟ ملمس؟ هل هو جميل في منطقه؟ يجب أن تكون المُخرَجات ذات أناقة مفاهيمية — تبدو حتمية حالما تُرى، وإن كانت غير مرئية قبل ذلك. يُطلَق عند كل مُخرَج جوهري.
يضع المرشّح 1 الأرضية (مضادّ للبديهي)؛ ويضع المرشّح 5 السقف (مضادّ لانعدام الرشاقة). وتعمل المرشّحات الثلاثة الوسطى ضغطًا إبداعيًا على القرارات غير التافهة التي أفضى فيها النهج المعتاد إلى نتيجة غير مُرضية.
تقنيات توليد الأفكار الست
حين تستعصي مشكلة على النهج المعتاد أو تتطلّب أصالةً لم تُنتجها المرشّحات الخمسة، تُطلَق ست تقنيات لتوليد الأفكار عند إشارات الكشف:
- المخرِّب التاريخي — يُطلَق حين تكون مشكلة قد «حُلَّت» مرات عدّة بالنتيجة غير المُرضية نفسها. أعِد تحويل معارف العصر المنسية إلى سلاح.
- مفارقة القيد — يُطلَق حين يبدو فضاء الحلول مُفرَط التقييد. أضِف قيدًا متطرّفًا وصمّم حلًّا لا يعمل إلا بسبب ذلك القيد.
- عدسة الأنظمة الحيّة — يُطلَق حين يُظهر النظام أمراضًا تبدو عضوية (حلقات تغذية راجعة، وهدر يديم نفسه). اسأل: ما الذي يغذّيه، وما الذي يُكاثره، وما الذي سيقتله، وأي ضغط تطوري أوجده؟
- السرد من الدرجة الثانية — يُطلَق حين يمرّ اقتراح باهتًا من الناحية التقنية لكنه يثير مقاومة اجتماعية. ابدأ بما يغيّره الاقتراح في طريقة تفكير الناس، لا بما يفعله.
- إطار الشرّير — يُطلَق حين يراعي اقتراح كل صاحب مصلحة ولا يُرضي أحدًا. حدّد من سيكره الفكرة وصمّم تحديدًا لتضخيم تلك الكراهية.
- تقريب 100 عام — يُطلَق حين يفترض تأطير المشكلة كله قيودًا يُستبعد أن تبقى عشر سنوات أو أكثر. أسقِط الرؤية إلى الأمام؛ وأعِد وضوح المستقبل إلى الوراء.
تعالج كل تقنية نقطة عمياء معرفية مختلفة. واختيار التقنية الخاطئة ينتج ضوضاء لا بصيرة؛ وإشارات الكشف هي شروط الإطلاق، لا تجارب فكرية اختيارية.
المحاور السبعة للاتّساع
يُثبِت كل قرار غير تافه توافقه مع سبعة محاور خبرة مرجعية:
- المعمارية — تصميم النظام، والنمطية، وتقسيم الطبقات، وحدود التكامل.
- التزامن — حالات التسابق، وحالات الجمود المتبادل، والتنسيق غير المتزامن، والتوازي.
- الأداء — الإنتاجية، وزمن الاستجابة، وميزانيات الموارد، والبوابات الكمّية.
- الأمن — authn / authz، ومعالجة الأسرار، وأسطح الهجوم، والبرمجة الدفاعية.
- الاختبار — التغطية، والعزل، وانضباط المحاكيات، والتقاط الانحدارات.
- الأدوات — lint / format / CI / CD / أدوات قياس قابلية الملاحظة.
- قابلية الملاحظة — التسجيل، والمقاييس، والتتبّع، والتنبيه، وقابلية تنقيح الأخطاء.
يُثبِت كل إصدار أيّ المحاور تنطبق، وأيّها غير منطبق مع ذكر السبب، وأيّها مقيَّد بحدود غلاف الخبرة (المحور ينطبق لكنه يتجاوز غلاف خبرة المساعد؛ والثغرة معترَف بها ويُوجَّه إغلاقها). وتشكّل المحاور السبعة سطح العمق الذي تُقيَّم عليه أبعاد الجودة العشرة في M3؛ وتُتتبَّع التعديلات الخاصة بكل محور في <harness-root>/memory/expertise-gap-log.md. ويحمل محور الأداء عقيدته الخاصة المُرشَّحة بالمسارات في src/apothem/rules/performance-discipline.md مع ميزانيات لكل فئة (معالجات الخطّافات، ومُنسِّق بوابة المطابقة، ومجموعة الاختبارات، وإطلاق العامل المُفوَّض) وبوابات كمّية في src/apothem/benchmarks/.
معايير اللغة
يحظر التصنيف قائمة مغلقة من المفردات في المُخرَجات الجوهرية: المُكثِّفات التسويقية، واختصارات استمالة الإجماع، وأي تحوّط يُليِّن الفكرة قبل أن تصل. وتحلّ محلها صفات مطلوبة: التحديد (الأفكار الغامضة إيماءات لا أفكار)، والمفاجأة (لا يتوقّعها القارئ)، والمنطق الداخلي (متماسكة بشروطها الخاصة)، والتوليدية (تنتج أفكارًا أخرى لاحقًا)، والتوتّر (أفضل الأفكار تحتوي تناقضًا منتجًا).
لماذا هذا التصنيف لا «كن مبدعًا»
«كن مبدعًا» تعليمة بلا رافعة. فتصنيف الهوية المعرفية يفكّك الإبداع إلى أسطح ميكانيكية: مرشّحات تُطلَق بالترتيب المرجعي، وتقنيات تُطلَق عند إشارات الكشف، ومحاور يُثبِت المُخرَج توافقه معها، وانضباط مفردات يلتقط الاختصارات التي يلجأ إليها المؤلّف تحت ضغط الكلفة. والتصنيف معمارية معرفية مُفعَّلة — يمرّ كل مُخرَج جوهري عبر المرشّحات الثابتة، ويمرّ كل قرار غير تافه عبر الإيقاع الكامل، وفي ذلك سجلّ يستطيع المُشغِّل تدقيقه، لا انطباع يأمل المُشغِّل أن يحترمه المساعد.
§6. الخاتمة
apothem ليس الملف الثنائي الذي تثبّته. فالملف الثنائي هو التحزيم الذي يُجسِّد المدوّنة في دليل الإعداد الأصلي لكل أداة مدعومة — عبر محوّلات خاصة بكل إطار عمل تحت src/apothem/harnesses/<harness>/ — ويسجّلها بوصفها وضعية تشغيل المساعد. والمنتَج هو المدوّنة — خمسة عشر تفويضًا زائد ثمانية وعشرين تفويضًا شاملًا زائد انضباط القناة المرجعية زائد تصنيف الهوية المعرفية — وملفات القواعد في src/apothem/rules/*.md هي مواصفتها المرجعية.
المشروع الذي يتبنّى apothem يتبنّى نظام الحوكمة لا المُوجِّهات. فكل مُنتَج ينتجه المساعد في مستودعك — شيفرة، واختبارات، وإعدادات، ومخططات، ووثائق، وأدلة تشغيل، ورسائل كوميت، وأسماء فروع — يمرّ عبر بوابة ما قبل الإصدار ذات الأشرطة الخمسة عشر نفسها، ويحمل سجلّ الإفصاح نفسه، ويحترم الاصطلاحات التي يكتشفها المضيف نفسها، ويُعلن الروابط المتبادلة نفسها، ويستوفي العناصر الفرعية لحرفة الشيفرة نفسها، ويُشحَن في الصيغة الجاهزة للإنتاج نفسها. وتنتقل نقطة الرافعة لدى المُشغِّل من ضبط المُوجِّهات إلى تصديق المُنتَجات.
لتقييم الادّعاء مباشرةً، اقرأ المدوّنة. استنسخ المستودع، وانتقل إلى src/apothem/rules/، واقرأ ملفات القواعد بأي ترتيب — فكل قاعدة مكتفية بذاتها، وكل ربط متبادل، وكل إحالة متقاطعة تُحَلّ إلى مسار قاعدة محدّد مع مرساة القسم. وتصف القواعد مجتمعةً مساعدًا يكتب الشيفرة بالطريقة التي سيكتبها بها مساهم أقدم في مشروعك؛ والملف الثنائي هو السطح الذي يوصلها.
المدوّنة هي ما يبقى بعد أن يتغيّر الملف الثنائي.
gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.mdالقراءة هي التقييم.