المفاهيم
مسرد يعرّف الملفات التعريفية المشتركة، ومحوّلات أُطُر العمل، والقواعد، والخطّافات، وبوابات المطابقة، والمهارات، والعمّال المُفوَّضين في Apothem.
مرجع سريع للمصطلحات التي ستصادفها في وثائق Apothem كلها.
الملف التعريفي المشترك
ملف YAML مُتحقَّق منه عبر مخطط في ~/.config/apothem/profile.yaml (يُتجاوَز بالخيار --profile PATH).
هو المصدر الوحيد للحقيقة لهويتك وتفضيلاتك وتهيئتك؛ ويقرؤه كل محوّل إطار عمل عند التثبيت،
ويشتقّ منه الإعداد الأصلي لذلك الإطار.
محوّل إطار العمل
محوّل خاص بكل منصّة يترجم الملف التعريفي المشترك إلى صيغة الإعداد الأصلية الخاصة بإطار عمل محدّد. أزمنة التشغيل المدعومة مُدرَجة في:
Claude Code, Cursor, Gemini CLI, etc.يعني تثبيت Apothem دائمًا: تثبيت الملف التعريفي المشترك، ثم تجسيد محوّل واحد أو أكثر.
القاعدة السلوكية
ملف Markdown ضمن src/apothem/rules/ يُحمَّل في كل تفاعل (دائم التفعيل) أو
فقط عند تحرير الملفات الموجودة ضمن مسار محدّد (مُرشَّح بالمسار). تُقنِّن القواعد كيف ينبغي
لإطار العمل أن يتصرّف. أربع قواعد دائمة التفعيل: agnostic-posture وauthority-inquiry
وsession-closure وcontext-management. ويُحمَّل فهرس القواعد، apothem-rule-index، معها
ويُسمّي كل قاعدة أخرى ومتى تُقرأ. وإطار العمل الذي لا يقيّد نطاق القواعد بالمسار
لا يُحمِّل أيًّا من القواعد الأخرى، لذا فالفهرس هو الطريقة التي تجدها بها الجلسة.
الخطّاف
سكربت Python مُسجَّل في إعداد الخطّافات الخاص بإطار العمل (settings.json في Claude Code)، ويُطلَق عند أحداث دورة الحياة مثل PreToolUse وPostToolUse وSessionStart وStop؛ وتسجّل بعض المحوّلات أيضًا PreCompact وPostCompact. وتفرض الخطّافات متطلّبات المطابقة في الزمن الحقيقي قبل أن يصل المُخرَج إلى القرص. أما المحوّلات الخاصة بأُطُر العمل التي لا تملك آلية خطّافات فتُغفِله.
بوابة المطابقة
الجزء الميكانيكي من بوابة ما قبل الإصدار ذات الخمسة عشر شريطًا (M1-M15) — أدوات التحقّق
القابلة للفحص الآلي التي تعمل قبل إصدار أي مُنتَج؛ استشارية افتراضيًا، وحاجبة
مع --strict. بوابة ما قبل الإصدار هي الحدّ الأدنى للجودة؛
وتُشغّل بوابة المطابقة أشرطتها القابلة للفحص الآلي، وتفرض الخطّافات أشرطة فردية في الزمن الحقيقي.
حزمة الخطّة
دليل مُهيكَل في <project-root>/.apothem/plans/<suite-name>/ يحتوي على مواصفة، وخطّة رئيسية، وملفات PHASE.md لكل مرحلة، ومُنتَجات الإخراج. يدير خط /plan حِزَم الخطط.
المهارة
تقنية قابلة لإعادة الاستخدام وقابلة للاستدعاء بأمر الشرطة المائلة، مُجمَّعة في ملف SKILL.md ضمن src/apothem/skills/<name>/. توسّع المهارات سطح أوامر الشرطة المائلة إلى ما يتجاوز خط /plan المدمج.
العامل المُفوَّض
مساعد دائم محدّد النطاق بغرضه، معرَّف في المسار المعياري:
src/apothem/agents/<name>.mdيتولّى العمّال المُفوَّضون البحث، والتدقيق، وفحص الجودة، وإدارة الذاكرة.