سجلّات الأدوات (Artifact Registries)

مرافق كنسي لِـ CLAUDE.md §11. يحمل هذا المستند التعدادات الكاملة للأوامر والقواعد والعاملين المساعِدين المُفوَّضين والخطّافات والمهارات وأنماط الإخراج وانضباط تطوّر-الأدوات وإعلانات صنف-الأداة-الفارغ. يحتفظ CLAUDE.md بسطر المرساة + المؤشّر؛ والجداول الموضوعية تعيش هنا. يوفّر فهرس القدرات في CLAUDE.md §3 العرض المُكثَّف الدائم (always-on) بالفعل.

١. الأوامر

ثلاثون أمرًا مُسجَّلة من src/apothem/commands/*.md (غير تعاودي). كل أمر هو ملف مُسجَّل من الدرجة الأولى؛ مُنسِّق /plan يسلسل فقط مراحل الخطّة التي هي بالفعل من الدرجة الأولى ولا يحمل أي منطق مرحلة خاص به، فلا يزال لا يوجد مُوزِّع متجانس ولا تجميع أوامر فرعية. الأوامر غير الخاصّة بالخطّة وغير الخاصّة بسير-العمل:

أوامر خطّ-أنابيب-الخطّة

يُشحَن خطّ أنابيب الخطّة كثمانية أوامر من الدرجة الأولى — واحد لكل مرحلة، كل منها قابل للاستدعاء مباشرة بصيغة /plan-<stage> من ملفه المُسجَّل في src/apothem/commands/plan-<stage>.md.

أوامر سير-عمل-المُشغِّل & المُنسِّق

ثلاثة أوامر تدخل إجراءً عميقًا بدلًا من حمل منطق مرحلة خاص بها: نقطتا دخول لسير-عمل-المُشغِّل (كل منهما مدعومة بمهارة شقيقة بنفس الاسم) إضافة إلى مُنسِّق خطّ-أنابيب-الخطّة الرفيع.

٢. القواعد

تعيش قواعد السلوك تحت src/apothem/rules/ — نواة صغيرة دائمة (always-on) إضافة إلى مجموعة أكبر مُرشَّحة-المسار (مُحمَّلة-عند-الطلب عند لمس الأدوات المطابقة). التعداد الكامل لكل-قاعدة — مع عمودَي Scope (دائم / مُرشَّح-المسار) وImplements — هو reference/rules.mdx المولَّد-من-المصدر، المُنعَش من src/apothem/rules/*.md بواسطة مولّد reference-inventory؛ راجِعه للحصول على القائمة الحالية الموثوقة.

تحديد جانب CM-21 (ثلاث قواعد تُنفِّذ CM-21 معًا بجوانب مميّزة غير متداخلة): الفلاتر الإبداعية والهوية المعرفية → cognitive-identity.md؛ منهجية التوليد (بروتوكولات الكتابة وإعادة-الكتابة) → clean-room-generation.md؛ تقنيات التخطيط/المراجعة → planning-techniques.md. كل قاعدة تملك جانبها؛ والأخريات تُحيل إلى الخارج.

مؤشّر مخطّط interactive-questions. مخطّط استدعاء الاستفسار-المُهيكل الكنسي — الحقول المطلوبة، جدول ملخّص-الحقول، مثالان عمليّان قابلان للتنفيذ (single-select في §2.1 وmulti-select في §2.2) — يعيش في src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape". قد تنسخ الأدوات النهائية §2.1 أو §2.2 كقوالب استدعاء؛ ومخطّط تعليق-الخيار ثلاثي-الأجزاء الذي يحمله جسم description لكل خيار مُحدَّد في §3 من الملف نفسه.

٣. العاملون المساعِدون المُفوَّضون

اثنا عشر تعريفًا لعامل دائم يُشحَنون مع المنظومة؛ وأنماط الفريق في قاعدة التنسيق توزّع عليهم. كل تعريف يعيش في مسار الملف المُدرَج أدناه.

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        host-selected
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           host-selected
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           host-selected
Fact Checker        src/apothem/agents/fact-checker.md        Audit           host-selected
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      host-selected
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           host-selected
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         host-selected
Quality Gate        src/apothem/agents/quality-gate.md        Quality         host-selected
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  host-selected
Research Scout      src/apothem/agents/research-scout.md      Research        host-selected
Security Scanner    src/apothem/agents/security-scanner.md    Audit           host-selected
Test Runner         src/apothem/agents/test-runner.md         Quality         host-selected

٤. الخطّافات

كل أمر خطّاف مُسجَّل يستخدم شكل أمر صيغة-التنفيذ (exec-form) في Claude Code (command: "python" إضافة إلى مصفوفة args) ويستدعي إمّا -m apothem.hooks.dispatch أو -m apothem.conformity.gate. يستورد المُوزِّع src/apothem/hooks/lib/resolve_root.py لحلّ جذر-المنظومة و يفوّض إلى مساعِدَين يقعان بجواره تحت src/apothem/hooks/ نفسه: src/apothem/hooks/emit_hook_context.py ينسّق حمولات الأحداث للمساعِد، و src/apothem/hooks/session_start_bootstrap.py يحمل عمل تحضير SessionStart الذي يسلّمه المُوزِّع عند توجيهه لذلك الحدث. رسائل الخطّاف المعروضة على المساعِد عند إطلاق الأحداث المدعومة تعيش كملفات سياق Markdown تحت src/apothem/hooks/messages/ — واحد لكل صنف حدث: postcompact.md، precompact.md، pretooluse-bash.md، pretooluse-bash-plan-guard.md، pretooluse-conformity.md، pretooluse-dependency-guard.md، pretooluse-edit.md، pretooluse-edit-header-guard.md، pretooluse-eval-guard.md، pretooluse-notebookedit.md، pretooluse-write.md، pretooluse-write-header-guard.md، pretooluse-write-plan-guard.md، sessionstart.md، stop.md. كل ملف سياق مُوجَّه يُحمَّل بواسطة المُوزِّع عند إطلاق حدثه وتسجيل وسيط سياقه في settings.json؛ ثلاثة ملفات سياق (pretooluse-conformity.md، pretooluse-dependency-guard.md، pretooluse-eval-guard.md) تُشحَن كأصناف متاحة دون مدخل توجيه حالي في settings.json.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24 §2.3               30s      Verify state externalized before compaction
PostCompact       CM-24 §6.2               30s      Restore working state after compaction
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

عُرف. الصفوف التي تكون فيها Automates هي — مقبولة من dispatch.py لكنها غير مربوطة في settings.json؛ يُظهِر عمود Timeout الافتراضي على مستوى-التوزيع الذي ينطبق إذا رُبِط الحدث وعندما يُربَط لاحقًا.

الكتلة الكنسية لقيمة-المهلة. عمود Timeout في هذا الجدول هو المصدر الوحيد للحقيقة لقيم مهلة الخطّاف عبر المنظومة. حقول timeout لكل-خطّاف في settings.json، والجداول المرآة في site/content/docs/reference/settings-reference.mdx § Hook Events وsite/content/docs/reference/artifact-schema.mdx § Hooks Pipeline، وإرشاد القاعدة في src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness كلها تُشتَقّ من هذا العمود. تنقيحات المهلة المستقبلية تهبط هنا والمستهلِكون يُعيدون الاشتقاق عند المرجع التالي.

كادنس مراجعة قالب الإعدادات

settings.json هو قالب Claude Code الوحيد. كل أمر خطّاف يستخدم صيغة التنفيذ بدلًا من غلاف خاص-بالصدفة، فتُراجَع سلوكيات عبر-الأنظمة داخل ملف واحد بدلًا من مقارنة قوالب مُزدوَجة. مداخل الأذونات الجديدة، أحداث الخطّاف، المهل، ورسائل الحالة تهبط في ذلك الملف ذرّيًّا.

٥. المهارات

تعيش المهارات القابلة لإعادة-الاستخدام تحت src/apothem/skills/، مجلد واحد لكل مهارة.

عُرف. المسار في كل صف هو مجلد؛ ونقطة الدخول هي ملف SKILL.md بداخله — مثلًا src/apothem/skills/plan-suite/SKILL.md — وفق عُرف مهارة مجلد-مع-SKILL.md المُعلَن في CLAUDE.md §15 Artifact Directories.

٦. أنماط الإخراج

أربعة أنماط إخراج تعيش تحت src/apothem/output-styles/.

٧. تطوّر الأدوات

إلزامي. عندما يتكرّر نمط أو تصحيح أو تقنية قابلة لإعادة-الاستخدام (نسختان أو أكثر في جلسة، أو مُدوَّن في الذاكرة كمتكرّر)، يجب أن تتطوّر المنظومة. الدورة لها أربع خطوات: Detect النمط أثناء أي تفاعل؛ Search المهارات والقواعد والأوامر والخطّافات والذاكرة القائمة عن تداخل؛ Act بتطوير الأداة المطابقة في-مكانها (تحديث الإجراء، الأنماط-المضادّة، النطاق) أو إنشاء أداة جديدة عندما يكون الاهتمام متعامدًا حقًّا؛ Validate أن المراجع-المتقاطعة لا تزال تُحَلّ وأن الأدوات التابعة تبقى متّسقة. فضِّل التحسين على الإنشاء — الأدوات الجديدة تُضاعِف سطح الصيانة. انظر src/apothem/rules/persistent-conventions-vigilance.md §2+§4 للبروتوكول الكامل بما في ذلك الكتالوج المغلق لمحفّزات اكتشاف-الثغرات عبر كل صنف أداة.

٨. أصناف الأدوات الفارغة

أسطح مُعلَنة في سجلّ المنظومة لكنها فارغة عمدًا حتى يُطلَق محفّز تفعيل. كل صف يسجّل السطح المحجوز، والملف أو الدليل الذي يُؤسِّس الصنف، والمحفّز الذي يرقّي الصف من فارغ-بإقرار إلى مأهول.

فارغ-بإقرار هو إعلان إيجابي، لا ثغرة. أساس الصنف (عند وجوده) هو الأداة الكنسية بدون-عملية التي تتعقّب لحظة التفعيل. الترقيات من فارغ-بإقرار إلى مأهول تهبط في قسم السجلّ ذي الصلة ذرّيًّا مع أوّل قيمة غير-فارغة للأساس.