Skip to content

Commit cbe8b90

Browse files
TMHSDigitalclaude
andcommitted
docs(claude): record the shared palette and the site link gate
tokens.css became the single :root for the landing, 404 and gallery pages, and tests/check_site_links.py now gates validate and deploy. An agent editing the site needs both facts before touching a color or a link, plus why pages.yml fetches full history. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
1 parent 6f3f0ab commit cbe8b90

1 file changed

Lines changed: 14 additions & 1 deletion

File tree

‎CLAUDE.md‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,8 @@ snippets/<snippet-name>.py - Standalone code patterns, 27 total
2424
examples/<name>/ - Runnable smoke-gated examples, 60 total (+ gallery.json)
2525
showcase/<name>/ - Budget-conformance props, 36 pieces (sibling of examples/; see showcase/README.md)
2626
scripts/build_gallery.py - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json
27-
scripts/site/ - Vendored landing-page build (Jinja2)
27+
scripts/site/ - Vendored landing-page build (Jinja2); tokens.css is the shared palette
28+
tests/check_site_links.py - Internal link/anchor/alt gate over the built site (docs/)
2829
docs/gallery/ - Committed generated gallery pages + hero renders
2930
VERSION - Source of truth for the repo version
3031
```
@@ -191,6 +192,18 @@ This is a content repository, no build step for skills/rules/snippets/templates
191192
`scripts/build_gallery.py` (stdlib) regenerates `docs/gallery/` and must be re-run after
192193
touching `examples/`; the landing page builds from `scripts/site/` at deploy time.
193194

195+
- **One palette:** `scripts/site/tokens.css` is the single `:root` for every published
196+
page — the landing and 404 templates `{% include %}` it and `build_gallery.py` inlines
197+
it. Change colors or type there, never in a hand-copied `:root`; a token edit changes
198+
all 89 gallery pages, so regenerate and commit `docs/gallery/`.
199+
- **Link gate:** after building both (`python scripts/site/build_site.py --repo-root . --out docs`
200+
then `python scripts/build_gallery.py`), run `python tests/check_site_links.py`. It resolves
201+
every internal `href`/`src`/`#anchor` across all pages and requires `alt` on every `<img>`;
202+
the `validate-site` job and the deploy both run it. Gallery hash fragments with `=`
203+
(`#tag=a,b`, `#k=showcase`, `#s=az`) are filter state, not anchors, and are skipped.
204+
- **"What's new" needs history:** the landing page dates recent additions from `git log`;
205+
a shallow clone hides the strip, which is why `pages.yml` checks out with `fetch-depth: 0`.
206+
194207
The AI consumes content via:
195208

196209
- **Cursor**: rules under `rules/` apply when scope globs match. Skills are referenced by name in chat.

0 commit comments

Comments
 (0)