Dostupné

Brány kvality

Čtyři agregátory — lokální brána, governance sada, CI a pre-push hook — by jinak nesly čtyři ručně udržované seznamy kroků, které se rozejdou. Manifest je jeden a všechny čtyři se ho ptají.

Příkaz

just quality — 38 kroků

Z toho governance

27 validátorů, které nepotřebují žádný nainstalovaný nástroj — jen Python a shell

Z toho toolchain

11 kroků, které potřebují nainstalovaný nástroj: lint, kontrola formátu, mypy --strict, kontrola testovací matice, testy s pokrytím, prahy pokrytí, katalog příkazů, UI testy, testy nad lokálním stackem, kontrola AI vrstvy a build CSS

Governance podmnožina

python scripts/doctrine_check.py — 24 kroků, bez toolchainu; zbylé tři governance kroky (stav hooků, statický report, GitHub tracker) běží jen v plné bráně a v pre-push

Pre-push

34 kroků — plná brána bez čtyř těžkých testovacích kroků, které běží v CI

Jak se počítá

podle pole kind, které každý krok deklaruje v manifestu (governance nebo toolchain), a podle profilů quality, doctrine a pre-push; stav k 27. 10. 2026

Manifest

scripts/quality_manifest.py

Jeden registr, čtyři konzumenti

Krok se deklaruje jednou: jméno, příkaz, profily, ve kterých se účastní, a jestli je blokující. Profilů je pět — plná lokální brána, governance sada, governance kroky pro CI, rychlá smyčka check (lint, formát, typy, offline testy a katalog příkazů — tentýž seznam spouští CI) a odvozený pre-push hook, což je plná brána bez těžkých testů, které stejně běží v CI.

Přidání kontroly je jeden řádek v manifestu a vyzvedne si ji každý konzument. Žádný z nich nemá vlastní seznam, ze kterého by se dalo něco vynechat.

Oslabení musí být vidět

Množiny kroků jsou zamčené v tests/unit/test_quality_manifest.py. Odebrání kroku nebo zúžení jeho profilů shodí test, dokud někdo neupraví i ten test — ve stejné změně, kde bránu oslabuje.

To nezabrání nikomu bránu oslabit. Zabrání to udělat to tiše. Rozdíl mezi „nešlo to jinak“ a „nikdo si toho nevšiml“ je celý smysl téhle konstrukce.

Co validátory hlídají

• Žádná runtime závislost na jiném repozitáři (no-bridge), žádné IP mimo deklarovanou hranici.
• Integrita odkazů v markdownu, topologie dokumentace, index dokumentů, značky konfliktů.
• Kontrakt zdroje offline, čerstvost roadmapy, struktura skills vrstvy a orchestrace.
• Lineage session-context souborů, hygiena repozitáře, bezpečnostní baseline, hashe vendorovaných assetů.
• Synchronizace web_src/ a generovaného web/.

Kde to v repozitáři žije

• scripts/quality_manifest.py — deklarativní registr kroků, profilů a blokujícnosti
• tests/unit/test_quality_manifest.py — zamčené množiny kroků — oslabení brány neprojde tiše
• docs/development/VALIDATION_GATES.md — co která brána kontroluje a kdy se spouští
• docs/doctrine/VALIDATION_DOCTRINE.md — proč se validátor nesmí zeslabit, aby prošel běh

Souvisí

Zpět na sekci Roadmapa