Koncentrirani OAP

Vnaprejšnje vlaganje človeškega dela, naknadna človeška presoja in odloženo človeško razsojanje

---

Štirje repozitoriji, en konec tedna, en strog rok

SLAIF je 22. in 23. avgusta 2026 izvedel praktično vajo koncentriranega agentskega razvoja v štirih javnih programskih repozitorijih: SLAIF Agent Site, SLAIF Local Coding, SLAIF API Gateway in SLAIF Zap-It. Začasno obdobje brezplačnega dostopa do kodirnega modela Ox Alpha je postavilo strog cilj: vse štiri sisteme pred ponedeljkom približati MVP.

V približno 48 urah so repozitoriji zabeležili 390 potrditev sprememb na veji main in 75 združenih PR-jev ter več kot 77.000 dodanih vrstic. Do ponedeljkovega jutra je dejavnost dosegla 464 potrditev sprememb in 91 združenih PR-jev. Telemetrija OpenRouter za 22. in 23. avgust beleži 13.528 zahtev za Ox Alpha in skupno 2,69 milijarde žetonov. Skupaj s pripravo in vnaprejšnjim vlaganjem dela 21. avgusta je vaja porabila 17.812 zahtev in skupno 3,07 milijarde žetonov.

Odločilen rezultat ni bila količina ustvarjene kode. Ponudniki so odpovedovali, procesi so se končevali, seje razpadale, računalniki menjavali, modeli pa bili zamenjani. Delo se je kljub temu nadaljevalo, ker so stanje repozitorija, delovni nalogi, poročila in artefakti orkestracije preživeli posamezne procese agentov.

Vaja je razkrila tudi mejo avtonomije: izvedba je lahko napredovala hitreje, kot je kdorkoli lahko odgovorno dokazoval dokončanost. Človeško posredovanje je ostalo bistveno za zavračanje pretiranega inženirstva, popravljanje napačnih diagnoz, določanje pomembnih kontrolnih točk presoje, preprečevanje nenehnega ročnega nadziranja orkestracije in zahtevo po neodvisnem skeptičnem pregledu.

Koncentrirani OAP (Concentrated OAP), ki vključuje vnaprejšnje vlaganje človeškega dela, naknadno človeško presojo, odloženo človeško razsojanje, logično trajnost vlog in neodvisno zaključno revizijo, je bil izpopolnjen neposredno na podlagi teh opažanj. V junijske delavnice še ni bil vključen, saj je nastal iz te poznejše praktične vaje; v prihodnje delavnice OAP bo vključen kot napredno gradivo, utemeljeno s praktičnimi dokazi. To poglavje je napredni način dela v okviru orkestriranega agentskega programiranja in predpostavlja model upravljanja iz prvega poglavja.

Povzetek

Običajno orkestrirano agentsko programiranje (Orchestrated Agentic Programming, OAP) je metoda pod človeškim upravljanjem, vodena s projektno ustavo, pri kateri strateška UI deluje kot nadzorna ravnina, visoko avtonomni kodirni agent opravi izvedbeno delo v omejenem okolju, človek pa ohrani pristojnost nad namenom izdelka, tveganjem, sprejemom in izdajo. Človeka že oddalji od nizkonivojskega tipkanja in terminalskega dela. Ne odstrani pa ga nujno iz ponavljajočih se točk odločanja, pregledovanja, združevanja in predajanja vprašanj višji ravni med izvajanjem.

Ta dokument predlaga bolj koncentrirano različico OAP za okolja, v katerih je pomembno hitro doseči verodostojen minimalni izvedljivi izdelek (MVP) ali demonstracijo, produkcijska namestitev pa ostaja poznejša in zahtevnejša odločitev. Razširitev uvede dva časovna mehanizma:

1. Vnaprejšnje vlaganje človeškega dela (Human Work Preloading, HWP): človek arhitekturno sklepanje, omejitve, sprejemna merila, razčlenitev dela, politiko tveganj in upravljanje zgosti pred začetkom avtonomne zanke.
2. Naknadna človeška presoja (Human Judgment Postloading, HJP): pomembne odločitve, ki jih iz vnaprejšnje priprave ni mogoče zanesljivo razrešiti, strateški agent sprejme začasno, jih pregledno zabeleži in odloži za izrecno človeško razsojanje po doseženem MVP, vendar pred prehodom zadevne meje namestitve.

Formalni mehanizem človeškega pregleda se imenuje odloženo človeško razsojanje (Deferred Human Adjudication, DHA). Njegov osrednji artefakt je CRITICAL.md: register, ki po načelu dopušča le dopisovanje in vsebuje pomembne avtonomne odločitve, nerazrešene predpostavke, morebitne ranljivosti, varnostne omilitve, izbire modela zaupanja, dileme o celovitosti podatkov in drug dolg presoje.

Rezultat je koncentrirani OAP: delovni tok, v katerem človek intenzivno dela pred zanko, agenti z visoko avtonomijo izvajajo in nadzorujejo razvoj, človek pa se vrne na določenih kontrolnih točkah razsojanja in namestitve. Strateški agent se ne sme ustaviti samo zato, ker bi zahtevno, a povratno inženirsko odločitev raje prepustil človeku. Odločiti se mora, dokumentirati, omiliti tveganje in nadaljevati. Hkrati brez človeške odobritve ne sme prečkati neprenosljivih produkcijskih, pravnih, uničujočih meja ali meja zunanje izpostavitve.

Temeljna doktrina je:

Vnaprej pripravi, kar je mogoče odločiti vnaprej. O preostalem odloči začasno. Ohrani negotovost. Razsodi pred namestitvijo.

---

1. Razmerje do virov in obseg

Ta dokument namenoma ločuje dve plasti:

• Temelj običajnega OAP: izhaja iz objavljenega priročnika OAP, zlasti iz ločitve vlog, strateškega raziskovanja, projektne ustave, delegiranja v obsegu PR-ja, omejenega izvajanja, pregleda na podlagi dokazov, resnice oddaljenega repozitorija, človeške odgovornosti in kontrolnih točk izdaje.
• Razširitev koncentriranega OAP: model HWP/HJP/DHA, razvit iz operativnih izkušenj s trajnimi strateškimi agenti, zamenljivimi kodirnimi agenti, samodejnim strateškim pregledom in združevanjem ter vrsto kritičnih odločitev za pregled na ravni repozitorija.

Razširitev ne trdi, da je običajni OAP šibek ali naiven. Običajni OAP človeka že razbremeni velikega dela izvedbe in spodbuja strateško zgoščevanje namesto nadzora ukaz za ukazom. Razlika je predvsem v tem, kam v čas umestimo človeško presojo in katere razvojne odločitve prenesemo na strateškega agenta.

flowchart LR
    O["Načela običajnega OAP"] --> E["Razširitev koncentriranega OAP"]
    H["Operativne izkušnje"] --> E
    E --> HWP["Vnaprejšnje vlaganje človeškega dela"]
    E --> LOOP["Bolj avtonomna strateška/kodirna zanka"]
    E --> HJP["Naknadna človeška presoja"]
    HJP --> DHA["Odloženo človeško razsojanje"]
    DHA --> CRIT["CRITICAL.md"]

To je predlagani operativni profil, ne nadomestilo za vsako uporabo OAP. Običajni OAP ostaja varnejša privzeta izbira, kadar so zahteve nestabilne, mora človek odobriti vsako spremembo ali se izvajalno okolje neposredno dotika produkcijsko kritičnih sistemov.

Okvirji Zapis iz prakse, dodani tej izdaji, izhajajo iz izvajanj SLAIF avgusta 2026, pri katerih so koncentrirani delovni tokovi z dvema agentoma preživeli odpovedi modelov, popravke delovnih nalogov, kritične revizije dokončanosti, kvalifikacijo GPU in odložene varnostne odločitve. To so primeri opaženega vedenja delovnega toka, ne splošne trditve o zmogljivosti. Navedki so bili rahlo urejeni, kjer je bilo to potrebno za berljivost.

1.1 Dokazna podlaga in omejitve

Koncentrirani OAP je bil izpopolnjen z opazovalno praktično vajo med 22. in 24. avgustom 2026. Njegova dokazna podlaga vključuje javne zgodovine GitHub štirih programskih repozitorijev SLAIF, delovne naloge OAP in poročila o izvedbi pod nadzorom različic, rezultate CI, telemetrijo zahtev in žetonov OpenRouter ter sočasne zapise pogovorov med človekom in UI, ki dokumentirajo strateške odločitve, operativne odpovedi, popravke in obnovitev.

Vaja ni bila nadzorovana primerjalna meritev. Dejavnost repozitorijev in količina žetonov kažeta obseg in intenzivnost agentskega izvajanja, ne dokazujeta pa neodvisno kakovosti programske opreme ali dokončanosti mejnika. Potrditve sprememb vključujejo izvedbo, preskuse, dokumentacijo, poročila, popravke, združitvene potrditve, ustvarjeno gradivo in posodobitve odvisnosti. Skupna števila žetonov pozivov vključujejo tudi veliko predpomnjenega konteksta.

Zato metodologija metrike dejavnosti obravnava kot dokaz izvedbene zmogljivosti, ne kot dokaz dokončanosti. Trditve o izdelku je treba dokazati s trenutno kodo, preskusi, zvestimi dejanskim mejam, CI, dokumentacijo in neodvisno zaključno revizijo.

1.2 Doktrina in ponovno uporabni referenčni profil začetne vzpostavitve

Zgoraj sta dve metodološki plasti, to poglavje pa vključuje še tretjo, izvedbeno specifično plast:

• Načela običajnega OAP določajo človeško upravljanje, ločitev vlog, omejeno izvajanje, resnico repozitorija, dokaze in odgovornost za izdajo.
• Doktrina koncentriranega OAP dodaja časovna pravila in pravila pristojnosti HWP/HJP/DHA, D0/D1/D2, delegirano združitev za razvoj, dolg presoje, logično kontinuiteto, izvor in ICA.
• Ponovno uporabni referenčni profil začetne vzpostavitve ponuja konkreten način uvedbe te doktrine po načrtovanju projekta: ločene delovne prostore, navodila po vlogah, polne in strnjene dokumente upravljanja, lokalni protokol orkestracije ter validirano, a neaktivno predajo.

Profil določa Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, različica 1.0. Njegova imena datotek, proračuni konteksta, cevi FIFO POSIX, slovnica krogov in dogovor o objavi poročil veljajo znotraj tega referenčnega profila; niso splošne zahteve OAP. Mogoča ostajajo druga orodja, prenosi, razporeditve in ponudniki, če ohranjajo veljavne vloge, dokaze in meje pristojnosti. Takšne inženirske pristope lahko uporablja tudi običajni OAP.

Dodatki opisujejo ponovno uporabno zasnovo, ne novega praktičnega rezultata ali trditve, da je bil vsak odjemalec kvalificiran. Profila za nazaj ne pripisujejo junijskim delavnicam ali avgustovski vaji. Začnite s postopkom uvajanja; natančne pogodbe in odgovornosti za validacijo so v dodatkih D–F.

---

2. Običajni OAP: temelj

2.1 Delovni model

Priročnik OAP metodo opredeljuje kot podvrsto agentskega programskega inženirstva pod človeškim upravljanjem, vodeno s projektno ustavo. Značilna ločitev vlog je:

• človeški vodja določa problem, namen izdelka, domensko resnico, pripravljenost za prevzemanje tveganj, prednostne naloge, sprejemna merila in odločitve o izdaji ter nosi odgovornost;
• strateška UI deluje kot nadzorna ravnina, arhitekturna in načrtovalna plast, spominska plast, avtor delovnih nalogov, kritik, pripravljavec sinteze dokazov in prvi pregledovalec;
• izvajalni agent opravlja delo v repozitoriju in na računalniku, navadno v utrjenem okolju, ki ga je mogoče ponovno zgraditi;
• oddaljeni repozitorij, PR-ji, CI, preskusi, dokumentacija in sled pregledov ohranjajo trajno resnico projekta.

flowchart TD
    H["Človeški vodja<br/>namen, tveganje, sprejem, izdaja"] --> S["Strateška UI<br/>arhitektura, delovni nalogi, pregled"]
    S --> C["Kodirni agent<br/>izvedba in preskusi"]
    C --> R["Veja, PR, CI, poročilo"]
    R --> S
    S --> B["Povzetek za odločanje in priporočilo"]
    B --> H
    H -->|sprejmi, popravi, zavrni, odloži| S

Običajni OAP ni običajno programiranje v paru z UI. Človeku ni treba ostati ob kodirnem agentu. Sodeluje predvsem prek strateške plasti in postavlja vodstvena vprašanja o ujemanju s ciljem, dokazih, varnosti, obsegu in pripravljenosti.

2.2 Življenjski cikel običajnega OAP

Značilen življenjski cikel običajnega OAP je:

1. človek in strateška UI izvedeta raziskovanje;
2. napišeta projektno ustavo in arhitekturo;
3. strateška UI pripravi omejen delovni nalog;
4. izvajalni agent ga izvede in vrne dokaze;
5. strateška UI pregleda rezultat;
6. človek presodi strateški pregled in po potrebi odobri združitev, popravek, zavrnitev ali izdajo;
7. cikel se ponovi.

sequenceDiagram
    participant H as Človeški vodja
    participant S as Strateška UI
    participant C as Kodirni agent
    participant G as GitHub in CI

    H->>S: Domenski namen, omejitve, odnos do tveganj
    S->>H: Arhitektura in možnosti
    H->>S: Sprejmi ali preusmeri
    S->>C: Delovni nalog v obsegu PR-ja
    C->>G: Veja, potrditve sprememb, PR, preskusi
    G-->>S: Razlika, CI, poročilo, dokazi
    S->>H: Povzetek za odločanje in priporočilo
    H->>S: Združi, popravi, zavrni ali odloži
    S->>C: Naslednji ali popravljalni delovni nalog

2.3 Človeške kontrolne točke običajnega OAP

Priročnik ohranja človeško odobritev za pomembna dejanja, kot so:

• produkcijska namestitev;
• združitev v zaščitene veje;
• uničujoče podatkovne operacije;
• zamenjava poverilnic;
• javne trditve ob izdaji;
• dodajanje tveganih odvisnosti;
• širitev omrežnega dostopa;
• spreminjanje varnostne zasnove.

Določa tudi, da je strateški model privzeti prvi pregledovalec, ne končni odgovorni pregledovalec. Model lahko spregleda tveganje, pretirano pohvali rezultat ali opravičuje slabost. Običajni OAP zato ohranja človeka na voljo pri ponavljajočih se kontrolnih točkah upravljanja in izdaje.

2.4 Zakaj je običajni OAP že zmogljiv

Običajni OAP že zagotavlja več bistvenih temeljev, ki jih koncentrirani OAP ohrani nespremenjene:

• strateško raziskovanje pred kodiranjem;
• strojno berljiva projektna pravila v ustavi;
• ozke, pregledljive delovne enote v obsegu PR-ja;
• trajno resnico repozitorija in CI;
• izrecne dokaze in preskušanje negativnih poti;
• omejeno visoko avtonomno izvajanje;
• dokumentacijo in predaje kot operativni spomin;
• pošteno razlikovanje med izvedenim obsegom in zatrjevano pripravljenostjo;
• človeško odgovornost za nastali sistem.

Koncentrirani OAP teh temeljev ne slabi. Poskuša zmanjšati pogostost rutinskih človeških prekinitev, hkrati pa nerazrešeno presojo narediti vidnejšo in lažje uveljavljivo.

---

3. Operativna omejitev: strateško izmikanje odločanju

Med dolgimi avtonomnimi izvajanji lahko strateški agent naleti na dilemo, ki jo tehnično razume, a je brez človeka noče razrešiti. Značilni primeri vključujejo:

• ali se varnostna meja za MVP sme omiliti;
• ali je model avtorizacije dovolj konservativen;
• ali naj bo izbris dokončen, logičen ali predstavljen z oznako izbrisa;
• ali je opozorilo pregledovalnika sprejemljiv lažno pozitiven rezultat;
• ali je začasni mehanizem avtentikacije sprejemljiv v omejeni demonstraciji;
• ali naj zasnova daje prednost hitrosti, povratnosti, izvoru ali preprostosti;
• ali tehnično upravičena sprememba arhitekture presega predvideni proračun tveganja.

Način odpovedi ni vedno neznanje. Pogosto gre za odpor do odločanja:

»Obe možnosti sta verjetni in imata pomembne posledice. Odločiti bi se moral človek.«

Zapis iz prakse — Model je vedel, vendar ni hotel prevzeti izbire.

Razširitev se je začela s ponavljajočim se človeškim opažanjem iz dejanskih izvajanj strateških agentov: agent je znal našteti možnosti, posledice in omilitve pri varnostnih mejah ali omilitvah varnostnega modela, vendar se je še vedno ustavil, ker je želel, da pomembno izbiro takoj prevzame človek. Če človeški očitek povzamemo: »Težava ni, da ne zna odločiti. Noče odločiti.«

Razlika je pomembna. Manjkajoče znanje zahteva raziskovanje. Odpor do odločanja znotraj že delegiranega, povratnega prostora zasnove zahteva obvezno začasno izbiro in pošteno prihodnjo človeško kontrolno točko.

Tak odgovor je pri splošnem pomočniku razumen. V namenoma vnaprej pripravljeni avtonomni zanki predaje pa lahko ustavi celoten projekt zaradi odločitve, ki je povratna, lokalno obvladljiva in znotraj delegiranega prostora zasnove.

flowchart TD
    A["Strateški agent naleti na dilemo"] --> K{"Razume možnosti?"}
    K -->|Ne| R["Razišči, preglej dokaze, izvedi preskuse"]
    R --> K
    K -->|Da| W{"Želi, da izbiro zdaj prevzame človek?"}
    W -->|Da| STOP["Ustavi zanko in zahtevaj človeško odločitev"]
    W -->|Ne| D["Izberi in nadaljuj"]

    style STOP fill:#f9d0d0,stroke:#a33

Ponavljajoče se ustavitve povzročijo več stroškov:

• zaporedne zakasnitve, ko človek ni na voljo;
• izgubo strateškega konteksta med čakanjem;
• razdrobljeno človeško pozornost;
• pritisk za hiter odgovor brez pregleda vseh dokazov;
• vrnitev k razporejanju s človekom v zanki;
• manjšo vrednost sicer avtonomne arhitekture z dvema agentoma.

Koncentrirani OAP to rešuje s spremembo privzetega pravila:

Zahtevna, a povratna razvojna odločitev sama po sebi ni dovoljenje za ustavitev.

---

4. Vnaprejšnje vlaganje človeškega dela (HWP)

4.1 Opredelitev

Vnaprejšnje vlaganje človeškega dela (HWP) je namerno zgoščevanje človeške inženirske presoje pred avtonomnim izvajanjem, zapisano v trajne projektne artefakte, da lahko strateški in kodirni agent dolgo delujeta brez rutinskega človeškega posredovanja.

Beseda delo je pomembna. Človek ne daje le konteksta ozadja. Obsežno inženirsko delo je že opravil:

• opredelil izdelek;
• razrešil glavne arhitekturne možnosti;
• določil meje zaupanja;
• določil pomen besede »končano«;
• določil proračun tveganja;
• razporedil delo;
• določil, o čem ni dovoljeno improvizirati;
• opredelil razliko med pripravljenostjo za demonstracijo, MVP, pilot in produkcijo.

4.2 HWP kot pretvorba presoje v izvedljiva pravila

HWP razpršeno človeško razumevanje pretvori v izvedljivo projektno upravljanje.

flowchart LR
    subgraph Human_reasoning["Človeško sklepanje"]
        P["Namen izdelka"]
        D["Domenska resnica"]
        R["Pripravljenost za prevzemanje tveganj"]
        A["Arhitekturne izbire"]
        N["Necilji"]
        G["Merila sprejema in izdaje"]
    end

    subgraph Preload["Pretvorba HWP"]
        AR["ARCHITECTURE.md"]
        CO["Projektna ustava"]
        RM["Razvojni načrt"]
        WO["Začetni delovni nalogi"]
        DP["Politika odločanja"]
        CT["Shema CRITICAL.md"]
    end

    P --> AR
    D --> AR
    R --> CO
    A --> AR
    N --> RM
    G --> WO
    R --> DP
    DP --> CT

Nastali artefakti strateškemu agentu služijo kot trajno »vnaprej pripravljeno stanje vodenja«.

4.3 Minimalni nabor artefaktov HWP

Resen paket HWP naj navadno vključuje:

Artefakt	Namen
ARCHITECTURE.md	Človeku berljiva oblika izdelka, meje, komponente, podatkovni tokovi, model namestitve in utemeljitev.
AGENTS.md ali enakovredna datoteka	Vstopna točka za kodirna pravila; lahko je minimalni usmerjevalnik do ustave posamezne vloge.
Ustava strateškega agenta	Vloga, pristojnosti, dolžnosti pregleda, politika združevanja in pravila odločanja.
Varnostni dokumenti in dokumenti preskušanja	Nespremenljive varnostne invariante in zahteve glede dokazov.
Razvojni načrt	Urejeni cilji in opredelitve mejnikov.
Začetni delovni nalogi	Konkretni prvi izvedbeni deli s sprejemnimi merili.
Necilji	Izrecno odloženo delo in prepovedana širitev obsega.
Opredelitve pripravljenosti	Ločena merila za demonstracijo, MVP, pilot in produkcijo.
Razvrstitev odločitev	Pravila D0, D1 in D2, opisana pozneje v dokumentu.
Predloga CRITICAL.md	Trajna oblika za odloženo človeško presojo.
Omejitve izvajalnega okolja	Gostitelji, GPU-ji, vrata, poverilnice, zaščitene storitve in preskusne meje.
Protokol obnovitve	Pravila za odpoved agenta, izgubo konteksta, zastarele veje in delno opravljeno delo.

To so dokumenti HWP za izdelek. Vhodni paket za začetno vzpostavitev doda pogodbe izvedbe vzpostavitve in preverjanja paketa; nameščeno okolje doda pomožna orodja, kontekste vlog in dokaze validacije. Njihovi nameni se razlikujejo: glejte dva popisa v dodatku D.

4.4 HWP ni inženirstvo pozivov

Inženirstvo pozivov optimizira interakcijo. HWP vzpostavi operativni sistem projekta.

flowchart TB
    PE["Inženirstvo pozivov"] --> P1["Boljša posamezna interakcija"]
    HWP["Vnaprejšnje vlaganje človeškega dela"] --> P2["Trajna arhitektura"]
    HWP --> P3["Trajno upravljanje"]
    HWP --> P4["Razporejeno delo"]
    HWP --> P5["Politika sprejema in tveganj"]
    HWP --> P6["Pravila obnovitve in razsojanja"]

Poziv lahko izgine s sejo. Artefakti HWP so pod nadzorom različic, pregledljivi, primerljivi po razlikah in ponovno uporabni med agenti in konteksti modelov.

Ponovno uporaben generatorski poziv lahko že opravljeno načrtovanje pretvori v trajne artefakte HWP in specifikacije začetne vzpostavitve. Tega načrtovanja ne nadomesti in ne odobri izvajanja izdelka.

4.5 HWP ni nespremenljiva zasnova

Vnaprejšnja priprava ne pomeni, da je začetna arhitektura popolna. Pomeni, da spremembe postanejo izrecni inženirski dogodki.

Strateški agent sme zasnovo izpopolniti, kadar to zahtevajo dokazi, ne sme pa tiho na novo opredeliti:

• namena izdelka;
• domenske resnice;
• etičnih ali pravnih meja;
• izrecnih neciljev;
• neprenosljivih varnostnih omejitev;
• odobritve produkcije.

Sprememba znotraj delegiranega prostora zasnove je lahko D0 ali D1. Sprememba, ki bi na novo opredelila človeški namen ali prestopila neprenosljivo mejo, je D2.

Zapis iz prakse — Vnaprej določen namen je naletel na GPU z 11 GB.

Vnaprejšnja priprava ZAP-IT je opisovala razvoj na fizičnem GPU1 in vsebovala zgodnjo predpostavko, da ima kartica približno 22–24 GB VRAM. Dejanska kvalifikacija je pokazala običajno RTX 2080 Ti z 11 GB. Strateški proces ni zavrgel cilja izdelka in ni pretvarjal, da je priprava dejstveno pravilna. Ohranil je namen—uporabi GPU1, zaščiti GPU0, izdelaj dejansko storitev—nato izmeril sklad modelov, SAM2 in CLIP ohranil naložena ter zavrnil nalaganje BLIP3 prek varnostnega proračuna.

HWP vnaprej določi smer in presojo. Resničnosti ne podredi osnutku.

4.6 Od usklajenega načrta do samostojnega paketa za začetno vzpostavitev

Predaja se začne v pogovoru, v katerem sta človek in načrtovalni model že uskladila namen izdelka, obseg, omejitve, arhitekturo in sprejemna merila. Načrtovalni model ustvari projektno specifičen vhodni ZIP za začetno vzpostavitev. Ločen agent z orodji, zagnan v razširjenem začasnem imeniku, te vhode pretvori v dejanska kodirni in strateški delovni prostor.

Faza	Udeleženec in rezultat	Pristojnost ne vključuje
Zasnova paketa	Načrtovalni model v vhodnem arhivu pripravi izvorne dokumente, pogodbe, specifikacije programa dela in sprejemne zahteve.	Upravljanja ciljnega računalnika, objave njegovega repozitorija ali začetka izvedbe izdelka.
Izvedba začetne vzpostavitve	Agent za začetno vzpostavitev ustvari delovna prostora, namesti upravljanje, izvede in preskusi pomožna orodja orkestracije, razširi neaktivne osnutke in napiše potrdilo.	Dela na izdelku, operativne aktivacije, izdaje, namestitve ali sprememb zaščitenih storitev.
Upravljani razvoj	Strateška in kodirna vloga ustvarjata omejeno delo, PR-je, dokaze, preglede in odobrene združitve za razvoj.	Človeškega razsojanja, neutemeljenega potrjevanja mejnika ali neodobrenega dejanja D2.
Zaključek, razsojanje in izdaja	Neodvisni pregledovalec in odgovorni človek ocenita pokritost arhitekture, DHA, odpravo pomanjkljivosti in posebej odobren prehod v ciljno stanje.	Obravnave zelenih preverjanj ali izčrpane vrste nalogov kot človeške odobritve.

Načrtovalni model napiše navodila za ustvarjanje in validacijo ogrodja, ne nujno končnega izvedljivega ogrodja. ZIP mora kljub temu določiti konkretno vedenje pomožnih orodij ter pozitivne in negativne preskuse: agentu za začetno vzpostavitev ni naročeno, naj izumi operativni protokol. Nasprotno mora izvedba vzpostavitve ustvariti dejanske datoteke in izvedljive različice pomožnih orodij, ne še enega načrta ali arhiva.

Uspešna predaja je namenoma omejena:

Upravljanje in orkestracija sta nameščena in validirana; delo na izdelku in operativna aktivacija se nista začela.

Obstoječi projekt prejme neuničujočo migracijo ali nadzorovano osvežitev. Njegovo tekoče delo, aktivni kazalec, register, poročila in zgodovina se ohranijo. Nasprotujoče si stanje ali delo v teku pred zamenjavo zahteva omejen prehod, ne ponastavitve za nov projekt. Razdelek 5.8 to predajo loči od aktivacije.

4.7 Zvestoba virom in sledljiva razčlenitev dela

Dokončne datoteke so vhodi, ne priložnost za prepisovanje. Natančne bajte dokončnega načrta ohranite kot PLAN.md, sprejete arhitekture pa kot ARCHITECTURE.md. Preimenovanje ne dovoljuje preoblikovanja, prevajanja, spreminjanja koncev vrstic, povzemanja ali tihih popravkov. Kontrolne vsote zabeležite glede na dejansko priložene datoteke. Če dokončna datoteka ne obstaja, iz usklajenega pogovora sestavite celovit samostojen dokument in ga pošteno označite kot nov artefakt; ločite človeške odločitve od predlaganih razdelav ter ne trdite, da je bil že odobren ali bajtno ohranjen.

SOURCE-MAP.md ločuje pet vrst informacij: izrecne človeške odločitve, dejstva, podprta z viri, predlagane privzete izvedbene izbire, nepreverjene predpostavke o izvajalnem okolju in nerazrešena vprašanja pristojnosti. Predlog v klepetu ni samodejno zahteva. Neznana imena gostiteljev, oddaljeni URL-ji, poverilnice, izbire modelov in meritve ostanejo neznani. Navedite nasprotujoče si izvorne določbe in blokirajte od njih odvisna dejanja, varno neodvisno pripravo pa nadaljujte. Rutinske povratne privzete izbire lahko zabeležite; sporov o pomenu izdelka, uničujočem dejanju ali neprenosljivi pristojnosti ni dovoljeno razrešiti s tihim urejanjem vira. Odobren razvoj D0/D1 je pozneje še vedno mogoč skladno z §4.5.

Polna arhitektura mora opisovati izdelek: delovne tokove, komponente, meje, podatkovne in nadzorne tokove, vedenje ob odpovedi, obratovanje, varnost in dokaze za mejnike. Zgolj zagonski skripti niso HWP. Pomembnim zahtevam dodelite stabilne reference; če so bajti vira zaščiteni, uporabite zunanji indeks zahtev, namesto da v vir vstavljate identifikatorje.

Zahteve razčlenite na projektu primerno število povezanih, dokazljivo obvladljivih ciljev, brez fiksnega števila ali obljubljenega trajanja. Vsak vsebinski osnutek potrebuje konkreten cilj, odvisnosti, reference na arhitekturo in izvor, obseg, necilje, oštevilčena sprejemna merila, smiselno preverjanje z negativnimi potmi, vpliv na dokumentacijo, zaščitene vire in pogodbo poročanja. Preskusi in dokumentacija sodijo v vsak ustrezen del. Izhodišča razširite v samostojne osnutke, ne v generično besedilo z zamenjanimi naslovi.

Prihodnji nalogi ostanejo DRAFT UNTIL STRATEGIC RECONCILIATION (osnutek do strateške uskladitve). Strategija pred aktivacijo preveri trenutni repozitorij, dokaze, odvisnosti in pristojnosti. Za zapolnitev osnutka ne izmišljajte prihodnjih SHA-jev, PR-jev, meritev gostitelja ali rezultatov preskusov. Spremenjeni dokazi lahko spremenijo vrsto nalogov, vendar sprejete zahteve ostanejo obveznosti, dokler niso izpolnjene, pravilno odložene ali izrecno zabeležene kot nerazrešene. Obseg ICA prav tako določajo izvorne zahteve, ne ustvarjena vrsta nalogov.

Vključite potrebne dovoljene posnetke metodologije in projektnih virov, da začetna vzpostavitev ni odvisna od načrtovalnega pogovora ali nedostopnega URL-ja. Izključite zasebne pogovore, poverilnice, osebne podatke/podatke strank in gradivo brez dovoljenja. Očiščene izpeljanke in manjkajoče posnetke pošteno označite. Kontrolne vsote dokazujejo identiteto bajtov, ne resnice, pomenske enakovrednosti ali človeške odobritve.

---

5. Koncentrirani OAP: avtonomna razvojna zanka

5.1 Opredelitev

Koncentrirani OAP je profil OAP, omogočen s HWP, v katerem:

• človek opravi koncentrirano vnaprejšnjo pripravo;
• logično trajna strateška vloga nosi kontinuiteto projekta;
• zamenljiv kodirni agent oziroma agent, ki ga je mogoče ponovno zagnati, naenkrat izvaja en omejen delovni nalog;
• so GitHub, CI, poročila in projektni dokumenti avtoritativni;
• sme strateški agent izdajati popravljalne delovne naloge in združevati razvojne PR-je, kadar to dopušča politika;
• se pomembna negotovost zabeleži, namesto da bi jo skrivali;
• se človek vrne na izrecnih kontrolnih točkah razsojanja in namestitve.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    H["Človeška faza HWP"] --> S["Logično trajna strateška vloga"]
    S --> W["Objavi omejen delovni nalog"]
    W --> C["Zamenljiv kodirni agent"]
    C --> P["PR, preskusi, CI, poročilo"]
    P --> S
    S --> Q{"Zadovoljivo in CI zelen?"}
    Q -->|Ne| FIX["Izdaj popravljalni nalog s črkovno pripono"]
    FIX --> C
    Q -->|Da| J{"Kritična začasna presoja?"}
    J -->|Ne| M["Strateška združitev"]
    J -->|Da| CR["Zabeleži ali posodobi CRITICAL.md"]
    CR --> M
    M --> NX{"Priporoči zaključek mejnika?"}
    NX -->|Ne| W
    NX -->|Da| ICA["Neodvisna zaključna revizija"]
    ICA -->|Vrzeli| W
    ICA -->|Dokazi podpirajo zaključek| DHA["Ustrezni DHA in človeška kontrolna točka mejnika"]

5.2 Logično trajna strategija, zamenljivo izvajanje

Arhitektura okrepi nesimetrijo, ki je že prisotna v OAP:

»Trajno« opisuje kontinuiteto pristojnosti in razumevanja projekta, ne nesmrtnosti enega procesa. Strateško vlogo je mogoče znova vzpostaviti z drugim modelom ali ponudnikom, če pred delovanjem iz trajnih artefaktov obnovi isto stanje protokola.

• strateški kontekst naj bo dolgotrajen, ker vsebuje kontinuiteto izdelka, arhitekturo, razvojni načrt, zgodovino pregledov in nerazrešeno tveganje;
• kodirni kontekst naj bo vezan na nalogo, ker izvedbene podrobnosti zastarajo in porabljajo kontekst;
• trajna resnica naj bo v GitHubu in artefaktih repozitorija, ne v skritem spominu katerega od modelov.

flowchart LR
    S["Strateški kontekst<br/>dolgotrajen"] --> WO["Delovni nalog"]
    WO --> C1["Kodirni kontekst 1"]
    C1 --> G["Resnica GitHuba"]
    G --> S
    S --> C2["Kodirni kontekst 2"]
    C2 --> G
    S --> C3["Kodirni kontekst 3"]
    C3 --> G

Zapis iz prakse — Zamenjava možganov ni spremenila projekta.

Med praktičnim izvajanjem ob koncu tedna so ponudniki OpenCode odpovedovali, kodirne seje so prenehale po porabi usklajevalnih signalov, modeli so bili zamenjani, strateških sej ni bilo več mogoče nadaljevati, novi procesi pa so se zaganjali v novih terminalih. Pravilo obnovitve je ostalo: »GitHub je resnica programske opreme; datoteke OAP so resnica orkestracije; spomin procesa/seje je zamenljiv.« Novemu strateškemu procesu je bilo prepovedano ponovno izvajati združene cilje ali znova ustvarjati njihove PR-je zgolj zato, ker je njegov predhodnik izginil.

Operativni nauk: strateška trajnost je logična trajnost vloge, pristojnosti in zapisa, ne neprekinjena zavest v eni seji modela.

Referenčni protokol v dodatku D.5 to pravilo kontinuitete konkretizira za izgubljene signale, delno objavo in zamenjavo procesa.

5.3 Samodejna strateška združitev je razvojna pristojnost, ne pristojnost za izdajo

Pomembna razlika glede na običajni OAP je, da lahko strateški agent dobi pristojnost za združevanje PR-jev po neodvisnem pregledu, kadar so izpolnjeni vsi zahtevani pogoji.

To ne pomeni, da strateški agent odloča o produkcijski izdaji. Pomeni, da združeni razvojni PR sporoča:

»To je trenutno najboljše z dokazi podprto začasno inženirsko stanje, sprejeto za nadaljnji razvoj.«

Ne pomeni nujno:

»Človek je za produkcijo sprejel vsako varnostno, pravno, operativno odločitev in odločitev o modelu zaupanja.«

Razliko uveljavlja model dvojne kontrolne točke, opisan pozneje.

5.4 Pogoji za avtonomno strateško združitev

Strateški agent sme združiti le, kadar so izpolnjeni vsi veljavni pogoji:

1. PR izvaja aktivni delovni nalog;
2. razlika je omejena in povezana;
3. zahtevani CI in preskusi so zeleni;
4. preskusni dokazi so smiselni, ne zgolj skladenjski;
5. dokumentacija se ujema z vedenjem;
6. ni bila uvedena nobena skrivnost ali prepovedan artefakt;
7. ni bila prestopljena nobena meja D2;
8. vsaka odločitev D1 ima popoln vnos v CRITICAL.md;
9. povrnitev ali povratnost je primerna za razvojno fazo;
10. strateški agent zna pojasniti najmočnejši razlog proti združitvi in zakaj je kljub temu sprejemljiva za nadaljnji razvoj.

V referenčnem profilu je pregled vezan na natančni trenutni vrh veje PR-ja in neodvisno preverjeno oddaljeno stanje; spremenjeni vrh zahteva nov pregled. Dodatek D.4 določa identitete izvedbe/poročila in časovno zaporedje objave.

5.5 Izvor delovnega naloga in pravilo proti delu zaradi dela

Dolga avtonomna zanka mora znati pojasniti, zakaj obstaja vsak nov cilj. Koncentrirani OAP zato zahteva sledljivost vsakega strateškega delovnega naloga do enega ali več trajnih izvorov:

H  izrecno človeško navodilo ali vnaprejšnja priprava
A  arhitektura, ustava, pogodba ali razvojni načrt
E  opaženi dokazi o napaki
I  ugotovitev neodvisne revizije
C  odprava pomanjkljivosti CRITICAL/DHA

flowchart LR
    H["Človeški namen"] --> O["Delovni nalog"]
    A["Arhitektura"] --> O
    E["Opaženi dokazi"] --> O
    I["Neodvisna revizija"] --> O
    C["Odprava kritičnih pomanjkljivosti"] --> O
    O --> PR["Omejen PR"]

Strateški agent naj ne ustvarja dela zgolj zato, ker je sosednja izboljšava videti privlačna. Obratno pa nefunkcionalnega dela z izrecnim človeškim ali revizijskim izvorom, denimo obnovitve enoličnega številčenja ciljev, popravljanja napačnih trditev o pripravljenosti ali ohranjanja revizijsko pregledljivega zapisa, ni dovoljeno odpraviti kot agentsko birokracijo.

Zapis iz prakse — »Zaključujejo arhitekturo ali si izmišljajo delo?«

Človek je večkrat vprašal, ali zaključno zaporedje Agent-Site povečuje dejansko dokončanost ali zgolj ustvarja dejavnost. Odgovor je bilo mogoče utemeljiti šele s povezavo vsakega cilja z manjkajočo arhitekturo: povezovanjem izvajalnih poti, pristojnostjo zmogljivostnih žetonov, zapisi COW, Puckom, mediji, izrisovanjem, Playwrightom, pregledom, napredovanjem v ciljno okolje in bistvenimi dokazi E2E. Navidezni primer »birokracije«, preštevilčenje zaporedja, je bil pozneje pravilno prerazvrščen, ko je človek pojasnil, da ga je izrecno zahteval zaradi nedvoumne sledi OAP.

Operativno pravilo: brez avtonomnega naloga brez izvora; brez kritike procesnega dela brez predhodnega preverjanja njegovega izvora.

5.6 Arhitektura navodil in konteksta po vlogah

Referenčni profil uporablja tri razrešene korenske poti, ki so vse različne in niso gnezdene. Ciljne poti, ki jih izbere upravljavec, imajo prednost pred temi ponazoritvenimi dogovori:

BOOTSTRAP_ROOT = dejanski razširjeni začasni imenik
REPO_ROOT      = $HOME/codex-work/<project-slug>
STRATEGIC_HOME = $HOME/codex-supervision/<project-slug>

Ločitev varuje datoteke in dedovanje navodil: pravila začetne vzpostavitve v nadrejenem imeniku ne smejo postati operativna pravila. Obstajajo štiri funkcije navodil in dodatna strateška izvorna kopija pod nadzorom različic:

Lokacija	Funkcija navodil
BOOTSTRAP_ROOT/AGENTS.md	Ustava samo za začetno vzpostavitev: vzpostavi, validiraj, zabeleži, ustavi se.
REPO_ROOT/AGENTS.md	Majhen usmerjevalnik, ki izbere veljavne dokumente dodeljene vloge.
REPO_ROOT/oap/coding-instructions/AGENTS.md	Namenoma zgoščena kodirna ustava, omejena na izvajanje.
STRATEGIC_HOME/AGENTS.md	Polna operativna strateška ustava.
REPO_ROOT/oap/strategic-instructions/AGENTS.md	Vir te kopije strateškega doma pod nadzorom različic, ki se osvežuje namerno.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    B["Začasni koren začetne vzpostavitve"] -->|Vzpostavi| R["Korenski usmerjevalnik repozitorija"]
    B -->|Namesti| S["Strateški dom: polna ustava"]
    V["Strateški vir pod nadzorom različic"] -->|Nadzorovana kopija| S
    R -->|Kodirna vloga| C["Zgoščena kodirna pravila in strnjena arhitektura"]
    R -->|Strateška vloga ohrani| S
    A["Kanonična polna arhitektura"] -->|Izpeljava| C

