README: document the design-tools belt

afeb092a0c4cc225913ba3b3086fa06644618820 · 2026-07-23 07:35:17 -0700 · Steve Abrams

Files touched

M README.md

Diff

commit afeb092a0c4cc225913ba3b3086fa06644618820
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Thu Jul 23 07:35:17 2026 -0700

    README: document the design-tools belt
---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 959e8c8..fff8100 100644
--- a/README.md
+++ b/README.md
@@ -69,3 +69,21 @@ votes.jsonl, costlog.jsonl).
 - **Model profile page** — click a leaderboard row for that model's full artifact gallery + aggregate stats (`/api/models/:id/profile`).
 - **Export battle** — `/export/:id` downloads a self-contained standalone HTML (artifacts inlined via sandboxed `srcdoc`), renders offline.
 - **Consensus referee** — the AI referee is now a *panel* of local vision models (`VISION_MODELS`, default `qwen2.5vl:7b,minicpm-v`) with a spread/disagreement flag.
+
+## Design tools (🎨 per-battle toggle)
+
+Models can be given a graphic-design tool belt (`design-tools.js`):
+
+- **opendesign** — curated palettes (by mood), typography stacks + modular scale,
+  layout/spacing recipes, elevation shadows, inline SVG icon paths.
+- **hyperframes** — motion catalog: named easings, entrance keyframes, stagger /
+  text-effect / ambient-background snippets (pure CSS/vanilla JS — artifacts run
+  under CSP `default-src 'none'`, so no CDN libraries).
+- **figma** — live brand tokens (most-used fills + named styles) from a Figma
+  file via REST. Needs `FIGMA_TOKEN` (optional `FIGMA_ARENA_FILE` default file);
+  degrades gracefully when unset.
+
+Tool-capable models (GPT, Grok, Kimi, Qwen3, Hermes3) get a real function-calling
+loop (≤6 rounds, all tokens cost-logged as `model-arena-tools`); models without
+tool support (Gemma3, claude-code CLI) get the same essentials injected as a
+compact design pack. Each run records `toolCalls`, badged 🎨 in the battle view.

← 7df2798 design tools for arena models: figma / opendesign / hyperfra · back to Model Arena · auto-save: 2026-07-23T07:49:27 (26 files) — data/challenges. b855064 →