Skip to content

Latest commit

 

History

History
502 lines (368 loc) · 22 KB

README.pl.md

File metadata and controls

502 lines (368 loc) · 22 KB
Agent Design Taste od AI Evolution Polska — inteligencja projektowa dla agentów AI. Wybierz styl, buduj z tokenów, renderuj, audytuj.

Agent Design Taste

Inteligencja projektowa dla agentów AI

Naucz swojego agenta jak projektować — nie tylko jak kodować.

Licencja: MIT Skill v2.2.0 17 stylów validate AI Evolution Polska

English · Polski

Instalacja · Dla agentów AI · Workflow · 17 stylów · Galeria na żywo · Integracje

Uwaga: dokumentacja techniczna repozytorium (SKILL.md, DECISION-MATRIX.md, style, oceny) jest w języku angielskim — to język, w którym agenci pracują najpewniej. Ten plik to pełne wprowadzenie po polsku.


Po co to istnieje

Agenci AI budują działające aplikacje w kilka minut. I każda wygląda tak samo:

fioletowy gradient · szklane karty · wszędzie ten sam promień 24px · Inter w każdym rozmiarze · trzy identyczne karty funkcji · pływająca bryła 3D · „Trusted by 50,000+ teams" · wszystko wycentrowane · widok mobilny to po prostu desktop poskładany w pionie

<img src="assets/slop-vs-taste.webp" alt="Ten sam brief, dwa wyniki: po lewej domyślny wynik agenta — fioletowy gradient, odznaka z emoji, wycentrowany tekst, niepoparte „Trusted by 50,000+" i trzy identyczne karty; po prawej strona tern zaprojektowana z Agent Design Taste, z prawdziwą sesją terminala jako dowodem." width="100%">

To nie jest problem umiejętności. To problem wiedzy: nikt nie dał agentowi systemu projektowego ani sposobu podejmowania decyzji. Sięga więc po statystycznie najczęstszy wzorzec — i dokładnie dlatego wynik wygląda na wygenerowany.

To repozytorium daje agentowi jedno i drugie: prawdziwy system projektowy oraz proces wybierania wewnątrz niego.

Procesem jest produkt:

Produkt → Odbiorca → Styl → Layout → Tokeny → Render → Krytyka → Poprawa

Siedemnaście bibliotek stylów to łatwiejsza połowa. Ta, która naprawdę się liczy, to nauczenie agenta, żeby obserwował, decydował i potrafił obronić decyzję.

⭐ Jeśli to poprawia UI twojego agenta — zostaw gwiazdkę, żeby trafiło do większej liczby osób.


Instalacja

Sklonuj repozytorium, potem dodaj jeden plik, żeby agent znajdował je w każdej sesji.

git clone https://github.com/aievolutionpl/agent-design-taste.git
JednorazowoW projekcieGlobalnie
Chcesz spróbować raz. Nic nie instalujesz — wklejasz prompt. Jeden projekt. Leży obok kodu, commitowane razem z nim. Każdy projekt na twojej maszynie.

A · Jednorazowo — wklej ten prompt

Bez instalacji. Działa w Claude Code, Codex, Cursor, ChatGPT — wszędzie.

Użyj systemu Agent Design Taste: https://github.com/aievolutionpl/agent-design-taste

Przeczytaj najpierw AGENT-BOOTSTRAP.md, potem SKILL.md. Zanim napiszesz jakikolwiek UI:

1. Wypisz odbiorcę, typ produktu, osobowość marki, gęstość treści,
   główną akcję i emocję docelową — na piśmie.
2. Użyj DECISION-MATRIX.md, żeby wybrać JEDEN styl dominujący (plus maksymalnie
   jeden wspierający), i powiedz, dlaczego drugi w kolejności przegrywa.
3. Wczytaj TYLKO README.md i tokens.css tego stylu. Nie ładuj wszystkich 17.
4. Jeśli projekt ma już system projektowy, zastosuj docs/PRECEDENCE.md:
   przeanalizuj go, zmapuj się do niego, zaadaptuj — nigdy nie przemalowuj.
5. Buduj z tokenów. Każdy kolor, odstęp, promień i czas trwania to token.
6. Wyrenderuj w 1440 / 768 / 390 i spójrz na to. Przegląd kodu to nie
   przegląd wizualny.
