brand-guidelines-systemlisted
Install: claude install-skill rustcircle/c101
# Brand guidelines system
Guidelines are done when every rule carries a rationale and a misuse example, every value is
measured or proofed (never typed from memory), the assets ship in a versioned `brand/` folder, and
an audit procedure exists that can fail a touchpoint with numbers. A PDF of pretty pages is not a
system; a system still works when the logo is hidden.
Tool: [brand_check.py](scripts/brand_check.py). `pairs` (stdlib) builds the accessibility table
from DTCG tokens (aliases resolved; hex, srgb or oklch values); `drift` (Pillow) maps a
screenshot's dominant colours to the nearest token by OKLab distance and checks logo clear space.
```bash
STACK="$HOME/.claude/stack"; [ -d "$STACK" ] || STACK="${CLAUDE_PROJECT_DIR:-.}"
BC="$STACK/.claude/skills/brand-guidelines-system/scripts/brand_check.py"
PY="$STACK/.venv/bin/python"; [ -x "$PY" ] || PY=python3 # drift needs Pillow
python3 -I "$BC" pairs brand/color/brand.tokens.json color.text.body/color.bg.page color.paper/color.bg.action
"$PY" -I "$BC" drift shot.png brand/color/brand.tokens.json --k 12 --logo-box 20,20,120,60 --clear 24
```
Exit 1 means a pair under 3:1, an OFF colour above `--min-share` (default 0.5 % of pixels) or a
clear-space breach, so the same commands gate CI next to the token build.
## 1. Required sections, in this order
| # | Section | Must contain | Source of truth |
|---|---|---|---|
| 1 | Logo suite | versions, clear space, minimum sizes, backgrounds, misuse sheet | `logo/` master