DESIGN.md je specifikace od Google Labs Code, která má dát coding agentům trvalý a strukturovaný popis vizuální identity projektu. Místo toho, aby agent při generování UI jen hádal styl z existujících obrazovek nebo obecných instrukcí, dostane jeden soubor s přesnými design tokeny a textovým vysvětlením, jak se mají používat. Cílí hlavně na situace, kdy AI píše nebo upravuje frontend a potřebuje konzistentně držet barvy, typografii, spacing, zaoblení nebo pravidla pro komponenty.
Za projektem stojí účet google-labs-code. Repozitář je veřejný, má licenci Apache-2.0 a je napsaný převážně v TypeScriptu. GitHub u projektu uvádí 6,1 tisíce hvězd, 504 forků a poslední release 0.1.0 z 21. dubna 2026.
Soubor DESIGN.md kombinuje dvě vrstvy. První je YAML front matter s machine-readable tokeny, například barvami, typografií, spacingem, rounded hodnotami a komponentovými pravidly. Druhá je běžný Markdown, který vysvětluje designové rozhodnutí lidským jazykem. Tokeny dávají agentovi přesné hodnoty, text mu říká, proč existují a kdy je použít.
Praktické použití je jednoduché: projekt může mít v repozitáři vlastní DESIGN.md a agent nebo nástroj ho použije jako zdroj pravdy pro vizuální styl. Součástí balíčku je CLI, které umí soubor validovat přes npx @google/design.md lint DESIGN.md, porovnat dvě verze přes diff nebo exportovat tokeny do Tailwind konfigurace a DTCG tokens.json. Linter kontroluje například rozbité reference tokenů, chybějící primární barvu, kontrast komponent podle WCAG AA nebo špatné pořadí sekcí.
Zajímavé je, že formát neřeší jen tokeny jako databázi hodnot. Počítá i s design rationale, tedy s vysvětlením, jak má výsledné UI působit. Agent tak může vědět nejen to, že primární barva je konkrétní hex kód, ale i že má fungovat třeba jako „deep ink“ pro nadpisy a hlavní text. To je užitečné hlavně tam, kde samotné tokeny nestačí k rozhodnutí mezi několika podobnými variantami UI.
Zdroje:
