Markdown izdanje

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

# Podesite softversku fabriku zasnovanu na Archon-u i pregledajte jedan zadatak

> Vodič zasnovan na tačno određenoj reviziji za planiranje i pregled jednog Archon zadatka, od misije proizvoda i provera izvršavanja do ljudske odluke o spajanju. BIG CHANGE nije pokretao fabriku.

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.

Ovaj [Repozitorijum AI Software Factory](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) 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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) 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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) 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:

```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
```

Po potrebi koristite `python3`. Instalater kopira šablone fabrike i projekta i instalira Archon izvor naveden u [`pack.json`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) 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`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/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:

```bash
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:

```bash
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:

```bash
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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#cost) 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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py), `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

- [README fabrike na fiksiranoj reviziji](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md): podešavanje, komande, projektni ulazi, izbor tokova i navedena ograničenja. Opis održavaoca, ne dokaz da je BIG CHANGE pokrenuo fabriku.
- [Manifest fiksiranog paketa](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) i [kod upravljačkog programa](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py): Archon revizija, dostupni tokovi i razlike između status, halt, cancel i pause.
- [Vodič za prvi sat](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) i [uputstvo izvršnog domaćina](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md): ograda održavaoca o validaciji i uslovi izvršne provere vezane za kandidata.
- [Povezani BIG CHANGE izveštaj o agentima za programiranje i završenom radu](https://bigchange.ai/articles/ai-coding-agents-review-output-study): kontekst za proveru dovršenih ishoda. Obrađuje zasebnu studiju, a ne vremenski nastavak ove implementacije.

## Sources

- [README.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) — Podešavanje, projektne datoteke, tokovi rada, putanje zadatka i PRD-a, politika spajanja i ograničenja održavaoca.
- [pack.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) — Tačna Archon revizija, tokovi i mogućnosti komandne linije; poklapa se sa fiksiranim README-om.
- [first-hour.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) — Redosled podešavanja i izričita potreba za stvarnom proverom celog postupka.
- [consumer.py](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py) — Implementacija doctor/list, pozivanja tokova, status, halt, pause i cancel.
- [RUNTIME_HOST.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md) — Vezivanje za kandidata, početna i namerno pokvarena provera, podržani oblici aplikacije i ograničenja.
- [harness.config.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/harness/harness.config.json) — Prazne projektne komande i obavezne provere, kao i podrazumevane zaštićene putanje.
- [LICENSE](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/LICENSE) — Archon licenca; ne potvrđuje prava na odvojeni repozitorijum fabrike.
- [archon-ship.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/ship/archon-ship.yaml) — Objavljivanje nalaza podrazumeva auto; preview ostavlja usputne nalaze neobjavljene.
- [archon-lifecycle.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/lifecycle/archon-lifecycle.yaml) — Zahteva izričit način spajanja: merge, squash ili rebase.
- [archon-backlog.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/backlog/archon-backlog.yaml) — PRD je putanja unutar radne kopije repozitorijuma.
- [BIG CHANGE](https://bigchange.ai/articles/ai-coding-agents-review-output-study) — Povezan, ali zaseban kontekst za proveru završenih ishoda.