Archcore MCP

आधिकारिक

एक स्थानीय stdio MCP सर्वर जो AI कोडिंग एजेंटों को आपके रिपॉजिटरी से सीधे संरचित आर्किटेक्चर, नियम और निर्णय पढ़ने और बनाए रखने की अनुमति देता है।

GitHub

Archcore MCP के साथ आप क्या कर सकते हैं?

Archcore स्पेक्स, निर्णयों और नियमों को .archcore/ में टाइप किए गए Markdown के रूप में रखता है, जो MCP टूल्स के माध्यम से आपके एजेंट को उपलब्ध कराया जाता है।

प्रोजेक्ट संदर्भ खोजें — संपादन से पहले सहायक से लागू ADR, नियम या स्पेक्स खोजने के लिए कहें, search_documents के माध्यम से।
निर्णय दर्ज करें — सहायक से create_document के साथ एक संरचित ADR या नियम दस्तावेज़ बनवाएं।
मौजूदा संदर्भ अपडेट करें — सहायक से update_document का उपयोग करके स्पेक या योजना को संशोधित करने के लिए कहें।
सभी दस्तावेज़ सूचीबद्ध करें — .archcore/ में हर संदर्भ दस्तावेज़ को list_documents के साथ सूचीबद्ध करें।
दस्तावेज़ प्राप्त करें — get_document के साथ एकल दस्तावेज़ की पूरी सामग्री प्राप्त करें।
संबंधित दस्तावेज़ लिंक करें — add_relation के साथ दस्तावेज़ों को जोड़ें और list_relations के माध्यम से उन्हें देखें।

दस्तावेज़

Archcore CLI — AI कोडिंग एजेंटों के लिए Git-नेटिव संदर्भ

Archcore, AI कोडिंग एजेंटों के लिए एक git-नेटिव संदर्भ परत है।

CLI स्पेक्स, आर्किटेक्चर निर्णयों, नियमों, योजनाओं और प्रोजेक्ट ज्ञान को .archcore/ में रखता है, आपके कोड के साथ संस्करणित, और MCP और सत्र हुक के माध्यम से कोडिंग एजेंटों को प्रासंगिक संदर्भ प्रदान करता है।

यह CLI और एक स्थानीय stdio MCP सर्वर के रूप में उपलब्ध है, इसलिए कोई भी MCP-संगत कोडिंग एजेंट मानक टूल के माध्यम से आपके प्रोजेक्ट संदर्भ को पढ़ और लिख सकता है। इसका उपयोग Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code और Cline में लगातार प्रोजेक्ट संदर्भ के लिए करें।

इसे काम करते देखें

वह संदर्भ .archcore/ से आया — Git में संस्करणित टाइप किए गए Markdown दस्तावेज़, MCP टूल और सत्र हुक के माध्यम से किसी भी एजेंट को प्रदान किए जाते हैं।

archcore demo

क्या बदलता है

❌ Archcore के बिना

हर सत्र शून्य से शुरू होता है। एजेंट:

आपके आर्किटेक्चर का अनुमान लगाता है और आपके कन्वेंशन तोड़ता है
पहले से मौजूद लॉजिक की नकल करता है
उन निर्णयों को फिर से उठाता है जो आपकी टीम पहले ही कर चुकी है
हर चैट में समान संदर्भ को फिर से समझाने की आवश्यकता होती है

✅ Archcore के साथ

आपके निर्णय, नियम और कन्वेंशन संरचित संदर्भ के रूप में Git में रहते हैं। एजेंट:

सत्र प्रारंभ में लागू निर्णयों और नियमों को लोड करता है
कोड को वहाँ रखता है जहाँ आपका आर्किटेक्चर कहता है कि वह है
रिपॉजिटरी में पहले से मौजूद ADR, स्पेक्स और नियमों का सम्मान करता है
नए निर्णयों को स्थायी संदर्भ के रूप में रिकॉर्ड करता है — PR में समीक्षा योग्य, एजेंटों के बीच पोर्टेबल

