المفاهيم

مرجع سريع للمصطلحات التي ستصادفها في جميع أنحاء وثائق Apothem.

الملف التعريفي المشترك

ملف YAML مُتحقَّق منه عبر مخطط في ~/.config/apothem/profile.yaml (يُتجاوَز بـ --profile PATH). هو المصدر الوحيد للحقيقة لهويتك وتفضيلاتك وتهيئتك؛ ويقرأه كل محوّل إطار عمل عند التثبيت، ويشتقّ منه التهيئة الأصلية لذلك الإطار.

محوّل إطار العمل

محوّل خاص بكل منصّة يترجم الملف التعريفي المشترك إلى صيغة الإعداد الأصلية الخاصة بإطار عمل محدّد. أزمنة التشغيل المدعومة مُدرَجة في:

Claude Code, Cursor, Gemini CLI, etc.

يعني تثبيت Apothem دائمًا: تثبيت الملف التعريفي المشترك، ثم تجسيد محوّل واحد أو أكثر.

القاعدة السلوكية

ملف Markdown ضمن src/apothem/rules/ يُحمَّل في كل تفاعل (دائم التفعيل) أو فقط عند تحرير الملفات الموجودة ضمن مسار محدّد (مُرشَّح بالمسار). تُقنّن القواعد كيف ينبغي لإطار العمل أن يتصرّف.

الخطّاف

نص Python مُسجَّل في settings.json يُطلَق عند أحداث دورة حياة إطار العمل (PreToolUse, PostToolUse, SessionStart, PreCompact, Stop, PostCompact). تفرض الخطّافات متطلّبات المطابقة في الزمن الحقيقي قبل وصول المُخرَج إلى القرص. نموذج أحداث الخطّاف هو سطح خاص بـ Claude Code اليوم؛ ومحوّلات أُطُر العمل التي لا تملك آلية خطّاف تكتفي بحذفه.

بوابة المطابقة

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

حزمة الخطّة

دليل مُهيكَل في <project-root>/.apothem/plans/<suite-name>/ يحتوي على مواصفة، وخطّة رئيسية، وملفات PHASE.md لكل مرحلة، ومُنتَجات مُخرَجة. تدير سلسلة /plan حِزَم الخطط.

المهارة

تقنية قابلة لإعادة الاستخدام وقابلة للاستدعاء عبر أمر مائل، مُجمَّعة بوصفها ملف SKILL.md ضمن src/apothem/skills/<name>/. توسّع المهارات سطح الأوامر المائلة لما هو أبعد من سلسلة /plan المدمجة.

العامل المُفوَّض

مساعد دائم محدّد النطاق والغرض، معرَّف في المسار المعياري:

src/apothem/agents/<name>.md

يتولّى العاملون المُفوَّضون البحث، والتدقيق، وفحص الجودة، وإدارة الذاكرة.