AWR क्या है

GitHub पर स्रोत देखें

AWR लोगों और AI के लिए एक ओपन-सोर्स प्रोजेक्ट डिलीवरी प्लेटफ़ॉर्म है। यह लक्ष्यों, वर्कस्ट्रीम (workstreams), निर्भरताओं, कॉन्टेक्स्ट और स्वीकृति (acceptance) को एक ही प्रोजेक्ट डिलीवरी वर्कफ़्लो में जोड़ता है, ताकि कोई प्रोजेक्ट सहमत लक्ष्य से सत्यापित डिलीवरी तक पहुँच सके — भले ही काम कई एजेंटों, सत्रों (sessions) और सहयोगियों के बीच बँटा हो।

AWR दो ऐसी स्थितियों के लिए बना है जिनकी जड़ में एक ही समस्या है:

  • कई एजेंटों का समन्वय करता एक व्यक्ति, किसी जटिल प्रोजेक्ट पर।
  • एक साझा प्रोजेक्ट डिलीवर करती टीम, जिसकी शुरुआत जटिल सॉफ़्टवेयर प्रोजेक्टों से होती है।

दोनों मामलों में, लोग दिशा तय करते हैं और परिणामों की समीक्षा करते हैं; काम एजेंट करते हैं। AWR अपनी CLI और MCP सेवा के माध्यम से उनके काम को उसी प्रोजेक्ट स्थिति से जोड़ता है।

AWR कौन सी समस्या हल करता है

जब आप AI कोडिंग एजेंटों के साथ काम करते हैं, तो प्रोजेक्ट का ज्ञान आम तौर पर एजेंट के निजी वार्तालाप में रहता है। जब सत्र समाप्त होता है, मॉडल बदलता है, या कोई दूसरा व्यक्ति या एजेंट काम संभालता है, तो वह कॉन्टेक्स्ट खो जाता है। समानांतर प्रयास एक-दूसरे से भटक जाते हैं, और "पूर्ण" का अर्थ वह हो जाता है जो आखिरी एजेंट ने कह दिया।

AWR इस बात को ध्यान में रखकर डिज़ाइन किया गया है कि असल में क्या होना चाहिए:

  • सत्र, मॉडल या सहयोगी बदलने पर भी प्रोजेक्ट बना रहता है। लक्ष्य, बाधाएँ और सत्यापित प्रगति हैंडऑफ़ (handoff) के बाद भी जीवित रहते हैं। उत्तराधिकारी को मौजूदा कार्य का आवश्यक कॉन्टेक्स्ट और उसका चेकपॉइंट (checkpoint) मिलता है, ताकि प्रोजेक्ट सत्रों और एजेंटों के पार जारी रह सके।
  • समानांतर काम का स्पष्ट स्वामित्व और हैंडऑफ़ होता है। स्वतंत्र वर्कस्ट्रीम (जैसे फ्रंटएंड, बैकएंड और टेस्टिंग) प्रोजेक्ट की बाधाएँ साझा करते हुए अपने कार्य, कॉन्टेक्स्ट और स्वामित्व अलग रखती हैं।
  • "पूर्ण" सत्यापन योग्य है। पूर्णता के दावे संस्करण-बंधे (version-bound) साक्ष्य से जुड़ते हैं। कार्यान्वयन, सत्यापन, मर्ज और रिलीज़ को एक ही दावे में मिलाए बिना अलग-अलग तथ्यों के रूप में ट्रैक किया जाता है।
  • प्रयास दिखाई देता है। हर चरण पर आप बता सकते हैं कि क्या तैयार है, क्या प्रतीक्षा में है, क्या सत्यापित हो चुका है, और प्रयास कहाँ गया।

संक्षेप में: AWR सीमित कॉन्टेक्स्ट विंडो के पार प्रोजेक्ट की निरंतरता सुरक्षित रखता है। किसी एजेंट की कॉन्टेक्स्ट विंडो सीमित होती है, और कम्पैक्शन (जब कोई होस्ट वार्तालाप को छोटा करके फ़िट करता है) होस्ट का काम है — इसके बजाय AWR के चेकपॉइंट दर्ज किए गए प्रोजेक्ट तथ्यों को आगे ले जाते हैं।

यह कैसे काम करता है: आपकी फ़ाइलें ही सत्य का स्रोत (source of truth) रहती हैं

