diff --git a/.agents/workflows/utf-design.md b/.agents/workflows/utf-design.md
index 1d3dcda..fb8a613 100644
--- a/.agents/workflows/utf-design.md
+++ b/.agents/workflows/utf-design.md
@@ -49,7 +49,10 @@ não consegue guardar — os tokens, os breakpoints e as decisões de abandono.
 1. **Framework CSS** — apresente as opções que a ficha permite (ex.: Tailwind,
    PrimeNG), com o custo de cada uma. A escolha é única para o semestre.
 2. **Tokens** — grave em `docs/design-tokens.md`: paleta (com os papéis: primária,
-   superfície, erro…), escala de espaçamento, tipografia, estados de botão. Não é
+   superfície, erro…), escala de espaçamento, tipografia, estados de botão.
+   **O nome do token é em inglês** (`primary`, `surface`, `danger`), como o resto do
+   código: no setup ele vira classe do framework CSS (`bg-primary`). A conversa com o
+   aluno segue em português; só o nome gravado na tabela é em inglês. Não é
    design system completo — é o mínimo para a IA não inventar um botão por tela.
 3. **Protótipo** — registre o **link público** do Stitch/Figma no
    `docs/design-tokens.md` e no README. O protótipo é a jornada navegável: telas
diff --git a/docs/design-tokens.md b/docs/design-tokens.md
index dfada83..204f863 100644
--- a/docs/design-tokens.md
+++ b/docs/design-tokens.md
@@ -14,17 +14,18 @@
 
 ## Paleta
 
-Nome semântico, nunca `azul-2` — a cor muda, o papel dela não.
+Nome semântico, nunca `blue-2` — a cor muda, o papel dela não. O nome é em
+inglês, como o resto do código: ele vira classe do framework CSS (`bg-primary`).
 
 | Token | Valor | Onde se usa |
 | --- | --- | --- |
-| `primaria` | | ação principal |
-| `superficie` | | fundo de card e painel |
-| `texto` | | texto padrão |
-| `texto-suave` | | legenda, apoio |
-| `perigo` | | erro, exclusão |
-| `sucesso` | | confirmação |
-| `desabilitado` | | controle inativo |
+| `primary` | | ação principal |
+| `surface` | | fundo de card e painel |
+| `text` | | texto padrão |
+| `text-muted` | | legenda, apoio |
+| `danger` | | erro, exclusão |
+| `success` | | confirmação |
+| `disabled` | | controle inativo |
 
 ## Escala de espaçamento