---
fonte: 02-tokens/seed-tokens.md
versao_da_fonte: v1.23
secao: cabeçalho
titulo: "cabeçalho (H1 e notas de abertura)"
sequencia: 1 de 17
bytes_do_corpo: 5485
md5_do_corpo: 90d49edc52169117fe23f4d74b1308d2
gerado_por: 06-validacao/geradores/gen-camada-ia.py
nota: fatia GERADA — o corpo abaixo é byte a byte o trecho do canônico; edite o canônico, nunca esta fatia. Canônico inteiro em https://ds.seed.eng.br/02-tokens/seed-tokens.md
---
# SEED engenharia — Design Tokens v1.23

> ⚠ **ERRATA DE CABEÇALHO, declarada em 2026-08-20.** Esta linha dizia **v1.17** enquanto os gêmeos
> (`seed-tokens.json` + `seed-tokens.css`) já estavam em **v1.19** — o cabeçalho do CSS até registra a
> defasagem por escrito (*"este cabecalho dizia v1.17 depois de a v1.18 ter nascido"*), mas a correção
> nunca chegou aqui. **Três versões de atraso num H1 de arquivo canônico.** Corrigido junto com a
> **v1.20**, que nasce `--seed-font-expressive`.
> *Por que isso vale registro e não só conserto: número de versão em cabeçalho é a primeira coisa que
> alguém lê para decidir se o arquivo está atual. Cabeçalho atrasado faz um documento correto parecer
> velho — e um documento velho parecer correto.*

> **Arquivo canônico da camada de tokens.** Primeira entrega (Fase 1) do rebranding do design system SEED iniciado em julho/2026. Este documento é a fonte de verdade conceitual; os valores executáveis vivem em dois arquivos gêmeos gerados juntos: `seed-tokens.json` (formato DTCG/W3C, para ferramentas e agentes) e `seed-tokens.css` (CSS custom properties, para web). Os três arquivos formam uma unidade: alterar um exige alterar os três.
>
> **Quem consome:** o site público do DS (Lovable), o ERP SEED, o sistema de chat, o site institucional, as skills `seed-ds-*` do Claude, e qualquer sistema futuro. Componentes e peças NUNCA usam hex direto: consomem tokens semânticos; tokens semânticos consomem primitivos.
>
> **Contexto para leitor novo:** a SEED engenharia é um HUB de engenharia elétrica (ES/MG/BA, desde 2016). A paleta de marca (8 cores, definida no rebrand de 2018 e mantida) não mudou neste trabalho — o que este arquivo faz é transformá-la de "lista de 8 hex" em sistema de 3 camadas capaz de servir produto digital, dark mode, dataviz e acessibilidade WCAG 2.2 AA. Identidade visual geral: `marca-seed.md` (v5.0 em produção). Institucional: `sobreaseed.md`.
>
> **Data:** 2026-07-30 · **Editado:** 2026-08-25 (v1.22 — **a SEGUNDA leva da camada 3 entra nos gêmeos, e a classe ganha INSTRUMENTO**: 19 tokens de botão, cartão, divisor, lista, item destrutivo de menu e espera, todos nomes que o `seed-componentes.md` já usava e o gêmeo não definia. A diferença de método em relação à v1.21 é que a lacuna deixou de ser procurada por `grep` e passou a ser medida pela guarda `guarda-spec-gemeo.py` (contrato **SG1**), que varre os canônicos e reprova todo custom property nomeado no canon e ausente do gêmeo — placar dela: **121 PASS · 29 FAIL → 140 PASS · 10 FAIL**. Dos 29 acusados, 19 tinham origem de valor declarada e foram emitidos; **10 não se emite**, e a lista com o motivo de cada um está na entrada v1.22 do §9 — inclusive três nomes que o canon cita apenas para registrar um defeito, um descarte ou um exemplo de diagrama. Anterior: v1.21 — **nasce a PRIMEIRA CAMADA 3 (componente) dos gêmeos, fechando a AD-P6**: os 21 tokens `--seed-field-*` do form-field, especificados e medidos na §2.5 do `seed-componentes.md` desde 2026-08-02 e até hoje ausentes dos gêmeos — a spec citava `seed-field-` 116 vezes, os gêmeos tinham ZERO, e o ERP consome exatamente essa camada. Adição pura (nenhum valor anterior muda), hex resolvido dos aliases da §2.5, gate **G5** novo na `paridade-tokens.py` (fidelidade alias→valor + espelho `prefers-color-scheme` conferido pela primeira vez); placar 85·0. Detalhe na fronteira do §6; v1.17 — **a MARCA QUE CARREGA TEXTO desce um degrau**: o gate visual do Rafael vetou a tinta escura sobre a marca e pediu texto branco; com o branco fixado, a superfície passa a ser turquesa-600 `#098475` (4,60) e nascem `surface-brand-strong` e `text-on-brand-strong` — estado vigente no **§5-d**, que supersede metade do §5-b. A marca chapada `#11B0A0` segue a âncora, reservada para área sem texto; v1.16 — **a TINTA DO BOTÃO DESTRUTIVO**, que fecha a **AD-P1**: o destrutivo clareia no tema escuro e a tinta continuava branca, medindo 2,71→2,76 contra piso 4,50; nasce `text-on-action-destructive`, branca no claro e vermelho-900 no escuro, com o RITO de três rodadas registrado no **§5-c**; v1.15 — **as TRÊS TINTAS DE MARCA**, que fecham a **MR-P1** e a **MR-P2**: um único token de tinta servia três fundos de marca com necessidades opostas e errava dois deles, um em cada tema; agora são `text-on-brand` (escura, sobre a marca chapada), `text-on-brand-deep` (branca) e `text-on-action-primary` (inverte) — estado vigente no **§5-b**, com errata dupla no §5; v1.14 — **`surface-brand-subtle`**, que fechou o BT-P6 na causa, mais a primeira errata do "3,22"; v1.13 — **`row-selected-*`**: o realce de linha selecionada ganha dono no canônico, fechando uma lacuna que a bancada `banco-dados.html` já vivia com definição local; adição pura, três tokens, quatro guardas novas na paridade; v1.12 — **`border-interactive` fecha a SH-P1/PN-P5**, promoção medida do empréstimo declarado do shell; v1.11 — **semânticos de COMPOSIÇÃO E CHROME do CP-P3**: `rail-background` gradiente CP20, dois overlays de chrome do SUP-6, paleta de entidade `entity-1…6`+tinta do CP23 e `marker-now` do CP24 — todos invariantes de tema, todos medidos, inclusive em composição; histórico completo no §9, com a restauração retroativa das entradas v1.7–v1.10 que faltavam na tabela) · **Autoria:** Claude + Rafael (decisões aprovadas em conversa de projeto)

---