एजेंट अनुमान लगाना बंद कर देता है और सिस्टम का पालन करना शुरू कर देता है।

60 सेकंड में आरंभ करें

curl -fsSL https://archcore.ai/install.sh | bash    # macOS / Linux
cd your-project && archcore init

archcore init .archcore/ स्कैफोल्ड करता है, आपके कोडिंग एजेंटों का पता लगाता है, और उनके लिए हुक और MCP सेट करता है।

फिर अपना एजेंट खोलें और कहें:

"हम प्राथमिक स्टोरेज के लिए PostgreSQL का उपयोग कर रहे हैं। इस निर्णय को रिकॉर्ड करें।"

हो गया — अब .archcore/ में एक संरचित ADR है जिसे किसी भी एजेंट में हर भविष्य का सत्र देखेगा।

Windows पर: irm https://archcore.ai/install.ps1 | iex। WSL के लिए, go install, और स्रोत से निर्माण के लिए, नीचे Install methods या पूर्ण इंस्टॉल गाइड देखें।

आपके एजेंट के साथ काम करता है

CLI स्वयं एक स्थानीय stdio MCP सर्वर है — हर MCP-संगत एजेंट के लिए एक एकीकरण सतह। हुक उन एजेंटों में सत्र-प्रारंभ संदर्भ जोड़ते हैं जहाँ वे उनका समर्थन करते हैं।

Agent	Hooks	MCP
Claude Code	yes	yes
Cursor	yes	yes
Gemini CLI	yes	yes
GitHub Copilot	yes	yes
OpenCode	—	yes
Codex CLI	—	yes
Roo Code	—	yes
Cline	—	manual

archcore init पहचाने गए एजेंटों को स्वचालित रूप से कॉन्फ़िगर करता है। हाथ से जोड़ने के लिए:

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

यह कैसे काम करता है

Initialize — archcore init .archcore/ बनाता है और एजेंट एकीकरण इंस्टॉल करता है।
Capture — निर्णय, नियम, योजनाएँ और गाइड YAML frontmatter के साथ टाइप किए गए Markdown दस्तावेज़ों के रूप में संग्रहीत किए जाते हैं।
Reuse — एजेंट काम करते समय MCP टूल के माध्यम से दस्तावेज़ पढ़ते, बनाते, अपडेट करते और लिंक करते हैं; हुक सत्र प्रारंभ में संदर्भ लोड करते हैं।
Git में रखें — संदर्भ परिवर्तनों की समीक्षा कोड की तरह करें, उन्हें समय के साथ विकसित करें, उन्हें टूल के बीच पोर्टेबल रखें।

.archcore/
├── settings.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

संरचना स्वतंत्र-रूप है — डोमेन, फीचर या टीम द्वारा व्यवस्थित करें। किसी दस्तावेज़ का प्रकार उसके फ़ाइलनाम में रहता है (slug.type.md): तीन परतों में 19 प्रकार — ज्ञान (ADR, नियम, स्पेक्स, गाइड), दृष्टि (PRD, योजनाएँ, विचार, आवश्यकता ट्रैक), और अनुभव (घटना पैटर्न, आवर्ती कार्य)। इस रिपॉजिटरी का अपना .archcore/ एक कार्यशील उदाहरण है।

अपने एजेंट से पूछें

"auth मॉड्यूल को छूने से पहले, यहाँ कौन से निर्णय और नियम लागू होते हैं?"

एजेंट एक भी पंक्ति संपादित करने से पहले उस क्षेत्र से जुड़े ADR और नियम लोड करता है।

"हमारा एक कन्वेंशन है: त्रुटियों को हमेशा fmt.Errorf और %w के साथ लपेटें। इसे एक नियम बनाएं।"

अनिवार्य मार्गदर्शन, तर्क और अच्छे/बुरे उदाहरणों के साथ backend/error-wrapping.rule.md बनाता है।

"पिछले सप्ताह हमारे पास connection-pool exhaustion की घटना थी। इसे दस्तावेज़ित करें ताकि हम इसे दोहराएँ नहीं।"

