قائمة تحقّق النشر

خطوات التحقّق المسبق قبل نشر منظومة Apothem على جهاز جديد، أو مشاركتها مع الآخرين، أو التعامل معها على أنّها جاهزة للإنتاج.

1. صحّة YAML

• جميع ملفّات القواعد تُحلَّل دون أخطاء YAML — كتلة الـ frontmatter تفتح بـ --- وتُغلق بـ --- ولا تحتوي على محتوى يتيم خارج الكتلة
• جميع ملفّات العاملين المُفوَّضين تُحلَّل دون أخطاء YAML
• جميع ملفّات الأوامر تُحلَّل دون أخطاء YAML
• جميع ملفّات المهارات SKILL.md تُحلَّل دون أخطاء YAML

التحقّق: يحلّ python scripts/dev/validate_ecosystem.py الـ frontmatter لكل مُنتَج ويشير إلى أخطاء YAML والحقول المطلوبة المفقودة. للكشف الموضعي عن عناصر القائمة اليتيمة: rg -n "^- " src/apothem/rules/*.md.

2. اكتمال الـ frontmatter

لكل نوع مُنتَج، تحقّق من وجود الحقول المطلوبة:

القواعد (src/apothem/rules/*.md)

• name — مُعرّف بنمط kebab-case مطابق لاسم الملفّ
• version — semver MAJOR.MINOR.PATCH (مثال: "X.Y.Z")
• updated — تاريخ ISO 8601 (مثال: "2026-04-20")
• description — ملخّص من جملة واحدة
• scope — "always-on" أو "path-filtered"
• portability — "universal" أو "universal-with-windows-caveats" أو "unix-only" أو "windows-only"
• pathFilter — حاضر وعبارة عن سلسلة glob صالحة للقواعد المُرشَّحة بالمسار؛ وغائب للقواعد الدائمة التشغيل

الأوامر (src/apothem/commands/*.md)

• name — اسم أمر بنمط kebab-case
• version وupdated وdescription وargument-hint حاضرة
• disable-model-invocation حاضر ومقصود (true للأوامر الإرشادية فقط)
• مراجعة effort وportability حيثما وُجدا (اختياريان وفق الـ schema)

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

المسار:

src/apothem/agents/*.md

• name وversion وupdated وdescription حاضرة
• tools — قائمة بالأدوات المسموح بها مفصولة بفواصل
• disallowedTools — يدرج صراحةً الأدوات غير المسموح بها
• maxTurns — مضبوط (مع تعليق مبرِّر إذا كان > 10)
• permissionMode — يجب ألّا يكون "bypassPermissions" — استخدم "default"
• memory: false ما لم تكن الذاكرة الدائمة مقصودة

المهارات (src/apothem/skills/*/SKILL.md)

• name وversion وupdated وdescription حاضرة
• user-invocable — مُعلَن (true/false)

3. الأمان

• لا يستخدم أيّ عامل مُفوَّض permissionMode: "bypassPermissions" — فهذا يتجاوز التأكيد التفاعلي لعمليات Write/Bash
• قوائم tools للعامل في حدّها الأدنى — فقط الأدوات التي يحتاجها العامل فعلًا
• العاملون الذين لديهم وصول إلى Bash مبرَّرون ولديهم حدود maxTurns
• لا توجد مسارات أو رموز أو أسرار مكتوبة بشكل ثابت في أيّ مُنتَج
• للخطّافات في settings.json مهلات معقولة (≤ 60 ثانية) ولا تنفّذ شيفرة عشوائية من مدخلات المستخدم

4. سلامة الإحالات المتبادلة

