एजेंट आर्किटेक्चर

Apothem किस तरह एक ही एजेंटिक-क्षमता समूह को सत्रह हार्नेस पर—जिनके हुक सतह और नियम प्रारूप भिन्न हैं—प्रक्षेपित करता है।

यह एक डेवलपर-केंद्रित तकनीकी-विनिर्देश पृष्ठ है। यह Apothem की आंतरिक शब्दावली — अडैप्टर वर्ग, मटेरियलाइज़र, प्रोपगेशन मैनिफ़ेस्ट, सिबलिंग-कन्वेंशन अभिसरण — का उपयोग करता है, और इसे सामान्य पाठक-वर्ग के लिए नरम नहीं करता।

Apothem एक साझा प्रोफ़ाइल (~/.config/apothem/profile.yaml) पढ़ता है और सत्रह पंजीकृत अडैप्टरों के लिए टूल-नेटिव कॉन्फ़िगरेशन को मटेरियलाइज़ करता है। ये टूल एक साझा एजेंटिक-क्षमता मॉडल साझा नहीं करते: कुछ प्री-टूल-कॉल हुक उजागर करते हैं, कुछ सपाट .md फ़ाइलों से नियम चलाते हैं, कुछ हर नियम को एक ही निर्देश फ़ाइल में अंतःस्थापित करते हैं, और कुछ इंस्टॉल समय पर प्रोफ़ाइल-संचालित कॉन्फ़िग रेंडर करते हैं। यह पृष्ठ उस भिन्नता और उस अनुशासन को मानचित्रित करता है जिसे Apothem उसके आर-पार लागू करता है।

प्रति-टूल एजेंटिक-क्षमता मैट्रिक्स

नीचे का मैट्रिक्स सभी सत्रह टूल को कवर करता है। स्तंभ: प्रत्येक टूल जो PreToolUse हुक सतह उजागर करता है, Apothem नियम सक्रिय करने के लिए जो प्रारूप उपयोग करता है, वह अडैप्टर वर्ग (देखें अडैप्टर वर्ग), और क्या अडैप्टर किसी मटेरियलाइज़र के माध्यम से नेटिव कॉन्फ़िग रेंडर करता है।

टूल	PreToolUse हुक सतह	नियम-सक्रियण प्रारूप	अडैप्टर वर्ग	मटेरियलाइज़र
antigravity	नेटिव हुक सतह मौजूद है; केवल Apothem समर्थन सामग्री	`GEMINI.md` साथ ही Antigravity CLI प्लगइन नियम	वर्ग I	कोई नहीं
claude-code	नेटिव PreToolUse / PostToolUse / Stop / SessionStart	`rules/` के अंतर्गत `.md` सपाट नियम	वर्ग II-A	कोई नहीं (वेंडर सेटिंग्स टेम्पलेट)
codebuddy	कोई नहीं	`.codebuddy/rules/apothem-rules.md` प्रोजेक्ट नियम फ़ाइल	वर्ग I	कोई नहीं
codex	नेटिव `hooks.json` लाइफ़साइकल हुक	`AGENTS.md` साथ ही इंस्टॉल किए गए स्किलों द्वारा संदर्भित समर्थन नियम	वर्ग I	कोई नहीं
cursor	कोई नहीं	`.mdc` वर्कस्पेस नियम (MDC फ़्रंटमैटर: `description` / `globs` / `alwaysApply`)	वर्ग I	कोई नहीं
gemini-cli	कोई नहीं	एकल `GEMINI.md` में अंतःस्थापित नियम	वर्ग I	कोई नहीं
github-copilot	कोई नहीं (IDE एक्सटेंशन, कोई टूल-कॉल हुक नहीं)	`.github/copilot-instructions.md` में नियम	वर्ग I	कोई नहीं
glm	कोई नहीं (मॉडल बैकएंड; कोई एजेंट टूल सतह नहीं)	`.apothem/providers/glm.toml` बैकएंड प्रोवाइडर कॉन्फ़िग (कोई नियम समूह नहीं)	वर्ग I	कोई नहीं
hermes	केवल समर्थन सामग्री	`config.yaml` साथ ही बाहरी स्किल निर्देशिका	वर्ग II-B	`config.yaml`
kimi-code	कोई नहीं	`AGENTS.md` साथ ही `.kimi-code/.apothem/support/` के अंतर्गत समर्थन नियम	वर्ग I	कोई नहीं
kiro	कोई नहीं (Kiro एजेंट हुक अडैप्टर दायरे से बाहर हैं)	`.kiro/steering/apothem-rules.md` स्टीयरिंग फ़ाइल	वर्ग I	कोई नहीं
open-claw	केवल समर्थन सामग्री	`openclaw.json` साथ ही अतिरिक्त स्किल निर्देशिका	वर्ग II-B	`openclaw.json`
opencode	केवल समर्थन सामग्री	प्रोफ़ाइल-रेंडर किया गया JSON साथ ही नेटिव कमांड, स्किल और एजेंट	वर्ग II-B	`opencode.json`
qwen-code	नेटिव PreToolUse / Stop / SessionStart	`QWEN.md` साथ ही नेटिव कमांड, स्किल और एजेंट	वर्ग II-B	`settings.json` / `QWEN.md`
trae	कोई नहीं	`.trae/rules/apothem-rules.md` प्रोजेक्ट नियम फ़ाइल	वर्ग I	कोई नहीं
windsurf	कोई नहीं	`.devin/rules/` में नियम	वर्ग I	कोई नहीं
zed	कोई नहीं	प्रोजेक्ट-रूट `.rules` सपाट फ़ाइल	वर्ग I	कोई नहीं

