इस प्रोजेक्ट के बारे में

Repo Agent Orchestration एक अनौपचारिक कम्युनिटी Codex Skill (MIT लाइसेंस प्राप्त) है जो मल्टी-एजेंट रिपॉजिटरी डिलीवरी कन्वेंशन को एक केंद्रीय सेवा के बजाय रिपॉजिटरी के भीतर ही रखता है। इसका घोषित लक्ष्य स्पष्ट स्वामित्व, आनुपातिक सत्यापन और रिकवरेबल हैंडऑफ के साथ उचित संदर्भों में रिपॉजिटरी कार्य को पूरा करना है। प्रोजेक्ट स्पष्ट रूप से उल्लेख करता है कि यह कोई अनुमति नहीं देता है, किसी उत्पाद क्षमता को अनलॉक नहीं करता है और किसी भी प्रोप्रायटरी ऑर्केस्ट्रेशन सिस्टम को पुन: पेश नहीं करता है। दस्तावेज़ तीन स्वामित्व मोड — direct, delivery और architected — को इस बात के विवरण के रूप में प्रस्तुत करते हैं कि निर्णयों का स्वामित्व किसके पास है, न कि बातचीत की निश्चित संख्या के रूप में। मार्गदर्शन में अलग किए जा सकने वाले कार्यों को सौंपना, अपरिवर्तित स्थिति की पोलिंग करने के बजाय डिपेंडेंसी-रेडी कार्य को जारी रखना, कार्यान्वयन और समीक्षा निर्णयों को स्वतंत्र रखना, और वास्तविक Git पहचान और एक्सक्लूसिव पाथ्स को सत्यापित करना शामिल है। आंतरिक राइटर्स (Internal writers) को अपने ओनर के ट्री को अलग-अलग स्कोप के साथ साझा करने वाले के रूप में वर्णित किया गया है, जबकि स्वतंत्र रूप से चलने वाले App राइटर्स अलग-अलग पंजीकृत रिपॉजिटरी-लोकल worktrees का उपयोग करते हैं। स्पष्ट उपयोगकर्ता या रिपॉजिटरी आवश्यकताओं द्वारा, या महत्वपूर्ण क्रॉस-कटिंग या अपरिवर्तनीय जोखिम के लिए स्वतंत्र डिज़ाइन समीक्षा आवश्यक है। इंस्टॉलेशन सोर्स चेकआउट से scripts/install_repository.py के माध्यम से किया जाता है जिसे रिपॉजिटरी पाथ की ओर निर्देशित किया जाता है। यह Skill को .agents/skills/repo-agent-orchestration में कॉपी करता है और रिपॉजिटरी के रूट AGENTS.md में एक चिह्नित ब्लॉक को आइडम्पोटेंटली अपडेट करता है, जबकि उस ब्लॉक के बाहर के नियमों को सुरक्षित रखता है। एक --dry-run फ्लैग राइट्स का पूर्वावलोकन करता है, और --check लक्ष्य को संशोधित किए बिना इंस्टॉल की गई फ़ाइल या प्रोफ़ाइल ड्रिफ्ट का पता लगाता है। इंस्टॉलर मुख्य ब्रांच, worktree रूट, ब्रांच प्रीफिक्स, रूट worktree पॉलिसी, टास्क होस्ट पॉलिसी, कंट्रोलर मॉडल पॉलिसी, प्रति-भूमिका मॉडल सेटिंग्स, साझा इंटीग्रेशन पाथ्स, निरंतरता पॉलिसी और बाहरी गेट्स को कवर करने वाले विकल्पों को स्वीकार करता है। मॉडल डिफॉल्ट app_default हैं, जो मॉडल और थिंकिंग ओवरराइड्स को छोड़ देते हैं; अपग्रेड मौजूदा स्पष्ट बाइंडिंग्स को सुरक्षित रखते हैं, सिवाय एक रिटायर इंस्टॉलर डिफॉल्ट के जो वापस app_default पर माइग्रेट हो जाता है। एक वैकल्पिक स्ट्रक्चर्ड एडेप्टर स्पष्ट रूप से अनुरोधित App कार्यों का समर्थन करता है जहाँ होस्ट एक saved-project, लोकल रूट का समर्थन करता है। इसका कंस्ट्रक्टर और वैलिडेटर आठ पैकेट प्रकारों — binding, write, review, update, design_handoff, delivery_update, design_reopen और design_decision — को संभालते हैं, जो एक स्कीमा साझा करते हैं। दस्तावेज़ बताते हैं कि एडेप्टर पाथ कंटेनमेंट, saved-project पहचान, वर्तमान Git ब्रांच और कमिट, रीड-ओनली समीक्षा और संरक्षित रिपोर्ट सेटिंग्स की जाँच करता है, लेकिन यह टास्क ऑथराइजेशन, वास्तविक डिलीवरी, समीक्षा गुणवत्ता या स्वीकृति को साबित नहीं करता है, और यह कि रिपोर्ट का DELIVERY फ़ील्ड एक इच्छित रूट है न कि रसीद। वैलिडेशन Python की स्टैंडर्ड-लाइब्रेरी unittest डिस्कवरी, एक उदाहरण वैलिडेटर और एक लोकल डेमो पर निर्भर करता है, जिसमें CI Python 3.11 और 3.13 को लक्षित करता है; इंस्टॉलर और worktree परीक्षणों के लिए Git आवश्यक है। डेमो एक अस्थायी Git रिपॉजिटरी और अलग राइटर्स ट्री बनाता है और केवल लोकल Git और कॉन्ट्रैक्ट चेक को साबित करता है, न कि App क्रिएशन, मैसेज डिलीवरी, प्रभावी मॉडल या वास्तविक एजेंट व्यवहार को। उन अभ्यासों के लिए बिहेवियरल केस दिए गए हैं जिन्हें स्ट्रिंग असर्शन साबित नहीं कर सकते। क्लीनअप मार्गदर्शन के लिए हर ओन्ड worktree और ब्रांच के लिए एक स्पष्ट निर्णय की आवश्यकता होती है, जो Git के worktree फ्लो के माध्यम से केवल वैलिडेटेड क्लीन, इंटीग्रेटेड या स्पष्ट रूप से छोड़े गए अवशेषों को हटाता है, और सटीक निर्देशांकों के साथ असुरक्षित या उपयोगी अवशेषों को बनाए रखता है; इसमें आयु-आधारित क्लीनअप, रिकवरेबल कार्य का जबरन विलोपन, रिमोट-ब्रांच विलोपन, बैकग्राउंड डेमन या स्वचालित अनुमति वृद्धि शामिल नहीं है। लेआउट इंस्टॉल करने योग्य Skill, इंस्टॉलर, उदाहरण वैलिडेटर, लोकल डेमो, बिहेवियरल इनपुट्स, एक वैकल्पिक डेस्कटॉप रनबुक और नियतात्मक परीक्षणों को अलग करता है।