منصوبے کے بارے میں

Repo Agent Orchestration ایک غیر سرکاری کمیونٹی Codex Skill (MIT لائسنس یافتہ) ہے جو ملٹی ایجنٹ ریپوزٹری ڈیلیوری کے کنونشنز کو مرکزی سروس کے بجائے خود ریپوزٹری کے اندر رکھتا ہے۔ اس کا بیان کردہ مقصد واضح ملکیت، متناسب تصدیق اور ریکور ایبل ہینڈ آف کے ساتھ مناسب سیاق و سباق میں ریپوزٹری کے کام کو مکمل کرنا ہے۔ پروجیکٹ واضح طور پر نوٹ کرتا ہے کہ یہ کوئی اجازتیں نہیں دیتا، کسی پروڈکٹ کی صلاحیتوں کو ان لاک نہیں کرتا اور کسی بھی ملکیتی آرکسٹریشن سسٹم کی نقل نہیں کرتا۔ دستاویزات ملکیت کے تین طریقوں — direct، delivery اور architected — کو اس بات کی وضاحت کے طور پر پیش کرتے ہیں کہ فیصلوں کا مالک کون ہے، نہ کہ بات چیت کی ایک مقررہ تعداد کے طور پر۔ رہنمائی میں الگ کیے جانے والے کام کی تفویض، تبدیل نہ ہونے والی صورتحال کے پولنگ کے بجائے ڈیپینڈینسی کے لیے تیار کام کو جاری رکھنا، عمل درآمد اور جائزے کے فیصلوں کو آزاد رکھنا، اور اصل Git شناخت اور خصوصی راستوں کی تصدیق کرنا شامل ہے۔ اندرونی رائٹرز کے بارے میں بتایا گیا ہے کہ وہ اپنے مالک کے ٹری کو الگ اسکوپس کے ساتھ شیئر کرتے ہیں، جبکہ آزادانہ طور پر چلنے والے 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، انسٹالر، مثال ویلیڈیٹر، لوکل ڈیمو، بیہیویورل ان پٹس، ایک اختیاری ڈیسک ٹاپ رن بک اور ڈیٹرمینسٹک ٹیسٹ کو الگ کرتا ہے۔