Naucz swojego agenta jak projektować — nie tylko jak kodować.
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.
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 → PoprawaSiedemnaś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.
Sklonuj repozytorium, potem dodaj jeden plik, żeby agent znajdował je w każdej sesji.
git clone https://github.com/aievolutionpl/agent-design-taste.git| Jednorazowo | W projekcie | Globalnie |
|---|---|---|
| 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. |
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.
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, alltwoj-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.
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.mdgit 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.
Jeśli jesteś agentem AI czytającym to repozytorium — ta sekcja jest dla ciebie.
- Nie generuj jeszcze UI.
- Przeczytaj
AGENT-BOOTSTRAP.md— 75 linii, potemSKILL.md. - Ustal tryb (projektowanie / budowa / przegląd / dopracowanie) i profil
kontekstu (LIGHT / STANDARD / FULL) →
docs/CONTEXT-PROFILES.md. - Przeanalizuj istniejący projekt, zanim cokolwiek zmienisz. Jeśli ma system
projektowy, wykonaj ANALYZE → MAP → ADAPT →
docs/PRECEDENCE.md. - Zachowaj ograniczenia marki. Tokeny stylów to domyślne wartości dla nowych projektów, a nie zgoda na przemalowanie cudzego produktu.
- Wybierz jeden styl dominujący przez
DECISION-MATRIX.md. Powiedz, dlaczego drugi w kolejności przegrywa. - Ł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.
- Buduj z tokenów. Każda wartość jest tokenem.
- 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. - Oceń przez
evaluation/DESIGN-TASTE-SCORE.md. - Usuń slop przez
ANTI-SLOP.md. Zero 🔴 BLOCKERÓW. - Iteruj, dopiero potem oddaj.
Routing maszynowy, bez parsowania prozy:
design-taste.manifest.json ·
styles/index.json
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ściPominię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
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).
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
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ścitokens.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.
| Biblioteka promptów daje ci | To 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ę |
marka i prawo ▸ dostępność ▸ potrzeby produktu ▸ DNA stylu ▸ tokeny repo ▸ gust agentaTokeny 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ć.
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 maszynowoKoszt 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.
- Każdy folder stylu musi odpowiadać na pytanie kiedy NIE używać tego stylu.
- Tokeny są kanoniczne. Jeśli
README.mditokens.csssię 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 — praktyczna edukacja AI, workflow, agenci i automatyzacja — po polsku i dla każdego. AI Evolution Labs — produkty AI, automatyzacja i technologia kreatywna.
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



