poradnik
Czym jest DESIGN.md? (oraz AGENTS.md, CLAUDE.md i llms.txt)
DESIGN.md to plik tekstowy, który opisuje system wizualny marki (kolory, typografię, odstępy, komponenty i zasady), żeby ludzie i narzędzia AI budowali na tych samych decyzjach. Leży w projekcie albo jest dołączony do czatu, a narzędzia AI czytają go jako kontekst, zanim zaczną pisać lub projektować.
Pliki, które spotkasz
| Plik | Co to jest | Kto go czyta |
|---|---|---|
DESIGN.md | Pełny system wizualny marki w markdownie. brandmarkdown trzyma się formatu opublikowanego przez Google Labs (github.com/google-labs-code/design.md): tokeny w bloku nagłówka, zasady w treści. | Ludzie, Claude, ChatGPT, Cursor, v0, Lovable |
AGENTS.md | Instrukcje dla agentów AI, które piszą kod w repozytorium. | Codex, Jules, Aider i inni agenci, którzy czytają AGENTS.md |
CLAUDE.md | Pamięć projektu, którą Claude Code wczytuje w każdej sesji w tym folderze. | Claude Code |
.cursor/rules/*.mdc | Zasady, które Cursor stosuje do pasujących plików. | Cursor |
llms.txt | Krótki spis w głównym katalogu twojej strony, który wskazuje wyszukiwarkom AI i agentom najważniejsze podstrony. | Wyszukiwarki AI, agenci |
Dlaczego markdown
Brandbook w PDF jest pisany dla ludzi i model słabo sobie z nim radzi. Markdown to zwykły tekst z nagłówkami i tabelami: model czyta go dokładnie, a ty trzymasz go w tym samym miejscu co stronę albo prompty.
Zobacz pełny przykład: DESIGN.md przykładowej marki (po angielsku).