Puščice izpeljave opisujejo pripravo dokumentov, ne prenosa pristojnosti. Agent za začetno vzpostavitev ne postane samodejno operativna vloga. Neodvisni revizor je pregledovalec z omejenim obsegom, ne tretja trajna izvajalna veja.

Primer korenskega usmerjevalnika za vzpostavljeni projekt:

Uporabi vlogo, dodeljeno z zaupanja vrednim zaganjalnikom ali izrecnim človeškim navodilom.
CODING -> preberi oap/coding-instructions/AGENTS.md in pripadajoči strnjeni nabor branja.
STRATEGIC -> ohrani STRATEGIC_HOME/AGENTS.md; pregled repozitorija ne spremeni vloge.
UNKNOWN/CONFLICT -> brez operativnega spreminjanja do uskladitve vloge.
BOOTSTRAP/AUDIT -> pregled tega repozitorija ne podeli operativne pristojnosti.
Branje navodil druge vloge ne podeli njene pristojnosti.

Oznaka vloge, pričakovani začetni imenik in kratek modelu viden začetni poziv se morajo ujemati; sama okoljska spremenljivka modelu morda ni vidna. Imenik preverite ob zagonu, poznejši upravičeni pregled pa omogočite. Ukaz cd, ime datoteke, skupna poverilnica ali možnost urejanja datoteke ne spremenijo logične pristojnosti. Usmerjanje je disciplina konteksta, ne avtentikacija, peskovnik operacijskega sistema ali meja dovoljenj.

Pravil začetne vzpostavitve nikoli ne kopirajte v operativno ustavo. Arhivirajte jih pod imenom, ki ga odjemalec samodejno ne odkrije, na primer BOOTSTRAP-GENERATOR.md, in pred nenamernim odkrivanjem zaščitite tudi druge zgodovinske posnetke navodil. Strateški dom se sklicuje na kanonične datoteke načrta, arhitekture in CRITICAL, namesto da bi hranil neodvisno uredljive polne kopije.

5.7 Zgoščevanje pravil upravljanja, nalaganje in nadzor odmikov

Kodirna ustava je izvajalčeva projekcija, ne splošen povzetek. Ohranja pristojnosti, obseg, moč obveznosti, pogoje, izjeme, vrstni red, vedenje ob odpovedi, preverjanje in predajo vprašanj višji ravni, ki so pomembni za izvajalca. Določena strnjena notacija in stabilni identifikatorji določb lahko odstranijo ponavljanje, zgodovino, primere in strateško razpravo; zaradi omejitve velikosti ne smejo odstraniti prepovedi ali izjeme.

Polna strateška ustava ohranja skrbništvo arhitekture, delegirani razvoj, izbiro dela s sledljivim izvorom, sklepanje D0/D1/D2, obvezne začasne odločitve, avtorstvo DHA, skeptični pregled, politiko združevanja, skupno tveganje, pripravljenost, kontinuiteto in ICA. Ni kodirna datoteka z drugo oznako niti navodilo za ponavljajoče se nalaganje celotnih izvornih knjig. Razporeditev vlog ne predpisuje modela, ponudnika ali velikosti kontekstnega okna.

Ohranite eno trenutno kanonično datoteko REPO_ROOT/ARCHITECTURE.md. Njena projekcija ARCHITECTURE-for-agents.md vsebuje revizijo/zgoščeno vrednost vira in reference na zahteve/invariante. Kodirna vloga navadno bere projekcijo, strategija in ICA pa uporabljata polni vir. Projekcija mora operativno zadostovati za navedeni obseg in ne sme prevladati nad virom. Dejanska vrzel zahteva omejeno strateško pojasnilo, popravek projekcije ali izrecno odobreno branje ustreznega razdelka vira, ne izmišljenih pravil ali samodejnega nalaganja celotnega vira.

Kontekst	Rutinski ali začetni nabor branja	Kaj se ne naloži samodejno
Začetna vzpostavitev	Ustava in navodila začetne vzpostavitve, priloženi polni načrt/arhitektura, razmerja med viri, specifikacije, ustrezna metodologija.	Nepovezana zasebna zgodovina ali skrivnosti izvajalnega okolja.
Zagon/obnovitev kodirne vloge	Minimalni usmerjevalnik, zgoščena kodirna pravila, strnjena arhitektura in komunikacija, natančni aktivni nalog, veljavne varnostne/preskusne pogodbe in pogodbe poddreves, naročeni odlomki.	Polni načrt/arhitektura, strateška pravila, izvorni poglavji OAP, celoten razvojni načrt, prihodnji osnutki, revizija zgoščevanja, zgodovinski register CRITICAL.
Zagon/nova pojavitev strateške vloge	Polna strateška pravila, komunikacija/inicializacija, kanonična polna načrt/arhitektura, razvojni načrt, politika odločanja/pripravljenosti/izvajalnega okolja, trenutni CRITICAL, aktivno stanje, trenutni dokazi repozitorija.	Celotne izvorne knjige in zgodovinska vsebina ob vsakem koraku brez potrebe.
Neodvisna revizija	Človeško določen obseg mejnika, polna arhitektura, natančna združena revizija, ustrezni viri/izvajalno okolje/preskusi, neodvisno pregledani dokazi.	Samodejno prevzemanje strateških sklepov ali pristojnosti kodiranja/združevanja.

Strategija ustrezno gradivo osveži po spremembah, zgoščevanju konteksta, negotovosti in pred kontrolnimi točkami. Jedrnati povzetki stanja pri povezani odločitvi ne nadomestijo avtoritativnih podrobnosti. Izbirno pravilo za CRITICAL v §8.9 ostaja nespremenjeno.

Merite tranzitivni nabor branja, vključno s samodejnim odkrivanjem, obveznimi referencami, veljavnimi varnostnimi/preskusnimi pravili, podedovanimi navodili in podvojenim vnašanjem. Majhen usmerjevalnik, ki posredno zahteva deset dolgih datotek, ne prihrani konteksta. Preverite dejansko odkrivanje in dedovanje v nameščenem odjemalcu: povezava Markdown ne povzroči nujno branja, medtem ko se lahko gnezdeni AGENTS.md naloži ob pregledu poddrevesa. Vire drugih vlog izrecno omejite; zaradi uspeha usmerjevalnega preskusa ne prepisujte nepovezanih globalnih ali nadrejenih navodil.

Dodatek E podaja ponazoritvene, ločeno merjene proračune bajtov/žetonov in preslikavo vira v določbe. Mehanska preverjanja lahko ugotovijo identiteto, navedeno pokritost, velikosti in skladnjo; nameren pomenski pregled mora še vedno presoditi, ali projekcija ohranja pravila.

Celovitost ima štiri področja: nespremenljive vire paketa; trenutno kanonično upravljanje in projekcije; nameščene strateške kopije; ter spreminjajoče se stanje orkestracije/CRITICAL. PR-je, ki spreminjajo upravljanje, primerjajte s sprejeto osnovo in odobrenim obsegom predlagane spremembe. Po sprejemu prizadete strateške kopije osvežite na kontrolni točki brez tekočega dela ter ohranite zasebno konfiguracijo, osnutke, predaje in zgodovino. Urejanje pričakovane zgoščene vrednosti ni odobritev, upravičenega dopisa v živi register pa ni dovoljeno zavrniti, ker se razlikuje od začetnega stanja.

5.8 Izvedba vzpostavitve, nastavitev in operativna aktivacija

Izvedba vzpostavitve sledi pogodbam v dodatku D in ustvari dokaze v dodatku F. V tem profilu skupni datotečni sistem POSIX podpira trajne datoteke nalogov/poročil in lokalna obvestila po poimenovanih ceveh. Cevi so prebujanja; avtoritativno stanje in natančna povezava jih preživita. Operativno čakanje v mirovanju poteka zunaj modelovega sklepanja.

Za novo namestitev uspešna neaktivna predaja pomeni odsotnost oap/active, aktiviranega naloga, izmišljenega poročila/pregleda, poslanega nadzornega signala in delujočih operativnih vlog. Osnutki in konfigurirane cevi lahko obstajajo. Prazen ali nepravilno oblikovan kazalec je napaka, ne neaktivnost. Obstoječi projekti namesto tega ohranijo dejansko stanje; če si to nasprotuje, potrebujejo izrecen omejen prehod. Ponovitev začetne vzpostavitve ni dovoljenje za ponastavitev.

Nastavitveni način odpre dve vzporedni lupini v pravih imenikih z ločenima domačima imenikoma odjemalca za posamezni vlogi. Omogoča izrecno konfiguriranje in prijavo brez aktiviranja naloga ali zagona zanke. Manjkajoče poverilnice, konfiguracija modela ali oddaljeni repozitorij ne smejo preprečiti dostopa do teh lupin. Ločena domača imenika ne dovoljujeta kopiranja avtentikacijskih datotek, zgodovin, piškotkov ali zasebne globalne konfiguracije.

Operativni način preveri aktualnost virov/projekcij, sprejeto osnovo, konfiguracijo nameščenega odjemalca, pripravljenost repozitorija/oddaljenega repozitorija in CI, dejanske meje izvajalnega okolja, lastništvo procesov in izrecno pristojnost za aktivacijo. Kodirna vloga se začne na novo za vsak aktivirani krog; strategija ohrani logično kontinuiteto. Preglejte različico, pomoč in konfiguracijsko vedenje odjemalca, ohranite izrecne izbire modelov in zabeležite manjkajoče predpogoje brez tihega preklopa na drugega ponudnika/model. Konfiguracija razvojnih agentov je ločena od modelov, uporabljenih v izdelku.

Zaganjalniki morajo spoštovati namerni izhod, preprečiti podvojene procese in počistiti le lastne vire. Načini samo za izpis/suhi zagon ne zaženejo agentov; privzeto se ne namesti cron, demon ali samodejno ponovno oživljanje. Lokalna potrditev YES ali true lahko zabeleži odločitev, ne more pa dokazati, da je človek prenesel pristojnost.

Validirano ogrodje lahko ostane blokirano za aktivacijo. Preverjanje paketa, preverjanje pomožnih orodij, pripravljenost za aktivacijo, kvalifikacija izdelka in sprejem mejnika/ciljne kontrolne točke so ločene dokazne plasti. Namestitev ne odobri ustvarjanja oddaljenega repozitorija, objave, prenosov za izdelek/modelskega sklepanja, omrežne izpostavitve, sprememb poverilnic ali spreminjanja zaščitenih storitev. Poznejši prvi delovni nalog zahteva strateško uskladitev in posebej vzpostavljeno človeško/delegirano pristojnost.

---

6. Naknadna človeška presoja in odloženo človeško razsojanje

6.1 Terminologija

Naknadna človeška presoja (HJP) je časovno načelo zasnove: človeška presoja, ki je pred izvajanjem ni mogoče koristno ali gospodarno podati, je namenoma načrtovana po avtonomnem razvoju MVP, namesto da bi prekinjala vsak delovni nalog.

Odloženo človeško razsojanje (DHA) je formalni proces, v katerem človek pozneje vsako zabeleženo začasno odločitev sprejme, zavrne, spremeni ali zahteva dodatne dokaze.

Razmerje je:

flowchart LR
    HJP["Naknadna človeška presoja<br/>časovno načelo"] --> DHA["Odloženo človeško razsojanje<br/>formalni proces"]
    DHA --> CR["CRITICAL.md<br/>register odločitev"]
    CR --> DEC["Človeška razsodba"]
    DEC --> HARD["Delovni nalogi za utrjevanje"]

»HJP« je zapomnljiv in simetričen s HWP. »DHA« je natančen: človek pozneje razsoja med možnostmi, ne zgolj lektorira kode.

6.2 Pravilo obvezne odločitve

Ko strateški agent naleti na pomembno dilemo znotraj svoje delegirane razvojne pristojnosti, se NE SME ustaviti zgolj zato, ker bi bilo udobneje, da odgovornost takoj prevzame človek.

Mora:

1. pregledati veljavno arhitekturo in ustavo;
2. zbrati razpoložljive dokaze;
3. prepoznati verodostojne možnosti;
4. primerjati tveganja, povratnost, obseg posledic in primernost za fazo;
5. izbrati začasno rešitev;
6. izvesti ali naročiti ustrezne omilitve in preskuse;
7. dilemo in odločitev zabeležiti v CRITICAL.md;
8. nadaljevati razvojno zanko.

Strateški agent negotovosti ne sme izbrisati s samozavestno utemeljitvijo. Izrecno jo mora ohraniti.

Avtonomni sistem lahko negotovost začasno razreši, ne sme pa povzročiti, da izgine.

6.3 Česa pravilo obvezne odločitve ne pomeni

»Mora odločiti« ne pomeni »mora izvesti vsako dejanje«.

Od strateškega agenta lahko zahtevamo izbiro arhitekture, hkrati pa mu še vedno prepovemo:

• njeno namestitev v produkcijo;
• uničenje dejanskih produkcijskih podatkov;
• zamenjavo dejanskih poverilnic;
• širitev dejanskega požarnega zidu ali meje javnega omrežja;
• pravno zavezujočo ali etično neprenosljivo izbiro;
• obdelavo dejanskih občutljivih podatkov po neodobrenem modelu zaupanja;
• preglasitev izrecnega človeškega namena izdelka;
• prevzem nepovratne zunanje obveznosti.

Iz te razlike izhajajo trije razredi odločitev.

---

7. Razredi odločitev: D0, D1 in D2

7.1 Razvrstitev

Razred	Pomen	Vedenje strateškega agenta	Čas človeške udeležbe
D0 — Običajna delegirana odločitev	Povratna inženirska izbira z majhnimi posledicami znotraj arhitekture in proračuna tveganja.	Odloči, preskusi, običajno dokumentiraj, nadaljuj.	Posebno razsojanje ni potrebno.
D1 — Odložena kritična presoja	Pomembna, vendar dovolj obvladljiva in povratna odločitev za nadaljnji razvoj. Obstaja več upravičenih možnosti.	Odloči začasno, omili tveganje, dodaj preskuse, zabeleži v CRITICAL.md, združi, če je razvojna kontrolna točka uspešna.	Človek razsodi pred navedeno mejo izdaje/namestitve.
D2 — Neprenosljiva meja	Prestopen bi bil produkcijski, uničujoči, pravni, etični okvir, meja poverilnic, javne izpostavitve ali izrecne človeške pristojnosti.	Analiziraj in priporoči; če je odobreno, smeš varno izvesti v izolaciji; dejanske meje NE SMEŠ prestopiti.	Človeška odobritev je potrebna pred dejanjem.

7.2 Tok odločanja

flowchart TD
    X["Strateška dilema"] --> I{"Dovolj dokazov za razumevanje možnosti?"}
    I -->|Ne| E["Razišči, preskusi, preglej"]
    E --> I
    I -->|Da| B{"Bi dejanje prestopilo neprenosljivo mejo?"}
    B -->|Da| D2["D2: priporoči in se ustavi pred mejo"]
    B -->|Ne| C{"Pomembna negotovost, ki zahteva poznejši človeški sprejem?"}
    C -->|Ne| D0["D0: odloči in nadaljuj"]
    C -->|Da| D1["D1: odloči začasno"]
    D1 --> M["Omili tveganje in preskusi"]
    M --> R["Zabeleži vnos CRITICAL"]
    R --> CONT["Nadaljuj razvoj"]

7.3 Privzete meje D2

Kontrolne točke človeške odobritve iz običajnega OAP naj se praviloma preslikajo v D2:

• produkcijska namestitev;
• združitve ali izdaje, ki neposredno sprožijo produkcijsko namestitev;
• uničujoče operacije nad produkcijskimi ali nenadomestljivimi podatki;
• zamenjava ali razkritje dejanskih poverilnic;
• javne trditve ob izdaji s pravnimi ali pogodbenimi posledicami;
• sprejem tveganih odvisnosti z nerazrešenimi licenčnimi obveznostmi ali obveznostmi dobavne verige;
• širitev dejanskega omrežnega dostopa;
• spreminjanje dejanske produkcijske varnostne zasnove.

Organizacija lahko v vnaprejšnji pripravi doda še druge meje D2.

Pred omogočanjem delegirane združitve za razvoj preglejte dejansko avtomatizacijo, ki jo združitev sproži. Združitev, ki namesti ali izpostavi zaščiteno storitev, je še vedno D2; nastavitvene ali aktivacijske zastavice ne podelijo druge vrste avtonomne pristojnosti za izdajo. Glejte §5.8 in dodatek D.4.

7.4 Primeri

Dilema	Verjetni razred	Razlog
Izbira knjižnice za predpomnjenje A ali B	D0	Rutinska, povratna inženirska izbira.
Logični ali dokončni izbris sintetičnih zapisov samo za demonstracijo	D1	Posledice za celovitost in izvor podatkov, vendar obvladljive.
Združitev vzorca SSRF, ki ga je označil pregledovalnik, za strogimi lokalnimi seznami dovoljenih ciljev za nadaljnji razvoj	D1	Varnostna presoja, ki zahteva poznejši človeški pregled.
Ohranitev nadomestne izvedbe avtentikacije v izolirani demonstraciji	D1, z blokado namestitve	Razvoj se sme nadaljevati, zunanja namestitev pa ne.
Izpostavitev te storitve z nadomestno avtentikacijo javnemu internetu	D2	Prestopek dejanske varnostne meje.
Izbris produkcijskih podatkov strank	D2	Nepovratno, uničujoče, z zunanjimi posledicami.
Nova opredelitev predvidenih uporabnikov ali pravnega namena izdelka	D2	Spremeni pomen izdelka, ki ga določa človek.

---

8. CRITICAL.md: register odloženega človeškega razsojanja

8.1 Namen

CRITICAL.md ni zgolj seznam ranljivosti in ni zgolj tehnični dolg. Je evidenca avtonomne presoje.

Beleži okoliščine, v katerih:

• je strateški agent sprejel pomembno začasno odločitev;
• ostaja morebitna ranljivost;
• je bila varnostna meja omiljena ali razložena;
• je bilo opozorilo pregledovalnika sprejeto ali odloženo;
• pomen avtorizacije ali zaupanja ostaja negotov;
• sta celovitost podatkov ali pomen izbrisa sporna;
• bi bila bližnjica MVP v produkciji nesprejemljiva;
• je predpostavka potrebna, a je človek še ni odobril;
• sta arhitektura in izvedba začasno neusklajeni;
• zunanji dokazi ne zadostujejo za zaupanje v produkcijo.

Obstoječi slaif-agent-site/CRITICAL.md prikazuje osnovni vzorec: avtonomno združeni PR-ji so navedeni s tveganjem, sprejeto odločitvijo in prednostjo pregleda, vključno z izrecnima kontrolnima točkama »pred produkcijo« in »pred kakršnokoli namestitvijo«.

Zapis iz prakse — Register je obstajal, preden je metodologija dobila ime.

Agent-Site je že zbral vrsto avtonomno združenih odločitev o dodeljevanju privilegijev, dokončnem izbrisu, nadomestni avtentikaciji, omilitvah SSRF, ravnanju z zmogljivostnimi žetoni in kontrolnih točkah namestitve. Imenovala se je »Critical Review Queue«, operativno pa je že bila evidenca avtonomne presoje: agent je izbral začasno pot, razvoj se je nadaljeval, obveznost človeškega pregleda pa je ostala vidna. HJP in DHA sta formalizirala nastajajočo prakso, ne pa si je v celoti izmislila na papirju.

8.2 Dolg presoje

Odločitev D1 ustvari dolg presoje: pomembna izbira je bila sprejeta za razvoj, človeški sprejem pa še manjka.

Tehnični dolg je lahko viden v kodi. Dolg presoje je lažje skriti, ker je izvedba lahko videti čista, preskusi lahko uspejo, dokumentacija pa zveni prepričljivo.

Koncentrirani OAP zato sprejme pravilo:

Avtonomija sme kopičiti izvedbeni dolg, ne sme pa kopičiti nevidnega dolga presoje.

8.3 Zahtevana struktura vnosa

Vsak vnos D1 MORA vključevati naslednje. Imena polj in protokolarne vrednosti ostanejo v izvirni obliki:

## CRIT-0001 — Kratek naslov odločitve

- **Status:** OPEN — HUMAN ADJUDICATION REQUIRED
- **Introduced by:** PR #123 / OAP objective 037-a
- **Category:** security | authorization | data integrity | privacy | operations | architecture | dependency | other
- **Severity:** low | medium | high | critical
- **Decision confidence:** low | medium | high
- **Required human gate:** before pilot | before external demo | before production | before irreversible migration
- **Affected components:** ...