• كل قاعدة مدرجة في جدول src/apothem/rules/ موجودة على القرص في المسار المذكور
• كل أمر مدرج في جدول src/apothem/commands/ موجود على القرص
• كل عامل مُفوَّض مدرج في جدول السجلّ src/apothem/agents/ موجود على القرص
• كل مهارة مدرجة في جدول src/apothem/skills/ موجودة على القرص
• كل خطّاف في جدول src/apothem/hooks/ له مدخل مقابل في settings.json
• جميع ملفّات src/apothem/rules/*.md المُشار إليها بعمود Implements في CLAUDE.md موجودة

5. تغطية التكليفات

• لكل CM-N مُشار إليه في CLAUDE.md موقع تطبيق (إمّا ملفّ قاعدة أو تعريف مضمّن صريح)
• لا يتعارض أيّ ملفّ قاعدة مع آخر (خاصةً فيما يتعلّق بتدرّج الجدّية)
• يُحترَم تقسيم الأوجه الثلاثة لـ CM-21 — لا تدّعي أيّ قاعدة ملكية وجه CM-21 لقاعدة أخرى

6. اختبارات الدخان الوظيفية

شغّل سطح التحقّق بلغة Python أولًا — فهو سريع وغير متّصل ويلتقط الانحدارات البنيوية:

• pytest tests — اختبارات الوحدة لزمن تشغيل الخطّافات، جميعها خضراء
• python scripts/dev/validate_hooks.py — بنية الخطّافات + فحص النظافة الخاص بـ Python فقط ناجح
• python scripts/dev/validate_ecosystem.py — الشجرة الكاملة + الـ frontmatter + فحوص الخطّافات المُفوَّضة ناجحة
• python scripts/dev/chaos_pass.py — كل أمر خطّاف مُكوَّن يُعيد مغلَّف JSON صالحًا في ظل مدخلات متدهورة

ثم السيناريوهات الحيّة:

• /plan-spec --interactive (أو /plan-spec <sample-file>) — يُكمل الاستيعاب/التوضيح دون أخطاء على مستوى الأمر
• /plan-generate --dry-run — يُنتج معاينة للبنية دون كتابة ملفّات
• /plan-status على حزمة خطّة مكتملة — يُعيد أعداد مراحل دقيقة
• إرسال العامل المُفوَّض: العامل codebase-explorer المُستدعى بنطاق صغير يكتمل ضمن maxTurns ويُعيد مخرجات منظَّمة

7. حداثة التوثيق

• يعكس CHANGELOG.md (في جذر المنظومة) كل تغيير في المُنتَجات منذ الإصدار الأخير؛ قسم الإصدار التالي مُعبّأ قبل وصول الوسم، أو أنّ كل تغيير مُدرَج بالفعل في قسم مُصدَر
• يصف site/content/docs/developer-guide.mdx بدقّة بنية المُنتَجات الحالية
• يطابق site/content/docs/reference/artifact-schema.mdx حقول الـ frontmatter الموجودة فعلًا في المُنتَجات
• يطابق site/content/docs/reference/settings-reference.mdx تكوين الخطّافات الفعلي في settings.json
• README.md متّسق مع الشجرة على القرص

8. قابلية النقل (في حال المشاركة مع الآخرين)

• جميع المسارات في أوامر الخطّافات غير معتمِدة على البيئة أو تستخدم توسعة ~
• أوامر الخطّافات تستخدم نمط exec وتتجنّب سلاسل الأوامر الخاصّة بصدفة معيّنة
• لا توجد مسارات C:\Users\username أو /home/username مكتوبة بشكل ثابت في أيّ مُنتَج
• يستخدم settings.json جدول تغطية واحد لأحداث الخطّافات والمسار المعياري لوحدة الإرسال

9. مواءمة الإصدارات

• version في CLAUDE.md هي الأعلى بين أيّ مُنتَج في الشجرة (أو مساوية لإصدار أحدث مُنتَج تمّت زيادته، بحسب العُرف)
• version كل مُنتَج تطابق الـ semver المذكور (MAJOR.MINOR.PATCH)
• يحتوي CHANGELOG.md تحديدًا على مدخل الإصدار للإصدار المستهدف قبل الوسم
• حقل updated لكل مُنتَج عند تاريخ آخر تعديل مُغيِّر للسلوك أو بعده
• لا يحمل أيّ مُنتَج version أقلّ من الإصدار الذي عُدِّل عنده آخر مرّة (دون انحدارات)
• src/apothem/skills/plan-suite/SKILL.md وsrc/apothem/skills/plan-suite/master-template.md مثبَّتان على خطّ إصدار القالب نفسه

التصديق

اعتمد النشر: ___________________ التاريخ: ___________________ إصدار المنظومة المنشور: ___________________