मैट्रिक्स पर टिप्पणियाँ:

claude-code संदर्भ अडैप्टर है। यह नेटिव PreToolUse, PostToolUse, Stop, और SessionStart हुक रखता है और वेंडर सेटिंग्स टेम्पलेट भेजता है। यह जानबूझकर CLAUDE.md का प्रबंधन नहीं करता — वह फ़ाइल ऑपरेटर-स्वामित्व वाला क्षेत्र है।
codex hooks.json के माध्यम से नेटिव लाइफ़साइकल हुक इंस्टॉल करता है, एजेंटों को TOML में परिवर्तित करता है, कमांड प्रॉम्प्ट को Codex स्किलों के रूप में लपेटता है, और config.toml को ऑपरेटर-स्वामित्व में छोड़ देता है।
antigravity ~/.gemini/GEMINI.md को वैश्विक संदर्भ-लंगर के रूप में रखता है और ~/.gemini/antigravity-cli/plugins/apothem/ के अंतर्गत एक Apothem प्लगइन इंस्टॉल करता है। हुक फ़ाइलें समर्थन सामग्री के रूप में तब तक रखी जाती हैं जब तक अडैप्टर Antigravity हुक-स्कीमा अनुवाद का स्वामी न हो।
cursor वेंडर MDC फ़्रंटमैटर (description, globs, alwaysApply) धारण करने वाली .mdc फ़ाइलों के माध्यम से नियम सक्रिय करता है; अडैप्टर कोई एकल-फ़ाइल .cursorrules नहीं लिखता।
windsurf .devin/rules/ का उपयोग करता है; अडैप्टर कोई एकल-फ़ाइल .windsurfrules नहीं लिखता।
hermes और open-claw नेटिव कॉन्फ़िग फ़ाइलें रेंडर करते हैं और प्रत्येक टूल की प्रलेखित स्किल-निर्देशिका सेटिंग के माध्यम से Apothem समर्थन स्किल निर्देशिकाओं को जोड़ते हैं। असमर्थित साझा समूह Apothem-स्वामित्व वाले समर्थन उप-वृक्षों के अंतर्गत रहते हैं।
qwen-code संदर्भ और हुक प्रेषण के लिए प्रलेखित settings.json कुंजियाँ रेंडर करता है, फिर Qwen-नेटिव कमांड, स्किल, और एजेंट निर्देशिकाओं का उपयोग करता है।

आर-पार-टूल ऑर्केस्ट्रेशन अनुशासन

Apothem सिबलिंग-कन्वेंशन अभिसरण लागू करता है: एक ही ऑपरेटर-आह्वान-योग्य वर्कफ़्लो को एक साझा प्रारूप में बाध्य करने के बजाय प्रत्येक टूल के नेटिव मुहावरे में प्रक्षेपित किया जाता है। एक नियम जो claude-code के तहत सपाट .md फ़ाइल के रूप में सक्रिय होता है, वह cursor के तहत .mdc वर्कस्पेस नियम बन जाता है, gemini-cli के तहत GEMINI.md का एक अंतःस्थापित खंड बन जाता है, और qwen-code के QWEN.md साथ ही नेटिव खोज निर्देशिकाओं में एक संयोजित संदर्भ बन जाता है — वही आशय, प्रत्येक टूल की बोली।

केननिकल-मास्टर समूह यहाँ रहता है:

src/apothem/{rules,commands,skills,agents,output-styles,hooks,conformity,statuslines}/

