← Standards

repository

Every repository in the Nomograph estate ships a small, fixed set of brand and governance files, in the same shape, so a repo is recognizable and complete on first sight. Consistency here is cheap to enforce and expensive to skip.

What this standard checks

  • avatar.svg, hero.svg exist. The avatar is the GitLab repo identity; the hero carries the brand on mirrored views (GitHub does not render the repo avatar, so the README hero is what shows).
  • LICENSE, CODEOWNERS exist. Every repo states its license and its owner.
  • README.md exists and opens with ![hero](hero.svg), so the banner renders the moment the repo is opened.

Why

A repo missing its hero or license is not a stylistic lapse; it is an incomplete artifact. These checks are mechanical, so they belong in CI rather than in review. The point is that no one has to remember.

How to adopt

Lift the brand artifacts and governance files, replace the placeholders, and run the check below.

fetch as markdown
curl https://reference.nomograph.ai/standards/repository/index.md
check a repo against it
just -f ~/gitlab.com/nomograph/reference/justfile check-one repository $PWD