Ovaj Repozitorijum AI Software Factory opisuje put od misije proizvoda i zadatka do zahteva za spajanje koji pravi Archon. Instalacija i provere tokova rada samo su početak. Održavalac u vodiču za prvi sat kaže da stvarna provera celog postupka tek treba da se obavi. Ovaj vodič prati commit fabrike 9e2d85298b45497031009597a6ae0811b66fe6d6 i njenu fiksiranu Archon reviziju fad09169ea1b43512bc7ee88470d47f960a3e0f8. Zasnovan je na čitanju dokumentacije i koda, a ne na instalaciji ili pokretanju koje je obavio BIG CHANGE.

Postupak je namenjen timu koji kontroliše repozitorijum aplikacije ili PRD, njegove GitHub dozvole i nalog kod dobavljača modela. Održavalac izričito dokumentuje kloniranje i instaliranje fabrike u sopstveni repozitorijum. Stablo fiksirane revizije fabrike nema datoteku licence ni obaveštenja; ovaj vodič ne utvrđuje šira prava ponovne upotrebe ili distribucije. Archon MIT licenca važi za odvojeni Archon izvorni kod. Tajne dobavljača ne unosite u zadatke, upite, evidencije ili zapise o pregledu.

Velika promena

  • Šta se promenilo: Ova implementacija povezuje obuhvat proizvoda, planiranje zadataka, programiranje, nezavisni pregled i izvršne provere kroz fiksirani paket Archon tokova. Fabrika daje projektne ulaze i pokretač; zajednički paket sadrži AI korake.
  • Zašto je važno: Tim može da prati predlog od zadatka do konkretnih izmena, CI rezultata i pokrenutog kandidata pre odluke o spajanju. Same instalacione provere ostavljaju taj trag nepotpunim; održavalac navodi da stvarnu integraciju još treba potvrditi.
  • Šta pratiti: Prvi koristan dokaz je stvaran zadatak čija isporučena revizija prolazi smislene korisničke tokove i nezavisne izdvojene provere, uz timu vidljive troškove i zapis pregleda. Raspored i puštanje u rad ostaju zasebne odluke posle pregleda.

1. Proverite repozitorijum, dozvole i fiksirani izvor

Dokument Uputstvo održavaoca za podešavanje navodi Git, Python 3.10 ili noviji, gh prijavljen sa opsegom workflow, udaljeni GitHub repozitorijum, agenta za programiranje, Bun i uv. Git mora da može i da šalje datoteke tokova rada (gh auth setup-git). Pre pokretanja agenta proverite postojeće komande za testiranje, pokretanje i CI, zaštitu grana, pristup GitHub-u, autentifikaciju dobavljača i naplatu modela. Dodelite samo potrebna ovlašćenja za repozitorijum i tokove rada.

Klonirajte fabriku van repozitorijuma aplikacije i pređite na navedeni commit. Iz korena aplikacije, dokumentovana komanda za instaliranje je:

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

Po potrebi koristite python3. Instalater kopira šablone fabrike i projekta i instalira Archon izvor naveden u pack.json. README i paket na ovom commit-u navode istu reviziju fad09169ea1b43512bc7ee88470d47f960a3e0f8. Instalater ne prijavljuje dobavljača, ne bira nivoe modela i ne uključuje raspored. Pregledajte izmene datoteka pre nego što ih prihvatite u repozitorijumu.

Prema instaliranom Archon uputstvu podesite izabranog dobavljača i podržane identifikatore modela. Stvarne komande za statičke provere i jedinične testove upišite u harness/harness.config.json. Ako GitHub ne može da prijavi zaštitu grana, u required_checks navedite CI poslove potrebne za spajanje. Pregledajte protected_paths kako bi izmene misije, okruženja za proveru i pravila fabrike zahtevale čoveka. Šablon ostavlja obične komande za proveru i required_checks praznim; samo kopiranje ne uspostavlja upotrebljivu kontrolu prihvatanja.

2. Napišite misiju i provere za postojeći proizvod

U MISSION.md navedite svrhu proizvoda, čvrsta ograničenja i verovatne zahteve van obuhvata. U harness/END-TO-END.md opišite dva do pet korisničkih tokova koje sadašnja aplikacija zaista završava, uključujući vrednost vidljivu korisniku. Tok koji zahteva još nenapravljenu funkciju blokirao bi prvu isporuku. U .factory/holdout/HOLDOUT.md napišite odvojene slučajeve koji kombinuju ponašanja ili proveravaju granične situacije. Naziv direktorijuma ne skriva ih od programera sa pristupom istoj radnoj kopiji; zaista privatne slučajeve držite van nje i prosledite ih samo proveri.

Za repozitorijum sa samo PRD-om, README traži da se misija, planirani tokovi i komande za proveru izvedu iz dokumenta. Prvi predloženi zadatak mora da omogući pokretanje proizvoda i navede komandu za pokretanje, putanje za proveru ispravnosti i identiteta verzije, testove i CI. Pregledajte predlog pre nego što dozvolite objavljivanje zadataka.

