---
name: seed-ds
description: Design system da SEED engenharia (marca, tokens, componentes, telas, peças, voz e boas práticas), publicado em https://ds.seed.eng.br. Use sempre que um pedido em contexto SEED envolver interface ou código de front-end (ERP, site, apps), peça gráfica ou impressa (proposta, placa, cartão, timbrado, post, carrossel, capa), apresentação ou documento com a marca, texto ou mensagem em nome da empresa (e-mail, WhatsApp, microcópia), ou qualquer dúvida sobre cor, fonte, logo, mascote EEny, grafismo ou tom de voz da SEED. Ensina onde consultar o canon vivo por modo, como instalar os tokens (registry), quais assets oficiais usar e como citar seção e versão; traz um retrato local para trabalhar sem rede. Se o canon não cobrir o pedido, diga que não cobre e gere o pedido de cobertura pronto para enviar.
license: SEED engenharia — uso interno e de parceiros autorizados; fontes sob SIL OFL (licenças em assets/fontes/)
compatibility: Rede para https://ds.seed.eng.br recomendada (canon vivo); sem rede, use references/ e assets/ (versão em VERSAO.json). Python 3 só para scripts/.
metadata:
  versao: "2026.09.06+b6514dcb"
  canon_de: "2026-09-06"
  gerado_por: "06-validacao/geradores/gen-skill.py"
  fonte: "https://ds.seed.eng.br/10-publicacao/skill/seed-ds/"
---

# seed-ds — o SEED Design System para quem produz com IA

O SEED Design System (DS) é o manual vivo e executável de como a SEED engenharia aparece e se
comporta: 317 tokens, 98 seções de componentes e telas, 31 specs de peça, o jeito de escrever e as boas
práticas de mercado — decididos um a um pelo decisor e publicados em **https://ds.seed.eng.br** para pessoas e agentes.
Esta skill NÃO é o DS: é o caminho até ele. O conteúdo vivo está no site; aqui estão as instruções de
consulta, um retrato local para trabalhar sem rede (canon de 2026-09-06) e os assets oficiais.

## Regra de ouro

1. **A verdade é o canon vivo.** Com rede, comece por `https://ds.seed.eng.br/llms.txt` e leia **só a seção** que a
   tarefa pede (`references/mapa-do-canon.md` diz qual e onde) — nunca um canônico inteiro: o de
   componentes tem mais de 300 mil tokens. Sem rede, use `references/` e diga a versão do `VERSAO.json`.
2. **Cite seção e versão** de cada decisão que você tomar ("botão ghost: seed-componentes.md §1, v1.43").
   O que veio de fora do canon, marque como tal.
3. **Valor de marca não se inventa.** Toda cor, fonte, espaço, raio e tempo vem de um token nomeado
   (`references/tokens.md`); logo, símbolo e EEny só dos `assets/` ou das URLs oficiais — nunca redesenhados;
   dado institucional (endereço, telefone, CNPJ, pilares) só de `references/empresa.md`.
4. **O que o canon não cobre, você diz que não cobre** — entrega o mais próximo, marcado como provisório, E o
   **pedido de cobertura** pronto para enviar (seção abaixo). Nunca preencha a lacuna em silêncio.
5. **Precedência:** marca, tokens, componentes e composição vencem as boas práticas de mercado
   (`seed-praticas.md` é orientação, não regra); a versão mais nova vence a mais antiga.

## Escolha o modo pelo pedido

| o pedido é… | modo | comece por |
|---|---|---|
| tela, componente, página, formulário, dashboard, código React/Tailwind/shadcn, refatorar para o DS, mockup estático de UI | **código** | `references/registry.md` |
| proposta, placa, cartão, timbrado, crachá, etiqueta, uniforme, frota, post, story, capa, carrossel, one-pager, portfólio, qualquer coisa que vira PNG/PDF/impresso | **peça** | `references/pecas.md` |
| e-mail, WhatsApp, mensagem, texto institucional, microcópia, legenda, slogan, grafia | **texto** | `references/voz.md` |
| apresentação, deck, slides, documento com a marca (Word/PDF que não é peça do §12) | **apresentação / documento** | `references/slides-e-documentos.md` |
| "qual é a cor…", "pode usar…", "como é o logo em…", dúvida de marca sem entregar nada | qualquer um | `references/mapa-do-canon.md` → a seção da marca |

