brand-guidelines.md: Jedyny plik, którego każde narzędzie AI potrzebuje, aby poznać Twoją markę

Zapłaciłeś niemało za wytyczne dotyczące marki. Leżą one w 47-stronicowym pliku PDF gdzieś na Google Drive — tym, który Twoja agencja projektowa dostarczyła 18 miesięcy temu. Twoi deweloperzy nigdy go nie otworzyli. Twoje narzędzia AI nie mogą go otworzyć. I za każdym razem, gdy ktoś tworzy stronę docelową w Cursorze, redaguje e-mail marketingowy z Claudem, lub szkicuje komponent w v0, zaczyna od zera: "Jaki jest znowu nasz podstawowy kolor? Czy to Inter czy Plus Jakarta Sans? Czy używamy zaokrąglonych czy ostrych rogów?"

Ta pętla — wyjaśnianie marki, nadzieja, że się przyjmie, naprawianie tego, co się nie przyjmie — kosztuje godziny każdego tygodnia. W skali zespołu, kosztuje tysiące miesięcznie tylko na poprawki.

Format Stitch design-md firmy Google eliminuje tę pętlę. A Branding5 generuje Twój kompletny plik brand-guidelines.md automatycznie — pobierz go jednym kliknięciem, wrzuć do swojego repozytorium, a każde narzędzie AI, z którym pracuje Twój zespół, natychmiast pozna Twoją markę.

Czym jest design-md? (I dlaczego ludzie nazywają go DESIGN.md?)

Design-md to specyfikacja wytycznych dotyczących marki i designu, oparta na zwykłym tekście i Markdownie. Zamiast pliku PDF, który tylko ludzie mogą (teoretycznie) czytać, jest to ustrukturyzowany plik .md, który zarówno ludzie, jak i systemy AI mogą parsować, rozumieć i na jego podstawie tworzyć.

Google stworzyło ten format jako część Stich — swojej platformy do generowania interfejsów użytkownika wspomaganej przez AI — z prostym założeniem: jeśli dasz sztucznej inteligencji dobrze ustrukturyzowany opis swojego systemu marki, może ona generować interfejsy użytkownika, pisać teksty i podejmować decyzje projektowe, które są już zgodne z marką. Koniec z powtarzaniem się na każdej sesji.

Dwie nazwy, jedna idea

Pliki napisane w tym formacie występują pod dwiema nazwami:

• DESIGN.md — skrót w społecznościach deweloperskich. Leży obok README.md i CONTRIBUTING.md w katalogu głównym projektu, a Cursor, Windsurf i inne narzędzia do kodowania AI automatycznie go szukają.
• brand-guidelines.md — nazwa używana przez Branding5, ponieważ plik zawiera znacznie więcej niż tylko specyfikacje wizualne. Zawiera pozycjonowanie, archetypy, ICP, głos i strategię — cały system marki, a nie tylko kolory i czcionki.

Obie nazwy działają. Format i moc są takie same.

Co zawiera brand-guidelines.md

Kompletny plik obejmuje każdą warstwę Twojej marki, od strategii po specyfikacje na poziomie pikseli. Oto, jak wygląda plik brand-guidelines.md wygenerowany przez Branding5 w praktyce:

# Acme Analytics

## Brand Foundation

- **Positioning:** The only analytics platform built for non-technical marketing teams
  who need enterprise-grade insights without the learning curve.
- **Archetype:** The Sage — wise, trustworthy, data-driven
- **Mission:** Make data literacy accessible to every marketer.
- **Values:** Clarity over complexity. Accuracy over speed. Empowerment over dependency.

## Ideal Customer Profiles

### ICP 1: Growth Marketing Manager

- 28–38, mid-market SaaS (50–500 employees)
- Frustrated by complex BI tools; needs dashboards they can build alone
- Language patterns: "actionable insights", "self-serve", "time-to-value"
- Key objection: "Will this replace our existing BI stack?"

### ICP 2: VP of Marketing

- 35–50, reports to CMO or CEO
- Cares about cross-channel attribution and board-ready reporting
- Buys on ROI proof and integration breadth

## Visual Identity

### Colors