AWR की आर्किटेक्चर के तीन भाग हैं:

  1. आपकी फ़ाइलों में आशय (intent) रहता है। आपके प्रोजेक्ट की Markdown और YAML फ़ाइलें लक्ष्यों, योजनाओं, काम, बाधाओं और निर्णयों का वर्णन करती हैं। AWR इन स्रोतों को बिना चुपचाप बदले इंडेक्स करता है।
  2. AWR निरंतरता बनाए रखता है। लोकल स्टेट (एक SQLite प्रोजेक्ट) उन स्रोतों के प्रोजेक्शन के साथ सत्र, क्लेम (claims), चेकपॉइंट और साक्ष्य रखता है। कॉन्टेक्स्ट कम्पाइलेशन — मौजूदा कार्य के लिए संबंधित लक्ष्यों, नियमों, निर्भरताओं और साक्ष्य को एकत्र करना — लोकल रूप से चलता है और कोई मॉडल कॉल नहीं करता। रिवीज़न जाँचें लिखने की क्रिया को पुरानी स्थिति से बचाती हैं।
  3. लोग और एजेंट काम करते हैं। CLI और MCP सेवा प्रोजेक्ट तथ्यों को आपके इस्तेमाल किए जा रहे किसी भी होस्ट से जोड़ती है। एजेंट अपने मॉडल, टूल और वार्तालाप स्वयं लाते हैं; समीक्षा किए गए बदलाव और प्रगति प्रोजेक्ट स्रोतों में लौटते हैं।

चूँकि दर्ज चेकपॉइंट केवल दर्ज तथ्यों को ले जाते हैं, वे किसी एजेंट के अदर्ज वार्तालाप इतिहास को पुनः नहीं बनाते — वह होस्ट की ज़िम्मेदारी बनी रहती है।

हिस्से और वे एक-दूसरे से कैसे जुड़ते हैं

आप AWR से दो एंट्री पॉइंट के माध्यम से जुड़ते हैं, दोनों एक ही पैकेज से इंस्टॉल होते हैं:

  • awr CLI — प्रोजेक्ट इनिशियलाइज़ करती है, स्थिति दिखाती है, और स्पष्ट सत्र वर्कफ़्लो चलाती है: काम का एक हिस्सा क्लेम करें, उसका केंद्रित कॉन्टेक्स्ट पाएँ, और रुकने से पहले चेकपॉइंट सहेजें। कोई भी एजेंट जो शेल कमांड चला सकता है, इसका उपयोग कर सकता है।
  • awr-mcp MCP सेवा — वही प्रोजेक्ट स्थिति MCP टूल के रूप में प्रस्तुत करती है (MCP, यानी Model Context Protocol, वह तरीका है जिससे AI क्लाइंट बाहरी टूल कॉल करते हैं)। कोई क्लाइंट या तो stdio के ज़रिए एक प्रोजेक्ट से जुड़ता है, या एक साझा HTTP MCP सेवा से, जो कई क्लाइंटों और प्रोजेक्टों को सेवा देती है।

इनके ऊपर, AWR उस एजेंट का समर्थन करता है जिसके साथ आप पहले से काम करते हैं। इंटीग्रेशन परतों में आते हैं:

  • जेनेरिक कॉन्ट्रैक्ट (डिफ़ॉल्ट, पूर्ण समर्थित)। कोई भी होस्ट जो CLI चला सके या MCP बोल सके, साझा सत्र वर्कफ़्लो के माध्यम से वही प्रोजेक्ट स्थिति उपयोग करता है। इसमें Claude Code, Cursor, Windsurf और इसी तरह के होस्ट शामिल हैं — किसी विशेष इंस्टॉलर की ज़रूरत नहीं।
  • होस्ट नोट्स। कुछ होस्ट (Cursor, Kimi Code, Grok Build) के लिए AWR सटीक कॉन्फ़िगरेशन मर्ज पथ और नेटिव सत्र फ़्लैग दर्ज करता है, जिन्हें किसी दिनांकित होस्ट संस्करण के साथ सत्यापित किया गया है। ये नोट्स कोई रनटाइम फ़ीचर नहीं जोड़ते।
  • वैकल्पिक लाइफ़साइकिल एडाप्टर। जहाँ किसी होस्ट के नेटिव लाइफ़साइकिल हुक स्थिर हों, वहाँ एक एडाप्टर होस्ट इवेंट से AWR चेकपॉइंट चला सकता है। आज यह Codex के लिए मौजूद है। कोई एडाप्टर AWR को उस होस्ट का रनटाइम कभी नहीं बनाता।

कई एजेंटों का समन्वय करने वाले व्यक्ति के लिए वही निर्भरता, समीक्षा और लेखांकन अनुशासन लागू होता है जो किसी बड़ी टीम के लिए होता है — यह एक ही प्रोजेक्ट मॉडल है, दो प्रोडक्ट नहीं।

AWR क्या नहीं है