Pretvorite tokove u ulaze scenarija koje očekuju Archon tokovi izvršavanja. Pratite instalirani factory/RUNTIME_HOST.md za snimak aplikacije iz isporučenog commit-a, novo stanje, provere ispravnosti i identiteta verzije i dozvoljene Python ili Node komande za pokretanje. Dokumentovani izvršni domaćin ne upravlja udaljenim bazama, kontejnerima ili resursima u oblaku kao svojim izvršnim resursima. Aplikaciji koja ih koristi treba posebno obrazloženo rešenje za proveru; uspešna lokalna provera ne dokazuje njihovu izolovanost.

Pre oslanjanja na ocenjivača uspostavite uspešnu početnu proveru koja ispituje stvarnu korisničku vrednost, pokažite da relevantna namerna greška pada i proverite da pogrešan identitet kandidata vraća neodređen zaključak. Uputstvo domaćina navodi ulaze skupa provera i tačna očekivana polja, uključujući expectations_passed: true i baseline_verified: true. Sačuvajte stvarni izvorni odgovor i identitet kandidata kao dokaze. Tvrdnja koja proverava samo učitavanje stranice ili test koji neposredno priprema završno stanje nisu dovoljni.

3. Proverite instalaciju, pa izaberite jedan zadatak

Pokrenite iz korena aplikacije:

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

doctor proverava fiksirani izvor, mogućnosti komandi i dostupne tokove rada. list prikazuje pronađene tokove. Nijedna komanda ne dokazuje da dobavljač može da završi zadatak, da će CI proći ili da aplikacija radi. Otklonite prijavljene greške pre isporuke; raspored ostavite isključen.

Za postojeći kod napišite mali zadatak sa jasnim ishodom i proverama prihvatanja. README dokumentuje ovu komandu za razvrstavanje, isporuku i pregled do zahteva za spajanje:

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

Zamenite URL zadatkom koji kontrolišete. Izričito discovery_publication=preview sprečava objavljivanje usputnih nalaza pregleda kao zadataka; fiksirani archon-ship inače podrazumeva auto. Koristite archon-lifecycle tek kada pripremite scenario izvršavanja i izdvojene kontrolne slučajeve. Prosledite zadatak kao target, ulazne putanje kao scenario i holdout, uz merge_mode=approve i discovery_publication=preview. Navedite i projektom odobren merge_method: merge, squash ili rebase. Na primer, merge_method=squash koristite samo ako repozitorijum to dozvoljava. Tok uključuje izvršne i izdvojene provere, popravku i kontrolu spajanja. Režim odobravanja zadržava ljudsku odluku pre spajanja; oznaka spremnosti toka nije ta odluka. Dokumentovana opcija --runtime-host radi samo u prvom planu i ne može uz --detach ili --resume.

Za PRD, dokumentovana komanda za listu planiranih zadataka je:

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

Zamenite docs/PRD.md pod navodnicima stvarnom putanjom PRD-a u odnosu na radnu kopiju aplikacije. Pre objavljivanja pregledajte predloženi redosled zadataka. Podesite izvršni domaćin prema pokretanju aplikacije i ugovoru o identitetu navedenim u prvom zadatku, pa taj zadatak sprovedite kroz archon-lifecycle sa pripremljenim tokovima i izdvojenim proverama. Prvi zadatak proverite jednako pažljivo kao naredne.

4. Ocenite izmene i rezultat izvršavanja pre odobrenja

Sačuvajte vraćeni identifikator izvršavanja. Upravljački program nudi get <run-id> --json --events i status --all --json za napredak i dokaze. Uporedite zadatak i plan sa MISSION.md; pročitajte stvarne izmene zahteva i nezavisni pregled njegove trenutne revizije; proverite obavezne CI rezultate i izveštaj o zaštićenim putanjama. Pokrenite korisničke tokove na isporučenoj reviziji i pregledajte izvorne rezultate izvršavanja i izdvojenih provera, uključujući identitet kandidata. Uporedite uočeni korisnički ishod sa uslovima prihvatanja. Pregledač treba da vrati neispravan zahtev na popravku; README opisuje archon-deliver --adopt <run id> za isporuku zadržanu u redu za spajanje.

Tek po prolasku provera čovek sa ovlašćenjem nad repozitorijumom treba da odobri spajanje. Puštanje u rad zahteva posebne projektne komande za postavljanje, ispravnost i identitet, kao i ponovnu proveru revizije posle postavljanja; spojen zahtev ne dokazuje puštanje u rad. Raspored držite isključen tokom prvog zadatka, pa posebno odlučite da li uključiti ponavljajuće izvršavanje.

Dokument Uputstvo održavaoca o troškovima ne daje fiksnu cenu izvršavanja. Preporučuje merenje tokena od prvog dana i praćenje poziva modela na malom zadatku pre uključivanja petlje. Naplata zavisi od dobavljača, modela i uslova naloga. BIG CHANGE nije merio troškove ove fabrike.

Za aktivno izvršavanje potrebna je i izričita odluka o zaustavljanju. U kodu upravljačkog programa, halt blokira nova pokretanja i nastavke, dok cancel <run-id> cilja aktivni rad. pause zaustavlja pokretanja tajmerom, ali dozvoljava buđenja već pokrenutog rada. Nijedna komanda ne zamenjuje proveru stvarnog stanja izvršavanja i izmena udaljenog repozitorijuma.

Izvori i dodatno čitanje