7. Zrób audyt: ANTI-SLOP.md (zero BLOCKERÓW) i evaluation/DESIGN-TASTE-SCORE.md
   (wynik 75+), popraw dwa najsłabsze obszary, wyrenderuj ponownie, dopiero
   wtedy oddaj.

B · Instalacja w projekcie

cd twoj-projekt
git clone --depth 1 https://github.com/aievolutionpl/agent-design-taste.git
bash agent-design-taste/scripts/install.sh --agent claude   # albo codex, cursor,
                                                            # windsurf, copilot,
                                                            # gemini, agents, all
twoj-projekt/
├── agent-design-taste/     ← system
├── CLAUDE.md               ← pisze instalator: kieruje agenta do systemu
├── DESIGN.md               ← pisze agent: kontrakt wizualny twojego projektu
└── src/

Instalator nigdy nie nadpisuje bez --force, a --dry-run pokazuje plan.

C · Instalacja globalna

Jeden klon, używany wszędzie.

git clone https://github.com/aievolutionpl/agent-design-taste.git ~/design/agent-design-taste

# Claude Code — katalog skilla może być dowiązaniem; ładuje się tylko gdy trzeba
ln -s ~/design/agent-design-taste ~/.claude/skills/agent-design-taste

# Codex — obowiązuje w każdym otwieranym projekcie
cp ~/design/agent-design-taste/adapters/AGENTS.md ~/.codex/AGENTS.md

# Gemini CLI
cp ~/design/agent-design-taste/adapters/GEMINI.md ~/.gemini/GEMINI.md

git pull aktualizuje wszystkie projekty naraz.

Konfiguracja per narzędzie — Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Lovable, v0 — z dokładnymi ścieżkami, które każde z nich dokumentuje: docs/INTEGRATIONS.md

Sprawdź, czy działa. Zapytaj agenta, bez żadnego innego kontekstu: „Jaki plik czytasz jako pierwszy przed zmianą UI w tym projekcie i jakie są kanoniczne viewporty?" Poprawna odpowiedź: AGENT-BOOTSTRAP.md oraz 1440 / 768 / 390.


Dla agentów AI

Jeśli jesteś agentem AI czytającym to repozytorium — ta sekcja jest dla ciebie.

  1. Nie generuj jeszcze UI.
  2. Przeczytaj AGENT-BOOTSTRAP.md — 75 linii, potem SKILL.md.
  3. Ustal tryb (projektowanie / budowa / przegląd / dopracowanie) i profil kontekstu (LIGHT / STANDARD / FULL) → docs/CONTEXT-PROFILES.md.
  4. Przeanalizuj istniejący projekt, zanim cokolwiek zmienisz. Jeśli ma system projektowy, wykonaj ANALYZE → MAP → ADAPT → docs/PRECEDENCE.md.
  5. Zachowaj ograniczenia marki. Tokeny stylów to domyślne wartości dla nowych projektów, a nie zgoda na przemalowanie cudzego produktu.
  6. Wybierz jeden styl dominujący przez DECISION-MATRIX.md. Powiedz, dlaczego drugi w kolejności przegrywa.
  7. Ładuj tylko to, czego potrzebujesz. Jedno DNA stylu to ~2,7 tys. tokenów. Wszystkie siedemnaście to ~46 tys. — a szesnaście odrzuconych stylów w kontekście pogarsza twój wynik.
  8. Buduj z tokenów. Każda wartość jest tokenem.
  9. Renderuj w 1440 / 768 / 390 i patrz na wynik — node scripts/screenshot.mjs <url-lub-plik> robi wszystkie cztery viewporty i kończy błędem przy przewijaniu poziomym na mobile.
  10. Oceń przez evaluation/DESIGN-TASTE-SCORE.md.
  11. Usuń slop przez ANTI-SLOP.md. Zero 🔴 BLOCKERÓW.
  12. Iteruj, dopiero potem oddaj.

Routing maszynowy, bez parsowania prozy: design-taste.manifest.json · styles/index.json


Workflow

Dziesięć kroków workflow: Understand i Choose style (decyzja), Typography, Layout, Tokens (projekt), Build, Render, Audit, Remove slop (weryfikacja), Polish. Pętla wraca z Remove slop do Build, gdy wynik jest poniżej 75 albo pojawi się bloker.

