एजेंट आर्किटेक्चर
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/settings.local.json में नेटिव SessionStart और PostToolUse; कोई PreToolUse गार्ड नहीं (वेंडर वहाँ कोई additionalContext प्रलेखित नहीं करता) | .codebuddy/rules/apothem-rules.md प्रोजेक्ट नियम फ़ाइल | वर्ग I | कोई नहीं |
| codex | नेटिव hooks.json लाइफ़साइकल हुक | AGENTS.md साथ ही इंस्टॉल की गई स्किलों द्वारा संदर्भित समर्थन नियम | वर्ग I | कोई नहीं |
| cursor | प्रोजेक्ट की .cursor/hooks.json में नेटिव sessionStart; अभी कोई टूल-इवेंट हुक नहीं | एक .mdc वर्कस्पेस नियम फ़ाइल (MDC फ़्रंटमैटर: description / globs / alwaysApply) | वर्ग I | कोई नहीं |
| gemini-cli | नेटिव हुक सतह मौजूद है; केवल Apothem समर्थन सामग्री | एकल GEMINI.md में अंतःस्थापित नियम | वर्ग I | कोई नहीं |
| github-copilot | .github/hooks/apothem.json में नेटिव sessionStart और postToolUse; कोई preToolUse गार्ड नहीं (वेंडर वहाँ केवल अनुमति फ़ील्ड पढ़ता है) | .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/hooks/apothem.json में नेटिव SessionStart; कोई टूल-इवेंट हुक नहीं (वेंडर उनके आउटपुट को अनदेखा करता है) | .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/config.local.json में Devin Local के लिए नेटिव SessionStart और PostToolUse; कोई PreToolUse गार्ड नहीं (वेंडर वहाँ कोई संदर्भ चैनल प्रलेखित नहीं करता) | .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>जाँचता है कि प्रबंधित फ़ाइलें मौजूद हैं और पार्स होती हैं।--profile PATHके साथ यह उन्हें इस आधार पर भी जाँचता है कि वह प्रोफ़ाइल क्या उत्पन्न करती, और ड्रिफ़्ट होने पर विफल होता है।apothem statusरिपोर्ट देता है कि प्रत्येक टूल इंस्टॉल है या नहीं और क्या वह वर्तमान साझा प्रोफ़ाइल से ड्रिफ़्ट हुआ है।apothem doctorप्रत्येक पंजीकृत अडैप्टर के आर-पार प्रति-टूल स्वास्थ्य की रिपोर्ट देता है:ok,not_installed,needs_project,verify_failed,hook_failed, याerror।
पूर्ण कमांड सतहों के लिए CLI संदर्भ देखें।
भिन्नता वर्गीकरण
सत्रह टूल तीन अक्षों के साथ भिन्न होते हैं। मैट्रिक्स में प्रत्येक प्रति-टूल अंतर इनमें से किसी एक तक सिमट जाता है।
| अक्ष | सत्रह हार्नेस के आर-पार देखी गई सीमा |
|---|---|
| हुक सतह | नेटिव मल्टी-इवेंट (claude-code, codex, qwen-code) → उन इवेंट पर नेटिव जिन्हें वेंडर मॉडल तक पहुँचाता है (codebuddy: SessionStart और PostToolUse; cursor: sessionStart; github-copilot: sessionStart और postToolUse; kiro: SessionStart; windsurf: SessionStart और PostToolUse) → केवल-समर्थन हुक सामग्री (antigravity, gemini-cli, hermes, kimi-code, open-claw, opencode) → अडैप्टर द्वारा कोई हुक पंजीकृत नहीं (glm, trae, 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 का काम है एक सुसंगत ऑपरेटर आशय को स्थिर रखना जबकि ये तीन अक्ष प्रति-टूल भिन्न होते हैं। प्रसार मैनिफ़ेस्ट और अडैप्टर-वर्ग अनुबंध — ये दो तंत्र हैं जो उस आशय को भिन्नता के आर-पार स्थिर बनाए रखते हैं।