docs: gold-ink token note, redesign gotchas in project CLAUDE.md

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -261,6 +261,20 @@ dashboards safe:
   page uses `variant="strip"`. `pages.booking` takes `compact` for the home card; booking rules are
   shared and unchanged.
 
+Gotchas found in the 24-x QA (2026-10-31) — all come from `app.css`/shared markup reaching into `body.site`:
+- `app.css` sets `overflow-x:hidden` on `body` (breaks `position:sticky`) and the body font via
+  `html[lang] body` (beats `body.site`): `public.css` overrides both (`overflow-x:clip`,
+  `html[lang] body.site`). Any new public rule that must beat `app.css` needs the same care.
+- Reveal uses the `translate` property, not `transform`, so hover lifts (`transform`) still work.
+- Flux always renders a hidden `data-flux-error`, so `app.css` paints every Flux input red; auth
+  styles override it unless the error is visible (`:not(.hidden)`).
+- A Volt template that starts with a Blade `@if` gets no Livewire root (form unbound, only visible
+  in the browser console): wrap such templates in one root `<div>`.
+- A broad link-colour rule on auth pages must exclude `[data-test^=language-switch]`: its active
+  label is white on olive, and an olive link colour erased it.
+- After a change, check text against its background (contrast of active, hover and filled states)
+  in a screenshot, not only layout metrics.
+
 ## Design Requirements (from PRD)
 
 Below: the dashboards' palette and rules. Public pages: Part A of `docs/ux-design.md`.