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

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

١. الأوامرCopy Anchor Link

خمسة وأربعون أمرًا مُسجَّلة من src/apothem/commands/*.md (غير تعاودي) — والمرجع الكامل الدائم الحداثة لكل أمر هو مرجع الأوامر المُولَّد، وفيه يُعدَّد بالكامل خطّ أنابيب /research ذو المراحل الثلاث عشرة (من /research-ideate إلى /research-disseminate) إضافة إلى مُنسِّقَي سير-العمل المُغلَّف /audit و/fortress. كل أمر هو ملف مُسجَّل من الدرجة الأولى؛ مُنسِّق /plan يسلسل فقط مراحل الخطّة التي هي بالفعل من الدرجة الأولى ولا يحمل أي منطق مرحلة خاص به، فلا يزال لا يوجد مُوزِّع متجانس ولا تجميع أوامر فرعية.

خمسة وثلاثون أمرًا قابلة للاستدعاء من النموذج (disable-model-invocation: false): يجوز للنموذج تشغيل أحدها عندما يطابق طلبٌ وصفه. وعشرة لا يستدعيها إلا المُشغِّل: /freshify، و/github-deploy-fresh، و/github-deploy-next، و/release-readiness، و/elevate، و/fortress، و/workflow، و/plan-execute، و/research-experiment، و/research-publish. والراية الخاصة بكل أمر مُسجَّلة في src/apothem/commands/README.md.

أوامر التدقيق والرفع غير الخاصّة بالخطّة وغير الخاصّة بالبحث:

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

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

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

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

٢. القواعدCopy Anchor Link

تعيش قواعد السلوك تحت 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 من الملف نفسه.

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

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

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Citation Auditor    src/apothem/agents/citation-auditor.md    Audit           host-selected
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
Design Critic       src/apothem/agents/design-critic.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

٤. الخطّافاتCopy Anchor Link

تستخدم إدخالات خطّافات Claude Code المُثبَّتة صيغة exec: إذ إن command هو ${PYTHON_BIN}، وargs يحمل مسار نص برمجي تحت ${HARNESS_ROOT}/.apothem/support/ (مثل hooks/dispatch.py وconformity/gate.py). والصيغة -m apothem.hooks.dispatch مخصّصة للتطوير من نسخة مسحوبة من المصدر مع PYTHONPATH=src. ويستورد الموزّع 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، وposttooluse-proactive-compaction.md، وpretooluse-askuserquestion-recommended.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، وskill-index.md، وstop.md. ويُحمَّل كل ملف سياق مُوجَّه بواسطة الموزّع عند إطلاق حدثه وتسجيل وسيط سياقه في settings.json. ويُشحَن pretooluse-conformity.md صنفًا متاحًا دون مدخل توجيه حالي في settings.json. ويُولَّد skill-index.md من فهرس المهارات والأوامر ويقرؤه تمهيد بدء الجلسة، ولا يُوجَّه عبر settings.json. وpretooluse-dependency-guard.md موجَّه على مطابِقَي Write وEdit، وpretooluse-eval-guard.md على مطابِقات Write وEdit وBash|PowerShell.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24                    30s      Verify state externalized before compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
PostCompact       CM-24                    30s      Restore working state after compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
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       Proactive compaction     10s      Proactive-compaction advisory on every tool call; the Claude Code settings.json template routes it on the all-tools matcher
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 كلها تُشتَقّ من هذا العمود. تنقيحات المهلة المستقبلية تهبط هنا والمستهلِكون يُعيدون الاشتقاق عند المرجع التالي.

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

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

٥. المهاراتCopy Anchor Link

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

المهارة التي تحمل disable-model-invocation: true لا تعمل إلا عندما يستدعيها المُشغِّل باسمها. عشرون مهارة قابلة للاستدعاء من النموذج. وأربع يدوية لأنها تُغيِّر الحالة خارج شجرة العمل أو تعتمد على اختيار المُشغِّل للحظة: Dependency Upgrade، وSecret Rotation، وWorkflow، وIssue Lifecycle. ومهارتا الحزمتين قالبان مرجعيان فقط يُقرآن بالمسار. ويسرد فهرس المهارات عند بدء الجلسة الأسماء القابلة للاستدعاء من النموذج والأسماء اليدوية بحسب المجال.

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

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

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

٧. تطوّر الأدواتCopy Anchor Link

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

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

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

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