Wersja tekstowa (dla agentów i czytników ekranu)
        ZROZUM              odbiorca · produkt · osobowość · gęstość · emocja
             │
       WYBIERZ STYL         punktacja ważona, bramki weta, i dlaczego nie inne
             │
        TYPOGRAFIA          role przed krojami — uzasadnione jednym zdaniem
             │
          LAYOUT            nazwany wzorzec, nie znowu to samo hero
             │
          TOKENY            rozstrzygnięte przez precedencję, zapisane w DESIGN.md
             │
          BUDUJ             najpierw ograniczenia: każda wartość to token
             │
        RENDERUJ            1440 · 768 · 390 — w prawdziwej przeglądarce, oczami
             │
          AUDYT             13 ważonych kategorii, 8 twardych blokerów
             │
      USUŃ AI SLOP          BLOCKER · STRONG SMELL · MINOR SMELL
             │
        DOPRACUJ            rytm · stany focus · reduced motion · prawdziwe treści

Pominięcie ZROZUM, WYBIERZ, RENDERUJ albo USUŃ SLOP to porażka — nawet jeśli wynik wygląda dobrze. „Wygląda dobrze" i „jest zaprojektowane" to dwie różne rzeczy.

Zobacz cały proces na jednym briefie: docs/EXAMPLE-WORKFLOW.md

Jak wybierany jest styl

Wykres routingu dla briefu piekarni (ciepła, spokojna, konsumencka, niska gęstość, mobile-first): Brutalist / Anti-Grid i 3D / Spatial UI odpadają przez weto mobile-first; Organic / Natural wygrywa z wynikiem +11, drugi Liquid Glass +5; Terminal / Dev Dark ma −4.

Jedenaście sygnałów briefu → bramki weta (bezwzględne) → punktacja ważona → jeden styl dominujący plus argument przeciw drugiemu w kolejności. Wykres powyżej to nie ilustracja: scripts/render_assets.mjs liczy go z styles/index.json tymi samymi wagami, których używa agent (DECISION-MATRIX.md).


17 stylów

17 stylów, jedna decyzja: kafelek dla każdego stylu od 01 Minimalism do 17 Organic / Natural, plus puste miejsce na kolejny styl.

Kafelki powyżej to grafika poglądowa. Prawdziwe strony przykładowe zobaczysz w galerii na żywo, do której link jest pod tabelą.

# Styl Tożsamość Najlepszy do Gęstość
01 Minimalism Mniej, ale lepiej B2B SaaS, fintech, premium niska–śr.
02 Glassmorphism Przezroczyste. Warstwowe. Narzędzia dev, dashboardy niska–śr.
03 Liquid Glass Płynne światło i ruch Aplikacje konsumenckie i kreatywne niska–śr.
04 Bento Grid Modularne, uporządkowane bloki Produkty bogate w funkcje śr.–wys.
05 Neo-Brutalism Odważny, surowy, nieoczywisty Marki młodzieżowe, narzędzia twórców niska–śr.
06 Brutalist / Anti-Grid Łam siatkę celowo Portfolia, agencje, sztuka niska
07 Neumorphism Miękkie wytłoczone powierzchnie Tylko powierzchnie dekoracyjne ⚠️ niska
08 Claymorphism Radosne, puszyste 3D Dzieci, edukacja, wellness niska–śr.
09 Skeuomorphism Wygląda jak rzecz prawdziwa Audio, instrumenty, finanse śr.–wys.
10 Swiss / International Siatka, typografia, porządek Narzędzia dev, dane, korporacje śr.–wys.
11 Editorial / Magazine Czyta się jak magazyn Media, długie formy, luksus śr.–wys.
12 Maximalism Więcej znaczy więcej Moda, wydarzenia, kultura wysoka
13 Y2K / Retrofuturism Chrom, bańka, optymizm Muzyka, streetwear, gaming śr.–wys.
14 3D / Spatial UI Głębia, przez którą się przechodzi Web3, premiery, immersja niska–śr.
15 Kinetic Typography Typografia jako interfejs Portfolia, kampanie niska
16 Terminal / Dev Dark 🆕 Sygnał na czerni CLI, narzędzia dla agentów AI, infra śr.–wysoka
17 Organic / Natural 🆕 Ciepło, ziemia, rękodzieło Jedzenie, rzemiosło, wellness, gościnność niska–śr.

Galeria na żywo wszystkich 17 stron przykładowych → (widok desktop i 390 px, filtr gęstości, wyszukiwanie po typie produktu) · źródło

Co jest w każdym folderze stylu

Nie moodboard. Kompletny, samowystarczalny brief projektowy:

styles/10-swiss-international/
├── README.md              Design DNA w 24 sekcjach — filozofia, typografia,
│                          siatka, kolor, komponenty, motion, RWD, dostępność,
│                          kiedy NIE używać, do/don't, anti-slop, ruch firmowy
├── tokens.css             kanoniczne design tokens (jasny + ciemny)
├── tokens.json            te same tokeny dla narzędzi projektowych i JS
├── tokens.tailwind.css    te same tokeny jako blok @theme w Tailwind v4
├── prompts.md             gotowe prompty dla Codex / Claude / Lovable / v0
└── example.html           działająca strona, jeden plik, zero zależności

tokens.css to źródło prawdy; pozostałe dwa są z niego generowane i sprawdzane w CI. Jeśli tekst i token się nie zgadzają — wygrywa token.


Czym to się różni od biblioteki promptów

Biblioteka promptów daje ciTo daje twojemu agentowi

Tekst do wklejenia

Proces decyzyjny z bramkami weta i punktacją ważoną

Styl — o ile już wiesz, którego chcesz

Powód wyboru stylu — i argument przeciw drugiemu w kolejności

Wszystko, za każdym razem

Routing kontekstu — LIGHT / STANDARD / FULL, jedno DNA naraz

Wynik

Wynik wyrenderowany, oceniony, oczyszczony ze slopu i poprawiony

To, co model ma domyślnie

Jawny łańcuch precedencji, który chroni istniejącą markę

Precedencja — reguła, która chroni twoją markę

marka i prawo ▸ dostępność ▸ potrzeby produktu ▸ DNA stylu ▸ tokeny repo ▸ gust agenta

Tokeny stylów to domyślne wartości dla nowych projektów. Gdy projekt ma już system projektowy, agent go analizuje, mapuje się do niego i adaptuje — nie przemalowuje go. A gdy kolor marki nie spełnia kontrastu, odpowiedzią jest zachowanie marki i wyprowadzenie dostępnego wariantu z tej samej rodziny odcieni — nie podmiana marki i nie wysłanie tekstu, którego nie da się przeczytać.

→ docs/PRECEDENCE.md


Mapa repozytorium

Wszystko i kiedy to ładować
AGENT-BOOTSTRAP.md         punkt wejścia — 10 kroków i czego NIE ładować
SKILL.md                   workflow, twarde reguły, priorytet wiedzy
DECISION-MATRIX.md         11 sygnałów → bramki weta → punktacja ważona
STYLE-COMBINATIONS.md      bezpieczne i niebezpieczne połączenia stylów
LAYOUT-PATTERNS.md         43 wzorce jako biblioteka decyzyjna
ANTI-SLOP.md               BLOCKER / STRONG SMELL / MINOR SMELL

docs/
  PRECEDENCE.md            rozstrzyganie konfliktów · ANALYZE → MAP → ADAPT
  CONTEXT-PROFILES.md      LIGHT / STANDARD / FULL, ze zmierzonym kosztem
  INTEGRATIONS.md          instalacja per agent, zweryfikowana z dokumentacją
  EXAMPLE-WORKFLOW.md      jeden brief, przeprowadzony od początku do końca
  STYLE-TEMPLATE.md        wymagana struktura dla stylu #18

styles/
  NN-nazwa/                17 samowystarczalnych Design DNA
  index.json               routing maszynowy: id, aliasy, punktacja, weta

accessibility/             podłoga dostępności + błędy typowe dla każdego stylu
responsive/                drabina viewportów; rekompozycja, nie układanie w stos
typography/                role, sygnały, metryki, wsparcie językowe, wydajność
visual-language/           fotografia, 3D, ikony, tekstura, kierunek artystyczny
motion/                    budżety czasu, easing, reduced-motion
component-patterns/        19 komponentów × 8 stanów interakcji
layout-patterns/           siatki, skala odstępów, anatomia sekcji
design-tokens/             kategorie tokenów, nazewnictwo, formaty

evaluation/
  DESIGN-TASTE-SCORE.md    13 ważonych kategorii + 8 twardych blokerów
  RENDERED-VERIFICATION.md przegląd kodu to nie przegląd wizualny
  MODE-ROUTING.md          czasownik → tryb → wycinek wiedzy
  TASTE-LOOP.md            uczenie preferencji między sesjami

prompts/
  DESIGN-CONTRACT.md       wzorzec DESIGN.md
  PROMPT-LIBRARY.md        szkielety promptów oparte na ograniczeniach

