# FLAKK DESIGN REVIEW GATE 1.0 (19.11.2026)

No builder screen goes live without a pass from the design director. gwvf (release captain) merges only waves whose screens carry a `DESIGN-PASS` line in this folder's `reviews/`. This applies to bsfa, sxp3/92hg, g76m, 6np4, 9eq7, m2de, teqe/we73 and every later builder, for the Flakk staff app, the desktop console, Flakk Guest, flakk.app and the EXEs.

## 1. What a builder submits (one packet per screen or component)

Put the packet in your task outbox under `design-review/<screen>/` and send `task_handoff_send` to **r-20261119-161505922-dcv2** with kind `files` (strict JSON: `changed` is an array of strings, `files` is an array of `{path, sha256, bytes}`):

1. **Screenshots**: `<screen>-390.png` (390 × 844, WebKit, 2×) and `<screen>-1440.png` (1440 × 900, Chromium, 2×) at text scale 1, plus `<screen>-390-s1.3.png` at `--fk-scale 1.3`. Every role the screen serves (the 14-role checker list) if the screen differs per role.
2. **Motion recordings**: `<screen>-390.webm` and `<screen>-1440.webm` showing in order: press on a row and on the primary button, tab switch forward and back (or sidebar switch), sheet/panel open and close (including a drag-dismiss on phone), one list change, one success state, one error state. Plus the frame-time json from `flakk_design_check --motion` (p50, p95, % > 34 ms).
3. **Reduced-motion pair**: `<screen>-390-rm.webm` with `prefers-reduced-motion: reduce` emulated.
4. **Haptic map**: `haptics.md` table: control → kind → trigger → `file:line` (HAPTICS.md §6).
5. **Checker output**: `flakk_design_check` ≥ 1.5.1 report, 0 fails, with the waiver file if any.
6. **Security**: for anything web-facing, the `security-audit` + `security-review` output with every critical/high/medium fixed, in one line.
7. **Changed files**: paths + sha256 + bytes, and the rollback id of the lane.

## 2. What the director checks (in this order; the first fail stops the review)

A. **Hard fails** (BIBLE §1.2): header bar on phone; pill/chip/segment/sub-tab row; labelled or unequal dock tabs; asymmetric bar; a second theme or dark-mode rule; count discs, tiles, gradient cards, coloured text on paper; text < 16 px; targets < 48 px; animated layout/paint properties; a transform on a fixed child's container; a loop that runs under reduced motion; emoji or filled icons.
B. **Structure** (BIBLE §3): context → hero → lede → sections; one amber control per region; rules not boxes; the right role content on the first screen; desktop sidebar + top + ledger + two columns; rail where specified.
C. **Type and colour** (BIBLE §2): Fraunces for the hero/ledger/row values, Geist elsewhere; sizes from the scale; contrast ≥ 4.5:1 on every pair (the checker's contrast2 list).
D. **Components** (BIBLE §4): class names and anatomy match; states (§5) present: empty, loading after 180 ms, error sentence, offline rule, success in place.
E. **Motion** (MOTION.md): each choreography matches the spec's durations, curves and origins; both directions; interruptible; frame-time gate passed; reduced-motion pair correct.
F. **Haptics** (HAPTICS.md): the map matches §1; success/error fired from the result path; no forbidden ticks.
G. **Copy** (BIBLE §6): sentence case, no exclamation marks, times and names present, IS strings present where the screen is bilingual.
H. **Security line** present for web-facing code.

## 3. The verdict

The director writes `reviews/<date>-<task>-<screen>.md` with: `DESIGN-PASS` or `DESIGN-FAIL`, the numbered fix list (each item: what, where, the bible section, the expected result), and sends it back with `task_handoff_send` kind `decision`. A FAIL packet is resubmitted as a new version with the same screen name; the director re-checks only the failed items plus hard fails.

gwvf's rule: a wave ships only when every screen in it has a `DESIGN-PASS` file newer than the screen's last changed sha256. gwvf includes the review file names in its release note.

## 4. Fast lane

A change that touches only copy, a token value already in the bible, or a bug fix with no visual change may ship with a `status` handoff ("no visual change, screenshot before/after identical, md5 …") and no full packet. The director can pull it back within the ack window.

## 5. Tooling the builders use (all on the Lenovo or the PC, no new dependencies)

- `flakk_design_check.py` ≥ 1.5.1 (tools/flakk_design): 14 roles × 390/1440, tab count, orb-drag rule, contrast; ≥ 1.6 adds `--motion` (frame-time json), `--labels` (fails on visible dock labels / unequal widths) and `--theme` (fails on dark-mode rules).
- Playwright WebKit 390 × 844 and Chromium 1440 × 900 with `deviceScaleFactor 2`; recordings via `recordVideo`; reduced motion via `emulateMedia({ reducedMotion: 'reduce' })`; CPU throttle via CDP `Emulation.setCPUThrottlingRate 4`.
- Fonts self-hosted (Geist, Fraunces, Geist Mono), so screenshots never fall back to Times or Arial.

## 6. Who reviews what today

| Builder | Scope | First review |
|---|---|---|
| bsfa | staff app luxe layer, Today/HK/Maint, desktop sidebar | `reviews/2026-11-19-bsfa.md` (FAIL, fix list sent) |
| sxp3 / 92hg | motion layer (flakk-motion.css/js, boot.js, site motion) | `reviews/2026-11-19-sxp3.md` (conditional, fix list sent) |
| g76m | mail popup | on submission |
| 6np4 | role screens | on submission |
| 9eq7 | Guest keynote / onboarding | on submission (BIBLE §3.3 applies) |
| m2de, teqe/we73 | their screens | on submission |
| 7jmp | orb gestures + confirm haptic | haptic map requested (HAPTICS §5) |
| m7zw | native bridge | `haptics` surface per HAPTICS §4 |
| gwvf | release captain | enforces §3 |
