یہ AI Software Factory کی ریپوزٹری مصنوعات کے مقصد اور کام سے Archon کی بنائی پل ریکویسٹ تک کا راستہ بیان کرتی ہے۔ تنصیب اور ورک فلو کی پڑتال صرف آغاز ہیں۔ منتظم کی پہلے گھنٹے کی رہنمائی کے مطابق حقیقی مکمل عملی توثیق ابھی باقی ہے۔ یہ رہنما فیکٹری کے کمٹ 9e2d85298b45497031009597a6ae0811b66fe6d6 اور اس میں مقررہ Archon ریویژن fad09169ea1b43512bc7ee88470d47f960a3e0f8 کی پیروی کرتا ہے۔ یہ دستاویز اور کوڈ پڑھنے پر مبنی ہے، BIG CHANGE کی تنصیب یا اجرا کی رپورٹ نہیں۔

طریقہ اس ٹیم کے لیے ہے جو ایپ کی ریپوزٹری یا PRD، GitHub اجازتوں اور ماڈل فراہم کنندہ کے اکاؤنٹ کو کنٹرول کرتی ہو۔ نگہبان اپنی ریپوزٹری میں فیکٹری کلون اور نصب کرنے کا طریقہ واضح طور پر بیان کرتا ہے۔ مقررہ فیکٹری کی فائل شاخ میں لائسنس یا نوٹس فائل نہیں؛ یہ رہنمائی وسیع تر دوبارہ استعمال یا تقسیم کے حقوق ثابت نہیں کرتی۔ Archon کا MIT لائسنس الگ Archon ماخذ پر لاگو ہے۔ فراہم کنندہ کے راز کام کے متن، ہدایات، لاگ یا جائزے کے ریکارڈ میں نہ ڈالیں۔

بڑی تبدیلی

  • کیا بدلا: یہ نفاذ مقررہ Archon ورک فلو پیک سے مصنوعات کا دائرہ، کام کی منصوبہ بندی، پروگرامنگ، آزاد جائزہ اور رن ٹائم پڑتال جوڑتا ہے۔ فیکٹری منصوبے کے ان پٹ اور لانچر دیتی ہے؛ مشترک پیک میں AI مراحل ہیں۔
  • کیوں اہم ہے: ٹیم مرج سے پہلے تجویز کو کام سے مخصوص فرق، CI نتیجے اور چلتے امیدوار تک دیکھ سکتی ہے۔ صرف تنصیب کی پڑتال سے یہ زنجیر نامکمل ہے؛ منتظم کے مطابق حقیقی انضمام کی توثیق ابھی باقی ہے۔
  • کیا دیکھیں: پہلا مفید ثبوت حقیقی کام ہے جس کی فراہم کردہ ریویژن بامعنی صارف مراحل اور آزاد الگ جانچ پاس کرے، اور ٹیم خرچ و جائزہ ریکارڈ دیکھ سکے۔ بعد میں بھی شیڈول اور تعیناتی الگ فیصلے ہیں۔

1. ریپوزٹری، اجازتیں اور مقررہ ماخذ جانچیں

منتظم کی ترتیب کی ہدایات میں Git، Python 3.10 یا جدید، تصدیق شدہ gh جس کے پاس workflow دائرہ ہو، GitHub ریموٹ، کوڈنگ ایجنٹ، Bun اور uv درکار ہیں۔ Git کو ورک فلو فائلیں بھی بھیج سکنا چاہیے (gh auth setup-git)۔ ایجنٹ چلانے سے پہلے موجودہ ٹیسٹ، آغاز اور CI کمانڈ، برانچ تحفظ، GitHub رسائی، فراہم کنندہ کی تصدیق اور ماڈل بلنگ دیکھیں۔ صرف مطلوبہ ریپوزٹری اور ورک فلو اختیارات دیں۔

فیکٹری کو ایپ کی ریپوزٹری سے باہر کلون کر کے مقررہ کمٹ منتخب کریں۔ دستاویز کی تنصیبی کمانڈ ایپ کی بنیادی ڈائریکٹری سے چلتی ہے:

Terminal
git clone https://github.com/coleam00/ai-software-factory ~/ai-software-factory
git -C ~/ai-software-factory checkout 9e2d85298b45497031009597a6ae0811b66fe6d6
python ~/ai-software-factory/bin/factory.py init

ضرورت پر python3 استعمال کریں۔ انسٹالر فیکٹری اور منصوبے کے سانچے نقل کرتا اور pack.json میں مقررہ Archon ماخذ نصب کرتا ہے۔ اس کمٹ کے README اور پیک دونوں fad09169ea1b43512bc7ee88470d47f960a3e0f8 بتاتے ہیں۔ انسٹالر فراہم کنندہ کی تصدیق، ماڈل درجات کا انتخاب یا شیڈول شروع نہیں کرتا۔ ریپوزٹری میں قبول کرنے سے پہلے بدلی فائلیں دیکھیں۔

