# DESIGN-SYSTEM — creative + design direction (read before building anything)
Muse owns creative direction. Everything a builder needs to hit the bar without the bots.

| File | Use |
|---|---|
| `SCORECARD-v1.1.md` | How every concept is scored (100 pts; **82+ = PASS**). Criteria: first impression 20 · signature 15 · legibility 15 · booking 15 (L-005, hidden booking = gate fail) · distinctness 10 · craft 10 · perf 10 · truth 5. |
| `BRIEF-TEMPLATE.md` | Fill one per pro before building. |
| `briefs/` | Every Muse brief written so far (Julee Marie, Arcane Glow, Nail Retreat Room, Unforgettable Hair, Flow State Lounge), SELECTION.md (why these 4), archetype DIRECTION (salons.site Pro profiles), claim-landing S2-DIRECTION. |
| `lessons/LESSONS-L001-L005.md` | Builder must read before every build. L-001 mobile-first cinematic · L-002 Muse review rules · L-003 external-review rules · L-004 clip/tag/caption truth · L-005 booking-first. |
| `PILL-RULING.md` (below) | Muse's sticky Book pill ruling. |
| `brand-handoff-R6/` | DGENIUS brand handoff (R6): BRAND-SPEC, COMPONENTS, DO-NOT-BREAK, tokens.css/json, marks, motion, frames. |
| `creative-library/` | Reusable motion/layout patterns (`modules/pat-*.md`) + index. |
| `reviews-and-scores/` | BUILD-LOGs (contain Muse review rounds + fix lists), Julee S6 fixes, external review of Julee, landing LANDING.md (Muse acceptance). Summary below. |

## Pill ruling (Muse, 2026-10-30)
- The sticky Book pill sits **only over media or plain background** — never over text, captions, controls, CTAs, accordion headers, service rows, footer text, or a focal subject (the pro's work is the subject edge to edge, e.g. never on nails).
- It hides while any of those is inside its ~84px zone and while an inline 56px CTA is ≥80% on screen. **Never half-animated at rest. No spacer bands** to make room for it.
- Never over the signature pin, an open selector/sheet/accordion, or the final CTA. ≥44px + safe-area inset; one verb "Book with <Name>".
- Implementation reference: `02-…/M-20261029-010/SR-86cf68c094/v3/js/app.js` (IntersectionObserver on the pill zone) and its `_build/qa.js` (per-20px-step violation audit).
- Related ruling (dissolve captions): text must never be able to REST mid-fade. Scrub footage with scroll, but switch captions at the 50% crossover with a ~200ms time-based fade, so text is always 100% or 0%.

## salons.site booking rule (Muse, 2026-10-30) — pro pages on the platform
Opaque docked full-width booking bar ≥64px with safe-area padding; content padded beneath it; visible ≥90% of scroll depth; hidden only while the finale CTA is on screen; only ≥56px targets count. Menu rows say "Book" at every width, all other CTAs "Book with <Name>". The floating pill (ruling above) remains an option for cinematic Styled.page sites only.
Landscape-opening rule: at ≤430px stage ≥4:5 on the focal, else name-below layout; scrim solid band ≤35%.

## Scores and verdicts so far
| Concept | Rounds | Verdict |
|---|---|---|
| Julee Marie (M-20261029-008) | Scored under scorecard v1 (before L-005); see `SCORECARD-v1.1.md` C-rows + S6-FIXES + external review | Benchmark; re-check booking (C4/G5) vs v1.1 before using as the bar. Truth fix pending (tagline). |
| Nail Retreat Room (S2b) | FAIL 57 → 72 → **PASS 83** (v3) | First impression 15/20, signature 12/15, legibility 13/15, booking 14/15, distinctness 8/10, craft 7/10, perf 9/10 (emulated), truth 5/5. Polish v3.1 queued. |
| Arcane Glow (S2a) | see its BUILD-LOG | Built. |
| Unforgettable Hair (S2c) | v2 reviewed; v3 (fix2) in progress | Awaiting re-review. |
| Flow State Lounge (S2d) | brief only | Not built. |
| Claim landing (M-20261030-002) | fix1 | **ACCEPTED** (0/616 contrast failures); 2 non-blocking polish notes. |
| salons.site challenger (M-20261030-001) | Muse S2 review (`reviews-and-scores/M-20261030-001_challenger/`) | **All 5 FAIL G5 booking: p1 65 · p2 64 · p3 64 · p4 57 · p5 61** (≈66–74 with booking fixed). New docked-bar rule below. Lens S2 review done (`01-salons-site-challenger/lens-review-M-20261030-001/REPORT.md`): best booking page of the four, not yet a better platform base than BeautyOS. |