प्रत्येक अडैप्टर इस समूह के एक उपसमुच्चय का प्रसार करता है। प्रति-टूल उपसमुच्चय src/apothem/lib/propagation-manifest.yaml में घोषित है; यह मैनिफ़ेस्ट इस बात का एकमात्र सत्य-स्रोत है कि कौन-से आर्टिफ़ैक्ट किस टूल तक और किस रूप में पहुँचते हैं। कोई अडैप्टर मैनिफ़ेस्ट के बाहर आर्टिफ़ैक्ट नहीं गढ़ता, और मैनिफ़ेस्ट कभी ऐसे टूल को कोई आर्टिफ़ैक्ट नहीं सौंपता जिसके पास उसे होस्ट करने की सतह नहीं है।

अडैप्टर वर्गों की व्याख्या

Apothem अडैप्टरों को इस आधार पर तीन वर्गों में छाँटता है कि वे साझा प्रोफ़ाइल को टूल-नेटिव आउटपुट में किस तरह अनुवादित करते हैं।

वर्ग I — रॉ-प्रोपगेशन। अडैप्टर केननिकल-मास्टर आर्टिफ़ैक्ट (एक मैनिफ़ेस्ट-घोषित उपसमुच्चय) को बिना किसी रेंडरिंग चरण के सीधे टूल की कॉन्फ़िग स्थिति में कॉपी करता है। कोई मटेरियलाइज़र नहीं होता। antigravity, codebuddy, codex, cursor, gemini-cli, github-copilot, glm, kimi-code, kiro, trae, windsurf, और zed वर्ग I हैं।
वर्ग II-A — रॉ + वेंडर-बद्ध सेटिंग्स टेम्पलेट। अडैप्टर आर्टिफ़ैक्ट को रॉ-प्रसारित करता है और अतिरिक्त रूप से वेंडर-विशिष्ट सेटिंग्स टेम्पलेट प्रबंधित करता है जो वेंडर के स्कीमा से बद्ध होते हैं। claude-code वर्ग II-A है।
वर्ग II-B — प्रोफ़ाइल-रेंडर्ड एकल-सतह मटेरियलाइज़र। अडैप्टर एक मटेरियलाइज़र के माध्यम से साझा प्रोफ़ाइल को एकल नेटिव कॉन्फ़िग सतह में रेंडर करता है। hermes, open-claw, opencode, और qwen-code वर्ग II-B हैं।

मटेरियलाइज़र-समय व्यवहार

वर्ग भेद मटेरियलाइज़र समय पर उभरता है — जब कोई ऑपरेटर किसी टूल के विरुद्ध CLI चलाता है:

apothem install --harness <H> <H> के लिए मैनिफ़ेस्ट उपसमुच्चय का प्रसार करता है और, वर्ग II-A / II-B अडैप्टरों के लिए, टूल-नेटिव कॉन्फ़िग रेंडर करता है।
apothem verify --harness <H> इंस्टॉल की गई कॉन्फ़िग की जाँच इस आधार पर करता है कि वर्तमान प्रोफ़ाइल क्या उत्पन्न करती और ड्रिफ़्ट की रिपोर्ट देता है।
apothem doctor प्रत्येक पंजीकृत अडैप्टर के आर-पार प्रति-टूल स्थिति की रिपोर्ट देता है — इंस्टॉल / अनुपस्थित / ड्रिफ़्टेड।

पूर्ण कमांड सतहों के लिए CLI संदर्भ देखें।

भिन्नता वर्गीकरण

सत्रह टूल तीन अक्षों के साथ भिन्न होते हैं। मैट्रिक्स में प्रत्येक प्रति-टूल अंतर इनमें से किसी एक तक सिमट जाता है।

अक्ष	सत्रह टूल के आर-पार देखी गई सीमा
हुक सतह	नेटिव मल्टी-इवेंट (claude-code, codex, qwen-code) → केवल-समर्थन हुक सामग्री (antigravity, gemini-cli, hermes, open-claw, opencode) → कोई नहीं (codebuddy, cursor, github-copilot, glm, kimi-code, kiro, trae, windsurf, zed)
नियम-सक्रियण प्रारूप	सपाट `.md` (claude-code) → प्लगइन नियम (antigravity) → `.mdc` वर्कस्पेस (cursor) → निर्देशिका नियम (codebuddy, trae, windsurf) → स्टीयरिंग फ़ाइल (kiro) → प्रोजेक्ट-रूट सपाट फ़ाइल (zed) → एकल अंतःस्थापित फ़ाइल (codex, gemini-cli, github-copilot, kimi-code) → कॉन्फ़िग-संदर्भित समर्थन सामग्री (hermes, open-claw, opencode, qwen-code) → बैकएंड प्रोवाइडर कॉन्फ़िग (glm)
अडैप्टर वर्ग	वर्ग I रॉ-प्रोपगेशन → वर्ग II-A रॉ + वेंडर सेटिंग्स → वर्ग II-B प्रोफ़ाइल-रेंडर्ड एकल-सतह

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