मूल-कारण विश्लेषण और रोकथाम चरणों के साथ incidents/connection-pool-exhaustion.cpat.md बनाता है।

यह कैसे तुलना करता है

यदि आप इस पर निर्भर हैं…	कमी	Archcore इसके बजाय क्या करता है
कुछ भी नहीं	एजेंट हर सत्र में आपकी रिपॉजिटरी को फिर से सीखता है और तय किए गए निर्णयों को फिर से उठाता है	सत्र प्रारंभ में निर्णय, नियम और कन्वेंशन लोड करता है — किसी भी एजेंट में
फ्लैट निर्देश फ़ाइलें (`CLAUDE.md`, `.cursorrules`)	पाठ की एक बढ़ती दीवार — कोई प्रकार नहीं, कोई लिंक नहीं, कोई जीवनचक्र नहीं, प्रति टूल कॉपी-पेस्ट	टाइप किए गए दस्तावेज़, एक संबंध ग्राफ, एक ड्राफ्ट → स्वीकृत जीवनचक्र, हर एजेंट के लिए एक सेटअप
मेमोरी टूल (claude-mem, Mem0)	आपने क्या किया याद रखता है — अस्थिर, अपारदर्शी, विक्रेता-बद्ध	सिस्टम कैसे बनाया गया है और क्या तय किया गया था संग्रहीत करता है — Git में संस्करणित, आपके स्वामित्व में
पद्धति किट (BMAD, Spec Kit, Agent OS)	एक प्रक्रिया निर्धारित करते हैं, अक्सर एक बार के हैंडऑफ के रूप में	आर्टिफैक्ट संग्रहीत करता है — एक जीवित संदर्भ ग्राफ जो कोडबेस के साथ विकसित होता है
RAG / एक बड़ा संदर्भ विंडो	वह पुनर्प्राप्त करता है जो कोड कहता है, नहीं जो तय किया गया था और क्यों	निर्णयों और तर्क को स्पष्ट और चयनात्मक रखता है — एजेंट वह लोड करता है जो लागू होता है, सब कुछ नहीं

इसके लिए नहीं — चैट मेमोरी, प्रॉम्प्ट लाइब्रेरी, या एक बार का स्पेक-से-कोड जनरेटर। Archcore कोडिंग एजेंटों के लिए एक रिपॉजिटरी सत्य परत है, पद्धति किट नहीं।

संदर्भ

बॉक्स में क्या आता है: 19 दस्तावेज़ प्रकार, 4 संबंध प्रकार, 10 MCP टूल, 4 एजेंटों के लिए हुक एकीकरण और 8 के लिए MCP एकीकरण।

दस्तावेज़ प्रकार — दृष्टि, ज्ञान और अनुभव में 19 प्रकार

ज्ञान

Type	Full Name	Description
`adr`	Architecture Decision Record	संदर्भ, विकल्पों और परिणामों के साथ एक अंतिम तकनीकी निर्णय को कैप्चर करता है
`rfc`	Request for Comments	टीम समीक्षा और फीडबैक के लिए खुले एक महत्वपूर्ण परिवर्तन का प्रस्ताव करता है
`rule`	Rule	अनिवार्य मार्गदर्शन और उदाहरणों के साथ कोडिंग या प्रक्रिया मानक
`guide`	Guide	एक विशिष्ट कार्य पूरा करने के लिए चरण-दर-चरण निर्देश
`doc`	Document	संदर्भ दस्तावेज़ीकरण, रजिस्ट्री और वर्णनात्मक सामग्री
`spec`	Specification	एक सीमा या फीचर/उप-सिस्टम के लिए मानक व्यवहार अनुबंध जिस पर अन्य निर्भर करते हैं

दृष्टि

Type	Full Name	Description
`prd`	Product Requirements Document	लक्ष्य, उपयोगकर्ता कहानियाँ, स्वीकृति मानदंड और सफलता मेट्रिक्स
`idea`	Idea	भविष्य की खोज के लिए किसी उत्पाद या तकनीकी विचार का हल्का कैप्चर
`plan`	Plan	स्वीकृति मानदंड और निर्भरताओं के साथ चरणबद्ध कार्य सूची
`rnd`	Research	समय-बद्ध जाँच जो किसी निर्णय को रोकने वाले प्रश्न का उत्तर देती है