| Role        | Hex       | Usage                                |
| ----------- | --------- | ------------------------------------ |
| Primary     | `#2563eb` | CTAs, active states, key UI elements |
| Secondary   | `#f8fafc` | Backgrounds, cards, containers       |
| Accent      | `#16a34a` | Success states, positive metrics     |
| Neutral 900 | `#0f172a` | Body text, headings                  |
| Neutral 400 | `#94a3b8` | Placeholder text, disabled states    |
| Error       | `#dc2626` | Error states, destructive actions    |
| Warning     | `#f59e0b` | Warning states, attention alerts     |

### Typography

| Role    | Family            | Weight | Size | Line Height | Tracking |
| ------- | ----------------- | ------ | ---- | ----------- | -------- |
| H1      | Plus Jakarta Sans | 800    | 48px | 1.1         | -0.02em  |
| H2      | Plus Jakarta Sans | 700    | 36px | 1.2         | -0.01em  |
| H3      | Plus Jakarta Sans | 700    | 24px | 1.3         | 0        |
| Body    | Inter             | 400    | 16px | 1.6         | 0        |
| Caption | Inter             | 500    | 13px | 1.4         | 0.01em   |
| Code    | JetBrains Mono    | 400    | 14px | 1.5         | 0        |

### Spacing & Layout

- Base unit: 8px
- Component padding: 16px (compact), 24px (default), 32px (spacious)
- Section spacing: 64px (desktop), 48px (mobile)
- Max content width: 1200px
- Border radius: 8px (cards), 12px (modals), 9999px (pills/buttons)

### Shadows & Elevation

- Card: `0 1px 3px rgba(0,0,0,0.08)`
- Dropdown: `0 4px 12px rgba(0,0,0,0.12)`
- Modal: `0 8px 32px rgba(0,0,0,0.16)`

## Brand Voice & Tone

- **Voice:** Direct, confident, jargon-free. We explain, we don't lecture.
- **Tone shifts:** Warmer in onboarding, more assertive in sales copy,
  precise and neutral in documentation.
- **Sentence style:** Short sentences. Active voice. Lead with the benefit.
- **Avoid:** Passive constructions, "leverage", "synergy", filler phrases,
  exclamation marks in product UI.

### Examples

- ✅ "See which campaigns drive revenue — in one click."
- ❌ "Our innovative platform leverages cutting-edge technology to empower
  your marketing team with best-in-class analytics solutions."

## Component Guidelines

### Buttons

- Primary: filled, `#2563eb`, white text, rounded-full, min-height 44px
- Secondary: outlined, 1px border `#2563eb`, transparent background
- Ghost: no border, text-only, used in nav and tertiary actions
- All buttons: 16px horizontal padding, font-weight 600, no uppercase

### Cards

- Background: white, border-radius 8px, subtle shadow
- Padding: 24px
- Header: H3 weight, 8px margin-bottom
- Always include a clear CTA or next action

### Forms

- Label above input, font-weight 500
- Input height: 44px, border-radius 8px, 1px border neutral-300
- Error message below input in red, 13px
- Required fields marked with \* (not colour alone)

## Do's and Don'ts

- ✅ Always include a single, clear CTA per section
- ✅ Use real data in examples and screenshots, never "Lorem ipsum"
- ✅ Test contrast ratios — minimum WCAG AA (4.5:1 for text)
- ❌ Never use more than 3 colours in a single component
- ❌ Don't use stock photos of people pointing at screens
- ❌ Avoid centre-aligning body text longer than 2 lines

To zwykły tekst. Bez własnościowego formatu. Bez specjalnych narzędzi. Podaj go jakiemukolwiek narzędziu AI — Cursor, Claude, Stitch, v0, Bolt, Copilot — a Twoja marka stanie się warstwą ograniczeń, która automatycznie kształtuje każdy wynik.

Dlaczego to ma znaczenie właśnie teraz

Trzy siły zbiegły się, aby uczynić wytyczne dotyczące marki czytelne dla maszyn pilnymi, a nie opcjonalnymi:

1. Narzędzia AI piszą teraz większość kodu i tekstów

Cursor, GitHub Copilot, Claude, v0, Bolt, Lovable — deweloperzy i marketerzy działają szybciej niż kiedykolwiek z pomocą AI. Ale te narzędzia nie mają żadnej wiedzy o Twojej marce, chyba że im powiesz. Na każdej sesji, przy każdym zapytaniu, ponownie wyjaśniasz swoją paletę kolorów. To nie jest przepływ pracy — to podatek od szybkości.

