हा AI Software Factory रिपॉझिटरी उत्पादनाचे ध्येय आणि कामापासून Archon ने बनवलेल्या पुल रिक्वेस्टपर्यंतचा मार्ग सांगते. स्थापना आणि कार्यप्रवाह तपासणी ही फक्त सुरुवात आहे. देखभालकर्त्याच्या पहिल्या तासाच्या मार्गदर्शकानुसार संपूर्ण प्रक्रियेची प्रत्यक्ष पडताळणी अजून बाकी आहे. हा लेख फॅक्टरी कमिट 9e2d85298b45497031009597a6ae0811b66fe6d6 आणि त्यात निश्चित केलेली Archon आवृत्ती fad09169ea1b43512bc7ee88470d47f960a3e0f8 वापरतो. तो दस्तऐवज आणि कोड वाचनावर आधारित आहे; BIG CHANGE ने केलेल्या स्थापनेचा किंवा प्रत्यक्ष चालवण्याचा अहवाल नाही.

ही पद्धत ॲप रिपॉझिटरी किंवा PRD, GitHub परवानग्या आणि मॉडेल पुरवठादाराचे खाते नियंत्रित करणाऱ्या संघासाठी आहे. देखभालकर्ता स्वतःच्या रिपॉझिटरीत फॅक्टरी क्लोन व स्थापित करण्याची पद्धत स्पष्टपणे नोंदवतो. निश्चित फॅक्टरीच्या फाइल-वृक्षात परवाना किंवा सूचना फाइल नाही; हे मार्गदर्शन व्यापक पुनर्वापर किंवा पुनर्वितरणाचे अधिकार स्थापित करत नाही. Archon चा MIT परवाना वेगळ्या Archon स्रोताला लागू होतो. पुरवठादाराची गुपिते कामाचा मजकूर, सूचना, नोंदी किंवा पुनरावलोकन पुराव्यात टाकू नका.

मोठा बदल

  • काय बदलले: ही अंमलबजावणी निश्चित Archon कार्यप्रवाह पॅकद्वारे उत्पादनाची कक्षा, काम नियोजन, प्रोग्रामिंग, स्वतंत्र पुनरावलोकन व कार्यरत तपासण्या जोडते. फॅक्टरी प्रकल्प इनपुट व प्रारंभक देते; सामायिक पॅकमध्ये AI टप्पे आहेत.
  • का महत्त्वाचे: मर्जपूर्वी संघ प्रस्तावाला कामापासून विशिष्ट फरक, CI परिणाम व चालत्या उमेदवारापर्यंत शोधू शकतो. केवळ स्थापना तपासण्या ही साखळी अपूर्ण ठेवतात; देखभालकर्ता प्रत्यक्ष एकत्रीकरण पडताळणी बाकी असल्याचे सांगतो.
  • काय पाहावे: पहिला उपयुक्त पुरावा म्हणजे खरे काम, ज्याची सुपूर्त आवृत्ती अर्थपूर्ण प्रवास व स्वतंत्र राखीव चाचण्या उत्तीर्ण करते आणि संघाला खर्च व पुनरावलोकन नोंद दिसते. नंतरही वेळापत्रक व तैनाती स्वतंत्र निर्णय राहतात.

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

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

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

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

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

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

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

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

परत आलेला रन 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 टाइमरचे प्रारंभ थांबवतो, मात्र सुरू कामाला जागे करण्याची परवानगी देतो. कोणतीही आज्ञा सध्याची रन स्थिती व दूरस्थ रिपॉझिटरी बदल तपासण्याचा पर्याय नाही.

स्रोत आणि पुढील वाचन