AWR जानबूझकर सीमित दायरे में है। यह एक होस्ट-अज्ञेयवादी वर्क रनटाइम है, और इसकी प्रोडक्ट सीमा साझा CLI/MCP कॉन्ट्रैक्ट है — कोई एक एडिटर या एजेंट नहीं।

  • AWR एक AI एजेंट नहीं है। यह कोई कोडिंग एजेंट चुनता, शुरू या कॉन्फ़िगर नहीं करता। एजेंट अपने मॉडल, टूल और वार्तालाप स्वयं लाते हैं; AWR द्वारा संग्रहित प्रोवाइडर और मॉडल स्ट्रिंग केवल प्रदर्शन लेबल हैं।
  • AWR कोई एडिटर, चैट UI या मॉडल प्रोवाइडर नहीं है। एजेंट का UI, नेटिव वार्तालाप ID और कम्पैक्शन होस्ट के हैं।
  • AWR आपकी प्रोजेक्ट फ़ाइलों की जगह नहीं लेता। Markdown/YAML स्रोत आधिकारिक रहते हैं; AWR की लोकल स्टेट एक इंडेक्स के साथ निरंतरता रिकॉर्ड है, और इसे आपके स्रोतों को चुपचाप बदलना नहीं चाहिए।
  • AWR किसी एक ट्रांसपोर्ट से बँधा नहीं है। MCP stdio पर चले, HTTP पर चले या अनुपस्थित हो — यह होस्ट की पसंद है; यदि किसी होस्ट में नेटिव हुक नहीं हैं, तो आप CLI के माध्यम से मैन्युअल रूप से चेकपॉइंट करते हैं।
  • AWR वर्कस्ट्रीम को भौतिक रूप से अलग नहीं करता। वर्कस्ट्रीम आइसोलेशन प्रोजेक्ट स्थिति और समर्थित ऑपरेशन तक सीमित है; भौतिक प्रोसेस आइसोलेशन निष्पादन होस्ट पर निर्भर करता है।

वर्तमान दायरा: प्रकाशित रिलीज़ बनाम विकास

AWR इस बात को लेकर ईमानदार है कि क्या शिप हुआ है और क्या बनाया जा रहा है। प्रकाशित 0.5.1 CLI/MCP पैकेज देते हैं:

  • स्रोत-समर्थित लक्ष्य और कार्य, निर्भरता नेविगेशन के साथ
  • मौजूदा कार्य के लिए केंद्रित कॉन्टेक्स्ट कम्पाइलेशन
  • सत्र क्लेम और चेकपॉइंट
  • संस्करण-बंधे साक्ष्य
  • कई क्लाइंटों और प्रोजेक्टों के लिए एक साझा HTTP MCP सेवा
  • Personal Workspace फ़ाइल एक्सचेंज
  • एक निजी वर्कस्ट्रीम नींव: स्पष्ट स्रोत स्वामित्व, सत्र एट्रिब्यूशन और लोकल SQLite प्रोजेक्ट में स्कोप्ड कॉन्टेक्स्ट

यह रिलीज़ प्रमाणित (authenticated) Team सेवा या पूर्ण मल्टी-क्लाइंट आइसोलेशन नहीं देती। main पर अभी विकास में:

  • संस्करणित क्रॉस-वर्कस्ट्रीम डिलीवरी अडॉप्शन (डाउनस्ट्रीम काम को किसी स्वीकृत आर्टिफ़ैक्ट और कॉन्ट्रैक्ट संस्करण से बाँधना; बदलने पर उपभोक्ताओं की पुनः जाँच)
  • टीम सहयोग और डिलीवरी समीक्षा (स्पष्ट समीक्षक और अनुमोदन रिकॉर्ड)
  • वर्कस्ट्रीम उपयोग, समय और ETA लेखांकन

प्रत्येक प्रकाशित संस्करण की रिलीज़ नोट्स वास्तविक पैकेज सीमा को परिभाषित करती हैं।

इसका आपके लिए क्या अर्थ है

यदि आप AWR का मूल्यांकन कर रहे हैं: आप अपना मौजूदा एजेंट और अपनी मौजूदा फ़ाइलें बनाए रखते हैं। आप अपने प्रोजेक्ट में AWR इनिशियलाइज़ करते हैं, अपने एजेंट को एक कार्य-समझौता देते हैं, और उसके बाद हर सत्र दर्ज लक्ष्यों, नियमों, निर्भरताओं और चेकपॉइंट से शुरू होता है — शून्य से नहीं। आप किसी भी समय प्रगति देख सकते हैं।

यदि आप इसे टीम में अपना रहे हैं: वही CLI/MCP नींव साझा डिलीवरी और समीक्षा की ओर बढ़ती है जैसे-जैसे वे क्षमताएँ शिप होती हैं — प्रकाशित रिलीज़ पहले से ही आपको सिंगल-यूज़र और मल्टी-एजेंट कोर देती है।

आगे कहाँ जाएँ

  • Quickstart — AWR इंस्टॉल करें, प्रोजेक्ट जोड़ें, और अपना पहला सत्र चलाएँ।
  • Concepts — प्रोजेक्ट मॉडल विस्तार से: लक्ष्य, वर्कस्ट्रीम, सत्र, क्लेम, चेकपॉइंट और साक्ष्य।
  • CLI और MCP सेवा — दोनों एंट्री पॉइंट गहराई से।
  • एजेंट इंटीग्रेशन — अपने इस्तेमाल किए जा रहे एजेंट को जोड़ें।