आर्टिफ़ैक्ट रजिस्ट्रियाँ

आर्टिफ़ैक्ट समूह की विहित रजिस्ट्री। यह दस्तावेज़ कमांड, नियम, प्रत्यायोजित सहायक, हुक, स्किल, आउटपुट-स्टाइल, आर्टिफ़ैक्ट-विकास अनुशासन, और रिक्त-आर्टिफ़ैक्ट-वर्ग घोषणाओं के पूर्ण परिगणन को धारण करता है; सारगर्भित तालिकाएँ यहाँ रहती हैं। प्रोजेक्ट स्रोत लेआउट संक्षिप्त always-on दृश्य प्रदान करता है।

1. कमांड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

प्लान पाइपलाइन आठ प्रथम-श्रेणी कमांड के रूप में शिप होती है — एक प्रति स्टेज, प्रत्येक को src/apothem/commands/plan-<stage>.md पर अपनी पंजीकृत फ़ाइल से सीधे /plan-<stage> के रूप में आह्वान योग्य।

ऑपरेटर-वर्कफ़्लो & ऑर्केस्ट्रेटर कमांडCopy Anchor Link

तीन कमांड अपना स्टेज लॉजिक धारण करने के बजाय एक गहन प्रक्रिया में प्रवेश करते हैं: दो ऑपरेटर-वर्कफ़्लो एंट्री पॉइंट (प्रत्येक उसी नाम की एक सहोदर स्किल द्वारा समर्थित) तथा पतला प्लान-पाइपलाइन ऑर्केस्ट्रेटर।

2. नियमCopy Anchor Link

