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

OpenSpec AI کوڈنگ اسسٹنٹس کے لیے ایک سپیس ڈرائیون ڈویلپمنٹ (SDD) فریم ورک ہے۔ یہ ایک ہلکی پھلکی وضاحتی تہہ شامل کرتا ہے تاکہ انسانی ڈویلپرز اور AI اسسٹنٹس کوڈ لکھنے سے پہلے بنانے والی چیزوں پر متفق ہو سکیں۔ یہ پروجیکٹ npm پیکیج @fission-ai/openspec کے طور پر شائع ہوتا ہے، MIT لائسنس کے تحت لائسنس یافتہ ہے، اور Node.js 20.19.0 یا اس سے اوپر کی ضرورت ہوتی ہے۔ ورک فلو سپورٹ شدہ AI کوڈنگ ٹولز کے اندر سلش کمانڈز کے گرد مرتکز ہے۔ پروجیکٹ میں `openspec init` چلانے کے بعد، صارفین `/opsx:explore` کے ذریعے AI سے خیالات پر بحث کر سکتے ہیں، `/opsx:propose <name>` سے تبدیلی کا پروپوزل بنا سکتے ہیں، `/opsx:apply` سے منصوبہ بند کاموں کو نافذ کر سکتے ہیں، اور `/opsx:archive` سے تبدیلی کو حتمی شکل دے کر محفوظ کر سکتے ہیں۔ ہر تجویز کردہ تبدیلی کے لیے `openspec/changes/` کے تحت ایک الگ فولڈر بنایا جاتا ہے جس میں `proposal.md`، ضروریات اور منظرناموں والا `specs/` فولڈر، `design.md`، اور `tasks.md` شامل ہوتا ہے۔ سپیسز عام مارک ڈاؤن میں لکھی جاتی ہیں جن میں خاص سِنٹیکس کی ضرورت نہیں ہوتی۔ OpenSpec 30 سے زائد AI کوڈنگ اسسٹنٹس اور ٹولز کو سپورٹ کرتا ہے، جہاں ٹول کے مطابق کمانڈ کے اسپیلنگ مختلف ہو سکتی ہے، جیسے `/opsx-propose`، `@opsx-propose`، یا `$openspec-propose`. مزید کمانڈز جیسے `/opsx:new`، `/opsx:continue`، `/opsx:ff`، `/opsx:verify`، اور `/opsx:onboard` شامل کرنے والا ایک توسیع شدہ ورک فلو پروفائل بھی دستیاب ہے۔ اس پروجیکٹ نے 'Stores' نامی بیٹا فیچر متعارف کرایا ہے، جو ٹیم کے درمیان شیئرڈ ریپوزٹری میں git push کے ذریعے منصوبہ بندی کی اجازت دیتا ہے۔ Stores اسی `openspec/` ساخت استعمال کرتے ہیں اور کراس-ریپوزٹری فیچرز، مشترکہ ضروریات، اور 'کوڈ سے پہلے منصوبہ بندی' کے ورک فلو کو سپورٹ کرنے کی کوشش کرتے ہیں۔ OpenSpec نامعلوم استعمال کے اعداد و شمار جمع کرتا ہے، جو صرف کمانڈ کے نام اور ورژن تک محدود ہیں، بغیر کسی آرگومنٹ، پاتھ، مواد یا ذاتی معلومات کے۔ ٹیلی میٹری CI میں خودکار طور پر غیر فعال ہوتی ہے اور کنفیگریشن یا ماحولیاتی متغیرات کے ذریعے آپٹ آؤٹ کیا جا سکتا ہے۔ دستاویزات میں گٹ شروع کرنا، کمانڈز کا طریقہ کار، موجودہ پروجیکٹ اپنانا، تبدیلیوں میں ترمیم، CLI حوالہ، ملٹی لینگویج سپورٹ، کسٹمائزیشن، اور کمیونٹی اسکیما شامل ہیں۔ یہ پروجیکٹ OpenSpec خود کے ساتھ بنایا گیا ہے، اور اس کے ریپوزٹری میں سپیسز اور جاری تبدیلیوں کے لائیو مثالیں موجود ہیں۔