### Dilemma
Katero pomembno vprašanje ni imelo jasno predpisanega odgovora?

### Decision taken
Kaj je izbral strateški agent?

### Reasoning
Zakaj je bilo to ocenjeno kot najboljša začasna izbira v trenutni fazi?

### Alternatives considered
Katere verodostojne možnosti so obstajale?

### Strongest argument that this decision is wrong
Navedi najboljši protiargument, ne zgolj formalnega ugovora.

### Assumptions
Kaj mora veljati, da odločitev ostane utemeljena?

### Failure mode and blast radius
Kaj se lahko zgodi, če je odločitev napačna, in kaj bi bilo prizadeto?

### Mitigations and evidence
Kateri preskusi, nadzorni mehanizmi, izolacija, spremljanje ali omejitve zmanjšajo tveganje?

### Reversibility and rollback
Kako je odločitev mogoče pozneje spremeniti? Koliko bi stala migracija?

### Safe autonomous continuation
Zakaj je varno nadaljevati brez takojšnjega človeškega razsojanja? Katero
natančno delo se sme nadaljevati avtonomno in kaj mora ostati blokirano?

### Exact human gate
Pred katero demonstracijo, pilotom, izdajo, namestitvijo, migracijo,
izpostavitvijo ali drugo mejo mora obstajati človeška razsodba?

### Exact question for the human adjudicator
Katero natančno odločitev mora človek nazadnje sprejeti?

### Strategic attestation
ALL FIVE CRITICAL-ENTRY CONDITIONS SATISFIED

### Human disposition
PENDING — dopiši ločeno; tega vnosa ne urejaj.

### Resolution
PENDING — razrešeno le z najnovejšo dopisano človeško razsodbo `ACCEPTED`.

8.4 Prag za vključitev: mehanizem proti balastu

Vnos CRIT-NNNN je dovoljen le, kadar je izpolnjenih vseh pet pogojev:

1. Obstoječa človeška navodila, ustava, arhitektura, aktivni delovni nalog in razpoložljivi dokazi vprašanja ne razrešijo.
2. Strateški agent je dovolj raziskal, da je prepoznal bistveno različne možnosti, in mora eno izbrati.
3. Napačna izbira bi lahko pomembno vplivala na varnost, avtorizacijo, zasebnost, celovitost podatkov, nepovratno izgubo, meje zaupanja, javno izpostavitev, varnost namestitve ali sprejemljivost izdaje.
4. Eno začasno izbiro je mogoče varno izvesti in preskusiti brez prehoda neprenosljive zunanje ali produkcijske meje.
5. Usposobljen človek bi izbiro pred navedeno kontrolno točko lahko upravičeno zavrnil ali bistveno spremenil.

Register izrecno izključuje:

• običajne izvedbene odločitve;
• napake in neuspešne preskuse;
• naloge TODO in znane omejitve;
• prestrukturiranje kode in slogovne izbire;
• običajne izbire odvisnosti;
• špekulativna tveganja brez konkretnih dokazov;
• povratne kompromise z majhnim vplivom;
• ponovljene vnose za isto osnovno dilemo.

Ta prag preprečuje, da bi CRITICAL.md postal priročen predal za negotovost. Strateški agent mora najprej opraviti sklepanje. Register je namenjen pomembnemu dolgu presoje, ne vsemu, kar je nedokončano, neprijetno ali nepopolno.

8.5 Vsak dokončni delovni nalog navede izid razsojanja

V strogem, mehansko uveljavljenem profilu MORA vsak dokončni delovni nalog vsebovati eno od naslednjih izjav:

## Deferred human adjudication
- Decision: NONE

ali:

## Deferred human adjudication
- Decision: APPEND CRIT-0001

NONE je pričakovan v skoraj vsakem nalogu in ne zahteva splošnega obrambnega besedila. Nalog APPEND je neveljaven, če ne vključuje celotnega vnosa strateškega avtorja, skupaj z najmočnejšim argumentom, da je odločitev napačna, predpostavkami, načinom odpovedi in obsegom posledic, omilitvami in dokazi, povrnitvijo, natančnim človeškim vprašanjem, varnim avtonomnim nadaljevanjem, natančno človeško kontrolno točko ter izjavo:

ALL FIVE CRITICAL-ENTRY CONDITIONS SATISFIED

Izvedba v repozitoriju lahko to uveljavi v publish_order.py: zavrne dokončni nalog brez izjave in zavrne APPEND, če vnos ni popoln ali izjava manjka. Pravilo proti balastu se tako iz nasveta pretvori v invarianto objave.

Ta invarianta preverja strukturo, ne vsebinske resničnosti petih pogojev. Strategija še vedno nosi to presojo. Validatorji profila morajo razlikovati med predlogami v ograjenih blokih in živimi vnosi; natančno izločanje vsebine, varne ponovitve in dejanski izvor PR-ja določa dodatek D.6.

8.6 Življenjski cikel po načelu dopisovanja

Agenti smejo dodajati dokaze, omilitve, povezave in podrobnosti izvedbe, ki nadomešča prejšnjo. Zgodovinske dileme ne smejo izbrisati ali je sami označiti kot človeško odobreno.

stateDiagram-v2
    [*] --> OPEN
    OPEN --> MITIGATED: agent doda nadzorne mehanizme ali dokaze
    OPEN --> SUPERSEDED_PENDING: poznejša zasnova nadomesti izvedbo
    OPEN --> OPEN: človeški DEFERRED
    OPEN --> CHANGE_REQUIRED: človeški REJECTED ali CHANGE REQUIRED
    MITIGATED --> CHANGE_REQUIRED: človeški REJECTED ali CHANGE REQUIRED
    SUPERSEDED_PENDING --> CHANGE_REQUIRED: človeški REJECTED ali CHANGE REQUIRED
    CHANGE_REQUIRED --> MITIGATED: agenti izvedejo popravek po človeškem navodilu
    OPEN --> ACCEPTED: človeški ACCEPTED
    MITIGATED --> ACCEPTED: človeški ACCEPTED
    SUPERSEDED_PENDING --> ACCEPTED: človeški ACCEPTED
    ACCEPTED --> [*]

8.7 Človeške razsodbe se dopisujejo, nikoli prepisujejo

Agenti vnosov ne smejo zapirati. Človeška razsodba se dopiše kot ločen zapis, ki ga je mogoče pripisati avtorju:

## HUMAN ADJUDICATION — CRIT-0001 — 2026-09-15
- Decision: ACCEPTED
- Authority: Janez Perš / project owner
- Conditions or required follow-up:
- Evidence/reference:

Dovoljene odločitve so:

ACCEPTED
REJECTED
CHANGE REQUIRED
DEFERRED

Le najnovejša človeška razsodba ACCEPTED razreši registrirano kontrolno točko. DEFERRED, REJECTED in CHANGE REQUIRED ostajajo blokirajoče. Poznejša omilitev ali nadomestna izvedba ne zaključi tiho prvotne presoje; zagotovi dokaze za poznejšo človeško razsodbo.

Mehansko nadzorovani repozitorij naj zagotovi, da check_state.py poroča o:

• vseh identifikatorjih kritičnih vnosov;
• podvojenih identifikatorjih;
• najnovejši človeški razsodbi za vsak vnos;
• vnosih, sprejetih za svojo registrirano kontrolno točko;
• vnosih, katerih kontrolne točke ostajajo odprte.

Ime v polju Authority: ali ujemajoča se kontrolna vsota ne overita človeške odobritve. Projekt potrebuje pot za beleženje, ki jo je mogoče pripisati človeku in je ločena od agentovih dovoljenj za dopisovanje; nepreverjeno avtorstvo ostane blokirajoče. Sprejem razreši le registrirani obseg, ne odobritve namestitve. Dodatek D.6 opisuje te mehanske omejitve, ne da bi predpisal splošni sistem avtentikacije.

8.8 Pravila celovitosti

CRITICAL.md naj upošteva naslednje invariante:

• vsak vnos ima stabilen identifikator, na primer CRIT-0001;
• vsak vnos se sklicuje na PR in cilj, ki sta ga uvedla;
• vnosov ni dovoljeno tiho brisati;
• agent ne more nastaviti HUMAN_ACCEPTED;
• »omiljen« vnos ostane v čakanju do razsojanja;
• orodja za namestitev lahko mehansko prepoznajo odprte blokirajoče vnose;
• povzetke je mogoče ustvarjati, vendar podrobni vnos ostane avtoritativen;
• opozorila varnostnih orodij, sprejeta kot lažno pozitivna, ostanejo vidna do ustrezne človeške kontrolne točke.

8.9 Namerna politika nalaganja konteksta

CRITICAL.md ni datoteka z navodili, ki bi bila vedno naložena. Praviloma naj bo izključena iz opencode.json ali enakovrednega rutinskega seznama navodil, podanega ob vsakem koraku modela.

Namesto tega:

• jo strateški agent prebere ob zagonu, pred kontrolno točko izdaje ali namestitve in kadar postane pomembna povezana dilema ali obstoječi vnos;
• jo kodirni agent prebere le, kadar aktivni delovni nalog zahteva natančen dopis ali ustrezno navzkrižno referenco;
• se lahko rutinsko nalagajo povzetki ali izhod preverjanja stanja, ne pa celotni zgodovinski register.

To ohranja zmogljivost konteksta in preprečuje, da bi register postal preprost nadomestek za novo strateško sklepanje. Agent mora najprej raziskati trenutno vprašanje; CRITICAL.md lahko uporabi za prepoznavanje povezanih preteklih dilem in preprečevanje podvajanja, ne za odlaganje rutinske negotovosti v vrsto.

Uporabite širšo politiko konteksta po vlogah in tranzitivnega branja iz §5.7, ne da bi spreminjali te pogoje branja, specifične za CRITICAL.

---

9. Model dvojne kontrolne točke

9.1 Zakaj sta potrebni dve kontrolni točki

Koncentrirani OAP loči:

1. kontrolno točko združitve za razvoj in
2. človeško kontrolno točko namestitve.

Brez te ločitve bi samodejna strateška združitev nakazovala več zaupanja, kot ga delovni tok dejansko upravičuje.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    PR["PR s preskusi in poročilom"] --> SG{"Strateška razvojna kontrolna točka"}
    SG -->|neuspešno| REPAIR["Popravljalni delovni nalog"]
    REPAIR --> PR
    SG -->|uspešno| MERGE["Združitev v razvojno resnico"]
    MERGE --> MVP["Priporočilo za zaključek mejnika"]
    MVP --> ICA["Neodvisna zaključna revizija"]
    ICA -->|Vrzeli| REPAIR
    ICA -->|Dokazi podpirajo zaključek| HG{"Človeška kontrolna točka namestitve"}
    HG -->|odprte kritične odločitve| DHA["Odloženo človeško razsojanje"]
    DHA --> HARDEN["Delovni nalogi za utrjevanje"]
    HARDEN --> MVP
    HG -->|Izpolnjene kontrolne točke in izrecna odobritev| DEPLOY["Namestitev odobrena"]

9.2 Kontrolna točka združitve za razvoj

Strateški agent sme združiti, kadar:

• je delovni nalog izpolnjen;
• je CI zelen;
• je razlika povezana;
• dokazi zadostujejo za nadaljnji razvoj;
• ni prišlo do dejanja D2;
• so vse odločitve D1 izrecno registrirane;
• združeno stanje ne zatrjuje lažne produkcijske pripravljenosti.

Ta kontrolna točka velja za delo na izdelku šele po meji aktivacije iz §5.8. Nameščena pomožna orodja in uspešna nastavitvena preverjanja je ne izpolnijo.

9.3 Človeška kontrolna točka namestitve

Človeška kontrolna točka namestitve ocenjuje:

• vsak odprti vnos CRITICAL.md, katerega kontrolna točka velja;
• varnostne meje in meje zasebnosti;
• model zaupanja in avtorizacije;
• življenjski cikel podatkov in uničujoče operacije;
• operativno obnovitev in spremljanje;
• zunanjo izpostavitev;
• licence in skladnost, kjer je to pomembno;
• ali je treba odstraniti bližnjice MVP;
• ali sprejeto preostalo tveganje ustreza pripravljenosti organizacije za prevzemanje tveganj.

Pripravljenost za aktivacijo je ločen pripravljalni predpogoj, ne tretja kontrolna točka sprejema ali nadomestek katere od zgornjih dveh. Pred uporabo delegirane združitve za razvoj preglejte stranske učinke združevanja po §7.3 in trenutne dokaze po dodatku D.4.

9.4 Združitev ni enaka odobritvi namestitve

flowchart LR
    M["Strateško združeno"] --> A["Sprejeto za nadaljnji razvoj"]
    M -. ne pomeni .-> P["Človeško odobreno za produkcijo"]
    C["Register CRITICAL razrešen za ciljno kontrolno točko"] --> P
    H["Izrecna človeška odobritev"] --> P

Ta pomenska razlika mora biti vidna v dokumentaciji, zaščiti vej, orodjih za izdajo in organizacijskem sporazumevanju.

V strnjeni obliki:

strateška združitev
=
najboljša razpoložljiva omejena začasna inženirska odločitev,
varna za nadaljnji razvoj

vendar:

strateška združitev
≠
človeška odobritev namestitve prek registrirane kontrolne točke

Odprt kritični vnos zato ni dovoljenje za javno izpostavitev, uporabo produkcijskih ali dejanskih podatkov strank, uničujoče produkcijske spremembe, izklop obveznih nadzornih mehanizmov, širitev zunanjih privilegijev ali končno izdajo prek navedene človeške kontrolne točke.

---

10. Pripravljenost za MVP in produkcijska pripravljenost

Temeljna korist razširitve je poštena ločitev ravni pripravljenosti.

Vidik	Pripravljeno za MVP/demonstracijo	Produkcijsko pripravljeno
Osnovni delovni tok	Deluje za predvideno demonstracijo	Deluje v kvalificiranih operativnih pogojih
Preskusi	Zadostujejo za prikaz izvedenega vedenja	Vključujejo ključne invariante, obnovitev po odpovedi ter varnostne, obremenitvene in operativne preskuse
Varnostne odločitve	Lahko vsebujejo izrecne začasne izbire D1	Blokirajoče izbire so predmet človeške razsodbe in odprave pomanjkljivosti
Avtentikacija	Lahko je izolirana ali začasna, če je izpostavitev jasno blokirana	V celoti izvedena, preskušena, pregledana in operativno upravljana
Podatki	Sintetični, zamenljivi ali strogo nadzorovani	Dejanski življenjski cikel podatkov, hramba, brisanje, varnostno kopiranje in obnovitev so odobreni
Namestitev	Lokalno ali omejeno demonstracijsko okolje	Odobrena infrastruktura in model izpostavitve
CRITICAL.md	Odprti vnosi so dovoljeni, če njihove kontrolne točke niso prestopljene	Brez nerazrešenih vnosov, ki blokirajo ciljno namestitev
Trditve	»MVP«, »demonstracija«, »prototip« ali podobno poštena oznaka	Trditve ustrezajo preverjenemu produkcijskemu obsegu

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    IDEA["Zamisel"] --> HWP["Paket HWP"]
    HWP --> DEV["Razvoj s koncentriranim OAP"]
    DEV --> ICA["Priporočilo za zaključek in ICA"]
    ICA -->|Vrzeli| DEV
    ICA -->|Dokazi o mejniku podpirajo trditev| MVP["Pripravljeno za MVP/demonstracijo"]
    MVP --> VALUE{"Demonstracija potrdi vrednost?"}
    VALUE -->|Ne| STOP["Ustavi, preusmeri ali arhiviraj"]
    VALUE -->|Da| DHA["DHA in utrjevanje"]
    DHA --> RECHECK["Posodobljeni dokazi in ponovitev ICA, kjer je ustrezno"]
    RECHECK --> GATE["Človeška ciljna kontrolna točka in izrecna odobritev"]
    GATE --> PROD["Produkcijsko pripravljeno"]

To je posebej dragoceno za MSP. Utrjevanje za zahtevno poslovno uporabo je drago. Ni nujno, da mora predhoditi dokazu, da je izdelek uporaben. Toda demonstracijske bližnjice ne smejo postati nevidne produkcijske privzete izbire.

10.1 Neodvisna zaključna revizija: varovalo pred samoocenjevanjem mejnika

Koncentrirani OAP ustvarja neobičajno močno tveganje samopotrjevanja. Ista strateška vloga je lahko:

• razložila vnaprejšnjo pripravo;
• napisala razvojni načrt in delovne naloge;
• pregledala poročila o izvedbi;
• izdala popravke;
• združila PR-je;
• povzela napredek;
• in se nazadnje vprašala, ali je mejnik dokončan.

Ta vloga lahko priporoči zaključek, ne sme pa ga sama potrditi le na podlagi svoje vrste nalogov in pripovedi. Pred oznako »MVP dokončan«, »kandidat za izdajo« ali enakovrednim arhitekturno določenim mejnikom izvedite neodvisno zaključno revizijo (ICA) s svežim modelom/kontekstom, izrecno kritičnim načinom pregleda ali neodvisnim človekom/revizijskim agentom.

flowchart TD
    LOOP["Zanka koncentriranega OAP"] --> CLAIM["Strateško priporočilo za zaključek"]
    CLAIM --> ICA["Neodvisna zaključna revizija"]
    ARCH["Človeški obseg in arhitektura"] --> ICA
    MAIN["Trenutna združena veja main"] --> ICA
    EVID["Dokazi, zvesti dejanskim mejam"] --> ICA
    REPORTS["Nalogi, poročila, trditve v README"] -. samo trditve .-> ICA
    ICA --> GAPS{"Vrzeli ali nedokazane zahteve?"}
    GAPS -->|Da| FIX["Novi zaključni nalogi s sledljivim izvorom"]
    FIX --> LOOP
    GAPS -->|Ne| DHA["Človeško razsojanje in ciljna kontrolna točka"]
    LOOP --> REPEAT["Ponovi ICA po zaključnem delu"]
    REPEAT --> ICA

Revizija vsako zahtevo razvrsti kot izvedeno, delno, odsotno ali nedokazano. Dokončanje vseh točk zaključnega načrta ne zadostuje; sam načrt je lahko izpustil arhitekturne zahteve, zato se revizija po odpravi pomanjkljivosti ponovi.

Profil začetne vzpostavitve pripravi vsebinsko matriko zahtev, izpeljano iz projekta, protokol ICA, predloge zahteve/poročila/matrike in osnutke zahtev za posamezne mejnike. Načrtovano delo se pošteno začne kot nedokazano ali odsotno, ne z vnaprejšnjo oznako izvedeno. Vsaka revizijska vrstica poveže zahtevo in vir s kodo/izvajalnimi potmi, ki jo uveljavljajo, preskusi in negativnimi potmi, omejitvami ter natančno revidirano združeno revizijo; uporablja IMPLEMENTED, PARTIAL, ABSENT ali UNPROVEN.

Zabeležite izvor revizorja/konteksta in aktualnost dokazov. Nov kontekst sam po sebi ne vzpostavi neodvisnosti; generatorjev lastni drugi pregled ni ICA. Revizor z omejenim obsegom izhaja iz celotnega človeškega/arhitekturnega obsega in trenutnih dokazov, ne iz strateške pripovedi o napredku, ter ne dobi pristojnosti za izvedbo ali združevanje. Pomembne poznejše spremembe zahtevajo novo presojo. Vsak rutinski omejeni PR ne zahteva ICA mejnika, ICA sama pa ne odobri namestitve. Dodatek F loči te dokazne plasti.

Zapis iz prakse — »Ne zaupajte agentom.«

Med izvajanjem Agent-Site je spremljajoča avtonomna dokazna sled dosegla oznako »100 % MVP«. Človek je naročil novo oceno iz arhitekture in trenutnega main: »Ne zaupajte agentom.« Kritična revizija je poročila, opise PR-jev, odstotke v README in povzetke zelenih preverjanj obravnavala kot trditve, dokler jih niso podprle koda in izvajalne poti. Odkrila je več bistvenih poti, ki so bile še vedno sintetične, nadomestne ali nepovezane, in neformalno oceno dokončanosti znižala na približno 40 odstotkov.

Nastalo zaključno zaporedje je bilo bistveno boljše, toda drug pregled je opazil, da lahko tudi to izpusti MCP, popolne medijske operacije, rekonstrukcijo virov in nekatere vizualne cilje. Nauk je bil ostrejši od »enkrat opravi revizijo«: zaključni načrt ni dokaz, da je zaključni načrt popoln.

---