adapters/                  pliki do skopiowania dla każdego agenta
scripts/                   gen_tokens · gen_manifest · validate · install
                           check_contrast · screenshot · render_assets
assets/src/                źródła HTML grafik renderowanych (workflow, wykres routingu, social preview)
design-taste.manifest.json manifest repozytorium czytelny maszynowo
Koszt kontekstu — dlaczego agent nie może ładować wszystkiego
Ładujesz ~tokenów
AGENT-BOOTSTRAP.md 0,8 tys.
Profil LIGHT — poprawka komponentu ~3 tys.
Profil STANDARD — landing page ~8 tys.
Profil FULL — cały produkt ~25 tys.
Jedno DNA stylu ~2,7 tys.
Wszystkie 17 DNA stylów ~46 tys. ← nigdy
Całe repozytorium ~119 tys.

Zmierz sam: python3 scripts/validate.py --budget

DNA stylu określa już kroje, skalę, layout, kolor, komponenty, motion, dostępność i reguły anti-slop. Jeden styl to kompletny brief. Siedemnaście to szum z briefem gdzieś w środku.

Współpraca i walidacja
python3 scripts/validate.py          # pełna kontrola strukturalna — to samo co CI
python3 scripts/check_contrast.py    # WCAG AA dla palety każdego stylu
python3 scripts/validate.py --budget # zmierzony koszt kontekstu per plik
python3 scripts/gen_tokens.py        # regeneruje tokens.json + tokens.tailwind.css
python3 scripts/gen_manifest.py      # regeneruje styles/index.json + manifest
node    scripts/screenshot.mjs 10    # renderuje styl w 1440/768/390/360
node    scripts/render_assets.mjs    # odbudowuje wszystkie grafiki README ze źródeł

CI sprawdza, czy każdy folder stylu jest kompletny, czy istnieją wszystkie wymagane kategorie tokenów (w tym --shadow-focus), czy każdy link wewnętrzny działa, czy każdy example.html się parsuje, czy wszystkie 17 DNA ma tę samą 24-sekcyjną strukturę i czy pliki generowane są zgodne ze źródłem. CI dodatkowo mierzy każdą paletę względem WCAG AA i renderuje wszystkie 17 stron przykładowych w 1440/768/390/360, kończąc błędem przy przewijaniu poziomym. Reguły są egzekwowane, nie tylko zapisane.

Diagram workflow i wykres routingu są renderowane z HTML w assets/src/ przez scripts/render_assets.mjs; wykres routingu jest liczony z styles/index.json, więc po zmianie punktacji stylu wystarczy uruchomić skrypt ponownie.

Dodajesz styl #18? CONTRIBUTING.md i docs/STYLE-TEMPLATE.md mają pełną listę kontrolną. Sekcja, którą recenzenci czytają pierwszą, to „When NOT to use" — styl bez uczciwie opisanego trybu porażki nie został przemyślany.


Zasady

  • Każdy folder stylu musi odpowiadać na pytanie kiedy NIE używać tego stylu.
  • Tokeny są kanoniczne. Jeśli README.md i tokens.css się nie zgadzają, wygrywa token, a README jest błędem do zgłoszenia.
  • Strony przykładowe to pojedyncze pliki HTML, zero zależności, otwierasz w przeglądarce.
  • Prompty to sprawdzone wzorce, nie życzenia — zwięzłe, oparte na ograniczeniach.
  • Żadnych niepopartych twierdzeń: bez zmyślonych cytowań, bez niezweryfikowanych integracji, bez statystyk bez źródła. Ta reguła dotyczy również tego repozytorium.

AI Evolution Polska — edukacja AI, społeczność i praktyka: darmowy kurs, szkolenia firmowe i wdrożenia agentów. aievolutionpolska.pl

Zbudowane przez AI Evolution Polska + AI Evolution Labs

AI Evolution Polska — praktyczna edukacja AI, workflow, agenci i automatyzacja — po polsku i dla każdego. AI Evolution Labs — produkty AI, automatyzacja i technologia kreatywna.

Strona GitHub X


Jeśli Agent Design Taste pomógł twojemu agentowi budować lepsze interfejsy:

⭐ Zostaw gwiazdkę  ·  🤝 Wkład mile widziany  ·  🐛 Zgłoś issue

MIT © AI Evolution Polska / AI Evolution Labs