Pedido misto (uma tela E o texto dela) = dois modos, nesta ordem: o que estrutura primeiro, o texto depois.

## Modo código

Caminho de consulta, nesta ordem:

1. **Tokens pelo registry** (`references/registry.md`): instale `@seed/tokens` (as variáveis `--seed-*`), `@seed/theme`
   (os apelidos do shadcn apontando para elas) e `@seed/fontes`. O código consome **só semânticos**
   (`--seed-text-primary`, `--seed-surface-brand-deep`…), nunca primitivo, nunca hex, nunca cor padrão do Tailwind.
2. **O componente**: `seed-componentes.md` § do componente (mapa: `references/mapa-do-canon.md`) — estados, tamanhos,
   acessibilidade (WCAG 2.2 AA é o piso), o contrato de bancada. Se a página da vitrine tiver bancada embutida, é o
   comportamento aprovado.
3. **A composição**: `seed-composicao.md` (leis CP1–CP32: grid, densidade, breakpoints, container queries).
4. **A tela**: os 16 gabaritos em `https://ds.seed.eng.br/telas/` (shell, lista, tabela, painel, detalhe, chat, quadro, gantt…).
5. **Ícones**: `references/icones-nm4.md` — quando usar glifo do set SEED, quando importar do Lucide, quando criar.
6. **Camada de máquina** de toda página (§47: um h1, title/description, canônica, lang, alt, nav nomeada, JSON-LD por
   tipo, nunca marcar o que não se vê) e formulário legível por agente (type, inputmode, autocomplete, label, erro em
   aria-describedby).

Mockup estático é este modo com o rótulo "estático": mesmas seções, sem estado nem ARIA — diga no topo que é mockup.
Dados de exemplo: institucionais de `references/empresa.md`; pessoais **fictícios e óbvios** (nunca reais — LGPD).

## Modo peça

1. `references/pecas.md` → a linha da peça: página da vitrine (spec + render), o `.md`, os templates HTML aprovados em
   `07-pecas/`. A spec é o §12.n do `marca-seed.md` v5.37: medida, margens, hierarquia, o que é obrigatório
   (placa de obra tem itens de lei), o que é proibido.
2. **Grafismo**: marca §7 (dois regimes — serra-cena e detalhe de linha — tetos por formato, piso de traço em mm). O
   SVG de referência em `assets/grafismos/` é uma INSTÂNCIA de uma medida (leia `references/grafismo.md`): para outra
   largura, altura ou tema, **gere** com `scripts/06-validacao/geradores/gen-detalhe.py` — nunca repita, estique ou
   ladrilhe o arquivo. Em Python: `importlib` no arquivo, depois `svg_divisor(largura, altura=…, tema='claro'|'escuro',
   uid='…')`, `svg_textura(largura, tema=…, papel=…, uid=…)`, `svg_marcador()`.
3. **Logo e EEny**: marca §5 (14 variantes, mínimos por contexto, posição por contexto, área de proteção) e §6
   (parcimônia: uma pose por peça, nunca redesenhar). Arquivos em `assets/logos/`, `assets/simbolos/`,
   `assets/mascote-eeny/`.
4. **Cor e tipografia** só por token (`references/tokens.md`): a lei 70/20/10 (marca §3.3), vermelho é funcional e
   proibido em marca, Caveat só em display celebratório (§4.3).
5. **Boas práticas do formato** (`references/praticas.md` → `seed-praticas.md` §1–§9: post, carrossel, apresentação,
   proposta) — DEPOIS da marca, e só no que não a contradiz.
6. Peça sem spec no §12 (ex.: carrossel não tem) = o mais próximo do §12 + marca §7/§5 + prática, tudo marcado
   provisório, **e o pedido de cobertura**.

## Modo texto

1. Grafia: **"SEED engenharia"** (S-E-E-D maiúsculas, "engenharia" minúsculo), marca §1 — em `references/voz.md`.
2. Tom e linguagem editorial: marca §10 (direto, acolhedor, sem floreio vazio; o que nunca escrever) — em `references/voz.md`,
   com a microcópia de interface (componentes §1.7, §2.8, §89).
3. E-mail e mensagem: `seed-email.md` (mapa: `references/mapa-do-canon.md`) — estrutura, assinatura, rodapé de
   conformidade; frameworks de mensagem e cold outreach em `seed-praticas.md` §10–§11 (prática, não regra).
4. Fato de empresa só de `references/empresa.md`. Nenhum dado pessoal de cliente em exemplo.

## Modo apresentação / documento

1. `references/slides-e-documentos.md` = marca §13: capa (brand-deep OU branco editorial), slide de conteúdo, slide de
   seção, rodapé padrão `SEED engenharia · seed.eng.br`.
2. Se o documento é uma peça do §12 (proposta §12.7, proposta plus §12.10, one-pager §12.24, portfólio §12.28, laudo,
   memorial…), é **modo peça** — use o template aprovado.
3. Tokens e fontes: `references/tokens.md`; TTF para PPTX/DOCX em `assets/fontes/ttf-por-url.md`.
4. Prática de slide deck: `seed-praticas.md` §6–§7 (sob a regra de precedência de lá).
5. **O canon não tem template de slide** (inventário de peças, item 21): diga isso e gere o pedido de cobertura junto
   com o deck que você montar pelas regras do §13.

## Quando o canon não cobre — o pedido de cobertura

Se a sua resposta contém "o canon não cobre" (ou você tomou uma decisão SEM canon), termine a resposta com o texto de
`references/pedido-de-cobertura.md` **preenchido** — data, papel de quem pediu, a tarefa em uma frase, o que o canon já
cobre (com versão), o que falta exatamente, o que você entregou no lugar, o que a SEED precisa decidir — pronto para a
pessoa copiar e enviar a **contato@seed.eng.br** com o assunto `[DS] pedido de cobertura — <o que falta>`. A pessoa não precisa
explicar nada: tudo vem de você. Do lado da SEED o pedido vira pendência com código e, resolvido, entra no canon — é assim
que o DS cresce.

## Sem rede

`references/` é o retrato do canon de **2026-09-06** (`VERSAO.json` tem a versão e o MD5 de cada fonte). Trabalhe com ele,
diga a versão que usou e avise que pode haver canônico mais novo em https://ds.seed.eng.br. Com rede, `python scripts/conferir-frescor.py`
compara o retrato com o índice vivo e lista o que mudou.

## Antes de entregar — a checagem

- [ ] Toda cor, fonte, espaço e raio é um token nomeado; nenhum hex solto, nenhuma cor padrão de framework.
- [ ] Logo, símbolo e EEny vieram de `assets/` ou das URLs oficiais, sem redesenho; grafismo gerado na medida, nunca repetido.
- [ ] Cada decisão cita seção e versão; o que veio de fora do canon está marcado; a versão do retrato está dita.
- [ ] Nenhum dado pessoal real; dado institucional só de `references/empresa.md`.
- [ ] Se houve "não cobre", o pedido de cobertura está no fim, preenchido.
- [ ] Um agente de IA consegue **achar, ler e citar** o que você entregou (nome, versão, data, procedência).

## Endereços

- Índice para agentes: `https://ds.seed.eng.br/llms.txt` · fatias por seção: `https://ds.seed.eng.br/10-publicacao/ia/` · tokens: `https://ds.seed.eng.br/10-publicacao/ia/tokens.md`
- Registry shadcn: `https://ds.seed.eng.br/r/LEIA-ME.md` (itens em `/r/<item>.json`) · vitrine: `https://ds.seed.eng.br/` · feed de atualizações: `https://ds.seed.eng.br/atualizacoes.xml`
- Este pacote: `https://ds.seed.eng.br/10-publicacao/skill/seed-ds/` (pasta) e `https://ds.seed.eng.br/10-publicacao/skill/seed-ds.zip`

## Arquivos deste pacote

`references/mapa-do-canon.md` (todo o canon por seção, com URL) · `tokens.md` (317 tokens, v1.23) · `registry.md` · `pecas.md`
(31 specs) · `voz.md` · `icones-nm4.md` (§45) · `empresa.md` (= `sobreaseed.md`) · `slides-e-documentos.md` (marca §13) ·
`grafismo.md` (a regra da emenda) · `praticas.md` (índice do `seed-praticas.md` v0.1) · `pedido-de-cobertura.md` ·
`scripts/06-validacao/geradores/gen-detalhe.py` (+ `gen-zero-formatos.py`, que ele lê) · `scripts/conferir-frescor.py` ·
`assets/` (11 logos, 3 símbolos, 8 poses do EEny, 5 grafismos, 7 fontes woff2) · `VERSAO.json`.
Gerado por `06-validacao/geradores/gen-skill.py` — nada aqui se edita à mão; o que mudar no canon muda aqui na próxima geração.