11. Celoten življenjski cikel HWP–OAP–HJP

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    subgraph BEFORE["Pred zanko: HWP in priprava referenčnega profila"]
        B1["Usklajen načrt in dokončni viri"] --> B2["Načrtovalni model zasnuje paket"]
        B2 --> B3["Projektno specifičen vhodni ZIP"]
        B3 --> B4["Ločena izvedba začetne vzpostavitve"]
        B4 --> B5{"Validacija končana?"}
        B5 -->|Ne| HOLD["Nedokončano: popravi znotraj obsega nastavitve"]
        HOLD --> B4
        B5 -->|Da| INACTIVE["Nameščeno in neaktivno"]
        INACTIVE --> READY{"Predpogoji in pristojnost za aktivacijo?"}
        READY -->|Manjkajo| WAIT["Ostani neaktiven; dokončaj nastavitev"]
        WAIT --> READY
    end

    subgraph LOOP["Koncentrirani avtonomni OAP"]
        S["Strateški agent"]
        C["Kodirni agent"]
        PR["PR, CI, preskusi, poročilo"]
        CR["Posodobitve CRITICAL.md"]
        S --> C
        C --> PR
        PR --> S
        S --> CR
        S -->|združitev ali popravljalni nalog| C
    end

    subgraph AFTER["Po MVP: naknadna človeška presoja"]
        A1["Človek pregleda veljavne kontrolne točke in CRITICAL"] --> A2["Sprejmi, zavrni, spremeni ali odloži"]
        A3["Delovni nalogi za utrjevanje"]
        A4["Izrecna človeška odobritev namestitve"]
    end

    READY -->|Vzpostavljeni| ACTIVATE["Izrecna operativna aktivacija"]
    ACTIVATE --> S
    LOOP --> CLAIM["Strateško priporočilo za zaključek"]
    CLAIM --> ICA["Neodvisna zaključna revizija"]
    ICA -->|vrzeli| LOOP
    ICA -->|pokritost dokazana| AFTER
    A2 -->|odprava pomanjkljivosti ali dodatni dokazi| A3
    A3 --> LOOP
    A2 -->|Dokazi in veljavne kontrolne točke zadostujejo| A4

Človek ni odstranjen. Njegovo delo je prerazporejeno:

• pred zanko: zgoščeno arhitekturno delo in delo na upravljanju;
• med zanko: le izjemno posredovanje;
• po neodvisni potrditvi zaključka trditve o MVP: usmerjeno razsojanje o zabeleženem dolgu presoje;
• pred namestitvijo: izrecna odobritev.

Koraki paketa/izvedbe vzpostavitve ponazarjajo referenčni profil; obstoječa pravila HWP, ICA in človeške pristojnosti veljajo za vsako izvedbo. Manjkajoča validacija ali predpogoji za aktivacijo pustijo pripravo neaktivno in nikoli samodejno ne zaženejo dela na izdelku.

---

12. Običajni in koncentrirani OAP

Vidik	Običajni OAP	Koncentrirani OAP s HWP/HJP
Človeška vloga	Človek je na voljo pri ponavljajočih se strateških pregledih in kontrolnih točkah odobritve.	Človek delo zgosti pred zanko ter se vrne na kontrolnih točkah mejnika/razsojanja/namestitve.
Začetna priprava	Strateško raziskovanje in ustava predhodita izvajanju.	Veliko poglobljenejša vnaprejšnja priprava: arhitektura, razvojni načrt, zaporedje nalogov, razvrstitev odločitev, pravila kritičnega registra in pomen pripravljenosti.
Strateška UI	Svetovalna nadzorna ravnina in prvi pregledovalec.	Logično trajni delegirani nadzornik razvoja, avtoriteta za delovne naloge, prvi pregledovalec in pogojna avtoriteta za združevanje.
Kodirni agent	Izvaja delo v obsegu PR-ja in vrača dokaze.	Enako, pogosto bolj zamenljiv in mehansko voden s strateškimi delovnimi nalogi.
Pristojnost za združitev	Za zaščitene veje je navadno potrebna človeška odobritev.	Strateški agent sme pod strogo politiko združevati razvojne PR-je; človek ohrani pristojnost za izdajo/namestitev.
Zahtevna dilema	Strateška UI lahko pripravi vprašanje za človeško odločitev.	Strateška UI mora odločiti pri D0/D1; D1 se zabeleži za poznejše razsojanje.
Človeška prekinitev	Pričakovana pri pomembnih točkah pregleda in odobritve.	Med razvojem zmanjšana na minimum; namenjena D2 ali izrecnim kontrolnim točkam mejnika.
Ravnanje z negotovostjo	Pogosto predstavljena v povzetku za odločanje pred združitvijo ali izdajo.	Pretvorjena v viden dolg presoje v CRITICAL.md; razvoj se sme nadaljevati.
Ključni artefakt	Povzetek za odločanje, poročilo o pregledu, seznam odprave pomanjkljivosti.	Vsi običajni artefakti in trajni register odloženega človeškega razsojanja.
Model pripravljenosti	Človek sproti presoja pripravljenost za združitev in izdajo.	Izrecna dvojna pripravljenost: sprejem za razvoj/MVP v primerjavi z odobritvijo produkcije.
Trditev o dokončanosti mejnika	Človeški in strateški pregled potrdita dokončanost na običajnih kontrolnih točkah.	Koncentrirana zanka sme priporočiti zaključek, vendar mora pred sprejemom mejnika prestati novo neodvisno zaključno revizijo.
Odnos do tveganja	Konservativen ritem pod človeškim upravljanjem.	Visoka razvojna hitrost s strogim omejevanjem in odloženo kontrolno točko namestitve.
Najprimernejša uporaba	Delo z visokim tveganjem, spreminjajoči se cilji ali ekipe, ki potrebujejo pogost človeški nadzor.	Dobro vnaprej pripravljeni programi MVP, časovni pritisk, izolirana okolja in MSP, ki dokazujejo vrednost pred utrjevanjem.
Ponovljiva začetna vzpostavitev	Lahko uporablja ločene delovne prostore in orodja za začetno vzpostavitev.	Izbirni referenčni profil usklajeno načrtovanje pretvori v vhode, vzpostavi ogrodje in se ustavi pred aktivacijo.
Nalaganje upravljanja/konteksta	Lahko uporablja jedrnate ustave in izbirni kontekst.	Referenčni profil izrecno določa polna strateška pravila, izvajalčeve projekcije, tranzitivne proračune in nadzorovano osvežitev.

12.1 Razporeditev človeške pozornosti

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    subgraph Ordinary["Običajni OAP"]
        direction TB
        O1["Človeško raziskovanje"]
        O2["Delo agenta"]
        O3["Človeški pregled"]
        O4["Agentov popravek"]
        O5["Človeška odločitev o združitvi"]
        O6["Naslednji cikel"]
        O1 --> O2 --> O3 --> O4 --> O5 --> O6
    end

    subgraph Concentrated["Koncentrirani OAP"]
        direction TB
        C1["Obsežna človeška vnaprejšnja priprava"]
        C2["Dolgo obdobje avtonomnega razvoja"]
        C3["Priporočilo za zaključek in ICA"]
        C4["Usmerjeno človeško razsojanje"]
        C5["Avtonomno utrjevanje"]
        C6["Človeška odločitev o namestitvi"]
        C1 --> C2 --> C3 --> C4
        C3 -->|Vrzeli| C2
        C4 -->|Odprava pomanjkljivosti| C5
        C5 --> C3
        C4 -->|Dokazi in veljavne kontrolne točke zadostujejo| C6
    end

---

13. Pristojnost in odgovornost

13.1 Matrika pristojnosti

Dejavnost	Človek	Strateški agent	Kodirni agent
Določanje namena izdelka in domenske resnice	Določa	Svetuje in kritično preverja	Brez pristojnosti
Določanje pripravljenosti za prevzemanje tveganj in meja D2	Določa	Pripravi osnutek in uporablja	Mora upoštevati
Vzdrževanje arhitekture	Odobri temeljni namen	Vodi delegirani razvoj	Izvaja naročene spremembe
Ustvarjanje delovnih nalogov	Sme usmerjati	Primarna pristojnost	Brez pristojnosti za samostojno dodeljevanje širokih ciljev
Izvedba in preskušanje	Neobvezno usmerjeno delo	Pregleduje	Primarna pristojnost
Ustvarjanje/dopolnjevanje PR-ja	Neobvezno	Nadzoruje	Primarna pristojnost
Pregled PR-ja in CI	Sme pregledati	Primarni razvojni pregledovalec	Predloži dokaze, ne sme sam odobriti
Združitev razvojnega PR-ja	Delegirana s politiko	Pogojna pristojnost	Nikoli
Beleženje presoje D1	Sme dodati	Določi potrebnost, napiše natančen vnos, dodeli ID	Sme poročati o kandidatu; vnosa ne sme izumiti ali prepisati
Razrešitev vnosa CRITICAL.md	Izključna končna pristojnost	Priporoča	Izvede nastalo delo
Prehod meje D2	Izključna pristojnost	Mora se ustaviti pred dejanjem	Ne sme ukrepati
Odobritev produkcijske namestitve	Izključna pristojnost	Pripravi dokaze	Izvede šele po odobritvi
Končna odgovornost	Jo ohrani	Je ne nosi	Je ne nosi

13.2 Tok pristojnosti

flowchart TD
    H["Človeška pristojnost<br/>namen, tveganje, razsojanje, namestitev"] --> S["Delegirana strateška pristojnost<br/>načrtovanje, pregled, združitev za razvoj"]
    S --> C["Delegirana kodirna pristojnost<br/>izvedba, preskušanje, PR"]
    C --> G["Dokazi GitHuba in CI"]
    G --> S
    S --> CR["Register presoje CRITICAL"]
    CR --> H

Delegiranje ne prenese končne odgovornosti. Človek ali organizacija ostaja odgovoren za sistem in odločitev o njegovi namestitvi.

13.3 Avtorstvo in mehanika dopisovanja

Strateški agent je pristojen za presojo, ali je vnos upravičen. Raziskati mora vprašanje, sprejeti začasno odločitev, dodeliti naslednji identifikator CRIT-NNNN, napisati natančen vnos, ga vključiti v trenutni delovni nalog ali popravljalni nalog istega PR-ja in preveriti dopis brez sprememb prejšnjih vnosov. Če je nadaljnji razvoj varen in je kontrolna točka združitve za razvoj uspešna, sme še vedno združiti, ob tem pa ohraniti človeško kontrolno točko.

Kodirni agent kritičnega vnosa ne sme izumiti ali prepisati strateške presoje. Dopiše lahko le natančno naročene bajte, po možnosti z ozko omejenim pomožnim orodjem, kot je:

python oap/bin/append_critical.py \
  --repo-root "$REPO_ROOT" \
  --source /path/to/strategic-authored-entry.md \
  --id CRIT-0001

Dopis sodi v običajno izvedbeno delo in je potrjen pred zajemom izvedbenega SHA-ja. Nikoli ne sme biti prikrito dodan v končno potrditev sprememb samo za poročilo. Kodirni agent vnosa ne sme urejati, brisati, slabiti, zapirati ali ga označiti kot človeško odobrenega.

Če kodirni agent sam odkrije morebitno pomembno vprašanje, sme z dokazi poročati o kandidatu. Le strateški agent sme odločiti, ali je prag petih pogojev izpolnjen, in naročiti dopis.

V referenčnem profilu mora PR, ki uvaja vnos, dejansko obstajati: če ob dokončanju naloga še ni znan, vzpostavite varen predhodni PR in izdajte nadaljevanje istega PR-ja s popolnim vnosom pred razvojnim sprejemom te začasne izbire. Kodirna vloga nadomestnih oznak ne sme zamenjati z lastno presojo. Dodatek D.6 določa preverjanja dopisovanja/ponovitev, ki ohranjajo bajte; dodatek D.4 pa ločeno potrditev sprememb SELF, namenjeno samo poročilu, in pregled trenutnega vrha veje.

---

14. Protokol odločanja strateškega agenta

Ko se pojavi dilema D1, naj strateški agent sledi ponovljivemu protokolu, namesto da improvizira prepričljivo utemeljitev.

14.1 Postopek odločanja

1. Dilemo natančno poimenuj. Izogibaj se nejasnemu jeziku, kot je »varnost bi lahko bila vprašljiva«.
2. Poišči veljavno avtoriteto. Navedi arhitekturo, ustavo, delovni nalog, preskuse, standarde ali kodo.
3. Pripravi verodostojne možnosti. Kjer je mogoče, vključi vsaj en bistveno drugačen pristop.
4. Oceni primernost za fazo. Dobra odločitev za MVP je lahko slaba odločitev za produkcijo.
5. Daj prednost povratnosti. V negotovosti izberi možnost, ki ohrani prihodnji popravek.
6. Daj prednost omejevanju. Začasno tveganje omeji na lokalni, sintetični ali neprodukcijski kontekst.
7. Daj prednost varni zavrnitvi ob napaki pri varnosti in avtorizaciji, razen če vnaprejšnja priprava izrecno določa drugače.
8. Izberi. Pri D1 ne končaj z »odločiti bi se moral človek«.
9. Omili tveganje in preskusi. Dodaj nadzorne mehanizme, sorazmerne začasnemu tveganju.
10. Napiši najmočnejši protiargument. Pojasni, kako bi lahko bila odločitev napačna.
11. Zabeleži vnos. Potrdi CRITICAL.md v istem PR-ju ali pred strateško združitvijo.
12. Nadaljuj. Preidi na naslednji cilj, razen če je dosežena meja D2.

flowchart LR
    N["Poimenuj dilemo"] --> G["Poišči veljavne omejitve"]
    G --> A["Primerjaj možnosti"]
    A --> S["Oceni fazo, povratnost in omejevanje"]
    S --> D["Sprejmi začasno odločitev"]
    D --> T["Omili tveganje in preskusi"]
    T --> X["Napiši najmočnejši protiargument"]
    X --> C["Potrdi vnos CRITICAL"]
    C --> M["Združi za nadaljnji razvoj"]

14.2 Zaupanje ni dovoljenje za izpustitev

Strateška odločitev z visokim zaupanjem je lahko še vedno D1, če so posledice velike. Odločitev z nizkim zaupanjem ni samodejno D2, če ostaja povratna in omejena.

Razvrstitev je odvisna od pristojnosti in posledic, ne le od modelovega zaupanja.

14.3 Dovoljeni razlogi za ustavitev

Strateški agent se SME ustaviti in zahtevati takojšnje človeško posredovanje, kadar:

• bi bila sicer prestopljena meja D2;
• si izrecna projektna navodila nerešljivo nasprotujejo;
• manjka zahtevani človeški namen izdelka in bi vsaka izbira na novo opredelila izdelek;
• bi skorajšnje dejanje lahko povzročilo nepovratno škodo;
• razpoložljivi dokazi ne zadostujejo niti za izbiro obvladljive začasne poti;
• pravne, etične, pogodbene ali organizacijske pristojnosti ni mogoče prenesti;
• izvajalno okolje predlaganega dela ne more varno izolirati.

NE SME se ustaviti zgolj zato, ker:

• obstajata dve razumni knjižnici;
• je povratna arhitekturna izbira neprijetna;
• strateški agent želi, da človek prevzame odgovornost za ugled;
• popolna gotovost ni na voljo;
• produkcijsko utrjevanje ni končano, trenutno delo pa je omejeno na razvoj MVP.

---

15. Načini odpovedi, ki jih uvede razširitev

Koncentrirani OAP poveča avtonomijo in zato uvede tveganja, ki presegajo običajni OAP.

15.1 Strateško samoopravičevanje

Isti model lahko izbere zasnovo in nato pregleda lastno sklepanje. Ustvari lahko povezano, a pristransko razlago.

Omilitve:

• obvezen razdelek z najmočnejšim protiargumentom;
• ločeni kodirna in strateška vloga;
• neodvisni CI in pregledovalniki;
• revizija z zunanjim modelom ali človekom ob mejnikih;
• izrecno navedeno zaupanje in predpostavke;
• povezave do dokazov namesto zgolj besedilne utemeljitve.

15.2 Manjkajoči kritični vnosi

Največja nevarnost ni slaba zabeležena odločitev, temveč nezabeležena odločitev.

Omilitve:

• predloga delovnega naloga vpraša, ali so bile uvedene odločitve D1;
• kodirno poročilo vsebuje razdelek o odkritih kritičnih odločitvah;
• kontrolni seznam strateške združitve zahteva pregled CRITICAL.md;
• samodejna pravila za razlike označijo spremembe avtentikacije/avtorizacije, dovoljenj, brisanja, omrežja, poverilnic, migracij, varnostne politike in hrambe podatkov;
• orodja za izdajo zavrnejo nadaljevanje, če zahtevani kritični metapodatki manjkajo.

15.3 Medsebojno stopnjevanje začasnih odločitev

Več posamezno zagovarjanih bližnjic se lahko združi v nevarno arhitekturo.

flowchart LR
    D1A["Bližnjica D1 pri avtentikaciji/avtorizaciji"] --> C["Združen sistem"]
    D1B["Omrežna bližnjica D1"] --> C
    D1C["Bližnjica D1 pri beleženju"] --> C
    C --> X["Nastalo visoko tveganje"]

Omilitve: občasni skupni pregled celotnega CRITICAL.md, ne le pregled posameznih vnosov; povezave odvisnosti med vnosi; osvežitev modela groženj na ravni mejnika.

15.4 Nenadzorovan prehod demonstracije v produkcijo

Uspešna demonstracija ustvari organizacijski pritisk za takojšnjo namestitev.

Omilitve:

• izrecne oznake pripravljenosti;
• kontrolna točka namestitve v CI/CD;
• izolacija lokalnega/demonstracijskega okolja;
• opozorilo CRITICAL.md v opombah ob izdaji;
• brez produkcijskih poverilnic v izvajalnem okolju MVP;
• ločen žeton odobritve namestitve ali ročno pravilo zaščite okolja.

15.5 Zastarela vnaprejšnja priprava

Človeška vnaprejšnja priprava lahko z razvojem zahtev postane napačna.

Omilitve: arhitekturne odločitve pod nadzorom različic, strateška preverjanja odmikov, občasna osvežitev HWP in razvrstitev D2, kadar bi izvedba nasprotovala namenu, ki ga določa človek.

15.6 Neobvladljiv zaostanek razsojanja

Če vsaka manjša izbira postane D1, CRITICAL.md postane šum.

Omilitve: jasni pragi D0/D1, odpravljanje podvajanja, združevanje povezanih vnosov, polja resnosti in kontrolnih točk ter triaža ob mejnikih.

15.7 Strateško samopotrjevanje mejnika

Strateško povezan sistem lahko še vedno preceni lastno dokončanost, ker se izpustitve kopičijo v isti zanki arhitekture, izvedbe, pregleda in poročanja.

Omilitve: obvezna neodvisna zaključna revizija ob določenih mejnikih; matrike zahtev od arhitekture do trenutnega main; poročila kot trditve, ne dokazi; ponovljena revizija po odpravi pomanjkljivosti; človeška pristojnost nad končno oznako mejnika.

Naslednja tveganja zasnove obravnava ponovno uporabni referenčni profil; ne gre za dodatna opažanja praktične vaje.

15.8 Mešanje vlog zaradi odkrivanja navodil

Vloga začetne vzpostavitve, kodiranja, strategije ali revizije podeduje navodila druge vloge ali pregled razume kot dovoljenje za delovanje.

Omilitve: različni, negnezdeni koreni, minimalni usmerjevalnik, izrecna identiteta zaganjalnika in modelu vidno usmerjanje, zaščiteni viri vlog, varna imena arhivskih datotek in preverjanje dejanskega odkrivanja pri odjemalcu. Usmerjanje s pozivi ni varnostna meja operacijskega sistema.

15.9 Zgoščevanje z izgubo pomena in posredno napihovanje konteksta

Povzetek izpusti prepoved ali izjemo oziroma majhen usmerjevalnik posredno naloži celotno knjižnico virov.

Omilitve: stabilna preslikava vira v določbe, nameren pomenski pregled, merjenje tranzitivnega nabora branja, naveden obseg projekcije in omejeno pojasnjevanje. Zgoščenost nikoli ne dovoljuje krajšanja z izgubo vsebine ali dvoumnih pravil.

15.10 Razhajanje vira, projekcije in nameščene kopije

Strnjena arhitektura zastara, zasebne strateške kopije se razidejo ali kontrolna vsota začetnega stanja napačno zamrzne živi register.

Omilitve: ločena področja celovitosti, primerjava sprejetega in predlaganega stanja, odobrena osvežitev na kontrolni točki brez tekočega dela ter ohranjena zgodovina.

