اصطلاحات التسمية

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

---

1. أسماء نظام الملفات

تستخدم الملفات والمجلّدات صيغة kebab-case افتراضيًّا. لا تحمل المُعرِّفات مسافات ولا شرطات سفلية ولا صيغة camelCase.

تُحجَز استثناءات الأحرف الكبيرة القانونية لملفات سطح النشر الفردية التي يتعرّف عليها كل مساهم من أول لقاء: CLAUDE.md، وREADME.md، وLICENSE، وCHANGELOG.md، وSECURITY.md، وCODE_OF_CONDUCT.md، وCONTRIBUTING.md، وملفات مجموعة الخطّة الفردية (MASTER-PLAN.md، وPROGRESS.md، وPHASE.md، وSKILL.md، وVERSION). وكل ملف آخر يستخدم kebab-case.

2. مفاتيح frontmatter

تستخدم مفاتيح YAML frontmatter صيغة kebab-case (مثل argument-hint، وdisable-model-invocation). تنطبق قاعدة kebab-case بشكل موحّد عبر القواعد والأوامر والعمّال المُفوَّضين والمهارات وCLAUDE.md نفسه.

3. أسماء الفروع

تتبع الفروع الصيغة <type>/<short-description> مع نوع مأخوذ من المجموعة المغلقة {feat, fix, chore, docs, refactor, test, perf, ci, build, style, revert, release}. والوصف بصيغة kebab-case وأقلّ من خمسين حرفًا.

4. البادئات الرقمية

تنقل البادئات الرقمية (NN-) على مسارات نظام الملفات الترتيب، وتنطبق فقط حيث يكون الترتيب جوهريًّا — مجلّدات المراحل، ومجلّدات المراحل الفرعية، وبرامج الترحيل النصّية، وأي فئة مُخرَجات أخرى يكون تسلسلها جزءًا من العقد. أمّا الملفات الفردية على مستوى الجذر التي لا تملك تسلسلًا شقيقًا فلا تحمل بادئةً رقمية؛ وإضافة واحدة تشير خطأً إلى علاقة ترتيب غير موجودة. ويوجد الانضباط الكامل في src/apothem/rules/canonical-layout.md §2.1.

5. أدوات التحقّق

إنّ naming-grep في src/apothem/conformity/naming_grep.py هو سطح الإنفاذ الميكانيكي. ويستدعيه التكامل المستمرّ عبر make validate.