Přeskočit na obsah

Plánovací obálka nesmí předstírat vytvořený commit

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

Agent v čistě plánovacím kole nesmí měnit repozitář, ale výsledná JSON obálka povinně vyžaduje „SHA vytvořeného commitu“. Agent proto opakovaně odmítá vrátit úspěšný plán: nový commit nevznikl a aktuální HEAD neobsahuje artefakty plánované operace.

Pokud by agent vyplnil aktuální HEAD, auditní stopa by nepravdivě tvrdila, že effectful výsledek patří existujícímu commitu.

Jedno pole mělo dvě neslučitelné sémantiky:

  • u implementace označovalo commit vytvořeného kandidáta;
  • u nemutačního plánování mělo označovat pouze stav repozitáře, ze kterého plán vycházel.

Generátor promptu a validátor nerozlišovaly fázi workflow. Povinný čtyřicetiznakový hash byl proto syntakticky konzistentní, ale sémanticky nepravdivý.

{
"verdict": "PLAN_PROPOSED",
"commit": "<SHA vytvořeného commitu>"
}

Plánovací verdikty používají oddělený kontrakt:

{
"verdict": "PLAN_PROPOSED",
"commit": null,
"refHead": "<ověřený aktuální HEAD>"
}

Validátor povolí commit: null pouze pro plánovací verdikty, vyžaduje plný hash v refHead a porovná jej s read-only zjištěným HEAD. U implementace a auditu kandidáta zůstává commit povinný a refHead je zakázán. Prompt výslovně říká, že refHead je vstupní reference, nikoli důkaz vytvořeného artefaktu.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Pro každý verdikt otestuj nejen formát polí, ale i jejich význam a povolené vedlejší účinky dané fáze.
  • Anti-pattern: Jedna univerzální obálka vyžaduje stejný „result commit“ pro plánování, implementaci i ověřování.
  • Lepší přístup: Použij diskriminovaný kontrakt podle verdiktu; vstupní reference a výstupní artefakt musí mít odlišná pole.

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 obálka neplatná syntakticky; zde byl samotný požadovaný formát sémanticky chybný.

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