> **PromptEye Brand Book & Design Language** · Lista kontrolna · PL (wersja źródłowa) · stan 28.10.2026
> Strona dla ludzi: https://brand.prompteye.com/pl/lista-kontrolna/ · English: https://brand.prompteye.com/en/checklist.md · indeks dla agentów: https://brand.prompteye.com/llms.txt
> Ścieżki plików są względne wobec https://brand.prompteye.com/ds/ (np. `tokens/colors.css` → https://brand.prompteye.com/ds/tokens/colors.css), odwołania do `*.md` wobec https://brand.prompteye.com/ds/docs/. Poza Claude Design zamiast `_ds_bundle.js` wczytaj `styles.css` i skrypty `js/pe-light.js`, `js/pe-pl.js`, `js/pe-raster.js`, `js/pe-motyw.js` (w tej kolejności).

# Lista kontrolna przed oddaniem

## Tło i motyw

- [ ] Motyw dodany atrybutem (`data-pe-hero`, `data-pe-cta`, …), nie rysowany ręcznie.
- [ ] Kolumna tekstu wskazana (`.ah-in`, `h2` w CTA albo `data-pe-tekst`). `data-pe-uklad` na sekcji ma oczekiwaną wartość.
- [ ] Obiekt nie wchodzi w tekst, wygasa w jego stronę.
- [ ] Gradient naprzeciw tekstu (tekst na dole → G).
- [ ] Gradient dobrany z tabeli „Jak dobrać i ustawić gradient” (`tla.md`): hero, okładka lub nagłówek bez motywu = G5 łukiem, rozciągnięty.
- [ ] Przejście gradientu zajmuje co najmniej połowę kadru. Nie ma wąskiego paska koloru pod tekstem.
- [ ] Strona w jasnym i ciemnym motywie: nagłówki i gradienty są takie same w obu.
- [ ] Hero: tytuł i lead do 3 linii.
- [ ] Tekst nie stoi na kolorze. Jeśli sekcja ma `data-pe-czytelnosc` większe niż ok. 0,15, tekst jest za długi na kadr: skróć tytuł lub lead albo powiększ kadr.
- [ ] Jasne F: rama według miejsca (www / pudełko / bez ramy), bez mieszania w serii.
- [ ] Siatka kropek tylko na jednolitym tle, nie pod tekstem, nie razem z motywem.
- [ ] Brak gradientów CSS bez ziarna.

## Kolor

- [ ] Tylko tokeny `--pe-*` (albo wartości z `tokens.json`).
- [ ] **Pomarańcz** (`kolor.md`, punkt 2): kropka po tytule nigdy z punktem motywu; przy `b1a` bez kropki po tytule i bez punktów w przyciskach obok; w danych tylko lider.
- [ ] Pomarańcz nie jest tekstem ani tłem. Kobalt nie wypełnia przycisku.
- [ ] Mały tekst ma kontrast ≥ 4,5 : 1 (linki na bieli: Kobalt 600).

## Typografia i układ

- [ ] Geist w nagłówkach, Inter w tekście. Bez trzeciego kroju (poza e-mailem).
- [ ] Rozmiary i marginesy z tabeli formatów (`uklad.md`), pismo zaokrąglone do 4 px.
- [ ] `.dot` tylko w nagłówkach-hasłach; tytuł-pytanie bez kropki.
- [ ] Polskie zasady: `data-pe-typo` albo ręcznie (spacja przed %, spójniki).
- [ ] Logo: właściwy wariant (kolor / biały), właściwy róg, min. 14 px.

## Treść

- [ ] „Poleca”, nie „widać”; efekt, nie czynność (`marka.md`).
- [ ] Liczby tylko potwierdzone. Bez „93 na 100”.
- [ ] Przyciski: czasownik + rzecz, maks. 3 słowa, jeden poziom 1 na sekcję.

## Dane i raporty

