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

Touchstone ان تنہا ڈویلپرز کے لیے ایک بنیادی ڈھانچہ قائم کرتا ہے جو متعدد GitHub پروجیکٹس میں کئی AI ایجنٹس کی رہنمائی کر رہے ہیں۔ یہ دو بنیادی اجزاء فراہم کرتا ہے: گائیڈنس پرامپٹس جو ایجنٹس کو ورک فلو کے معیارات (پہلے برانچنگ، سنگل-کنسرن کمٹس، لازمی فائنڈنگ ریزولوشن، اور گیٹ کمپلائنس) کی ہدایت دیتے ہیں، اور پش ٹولنگ (ایک CLI جو GitHub کے درست استعمال کے نمونوں کو نافذ کرتا ہے)۔ یہ سسٹم 'سیٹ-اینڈ-فورگیٹ' اپنائے جانے کے ذریعے ڈویلپمنٹ فلو کو معیاری بناتا ہے، جہاں ریپوزٹریز مزید مداخلت کے بغیر درست رہتی ہیں۔ CLI اعلان کردہ پروجیکٹ چیکس کی توثیق کرتا ہے، ٹریکر دعوؤں کی تصدیق کرتا ہے، GitHub پالیسی لاگو کرتا ہے، اور چار محدود PR آپریشنز (open, status, merge, answer) فراہم کرتا ہے۔ یہ واضح طور پر کوڈ کو اسٹیج، کمٹ یا پش نہیں کرتا، اور کبھی بھی GitHub کے مرج فیصلے کی جگہ نہیں لیتا۔ ہر آپریشن میں دستاویزی raw git/gh ریکوری راستے شامل ہوتے ہیں۔ Touchstone تین اصولوں پر کام کرتا ہے: GitHub رولز کے ذریعے ڈیفالٹ برانچ تک ڈیلیوری کو محدود کرنا (براہ راست/زبردستی/غیر جائزہ شدہ پشز کو مسترد کرنا)، نیٹیو GitHub سطحوں (git, PRs, issues) کے ذریعے اسٹیٹ کو واضح بنانا، اور تمام پروجیکٹس اور ایجنٹس میں مستقل قوانین برقرار رکھنا۔ ایک کلیدی آپریٹنگ رول یہ ہے کہ نفاذ اس لیئر پر ہونا چاہیے جو حقیقت میں اسے نافذ کر سکے (GitHub رول سیٹس/لازمی چیکس کو سنبھالتا ہے، جبکہ اسکرپٹس صرف مشاہدہ اور ترتیب دیتے ہیں)۔ مرج گیٹ ایک exact-head فیصلہ نظام نافذ کرتا ہے: ریویو-گیٹ ورک فلو صرف موجودہ PR ہیڈ سے منسلک ایک قابل اعتماد کلین فیصلے کے لیے کامیاب ہوتا ہے۔ انسٹالیشن Homebrew (macOS) یا پلیٹ فارم سے آزاد ریلیز اسکرپٹس کے ذریعے ہوتی ہے۔ اسے اپنانے میں پروجیکٹ حقائق کا اعلان کرنا اور دستاویزی کمانڈز کے ذریعے آڈٹ شدہ GitHub پالیسی لاگو کرنا شامل ہے۔