inžinierske poznámky · 01

Vnútri harnessu: ako dodávame produkčný softvér s LLM —
a nestratíme niť.

uistory.sk·~6 min čítania

Vypromptovať z modelu kód vie hocikto. Ťažké je vyrobiť softvér, na ktorý by ste vsadili produkčný systém. Naša odpoveď je inžiniersky harness: pipeline, kde modely kontrolujú vstupy a výstupy na každom rozhraní a človek podpisuje každé rozhodnutie, na ktorom záleží.

Načo vôbec harness

Agent bez harnessu optimalizuje na to, aby vyzeral hotovo: implementácia skôr, než je problém zadefinovaný, testy vynechané, keď zavadzajú, „hotovo“ ohlásené bez dôkazu. Sú to predvídateľné spôsoby zlyhania a harness ich rieši štrukturálne, nie tvrdším promptovaním. Každá fáza má vstupné a výstupné kritériá — vstupy skontrolované pri vstupe, výstupy prekontrolované pri výstupe, najprv modelom v roli adversariálneho reviewera, potom inžinierom.

V praxi: spec sa overí voči pôvodnému problému skôr, než sa začne architektúra. Architektúra sa overí voči specu skôr, než sa začne implementácia. Každý diff sa overí voči plánu, testom a bezpečnostnému checklistu skôr, než ho prečíta človek — takže pozornosť reviewera padne na úsudok, nie na chytanie mechanických chýb.

Pozrite si beh pipeline

Build pipeline · záznam
Jedna spolupráca v skratke.
Rovnaké brány sa spustia pri každom builde — vrátane tej, ktorá zamietne. Nižšie: build billingu podľa spotreby, prehraný fázu za fázou.
◇ modelová brána (adversariálna) · [HUMAN] podpis človeka · ● artefakt · ↻ zamietnutie → návrat
Analýza
1
Zámerintent.md — onboarding, nie cenový engine
popisuje problém, nie riešenie
2
Validáciaregister rizík
HUMANpodpis: go / no-go — PM
Návrh
3
Rozsahspec.md — metrika: čas do prvej faktúry
spec overený voči problému — každý cieľ vedie k zámeru
HUMANpodpis: spec schválený — PM
4
ArchitektúraADR-001 — idempotentné kľúče + append-only ledger
návrh overený voči specu — žiadne neodôvodnené závislosti
5
Plántickety — cesty k súborom + kroky overenia
HUMANpodpis: plán schválený — PM
Vývoj a dodanie
6
Kostrarepo · CI/CD · prvý zelený build
7
ImplementáciaRED → GREEN — metering-idempotency.spec(test najprv zlyhá, potom prejde)
diff overený voči plánu, testom a bezpečnostnému checklistu
8
Kontrola
HUMANpodpis: kontrola senior inžinierom
9
Dodaniestaging → preview → prod · rollback pripravený
HUMANpodpis: deploy schválený — senior inžinier

Pravidlá, ktoré pipeline vynucuje

Pod diagramom fáz robia skutočnú prácu štyri pravidlá:

Pipeline vynucuje aj tri tvrdé obmedzenia: modely pracujú so sandboxovaným prístupom a s obmedzenými, časovo ohraničenými prihlasovacími údajmi; automatické bezpečnostné skenovanie beží pri každej zmene; a produkčné tajomstvá ani citlivé dáta sa k modelu nikdy nedostanú. Žiadne výnimky, žiadne obchádzky.

Čo to prináša

Každú spoluprácu meriame; neodhadujeme. Či si harness zaslúži svoje miesto, nám povedia tri čísla:

Svoju prácu už odviedol aspoň raz: pri billing builde architektonická brána zamietla návrh, ktorý by pri retryoch počítal spotrebu dvakrát — ešte skôr, než existoval jediný riadok kódu.

Zverejňujeme ich ako priebežné priemery, keď je vzorka dosť veľká na to, aby niečo znamenala. Čísla sem pribúdajú, ako ich zbierame.

Čo to stojí

Nič z toho nie je zadarmo. Specy zaberú čas skôr, než sa objaví kód, brány prácu zamietajú a vracajú na prepracovanie a pipeline je v prvý deň pomalšia. Berieme to, lebo náklad sa ukáže skoro — tam, kde je lacný — a nie až v produkcii.

Hranica, ktorá sa neposúva

Harness nás robí zároveň rýchlejšími aj prísnejšími — o to celé ide. Nikdy však nerozhoduje. Každá voľba architektúry, každý merge, každý deploy nesie podpis človeka. Preberáte codebase, kde je každý z tých podpisov dohľadateľný.

Chcete tento harness na svojom projekte?
30 minút · hovoríte priamo s vývojármi
Úvodný hovor →
© 2026 uistory · inžinierske poznámky← uistory.sk