brand-guidelines.md: Il File Essenziale Che Ogni Strumento AI Deve Conoscere per Capire il Tuo Brand

Hai speso un bel po' di soldi per le linee guida del tuo brand. Sono lì, in un PDF di 47 pagine da qualche parte su Google Drive, quello che la tua agenzia di design ti ha consegnato 18 mesi fa. I tuoi sviluppatori non l'hanno mai aperto. I tuoi strumenti AI non possono aprirlo. E ogni volta che qualcuno crea una landing page in Cursor, redige un'email di marketing con Claude o costruisce un componente in v0, riparte da zero: "Qual è di nuovo il nostro colore primario? È Inter o Plus Jakarta Sans? Usiamo angoli arrotondati o spigolosi?"

Quel ciclo – spiegare il brand, sperare che rimanga impresso, correggere ciò che non va – costa ore ogni settimana. In un team, costa migliaia al mese solo in rilavorazioni.

Il formato design-md Stitch di Google elimina quel ciclo. E Branding5 genera automaticamente il tuo brand-guidelines.md completo: scaricalo con un clic, inseriscilo nel tuo repository e ogni strumento AI utilizzato dal tuo team conoscerà istantaneamente il tuo brand.

Cos'è design-md? (E perché lo chiamano DESIGN.md?)

Design-md è una specifica in testo semplice, basata su Markdown, per le linee guida di brand e design. Invece di un PDF che solo gli esseri umani possono (teoricamente) leggere, è un file .md strutturato che sia le persone che i sistemi AI possono analizzare, comprendere e utilizzare per costruire.

Google ha creato il formato come parte di Stich – la loro piattaforma di generazione UI basata su AI – con una premessa semplice: se si fornisce a un'AI una descrizione ben strutturata del proprio sistema di brand, questa può generare UI, scrivere testi e prendere decisioni di design che sono già in linea con il brand. Basta ripetersi ogni sessione.

Due nomi, un'unica idea

I file scritti in questo formato sono conosciuti con due nomi:

• DESIGN.md — la forma abbreviata nelle comunità di sviluppatori. Si trova accanto a README.md e CONTRIBUTING.md nella directory principale del progetto, e Cursor, Windsurf e altri strumenti di coding AI lo cercano automaticamente.
• brand-guidelines.md — il nome usato da Branding5, perché il file contiene molto più delle specifiche visive. Cattura il tuo posizionamento, gli archetipi, gli ICP, la voce e la strategia — l'intero sistema di brand, non solo colori e font.

Entrambi i nomi funzionano. Il formato e la potenza sono gli stessi.

Cosa c'è dentro un brand-guidelines.md

Un file completo copre ogni livello del tuo brand, dalla strategia alle specifiche a livello di pixel. Ecco come appare in pratica un brand-guidelines.md generato da Branding5:

# 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

Questo è testo semplice. Nessun formato proprietario. Nessuno strumento speciale. Dallo a qualsiasi strumento AI — Cursor, Claude, Stitch, v0, Bolt, Copilot — e il tuo brand diventerà uno strato di vincolo che modella automaticamente ogni output.

Perché questo è importante ora

Tre forze sono confluite per rendere le linee guida del brand leggibili dalle macchine urgenti, non opzionali:

1. Gli strumenti AI scrivono ora la maggior parte del codice e dei testi

Cursor, GitHub Copilot, Claude, v0, Bolt, Lovable — sviluppatori e marketer stanno rilasciando prodotti più velocemente che mai con l'aiuto dell'AI. Ma questi strumenti non hanno alcuna conoscenza del tuo brand a meno che tu non glielo dica. Ogni sessione, ogni prompt, stai rispiegando la tua palette di colori. Non è un flusso di lavoro, è una tassa sulla velocità.

Un singolo brand-guidelines.md nel tuo repository elimina quella tassa in modo permanente.

2. Google sta promuovendo design-md come standard

Quando Google rilascia una specifica di formato tramite un prodotto come Stitch, l'ecosistema presta attenzione. Plugin Figma, estensioni VS Code e generatori di componenti AI stanno già iniziando a cercare un DESIGN.md alla radice del progetto. Avere il tuo file corretto oggi significa che gli strumenti di domani funzioneranno semplicemente – senza migrazioni, senza rilavorazioni.

3. La coerenza del brand alla velocità dell'AI richiede regole leggibili dalle macchine

Se il tuo team genera 50 post di blog al mese, 20 variazioni di annunci a settimana e una nuova landing page ogni sprint, un PDF in Google Drive è inutile. Le regole del brand devono vivere dove avviene la generazione – nel repository, nel contesto del prompt, nella memoria dello strumento.

PDF vs. brand-guidelines.md: un confronto fianco a fianco

Il PDF non è morto per le presentazioni agli stakeholder. Ma per l'esecuzione quotidiana – dove gli strumenti AI stanno generando – il testo semplice vince in modo decisivo.

Come usare brand-guidelines.md con Google Stitch

Google Stitch legge il tuo brand-guidelines.md e lo usa per vincolare la sua generazione di UI. Invece di produrre componenti Material generici, genera UI che corrispondono al tuo sistema di colori, tipografia, spaziatura e convenzioni dei componenti.

