Подесите софтверску фабрику засновану на Archon-у и прегледајте један задатак

Овај Репозиторијум AI Software Factory описује пут од мисије производа и задатка до захтева за спајање који прави Archon. Инсталација и провере токова рада само су почетак. Одржавалац у водичу за први сат каже да стварна провера целог поступка тек треба да се обави. Овај водич прати commit фабрике 9e2d85298b45497031009597a6ae0811b66fe6d6 и њену фиксирану Archon ревизију 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. Из корена апликације, документована команда за инсталирање је:

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. 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 тражи да се мисија, планирани токови и команде за проверу изведу из документа. Први предложени задатак мора да омогући покретање производа и наведе команду за покретање, путање за проверу исправности и идентитета верзије, тестове и CI. Прегледајте предлог пре него што дозволите објављивање задатака.

Претворите токове у улазе сценарија које очекују Archon токови извршавања. Пратите инсталирани factory/RUNTIME_HOST.md за снимак апликације из испорученог commit-а, ново стање, провере исправности и идентитета верзије и дозвољене Python или Node команде за покретање. Документовани извршни домаћин не управља удаљеним базама, контејнерима или ресурсима у облаку као својим извршним ресурсима. Апликацији која их користи треба посебно образложено решење за проверу; успешна локална провера не доказује њихову изолованост.

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

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

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

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

doctor проверава фиксирани извор, могућности команди и доступне токове рада. list приказује пронађене токове. Ниједна команда не доказује да добављач може да заврши задатак, да ће CI проћи или да апликација ради. Отклоните пријављене грешке пре испоруке; распоред оставите искључен.

За постојећи код напишите мали задатак са јасним исходом и проверама прихватања. README документује ову команду за разврставање, испоруку и преглед до захтева за спајање:

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, документована команда за листу планираних задатака је:

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> за испоруку задржану у реду за спајање.

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

Документ Упутство одржаваоца о трошковима не даје фиксну цену извршавања. Препоручује мерење токена од првог дана и праћење позива модела на малом задатку пре укључивања петље. Наплата зависи од добављача, модела и услова налога. BIG CHANGE није мерио трошкове ове фабрике.

За активно извршавање потребна је и изричита одлука о заустављању. У коду управљачког програма, halt блокира нова покретања и наставке, док cancel <run-id> циља активни рад. pause зауставља покретања тајмером, али дозвољава буђења већ покренутог рада. Ниједна команда не замењује проверу стварног стања извршавања и измена удаљеног репозиторијума.

Извори и додатно читање

• README фабрике на фиксираној ревизији: подешавање, команде, пројектни улази, избор токова и наведена ограничења. Опис одржаваоца, не доказ да је BIG CHANGE покренуо фабрику.
• Манифест фиксираног пакета и код управљачког програма: Archon ревизија, доступни токови и разлике између статус, halt, цанцел и pause.
• Водич за први сат и упутство извршног домаћина: ограда одржаваоца о валидацији и услови извршне провере везане за кандидата.
• Повезани BIG CHANGE извештај о агентима за програмирање и завршеном раду: контекст за проверу довршених исхода. Обрађује засебну студију, а не временски наставак ове имплементације.