brand-guidelines.md: Il file che ogni strumento AI deve conoscere del tuo brand

Hai pagato bene per le linee guida del brand. Sono sepolte in un PDF di 47 pagine da qualche parte in Google Drive — quello che la tua agenzia di design 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, scrive un'email di marketing con Claude o struttura un componente in v0, ricomincia da zero: "Com'era il nostro colore primario? È Inter o Plus Jakarta Sans? Usiamo angoli arrotondati o netti?"

Questo ciclo — spiegare il brand, sperare che resti, correggere quello che non va — costa ore ogni settimana. A livello di team, solo nel rielaborazione, costa migliaia al mese.

Il formato Stitch design-md di Google elimina questo ciclo. E Branding5 genera automaticamente il tuo brand-guidelines.md completo — scaricalo in un clic, mettilo nel repo, e ogni strumento AI che il tuo team usa conosce istantaneamente il tuo brand.

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

Il 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 umani possono (teoricamente) leggere, è un file .md strutturato che sia le persone che i sistemi AI possono analizzare, comprendere e usare come base.

Google ha creato il formato come parte di Stitch — la sua piattaforma di generazione UI alimentata da AI — con una premessa semplice: se dai a un'AI una descrizione ben strutturata del tuo sistema di brand, può generare UI, scrivere testi e prendere decisioni di design già in linea con il brand. Niente più ripetizioni ad ogni sessione.

Due nomi, un'idea

I file scritti in questo formato hanno due nomi:

• DESIGN.md — la forma abbreviata nelle community di sviluppatori. Si affianca a README.md e CONTRIBUTING.md alla radice 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ù di semplici 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 identici.

Cosa va dentro un brand-guidelines.md

Un file completo copre ogni livello del tuo brand, dalla strategia fino alle specifiche al pixel. Ecco com'è un brand-guidelines.md generato da Branding5 in pratica:

# Acme Analytics

## Fondamenta del brand

- **Posizionamento:** L'unica piattaforma di analytics costruita per team
  marketing non tecnici che hanno bisogno di insight enterprise senza
  curva di apprendimento.
- **Archetipo:** Il Saggio — saggio, affidabile, orientato ai dati
- **Missione:** Rendere l'alfabetizzazione ai dati accessibile a ogni marketer.
- **Valori:** Chiarezza prima della complessità. Precisione prima della velocità.
  Empowerment prima della dipendenza.

## Profili clienti ideali

### ICP 1: Growth Marketing Manager

- 28–38 anni, SaaS mid-market (50–500 dipendenti)
- Frustrato da strumenti BI complessi; ha bisogno di dashboard che può
  costruire da solo
- Pattern linguistici: "actionable insights", "self-serve", "time-to-value"
- Obiezione principale: "Questo sostituirà il nostro stack BI esistente?"

### ICP 2: VP Marketing

- 35–50 anni, riporta al CMO o CEO
- Interessato all'attribuzione cross-canale e ai report per il board
- Acquista su prova di ROI e ampiezza delle integrazioni

## Identità visiva

### Colori

| Ruolo        | Hex       | Utilizzo                                |
| ------------ | --------- | --------------------------------------- |
| Primario     | `#2563eb` | CTA, stati attivi, elementi UI chiave   |
| Secondario   | `#f8fafc` | Sfondi, card, contenitori               |
| Accento      | `#16a34a` | Stati di successo, metriche positive    |
| Neutro 900   | `#0f172a` | Testo corpo, intestazioni               |
| Neutro 400   | `#94a3b8` | Testo placeholder, stati disabilitati   |
| Errore       | `#dc2626` | Stati di errore, azioni distruttive     |
| Avvertimento | `#f59e0b` | Stati di avvertimento, alert attenzione |

### Tipografia

| Ruolo   | Famiglia          | Peso | Dimensione | Interlinea | 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        |
| Corpo   | Inter             | 400  | 16px       | 1.6        | 0        |
| Caption | Inter             | 500  | 13px       | 1.4        | 0.01em   |
| Codice  | JetBrains Mono    | 400  | 14px       | 1.5        | 0        |

## Voce & tono del brand

- **Voce:** Diretta, sicura, senza gergo. Spieghiamo, non facciamo la predica.
- **Variazioni di tono:** Più caldo nell'onboarding, più assertivo nella copy
  di vendita, preciso e neutro nella documentazione.
- **Stile delle frasi:** Frasi brevi. Voce attiva. Inizia con il beneficio.
- **Da evitare:** Costruzioni passive, "fare leva", "sinergia", frasi di riempimento,
  punti esclamativi nell'UI del prodotto.

### Esempi

- ✅ "Scopri quali campagne generano fatturato — in un clic."
- ❌ "La nostra piattaforma innovativa sfrutta tecnologie all'avanguardia per
  potenziare il tuo team marketing con soluzioni analytics best-in-class."

## Linee guida per i componenti

### Pulsanti

- Primario: pieno, `#2563eb`, testo bianco, rounded-full, altezza min 44px
- Secondario: outlined, bordo 1px `#2563eb`, sfondo trasparente
- Ghost: nessun bordo, solo testo, usato in nav e azioni terziarie
- Tutti i pulsanti: 16px padding orizzontale, font-weight 600, niente maiuscole

### Card

- Sfondo: bianco, border-radius 8px, ombra sottile
- Padding: 24px
- Intestazione: peso H3, margin-bottom 8px
- Includere sempre un CTA chiaro o azione successiva

## Da fare e da evitare

- ✅ Includere sempre un singolo CTA chiaro per sezione
- ✅ Usare dati reali in esempi e screenshot, mai "Lorem ipsum"
- ✅ Testare i rapporti di contrasto — minimo WCAG AA (4.5:1 per il testo)
- ❌ Non usare mai più di 3 colori in un singolo componente
- ❌ Non usare foto stock di persone che indicano schermi
- ❌ Evitare il centramento del testo corpo oltre 2 righe

Questa è l'anatomia. Ecco come appare un output reale — generato da Branding5 per Oscar Stories, una piattaforma di storie della buonanotte per bambini alimentata da AI con un archetipo Jester (Il Giullare).

Front matter YAML — il livello leggibile dalla macchina

---
name: 'Oscar Stories'
website: 'https://www.oscarstories.com'
archetype: 'The Jester'
positioning_statement: >
  Per i genitori che vogliono trasformare l'ora della buonanotte in
  un'avventura gioiosa, Oscar Stories usa una AI intelligente per
  creare storie personalizzate dove il tuo bambino è la star.
usp: >
  Crea istantaneamente storie uniche alimentate da AI dove il tuo
  bambino è l'eroe giocoso, rendendo la buonanotte magica, più
  facile per i genitori e ispirando ogni notte immaginazione e valori.
voice:
  tone: 'Amichevole, fantasioso e incoraggiante...'
  personality: 'Giocoso, fantasioso, premuroso, innovativo e affidabile.'
  promise: "Trasformare l'ora della buonanotte in un momento magico e di legame..."
values:
  - 'Joyful Connection'
  - 'Trustworthy Innovation'
  - 'Nurturing Education'
typography:
  primary_font: 'Nunito Sans'
  secondary_font: 'Lora'
colors:
  primary: '#5e219c' # Midnight Plum
  darker: '#332145'
---

Cosa contiene il resto del file

Sotto il front matter YAML, il file completo — oltre 14.000 parole — continua con tutto ciò di cui un'AI ha bisogno per prendere decisioni in linea con il brand:

• Narrativa del brand: dichiarazione di posizionamento, missione, visione, USP e la storia del "perché lo facciamo"
• Approfondimento sull'archetipo: i tratti chiave del Giullare, strategie fondamentali, potenziali insidie e brand di riferimento (Ben & Jerry's, M&M's, Old Spice)
• Identità visiva: sistema di colori completo con hex, CMYK, HSL e stati hover; gerarchia tipografica con pesi e regole d'uso
• Profilo cliente ideale: persona completa — "Il Genitore Moderno Consapevole" — con demografia, psicografia, pain point, obiettivi e canali preferiti
• Analisi SWOT: punti di forza, debolezze, opportunità, minacce e valutazione strategica complessiva
• Copy marketing: 8 headline scritte nella voce del Giullare, 5 CTA con tattiche di urgenza e copy completa landing page in PAS
• Strategia di contenuto: piano di contenuti Hero/Hub/Igiene con titoli, canali e obiettivi specifici
• Campagne marketing: campagne di awareness, interesse e desiderio mappate sul framework AIDA

