DESIGN.md, design.md Vercela i AGENTS.md: który plik do czego

Krótka odpowiedź

AGENTS.md to instrukcja pracy w repozytorium: kiedy co wczytać, jak sprawdzać zmiany. design.md od Vercela to publiczny przewodnik projektowy plus gotowy arkusz CSS. DESIGN.md od Google Labs to format: tokeny (kolory, fonty, narożniki) w YAML na górze pliku i opis w markdownie, z linterem do sprawdzania.

Nazwa jest prawie ta sama, ale to nie jeden standard. Wpis Vercela nie odwołuje się do specyfikacji Google.

Porównanie w jednej tabeli

Stan na 16.10.2026, na podstawie źródeł na dole.

design.md Vercela: przewodnik i gotowe klocki

Plik Vercela zaczyna się od zdania „Act as an excellent Vercel designer, editor, information architect, data storyteller, and design engineer”. Nie ma w nim listy kolorów w YAML. Zamiast tego opisuje, jak budować stronę z gotowych klas: pasek statystyk, tabela, wykres, kalkulator.

Siła tego podejścia to gotowy CSS. Vercel pisze, że zabrał modelowi decyzje o typografii, odstępach i układzie, bo agenci ciągle wymyślali własne.

DESIGN.md Google: tokeny, które da się sprawdzić

W specyfikacji Google plik ma dwie warstwy. Na górze, między liniami ---, tokeny w YAML: dokładne wartości. Pod spodem sekcje markdown (Overview, Colors, Typography, Layout, Shapes, Components, Do's and Don'ts), które tłumaczą, dlaczego tak i jak tego używać.

Do tego jest narzędzie wiersza poleceń: sprawdza plik ze specyfikacją, łapie zepsute odwołania do tokenów i kontrast WCAG, wynik zwraca jako JSON. Format ma status „alpha”, więc Google uprzedza, że będzie się zmieniał.

npx @google/design.md lint DESIGN.md

AGENTS.md: kto co wczytuje

U Vercela AGENTS.md jest drogowskazem. Ten w repozytorium mówi agentowi, kiedy wczytać skill product-design. Ten w folderze skilla opisuje kolejność wczytywania, walidację i zasady zmian, a SKILL.md prowadzi samą pracę.

Wniosek dla ciebie: plik ze stylem nic nie da, jeśli agent go nie przeczyta. Jedna linijka w AGENTS.md, która każe przy zmianach w UI wczytać DESIGN.md, załatwia sprawę.

## UI
Przy każdej zmianie wyglądu strony wczytaj najpierw DESIGN.md z katalogu głównego.
Używaj tylko kolorów, fontów i narożników z tego pliku. Nie dodawaj nowych.

Który wybrać

Najczęstsze błędy