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 परिणाम व चालत्या उमेदवारापर्यंत शोधू शकतो. केवळ स्थापना तपासण्या ही साखळी अपूर्ण ठेवतात; देखभालकर्ता प्रत्यक्ष एकत्रीकरण पडताळणी बाकी असल्याचे सांगतो.
- **काय पाहावे:** पहिला उपयुक्त पुरावा म्हणजे खरे काम, ज्याची सुपूर्त आवृत्ती अर्थपूर्ण प्रवास व स्वतंत्र राखीव चाचण्या उत्तीर्ण करते आणि संघाला खर्च व पुनरावलोकन नोंद दिसते. नंतरही वेळापत्रक व तैनाती स्वतंत्र निर्णय राहतात.

## १. रिपॉझिटरी, परवानग्या आणि निश्चित स्रोत तपासा

देखभालकर्त्याच्या [मांडणी सूचनांनुसार](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` रिकामे ठेवतो; फक्त कॉपी केल्याने उपयुक्त स्वीकार-द्वार उभे राहत नाही.

## २. विद्यमान उत्पादनाचे ध्येय आणि तपासण्या लिहा

फाइल `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` आहेत. वास्तविक मूळ प्रतिसाद आणि उमेदवार ओळख पुरावा म्हणून ठेवा. केवळ पान उघडते हे पाहणे किंवा चाचणीची अंतिम स्थिती थेट तयार करणे अपुरे आहे.

## ३. स्थापना तपासा, नंतर एक काम निवडा

ॲपच्या मूळ निर्देशिकेतून चालवा:

```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` मधून न्या. पहिले कामही नंतरच्या कामांइतके काळजीपूर्वक तपासा.

## ४. मंजुरीपूर्वी फरक आणि चालणारा परिणाम तपासा

परत आलेला रन 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) — पूर्ण परिणाम तपासण्याचा संबंधित, पण वेगळा संदर्भ.