Uno sviluppatore che non ha mai incontrato il team di Oscar Stories può mettere questo file in Cursor, chiedere una landing page e ottenere una copy che suona come il brand — giocosa, fantasiosa, mai predicatoria — con la giusta palette viola e i titoli in Nunito Sans. Nessun brief. Nessun avanti e indietro.

Ecco come appaiono le linee guida di brand leggibili dalle macchine in pratica. Non un PDF. Un singolo file che ogni strumento AI del tuo team può leggere, comprendere e usare come base.

Perché questo è importante adesso

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

1. Gli strumenti AI ora scrivono la maggior parte del codice e della copy

Cursor, GitHub Copilot, Claude, v0, Bolt, Lovable — sviluppatori e marketer stanno consegnando più velocemente che mai con l'assistenza AI. Ma questi strumenti non hanno alcuna conoscenza del tuo brand a meno che tu non gliela dica. Ad ogni sessione, ad ogni prompt, rispieghi la tua palette di colori. Non è un workflow — è una tassa sulla velocità.

Un singolo brand-guidelines.md nel tuo repo elimina questa tassa definitivamente.

2. Google sta spingendo il design-md come standard

Quando Google rilascia una specifica di formato attraverso 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. Impostare correttamente il file oggi significa che gli strumenti di domani funzioneranno senza migrazione né rielaborazione.

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

Se il tuo team genera 50 articoli 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 repo, nel contesto del prompt, nella memoria dello strumento.

PDF vs. brand-guidelines.md: confronto diretto

Il PDF non è morto per le presentazioni agli stakeholder. Ma per l'esecuzione quotidiana — dove gli strumenti AI fanno la generazione — il testo semplice vince nettamente.

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 corrisponde al tuo sistema di colori, tipografia, spaziatura e convenzioni dei componenti.

Il workflow in tre passaggi:

1. Carica o posiziona il file. Metti brand-guidelines.md nella radice del tuo progetto, o caricalo direttamente nell'interfaccia di Stitch.
2. Fai prompt naturalmente. Chiedi ciò di cui hai bisogno: "Genera una sezione di pricing con tre livelli e un piano popolare in evidenza."
3. Ottieni output in linea con il brand. Stitch applica automaticamente i tuoi colori, gerarchia tipografica, stili di pulsanti e spaziatura. Nessuna revisione design necessaria per le basi.

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

Utilizzo con Cursor, Copilot e altri strumenti di coding AI

Metti DESIGN.md (o brand-guidelines.md) nella radice del tuo repo e fai riferimento nelle tue prompt:

Cursor:

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

GitHub Copilot (modalità workspace):

#file:DESIGN.md Costruisci un componente griglia di card testimonials
usando le linee guida delle card 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 headline per la homepage che corrispondano
alla voce del brand e si rivolgano all'ICP 1 (Growth Marketing Manager).

Il vantaggio: gli sviluppatori che non hanno mai letto le linee guida del brand producono codice in linea con il brand dal primo prompt. Il vincolo è integrato nel workflow — non imposto attraverso cicli di revisione e messaggi Slack.

Oltre il visivo: perché la strategia nel file cambia tutto

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

La fondazione del brand dice all'AI perché il brand fa le scelte che fa. Quando un'AI sa che sei un archetipo Saggio che si rivolge a marketer non tecnici, non sceglie solo il colore giusto del pulsante — scrive copy che è chiara e sicura invece che guidata dall'hype.

I profili clienti ideali danno all'AI il contesto dell'audience per generare messaggi rilevanti. Un headline per un VP Marketing si legge molto diversamente da uno per un Growth Marketing Manager. Senza ICP nel file, l'AI indovina. Con loro, mira con precisione.

