اصطلاحات النثر

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

---

1. تسلسل الصِّيَغ الإلزامية (RFC 2119)

يستخدم النثر التوجيهي تسلسل الصِّيَغ الإلزامية وفق RFC 2119: MUST، وMUST NOT، وSHOULD، وSHOULD NOT، وMAY. يحمل كلٌّ منها قوة الإلزام التي يُعرِّفها الـRFC. لا تحمل الصِّيَغ بالأحرف الصغيرة (must، وshould) أي وزن معياري، وتُستخدَم فقط في النثر السردي حيث لا يُعلَن أي التزام.

2. المفردات المحظورة

2.1 الصفات التسويقية

المصطلحات powerful، وseamless، وrobust، وcutting-edge، وnext-generation، وworld-class، وenterprise-grade وما يكافئها محظورة في المُنتَجات المُوجَّهة للمستخدم ما لم تُسنَد بشكل ملموس بأدلّة مُقاسة. يستشهد الإسناد بمعيار قياس، أو مقارنة، أو قياس، أو مصدر تحقُّق خارجي.

2.2 الحشو المُتهرِّب

المصطلحات basically، وkind of، وsort of، وin some sense، وto some extent وما يكافئها محظورة في النص التوجيهي. النثر التوجيهي مُلزِم؛ والحشو المُتهرِّب يتنازل عن قوة الإلزام التي يدّعيها النثر.

2.3 إحكام UDA

يَفرض فحص إحكام التوجيهات العام (UDA) عند scripts/dev/validate_ecosystem.py مُعجمًا مُغلَقًا من ألفاظ التهرُّب (maybe، وmight، وcould، وshould probably، وusually، وgenerally speaking، وin most cases، وmostly، وtypically، وoften، وor similar، وetc.، وand so on) على الأسطر التي تحمل وصفًا مُلزِمًا. أمّا رموز التهرُّب المُستشهَد بها بوصفها موضوع القاعدة نفسها (مثلًا، قائمة بالكلمات المحظورة في صفحة قائمة محظورات) فمُعفاة بآلية العلامة التعريفية للمُتحقِّق.

3. الإشارات إلى التواريخ

التواريخ مطلقة بصيغة ISO-8601 (YYYY-MM-DD) في كل إشارة. التواريخ النسبية (yesterday، وlast week، وrecently) محظورة في المُنتَجات التي تستمرّ بعد جلسة كتابتها.

4. المُتحقِّقات

فحص إحكام UDA في scripts/dev/validate_ecosystem.py هو سطح الإنفاذ الآلي للقسم §2.3. تَفرض عائلة مُتحقِّقات conformity-grep من نوع markdown العاملة عند كل كتابة معيارَ جودة النثر الأوسع عند حدود خطّافات PreToolUse Write/Edit.