Il flusso di lavoro prevede tre passaggi:

1. Carica o posiziona il file. Inserisci brand-guidelines.md nella directory principale del tuo progetto, oppure caricalo direttamente nell'interfaccia di Stitch.
2. Esegui il prompt in modo naturale. Chiedi ciò di cui hai bisogno: "Genera una sezione prezzi con tre livelli e un piano popolare evidenziato."
3. Ottieni un output in linea con il brand. Stitch applica automaticamente i tuoi colori, la gerarchia dei tipi, gli stili dei pulsanti e la spaziatura. Nessuna revisione di design necessaria per le basi.

Il risultato non è solo più vicino al tuo brand – è più veloce da rilasciare perché salti il passaggio di correzione che normalmente impiegherebbe un intero pomeriggio.

Usarlo con Cursor, Copilot e strumenti di coding AI

Inserisci DESIGN.md (o brand-guidelines.md) nella directory principale del tuo repository e richiamalo nei tuoi prompt:

Cursor:

@DESIGN.md Genera una sezione hero per la homepage.
Utilizza lo stile CTA primario, la tipografia dei titoli e il sistema di colori dal file.

GitHub Copilot (modalità workspace):

#file:DESIGN.md Costruisci un componente a griglia di schede per testimonianze
usando le linee guida delle schede e il sistema di spaziatura definiti qui.

Claude / ChatGPT (incolla o allega il file):

Ecco le mie linee guida del brand [allegato: brand-guidelines.md].
Scrivi tre opzioni di titolo per la homepage che corrispondano alla brand voice
e si rivolgano all'ICP 1 (Growth Marketing Manager).

v0 / Bolt / Lovable: Carica brand-guidelines.md come file di progetto, oppure incolla le sezioni pertinenti nel tuo prompt. Questi strumenti applicheranno i tuoi colori, il tipo e le specifiche dei componenti a ogni generazione.

Il risultato: gli sviluppatori che non hanno mai letto le linee guida del brand producono codice in linea con il brand dal loro primo prompt. Il vincolo è incorporato nel flusso di lavoro — non imposto tramite cicli di revisione e messaggi Slack.

Oltre l'aspetto visivo: perché la strategia nel file cambia tutto

La maggior parte dei file di sistema di design si ferma a colori e font. Un brand-guidelines.md di Branding5 va più a fondo — e quella profondità è ciò che trasforma l'output AI da "sembra giusto" a "si sente giusto".

La Brand foundation dice all'AI perché il brand fa le scelte che fa. Quando un'AI sa che sei un archetipo del Saggio che si rivolge a marketer non tecnici, non si limita a scegliere il colore giusto per i pulsanti – scrive testi chiari e sicuri invece che enfatici e affannosi.

Gli Ideal Customer Profiles forniscono all'AI il contesto del pubblico per generare messaggi pertinenti. Un titolo per un VP del Marketing si legge in modo molto diverso da uno rivolto a un Growth Marketing Manager. Senza gli ICP nel file, l'AI indovina. Con essi, colpisce il bersaglio.

Le linee guida sulla voce e il tono con esempi concreti (buoni e cattivi) sono la sezione di maggiore impatto per la qualità dei testi. Un esempio ben scritto di "fare / non fare" insegna a un'AI più di cento parole di descrizione astratta della voce.

I Do's and don'ts (Cosa fare e cosa non fare) agiscono come vincoli rigidi. "Non usare mai più di 3 colori in un componente" e "includere sempre una CTA in ogni sezione" sono regole che l'AI può seguire letteralmente, ogni volta. Nessuna ambiguità, nessuna deviazione.

Come Branding5 genera il tuo

Dopo aver completato la tua analisi del brand in Branding5, il tuo brand-guidelines.md è pronto per essere scaricato dalla dashboard. Ecco cosa succede dietro le quinte:

1. La tua strategia di brand alimenta il file. Posizionamento, archetipo, ICP, analisi della concorrenza, tono di voce — tutto ciò che hai costruito in Branding5 fluisce direttamente nell'output Markdown strutturato.
2. Le specifiche visive sono derivate dal tuo posizionamento. Colori, tipografia e convenzioni dei componenti sono generati per corrispondere alla tua personalità del brand — non prelevati da un modello generico.
3. L'output segue la specifica design-md. Stitch e gli strumenti compatibili lo analizzano nativamente. Nessuna conversione, nessuna riformattazione.
4. È pronto all'uso immediatamente. Inseriscilo nel tuo repository, allegalo al tuo strumento AI o condividilo con il tuo team. Un file, ogni strumento, dal primo giorno.

I 30 minuti che dedichi a Branding5 producono:

• Un PDF di strategia per i tuoi stakeholder e investitori
• Framework di messaggistica per il tuo team di marketing
• Un brand-guidelines.md per ogni strumento AI che il tuo team di ingegneri e designer utilizzerà mai

Nessun copywriting. Nessuna formattazione manuale. Nessuna competenza Markdown necessaria.

Per iniziare: una checklist di cinque minuti

