# Conceitos do SEED Design System — índice por conceito

## Como consultar este canon — regra para agentes (uma fonte: `06-validacao/ferramentas/consulta_bloco.py`)

1. Comece pelo índice: `https://ds.seed.eng.br/llms.txt` (a camada de roteamento por INTENÇÃO no topo diz por onde entrar para cada tarefa) e depois o `_index.md` do canônico — uma linha por seção dizendo QUANDO consultá-la. Escolha pela necessidade, nunca pelo título (os títulos carregam placar, data e histórico). Nunca deduza a URL de uma fatia pelo título: o nome do arquivo muda a cada versão.
2. Leia a RECEITA da tarefa antes de abrir qualquer seção: ela lista o MÍNIMO obrigatório (tela de produto = §46 shell + §93 material + CP1 da composição + a tela de referência do shell). "Abra só 3 a 5 fatias" é teto de economia, não licença para parar na primeira; o mínimo da receita não se negocia.
3. Abra a fatia INTEIRA, nunca um recorte por busca de palavra: em 2026-09-18 a regra do raio do rail (linha 73 da fatia do §46) ficou fora de dois recortes de `sed` e voltou como correção do decisor. A fatia começa por "Em uma frase" e "Vocabulário desta seção"; a história fica no fim, em `NN-historico.md` — leia-a só se a pergunta for sobre o passado.
4. Respeite o ESTADO, que é campo do cabeçalho e não prosa: `status: superseded` não tem voz — siga o que `superseded_by` aponta e DIGA na resposta que encontrou a superada; `status: rascunho` pode ser citado como "há um rascunho sobre isso", nunca como decisão. Onde o texto disser "SUPERSEDIDA" antes da regra, a regra é o que vem depois dos dois-pontos.
5. Siga os PONTEIROS da seção: toda seção vestida por uma camada transversal (material, tema, composição) aponta a camada, e a fatia da camada aponta de volta. Quem chega ao §46 é levado ao §93; não é opcional.
6. Se a seção declarar `nao_cobre` o que você precisa, ou não existir seção, NÃO preencha em silêncio: entregue o mais próximo marcado como provisório e termine com o PEDIDO DE COBERTURA preenchido (`references/pedido-de-cobertura.md` na skill; `https://ds.seed.eng.br/pedidos/`). O §55 do chat declara no CH14 o que não cobre — o pedido estava a uma linha e não foi feito.
7. Cite seção, versão e estado de cada decisão ("§46 SH19, componentes v1.65, vigente") e o que veio de fora do canon marque como tal. Sem citação, a resposta é afirmação.
8. A entrega não sai sem a FICHA do conferidor (`conferir-peca.py`) — em adequação de produto existente, rode-o PRIMEIRO no estado inicial (a ficha é o inventário do que diverge) e DEPOIS como prova do conserto; cole o placar com o denominador e diga o que a ficha não mede.

> Páginas GERADAS por `06-validacao/geradores/gen-camada-ia.py` a partir de `01-canonicos/seed-consulta.json` (bloco `_conceitos` e o campo `conceitos` de cada seção). Um conceito é um termo que atravessa mais de uma seção — "rail", "material", "tema". A página do conceito diz o que ele é, qual seção MANDA nele (a seção dona) e todas as seções que o declaram, com a frase "quando consultar" de cada uma. Os links são determinísticos: só aparece aqui o que a seção declarou. **40 conceitos.**

