Nejvíc „AI-specifická“ oblast celého vyhodnocení. Hodnotí, jestli má agent odkud čerpat pravidla a vzory. U tohoto projektu je splněno 4 z 6 kontrol a leží tu dva z pěti hlavních zjištění vyhodnocení.

Skóre

Stav	Počet
✅ OK	4
🟥 Není OK	2

Celkově: základ je hotový a nadstandardní. Agentní instrukční soubor existuje, je udržovaný a doplněný recepty na časté úlohy; funkční specifikace je agentům dostupná. Chybí ale dvě věci s největším dopadem na kvalitu výstupu: seznam zakázaných vzorů a verzované implementační plány.

Co jsme hodnotili

#	Kontrola	Stav
1	Repozitář obsahuje agentní instrukční soubor, který popisuje architekturu, strukturu projektu a závazné konvence.	✅
2	Agentní instrukční soubor byl aktualizován v posledních 4 týdnech.	✅
3	Funkční specifikace je dostupná AI agentům.	✅
4	Repozitář obsahuje guideline na časté úlohy (např. jak přidat endpoint, migraci, nový modul).	✅
5	Existuje zdokumentovaný seznam zakázaných vzorů (antipatterns), kterým se má vývoj i AI agent vyhnout.	🟥
6	Implementační plány tasků jsou verzovány v repozitáři a jsou dohledatelné k tiketu.	🟥

Zjištění

Agentní instrukční soubor je živý dokument

Repozitář obsahuje instrukční soubor s architekturou, strukturou projektu a závaznými konvencemi, a byl aktualizován v posledních čtyřech týdnech. Neaktuální instrukční soubor je přitom horší než žádný: agent podle něj s jistotou udělá špatnou věc.

Recepty na časté úlohy

V repozitáři jsou postupy pro opakující se úlohy typu „jak přidat endpoint, migraci nebo nový modul“. Tím se z agenta stává použitelný vykonavatel rutiny: nemusí odvozovat vzor z existujícího kódu, dostane ho popsaný.

Funkční specifikace dostupná agentům

Agent se dostane k funkční specifikaci, ne jen ke kódu. Rozdíl je v tom, že rozumí záměru, ne jen současné implementaci; dokáže tedy rozpoznat, že stávající chování je chyba.

🟥 Chybí seznam zakázaných vzorů

Projekt nemá zdokumentovaný seznam antipatternů, kterým se má vývoj i agent vyhnout. Konvence popisují, jak se věci dělají, ale nikde není napsané, jak se nedělají. Následek je konkrétní: agent zvolí technicky funkční řešení, které je v tomto projektu z historických důvodů nežádoucí, projde CI a spor se otevře až na review.

⚠️ Toto zjištění je zvlášť relevantní, protože jsme při měření osy lidé zaznamenali případ, kdy se agent opakovaně pokusil vložit citlivé údaje přímo do kódu i přes explicitní zákaz v zadání. Zákaz zapsaný v repozitáři je spolehlivější než zákaz v promptu.

🟥 Implementační plány nejsou verzované

Plány k jednotlivým úlohám nejsou v repozitáři a nejsou dohledatelné k tiketu. Přichází se tak o dvě věci: agent nemůže navázat na dřívější rozhodnutí u podobné úlohy a člověk nemá co schvalovat před tím, než agent začne psát kód. Právě schválení plánu je přitom podle Agentic standardu jádrem celého postupu.

Doporučení

Priorita	Doporučení
Vysoká	Sepsat seznam zakázaných vzorů projektu, buď samostatně, nebo jako sekci agentního instrukčního souboru.
Vysoká	Zavést verzování implementačních plánů v repozitáři s dohledatelností k tiketu a lidským schválením před exekucí.
Střední	Rozšířit recepty na časté úlohy o sdílené postupy pro všechny služby (backend i frontend), které dnes chybí.