व्यवहार नियम src/apothem/rules/ के अंतर्गत रहते हैं — एक छोटा always-on कोर तथा एक बड़ा पथ-फ़िल्टर्ड सेट (मेल खाते आर्टिफ़ैक्ट स्पर्श पर माँग-पर-लोड)। पूर्ण प्रति-नियम परिगणन — Scope (always-on / पथ-फ़िल्टर्ड) और Implements स्तंभों के साथ — स्रोत-जनित reference/rules.mdx है, जो reference-inventory जनरेटर द्वारा src/apothem/rules/*.md से ताज़ा होता है; आधिकारिक वर्तमान सूची के लिए इसे देखें।

CM-21 पहलू सीमांकन (तीन नियम CM-21 को विशिष्ट गैर-अतिव्यापी पहलुओं के साथ सह-कार्यान्वित करते हैं): रचनात्मक फ़िल्टर & संज्ञानात्मक पहचान → cognitive-identity.md; जनन कार्यप्रणाली (लेखन & पुनर्लेखन प्रोटोकॉल) → clean-room-generation.md; योजना/समीक्षा तकनीकें → planning-techniques.md। प्रत्येक नियम अपना पहलू रखता है; अन्य बाहर संदर्भित करते हैं।

Interactive-questions स्कीमा पॉइंटर। विहित संरचित-पूछताछ आह्वान स्कीमा — आवश्यक फ़ील्ड, फ़ील्ड-सारांश तालिका, दो निष्पादन योग्य कार्यशील उदाहरण (§2.1 पर single-select और §2.2 पर multi-select) — src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape" में रहती है। डाउनस्ट्रीम आर्टिफ़ैक्ट्स §2.1 या §2.2 को आह्वान टेम्पलेट के रूप में कॉपी कर सकते हैं; प्रत्येक विकल्प का description बॉडी जो तीन-खंड विकल्प-एनोटेशन स्कीमा धारण करती है वह उसी फ़ाइल के §3 में निर्दिष्ट है।

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

4. हुक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 की तैयारी का वह कार्य करता है जिसे डिस्पैचर उस इवेंट को रूट करते समय सौंपता है। समर्थित इवेंट फ़ायर होने पर असिस्टेंट को दिए जाने वाले हुक संदेश src/apothem/hooks/messages/ के अंतर्गत Markdown संदर्भ फ़ाइलों के रूप में रहते हैं — हर इवेंट वैरिएंट के लिए एक: 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 स्तंभ पूरे ईकोसिस्टम में हुक timeout मानों के लिए सत्य का एकमात्र स्रोत है। settings.json प्रति-हुक timeout फ़ील्ड, 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 में नियम मार्गदर्शन सभी इस स्तंभ से व्युत्पन्न होते हैं। भावी timeout संशोधन यहाँ उतरते हैं और उपभोक्ता अगले संदर्भ पर पुनः-व्युत्पन्न करते हैं।

सेटिंग्स टेम्पलेट समीक्षा कैडेंसCopy Anchor Link

settings.json एकमात्र Claude Code टेम्पलेट है। प्रत्येक हुक कमांड shell-विशिष्ट रैपर के बजाय exec form का उपयोग करता है, इसलिए क्रॉस-OS व्यवहार की समीक्षा युग्मित टेम्पलेटों को diff करने के बजाय एक फ़ाइल के भीतर होती है। नई परमिशन प्रविष्टियाँ, हुक इवेंट, timeout, और स्टेटस संदेश उस फ़ाइल में परमाण्विक रूप से उतरते हैं।

5. स्किल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 स्किल परिपाटी के अनुसार।

6. आउटपुट-स्टाइलCopy Anchor Link

चार आउटपुट-स्टाइल src/apothem/output-styles/ के अंतर्गत रहती हैं।

7. आर्टिफ़ैक्ट विकासCopy Anchor Link

अनिवार्य। जब कोई पुन: प्रयोज्य पैटर्न, सुधार, या तकनीक पुनरावृत्त होती है (एक सत्र में 2+ इंस्टेंस, या स्मृति में पुनरावर्ती के रूप में नोट की गई), तो ईकोसिस्टम को विकसित होना चाहिए। चक्र के चार चरण हैं: किसी भी अंतःक्रिया के दौरान पैटर्न को Detect करें; अतिव्यापन के लिए मौजूदा स्किल, नियम, कमांड, हुक, और स्मृति को Search करें; मेल खाते आर्टिफ़ैक्ट को इन-प्लेस विकसित करके (प्रक्रिया, एंटी-पैटर्न, स्कोप अपडेट) या जब चिंता वास्तव में लंबकोणीय हो तब एक नया बनाकर Act करें; Validate करें कि क्रॉस-संदर्भ अब भी हल होते हैं और आश्रित आर्टिफ़ैक्ट सुसंगत रहते हैं। निर्माण पर परिष्करण को प्राथमिकता दें — नए आर्टिफ़ैक्ट रखरखाव सतह को संयोजित करते हैं। प्रत्येक आर्टिफ़ैक्ट वर्ग में अंतराल-पहचान ट्रिगरों के बंद कैटलॉग सहित पूर्ण प्रोटोकॉल के लिए src/apothem/rules/persistent-conventions-vigilance.md §2+§4 देखें।

8. रिक्त आर्टिफ़ैक्ट वर्गCopy Anchor Link

ईकोसिस्टम रजिस्ट्री में घोषित पर जान-बूझकर रिक्त सतहें जब तक कोई सक्रियण ट्रिगर फ़ायर न हो। प्रत्येक पंक्ति आरक्षित सतह, वर्ग को scaffold करने वाली फ़ाइल या डायरेक्टरी, और वह ट्रिगर रिकॉर्ड करती है जो पंक्ति को रिक्त-प्रमाणन से आबाद में प्रोन्नत करता है।

रिक्त-प्रमाणन एक सकारात्मक घोषणा है, अंतराल नहीं। वर्ग का scaffold (जब कोई मौजूद हो) वह विहित no-op आर्टिफ़ैक्ट है जो सक्रियण क्षण को ट्रैक करता है। रिक्त-प्रमाणन से आबाद की प्रोन्नतियाँ scaffold के प्रथम गैर-रिक्त मान के साथ प्रासंगिक रजिस्ट्री खंड में परमाण्विक रूप से उतरती हैं।