Přeskočit na obsah

Věcný NO-GO implementačního agenta nesmí být terminální incident

import { Aside } from ‘@astrojs/starlight/components’;

Implementační agent korektně vrátí strukturovaný NO_GO s vysvětlením a důkazy. Dashboard přesto ukáže obecný terminální incident, podrobný důvod zmizí a workflow nepokračuje do opravného kola.

Parser obálky verdikt podporoval, ale metoda adaptéru měla užší návratový kontrakt a přijímala pouze úspěšného kandidáta. Platný záporný výsledek proto změnila na výjimku. Obecný orchestrátorový catch nerozeznal doménový výsledek od neočekávaného pádu procesu.

platná obálka NO_GO
→ adaptér očekává jen READY
→ throw
→ obecný catch
→ terminální INCIDENT bez původní klasifikace

Návratový typ implementace je diskriminovaná unie: hotový kandidát nebo strukturovaný NO_GO s commitem, shrnutím a evidencí. Stavový automat má pro druhou větev samostatnou událost, která:

  • append-only uloží celý výsledek před přechodem;
  • zvýší počítadlo opravné revize;
  • vrátí operaci do implementace;
  • po pevném limitu skončí pravdivou chybou;
  • nikdy nevytvoří incidentní záznam jen kvůli očekávanému verdiktu.

Neočekávané výjimky adaptéru, neznámý stav vedlejších účinků a porušená integrita zůstávají terminální a fail-closed.

NO_GO může obsahovat hodnotnou rozpracovanou práci

Sekce “NO_GO může obsahovat hodnotnou rozpracovanou práci”

Další varianta stejné chyby vzniká, když agent před věcným NO_GO bezpečně opraví část kandidáta. Orchestrátor výsledek uloží, ale nechá pracovní strom rozpracovaný. Následující kolo pak skončí na obecné kontrole čistoty ještě předtím, než agent dostane šanci pokračovat.

Oprava je oddělit WIP checkpoint od auditovaného kandidáta:

  • po strukturovaném NO_GO se při nezměněném výchozím HEAD vytvoří interní checkpoint commit;
  • checkpoint nespouští produkční gate a nesmí být vydáván za auditovaný kandidát;
  • další kolo začíná z čistého stromu a navazuje na zachovanou práci;
  • jednorázová obnova staršího incidentu je vázaná na přesný hash incidentu, výchozí commit a digest dirty statusu;
  • opakovaný běh obnovy pouze ověří už existující checkpoint.

Pokud NO_GO zároveň popisuje chybějící externí capability, orchestrátor nejprve rezervuje samostatný prerequisite krok. Původní operaci obnoví až po jeho strojově doloženém dokončení.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Pro každý povolený verdikt parseru ověř integračním testem cestu až do durable stavu a UI.
  • Anti-pattern: if (verdict !== SUCCESS) throw nebo okamžitý návrat z NO_GO bez durable převzetí změn, následovaný požadavkem na čistý strom v dalším kole.
  • Lepší přístup: Odděl očekávané doménové výsledky, validační chyby, transportní chyby a neznámé vedlejší účinky do různých typů a přechodů; rozpracované změny převezmi explicitním WIP checkpointem.

Sister bugs / související

Sekce “Sister bugs / související”

Související je Formátová chyba agentní obálky zastaví jinak úspěšný workflow. Tam je problém ve formátu přenosu; zde je obálka validní a ztrácí se její věcný záporný verdikt.

Přidal aiarchitekt.cz · 24. 8. 2026 2:00
Provozuje aiarchitekt.cz