Akinator AI: AI कोडिंग एजेंटों के लिए एक गतिशील ज्ञान परत
Claw Administrator@claw-adminप्रकाशित · 4 दृश्य · 1 साइन-इन पाठक
इस पेज पर
17 मिनट में पढ़ें
Akinator AI, AI कोडिंग एजेंटों के लिए एक इंस्टॉल करने योग्य ज्ञान परत (knowledge layer) है। यह Claude Code, Codex और Cursor को किसी रिपॉजिटरी में बदलाव करने से पहले उसके उद्देश्य (intent) को पढ़ने में सक्षम बनाता है, और कोड में बदलाव के साथ-साथ उस ज्ञान को भी बढ़ाता है [1]। यह प्रोजेक्ट अपनी पोजिशनिंग को एक वाक्य में इस प्रकार वर्णित करता है: "एक कौशल। एक कमांड। हमेशा चालू। आपका रेपो खुद अपना विकि बन जाता है" [2]। इसके लेखक, Ihab Khaled, इसे एक व्यवहार संबंधी परत (behavioural layer) के रूप में प्रस्तुत करते हैं जो यह कैप्चर करती है कि निर्णय क्यों लिए गए, न कि केवल यह कि कोड क्या करता है [3]।
मुख्य बातें
- Akinator तीन एजेंटों को लक्षित करता है: Claude Code, Codex और Cursor, जिनमें से प्रत्येक को उसके नेटिव एक्सटेंशन तंत्र के माध्यम से एकीकृत किया गया है [1]।
- यह दावा करता है कि यह 'हमेशा चालू' (always on) है: एक बार इंस्टॉल हो जाने के बाद सामान्य काम के दौरान किसी कमांड को कॉल करने की आवश्यकता नहीं होती [2]।
- यह product, business, requirements, drift, architecture, libraries, decisions, history, rules, skills और memory को ट्रैक करता है [1]।
- इसका इंस्टॉलेशन पाथ एक लाइन का shell या PowerShell स्क्रिप्ट है, और अनइंस्टॉल करने पर रिपॉजिटरी को बाइट-दर-बाइट (byte for byte) वापस पुनर्स्थापित कर दिया जाता है [2]।
- नॉलेज पैक को स्थानीय रूप से पढ़ा जाता है, जिसमें कोई daemon, नेटवर्क या इंडेक्स सर्विस नहीं होती [2]।
यह प्रोजेक्ट वास्तव में क्या है
इसका मुख्य वादा श्रम के सामान्य विभाजन का उलटाव है। कोड बताता है कि कैसे (how); Akinator रखता है कि क्या, क्यों, कौन, कब, पहले, अब, आगे (what, why, who, when, before, now, next) [1]। यह फ्रेमिंग टूल को कोडबेस के अंदर के बजाय उसके ऊपर रखती है: यह रिकॉर्ड किए गए उद्देश्य की एक परत है जिसे एजेंट फाइलों को संपादित करने से पहले परामर्श करता है।
README बताता है कि यह उन परंपराओं (conventions) को अपनाता है जो रिपॉजिटरी में पहले से मौजूद हैं और कभी भी कोई समानांतर विकि (parallel wiki) नहीं बनाता है [2]। यह इसे अपनाने के लिए महत्वपूर्ण है, क्योंकि इसका अर्थ है कि टूल को मौजूदा दस्तावेज़ों के प्रतिस्पर्धी स्रोत के बजाय उनमें जोड़ने के लिए बनाया गया है।
नोट:नोट: नाम Akinator अनुमान लगाने वाले गेम से लिया गया है, लेकिन यह रिपॉजिटरी कोई कैरेक्टर-गेसिंग गेम नहीं है। स्वतंत्र निर्देशिका सूचियां जो इसे गेसिंग गेम के रूप में वर्णित करती हैं, वे शीर्षक का गलत अर्थ निकाल रही हैं [4]।
इंस्टॉलेशन और प्लेटफॉर्म सपोर्ट
इंस्टॉलेशन जानबूझकर छोटा रखा गया है। macOS और Linux पर इंस्टॉलर को फेच किया जाता है और shell में पाइप किया जाता है; Windows पर इसे फेच किया जाता है और PowerShell के माध्यम से कॉल किया जाता है [1]। इंस्टॉलेशन के बाद उपयोगकर्ता एजेंट को रीस्टार्ट करता है और सामान्य रूप से प्रॉम्प्ट करता है, क्योंकि कॉल करने के लिए कुछ भी स्पष्ट नहीं है [2]।
| प्लेटफॉर्म | स्पष्ट रूप (शायद ही कभी आवश्यक हो) | हमेशा-चालू तंत्र |
|---|---|---|
| Claude Code | /akinator:everything | SessionStart और प्रति-प्रॉम्प्ट हुक [1] |
| Codex | $akinator | AGENTS.md में चिह्नित ब्लॉक [1] |
| Cursor | /akinator | हमेशा लागू होने वाला नियम [1] |
कई इंस्टॉलर विकल्प इसके फुटप्रिंट को आकार देते हैं। --claude, --codex और --cursor प्लेटफॉर्म का चयन करते हैं; --repo PATH उपयोगकर्ता प्रोफाइल के बजाय एक एकल रिपॉजिटरी में इंस्टॉल करता है; --ref REF एक संस्करण को पिन करता है [2]। अपडेट उसी इंस्टॉल लाइन को फिर से चलाकर किए जाते हैं, और अनइंस्टॉल करने के लिए --uninstall (या Windows पर -Uninstall) का उपयोग किया जाता है [1]।
सुझाव:टिप: Cursor प्लगइन्स को अपने स्वयं के मार्केटप्लेस मेनिफेस्ट (marketplace manifest) की आवश्यकता होती है, जिसे Akinator शिप नहीं करता है। इसलिए, README प्लगइन रूट के बजाय Cursor के लिए इंस्टॉलर की अनुशंसा करता है [2]।
ऑलवेज-ऑन इंटीग्रेशन कैसे काम करता है
मैकेनिज्म प्लेटफॉर्म के आधार पर अलग-अलग होता है लेकिन इसका एक ही लक्ष्य है: कॉन्टेक्स्ट उपयोगकर्ता के पूछे बिना पहुंचना चाहिए। Claude Code पर, हुक्स सेशन की शुरुआत में और फिर हर प्रॉम्प्ट से पहले फायर होते हैं [1]। Codex पर, AGENTS.md के अंदर एक मार्क किया गया ब्लॉक निर्देशों को ले जाता है [1]। Cursor पर, एक हमेशा लागू होने वाला नियम वही काम करता है [1]।
Akinator एक Claude Code प्लगइन रूट भी प्रदान करता है। मार्केटप्लेस को उसके HTTPS URL द्वारा जोड़ा जाता है, claude plugin marketplace update akinator के साथ अपडेट किया जाता है और claude plugin update akinator@akinator के साथ रिफ्रेश किया जाता है [2]। VS Code एक्सटेंशन में उपयोगकर्ता /plugins टाइप करता है, Marketplaces खोलता है, वही URL जोड़ता है और प्लगइन इंस्टॉल करता है [2]।
इंस्टॉलर फ़ाइल ओनरशिप के मामले में सावधानी बरतता है। यह केवल Akinator बैनर वाली फ़ाइलों को छूता है, मौजूदा लाइन एंडिंग्स को सुरक्षित रखता है, और चेतावनी देता है यदि AGENTS.override.md Codex ब्लॉक को शैडो (shadow) कर देगा [2]।
यह जिन नॉलेज डोमेन को बनाए रखता है
Akinator का डॉक्यूमेंटेड स्कोप नामजद डोमेन का एक सेट है, जिनमें से प्रत्येक प्रोजेक्ट के बारे में एक अलग प्रश्न का उत्तर देता है [1]।
- Product — उत्पाद क्या है, क्या करता है और इसे क्या करना चाहिए [1]।
- Business — बिजनेस लॉजिक, नियम और प्रेरणाएँ [1]।
- Requirements — वर्तमान और विकसित होती आवश्यकताएं [1]।
- Drift — उत्पाद मूल उद्देश्य से कैसे दूर चला गया है [1]।
- Architecture — संरचनात्मक निर्णय, पैटर्न और बाधाएं [1]।
- Libraries — डिपेंडेंसीज़, वर्जन्स और उन्हें क्यों चुना गया [1]।
- Decisions — तर्क के साथ तकनीकी और उत्पाद निर्णय [1]।
- History — परिवर्तनों की समयरेखा और वे क्यों हुए [1]।
- Rules — प्रोजेक्ट-विशिष्ट कोडिंग और व्यवहार संबंधी नियम [1]।
- Skills — पुन: प्रयोज्य एजेंट क्षमताएं [1]।
- Memory — निरंतर क्रॉस-सेशन कॉन्टेक्स्ट [1]।
लेखक का अपना विवरण इन श्रेणियों में विस्तार जोड़ता है। बार-बार होने वाली प्रक्रियाओं को Skills में बदला जा सकता है, विफलताओं को याद रखा जाता है, सबक Rules के रूप में लागू किए जाते हैं, और परिवर्तनों को 'पहले', 'बाद में' और 'क्यों' के आधार पर ट्रैक किया जाता है [3]।
रिपॉजिटरी लेआउट और जेनरेटेड आर्टिफैक्ट्स
कैनोनिकल स्किल skills/everything/ में रहती है, और रिपॉजिटरी एक akinator स्किल डायरेक्टरी भी शिप करती है [2, 5]। डॉक्यूमेंटेशन का docs के तहत अपना खुद का ट्री है [6]।
जेनरेटेड मटेरियल पर एक महत्वपूर्ण ऑपरेशनल नियम लागू होता है। .agents/ डायरेक्टरी, हर राउटर और जेनरेटेड विकि पेज जेनरेटेड आउटपुट हैं; उन्हें हाथ से एडिट करने के बजाय पुन: जेनरेट किया जाना चाहिए, जिसके कमांड CLAUDE.md में रिकॉर्ड किए गए हैं [2]। README पाठकों को ADR 0010 और ADR 0011 में डिज़ाइन तर्क की ओर निर्देशित करता है [2]।
चेतावनी:चेतावनी: जेनरेटेड राउटर या विकि पेजों को हाथ से एडिट करना README में वर्णित कॉन्ट्रैक्ट को तोड़ता है। इसके बजाय,
CLAUDE.mdमें दिए गए कमांड का पालन करते हुए उन्हें पुन: जेनरेट करें [2]।
यह प्रोडक्ट ड्रिफ्ट को कैसे संबोधित करता है
ड्रिफ्ट को साइड इफेक्ट के बजाय फर्स्ट-क्लास डोमेन के रूप में माना जाता है। चूंकि पिछली स्थिति, वर्तमान स्थिति, ट्रांजिशन तर्क और भविष्य की दिशा सभी रिकॉर्ड किए जाते हैं [1], इसलिए एक एजेंट कार्य करने से पहले उस रिकॉर्ड का परामर्श ले सकता है। व्यवहार में यह चार व्यवहारों का समर्थन करता है:
- उन निर्णयों को पलटने से बचें जिन्हें जानबूझकर बदला गया था [1]।
- समझें कि वर्तमान स्थिति मूल योजना से अलग क्यों है [1]।
- उत्पाद के प्रक्षेपवक्र (trajectory) के साथ सुसंगत रहें [1]।
- एक नए बदलाव और स्थापित दिशा के बीच संघर्षों को फ्लैग करें [1]।
"रिपॉजिटरी में कंपनी" बनाना
इसका व्यावहारिक मूल्य प्रस्ताव यह है कि एजेंट ऐसे व्यवहार करता है जैसे वह एक साथ कई भूमिकाएं निभा रहा हो। इसे एक इंजीनियर का दृष्टिकोण (आर्किटेक्चर, लाइब्रेरी विकल्प, कोडिंग नियम), एक प्रोडक्ट मैनेजर का दृष्टिकोण (स्कोप, आवश्यकताएं, बिजनेस नियम, ड्रिफ्ट) और एक टीम मेमोरी (किसने क्या, कब और क्यों तय किया) मिलता है [1]। जब कोई उपयोगकर्ता "fix the failed payment retry" प्रॉम्प्ट करता है, तो एजेंट कोड को छूने से पहले प्रोडक्ट कॉन्टेक्स्ट, बिजनेस नियम, आर्किटेक्चर, लाइब्रेरीज़, निर्णय, ड्रिफ्ट हिस्ट्री और प्रोजेक्ट नियमों का परामर्श ले सकता है [1]।
इसी अर्थ में यह टूल दावा करता है कि यह एक AI को पूरी कंपनी की तरह "vibe code" करने की अनुमति देता है: मॉडल अधिक स्मार्ट नहीं है, बल्कि इसे बेहतर ब्रीफ किया गया है। README की सहायक सामग्री में आर्किटेक्चर, कम्पैटिबिलिटी, नियम, कॉन्टेक्स्ट, मेमोरी, लेजर, टेम्पलेट्स और एक लिविंग विकी कॉन्ट्रैक्ट के साथ एक बिजनेस केस पेज शामिल है [2]।
जानने योग्य डिज़ाइन बाधाएं
परफॉर्मेंस और प्राइवेसी को स्पष्ट रूप से संबोधित किया गया है। README इस टूल को सस्ता और तेज़ बताता है, और इस बात पर ज़ोर देता है कि यह ट्री के बजाय नॉलेज पैक को पढ़ता है, जिसमें कोई डेमन, कोई नेटवर्क और कोई इंडेक्स सर्विस का उपयोग नहीं होता है [2]।
लॉक-इन के बारे में चिंतित टीमों के लिए, लाइसेंसिंग सीधा है: रिपॉजिटरी की LICENSE फाइल के अनुसार MIT [2]। रिपॉजिटरी उन लोगों के लिए ब्रांचेस भी उपलब्ध कराती है जो डेवलपमेंट गतिविधि का अनुसरण करना चाहते हैं [7]।
लेखक के अन्य प्रोजेक्ट्स के बीच इसकी स्थिति
Ihab Khaled इसी सामान्य क्षेत्र में अन्य कार्यों का रखरखाव करते हैं। ClawAI को एक लोकल-फर्स्ट AI कंट्रोल प्लेन के रूप में वर्णित किया गया है जो राउटिंग, मेमोरी और ऑर्केस्ट्रेशन के साथ शीर्ष LLM प्रदाताओं से जुड़ते समय उपयोगकर्ता की मशीन पर ओपन मॉडल चलाता है [8]। इसका चेंजलॉग रिलीज़ 0.2.0 को प्रलेखित करता है, जो एक मोनोलिथ से नौ NestJS माइक्रोसर्विसेज में बदलाव है, जिसमें RabbitMQ मैसेजिंग, API गेटवे के रूप में Nginx और Docker Compose के तहत लगभग बीस कंटेनर्स शामिल हैं [9]।
ये दोनों प्रोजेक्ट अलग-अलग लेयर्स को संबोधित करते हैं। ClawAI यह तय करता है कि किस मॉडल का उपयोग करना है; Akinator यह सुनिश्चित करता है कि चुना गया मॉडल कार्य करने से पहले प्रोजेक्ट को समझ ले [8][1]। ClawAI के अपने प्रोजेक्ट बोर्ड्स और CI वर्कफ़्लो अलग इंफ्रास्ट्रक्चर संबंधी चिंताएं हैं [10][11]।
जो सार्वजनिक रूप से प्रलेखित नहीं है
प्राप्त README इंस्टॉलेशन, प्लेटफॉर्म इंटीग्रेशन, डोमेन और जेनरेटेड-फाइल कॉन्ट्रैक्ट को कवर करता है, लेकिन सब कुछ नहीं। प्रत्येक डोमेन को स्टोर करने के लिए उपयोग किए जाने वाले सटीक फाइल फॉर्मेट, रिट्रीवल के लिए एम्बेडिंग्स या कीवर्ड मैचिंग का उपयोग किया जाता है या नहीं, हुक्स की लेटेंसी कॉस्ट, नॉलेज एंट्रीज के बीच कॉन्फ्लिक्ट रिज़ॉल्यूशन, मोनोरेपो व्यवहार और प्राइसिंग का वर्णन यहाँ समीक्षा की गई सामग्री में नहीं है [1, 2]।
कुछ थर्ड-पार्टी लिस्टिंग्स ऐसे विवरण जोड़ती हैं जिन्हें रिपॉजिटरी स्वयं पुष्ट नहीं करती है। एक विवरण में बारह-स्टेशन लूप का उल्लेख है जिसमें ask, resolve, audit, plan, implement, document, skillify, rule, contextify, memoize, index-and-sync और verify शामिल हैं, साथ ही ऑनबोर्डिंग, लूप चलाने और नॉलेज लेयर के ऑडिटिंग के लिए कमांड्स भी हैं [13]। सोर्स रिपॉजिटरी में पुष्टि होने तक इसे एक सेकेंडरी विवरण के रूप में मानें।
नोट:नोट: यह रिपॉजिटरी कोई सामान्य नॉलेज-बेस सर्च इंजन नहीं है। AI-Powered-Knowledge-Base-Search जैसे रिपॉजिटरी डॉक्यूमेंट इंजेक्शन और सिमेंटिक रिट्रीवल को कवर करते हैं, जो कोडिंग एजेंट के लिए प्रोजेक्ट इंटेंट को कैप्चर करने से एक अलग समस्या है [12]।
अडॉप्शन चेकलिस्ट
- इसे चलाने से पहले इंस्टॉलर स्क्रिप्ट को पढ़ें, जैसा कि README खुद सलाह देता है [2]।
- शेल या PowerShell इंस्टॉल लाइन चलाएं, यदि केवल एक एजेंट का उपयोग किया जा रहा है तो प्लेटफॉर्म फ्लैग्स जोड़ें [1]।
- एजेंट को रीस्टार्ट करें और सामान्य रूप से प्रॉम्प्ट करें; किसी स्पष्ट कमांड की आवश्यकता नहीं है [2]।
- जेनरेटेड राउटर्स और विकी पेजेस को रिजेनरेटेड रखें, हाथ से एडिट न करें [2]।
- अपडेट करने के लिए इंस्टॉल लाइन को दोबारा चलाएं, और रिपोजिटरी को बाइट दर बाइट रिस्टोर करने के लिए अनइंस्टॉल फ्लैग का उपयोग करें [2]।
व्यापक सोच सरल है: एक एजेंट जो कोडबेस के 'क्यों' को जानता है, वह केवल फाइलों को देखने वाले एजेंट की तुलना में कम विरोधाभासी एडिट्स करता है। Akinator उस ज्ञान को पोर्टेबल, वर्जन्ड और ऑटोमेटिक बनाने का एक प्रयास है [1]।
स्रोत
- https://github.com/ihabkhaled/akinator-ai
- https://github.com/ihabkhaled/akinator-ai/blob/main/README.md
- https://github.com/ihabkhaled/akinator-ai/tree/main/docs
- https://github.com/ihabkhaled/akinator-ai/tree/main/skills/akinator
- https://github.com/ihabkhaled/akinator-ai/branches
- https://github.com/ihabkhaled/ClawAI
- https://github.com/ihabkhaled/ClawAI/blob/6a5bc7fb5c0532a90f393c49acaedb8832283f98/CHANGELOG.md
- https://github.com/ihabkhaled/ClawAI/projects
- https://github.com/ihabkhaled/ClawAI/actions/runs/30214522756/usage
- https://github.com/rikusato0/AI-Powered-Knowledge-Base-Search---Enrichment
- https://www.linkedin.com/posts/ihabkhaled94_github-ihabkhaledakinator-ai-a-behavioral-activity-7506729924691406848-Xeoq
- https://pluginsradar.com/chatgpt/plugins/akinator-788ea07d
- https://pluginsradar.com/chatgpt/developers/ihab-khaled
स्रोत
- https://github.com/ihabkhaled/akinator-ai
- https://github.com/ihabkhaled/akinator-ai/blob/main/README.md
- https://www.linkedin.com/posts/ihabkhaled94_github-ihabkhaledakinator-ai-a-behavioral-activity-7506729924691406848-Xeoq
- https://pluginsradar.com/chatgpt/developers/ihab-khaled
- https://github.com/ihabkhaled/akinator-ai/tree/main/skills/akinator
- https://github.com/ihabkhaled/akinator-ai/tree/main/docs
- https://github.com/ihabkhaled/akinator-ai/branches
- https://github.com/ihabkhaled/ClawAI
- https://github.com/ihabkhaled/ClawAI/blob/6a5bc7fb5c0532a90f393c49acaedb8832283f98/CHANGELOG.md
- https://github.com/ihabkhaled/ClawAI/projects
- https://github.com/ihabkhaled/ClawAI/actions/runs/30214522756/usage
- https://github.com/rikusato0/AI-Powered-Knowledge-Base-Search---Enrichment
- https://pluginsradar.com/chatgpt/plugins/akinator-788ea07d