15.11 Nenamerna aktivacija med nastavitvijo

Razširjanje arhiva, ponovitve zagona, prijavne lupine ali potrditvena zastavica začnejo delo na izdelku ali sprožijo zaščitene oddaljene učinke.

Omilitve: ločene faze paketa, izvedbe vzpostavitve, nastavitve in aktivacije; odsotnost aktivnega kazalca pri novem projektu; preverjanje brez zapisovanja/zagona; ohranitev obstoječega stanja; pregled avtomatizacije, sprožene z združitvijo.

15.12 Lažno zaupanje zaradi validacije začetne vzpostavitve

Obstoj datotek, preskusi z nadomestnim odjemalcem ali dovršeno potrdilo so zamenjani za kvalifikacijo dejanskega odjemalca, izvajanje izdelka, ICA ali odobritev izdaje.

Omilitve: ločene dokazne plasti, pošteno besedišče rezultatov, natančne preskušene meje in revizije, neodvisna revizija mejnika ter človeške ciljne kontrolne točke.

---

16. Primer uporabe za MSP in MVP

16.1 Zakaj model ustreza MSP

MSP se pogosto soočajo z gospodarskim problemom po fazah:

1. dokazati, da izdelek ali notranje orodje ustvarja vrednost;
2. pridobiti odobritev vodstva, stranke ali financerja;
3. šele nato upravičiti utrjevanje za zahtevno poslovno uporabo in operativno integracijo.

Zahteva po popolni produkcijski zrelosti pred validacijo lahko porabi redko strokovno znanje za izdelek, ki morda nikoli ne bo odobren. Popolna opustitev utrjevanja pa ustvarja nevaren nenadzorovan prehod prototipa v produkcijo.

Koncentrirani OAP ponuja tretjo pot:

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TD
    SME["Potreba MSP"] --> PRE["Koncentrirana strokovna vnaprejšnja priprava"]
    PRE --> AUTO["Avtonomna predaja MVP"]
    AUTO --> DEMO["Demonstracija s pošteno oznako pripravljenosti"]
    DEMO --> DEC{"Poslovna vrednost potrjena?"}
    DEC -->|Ne| ARCHIVE["Ustavi brez celotnega stroška utrjevanja"]
    DEC -->|Da| REVIEW["Človeško razsojanje in sprejem tveganja"]
    REVIEW --> HARDEN["Agentsko produkcijsko utrjevanje"]
    HARDEN --> ICA["ICA glede na trenutne dokaze mejnika"]
    ICA -->|Vrzeli| HARDEN
    ICA -->|Dokazi podpirajo cilj| GATE["Izrecna človeška odobritev cilja"]
    GATE --> DEPLOY["Nadzorovana namestitev"]

16.2 Zakaj je to odgovoren pospešen delovni tok

Delovni tok ne pomeni »hitro napreduj in prezri varnost«. Pomeni:

• hitro napreduj znotraj omejenega razvojnega okolja;
• ohrani vsako pomembno nerazrešeno presojo;
• prepovej neprenosljiva produkcijska dejanja;
• dokaži poslovno vrednost pred celotnim vlaganjem v utrjevanje;
• pred izpostavitvijo opravi usmerjen človeški pregled;
• zavrnjene začasne odločitve pretvori v nove delovne naloge;
• ohrani poštene trditve ob izdaji.

16.3 Pripravljenost za prevzemanje tveganj po fazah

Faza	Dovoljeno stanje
Lokalni razvoj	Odločitve D0 in omejene D1 so dovoljene; D2 je prepovedan.
Notranja demonstracija s sintetičnimi podatki	Odprti vnosi D1 so dovoljeni, če je njihova navedena kontrolna točka poznejša in je izolacija preverjena.
Zunanja demonstracija ali nadzorovani pilot	O vnosih, ki vplivajo na izpostavitev, avtentikacijo/avtorizacijo, zasebnost, podatke in pogodbene trditve, mora človek najprej razsoditi.
Produkcija	Vsi vnosi, ki blokirajo produkcijo, morajo biti razrešeni; preostala sprejeta tveganja morajo biti izrecna.

---

17. Pot uvajanja iz običajnega OAP

Obstoječi projekt OAP lahko razširitev uvede postopoma.

flowchart LR
    O["Običajni OAP"] --> A1["Dodaj poglobljen paket HWP"]
    A1 --> A2["Opredeli D0 D1 D2"]
    A2 --> A3["Ustvari CRITICAL.md"]
    A3 --> A4["Zahtevaj obvezne odločitve D1"]
    A4 --> A5["Delegiraj strateško združitev za razvoj"]
    A5 --> A6["Dodaj kontrolno točko namestitve"]
    A6 --> A7["Zahtevaj neodvisno zaključno revizijo"]
    A7 --> A8["Načrtuj mejnik DHA"]

Korak 1: poglobite vnaprejšnjo pripravo

Dodajte podrobno arhitekturo, odnos do tveganj, opredelitve mejnikov, necilje, razvojni načrt delovnih nalogov in ravni pripravljenosti.

Korak 2: opredelite delegirani prostor odločanja

Določite D0, D1 in D2 s primeri, specifičnimi za repozitorij.

Korak 3: ustvarite CRITICAL.md

Predlogo potrdite pred začetkom avtonomnega razvoja. Njen pregled naj bo del vsake strateške združitve.

Korak 4: spremenite strateško ustavo

Od strateškega agenta zahtevajte odločanje o dilemah D1 in mu prepovejte, da bi predajo vprašanja človeku uporabljal kot privzeti izhod.

Korak 5: previdno delegirajte združitev za razvoj

Strateško združitev dovolite šele po preverjanju CI, dokazov, obsega in kritičnega registra. Produkcijske namestitve ne delegirajte.

Korak 6: uveljavite pomen pripravljenosti

Dodajte oznake MVP/demonstracije, opombe ob izdaji in preverjanja CI/CD, ki ločijo združeno razvojno resnico od produkcijske resnice, pripravljene za namestitev.

Korak 7: zahtevajte neodvisno zaključno revizijo

Preden strateški agent sme arhitekturno določen mejnik označiti kot dokončan, zahtevajte revizijo arhitekture glede na trenutni main, ki ne izhaja iz agentove lastne pripovedi o dokončanosti. Po zaključnem delu jo ponovite.

Korak 8: načrtujte DHA

Določite, kdaj bo potekalo intenzivno človeško razsojanje: ob dokončanju MVP, pred zunanjo demonstracijo, pred pilotom, pred produkcijo ali ob več mejnikih.

17.1 Uporaba ponovno uporabnega generatorja paketa za začetno vzpostavitev

1. Dokončajte načrtovanje v pogovoru z usklajenim namenom, obsegom, arhitekturo, omejitvami in sprejemnimi merili. Priložite dokončne izvorne datoteke, kadar so pomembni njihovi natančni bajti.
2. V isti načrtovalni pogovor prilepite celoten ponovno uporabni poziv za generiranje paketa za začetno vzpostavitev. Uporabi obstoječi projektni kontekst; ne zahteva ponovnega izpolnjevanja splošnega vprašalnika ali izmišljanja novega načrta.
3. Preglejte nastali projektno specifični vhodni ZIP, preslikavo virov, predpostavke in predlagane ciljne poti. Vsebuje vhode in pogodbe, ne kode aplikacije ali delujoče namestitve.
4. Razširite ga v nov prazen začasni imenik, ločen od obeh operativnih delovnih prostorov in ne nad njima. AGENTS.md mora biti neposredno v korenu razširjenega arhiva, brez dodatnega ovojnega imenika.
5. V tem imeniku zaženite sposobnega agenta za začetno vzpostavitev z orodji, znotraj dogovorjene meje izvedbe vzpostavitve, s spodnjim kratkim pozivom.
6. Preglejte BOOTSTRAP-RECEIPT.md, dejanske rezultate validacije, manjkajoče predpogoje in neaktivno stanje. Manjkajoče oddaljene poverilnice ali poverilnice modela lahko validno ogrodje pustijo blokirano za aktivacijo.
7. Prek nastavitvenega načina dokončajte konfiguracijo posameznih vlog, preverite meje izvajalnega okolja/oddaljenega sistema/pristojnosti in ločeno odobrite operativno aktivacijo. Strategija pred aktiviranjem prvega ustreznega naloga uskladi trenutna dejstva.

Ponovno uporaben vir za načrtovanje

Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, različica 1.0.

Prenesi generatorski poziv (.md, angleščina)

Preneseno datoteko Markdown odprite kot besedilo in njeno celotno vsebino prilepite v pogovor, v katerem ste dokončali načrtovanje projekta. To je ponovno uporabni poziv; projektno specifični vhodni ZIP za začetno vzpostavitev ta pogovor ustvari pozneje.

Začetni poziv za agenta za začetno vzpostavitev v razširjenem imeniku:

Preberi AGENTS.md in izvedi INSTRUCTIONS.md. Uporabi priložene PLAN.md,
ARCHITECTURE.md, CRITICAL.md, specifikacije in razpoložljive izvorne dokumente.
Vzpostavi in validiraj ločena kodirni in strateški delovni prostor.
Ne izvajaj nalogov izdelka in ne zaganjaj operativnih agentov.
Ustavi se pred aktivacijo in napiši BOOTSTRAP-RECEIPT.md.

Dva poziva, dve fazi

Dolgi ponovno uporabni poziv gre v načrtovalni pogovor, da ustvari vhodni paket. Kratki začetni poziv prejme agent za začetno vzpostavitev v razširjenem imeniku, da namesti in validira operativno okolje. Nobeden ni delovni nalog izdelka in nobeden ne zažene avtonomne razvojne zanke.

---

18. Priporočeno besedilo ustave

Naslednji strnjeni nabor pravil je mogoče prilagoditi za ustavo strateškega agenta:

## Pravila odložene presoje

- Imaš strateško razvojno pristojnost, ne človeške pristojnosti za izdajo.
- Pri odločitvah D0 odloči, preskusi, običajno dokumentiraj in nadaljuj.
- Pri odločitvah D1 MORAŠ izbrati najboljšo začasno možnost, omiliti tveganje,
  jo preskusiti in zabeležiti popoln vnos v CRITICAL.md. NE SMEŠ se ustaviti le
  zato, ker bi človek morda raje sam izbiral med razumnimi povratnimi možnostmi.
- Pri mejah D2 analiziraj in priporoči, vendar dejanskega dejanja NE SMEŠ
  izvesti brez izrecne človeške odobritve.
- Združeni PR pomeni sprejem za nadaljnji razvoj, ne človeške odobritve za
  produkcijo.
- Združiti smeš le, kadar je zahtevani CI zelen, delovni nalog izpolnjen,
  razlika povezana, nobena meja D2 ni prestopljena in vsaka odločitev D1
  zabeležena.
- MORAŠ navesti najmočnejši argument, da je posamezna odločitev D1 napačna.
- Vnos D1 smeš ustvariti le, kadar je izpolnjenih vseh pet pogojev za
  vključitev kritičnega vnosa; običajne napake, TODO-ji, omejitve, slogovne
  izbire, špekulativna tveganja in povratni kompromisi z majhnim vplivom ne sodijo vanj.
- Vsak dokončni delovni nalog MORA navesti `Decision: NONE` ali
  `Decision: APPEND CRIT-NNNN`; `NONE` je običajni primer.
- Odgovoren si za natančno besedilo in identifikator vsakega naročenega dopisa.
  Kodirni agent sme dopisati le te natančne bajte in poročati le o kandidatih.
- V CRITICAL.md smeš dodati dokaze ali omilitve, ne smeš pa izbrisati vnosa
  ali ga označiti kot človeško sprejetega.
- Registrirano kontrolno točko razreši le dopisana človeška razsodba `ACCEPTED`,
  ki jo je mogoče pripisati avtorju; vse druge razsodbe ostanejo blokirajoče.
- Produkcijska namestitev je prepovedana, dokler veljavni blokirajoči vnosi
  ostajajo nerazrešeni.
- Vsak nov delovni nalog MORA navesti trajni izvor v človeškem namenu,
  arhitekturi, opaženih dokazih, neodvisni reviziji ali potrebi po kritičnem popravku.
- Tvoja strateška vloga je logično trajna ob zamenjavi procesa, modela,
  ponudnika in konteksta; pred delovanjem obnovi stanje iz GitHuba in artefaktov OAP.
- Priporočiš lahko zaključek mejnika, vendar ga NE SMEŠ potrditi le iz lastne
  zgodovine delovnih nalogov. Pred človeško kontrolno točko zahtevaj ICA.

Pri projektih, ki izberejo ponovno uporabni referenčni profil, ločeno dodajte naslednje; to ne nadomesti pravil odložene presoje:

Pravila zagona in konteksta referenčnega profila
- Začetna vzpostavitev namesti in validira; ustavi se pred delom na izdelku in aktivacijo.
- Korene začetne vzpostavitve, repozitorija in strategije ohrani različne in negnezdene.
- Korenski usmerjevalnik izbere pravila dodeljene vloge; pregled nikoli ne spremeni pristojnosti.
- Kodirna vloga za navedeni obseg bere zgoščena izvajalčeva pravila in strnjeno arhitekturo.
- Strategija ohrani polna pravila in kanonične vire; ICA pregleda celoten obseg mejnika.
- Meri tranzitivni nabor branja; zaradi proračuna nikoli ne izpusti obveznosti.
- Pred operativnim dejanjem uskladi identiteto vira/projekcije in trajno stanje.
- Nastavitvena lupina ali potrditvena zastavica ni delegirana pristojnost za aktivacijo.
- Med ponovitvami in osvežitvami ohrani obstoječa izvajanja, dokaze in človeške kontrolne točke.

---

19. Postopek odloženega človeškega razsojanja pred namestitvijo

19.1 Vhodi

Človeški razsodnik prejme:

• trenutni ARCHITECTURE.md;
• celotni CRITICAL.md;
• povezave do PR-jev in ciljev, ki so uvedli vnose;
• dokaze CI in preskusov;
• trenutni model groženj in topologijo namestitve;
• rezultate zunanjih pregledovalnikov ali revizij;
• strateška priporočila;
• ocene stroškov izvedbe in povrnitve.

19.2 Možnosti razsodbe

Za vsak vnos človek dopiše natanko eno od štirih odločitev:

• ACCEPTED: začasna odločitev je odobrena za registrirano ciljno kontrolno točko. To je edina razsodba, ki to kontrolno točko razreši.
• REJECTED: začasna odločitev ni sprejemljiva; kontrolna točka ostane blokirana, potrebna je odprava pomanjkljivosti ali odstranitev.
• CHANGE REQUIRED: smer je lahko izvedljiva šele, ko so izrecno navedene spremembe izvedene in znova predložene v razsojanje.
• DEFERRED: človek še ne odloči; registrirana kontrolna točka ostane odprta.

Pogoji, zahteve za dokaze, omejitve obsega in nadaljnja dejanja sodijo v polji razsodbe Conditions or required follow-up in Evidence/reference. Ne ustvarjajo dodatnih vrednosti odločitve. Če ostaja pomembno delo, je razsodba CHANGE REQUIRED ali DEFERRED, ne ACCEPTED.

19.3 Nastalo delo

sequenceDiagram
    participant H as Človeški razsodnik
    participant R as CRITICAL.md
    participant S as Strateški agent
    participant C as Kodirni agent
    participant G as GitHub in CI

    H->>R: Preglej vsak veljavni vnos
    H->>S: ACCEPTED, REJECTED, CHANGE REQUIRED ali DEFERRED
    S->>C: Izdaj delovne naloge za utrjevanje ali dokaze
    C->>G: Izvedi, preskusi, odpri PR
    G-->>S: CI in dokazi
    S->>H: Posodobljen povzetek za razsojanje
    H->>R: Zabeleži končno razsodbo
    H->>G: Odobri ciljno kontrolno točko namestitve

19.4 Pogoj dokončanja

Kontrolna točka namestitve je uspešna le, kadar:

• ima vsak veljavni blokirajoči vnos najnovejšo človeško razsodbo ACCEPTED;
• je zahtevana odprava pomanjkljivosti združena in preverjena;
• so sprejeti pogoji izvedljivo uveljavljivi;
• trditve ob izdaji ustrezajo odobrenemu obsegu;
• je odobritev namestitve izrecna in jo je mogoče pripisati avtorju.

---

20. Doktrina

Koncentrirani OAP lahko povzamemo v petnajstih pravilih:

1. Človek določa pomen izdelka, pripravljenost za prevzemanje tveganj in pristojnost za namestitev.
2. Človek pred zanko opravi koncentrirano inženirsko delo.
3. Vnaprejšnja priprava je zapisana v trajnih artefaktih pod nadzorom različic.
4. Strateški agent vodi delegirano razvojno načrtovanje in pregled.
5. Kodirni agent je pristojen za izvedbo, preskuse in dokaze PR-ja, ne za združitev ali usmeritev izdelka.
6. GitHub, CI in dokumenti repozitorija so avtoritativni.
7. Zahtevna povratna odločitev ni dovoljenje za ustavitev.
8. V CRITICAL.md vstopi le dolg presoje D1, ki izpolnjuje vseh pet pogojev; ustrezna negotovost postane začasna odločitev in natančen dopis.
9. Meje D2 ostajajo pod človeškim nadzorom.
10. Strateška združitev pomeni sprejem za nadaljnji razvoj, ne odobritve za produkcijo.
11. Noben veljavni dolg presoje ne sme ob namestitvi ostati neviden.
12. Človeško razsojanje zaključi zanko, preden sistem prestopi navedeno mejo namestitve.
13. Trajna strategija je logična, ne vezana na proces. Modeli in seje se lahko zamenjajo, ne da bi spremenili aktivni cilj ali strukturo pristojnosti.
14. Vsak cilj potrebuje trajni izvor. Avtonomna dejavnost mora biti sledljiva do človeškega namena, arhitekture, dokazov, revizije ali razsojanja.
15. Strateška zanka lahko priporoči zaključek, ne sme pa ga sama potrditi. Neodvisna zaključna revizija predhodi človeški kontrolni točki mejnika.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    PRELOAD["Vnaprej pripravi, kar je mogoče odločiti"] --> DECIDE["O preostalem odloči začasno"]
    DECIDE --> RECORD["Pošteno zabeleži negotovost"]
    RECORD --> BUILD["Nadaljuj avtonomni razvoj"]
    BUILD --> ICA["Priporočilo za zaključek in neodvisna zaključna revizija"]
    ICA -->|Vrzeli| BUILD
    ICA -->|Dokazi podpirajo zaključek| ADJUDICATE["Človek razsodi na kontrolni točki"]
    ADJUDICATE --> DEPLOY["Namesti šele po odobritvi"]

Povzetek referenčnega profila je ločen od teh petnajstih doktrinarnih pravil: usklajeno načrtovanje pretvori v samostojen paket; vzpostavi ločene delovne prostore vlog; preglej in izmeri izvajalčeve projekcije; validiraj ogrodje in ga pusti neaktivno; aktiviraj šele po uskladitvi in preverjanju pristojnosti; ohrani trajne dokaze objave in obnovitve. Poti, proračuni in izbire prenosa izvajajo doktrino, ne dodajajo pa splošnih pravil.

---

21. Sklep

Običajni OAP je discipliniran delovni tok pod človeškim upravljanjem, ki loči strateško sklepanje od operativnega izvajanja in ohrani človeški nadzor nad namenom, tveganjem, pregledom in izdajo. Koncentrirani OAP ohrani ta temelj, spremeni pa časovno in organizacijsko umestitev presoje.

Vnaprejšnje vlaganje človeškega dela večji delež človeškega inženirskega dela premakne pred avtonomno zanko. Logično trajna strateška vloga in kodirni agent s kontekstom, vezanim na nalogo, lahko nato izvedeta veliko daljše zaporedje delovnih nalogov, pregledov, popravkov in združitev za razvoj brez rutinskih človeških prekinitev. Strateški proces je mogoče ponovno zagnati ali zamenjati, projekt pa se nadaljuje iz GitHuba in zapisa OAP, ne iz skritega spomina seje.

Naknadna človeška presoja ne potlači odločitev, ki jih ni bilo mogoče pripraviti vnaprej. Strateškega agenta prisili v omejene začasne izbire in njihovo ohranitev v revizijsko pregledljivem registru. Preden register doseže človeško kontrolno točko, neodvisna zaključna revizija preveri, ali je arhitekturno določeni mejnik res prisoten v trenutni združeni programski opremi, ne zgolj v strateški pripovedi. Odloženo človeško razsojanje nato človeški pregled zgosti v točki največje vrednosti: ko je MVP že dokazal uporabnost, a preden nerazrešena presoja postane produkcijska izpostavitev.

