site-audit

name	site-audit
description	Audit the built website for the silent-failure classes this project has actually shipped — base-prefix drift, broken refs, canonical/sitemap divergence, og:image 404s, JSX whitespace collapse. Run before any push that touches website/.

Website audit

Build the site, then run the bundled checker:

cd website && npm run build
cd .. && python3 .claude/skills/site-audit/audit.py

Exit 0 is clean; exit 1 prints one line per failure with the page and detail.

Why these exact checks

Every check corresponds to an incident that shipped or nearly shipped from this repository. None of them fail the Astro build — the build stays green and only the live site is wrong, which is what makes them worth automating:

Check	The incident
base prefix	Project page under /hellonotes; a bare href="/privacy" is someone else's page. Use href() from src/lib/paths.ts.
broken refs	the generalisation of the og:image incident below — any href/src/srcset naming a moved or renamed emitted file.
canonicals	First emitted on github.io (a redirecting domain), later with .html forms after build.format: 'file'.
sitemap == canonicals	@astrojs/sitemap stripped the home page's trailing slash, advertising a URL that 301s.
og:image resolves	Social crawlers cache by URL; the image must live in public/ (stable name), never (content-hashed).