Pojedynczy plik brand-guidelines.md w Twoim repozytorium eliminuje ten podatek na stałe.

2. Google promuje design-md jako standard

Gdy Google wprowadza specyfikację formatu poprzez produkt taki jak Stitch, ekosystem zwraca na to uwagę. Wtyczki Figmy, rozszerzenia VS Code i generatory komponentów AI już zaczynają szukać pliku DESIGN.md w katalogu głównym projektu. Przygotowanie Twojego pliku dzisiaj oznacza, że narzędzia jutra będą po prostu działać — bez migracji, bez poprawek.

3. Spójność marki w tempie AI wymaga reguł czytelnych dla maszyn

Jeśli Twój zespół generuje 50 postów na blogu miesięcznie, 20 wariantów reklam tygodniowo i nową stronę docelową co sprint, plik PDF na Google Drive jest bezużyteczny. Zasady marki muszą żyć tam, gdzie odbywa się generowanie — w repozytorium, w kontekście zapytania, w pamięci narzędzia.

PDF kontra brand-guidelines.md: porównanie

PDF nie umarł dla prezentacji dla interesariuszy. Ale do codziennego wykonania — tam, gdzie narzędzia AI generują — zwykły tekst zwycięża zdecydowanie.

Jak używać brand-guidelines.md z Google Stitch

Google Stitch czyta Twój plik brand-guidelines.md i używa go do ograniczenia generowania interfejsu użytkownika. Zamiast tworzyć ogólne komponenty Material Design, generuje interfejs użytkownika, który odpowiada Twojemu systemowi kolorów, typografii, odstępom i konwencjom komponentów.

Przepływ pracy składa się z trzech kroków:

1. Prześlij lub umieść plik. Wrzuć brand-guidelines.md do katalogu głównego projektu lub prześlij go bezpośrednio w interfejsie Stitch.
2. Naturalnie formułuj zapytania. Zapytaj o to, czego potrzebujesz: "Wygeneruj sekcję z cennikiem z trzema poziomami i wyróżnionym popularnym planem."
3. Uzyskaj wynik zgodny z marką. Stitch automatycznie stosuje Twoje kolory, hierarchię typografii, style przycisków i odstępy. Nie potrzeba recenzji projektu dla podstaw.

Wynik jest nie tylko bliższy Twojej marce — jest szybszy w wdrożeniu, ponieważ pomijasz etap korekty, który normalnie zajmuje całe popołudnie.

Używanie go z Cursor, Copilot i narzędziami do kodowania AI

Wrzuć DESIGN.md (lub brand-guidelines.md) do katalogu głównego swojego repozytorium i odwołaj się do niego w swoich zapytaniach:

Cursor:

@DESIGN.md Generate a hero section for the homepage.
Use the primary CTA style, heading typography, and colour system from the file.

GitHub Copilot (tryb workspace):

#file:DESIGN.md Build a testimonial card grid component
using the card guidelines and spacing system defined here.

Claude / ChatGPT (wklej lub załącz plik):

Here are my brand guidelines [attached: brand-guidelines.md].
Write three homepage headline options that match the brand voice
and speak to ICP 1 (Growth Marketing Manager).

v0 / Bolt / Lovable: Prześlij brand-guidelines.md jako plik projektu lub wklej odpowiednie sekcje do swojego zapytania. Te narzędzia zastosują Twoje kolory, typografię i specyfikacje komponentów do każdego generowania.

Korzyści: deweloperzy, którzy nigdy nie czytali wytycznych marki, tworzą kod zgodny z marką od pierwszego zapytania. Ograniczenie jest osadzone w przepływie pracy — nie jest egzekwowane poprzez cykle przeglądów i wiadomości na Slacku.

Poza wizualiami: dlaczego strategia w pliku zmienia wszystko

Większość plików systemów projektowych kończy się na kolorach i czcionkach. Plik brand-guidelines.md z Branding5 idzie głębiej — a ta głębia zmienia wynik AI z „wygląda dobrze” na „czuje się dobrze”.