दो अतिरिक्त आवश्यकता ट्रैक उन टीमों के लिए जिन्हें संरचित खोज या औपचारिक विघटन की आवश्यकता है:

Sources ट्रैक (MRD → BRD → URD) — कैप्चर करता है कि आवश्यकताएँ कहाँ से आती हैं:

Type	Full Name	Description
`mrd`	Market Requirements Document	बाजार परिदृश्य, TAM/SAM/SOM, प्रतिस्पर्धी विश्लेषण और बाजार आवश्यकताएँ
`brd`	Business Requirements Document	व्यावसायिक उद्देश्य, हितधारक, ROI और व्यावसायिक नियम
`urd`	User Requirements Document	उपयोगकर्ता व्यक्तित्व, यात्राएँ, उपयोगिता आवश्यकताएँ और स्वीकृति मानदंड

ISO/IEC/IEEE 29148:2018 ट्रैक (BRS → StRS → SyRS → SRS) — कैप्चर करता है कि आवश्यकताएँ कैसे विघटित होती हैं:

Type	Full Name	Description
`brs`	Business Requirements Specification	मिशन, लक्ष्य, उद्देश्य और व्यावसायिक परिचालन अवधारणा
`strs`	Stakeholder Requirements Specification	हितधारक आवश्यकताएँ, परिचालन अवधारणा और उपयोगकर्ता आवश्यकताएँ
`syrs`	System Requirements Specification	सिस्टम फ़ंक्शन, इंटरफ़ेस, प्रदर्शन और डिज़ाइन बाधाएँ
`srs`	Software Requirements Specification	सॉफ़्टवेयर फ़ंक्शन, बाहरी इंटरफ़ेस और विस्तृत व्यवहार स्पेक्स

अधिकांश प्रोजेक्ट के लिए PRD का उपयोग करें; संरचित आवश्यकता खोज के लिए sources ट्रैक जोड़ें, और विनियमित या जटिल बहु-टीम सिस्टम में औपचारिक ट्रेसेबिलिटी के लिए ISO 29148। स्वतंत्र रूप से मिलाएँ।

अनुभव

Type	Full Name	Description
`task-type`	Task Type	आवर्ती कार्य के लिए पुन: प्रयोज्य चेकलिस्ट और वर्कफ़्लो
`cpat`	Code Change Pattern	रोकथाम चरणों के साथ किसी बग या घटना का मूल-कारण विश्लेषण

प्रत्येक दस्तावेज़ YAML frontmatter के साथ एक Markdown फ़ाइल है:

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

मान्य स्थितियाँ: draft, accepted, rejected। टैग वैकल्पिक और स्वतंत्र-रूप हैं।

MCP टूल और संबंध

MCP टूल

10 टूल: init_project, list_documents, get_document, search_documents, create_document, update_document, remove_document, add_relation, remove_relation, list_relations। सर्वर एक खाली रिपॉजिटरी में भी काम करता है — एजेंट init_project के माध्यम से स्वयं .archcore/ बूटस्ट्रैप कर सकते हैं।

संबंध

दस्तावेज़ निर्देशित संबंधों से लिंक होते हैं: related (सामान्य संबंध), implements (स्रोत लागू करता है जो लक्ष्य निर्दिष्ट करता है), extends (स्रोत लक्ष्य पर निर्माण करता है), depends_on (स्रोत को लक्ष्य की आवश्यकता होती है)। एजेंट द्वारा MCP टूल के माध्यम से प्रबंधित।

स्थानीय MCP सर्वर

archcore mcp वर्तमान निर्देशिका से stdio पर दस्तावेज़ प्रदान करता है। --project /path/to/repo पास करें (या ARCHCORE_PROJECT_ROOT सेट करें) जब सर्वर किसी ऐसी निर्देशिका से लॉन्च किया जाता है जो आपका वर्कस्पेस नहीं है — उदाहरण के लिए, किसी एडिटर एकीकरण द्वारा।

