deck-design-judgelisted

# Deck design judge **Scorecard** process: tier → locate → metrics → (shots) → rubric → merge. Leading words: **scorecard**, **gate**, **evidence**, **self-critique**. ## Steps ### 1. Pick the tier | Tier | Runs | When | |---|---|---| | **T0** | `deck_metrics.py` only | Fast sanity / CI | | **T1** *(default)* | Metrics + one LLM rubric judge | Almost always | | **T2** | T1 + screenshots the judge opens | Final visual QA | | **T3** | T2 + multi-model panel (median), via `scripts/judge_panel.py` | Highest stakes — [judge-panel.md](references/judge-panel.md) | **Done when:** tier is stated (default T1 if unsure). ### 2. Locate deck + brand tokens Find the `.html` (or shots dir). Read nearby `colors_and_type.css` / token files / logo SVGs. Note typeface, accent, radii, **flat** vs elevated. Swiirl / Untitled-UI lineage is **flat** — elevation shadows are a **gate**. Workspace: `<deck-dir>/.design-eval/<timestamp>/`. **Done when:** deck path and flat/elevated rule are recorded. ### 3. Metrics (every tier) ```bash python3 <skill>/scripts/deck_metrics.py <deck.html> \ [--tokens <colors_and_type.css>] -o <workspace>/metrics.json ``` Swiirl HTML (optional — `swiirl-design` is internal brand-token tooling; skip this step if you don't have it): ```bash python3 <swiirl-design>/scripts/check_brand_html.py <deck.html> \ -o <workspace>/brand_check.json ``` Interpret flags with [metrics.md](references/metrics.md). **Done when:** `metrics.json` exists and every gate id is