- [ ] Tytuł wykresu to wniosek. Tytuł tabeli to wniosek albo opis; tabela w tekście może być bez tytułu i figury. Figura ma stopkę: źródło, próba (n), okres, adres.
- [ ] Ikony modeli z `assets/llm/sprite.svg`, wklejonego raz do strony. Bez niego ikony są puste.
- [ ] Kolory danych z klas `css/dane.css` (`.q1`–`.q4`, `.hm1`–`.hm5`, `.up`), nie wpisane ręcznie.
- [ ] Tytuł rozdziału raportu bez kropki: to nazwa, nie hasło.
- [ ] Strona z blokami systemu wczytuje Geist i Inter (`styles.css` albo Google Fonts jak w arkuszach).
- [ ] Tabela złożona z warstw z `dane.md`, każda dodana z powodu. Każda wartość procentowa ma „%” przy liczbie, liczby stoją w polach `.lv` i przecinki są jeden pod drugim.
- [ ] Najlepszy model w wierszu nie jest grubszy niż najważniejsza miara. Po wyłączeniu mapy ciepła linie wierszy są widoczne.
- [ ] Nowa klasa w `css/` nie powtarza nazwy, która już jest w systemie (np. `.kl`, `.l`, `.v`, `.s`); sprawdź w `css/` i `guidelines/css/`.
- [ ] Tabela na telefonie: nazwy firm są całe (zawijają się, nie ucinają), kropka lidera stoi przy numerze.
- [ ] Szerokości kolumn w `style` na komórkach nagłówka, nie w `<colgroup>`: Claude Design go wyrzuca.
- [ ] Sortowanie i filtr modeli tylko tam, gdzie działa skrypt (strona raportu). W PDF, grafice i artykule tabela jest bez znaczników, posortowana po najważniejszej mierze.
- [ ] Znacznik sortowania stoi zaraz za ostatnim słowem nagłówka (`.so-t`), nie przy krawędzi kolumny, i nie wychodzi poza komórkę. Pod nagłówkami jest jedna linia 2 px: pod kolumną, po której sortujesz.
- [ ] Po wyłączeniu modelu widoczność, `#` i lider są przeliczone, a średnia pozycja i otwiera listę wygaszone, z notą pod paskiem.

## Eksport i zrzuty

- [ ] PDF, PNG, druk: `data-pe-static` i `await PEmotyw.ready`.
- [ ] Czarny kadr bez kropek = motyw nie wystartował. Wywołaj `PEmotyw.init(document)`. Nie dorysowuj.

## Style strony

- [ ] Style strony (np. `.strona h1 {…}`) nie przeciekają do sekcji systemu. Ogólne selektory piszesz z zakresem (`.strona > header h1`), inaczej nadpisują `.ah-in h1` i hero dostaje zły rozmiar tytułu.

## Najczęstsze błędy

| Błąd | Poprawnie |
|---|---|
| kropki lub mapa narysowane w SVG/CSS | atrybut `data-pe-hero`, rysuje skrypt |
| tekst na środku kadru nad motywem | tekst po lewej, u góry albo na dole; obiekt przy prawej krawędzi |
| kropka po tytule obok punktu motywu | tytuł bez kropki |
| siatka kropek na gradiencie (hero z `tla.html`) | siatka tylko na jednolitym tle |
| gradient ściśnięty w pasek pod tekstem (G3 jako podkreślenie) | G5 rozciągnięty, miejsce na tekst z kadru (`tla.md`) |
| kropka po każdym tytule strony lub rozdziału | `.dot` tylko po nagłówku-haśle (`typografia.md`) |
| `b1a` w nawigacji, także w jasnym hero F | w nawigacji `b1b` (`komponenty.md`, punkt 4) |
| `assets/prompteye-logo-white.svg` wzięte jako logo jednobarwne | pakiet `assets/logo/svg/` (`logo.md`): stary plik to logo w kolorze na ciemne tło |
| kolory „na oko” (#3366FF, #FF6600) | tokeny z `kolor.md` |
| hero z `archive/` lub `explorations/` | tylko `docs/`, `guidelines/`, `templates/` |
| `<use href="#llm-gpt">` bez sprite’a w dokumencie: puste ikony modeli | wklej `assets/llm/sprite.svg` raz do strony (`dane.md`) |
| kropka po nazwie rozdziału raportu | tytuł rozdziału bez kropki (`typografia.md`) |
| pojedyncze pliki CSS bez fontów: Geist i Inter zastąpione fontem systemowym | `styles.css` albo link do Google Fonts |
