Fix malformed/non-conformant brand templates and broken example link

Andrew Dunnrequested to merge
ps-conformance-template-hero-and-example into main

Why

Surfaced while scaffolding a new Public Sector project (serviceping-redact): following the reference did not yield a conformant hero/avatar or a working single-page site. Three defects in how the reference advises:

1. The canonical example links a chrome path that 404s

design/examples/workspaces-airgap.html linked ../chrome/index.css, which does not exist — the published CDN serves chrome/lab/index.css, and standards/design/SKILL.md documents that path. Copying the example (the natural starting point) produced an unstyled page.

2 + 4. The brand-artifact templates are malformed and non-conformant

  • standards/repository/templates/hero.svg and avatar.svg carried -- inside XML comments. That is malformed XML; rsvg-convert refuses it (Double hyphen within comment) — the exact failure the repository SKILL's own validation workflow warns about.
  • templates/{lab,docs,paper}/hero.svg shipped a 15-slot tile grid, which the repository standard explicitly bans ("Tile grids on the hero").

Net effect: make new-project stamped a hero that neither rendered nor passed the standard.

What changed

  • Fix the -- comment delimiters at the source (standards/repository/templates/{hero,avatar}.svg).
  • Redistribute the conformant hero/avatar to templates/{lab,docs,paper}/ (single source of truth).
  • Point the example at chrome/lab/index.css.

Validation

standard hero/avatar render: OK
lab/docs/paper hero render: OK, tiles=0
lab/docs/paper avatar+favicon render: OK
example chrome link: ../chrome/lab/index.css

Noted, not fixed here

The only single-page chrome is chrome/lab/ (evidence/ADR-shaped). A CLI/tool landing page works with it but isn't really "evidence"; the marketing/ chrome is slated for v1.1. A one-line note ("tool pages use lab chrome: hero + tldr + evidence") would close that advice gap — happy to add it here or as a follow-up.

Merge request reports