இந்த AI Software Factory களஞ்சியம் தயாரிப்பு நோக்கம் மற்றும் பணியிலிருந்து Archon உருவாக்கும் இழுப்புக் கோரிக்கை வரையிலான வழியை விளக்குகிறது. நிறுவலும் பணிப்பாய்வு சோதனைகளும் தொடக்கம் மட்டுமே. பராமரிப்பாளரின் முதல் மணிநேர வழிகாட்டி, உண்மையான தொடக்கம் முதல் முடிவு வரையிலான சரிபார்ப்பு இன்னும் தேவை என்கிறது. இந்த வழிகாட்டி தொழிற்சாலை commit 9e2d85298b45497031009597a6ae0811b66fe6d6 மற்றும் அதில் நிர்ணயிக்கப்பட்ட Archon revision 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 அணுகல், வழங்குநர் அங்கீகாரம், மாதிரி கட்டணம் ஆகியவற்றைப் பாருங்கள். தேவையான களஞ்சிய மற்றும் பணிப்பாய்வு அதிகாரங்களை மட்டுமே வழங்குங்கள்.

செயலியின் களஞ்சியத்திற்கு வெளியே தொழிற்சாலையை நகலெடுத்து குறிப்பிட்ட commit-க்கு மாறுங்கள். ஆவணத்தில் உள்ள நிறுவல் கட்டளைகள் செயலியின் மூல அடைவிலிருந்து இயக்கப்படுகின்றன:

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 மூலத்தை நிறுவுகிறது. இந்த commit-இன் 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-ஐப் பின்பற்றி வழங்கிய commit-இலிருந்து செயலிப் படிமம், புதிய நிலை, நலநிலை மற்றும் உருவாக்க அடையாளச் சோதனைகள், அனுமதிக்கப்பட்ட 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 நேரங்காட்டி தொடக்கங்களை நிறுத்தினாலும் ஏற்கெனவே நடக்கும் பணியை எழுப்ப அனுமதிக்கிறது. எந்தக் கட்டளையும் தற்போதைய இயக்க நிலை மற்றும் தொலைக் களஞ்சிய மாற்றங்களைச் சோதிப்பதற்கு மாற்றல்ல.

ஆதாரங்களும் கூடுதல் வாசிப்பும்