Tady se hodnotí, jestli se projekt dá spolehlivě spustit, ověřit a změřit. Bez toho agent nemá jak zjistit, že jeho změna funguje. U tohoto projektu je splněno 6 ze 7 kontrol.

Skóre

Stav	Počet
✅ OK	6
🟥 Není OK	1

Celkově: projekt jde rozchodit podle návodu, má vzorové konfigurace, lint, statickou analýzu i automatizované testy a vynucuje verze runtime. Na těchto strojově ověřitelných hranicích si agent umí chybu opravit sám, bez zásahu člověka.

Co jsme hodnotili

#	Kontrola	Stav
1	Dokumentace popisuje spuštění a konfiguraci lokálního vývojového prostředí.	✅
2	Zdrojový kód obsahuje vzorové konfigurační soubory pro lokální vývoj.	✅
3	Projekt podporuje hot reload při lokálním vývoji.	✅
4	Projekt má nastavené nástroje pro lint, formátování a statickou analýzu kvality kódu.	✅
5	Projekt obsahuje automatizované testy v rozsahu definovaném vývojovým standardem.	✅
6	Projekt vynucuje používání definovaných verzí frameworků a runtime.	✅
7	Technický dluh je evidován, prioritizován a pravidelně řešen v rámci sprintů.	🟥

Zjištění

Zpětná vazba, kterou agent dostane sám

Lint, formátování a statická analýza jsou nastavené a spustitelné jedním příkazem. Pro agentní vývoj to znamená: agent po sobě spustí kontrolu, přečte chybu a opraví ji, aniž by o tom kdokoli věděl. Bez těchhle nástrojů se stejná chyba objeví až na code review, kde už stojí čas člověka.

Návod na lokální prostředí

Dokumentace popisuje spuštění včetně konfigurace a řešení běžných problémů, a v repozitáři jsou vzorové konfigurační soubory. Agent tedy dokáže prostředí připravit a změnu ověřit lokálně.

⚠️ Dílčí zjištění: u jedné z exportních služeb nelze prostředí rozchodit lokálně vůbec a dokumentace nenabízí alternativní postup. Pro agentní práci nad touto konkrétní službou to znamená, že změny nelze ověřit před nasazením.

Testy v rozsahu daném standardem

Automatizované testy existují u všech služeb a jejich rozsah odpovídá internímu vývojovému standardu. Spolu s vynucením v CI (viz Automatizace) tvoří hranici, za kterou se agent nedostane s rozbitou změnou.

🟥 Evidence technického dluhu je bez priorit

Technický dluh se eviduje a prochází sprinty, evidence je ale zatím tenká: obsahuje jen několik položek bez priorit a bez odhadů pracnosti. Pro plánování dalších kroků to je málo.

Doporučení

Priorita	Doporučení
Střední	Doplnit evidenci technického dluhu o priority, odhady pracnosti a odpovědné osoby.
Střední	Popsat alternativní postup ověřování u služby, kterou nelze rozchodit lokálně.
Nízká	Naplánovat aktualizaci závislostí u služeb, kde poslední audit knihoven přesáhl rok.