अक्सर पूछे जाने वाले प्रश्न
Apothem के उद्देश्य, समर्थित हार्नेस, प्लान-सूट की वैकल्पिकता, नियम अनुकूलन, आर्टिफ़ैक्ट प्रकार और इकोसिस्टम स्थिति स्थानों के बारे में सामान्य प्रश्न।
सामान्य प्रश्न, आवृत्ति के क्रम में।
apothem क्या है?
Apothem कोडिंग-सहायक हार्नेस के लिए एक होस्ट-अज्ञेयवादी कॉन्फ़िगरेशन प्रबंधक है। आप एक साझा प्रोफ़ाइल लिखते हैं, और Apothem उसे प्रत्येक टूल की मूल कॉन्फ़िगरेशन सतह में मटेरियलाइज़ करता है — व्यवहारिक नियमों, रचनात्मक मानकों, स्लैश कमांड, स्थायी प्रत्यायोजित वर्कर, हुक और स्किल को एक एकल शासित कॉर्पस में जोड़ते हुए, जो हर हार्नेस में सुसंगत बना रहता है।
यह किन सहायक हार्नेस के साथ काम करता है?
Apothem हार्नेस-अज्ञेयवादी है। src/apothem/harnesses/<harness>/ के अंतर्गत
प्रति-हार्नेस अडैप्टर साझा प्रोफ़ाइल को
प्रत्येक टूल की मूल कॉन्फ़िग निर्देशिका में प्रक्षेपित करते हैं। रनटाइम हार्नेस रजिस्ट्री
समर्थित सेट का आधिकारिक स्रोत है; हार्नेस पृष्ठ प्रत्येक का दस्तावेज़ीकरण
करते हैं। रजिस्ट्री वर्तमान में निम्नलिखित समर्थित हार्नेस को कवर करती है:
Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi CodeClaude Code अडैप्टर ~/.claude/ में मटेरियलाइज़ होता है; इसका हुक डिस्पैचर होस्ट-तटस्थ है —
यह इकोसिस्टम रूट को पहले $CLAUDE_PROJECT_DIR से, फिर $LLM_PROJECT_DIR से रिज़ॉल्व करता है, फिर स्क्रिप्ट-सापेक्ष और कार्यशील-डायरेक्टरी खोज आज़माता है, और अंत में $HOME/.claude पर वापस लौटता है।
क्या मुझे प्लान-सूट पाइपलाइन का उपयोग करना आवश्यक है?
नहीं। प्लान-सूट पाइपलाइन इकोसिस्टम का एक घटक है। व्यवहारिक नियम, रचनात्मक मानक, हुक, और वैलिडेटर टूलचेन स्वतंत्र रूप से उपयोगी हैं।
रिपॉज़िटरी को फ़ोर्क किए बिना मैं नियमों को कैसे अनुकूलित करूँ?
~/.config/apothem/profile.yaml में rules: सूची में एक स्ट्रिंग जोड़ें और
इंस्टॉल या अपडेट फिर से चलाएँ। src/apothem/rules/ के अंतर्गत नियम फ़ाइलें पैकेज किए गए स्रोत ट्री को संपादित करती हैं, जिसे आर्काइव इंस्टॉलर --yes के साथ चलाने पर बदल देता है।
मैं किसी नियम को अस्थायी रूप से कैसे अक्षम करूँ?
या तो फ़ाइल का नाम src/apothem/rules/*.md
पैटर्न से बाहर बदलें या इसे किसी सहोदर निर्देशिका में ले जाएँ जिसे लोडर स्कैन नहीं
करता।
नियमों, स्किल और प्रत्यायोजित वर्कर के बीच क्या अंतर है?
- नियम व्यवहार को नियंत्रित करते हैं — हमेशा-चालू या पथ-फ़िल्टर्ड दायित्व जिनका सहायक पालन करता है।
- स्किल पुन: उपयोग योग्य पता लगाने योग्य तकनीकें हैं — एक पहचान संकेत, एक प्रक्रिया, और एक प्रवर्तन हुक।
- प्रत्यायोजित वर्कर अपने स्वयं के टूल प्रतिबंधों और सिस्टम प्रॉम्प्ट के साथ स्थायी भूमिकाएँ हैं, जो वर्कर-ऑर्केस्ट्रेशन प्रोटोकॉल के माध्यम से प्रेषित की जाती हैं।
मैं सुरक्षा समस्या की रिपोर्ट कैसे करूँ?
SECURITY.md देखें। समर्थित चैनल GitHub Security
Advisories और [email protected] हैं।
मैं योगदान कैसे करूँ?
योगदान देखें। संक्षिप्त संस्करण:
CONTRIBUTING.md पढ़ें, रिपॉज़िटरी को फ़ोर्क करें, मानक PR टेम्प्लेट
को भरकर एक PR खोलें, और सुनिश्चित करें कि CI जाँचें पास हों —
डेवलपर मार्गदर्शिका उन गेटों को सूचीबद्ध करती है
जिन्हें किसी PR को पार करना होता है।
इकोसिस्टम स्थिति कहाँ रहती है?
- प्रति-सूट प्लान स्थिति
<project>/.apothem/plans/{suite}/के अंतर्गत रहती है। - Apothem मेमोरी इंस्टॉल रूट के नीचे
.apothem/memory/के अंतर्गत रहती है (Claude Code के लिए:~/.claude/.apothem/memory/; जबworkspace.scopeuser-homeहो तो~/.apothem/memory/; प्रोजेक्ट-स्कोप इंस्टॉल के लिए<project>/.apothem/memory/)। Claude Code की अपनी ऑटो-मेमोरी हार्नेस कॉन्फ़िग रूट के अंतर्गत,projects/{hash}/memory/पर रहती है (Claude Code के लिए:~/.claude/projects/{hash}/memory/)। - क्रॉस-प्रोजेक्ट मेमोरी उसी हार्नेस कॉन्फ़िग रूट के अंतर्गत,
.apothem/memory/पर रहती है (Claude Code के लिए:~/.claude/.apothem/memory/)। - प्रति-सत्र स्क्रैच
<project>/.apothem/plans/{suite}/_inputs/के अंतर्गत रहता है।
क्या मैं लंबे समय तक चलने वाले काम को नई सत्र में या किसी दूसरी मशीन पर आगे बढ़ा सकता हूँ?
हाँ। लंबे समय तक चलने वाला काम अपनी पूरी स्थिति को एक प्रोजेक्ट-स्थानीय .apothem/plans/
सूट में बाहरीकृत कर देता है — एक पुनरारंभ अनुबंध के साथ एक कोल्ड-स्टार्ट प्रोटोकॉल —,
ताकि काम किसी एक चैट इतिहास के भीतर न रहे। चूँकि स्थिति आपके प्रोजेक्ट की फ़ाइलों में
होती है, उसी प्रोजेक्ट की ओर इंगित किसी भी खाते या मशीन पर एक नया सत्र उस काम को
वहीं से आगे बढ़ा देता है। Apothem स्वयं फ़ाइलों को खातों के बीच नहीं भेजता; वे उसी तरह
यात्रा करती हैं जैसे आपके प्रोजेक्ट की फ़ाइलें पहले से करती हैं (संस्करण नियंत्रण, एक साझा
चेकआउट, एक समन्वयित निर्देशिका)। देखें पुनरारंभ-योग्य योजना।
क्या Apothem को pip की आवश्यकता है?
नहीं — इंजन के लिए तो नहीं। इंजन वेंडर की गई निर्भरताओं के साथ एक स्व-निहित स्रोत
ट्री है — यह सिस्टम Python 3.10+ पर किसी भी चेकआउट, npx कैश, या प्लगइन ट्री से
python -m apothem के रूप में चलता है, और अपना स्वयं का कोई भी कोड site-packages
में इंस्टॉल नहीं करता (click और rich ही एकमात्र इंटरप्रेटर पूर्वापेक्षाएँ हैं)।
एकमात्र वैकल्पिक अपवाद: यदि click या rich अनुपस्थित है, तो इंस्टॉलर आपके लिए
केवल उन्हीं दोनों के लिए pip install चलाने की पेशकश करता है — आपकी पुष्टि के साथ,
या --yes / APOTHEM_AUTO_INSTALL_DEPS=1 के साथ। Apothem के अपने पैकेज कभी भी
site-packages में इंस्टॉल नहीं होते।
इंस्टॉल किए गए पैकेज के बिना हुक कैसे चलते हैं?
apothem install हार्नेस रूट के अंतर्गत हुक डिस्पैचर और अनुरूपता गेट को
मटेरियलाइज़ करता है (Claude Code के लिए: ~/.claude/.apothem/support/hooks/ और
~/.claude/.apothem/support/conformity/), और रेंडर की गई हुक प्रविष्टियाँ उन
स्क्रिप्ट को निरपेक्ष पथ से आह्वान करती हैं। दोनों स्टैंडअलोन stdlib स्क्रिप्ट हैं, इसलिए हुक
ऐसी मशीन पर काम करते हैं जिसने कभी pip install नहीं देखा।
मैं पूरी तरह से अनइंस्टॉल कैसे करूँ?
प्रत्येक इंस्टॉल किए गए हार्नेस के लिए apothem uninstall --harness <name> चलाएँ,
अपने इंस्टॉल चैनल के अनुसार इंजन हटाएँ, और यदि आप शून्य अवशेष चाहते हैं तो ~/.apothem/ (बैकअप) के साथ
~/.config/apothem/ (आपकी प्रोफ़ाइल) हटा दें।
अनइंस्टॉलिंग गाइड प्रत्येक चैनल को समझाती है।
इकोसिस्टम किस लाइसेंस के अंतर्गत है?
MIT — LICENSE देखें।