Podstawy marki mówią AI, dlaczego marka podejmuje takie, a nie inne decyzje. Kiedy AI wie, że jesteś archetypem Mędrca (Sage) celującym w niestandardowych marketerów, nie tylko wybiera odpowiedni kolor przycisku — pisze tekst, który jest jasny i pewny siebie, zamiast napędzanego szumem i bezsensownego.

Idealne Profile Klienta (ICP) dają AI kontekst odbiorców, aby generować odpowiednie komunikaty. Nagłówek dla wiceprezesa ds. marketingu czyta się zupełnie inaczej niż ten skierowany do menedżera ds. marketingu wzrostu. Bez ICP w pliku, AI zgaduje. Z nimi, celuje.

Wytyczne dotyczące głosu i tonu marki z konkretnymi przykładami (dobrymi i złymi) są najważniejszą sekcją podnoszącą jakość tekstu. Jeden dobrze napisany przykład „co robić / czego nie robić” uczy AI więcej niż sto słów abstrakcyjnego opisu głosu.

Zasady „co robić” i „czego nie robić” działają jako twarde ograniczenia. „Nigdy nie używaj więcej niż 3 kolorów w komponencie” i „zawsze dołączaj CTA w każdej sekcji” to zasady, których AI może dosłownie przestrzegać za każdym razem. Bez dwuznaczności, bez odchyleń.

Jak Branding5 generuje Twoje wytyczne

Po zakończeniu analizy marki w Branding5, Twój plik brand-guidelines.md jest gotowy do pobrania z pulpitu nawigacyjnego. Oto, co dzieje się za kulisami:

1. Twoja strategia marki zasila plik. Pozycjonowanie, archetyp, ICP, analiza konkurencji, ton głosu — wszystko, co zbudowałeś w Branding5, trafia bezpośrednio do ustrukturyzowanego wyniku Markdown.
2. Specyfikacje wizualne są wyprowadzane z Twojego pozycjonowania. Kolory, typografia i konwencje komponentów są generowane tak, aby pasowały do osobowości Twojej marki — nie są pobierane z ogólnego szablonu.
3. Wynik jest zgodny ze specyfikacją design-md. Stitch i kompatybilne narzędzia parsją go natywnie. Bez konwersji, bez przeformatowania.
4. Jest gotowy do natychmiastowego użycia. Wrzuć go do repozytorium, dołącz do narzędzia AI lub udostępnij swojemu zespołowi. Jeden plik, każde narzędzie, od pierwszego dnia.

30 minut spędzonych w Branding5 generuje:

• Strategiczny plik PDF dla Twoich interesariuszy i inwestorów
• Frameworki komunikacji dla Twojego zespołu marketingowego
• brand-guidelines.md dla każdego narzędzia AI, którego kiedykolwiek użyje Twój zespół inżynierów i projektantów

Bez pisania tekstów. Bez ręcznego formatowania. Bez specjalistycznej wiedzy o Markdownie.

Rozpoczęcie: pięciominutowa lista kontrolna

Masz już strategię marki? Oto jak przejść od zera do systemu marki gotowego na AI w pięć minut:

1. Wygeneruj swój plik. Przeprowadź analizę swojej marki w Branding5 i pobierz brand-guidelines.md z pulpitu nawigacyjnego.
2. Wrzuć go do katalogu głównego swojego repozytorium. Nazwij go DESIGN.md, jeśli Twój zespół preferuje konwencję deweloperską, lub zachowaj brand-guidelines.md dla jasności.
3. Poinformuj swój zespół. Udostępnij jedną linijkę wiadomości: "Nasze wytyczne dotyczące marki są teraz w DESIGN.md w katalogu głównym projektu. Odwołujcie się do nich w każdym zapytaniu do AI."
4. Odwołuj się do niego w każdej sesji AI. Użyj @DESIGN.md w Cursor, dołącz go w Claude lub ChatGPT, prześlij go w v0 lub Bolt.
5. Utrzymuj go w aktualności. Kiedy Twoja marka ewoluuje, zaktualizuj plik i zatwierdź zmiany (commit). Git śledzi zmiany. Każde narzędzie natychmiast to wychwytuje.

To wszystko. Bez prezentacji wdrożeniowej. Bez wąskich gardeł w przeglądach projektowych. Nigdy więcej pytania „jaki jest nasz kolor marki?” na Slacku.

Podsumowanie