Razširitev zato ni »povsem avtonomno programsko inženirstvo«. Je izraziteje časovno premaknjena oblika človeškega upravljanja:

Človek dela pred zanko, agenti delajo v zanki, človek pa razsodi pred namestitvijo.

Za MSP in druge ekipe pod velikim pritiskom doseganja MVP lahko to zagotovi praktično ravnotežje med hitrostjo in odgovornostjo. Prepreči celotno vlaganje v utrjevanje za zahtevno poslovno uporabo, še preden je vrednost dokazana, hkrati pa preprečuje, da bi kompromisi demonstracije tiho postali produkcijske predpostavke.

Ponovljiva začetna vzpostavitev naredi predajo HWP izrecno: usklajeno človeško načrtovanje postane pregledljiv vhod, ločeni operativni konteksti in preskušeno, a neaktivno ogrodje. Izbirni kontekst vsaki vlogi daje potrebna pravila, obenem pa ohranja polno arhitekturno avtoriteto in sledljivost. To je zasnova prenosa upravljanja v izvajanje, ne izmerjena trditev o prihranku žetonov, pospešitvi, zanesljivosti ali produkcijski pripravljenosti.

---

Dodatek A: Minimalna glava CRITICAL.md

# Register odloženega človeškega razsojanja

Ta datoteka beleži pomembne avtonomne odločitve, ki pred navedeno mejo izdaje
ali namestitve zahtevajo izrecno človeško razsojanje.

Pravila:

1. Nov vnos je dovoljen le, kadar je izrecno izpolnjenih vseh pet pogojev
   za vključitev kritičnega vnosa.
2. Agenti smejo dodajati vnose, dokaze, omilitve in povezave do nadomestnih rešitev.
3. Agenti ne smejo brisati vnosov, prepisovati zgodovine ali označevati vnosov
   kot človeško odobrenih.
4. Vsak vnos ima stabilen identifikator CRIT, izvorni PR/cilj, odločitev,
   protiargument, predpostavke, način odpovedi, povrnitev, obseg varnega nadaljevanja,
   natančno človeško kontrolno točko, človeško vprašanje in strateško izjavo.
5. Človeške razsodbe se dopišejo ločeno in jih je mogoče pripisati imenovani avtoriteti.
6. Združeno razvojno delo sme vsebovati vnose OPEN.
7. Namestitev je prepovedana, dokler najnovejša veljavna človeška razsodba ni
   ACCEPTED.

---

Dodatek B: Kontrolni seznam človeškega razsojanja

• Potrdite ciljno kontrolno točko: notranja demonstracija, zunanja demonstracija, pilot ali produkcija.
• Preberite vsak vnos CRITICAL.md, ki velja za to kontrolno točko.
• Preverite, da se vsak vnos sklicuje na dejanski PR, razliko, preskuse in trenutno kodo.
• Kritično presodite strateško sklepanje in najmočnejši protiargument.
• Preverite, ali predpostavke še veljajo v dejanski topologiji namestitve.
• Preverite skupno tveganje vseh vnosov, ne le vsakega posebej.
• Potrdite izvedljivost povrnitve in migracije.
• Dopišite eno natančno odločitev: ACCEPTED, REJECTED, CHANGE REQUIRED ali DEFERRED.
• Zavrnjene ali pogojne odločitve pretvorite v izrecne delovne naloge za utrjevanje.
• Odpravo pomanjkljivosti preverite s CI in usmerjenimi dokazi.
• Zabeležite človeško razsodbo z datumom in odgovorno avtoriteto.
• Zagotovite, da jezik izdaje ustreza razsojenemu obsegu.
• Namestitev odobrite šele, ko so razrešene vse veljavne blokade.

---

Dodatek C: Povzetek terminologije

Izraz	Opredelitev
OAP	Orkestracija strateške UI in visoko avtonomnih izvajalnih agentov pod človeškim upravljanjem, vodena s projektno ustavo.
HWP	Vnaprejšnje vlaganje človeškega dela: zgoščena človeška inženirska presoja, zapisana pred avtonomno zanko.
Koncentrirani OAP	OAP, omogočen s HWP, z logično trajnim strateškim nadzorom, manj rutinskimi človeškimi prekinitvami in pogojno strateško združitvijo za razvoj.
HJP	Naknadna človeška presoja: nameren časovni odlog nerazrešene človeške presoje do določenega mejnika.
DHA	Odloženo človeško razsojanje: formalni človeški proces razreševanja začasnih odločitev.
Dolg presoje	Še manjkajoči človeški sprejem pomembne izbire po avtonomni začasni odločitvi.
CRITICAL.md	Register odloženega človeškega razsojanja, ki po načelu dopušča le dopisovanje.
D0	Običajna delegirana odločitev.
D1	Pomembna, a obvladljiva začasna odločitev, ki zahteva poznejše človeško razsojanje.
D2	Neprenosljiva meja, ki zahteva človeško odobritev pred dejanskim dejanjem.
Kontrolna točka združitve za razvoj	Strateška kontrolna točka dokazov in CI za sprejem dela v nadaljnji razvoj.
Človeška kontrolna točka namestitve	Kontrolna točka človeške pristojnosti za zunanjo, produkcijsko, uničujočo ali drugače pomembno namestitev.
Logična strateška trajnost	Kontinuiteta strateške vloge, pristojnosti in zapisa ob zamenjavi modela, ponudnika, procesa ali konteksta.
Izvor delovnega naloga	Trajen razlog, ki cilj poveže s človeškim namenom, arhitekturo, opaženimi dokazi, neodvisno revizijo ali odpravo kritičnih pomanjkljivosti.
Neodvisna zaključna revizija (ICA)	Nova revizija arhitekture glede na trenutni main, ki strateški zanki preprečuje samopotrjevanje dokončanosti mejnika.
Vhodni paket za začetno vzpostavitev	Projektno specifični viri in specifikacije upravljanja, predani ločenemu agentu za začetno vzpostavitev; ne nameščeni izdelek.
Izvedba začetne vzpostavitve	Ustvarjanje in validacija operativnih delovnih prostorov in orkestracije iz teh vhodov.
Usmerjevalnik vlog	Minimalna vstopna točka, ki izbere veljavne dokumente dodeljene vloge, ne da bi podelila pristojnost.
Izvajalčeva projekcija	Zgoščena, sledljiva predstavitev polnih pravil, pomembnih za kodiranje, ki ohranja njihov normativni pomen.
Tranzitivni nabor branja	Vsa samodejno ali obvezno naložena vsebina, vključno s posrednimi referencami in ustreznimi podedovanimi navodili.
Preslikava zgoščevanja	Sled od obveznosti polnega vira do strnjenih določb ali izrecnih odločitev o neuporabi.
Predaja nameščenega, a neaktivnega ogrodja	Validirano ogrodje, ki čaka na posebej odobreno operativno aktivacijo.
Potrdilo o začetni vzpostavitvi	Z dokazi povezan zapis preverjanj izvedbe vzpostavitve in manjkajočih predpogojev, ne sprejem izdelka.
Referenčni izvedbeni profil	Izbirna konkretna uresničitev doktrine OAP, ne njena edina veljavna izvedba.

---

Dodatek D: Ponovno uporabni referenčni profil začetne vzpostavitve

Ta dodatek določa konkretni profil, uveden v §1.2. Njegovi popisi, lokalni prenos, identifikatorji in dogovori o objavi so izvedbene izbire. Vse tukajšnje poti in ukazi so dokumentacijski primeri za prihodnji vzpostavljeni projekt, ne navodila za začetno vzpostavitev repozitorija dokumentacije.

D.1 Vhodni arhiv za začetno vzpostavitev

Ponovno uporabni vir je poziv, ne splošen vnaprej izdelan ZIP. Vsak usklajeni načrtovalni pogovor ustvari lastno arhitekturo, program dela, pogodbe in sprejemne zahteve. Spodnje poti so relativne glede na koren tega vhodnega arhiva:

AGENTS.md                         # ustava samo za začetno vzpostavitev
INSTRUCTIONS.md                   # postopek izvedbe vzpostavitve in pogoj ustavitve
PLAN.md                           # samostojen načrt; natančni bajti, kadar je dokončen
ARCHITECTURE.md                   # polna arhitektura izdelka
CRITICAL.md                       # prazno začetno stanje ali ohranjen obstoječi register
README.md                         # razširjanje, zagon, ciljne poti, poznejša aktivacija
SOURCE-MAP.md                     # pristojnosti, dejstva, privzete izbire, predpostavke, nasprotja
PACKAGE-MANIFEST.json              # popis in razmerja med viri
INPUTS.sha256                     # bajtne identitete izvirnih vhodov
PACKAGE-CHECKS.md                  # samo dejanska preverjanja paketa
specifications/
  ROLE-CONTEXT.md
  OAP-PROTOCOL.md
  WORK-PROGRAM.md
  BOOTSTRAP-ACCEPTANCE.md
sources/
  concentrated-oap.md              # kadar je na voljo in dovoljen
  oap.md                          # kadar je na voljo in dovoljen
  ...                             # potrebni dovoljeni projektni viri

AGENTS.md je neposredno v korenu; ni zunanjega ovojnega imenika. Preverjanja paketa pregledajo absolutne poti, prehode iz dovoljenega imenika, nepričakovane simbolne povezave, popis, kontrolne vsote, povezave in razširjanje v začasni imenik za preskus. Dovoljene so le varne relativne poti. Samo razširjanje ne namesti ogrodja in ne validira njegovega izvajalnega okolja. Zgodovinski posnetki virov so dokaz izvora, ne dodatne trenutne veljavne kopije.

D.2 Vzpostavljeni delovni prostori in varnost datotečnega sistema

Agent za začetno vzpostavitev iz specifikacij ustvari naslednje skupine odgovornosti. To niso dodatne datoteke, za katere bi načrtovalni model moral lažno trditi, da jih je izvedel:

REPO_ROOT/
  AGENTS.md                         # majhen usmerjevalnik vlog
  PLAN.md
  ARCHITECTURE.md                    # trenutni polni vir
  ARCHITECTURE-for-agents.md         # izvajalčeva projekcija
  CRITICAL.md                        # živi register
  OAP-COMMUNICATION-coding-agent.md  # strnjeni protokol
  README.md / STATUS.md / SECURITY.md / TESTING.md
  docs/
    OAP-RUNBOOK.md
    AGENT-ROLE-SETUP.md
    READINESS.md
    DECISION-POLICY.md
    RUNTIME-CONSTRAINTS.md
    BOOTSTRAP-SOURCES.md
    bootstrap/
      BOOTSTRAP-GENERATOR.md         # zgodovinska pravila; ne samodejno odkrit AGENTS.md
      ...
  oap/
    README.md / RECOVERY.md / COMPLETENESS.md
    bootstrap-sources.lock.json
    runtime.env.example
    coding-instructions/
      AGENTS.md
    strategic-instructions/
      AGENTS.md                     # polni strateški vir pod nadzorom različic
      OAP-COMMUNICATION-strategic.md
      strategic_model_init_material.md
      INITIAL-ROADMAP.md
      initial-orders/               # vsebinski neaktivni osnutki
    governance/
      MANIFEST.json
      DISTILLATION-MAP.md
      CONTEXT-BUDGET.md
    templates/                      # nalog, poročilo, pregled, CRITICAL, razsodba, predaja
    audit/                          # protokol ICA, predloge, zahteve za mejnike
    prompts/                        # kratki začetni pozivi posameznih vlog
    bin/                            # preskušena pomožna orodja in zaganjalniki
    orders/                         # pri novi namestitvi brez aktiviranih nalogov
    reports/                        # brez izmišljenih poročil
    # active pri uspešni novi začetni vzpostavitvi NE OBSTAJA
  tests/oap/

STRATEGIC_HOME/
  AGENTS.md                         # nadzorovana polna strateška kopija
  OAP-COMMUNICATION-strategic.md
  strategic_model_init_material.md
  INITIAL-ROADMAP.md
  SOURCE-REFERENCES.md               # sklici na kanonični načrt/arhitekturo/register
  RUNTIME.md
  runtime.env                       # zasebno; aktivacija onemogočena
  control.fifo / response.fifo
  drafts/ / critical-drafts/
  workorders/                       # časovna evidenca in strateška predaja
  audit/ / logs/ / bootstrap-backups/
  agent-homes/coding/
  agent-homes/strategic/

Izogibajte se odvečnim dokumentom, ki le napihujejo popis. Skupna validacijska koda je boljša od neusklajenih razčlenjevalnikov. Nameščene strateške kopije se osvežujejo iz vira pod nadzorom različic; načrt, arhitektura in CRITICAL ostajajo kanonične datoteke repozitorija.

Pred zapisovanjem preglejte kanonične poti, tipe, lastništvo, simbolne povezave, podedovana navodila, stanje Git/oddaljene repozitorije, neoddano in nesledeno delo ter obstoječe manifeste. Podprite tako običajne imenike .git kot datoteke .git delovnih dreves. Razrešite vse tri korene in potrdite, da so različni in negnezdeni; presledke in Unicode obravnavajte z validacijo in ustreznim navajanjem. Zasebni konfiguraciji in cevem FIFO določite ustrezna dovoljenja.

Profil zahteva suhi zagon brez zapisovanja, enako ponovitev brez sprememb in izrecno omejeno osvežitev z varnostnimi kopijami. Ohranite dejansko kodo, aktivna izvajanja, poročila, vnose CRITICAL, zasebno nastavitev in zgodovino. Ponastavitve, čiščenja, začasnega shranjevanja sprememb, širokih sprememb dovoljenj, nevarnega sledenja simbolnim povezavam ali prisilnega pošiljanja ni dovoljeno uporabiti za izbris obstoječega dela. Nasprotujoče si stanje ostane vidno do odobritve omejenega prehoda.

Manjkajoča oddaljena konfiguracija ne preprečuje varne lokalne izvedbe vzpostavitve; preprečuje trditve o oddaljeni pripravljenosti. Izvedba vzpostavitve ne odobri ustvarjanja oddaljenega repozitorija, izbire javne vidnosti, objave dejanskega ogrodja, sprememb zaščite vej ali odpiranja dejanskega PR-ja. Prav tako ne odobri prenosov za izdelek, modelskega sklepanja, izvedbe izdelka, posegov v poverilnice, sprememb zaščitenih storitev, omrežne izpostavitve ali samodejnega zagona v ozadju. Začasni preskusni repozitoriji Git so drug obseg preskušanja. Lokalni privilegiji brez gesla niso pristojnost nad dragocenim stanjem gostitelja.

D.3 Trajni nalogi, objava in obvestila

Ta prenos predpostavlja skupni datotečni sistem POSIX, na primer Linux ali primerno namestitev WSL. Lokalne cevi FIFO ne povezujejo nepovezanih računalnikov. Drugačen prenos potrebuje lastna izrecna, preskušena pravila oblikovanja sporočil, povezovanja, stanja, ponovnega izvajanja in obnovitve.

REPO_ROOT/oap/orders/<ID>-<slug>.md
REPO_ROOT/oap/reports/<ID>-<slug>.md
REPO_ROOT/oap/active
STRATEGIC_HOME/control.fifo
STRATEGIC_HOME/response.fifo

Strategija je pristojna za besedilo naloga in objavo aktivnega kazalca; kodirna vloga pri delu vključi te natančne odobrene bajte in je pristojna za svoje poročilo. Objavljeni nalogi in poročila so nespremenljivi. Kazalec se spremeni le z odobreno objavo, njegova zgodovina pa je podprta z dokazi.

Pri novi neaktivni namestitvi kazalec ne obstaja. Obstoječi prazen ali nepravilno oblikovan kazalec je napaka. Veljaven kazalec vsebuje natanko en veljaven ID, ki mu sledi en LF, in se razreši v natanko en nespremenljiv nalog. Naloga nikoli ne izbirajte po najnovejšem imenu datoteke, največji številki, časovnem žigu ali vrstnem redu imenika.

Slovnica ID-jev in razpon pripon tega profila sta:

^[0-9]{3}-[a-z]{1,2}$
a, b, ..., z, aa, ab, ..., az, ba, ..., zz

NNN-a ustvari eno vejo/PR za cilj. Poznejše pripone dopolnjujejo isto vejo/PR; prekinjeni prvi krog ponovno uporabi že ustvarjeni PR. Nove strateške zahteve po pregledu uporabijo naslednjo pripono, zamenjava procesa, konteksta, modela, ponudnika ali računalnika pa ne. Izčrpan razpon zahteva izrecno revizijo protokola, ne tihega preštevilčenja. Na nov cilj preidite le po preverjeni združitvi/sprejemu ali izrecni opustitvi z novo presojo odvisnosti; opustitev ni sprejem.

Objava obsega dva obnovljiva zapisa pod zaklepom: objavo celotnega nespremenljivega naloga, nato atomsko zamenjavo aktivnega kazalca. To ni ena transakcija datotečnega sistema. Pred objavo validirajte končno stanje, identiteto, izvor, ustrezne identitete virov, način PR-ja, dovoljeni prehod, popolno izjavo DHA in odsotnost nerazrešenih polj za dokončanje. Osnutek z oznako DRAFT UNTIL STRATEGIC RECONCILIATION ni izvedljiva avtoriteta. Suhi zagon ta preverjanja izvede brez zapisovanja. Po potrebi dokončajte enako prekinjeno nerazrešeno objavo; zgodovinsko dokončanega naloga nikoli ne aktivirajte znova.

Signal pošljite šele, ko obstaja predvideno trajno stanje. Vsako obvestilo FIFO vsebuje natanko dva bajta ASCII OK (šestnajstiško 4f 4b), brez nove vrstice. Pošiljatelj na primer uporabi printf 'OK', da vsebino zapiše v svojo že validirano cev. To se razlikuje od končnega LF v aktivnem kazalcu. Obvestila ne vsebujejo ID-ja, stanja ali JSON-a; povezavo določa trajno stanje.

Obravnavajte delna branja/zapise, EOF, neveljavno obliko sporočila, prekinitve, podvojena obvestila in zaprtje pošiljateljevega deskriptorja. Natanko en ovojni proces porabi nadzorno obvestilo za kodirno vlogo pred zagonom novega kodirnega klica. Model ne sme znova čakati na že porabljeno obvestilo. Preprečite podvojene ovojne procese in tekmujoče porabnike; čakanje v mirovanju poteka zunaj sklepanja, brez občasnih modelskih klicev za odkrivanje dela.

Signal ni niti trajna resnica niti overjena pristojnost. Ne more prevladati nad nasprotujočim si stanjem aktivnega naloga, poročila, PR-ja ali oddaljenega sistema. OK pomeni, da je objavljena predaja pripravljena za pregled, ne da je izvedba uspela ali bila sprejeta.

D.4 PR, objava poročila in strateški pregled

Obstoječa razlika med izvedbenim SHA-jem in potrditvijo samo za poročilo iz §13.3 ima v tem profilu naslednje konkretno zaporedje:

1. Uskladi strnjeno upravljanje, natančni aktivni nalog in trenutno stanje repozitorija.
2. Izvedi, preveri, dokumentiraj in opravi morebitni natančno naročeni dopis CRITICAL.
3. Potrdi in pošlji vse delo razen poročila ter ohrani odobrene bajte naloga/kazalca.
4. Ustvari ali dopolni PR cilja pred pripravo njegovega končnega poročila.
5. Razreši varne težave CI znotraj obsega in zajemi dobesedni polni identifikator izvedbene potrditve sprememb.
6. Napiši nespremenljivo poročilo s spodnjima poljema.
7. Potrdi samo to poročilo, pri čemer je izvedbena potrditev njegov prvi starš, in ga pošlji.
8. Preveri identiteto oddaljenega PR-ja, bajte poročila, trenutni vrh veje, starša in invarianto, da se spremeni samo pot poročila.
9. Pošlji obvestilo o dokončanju in prenehaj spreminjati ta krog.

Implementation head SHA: <literal full implementation commit ID>
Report publication commit: SELF

SELF označuje potrditev sprememb, ki vsebuje poročilo; tako se izognemo pretvarjanju, da lahko potrditev vase vključi lastno prihodnjo zgoščeno vrednost. Identitete objektov validirajte glede na dejanski format objektov repozitorija, ne s predpostavko, da zadostuje skrajšana zgoščena vrednost.