نصب شدہ Archon رہنمائی سے منتخب فراہم کنندہ اور معاون ماڈل شناختیں ترتیب دیں۔ اصل جامد پڑتال اور یونٹ ٹیسٹ کمانڈ harness/harness.config.json میں درج کریں۔ GitHub برانچ تحفظ نہ بتا سکے تو مرج کے لیے ضروری CI کام required_checks میں لکھیں۔ protected_paths دیکھیں تاکہ مقصد، جانچ کے ڈھانچے اور فیکٹری پالیسی کی تبدیلی انسان سے گزرے۔ سانچہ عام جانچ کمانڈ اور required_checks خالی چھوڑتا ہے؛ صرف نقل سے کارآمد قبولیت کی رکاوٹ نہیں بنتی۔

2. موجودہ مصنوعات کا مقصد اور جانچ لکھیں

فائل MISSION.md میں مقصد، سخت حدود اور ممکنہ مگر دائرے سے باہر درخواستیں لکھیں۔ harness/END-TO-END.md میں دو سے پانچ صارف مراحل لکھیں جنہیں موجودہ ایپ واقعی مکمل کرتی ہے، اور صارف کو نظر آنے والا فائدہ بھی۔ ابھی نہ بنے فیچر پر منحصر مرحلہ پہلی فراہمی روک دے گا۔ .factory/holdout/HOLDOUT.md میں رویوں کے امتزاج یا حدی صورتوں کے الگ کیس لکھیں۔ ڈائریکٹری کا نام اسی ورکنگ کاپی تک رسائی والے ڈویلپر سے کیس نہیں چھپاتا؛ واقعی نجی کیس باہر رکھیں اور صرف تصدیق کرنے والے کو دیں۔

صرف PRD والی ریپوزٹری کے لیے README دستاویز سے مقصد، متوقع صارف مراحل اور جانچ کمانڈ اخذ کرنے کو کہتا ہے۔ پہلا مجوزہ کام مصنوعات کو قابلِ اجرا بنائے اور آغاز کی کمانڈ، صحت اور بلڈ شناخت کے پاتھ، ٹیسٹ اور CI بتائے۔ کام شائع کرنے کی اجازت سے پہلے تجویز جانچیں۔

مراحل کو Archon کے رن ٹائم ورک فلو کے متوقع منظرنامہ ان پٹ میں بدلیں۔ نصب شدہ factory/RUNTIME_HOST.md کے مطابق فراہم کردہ کمٹ کی ایپ تصویر، تازہ حالت، صحت و بلڈ شناخت کی پڑتال اور مجاز Python یا Node آغاز کمانڈ تیار کریں۔ دستاویز کا ہوسٹ دور دراز ڈیٹابیس، کنٹینر یا کلاؤڈ وسائل کو اپنے زیرِانتظام رن ٹائم وسائل کے طور پر سہارا نہیں دیتا۔ انہیں استعمال کرنے والی ایپ کے لیے الگ معقول تصدیقی انتظام چاہیے؛ کامیاب مقامی پڑتال ان کی علیحدگی ثابت نہیں کرتی۔

جائزہ کار پر اعتماد سے پہلے حقیقی صارف فائدہ آزمانے والا کامیاب بنیادی معیار بنائیں، دکھائیں کہ مناسب دانستہ خرابی ناکام ہوتی ہے اور غلط امیدوار شناخت پر غیر فیصلہ کن نتیجہ آتا ہے۔ ہوسٹ رہنما میں آزمائشی مجموعے کے ان پٹ اور درست متوقع فیلڈ ہیں، جن میں expectations_passed: true اور baseline_verified: true شامل ہیں۔ اصل واپس آنے والا نتیجہ اور امیدوار شناخت ثبوت کے لیے رکھیں۔ صرف صفحہ کھلنا دیکھنا یا ٹیسٹ کی آخری حالت براہِ راست بنانا ناکافی ہے۔

3. تنصیب جانچ کر ایک کام چنیں

ایپ کی بنیادی ڈائریکٹری سے چلائیں:

Terminal
python factory/consumer.py doctor
python factory/consumer.py list

doctor مقررہ ماخذ، کمانڈ صلاحیتیں اور دستیاب ورک فلو جانچتا ہے۔ list ملنے والے ورک فلو دکھاتا ہے۔ کوئی بھی یہ ثابت نہیں کرتا کہ فراہم کنندہ کام مکمل کرے گا، CI کامیاب ہوگی یا ایپ چلے گی۔ فراہمی سے پہلے بتائی غلطیاں درست کریں؛ شیڈول بند رکھیں۔

موجودہ کوڈ کے لیے واضح نتیجے اور قبولیت کی جانچ والا چھوٹا کام لکھیں۔ README درجہ بندی، فراہمی اور جائزے سے پل ریکویسٹ تک کے لیے یہ کمانڈ بتاتا ہے:

Terminal
python factory/consumer.py run archon-ship --input target=https://github.com/OWNER/REPO/issues/1 --input discovery_publication=preview --detach --json

URL کی جگہ اپنے کنٹرول کا کام دیں۔ واضح discovery_publication=preview جائزے کے متعلقہ انکشافات کو کام کے طور پر شائع نہیں کرتا؛ مقررہ archon-ship کی عمومی قدر auto ہے۔ رن ٹائم منظرنامہ اور الگ محفوظ جانچ ان پٹ تیار ہونے کے بعد ہی archon-lifecycle استعمال کریں۔ کام کو target، پاتھ کو scenario اور holdout میں دیں، ساتھ merge_mode=approve اور discovery_publication=preview۔ منصوبے سے منظور شدہ merge_method بھی دیں: merge، squash یا rebase۔ مثلاً merge_method=squash صرف ریپوزٹری کی اجازت پر استعمال کریں۔ اس عمل میں رن ٹائم و الگ جانچ، اصلاح اور مرج کی رکاوٹ شامل ہیں۔ منظوری موڈ مرج سے پہلے انسان کا فیصلہ برقرار رکھتا ہے؛ ورک فلو کا تیار نشان وہ فیصلہ نہیں۔ فیکٹری ہوسٹ کا دستاویزی --runtime-host صرف سامنے چلتا ہے اور --detach یا --resume کے ساتھ نہیں چل سکتا۔

PRD کے لیے دستاویزی بیک لاگ کمانڈ:

Terminal
python factory/consumer.py run archon-backlog --input 'prd=docs/PRD.md' --input publication=approve

اقتباسی علامات کے docs/PRD.md کو ایپ ورکنگ کاپی کے لحاظ سے اصل PRD پاتھ سے بدلیں۔ شائع کرنے سے پہلے مجوزہ ترتیب وار کام جانچیں۔ پہلے کام میں بیان کردہ ایپ آغاز اور شناخت کے معاہدے سے رن ٹائم ہوسٹ جوڑیں، پھر تیار مراحل اور الگ جانچ کے ساتھ اسے archon-lifecycle سے گزاریں۔ پہلے کام کو بعد کے کام جتنی احتیاط سے جانچیں۔

4. منظوری سے پہلے تبدیلی اور چلتے نتیجے کو پرکھیں

واپس ملنے والا run ID رکھیں۔ کنٹرول پروگرام پیش رفت اور ثبوت کے لیے get <run-id> --json --events اور status --all --json دیتا ہے۔ کام اور منصوبہ MISSION.md سے ملائیں؛ اصل PR فرق اور تازہ ترین ریویژن کا آزاد جائزہ پڑھیں؛ ضروری CI نتائج اور محفوظ پاتھ رپورٹ دیکھیں۔ فراہم کردہ ریویژن پر صارف مراحل چلائیں اور امیدوار شناخت سمیت اصل رن ٹائم اور الگ جانچ کے نتائج دیکھیں۔ مشاہدہ شدہ صارف نتیجہ قبولیت کی شرطوں سے ملائیں۔ ناقص PR اصلاح کے لیے واپس جائے؛ README مرج قطار میں رکی فراہمی کے لیے archon-deliver --adopt <run id> بیان کرتا ہے۔

جانچ کامیاب ہونے پر صرف ریپوزٹری اختیار رکھنے والا انسان مرج منظور کرے۔ تعیناتی کے لیے منصوبے کی اپنی تعیناتی، صحت و شناخت کمانڈ اور بعد میں ریویژن دوبارہ پڑھ کر تصدیق ضروری ہے۔ مرج شدہ PR خود تعیناتی ثابت نہیں کرتی۔ پہلے کام کے دوران شیڈول بند رکھیں اور بار بار اجرا کی اجازت الگ طے کریں۔

منتظم کی لاگت کی رہنمائی فی اجرا مقررہ قیمت نہیں دیتی۔ وہ پہلے دن سے ٹوکن گننے اور لوپ کھولنے سے پہلے چھوٹے کام پر ماڈل کال دیکھنے کا مشورہ دیتی ہے۔ فیس فراہم کنندہ، ماڈل اور اکاؤنٹ شرطوں پر منحصر ہے۔ BIG CHANGE نے اس فیکٹری کا خرچ نہیں ناپا۔

فعال اجرا کے لیے واضح رکنے کا فیصلہ بھی چاہیے۔ کنٹرول کوڈ میں halt نئے آغاز اور تسلسل روکتا ہے، جبکہ cancel <run-id> فعال کام کو نشانہ بناتا ہے۔ pause ٹائمر کے آغاز روکتا مگر جاری کام کو جگانے دیتا ہے۔ کوئی کمانڈ موجودہ اجرا حالت اور دور کی ریپوزٹری تبدیلی جانچنے کا بدل نہیں۔

ماخذ اور مزید مطالعہ