Narzędzia AI piszą Twój kod, generują Twoje teksty i tworzą szkielety komponentów. Jedyne pytanie to, czy robią to zgodnie z marką — czy też improwizują.

Plik brand-guidelines.md odpowiada na to pytanie raz. Następnie odpowiada na nie ponownie, automatycznie, przy każdym generowaniu, w każdym narzędziu, dla każdej osoby w Twoim zespole.

Format Stitch firmy Google sprawia, że wytyczne marki czytelne dla maszyn stają się standardem. DESIGN.md staje się plikiem, którego deweloperzy spodziewają się znaleźć w katalogu głównym projektu. Marki, które przyjmą go teraz, będą działać szybciej, zachowają większą spójność i zmarnują mniej czasu na poprawianie wyników AI, które odbiegły od normy.

Twoja strategia marki jest już w Branding5. Twój brand-guidelines.md jest o jedno kliknięcie stąd.

Często zadawane pytania

Jaka jest różnica między DESIGN.md a brand-guidelines.md?

To ten sam format. DESIGN.md to skrót popularny w społecznościach deweloperskich — odzwierciedla konwencje nazewnictwa README.md. brand-guidelines.md jest bardziej opisowy, sygnalizując, że plik zawiera strategię marki (pozycjonowanie, głos, ICP), a nie tylko specyfikacje wizualne. Użyj nazwy, którą preferuje Twój zespół; narzędzia AI parsją obie identycznie.

Czy muszę znać Markdown, aby stworzyć lub edytować plik?

Nie. Branding5 generuje plik automatycznie na podstawie analizy Twojej marki. Jeśli chcesz później wprowadzić ręczne edycje, Markdown to zwykły tekst z prostym formatowaniem (# dla nagłówków, - dla list, ** dla pogrubienia). Każdy może nauczyć się podstaw w dwie minuty.

Które narzędzia AI obsługują design-md / DESIGN.md?

Google Stitch czyta go natywnie. Cursor, GitHub Copilot, Windsurf, Claude, ChatGPT, v0, Bolt i Lovable wszystkie z nim współpracują, gdy odwołasz się do pliku lub go załączysz. Ponieważ jest to zwykły Markdown, każde narzędzie oparte na LLM może go parsować i podążać za nim — nie potrzeba żadnej wtyczki ani integracji.

Jak szczegółowy powinien być mój plik brand-guidelines.md?

Wystarczająco szczegółowy, aby usunąć dwuznaczności. Minimum to paleta kolorów z zasadami użycia, specyfikacje typografii, konwencje przycisków/kart/formularzy oraz wytyczne dotyczące głosu z przykładami. Im bardziej szczegółowe są Twoje zasady „co robić” i „czego nie robić”, tym bardziej spójny będzie wynik AI. Branding5 domyślnie generuje kompleksowy plik — zawsze możesz usunąć sekcje, których nie potrzebujesz.

Jak utrzymać plik w synchronizacji, gdy moja marka ewoluuje?

Traktuj go jak każdy inny plik źródłowy: edytuj, zatwierdź zmiany (commit), wypchnij (push). Ponieważ znajduje się w Git, Twój zespół widzi dokładnie, co i kiedy się zmieniło. Jeśli ponownie przeprowadzisz analizę marki w Branding5, możesz pobrać zaktualizowaną wersję i zastąpić stary plik. Bez opłat agencyjnych, bez miesięcznego cyklu rewizji.

Czy mogę używać brand-guidelines.md do zadań innych niż kodowanie, takich jak pisanie postów na blogu lub tekstów reklamowych?

Absolutnie. Załącz plik (lub wklej sekcje dotyczące głosu marki i ICP) podczas wysyłania zapytań do Claude'a, ChatGPT lub dowolnego asystenta pisania. Wytyczne dotyczące głosu, przykłady tonu i szczegóły dotyczące odbiorców są specjalnie zaprojektowane, aby poprawić jakość tekstów generowanych przez AI — nie tylko kodu.

Pobierz swój brand-guidelines.md

Przeprowadź analizę swojej marki w Branding5 i pobierz zgodny z design-md plik brand-guidelines.md (DESIGN.md) — gotowy dla Google Stitch, Cursor, Copilot i całego Twojego stosu narzędzi AI.

Wygeneruj swój brand-guidelines.md →