अक्सर पूछे जाने वाले प्रश्न

सामान्य प्रश्न, आवृत्ति के क्रम में।

apothem क्या है?

एक पोर्टेबल, होस्ट-अज्ञेयवादी कॉन्फ़िगरेशन जो आपकी होम निर्देशिका को कोडिंग-सहायक-संचालित विकास के लिए एक शासन, विचार-सृजन, और स्वचालन फ़्रेमवर्क में बदल देता है। यह व्यवहारिक नियमों, रचनात्मक मानकों, स्लैश कमांड, स्थायी प्रत्यायोजित वर्कर, हुक और स्किल को एक एकल सुसंगत सतह में जोड़ता है।

यह किन कोडिंग-सहायक CLI के साथ काम करता है?

Apothem हार्नेस-अज्ञेयवादी है। src/apothem/harnesses/<harness>/ के अंतर्गत प्रति-हार्नेस एडॉप्टर साझा प्रोफ़ाइल को प्रत्येक टूल की मूल कॉन्फ़िग निर्देशिका में प्रक्षेपित करते हैं; मानक सूची site/content/docs/harnesses/ पर है और वर्तमान में निम्नलिखित समर्थित हार्नेस को कवर करती है:

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, and Zed

Claude Code एडॉप्टर ~/.claude/ में मटेरियलाइज़ होता है; इसका हुक डिस्पैचर होस्ट-तटस्थ है — यह इकोसिस्टम रूट को पहले $CLAUDE_PROJECT_DIR से, फिर $LLM_PROJECT_DIR से रिज़ॉल्व करता है, फिर $HOME/.claude पर वापस लौटता है।

क्या मुझे प्लान-सूट पाइपलाइन का उपयोग करना आवश्यक है?

नहीं। प्लान-सूट पाइपलाइन इकोसिस्टम का एक घटक है। व्यवहारिक नियम, रचनात्मक मानक, हुक, और वैलिडेटर टूलचेन स्वतंत्र रूप से उपयोगी हैं।

रिपॉज़िटरी को फ़ोर्क किए बिना मैं नियमों को कैसे अनुकूलित करूँ?

मानक फ़्रंटमैटर के साथ src/apothem/rules/<my-rule>.md के अंतर्गत अपनी स्वयं की नियम फ़ाइल जोड़ें। नियम लोडर src/apothem/rules/*.md पैटर्न से मेल खाने वाली हर फ़ाइल उठा लेता है।

मैं किसी नियम को अस्थायी रूप से कैसे अक्षम करूँ?

या तो फ़ाइल का नाम src/apothem/rules/*.md पैटर्न से बाहर बदलें या इसे किसी सहोदर निर्देशिका में ले जाएँ जिसे लोडर स्कैन नहीं करता।

नियमों, स्किल और प्रत्यायोजित वर्कर के बीच क्या अंतर है?

• नियम व्यवहार को नियंत्रित करते हैं — हमेशा-चालू या पथ-फ़िल्टर्ड दायित्व जिनका सहायक पालन करता है।
• स्किल पुन: उपयोग योग्य पता लगाने योग्य तकनीकें हैं — एक पहचान संकेत, एक प्रक्रिया, और एक प्रवर्तन हुक।
• प्रत्यायोजित वर्कर अपने स्वयं के टूल प्रतिबंधों और सिस्टम प्रॉम्प्ट के साथ स्थायी भूमिकाएँ हैं, जो वर्कर-ऑर्केस्ट्रेशन प्रोटोकॉल के माध्यम से प्रेषित की जाती हैं।

मैं सुरक्षा समस्या की रिपोर्ट कैसे करूँ?

SECURITY.md देखें। समर्थित चैनल GitHub Security Advisories और [email protected] हैं।

मैं योगदान कैसे करूँ?

योगदान देखें। संक्षिप्त संस्करण: CONTRIBUTING.md पढ़ें, रिपॉज़िटरी को फ़ोर्क करें, मानक PR टेम्प्लेट को भरकर एक PR खोलें, और सुनिश्चित करें कि दस CI जाँच वर्ग पास हों।

इकोसिस्टम स्थिति कहाँ रहती है?

• प्रति-सूट प्लान स्थिति <project>/.apothem/plans/{suite}/ के अंतर्गत रहती है।
• प्रति-प्रोजेक्ट मेमोरी projects/{hash}/memory/ के अंतर्गत रहती है।
• क्रॉस-प्रोजेक्ट मेमोरी 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 देखें।