- [acessibilidade](https://ds.seed.eng.br/10-publicacao/ia/conceitos/acessibilidade.md) — declarado por 6 seção(ões): Foco visível, alvo de toque, nome acessível e o piso de contraste, em todo componente.
- [arquetipo](https://ds.seed.eng.br/10-publicacao/ia/conceitos/arquetipo.md) — declarado por 14 seção(ões): O tipo de tela (lista, painel, detalhe, chat) e o contrato de montagem dele.
- [botao](https://ds.seed.eng.br/10-publicacao/ia/conceitos/botao.md) — declarado por 9 seção(ões): O controle que dispara ação: variantes, tamanhos, seis estados, um primário por contexto.
- [camada-de-maquina](https://ds.seed.eng.br/10-publicacao/ia/conceitos/camada-de-maquina.md) — declarado por 1 seção(ões): O que toda página web declara para ser lida por máquina: h1, canônica, alt, JSON-LD.
- [celular](https://ds.seed.eng.br/10-publicacao/ia/conceitos/celular.md) — declarado por 8 seção(ões): Tela estreita: o que colapsa, em que ordem, e o piso de 360 px.
- [chat](https://ds.seed.eng.br/10-publicacao/ia/conceitos/chat.md) — declarado por 3 seção(ões): Mensageria: balões, composer, estados de envio e o vazio da conversa.
- [composicao](https://ds.seed.eng.br/10-publicacao/ia/conceitos/composicao.md) — declarado por 18 seção(ões): A montagem da tela: canvas, peças que flutuam sobre ele, calha e separação.
- [contraste](https://ds.seed.eng.br/10-publicacao/ia/conceitos/contraste.md) — declarado por 10 seção(ões): A régua de legibilidade entre tinta e fundo, com os pisos e os pares medidos.
- [cor](https://ds.seed.eng.br/10-publicacao/ia/conceitos/cor.md) — declarado por 22 seção(ões): A paleta da marca e os papéis de cor que o código consome.
- [dataviz](https://ds.seed.eng.br/10-publicacao/ia/conceitos/dataviz.md) — declarado por 4 seção(ões): Gráfico, mapa e KPI: cor de dado não é cor de interface.
- [email](https://ds.seed.eng.br/10-publicacao/ia/conceitos/email.md) — declarado por 1 seção(ões): E-mail é outro runtime: tabela, cor resolvida em hex, sem JS.
- [espaco](https://ds.seed.eng.br/10-publicacao/ia/conceitos/espaco.md) — declarado por 4 seção(ões): A escala de espaçamento e os cinco primitivos de layout que a aplicam.
- [estado-vazio](https://ds.seed.eng.br/10-publicacao/ia/conceitos/estado-vazio.md) — declarado por 7 seção(ões): O que a tela mostra quando não há dado: seis tipos, nunca um vazio genérico.
- [formulario](https://ds.seed.eng.br/10-publicacao/ia/conceitos/formulario.md) — declarado por 23 seção(ões): Campo, rótulo, ajuda, erro e o contrato HTML de toda entrada de dado.
- [grafismo](https://ds.seed.eng.br/10-publicacao/ia/conceitos/grafismo.md) — declarado por 8 seção(ões): A linguagem de linhas da marca: serra, montanha, regimes, tetos e emenda.
- [icone](https://ds.seed.eng.br/10-publicacao/ia/conceitos/icone.md) — declarado por 4 seção(ões): O glifo: grade 24, traço 2 px, cor por currentColor, set SEED e Lucide.
- [impresso](https://ds.seed.eng.br/10-publicacao/ia/conceitos/impresso.md) — declarado por 7 seção(ões): Peça com alvo físico: medida em milímetros, sangria, piso de traço, cor de impressão.
- [lista](https://ds.seed.eng.br/10-publicacao/ia/conceitos/lista.md) — declarado por 10 seção(ões): Lista de 1 a 3 linhas por item, incluindo a lista de conversas do chat.
- [logo](https://ds.seed.eng.br/10-publicacao/ia/conceitos/logo.md) — declarado por 6 seção(ões): As variantes oficiais do logotipo, onde pegar e por que nunca se redesenha.
- [mascote](https://ds.seed.eng.br/10-publicacao/ia/conceitos/mascote.md) — declarado por 2 seção(ões): O EEny: o que é, as oito poses oficiais e a regra de parcimônia.
- [material](https://ds.seed.eng.br/10-publicacao/ia/conceitos/material.md) — declarado por 4 seção(ões): A camada de acabamento (vidro e metal) que veste peças sem mudar cor nem tipografia.
- [metal](https://ds.seed.eng.br/10-publicacao/ia/conceitos/metal.md) — declarado por 2 seção(ões): Superfície opaca com reflexo de luz sobre a cor do token; vai no rail.
- [movimento](https://ds.seed.eng.br/10-publicacao/ia/conceitos/movimento.md) — declarado por 5 seção(ões): Durações e curvas: registro produtivo, registro expressivo e a preferência de reduzir movimento.
- [navegacao](https://ds.seed.eng.br/10-publicacao/ia/conceitos/navegacao.md) — declarado por 15 seção(ões): Como a pessoa anda pelo produto: regiões do shell, menu, abas, trilha, paginação.
- [painel](https://ds.seed.eng.br/10-publicacao/ia/conceitos/painel.md) — declarado por 3 seção(ões): Dashboard: grade de blocos, lentes, frescor do dado, KPI e edição direta.
- [proposta](https://ds.seed.eng.br/10-publicacao/ia/conceitos/proposta.md) — declarado por 1 seção(ões): A proposta comercial da SEED: estrutura, campos obrigatórios e o que o cliente lê primeiro.
- [rail](https://ds.seed.eng.br/10-publicacao/ia/conceitos/rail.md) — declarado por 2 seção(ões): A coluna de navegação à esquerda, 80 px expandida e 56 px recolhida.
- [raio](https://ds.seed.eng.br/10-publicacao/ia/conceitos/raio.md) — declarado por 2 seção(ões): O arredondamento de canto, da escala de tokens; peça sobre canvas usa radius-lg.
- [registry](https://ds.seed.eng.br/10-publicacao/ia/conceitos/registry.md) — declarado por 3 seção(ões): Como um produto instala tokens, tema e material em vez de copiar CSS.
- [shell](https://ds.seed.eng.br/10-publicacao/ia/conceitos/shell.md) — declarado por 7 seção(ões): A casca de toda tela de aplicação: rail, topbar, sidebar e conteúdo.
- [sidebar](https://ds.seed.eng.br/10-publicacao/ia/conceitos/sidebar.md) — declarado por 2 seção(ões): A navegação contextual do shell: árvore de até quatro níveis ao lado do conteúdo.
- [slide](https://ds.seed.eng.br/10-publicacao/ia/conceitos/slide.md) — declarado por 1 seção(ões): Apresentação com a marca: capa, slide de seção, slide de conteúdo, rodapé.
- [sombra](https://ds.seed.eng.br/10-publicacao/ia/conceitos/sombra.md) — declarado por 3 seção(ões): Elevação e o par sombra+anel que separa uma peça do canvas.
- [tabela](https://ds.seed.eng.br/10-publicacao/ia/conceitos/tabela.md) — declarado por 15 seção(ões): Grade de dados para comparar: colunas, alinhamento, cabeçalho fixo, ordenação, linha clicável.
- [tema](https://ds.seed.eng.br/10-publicacao/ia/conceitos/tema.md) — declarado por 8 seção(ões): Claro e escuro: como a tela inverte, o que inverte e o que fica fixo.
- [tipografia](https://ds.seed.eng.br/10-publicacao/ia/conceitos/tipografia.md) — declarado por 8 seção(ões): Fontes da casa (Montserrat, JetBrains Mono), pesos e a escala de tamanho do texto.
- [token](https://ds.seed.eng.br/10-publicacao/ia/conceitos/token.md) — declarado por 15 seção(ões): O valor de design nomeado e as três camadas; o código consome só o semântico.
- [topbar](https://ds.seed.eng.br/10-publicacao/ia/conceitos/topbar.md) — declarado por 1 seção(ões): A barra superior do shell: identidade à esquerda, busca ao centro, conta à direita.
- [vidro](https://ds.seed.eng.br/10-publicacao/ia/conceitos/vidro.md) — declarado por 2 seção(ões): Superfície translúcida que desfoca o que está atrás; vai na navegação e no que flutua.
- [voz](https://ds.seed.eng.br/10-publicacao/ia/conceitos/voz.md) — declarado por 12 seção(ões): Como a marca fala: tom, o que nunca escrever, e a microcópia dentro da tela.