Le linee guida di voce e tono con esempi concreti (buoni e cattivi) sono la sezione con la leva più alta per la qualità della copy. Un esempio ben scritto di "da fare / da evitare" insegna a un'AI più di cento parole di descrizione astratta della voce.

Da fare e da evitare agiscono come vincoli rigidi. "Non usare mai più di 3 colori in un componente" e "includere sempre un CTA in ogni sezione" sono regole che l'AI può seguire letteralmente, ogni volta. Nessuna ambiguità, nessuna deriva.

Come Branding5 genera il tuo

Dopo aver completato la tua analisi del brand in Branding5, il tuo brand-guidelines.md è pronto per il download 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 confluisce 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 personalità del tuo brand — non prelevati da un template generico.
3. L'output segue la specifica design-md. Stitch e gli strumenti compatibili lo analizzano nativamente. Nessuna conversione, nessuna riformattazione.
4. È pronto per l'uso immediato. Mettilo nel tuo repo, allegalo al tuo strumento AI, o condividilo con il tuo team. Un file, ogni strumento, dal primo giorno.

I 30 minuti che spendi in Branding5 producono:

• Un PDF di strategia per i tuoi stakeholder e investitori
• Framework di messaggistica per il tuo team marketing
• Un brand-guidelines.md per ogni strumento AI che il tuo team di engineering e design userà 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 AI in cinque minuti:

1. Genera il tuo file. Esegui la tua analisi del brand in Branding5 e scarica brand-guidelines.md dalla tua dashboard.
2. Mettilo nella radice del repo. Chiamalo DESIGN.md se il tuo team preferisce la convenzione degli sviluppatori, o tieni brand-guidelines.md per chiarezza.
3. Informa il tuo team. Condividi un messaggio di una riga: "Le nostre linee guida del brand sono ora in DESIGN.md alla radice del progetto. Fai riferimento in ogni prompt AI."
4. Fai riferimento 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 committa. Git traccia il cambiamento. Ogni strumento lo raccoglie istantaneamente.

Tutto qui. Nessun deck di onboarding. Nessun collo di bottiglia nella revisione del design. Mai più "com'è il nostro colore del brand?" su Slack.

La conclusione

Gli strumenti AI scrivono il tuo codice, generano la tua copy e strutturano i tuoi componenti. L'unica domanda è se lo stanno facendo in linea con il tuo brand — o improvvisando.

Un brand-guidelines.md risponde a quella domanda una volta. Poi risponde automaticamente, ad ogni generazione, su ogni strumento, per ogni persona del tuo team.

Il formato Stitch di Google sta rendendo le linee guida di brand leggibili dalle macchine uno standard. DESIGN.md sta diventando il file che gli sviluppatori si aspettano di trovare alla radice del progetto. I brand che lo adottano ora consegneranno più velocemente, resteranno più coerenti e perderanno meno tempo a correggere output AI che hanno mancato il segno.

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?

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

Devo conoscere Markdown per creare o modificare il file?

No. Branding5 genera il file automaticamente dalla tua analisi del brand. Se vuoi fare modifiche manuali in seguito, Markdown è solo 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 fai riferimento o alleghi il file. Poiché è Markdown semplice, qualsiasi strumento alimentato da LLM può analizzarlo e seguirlo — nessun plugin o integrazione richiesti.

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

Abbastanza dettagliato da rimuovere l'ambiguità. Come minimo, includi la tua palette di colori con regole d'uso, specifiche tipografiche, convenzioni per pulsanti/card/form e linee guida della voce con esempi. Più specifici sono i tuoi da fare e da evitare, più coerente sarà l'output AI. Branding5 genera di default un file completo — puoi sempre rimuovere le sezioni di cui non hai bisogno.

Come mantengo il file sincronizzato quando il mio brand si evolve?

Trattalo come qualsiasi altro file sorgente: modifica, committa, pusha. Poiché vive in Git, il tuo team vede esattamente cosa è cambiato e quando. Se riesegui la tua analisi del brand in Branding5, puoi scaricare una versione aggiornata e sostituire il vecchio file. Nessun retainer agenzia, nessun ciclo di revisione di un mese.

Ottieni il tuo brand-guidelines.md

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

Genera il tuo brand-guidelines.md →