fix(docs-template): link chrome to the reference's CDN URL (closes #2)

Andrew Dunnrequested to merge
fix-docs-chrome-cdn into main

Summary

  • Switch templates/docs/site/src/layouts/Layout.astro chrome <link> from ${BASE_URL}design/chrome/docs/index.css to the reference's Pages CDN URL: https://gitlab-com.gitlab.io/public-sector/reference/design/chrome/docs/index.css. Wholesale-lift consumers (e.g. gitlab-com/public-sector/kaniko) no longer 404 on first build.
  • Apply the same CDN treatment to templates/lab/site/index.html (tokens + chrome + anchors.js + the commented mermaid-init reference).
  • Drop the vendor step from scripts/new-project.sh. The script no longer copies design/{tokens,js,chrome/<family>} into site/[public/]design/ at stamp time. Templates rely on the CDN URL instead.
  • Update standards/design/SKILL.md: make CDN consumption the explicit default, show the exact <link> snippets consumers paste, and document the airgap vendor recipe in a <details> block.
  • Fix the README drift: templates/docs/README-template.md no longer claims site/src/styles/global.css carries placeholders (the file doesn't exist; the template's chrome loads from the CDN). The "what this template ships" bullet also clarifies the CDN consumption model. Updated templates/docs/site/README.md, templates/docs/AGENTS.md, templates/docs/.ai/standards.md, templates/docs/.ai/docs-authoring.md, templates/lab/README.md, and templates/lab/.ai/lab-authoring.md to drop "vendored under site/public/design/" language in favour of the CDN consumption model.

Closes #2 (closed).

Test plan

  • make build -- clean (57 pages built, agent surface emitted).
  • make check -- design standard passes; posture failure is pre-existing on main, unrelated.
  • make new-project TEMPLATE=docs DEST=/tmp/test-docs-issue2 NAME=test-docs-issue2 -- stamps without populating site/public/design/.
  • npm install && npm run build in the stamped docs site -- builds 7 pages cleanly.
  • grep -r "gitlab-com.gitlab.io/public-sector/reference/design" /tmp/test-docs-issue2/site/dist/ -- 7 matches, one per HTML page.
  • grep -r "/test-docs-issue2/design/" /tmp/test-docs-issue2/site/dist/ -- 0 matches (no stale BASE_URL references).
  • make new-project TEMPLATE=lab DEST=/tmp/test-lab-issue2 NAME=test-lab-issue2 -- stamps without populating site/design/; site/index.html carries 4 CDN refs.

🤖 Generated with Claude Code

Merge request reports