कमांड

मैं आपके लिए इस Markdown को हिन्दी में अनुवाद कर रहा हूँ। | कमांड | विवरण | | ------------------------ | ------------------------------------------------ | | `archcore init` | `.archcore/` निर्देशिका को इंटरैक्टिव रूप से प्रारंभ करें | | `archcore doctor` | अपना archcore सेटअप जांचें और समस्याएं ठीक करें | | `archcore status` | `.archcore/` संरचना और दस्तावेज़ स्वास्थ्य की जाँच करें | | `archcore config` | सेटिंग्स देखें या संशोधित करें | | `archcore hooks install` | पता लगाए गए AI एजेंटों के लिए हुक इंस्टॉल करें | | `archcore mcp` | MCP stdio सर्वर चलाएँ | | `archcore mcp install` | पता लगाए गए एजेंटों के लिए MCP कॉन्फ़िग इंस्टॉल करें | | `archcore update` | Archcore को नवीनतम संस्करण में अपडेट करें |

archcore update GitHub Releases की जाँच करता है, नया संस्करण डाउनलोड करता है, SHA-256 चेकसम सत्यापित करता है, और बाइनरी को एटॉमिक रूप से बदलता है।

इंस्टॉल विधियाँ

macOS / Linux

curl -fsSL https://archcore.ai/install.sh | bash

Windows

irm https://archcore.ai/install.ps1 | iex

archcore.exe को %LOCALAPPDATA%\Programs\archcore के अंतर्गत इंस्टॉल करता है और इसे आपके उपयोगकर्ता PATH में जोड़ता है। इंस्टॉल के बाद एक नई PowerShell विंडो खोलें।

Windows (WSL)

WSL इंस्टॉल करें, फिर उसके अंदर macOS/Linux स्क्रिप्ट चलाएँ।

Go install

go install github.com/archcore-ai/cli@latest

स्रोत से

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

समर्थित प्लेटफ़ॉर्म: macOS, Linux, Windows — amd64 और arm64।

पर्यावरण चरों (ARCHCORE_VERSION, ARCHCORE_INSTALL_DIR, GITHUB_TOKEN) और PATH समस्या निवारण के लिए, पूर्ण इंस्टॉल गाइड देखें।

कॉन्फ़िगरेशन

सेटिंग्स .archcore/settings.json में रहती हैं, जो archcore init द्वारा बनाई जाती हैं।

फ़ील्ड	विवरण	मान
`sync`	सिंक मोड। क्लाउड और ऑन-प्रिमाइस जल्द ही उपलब्ध होंगे।	`none` (केवल स्थानीय), `cloud`, `on-prem`
`language`	दस्तावेज़ भाषा। एजेंट को सही भाषा में दस्तावेज़ बनाने में मदद करता है।	स्ट्रिंग, डिफ़ॉल्ट `en`

archcore config                    # show all settings
archcore config get <key>          # get a specific value
archcore config set <key> <value>  # set a value

इकोसिस्टम

Archcore Plugin — Claude Code या Cursor का उपयोग कर रहे हैं? प्लगइन CLI के साथ जुड़ता है: समान इंजन, साथ ही कौशल, इंटेंट कमांड और गार्डरेल। एक उत्पाद, दो प्रवेश बिंदु — CLI अपने आप ही हर अन्य एजेंट को कवर करता है।
docs.archcore.ai — पूर्ण दस्तावेज़ीकरण।
इस रिपॉजिटरी में .archcore/ — एक जीवंत उदाहरण: CLI अपने स्वयं के संदर्भ परत के साथ बनाया गया है।

विकास

Go 1.25+ आवश्यक है।

go build -o archcore .   # build
go test ./...            # run all tests

लिंक और लाइसेंस

दस्तावेज़ीकरण: docs.archcore.ai
वेबसाइट: archcore.ai
प्लगइन (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
समस्याएं: github.com/archcore-ai/cli/issues
लाइसेंस: Apache 2.0