Poročilo lahko opiše CI, ki je bil že opažen na izvedbenem vrhu veje. Ne more potrditi lastnega prihodnjega pošiljanja ali prihodnjega CI na vrhu s poročilom. Preverjanja po objavi sodijo v ločeno potrdilo o izvedbi in strateški pregled, ne v naknadno urejanje nespremenljivega poročila. Pravilno objavljena poročila PARTIAL, BLOCKED in FAILED smejo obvestiti strategijo. Neuspešna ali nepreverjena objava poročila ne sme oddati zavajajočega signala dokončanja.

Strategija neodvisno pregleda razliko, ustrezne kroge, izvor izvedbe/poročila, smiselne preskuse, dokumentacijo, dolg presoje in vsako zahtevano preverjanje na natančnem pregledanem trenutnem vrhu veje. Spremenjeni vrh zahteva nov pregled; kjer je na voljo, uporabite zaščito s pričakovanim vrhom in preverite dejanski rezultat oddaljene združitve. Če izbrani način združevanja prepiše graf privzete veje, ohranite prvotne dokaze PR-ja/objave poročila, namesto da bi trdili, da so te identitete ostale nespremenjene.

Pred omogočanjem delegiranega združevanja preglejte dejansko avtomatizacijo, sproženo z združitvijo, skladno z §7.3. Dovoljena združitev za razvoj ne sme nenamerno sprožiti produkcijske namestitve ali razširiti izpostavitve. Operativna konfiguracija ne more nadomestiti manjkajoče človeške pristojnosti.

D.5 Obnovitev brez ponovnega izvajanja

Ta tabela izvaja pravilo logične kontinuitete iz §5.2 in prvega poglavja; ne uvaja novega cilja vsakič, ko proces izgine.

Opažanje	Obnovitev
Ni aktivnega naloga	Ostani neaktiven ali čakaj zunaj sklepanja; ne izmišljaj si dela.
Nadzorni signal porabljen, proces je prenehal, končnega poročila ni	Uskladi stanje in nadaljuj nedokončano delo v istem nalogu in veji/PR-ju.
Prvi krog je že ustvaril PR	Ta PR preveri in ponovno uporabi.
Poročilo poslano, obvestilo o dokončanju izgubljeno	Nadaljuj strateški pregled; izvedbe ne ponavljaj.
Poročilo je le lokalno ali oddaljena objava ni preverjena	Dokončaj/preveri objavo brez prepisovanja poročila ali prezgodnjih trditev o oddaljenem uspehu.
Nalog objavljen, posodobitev kazalca prekinjena	Dokončaj le enak nerazrešen prehod; sicer ohrani nasprotje za uskladitev.
Podvojeno obvestilo	Preveri trajno stanje in prepreči podvojeno izvajanje.
Proces/model/ponudnik/kontekst/računalnik se je zamenjal	Obnovi isto logično vlogo in cilj brez preštevilčenja.
CI še teče	Počakaj/ponovno preveri dokaze; zamuda ni nov cilj.
Človek je namenoma končal izvajanje	Urejeno ustavi lastno dejavnost; brez samodejnega ponovnega oživljanja.

Zasebni metapodatki izvajanja lahko pomagajo pri obnovitvi, ne morejo pa prevladati nad oddaljenim repozitorijem in zapisom OAP. Pri diagnozi poiščite prvo ponovljivo mejo odpovedi in izvedite najmanjši razločevalni poskus s pogojem ustavitve, kot v prvem poglavju §10.7. Ohranite opažanja in razlage izrecno nadomestite; zgodovinskih poročil ne prepisujte zaradi poznejše razlage.

D.6 Mehanska varovala DHA

Prag petih pogojev za vključitev (§8.4), natančni izjavi NONE/APPEND (§8.5), strateško avtorstvo (§13.3), štiri človeške razsodbe (§8.7) in izbirno nalaganje registra (§8.9) ostajajo avtoritativni. Referenčni profil doda naslednja izvedbena preverjanja:

• Novo začetno stanje vsebuje politiko in nič dejanskih vnosov. Primeri naj bodo v ograjenih blokih ali ločenih predlogah; razčlenjevalniki ograjene primere prezrejo. Obstoječi register in odprte kontrolne točke preživijo izvedbo vzpostavitve nespremenjeni, razen če je določen dopis izrecno odobren.
• Validacija objave zavrne manjkajoča polja, napačno oblikovane izjave, neujemajočo se vsebino ali manjkajočo izjavo o izpolnjenih pogojih. Ne more dokazati vsebinske resničnosti petih pogojev; strategija ostane odgovorna.
• Določite dogovore o izločanju vsebine in zgoščenih vrednostih, stabilne ID-je, zaupanja vredno predhodno stanje, odkrivanje podvojitev, zaklepanje in idempotentno obravnavo enakih ponovitev. Ohranite prejšnje bajte. Dopise dokazov/omilitev ločite od vključitve nove presoje D1; nobeden tiho ne razreši kontrolne točke.
• Uporabite dejanski izvor PR-ja. Če številka PR-ja še ne obstaja, morata varen predhodni PR in nadaljevanje istega PR-ja vzpostaviti popoln natančen vnos pred razvojnim sprejemom začasne izbire. Kodirna vloga strateških nadomestnih oznak ne izpolnjuje sama.
• Pripisovanje avtorstva človeku potrebuje pot beleženja, ločeno od agentovih dovoljenj za dopisovanje. Samo ime v Markdownu ali kontrolna vsota ne zadostujeta, nepreverjeno avtorstvo pa ostane blokirajoče. Ta obveznost ne predpisuje izdelka za avtentikacijo.
• Le najnovejši človeški ACCEPTED, ki ga je mogoče pripisati avtorju, razreši registrirani obseg. REJECTED, CHANGE REQUIRED in DEFERRED ostajajo blokirajoči. Omilitev, nadomestitev, ICA in CI so dokazi, ne človeška razsodba ali ločena odobritev namestitve.

---

Dodatek E: Primer projekcije upravljanja in proračuna konteksta

E.1 Sledljivost in pomenski pregled

Referenčni profil beleži tri dopolnjujoče se artefakte:

oap/governance/DISTILLATION-MAP.md
oap/governance/CONTEXT-BUDGET.md
oap/governance/MANIFEST.json

Preslikava zgoščevanja določa pot, revizijo, razdelek in obveznost vsakega polnega vira, nato pa ustrezno strnjeno določbo ali izrecen razlog, zakaj za izvajalca ne velja. Naslednje so ponazoritve, ne dokazi, da je ustvarjena projekcija prestala pregled:

Obveznost polnega vira	Izvajalčeva projekcija	Presoja
Kodirna vloga nikoli ne sme združevati ali omogočiti samodejnega združevanja.	C-AUTH-01	Ohrani moč prepovedi.
Strategija napiše natančni odobreni dopis CRITICAL.	C-DHA-02: dopiši natančne naročene bajte; poročaj le o kandidatih.	Ohrani izvajalčevo dolžnost; strateška presoja vključitve ostane zunaj kodirne pristojnosti.
Polna arhitektura določa zaščiteno podatkovno mejo.	A-DATA-01 in dejanska referenca izvorne zahteve.	Ohrani projektne pogoje, izjeme in vedenje ob odpovedi.
Strategija ocenjuje konkurenčne prihodnje mejnike.	Brez kodirne določbe.	Ne velja za izvajalca; ohranjeno v polnih strateških pravilih.

---
config:
  flowchart:
    useMaxWidth: false
---
flowchart TB
    F["Polni veljavni viri"] -->|Namerna izpeljava| P["Izvajalčeve projekcije"]
    P --> M["Preverjanja preslikave in konteksta"]
    P --> S["Pomenski pregled"]
    A["Odobrene spremembe upravljanja"] --> R["Nadzorovana osvežitev"]
    R --> F
    R --> P
    H["Človeški obseg in polna arhitektura"] --> I["Neodvisna zaključna revizija"]
    E["Trenutni dokazi izvedbe"] --> I

Skripti lahko preverijo identitete, reference, navedeno pokritost, velikosti in skladnjo. Ne morejo dokazati pomenske enakovrednosti, pravilne razvrstitve D1, dejanske človeške odobritve ali neodvisnosti revizije. Pomenski pregled mora preveriti moč obveznosti, pristojnost, obseg, pogoje, izjeme, vrstni red, vedenje ob odpovedi, preverjanje in predajo vprašanj višji ravni. Generatorjev lastni drugi pregled je samopregled, četudi koristen; ni neodvisni pregled.

E.2 Ponazoritveni proračuni in pošteno merjenje

To so ponazoritvene privzete vrednosti za načrtovanje iz različice poziva 1.0, ne splošni standard OAP, pretvorba bajtov v žetone ali izmerjen rezultat zmogljivosti:

Komponenta	Ciljno število modelskih žetonov	Zgornja meja bajtov UTF-8
Korenski usmerjevalnik	400	2.048
Zgoščena kodirna ustava	2.200	12.000
Strnjena arhitektura	3.800	20.000
Strnjena kodirna komunikacija	1.800	10.000
Celotni rutinski nabor kodirnega upravljanja brez trenutnega naloga in kode	10.000	50.000

Izmerite celotni tranzitivni nabor, ne le navedenih datotek: vključite veljavna varnostna/preskusna in podedovana navodila, obvezna posredna branja ter ponavljajoče se vnašanje. Ne predpostavljajte, da odjemalec odstrani podvojitve. Strnjeni vir ne sme skrivati zahteve, da se ob vsakem običajnem kodirnem koraku naloži polna arhitektura.

Poročajte o natančnih bajtih UTF-8. O natančnih modelskih žetonih poročajte le z določenim ustreznim razčlenjevalnikom žetonov ter njegovo različico/konfiguracijo; sicer zapišite UNMEASURED. Ocene iz števila znakov niso natančne meritve žetonov. Tudi natančno število besedilnih žetonov ne meri celotnega dodatka ponudnikove zahteve, razen če je bila izmerjena celotna zahteva.

Projekti lahko upravičijo drugačne proračune. Preseganje cilja zahteva ponovno zgoščevanje, prestrukturiranje ali izrecno prilagoditev, nikoli krajšanja z izgubo pravil. Dejansko odkrivanje/dedovanje odjemalca beležite ločeno od preskusov klicanja nadomestnega odjemalca.

E.3 Štiri področja celovitosti

Področje	Kaj se preverja ali ohranja
Nespremenljivi viri paketa	Izvirne zgoščene vrednosti vhodov/paketa, zvestoba razširjanja, identiteta posnetka.
Trenutno kanonično upravljanje in projekcije	Sprejeta revizija vira, preslikana identiteta projekcije, odobrene predlagane spremembe, skladnost.
Nameščene strateške kopije	Ujemanje z virom pod nadzorom različic in nadzorovana osvežitev brez izbrisa zasebnega stanja.
Spreminjajoča se orkestracija in CRITICAL	Odobreni prehodi, celovitost dopisovanja/zgodovine, dokazi objave, človeške razsodbe; ne trajno ujemanje z začetnim stanjem.

Obseg manifesta določite brez krožne zahteve, da vsebuje lastno kontrolno vsoto. Spremenjena pričakovana zgoščena vrednost ni pristojnost za spremembo vira. Predlagano upravljanje primerjajte s sprejeto osnovo in izrecnim obsegom spremembe; ne zahtevajte, da ima odobreni predlog staro zgoščeno vrednost. Po sprejemu prizadete nameščene kopije osvežite na kontrolni točki brez tekočega dela, ob tem pa ohranite zasebno konfiguracijo, osnutke, predaje in zgodovino. Upravičeni dopis v register spremeni njegove žive bajte in ne sme spodleteti zgolj zato, ker se razlikuje od začetnega stanja.

---

Dodatek F: Kontrolni seznam validacije in predaje začetne vzpostavitve

Ta dodatek opisuje preverjanja, ki jih mora izvesti izvedba referenčnega profila. Gradnja dokumentacije jih ne izvede, njihovo dokumentiranje pa ni dokaz, da je dejanska začetna vzpostavitev, odjemalec ali izdelek uspešno prestal preverjanje.

F.1 Ločene plasti pripravljenosti in dokazov

Dokazna plast	Kaj potrjuje uspeh	Česa ne potrjuje
Preverjanja vhodnega paketa	Skladen popis, ohranjeni vhodi, poti, kontrolne vsote, povezave in razširjanje.	Izvedljivih pomožnih orodij ali vedenja ciljnega računalnika.
Preverjanje vzpostavljenega ogrodja/pomožnih orodij	Orkestracija se obnaša, kot je bilo preskušeno v navedenih preskusnih okoljih.	Vedenja dejanskega odjemalca, oddaljenih dovoljenj ali nepreskušene produkcijske varnosti.
Pripravljenost za operativno aktivacijo	Obstajajo zahtevana nastavitev odjemalca/modela/avtentikacije/oddaljenega sistema/izvajalnega okolja in pristojnosti.	Izvedbe izdelka ali sprejema cilja.
Kvalifikacija izdelka/izvajalnega okolja	Navedena vedenja delujejo na preskušenih mejah in reviziji.	Popolne pokritosti arhitekture ali človeške odobritve izdaje.
Sprejem mejnika in ciljne kontrolne točke	ICA, ustrezna človeška presoja, dokazi in odobritev izpolnjujejo navedeni obseg.	Odobritve za druga okolja, razrede podatkov ali izpostavitev.

Ogrodje lahko prestane preverjanja namestitve in ostane blokirano za aktivacijo. Kjer je koristno, ločeno poročajte o funkcionalni dokončanosti, zaupanju v dokaze, zmanjšanju negotovosti in zmanjšanju tehničnega dolga. Število ciljev, trud, količina žetonov in nastavitveni preskusi ne merijo dokončanosti izdelka.

F.2 Pogodba izvedljivega preverjanja

Uporabite pozitivne in negativne preskuse z začasnimi repozitoriji, nadomestnimi izvedljivimi agenti, nadomestnimi oddaljenimi vmesniki/vmesniki CI, začasnimi cevmi FIFO in izoliranimi terminalskimi sejami. Časovne omejitve preskusov so končne, tudi kjer je operativno čakanje v mirovanju namenoma neomejeno. Čiščenje je omejeno na vire, ki pripadajo preskusu.

Skupina preskusov	Zahtevana pokritost profila
Vhod in datotečni sistem	Bajtna zvestoba, popis, varno razširjanje, negnezdeni koreni, tipi/simbolne povezave/lastništvo, presledki/Unicode, delovna drevesa, ohranitev obstoječega stanja.
Ponovitev/osvežitev	Suhi zagon brez zapisovanja, enaka ponovitev brez sprememb, omejena osvežitev z varnostnimi kopijami, brez skrite aktivacije.
Vloge/kontekst	Pravilno usmerjanje in domači imeniki; neznane/nasprotujoče si vloge ne smejo spreminjati; pregled ne spremeni vloge; strnjeni tranzitivni nabor; polna strateška pravila; zaznane zastarele projekcije.
Nalogi/signali	Zavrnitev osnutkov in nepopolne identitete/izvora/DHA; nespremenljiva objava; prekinjeni zapisi; natančna oblika sporočil FIFO; en porabnik; brez sklepanja v mirovanju; podvojitve.
PR-ji/poročila	Popravki istega PR-ja in ponovna uporaba prekinjenega prvega kroga; napredovanje pripon; dobesedna identiteta izvedbe; starš SELF za potrditev samo poročila; lokalna/oddaljena ločitev; brez trditev o prihodnjem CI.
CRITICAL/kontrolne točke	Natančni naročeni dopisi, ohranitev prejšnjih bajtov, podvojeni ID-ji, zaklepi/ponovitve, prezrte ograjene predloge, štiri razsodbe, najnovejši pripisljiv človeški sprejem in obseg kontrolne točke.
Nastavitev/operativno delovanje	Nastavitev dostopna brez poverilnic; uveljavljeni operativni predpogoji; pravilni koreni/domači imeniki; izrecni izhod; preprečevanje podvojitev; čiščenje lastnih virov.
Obnovitev/pregled	Izgubljeni/porabljeni signali; lokalna/objavljena poročila; brez ponovnega izvajanja/preštevilčenja; preverjanje trenutnega vrha veje, nov pregled spremenjenega vrha, stranski učinki združitve, preverjeni oddaljeni rezultat.
ICA/trditve	Matrika zahtev glede na dejansko arhitekturo/revizijo, poštene razvrstitve in aktualnost, ponovitev revizije po odpravi pomanjkljivosti, brez samopregleda z oznako ICA.
Zasebnost/izolacija	Brez skrivnosti/zasebne vsebine v artefaktih ali dnevnikih; brez klicanja storitev izdelka ali spreminjanja zaščitene infrastrukture.

Preskusni nadomestek odjemalca dokazuje konfigurirano pogodbo klicanja, ne dejanskega odkrivanja navodil pri vsakem odjemalcu. Nameščeni odjemalec ločeno varno kvalificirajte ter zabeležite njegovo različico in vedenje. Ne izberite tiho drugega modela/ponudnika in ne predstavljajte neizvedenih dejanskih preverjanj kot uspešnih. Takšna kvalifikacija ostaja ločena od vedenja izdelka.

F.3 Potrdilo in neaktivna predaja

Začetna vzpostavitev zapiše BOOTSTRAP-RECEIPT.md v začasni vhodni imenik. V njem so:

• razrešene ciljne poti in identitete virov;
• ustvarjene, nespremenjene, varnostno kopirane, nasprotujoče si in ohranjene datoteke;
• identitete projekcij, tranzitivne meritve bajtov/žetonov, pomenski pregled in njegove omejitve;
• vsebinski osnutki ciljev in pokritost zahtev;
• natančni izvedeni ukazi, izidi, preskusna okolja in kvalifikacija dejanskega odjemalca;
• ohranjeno stanje CRITICAL, manjkajoči predpogoji pristojnosti/konfiguracije in dokazi neaktivnega stanja;
• potrditev, da ni prišlo do dela na izdelku ali operativne aktivacije.

Pošteno uporabljajte PASSED, FAILED, SKIPPED, NOT RUN, BLOCKED, PENDING ali MISSING. Uspešno je le dejansko izvedeno uspešno preverjanje. Vrzel ne sme biti zapolnjena z izmišljenim PR-jem, oddaljenim stanjem, številom žetonov, rezultatom preskusa, odobritvijo ali dokazom mejnika.

Pred predajo nove namestitve preverite naslednje; pri obstoječi zabeležite ohranjeno operativno stanje in njegov izrecno omejeni prehod, namesto da ga ponastavite:

• Viri paketa in sprejeto upravljanje/projekcije so usklajeni.
• Preskušena pomožna orodja, usmerjanje vlog, meritve konteksta in omejitve pomenskega pregleda so zabeleženi.
• Ni aktivnega kazalca, aktiviranega naloga, izmišljenega poročila/pregleda, nadzornega signala ali delujoče operativne vloge.
• Konfiguracijske vrzeli ostajajo vidne, nastavitveni lupini pa dostopni.
• Aktivacija zahteva ločeno pristojnost in trenutna preverjanja virov/izvajalnega okolja/oddaljenega sistema.
• Gradiva ICA vsebujejo iz projekta izpeljane zahteve s poštenimi začetnimi stanji.

Matrika ICA vsako zahtevo/vir poveže s kodo/izvajalnimi potmi, ki jo uveljavljajo, preskusi z negativnimi potmi, omejitvami in natančno revidirano združeno revizijo. Njene razvrstitve so IMPLEMENTED, PARTIAL, ABSENT in UNPROVEN. Zabeležite izvor revizorja/konteksta in aktualnost dokazov; revizijo vodi polni izvorni obseg, ne vrsta osnutkov. Ponovno presodite pomembne poznejše spremembe in ponovite ICA po zaključni odpravi pomanjkljivosti. Niti generatorjev samopregled niti potrdilo o začetni vzpostavitvi ne zagotavljata tega sprejema mejnika.

---

Viri

1. Janez Perš, Orchestrated Agentic Programming Manual (EN), Version 1.0.1, 2026.
2. UL FE LMI, slaif-agent-site/CRITICAL.md, operativna vrsta kritičnih odločitev za pregled pri avtonomno združenih PR-jih.
3. SLAIF weekend concentrated-OAP field transcripts: Agent-Site reaches MVP complete, izvoženo 23. avgusta 2026.
4. SLAIF weekend concentrated-OAP field transcripts: API Gateway nears SLAIF MVP completion, izvoženo 23. avgusta 2026.
5. SLAIF weekend concentrated-OAP field transcripts: Context compaction, provider replacement, and process recovery branches, izvoženo 23. avgusta 2026.
6. Concentrated OAP — Reusable Bootstrap-Package Generator Prompt, različica 1.0. Izvedbeni vir za tukaj opisani izbirni profil; navodila za uporabo so v §17.1.