# email-design.md: en varumärkesbrief till mejlagenten

Kanonisk URL: https://brew.new/sv/blog/email-design-md
Författare: Thomas Park
Publicerad: 2026-06-15
Uppdaterad: 2026-09-28

En hexkod talar om för en mejlagent vilken blå nyans den ska använda. Den säger inte varför ett varumärke sätter en liten etikett i monospace ovanför varje rubrik, eller varför sektionerna skiljs åt med tunna linjer i stället för rutor.

Det var problemet med vår första varumärkesmodell på Brew. Vi fångade en mängd värden men tappade ändå detaljerna som gjorde ett varumärke igenkännbart.

## Objektet hade ett fält för nästan allt

När vi började såg ett varumärke ut som strukturerad data. Vi modellerade färger, typografi, bildmaterial och en stor samling stilegenskaper. En crawler fyllde i fälten, och sedan satte genereringen ihop dem till kontext för mejlagenten.

Resultatet kunde ha rätt färg och rätt typsnitt och ändå se generiskt ut. Varje nytt varumärke kom med en detalj som schemat inte hade förutsett. Vi kunde fortsätta lägga till fält, men den mer användbara frågan var hur en designer skulle förklara samma varumärke för någon annan.

En designer skulle skriva en guide. Exakta värden där de spelar roll, exempel där de hjälper och text som förklarar besluten däremellan.

Så vi ändrade vad vi bad extraheringsagenten att ta fram.

## Dokumentet är briefen

Vi kallar det `email-design.md`. Det är ett redigerbart Markdown-dokument som beskriver hur ett visst varumärke ska se ut i mejl.

Här är ett påhittat, förkortat exempel:

```markdown
# Acme email design

## Voice

Write for engineers who want the setup instructions first.
Use short explanations and name the product action precisely.

## Signature details

- Put a small monospace label above the main headline.
- Use thin dividers between sections, without drop shadows.
- Reserve the accent color for the primary action.
- Use one product screenshot when it explains the task.

## Assets

Use the approved logo URL from the asset list.
Do not invent product images or customer logos.
```

Dokumentet kan rymma en regel som ”använd accentfärgen på en sak per mejl” bredvid det exakta färgvärdet. Det ger agenten en instruktion för fall som vi inte har förutsett ett och ett.

![Brew visar en redigerbar email-design.md bredvid samtalet om varumärket.](/blog/email-design-md-editor.png)

*Varumärkesinstruktionerna syns. En korrigering blir en del av nästa brief.*

Markdown är användbart här eftersom människor kan läsa och redigera det utan ett särskilt formulär. Rubriker ger dokumentet struktur, och en ny designregel kräver inget nytt databasfält. Det är ett praktiskt val av format. Det är inget påstående om att Markdown alltid använder färre tokens än JSON eller att alla modeller främst har tränats på Markdown.

## Mejl behöver egna designinstruktioner

En webbplats och ett mejl har olika begränsningar för rendering. Stödet för typsnitt, layout och mörkt läge varierar mellan e-postklienter. En design som ser rätt ut i en förhandsvisning i webbläsaren behöver ändå testas i inkorgen.

Varumärkesdokumentet innehåller därför riktlinjer som är specifika för e-post: reservtypsnitt, bredder på behållare, layoutrecept som fungerar med tabeller och val för ljusa och mörka bakgrunder. De instruktionerna hjälper agenten att fatta lämpliga beslut; de garanterar inte identisk rendering i varje klient.

Bilder har andra krav, så Brew använder också `image-style.md` för riktlinjer om bilder. Det är enklare att uttryckligen hålla isär de två områdena än att be en enda lista med designtokens beskriva varje medium.

## Utgå från materialet som du redan litar på

En publicerad webbplats är ett användbart underlag, men den är inte alltid facit. Den kan innehålla en gammal kampanj eller ett stilexperiment som varumärkesteamet inte längre använder.

Brew kan använda varumärkesriktlinjer, logotyper, bilder och annat referensmaterial som du laddar upp, tillsammans med domänen. Varumärkesriktlinjer som du laddar upp går före det Brew drar för slutsatser av webbplatsen när de säger olika saker. Granska det dokument som blir resultatet, särskilt där källmaterialet är ofullständigt eller motsägelsefullt.

![Formuläret för varumärkeskonfiguration med ett fält för webbplatsen och en plats för kompletterande filer.](/blog/email-design-md-ingest.png)

*En domän och godkända filer ger extraheringen olika sorters underlag.*

Om knappens form är fel, ändra instruktionen. Om tonläget är för formellt, byt ut det vaga adjektivet mot en exempelmening. Den sortens korrigering är mycket lättare att diskutera än ett stort objekt fullt av fält som ingen vill redigera.

## Vad förändringen bevisar och inte bevisar

Dokumentet lägger in godkända adresser till bildmaterial, produktnamn och designbeslut direkt i genereringskontexten. Det minskar luckorna som modellen annars skulle behöva gissa sig till. Det eliminerar inte felaktiga resultat.

Vi ändrade också andra delar av mejlagenten under det här arbetet. Utan en kontrollerad jämförelse skulle jag inte tillskriva filformatet ensamt en övergripande kvalitetsförbättring. Det jag kan påstå är snävare: varumärkesbriefen är lättare att granska, rätta och återanvända.

Ett genererat mejl behöver fortfarande granskas både sakligt och visuellt. Läs påståendena mot briefen, testa länkarna och granska resultatet i inkorgen. [Så briefar du en mejlagent](/sv/blog/how-to-brief-an-email-agent) tar upp den överlämningen.

## Samma kontext finns tillgänglig för anslutna agenter

[MCP-servern](/sv/mcp) för Brew är nu tillgänglig. En kompatibel assistent kan arbeta med Brew via de dokumenterade verktygen och använder då samma varumärkeskontext som appen. [Lanseringsinlägget om MCP](/sv/blog/brew-mcp) och [dokumentationen för konfiguration](https://docs.brew.new/api-reference/mcp/overview) förklarar anslutningen.

Jag gillar att varumärkesinstruktionerna har en självklar plats. När ett mejl känns fel kan vi peka på en mening, ändra den och försöka igen. Det är ett mer användbart samtal än att be modellen att ”göra det mer varumärkesenligt” en gång till.