Hai già una strategia di brand? Ecco come passare da zero a un sistema di brand pronto per l'AI in cinque minuti:

1. Genera il tuo file. Esegui la tua analisi di brand in Branding5 e scarica brand-guidelines.md dalla tua dashboard.
2. Inseriscilo nella directory principale del tuo repository. Chiamalo DESIGN.md se il tuo team preferisce la convenzione degli sviluppatori, oppure mantieni brand-guidelines.md per chiarezza.
3. Informa il tuo team. Condividi un messaggio di una riga: "Le nostre linee guida del brand si trovano ora in DESIGN.md nella directory principale del progetto. Fai riferimento ad esso in ogni prompt AI."
4. Richiamalo in ogni sessione AI. Usa @DESIGN.md in Cursor, allegalo in Claude o ChatGPT, caricalo in v0 o Bolt.
5. Mantienilo aggiornato. Quando il tuo brand si evolve, aggiorna il file e fai il commit. Git traccia la modifica. Ogni strumento lo rileva istantaneamente.

Questo è tutto. Nessun documento di onboarding. Nessun collo di bottiglia nella revisione del design. Basta con "qual è il nostro colore del brand?" in Slack.

In conclusione

Gli strumenti AI stanno scrivendo il tuo codice, generando i tuoi testi e creando l'ossatura dei tuoi componenti. L'unica domanda è se lo stanno facendo in linea con il brand — o se stanno improvvisando.

Un brand-guidelines.md risponde a questa domanda una volta per tutte. Poi risponde di nuovo, automaticamente, ad ogni generazione, attraverso ogni strumento, per ogni persona del tuo team.

Il formato Stitch di Google sta rendendo le linee guida del brand leggibili dalle macchine uno standard. DESIGN.md sta diventando il file che gli sviluppatori si aspettano di trovare nella directory principale del progetto. I brand che lo adottano ora rilasceranno più velocemente, manterranno maggiore coerenza e sprecheranno meno tempo a correggere output AI che non hanno centrato l'obiettivo.

La tua strategia di brand è già in Branding5. Il tuo brand-guidelines.md è a un clic di distanza.

Domande frequenti

Qual è la differenza tra DESIGN.md e brand-guidelines.md?

Sono lo stesso formato. DESIGN.md è la forma abbreviata popolare nelle comunità di sviluppatori — rispecchia le convenzioni di denominazione di README.md. brand-guidelines.md è più descrittivo, segnalando che il file contiene la strategia del brand (posizionamento, voce, ICP), non solo specifiche visive. Usa il nome che il tuo team preferisce; gli strumenti AI li analizzano entrambi in modo identico.

Devo conoscere Markdown per creare o modificare il file?

No. Branding5 genera il file automaticamente dalla tua analisi di brand. Se vuoi apportare modifiche manuali in seguito, Markdown è semplicemente testo semplice con formattazione semplice (# per i titoli, - per gli elenchi, ** per il grassetto). Chiunque può imparare le basi in due minuti.

Quali strumenti AI supportano design-md / DESIGN.md?

Google Stitch lo legge nativamente. Cursor, GitHub Copilot, Windsurf, Claude, ChatGPT, v0, Bolt e Lovable funzionano tutti con esso quando si fa riferimento o si allega il file. Poiché è Markdown semplice, qualsiasi strumento basato su LLM può analizzarlo e seguirlo — nessun plugin o integrazione richiesta.

Quanto dettagliato dovrebbe essere il mio brand-guidelines.md?

Abbastanza dettagliato da rimuovere l'ambiguità. Come minimo, includi la tua palette di colori con le regole di utilizzo, le specifiche tipografiche, le convenzioni per pulsanti/schede/moduli e le linee guida per la voce con esempi. Più specifici sono i tuoi do's and don'ts, più coerente sarà l'output dell'AI. Branding5 genera un file completo per impostazione predefinita — puoi sempre tagliare le sezioni che non ti servono.

Come mantengo il file sincronizzato man mano che il mio brand si evolve?

Trattalo come qualsiasi altro file sorgente: modifica, commit, push. Poiché risiede in Git, il tuo team vede esattamente cosa è cambiato e quando. Se riesegui la tua analisi di brand in Branding5, puoi scaricare una versione aggiornata e sostituire il vecchio file. Nessun costo fisso per l'agenzia, nessun ciclo di revisione di un mese.

Posso usare brand-guidelines.md per attività non legate al codice, come la scrittura di post di blog o testi pubblicitari?

Assolutamente. Allega il file (o incolla le sezioni Brand Voice e ICP) quando fai il prompt a Claude, ChatGPT o qualsiasi assistente di scrittura. Le linee guida sulla voce, gli esempi di tono e i dettagli del pubblico sono specificamente progettati per migliorare i testi generati dall'AI — non solo il codice.

Ottieni il tuo brand-guidelines.md

Esegui la tua analisi di brand in Branding5 e scarica un brand-guidelines.md (DESIGN.md) conforme a design-md — pronto per Google Stitch, Cursor, Copilot e l'intera suite di strumenti AI.

Genera il tuo brand-guidelines.md →