Markdown ایڈیشن

AI-translated from English; not yet reviewed by a fluent editor.

# Archon پر مبنی سافٹ ویئر فیکٹری ترتیب دیں اور ایک کام کا جائزہ لیں

> مقررہ نسخے کی دستاویزات پر مبنی رہنمائی: Archon کے ایک پروگرامنگ کام کی منصوبہ بندی اور جانچ، مصنوعات کے مقصد اور دورانِ اجرا پڑتال سے انسانی مرج فیصلے تک۔ BIG CHANGE نے یہ فیکٹری نہیں چلائی۔

By BIG CHANGE Editorial

Published: 2026-10-19T14:43:34.857Z
Updated: 2026-10-19T14:43:34.857Z
Canonical: https://bigchange.ai/blog/archon-software-factory-reviewed-issue

![Conceptual charcoal illustration of one reviewer studying an unbranded two-column code change printout clipped to a wall rail.](https://bigchange.ai/api/media/file/archon-reviewed-code-change-v2.png)
AI-generated conceptual illustration by BIG CHANGE; no factory installation, issue delivery, code review outcome or product interface is depicted.

یہ [AI Software Factory کی ریپوزٹری](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) مصنوعات کے مقصد اور کام سے Archon کی بنائی پل ریکویسٹ تک کا راستہ بیان کرتی ہے۔ تنصیب اور ورک فلو کی پڑتال صرف آغاز ہیں۔ منتظم کی [پہلے گھنٹے کی رہنمائی](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) کے مطابق حقیقی مکمل عملی توثیق ابھی باقی ہے۔ یہ رہنما فیکٹری کے کمٹ `9e2d85298b45497031009597a6ae0811b66fe6d6` اور اس میں مقررہ Archon ریویژن `fad09169ea1b43512bc7ee88470d47f960a3e0f8` کی پیروی کرتا ہے۔ یہ دستاویز اور کوڈ پڑھنے پر مبنی ہے، BIG CHANGE کی تنصیب یا اجرا کی رپورٹ نہیں۔

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

## بڑی تبدیلی

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

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

منتظم کی [ترتیب کی ہدایات](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) میں Git، Python 3.10 یا جدید، تصدیق شدہ `gh` جس کے پاس `workflow` دائرہ ہو، GitHub ریموٹ، کوڈنگ ایجنٹ، Bun اور uv درکار ہیں۔ Git کو ورک فلو فائلیں بھی بھیج سکنا چاہیے (`gh auth setup-git`)۔ ایجنٹ چلانے سے پہلے موجودہ ٹیسٹ، آغاز اور CI کمانڈ، برانچ تحفظ، GitHub رسائی، فراہم کنندہ کی تصدیق اور ماڈل بلنگ دیکھیں۔ صرف مطلوبہ ریپوزٹری اور ورک فلو اختیارات دیں۔

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

```bash
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`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) دستاویز سے مقصد، متوقع صارف مراحل اور جانچ کمانڈ اخذ کرنے کو کہتا ہے۔ پہلا مجوزہ کام مصنوعات کو قابلِ اجرا بنائے اور آغاز کی کمانڈ، صحت اور بلڈ شناخت کے پاتھ، ٹیسٹ اور CI بتائے۔ کام شائع کرنے کی اجازت سے پہلے تجویز جانچیں۔

مراحل کو Archon کے رن ٹائم ورک فلو کے متوقع منظرنامہ ان پٹ میں بدلیں۔ نصب شدہ [`factory/RUNTIME_HOST.md`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md) کے مطابق فراہم کردہ کمٹ کی ایپ تصویر، تازہ حالت، صحت و بلڈ شناخت کی پڑتال اور مجاز Python یا Node آغاز کمانڈ تیار کریں۔ دستاویز کا ہوسٹ دور دراز ڈیٹابیس، کنٹینر یا کلاؤڈ وسائل کو اپنے زیرِانتظام رن ٹائم وسائل کے طور پر سہارا نہیں دیتا۔ انہیں استعمال کرنے والی ایپ کے لیے الگ معقول تصدیقی انتظام چاہیے؛ کامیاب مقامی پڑتال ان کی علیحدگی ثابت نہیں کرتی۔

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

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

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

```bash
python factory/consumer.py doctor
python factory/consumer.py list
```

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

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

