Проверка README по воротам качества

documentation

readme-verify is a Claude Code skill that runs a five-gate sequential verification pass on a finalized README without modifying it, reporting results and stopping at the first failed gate. Gate 0 is a hard mandatory gate: every fenced ```scala block must compile via the project's sbt-kyo-doctest plugin, with sbt exit code 0 and failures=0 in the summary line — silently skipping it is explicitly prohibited. Gate 1 executes the companion script readme-check.sh with --chunks, --callouts, and --intro-order flags, blocking on strong findings such as em-dashes, marketing copy, or broken fences. Gate 2 walks every ## chunk in order to catch forward references and fabricated API names against the source-analysis inventory. Gates 4 and 5 are the load-bearing checks: source coverage of the public API surface and catalog-pattern detection. The skill takes two arguments — readme path and source-analysis path — and is designed as the final quality gate before shipping documentation in the kyo monorepo.