Markdown издање

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) каже да стварна провера целог поступка тек треба да се обави. Овај водич прати commit фабрике `9e2d85298b45497031009597a6ae0811b66fe6d6` и њену фиксирану Archon ревизију `fad09169ea1b43512bc7ee88470d47f960a3e0f8`. Заснован је на читању документације и кода, а не на инсталацији или покретању које је обавио BIG CHANGE.

Поступак је намењен тиму који контролише репозиторијум апликације или PRD, његове GitHub дозволе и налог код добављача модела. Одржавалац изричито документује клонирање и инсталирање фабрике у сопствени репозиторијум. Стабло фиксиране ревизије фабрике нема датотеку лиценце ни обавештења; овај водич не утврђује шира права поновне употребе или дистрибуције. Archon MIT лиценца важи за одвојени Archon изворни код. Тајне добављача не уносите у задатке, упите, евиденције или записе о прегледу.

## Велика промена

- **Шта се променило:** Ова имплементација повезује обухват производа, планирање задатака, програмирање, независни преглед и извршне провере кроз фиксирани пакет Archon токова. Фабрика даје пројектне улазе и покретач; заједнички пакет садржи AI кораке.
- **Зашто је важно:** Тим може да прати предлог од задатка до конкретних измена, CI резултата и покренутог кандидата пре одлуке о спајању. Саме инсталационе провере остављају тај траг непотпуним; одржавалац наводи да стварну интеграцију још треба потврдити.
- **Шта пратити:** Први користан доказ је стваран задатак чија испоручена ревизија пролази смислене корисничке токове и независне издвојене провере, уз тиму видљиве трошкове и запис прегледа. Распоред и пуштање у рад остају засебне одлуке после прегледа.

## 1. Проверите репозиторијум, дозволе и фиксирани извор

Документ [Упутство одржаваоца за подешавање](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-у, аутентификацију добављача и наплату модела. Доделите само потребна овлашћења за репозиторијум и токове рада.

Клонирајте фабрику ван репозиторијума апликације и пређите на наведени commit. Из корена *апликације*, документована команда за инсталирање је:

```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`. Инсталатер копира шаблоне фабрике и пројекта и инсталира Archon извор наведен у [`pack.json`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json). README и пакет на овом commit-у наводе исту ревизију `fad09169ea1b43512bc7ee88470d47f960a3e0f8`. Инсталатер не пријављује добављача, не бира нивое модела и не укључује распоред. Прегледајте измене датотека пре него што их прихватите у репозиторијуму.

Према инсталираном Archon упутству подесите изабраног добављача и подржане идентификаторе модела. Стварне команде за статичке провере и јединичне тестове упишите у `harness/harness.config.json`. Ако GitHub не може да пријави заштиту грана, у `required_checks` наведите CI послове потребне за спајање. Прегледајте `protected_paths` како би измене мисије, окружења за проверу и правила фабрике захтевале човека. Шаблон оставља обичне команде за проверу и `required_checks` празним; само копирање не успоставља употребљиву контролу прихватања.

## 2. Напишите мисију и провере за постојећи производ

У `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) за снимак апликације из испорученог commit-а, ново стање, провере исправности и идентитета верзије и дозвољене Python или Node команде за покретање. Документовани извршни домаћин не управља удаљеним базама, контејнерима или ресурсима у облаку као својим извршним ресурсима. Апликацији која их користи треба посебно образложено решење за проверу; успешна локална провера не доказује њихову изолованост.

Пре ослањања на оцењивача успоставите успешну почетну проверу која испитује стварну корисничку вредност, покажите да релевантна намерна грешка пада и проверите да погрешан идентитет кандидата враћа неодређен закључак. Упутство домаћина наводи улазе скупа провера и тачна очекивана поља, укључујући `expectations_passed: true` и `baseline_verified: true`. Сачувајте стварни изворни одговор и идентитет кандидата као доказе. Тврдња која проверава само учитавање странице или тест који непосредно припрема завршно стање нису довољни.

## 3. Проверите инсталацију, па изаберите један задатак

Покрените из корена апликације:

```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` тек када припремите scenario извршавања и издвојене контролне случајеве. Проследите задатак као `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` са припремљеним токовима и издвојеним проверама. Први задатак проверите једнако пажљиво као наредне.

## 4. Оцените измене и резултат извршавања пре одобрења

Сачувајте враћени идентификатор извршавања. Управљачки програм нуди `get <run-id> --json --events` и `status --all --json` за напредак и доказе. Упоредите задатак и план са `MISSION.md`; прочитајте стварне измене захтева и независни преглед његове тренутне ревизије; проверите обавезне CI резултате и извештај о заштићеним путањама. Покрените корисничке токове на испорученој ревизији и прегледајте изворне резултате извршавања и издвојених провера, укључујући идентитет кандидата. Упоредите уочени кориснички исход са условима прихватања. Прегледач треба да врати неисправан захтев на поправку; README описује `archon-deliver --adopt <run id>` за испоруку задржану у реду за спајање.

Тек по проласку провера човек са овлашћењем над репозиторијумом треба да одобри спајање. Пуштање у рад захтева посебне пројектне команде за постављање, исправност и идентитет, као и поновну проверу ревизије после постављања; спојен захтев не доказује пуштање у рад. Распоред држите искључен током првог задатка, па посебно одлучите да ли укључити понављајуће извршавање.

Документ [Упутство одржаваоца о трошковима](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 ревизија, доступни токови и разлике између статус, halt, цанцел и 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, позивања токова, статус, halt, pause и цанцел.
- [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; превиеw оставља успутне налазе необјављене.
- [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) — Повезан, али засебан контекст за проверу завршених исхода.