```bash
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 کے لیے دستاویزی بیک لاگ کمانڈ:

```bash
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 خود تعیناتی ثابت نہیں کرتی۔ پہلے کام کے دوران شیڈول بند رکھیں اور بار بار اجرا کی اجازت الگ طے کریں۔

منتظم کی [لاگت کی رہنمائی](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#cost) فی اجرا مقررہ قیمت نہیں دیتی۔ وہ پہلے دن سے ٹوکن گننے اور لوپ کھولنے سے پہلے چھوٹے کام پر ماڈل کال دیکھنے کا مشورہ دیتی ہے۔ فیس فراہم کنندہ، ماڈل اور اکاؤنٹ شرطوں پر منحصر ہے۔ BIG CHANGE نے اس فیکٹری کا خرچ نہیں ناپا۔

فعال اجرا کے لیے واضح رکنے کا فیصلہ بھی چاہیے۔ [کنٹرول کوڈ](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py) میں `halt` نئے آغاز اور تسلسل روکتا ہے، جبکہ `cancel <run-id>` فعال کام کو نشانہ بناتا ہے۔ `pause` ٹائمر کے آغاز روکتا مگر جاری کام کو جگانے دیتا ہے۔ کوئی کمانڈ موجودہ اجرا حالت اور دور کی ریپوزٹری تبدیلی جانچنے کا بدل نہیں۔

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

- [مقررہ نسخے کا فیکٹری README](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md): ترتیب، کمانڈ، مصنوعات ان پٹ، ورک فلو انتخاب اور بیان کردہ حدود۔ منتظم کا بیان ہے، BIG CHANGE کے اجرا کا ثبوت نہیں۔
- [مقررہ پیک کا منشور](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) اور [کنٹرول کوڈ](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py): Archon ریویژن، دستیاب ورک فلو اور status، halt، cancel، pause میں فرق۔
- [پہلے گھنٹے کا رہنما](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) اور [رن ٹائم ہوسٹ رہنما](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md): توثیق کا تحفظ اور امیدوار سے منسلک رن ٹائم پڑتال کی شرطیں۔
- [کوڈنگ ایجنٹ اور مکمل کام پر BIG CHANGE کی متعلقہ رپورٹ](https://bigchange.ai/articles/ai-coding-agents-review-output-study): مکمل نتائج کی جانچ کا پس منظر۔ یہ الگ تحقیق ہے، اس فیکٹری کی زمانی اگلی خبر نہیں۔

## Sources

- [README.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) — منتظم کی ترتیب، منصوبے کی فائلیں، ورک فلو، کام و PRD راستے، مرج پالیسی اور عملی حدود۔
- [pack.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) — درست Archon ریویژن، ورک فلو اور کمانڈ لائن صلاحیتیں؛ مقررہ README سے مطابقت۔
- [first-hour.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) — ترتیب کا سلسلہ اور حقیقی مکمل توثیق کی باقی ضرورت کا واضح بیان۔
- [consumer.py](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py) — doctor/list، ورک فلو کال، status، halt، pause اور cancel کا نفاذ۔
- [RUNTIME_HOST.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md) — امیدوار سے نسبت، بنیادی معیار اور دانستہ خرابی کی پیمائش، معاون ایپ اقسام اور حدود۔
- [harness.config.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/harness/harness.config.json) — خالی منصوبہ جانچ کمانڈ و ضروری پڑتال اور عمومی محفوظ پاتھ۔
- [LICENSE](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/LICENSE) — Archon لائسنس کی شرطیں؛ الگ فیکٹری ریپوزٹری کی اجازت ثابت نہیں کرتیں۔
- [archon-ship.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/ship/archon-ship.yaml) — دریافت کی اشاعت کی عمومی قدر auto؛ preview متعلقہ نتائج شائع نہیں کرتا۔
- [archon-lifecycle.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/lifecycle/archon-lifecycle.yaml) — واضح مرج طریقہ ضروری: merge، squash یا rebase۔
- [archon-backlog.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/backlog/archon-backlog.yaml) — PRD ورکنگ کاپی کے اندر پاتھ ہے۔
- [BIG CHANGE](https://bigchange.ai/articles/ai-coding-agents-review-output-study) — مکمل نتیجے کی جانچ کا متعلقہ مگر الگ پس منظر۔