diff .claude/skills/zenbu-personal-site/SKILL.md @ 258:60a876c4587a

[ui] Add semantic primitive ownership Build a layered Zenbu token and sizing system, make authored controls use native-underneath primitives, migrate mrjunejune without imposing visual surfaces, and document/enforce HTML ownership in the catalog and wiki. Co-authored-by: Copilot <[email protected]>
author MrJuneJune <me@mrjunejune.com>
date Wed, 05 Aug 2026 05:25:40 -0700
parents 30c2196d03d4
children 667156fcd3e3
line wrap: on
line diff
--- a/.claude/skills/zenbu-personal-site/SKILL.md	Tue Aug 04 16:49:11 2026 -0700
+++ b/.claude/skills/zenbu-personal-site/SKILL.md	Wed Aug 05 05:25:40 2026 -0700
@@ -16,6 +16,16 @@
 - Zenbu UI assets are copied from `//design_system:components` and
   `//design_system:styles` into `src/public/design-system/` by Bazel. Do not
   hand-copy or fork shared component files.
+- Preserve the site's established transparent content and plain header/icon
+  presentation. Use `appearance="plain"` when shared behavior is useful, and
+  do not introduce cards, shadows, borders, or surfaces without a concrete UX
+  reason.
+- Every site-owned `zen-button` declares an `xs` / `sm` / `md` / `lg` / `xl`
+  size. Site CSS must consume inherited `--zenbu-control-*` aliases plus
+  `--zenbu-sys-padding-*` and typography roles instead of hardcoding control
+  padding or height.
+- New site CSS uses `--zenbu-sys-*` semantic roles. Do not consume
+  `--zenbu-ref-color-*` or add new `--zen-*` compatibility-token usage.
 - `mrjunejune/test/`: integration tests and snapshots.
 - `mrjunejune/BUILD`: Bazel build, bundle, asset movement, and test-visible filegroups.
 - `mrjunejune/.config` and `.config.development`: server configuration. Do not commit secrets.
@@ -34,6 +44,11 @@
 
 The simple template renderer replaces `{{...}}` tokens with file contents loaded through `Seobeo_Web_LoadFile`.
 
+Before adding or changing HTML controls, read
+`design_system/wiki/HTML_AUTHORING.md` and `PRIMITIVE_MAP.md`. Every authored
+interactive control must have exactly one appropriate Zenbu owner while
+retaining its native element underneath.
+
 ## Routes and features
 
 Existing route areas include: