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

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

1. कमांड

तीस कमांड src/apothem/commands/*.md (गैर-पुनरावर्ती) से पंजीकृत हैं। प्रत्येक कमांड एक प्रथम-श्रेणी पंजीकृत फ़ाइल है; /plan ऑर्केस्ट्रेटर केवल पहले-से-प्रथम-श्रेणी प्लान स्टेजों को शृंखलाबद्ध करता है और अपना कोई स्टेज लॉजिक नहीं रखता, इसलिए अब भी कोई एकाश्म डिस्पैचर नहीं है और कोई सबकमांड समूहन नहीं है। गैर-प्लान, गैर-वर्कफ़्लो कमांड:

प्लान-पाइपलाइन कमांड

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

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

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

2. नियम

व्यवहार नियम 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. प्रत्यायोजित सहायक

बारह स्थायी सहायक परिभाषाएँ ईकोसिस्टम के साथ शिप होती हैं; ऑर्केस्ट्रेशन नियम के टीम पैटर्न उन्हें डिस्पैच करते हैं। प्रत्येक परिभाषा नीचे सूचीबद्ध फ़ाइल पथ पर रहती है।

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

4. हुक

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

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

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

5. स्किल

पुन: प्रयोज्य स्किल src/apothem/skills/ के अंतर्गत रहती हैं, प्रति स्किल एक फ़ोल्डर।

परिपाटी। प्रत्येक पंक्ति का पथ एक फ़ोल्डर है; प्रवेश बिंदु उसके भीतर SKILL.md फ़ाइल है — उदा. src/apothem/skills/plan-suite/SKILL.md — प्रोजेक्ट स्रोत लेआउट में घोषित फ़ोल्डर-के-साथ-SKILL.md स्किल परिपाटी के अनुसार।

6. आउटपुट स्टाइल

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

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

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

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

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

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