# seed-tokens v1.40 — índice por seção

## 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.

> Índice GERADO por `06-validacao/geradores/gen-camada-ia.py` a partir de `02-tokens/seed-tokens.md` (20 seções) e de `01-canonicos/seed-consulta.json`. Cobertura desta lista: 20 de 20 com a frase "quando consultar"; 18 de 20 com "em uma frase". O título completo, com o histórico de processo, está dentro de cada fatia; o canônico inteiro está em https://ds.seed.eng.br/02-tokens/seed-tokens.md.

- [cabeçalho cabeçalho (H1 e notas de abertura)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/_cabecalho.md) — Versão vigente dos gêmeos JSON/CSS e as erratas: leia antes de citar um token. · ≈ 1951 tokens
- [§01 Arquitetura em 3 camadas](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/01-arquitetura-em-3-camadas.md) — A arquitetura em 3 camadas (primitivo → semântico → componente): código consome só o semântico. · ≈ 244 tokens
- [§02 Camada 1 — Primitivos](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/02-camada-1-primitivos.md) — Camada 1, primitivos: rampas de cor, TIPOGRAFIA (fonte e tamanho do texto), espaço, raio, movimento. · ≈ 5022 tokens
- [§03 Camada 2 — Semânticos (light + dark)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03-camada-2-semanticos-light-dark.md) — Camada 2, semânticos (claro e escuro): surface, text, border, action, status — usados pelo código. · ≈ 4234 tokens
- [§03b Hierarquia de uso da paleta (decisão de 2026-07-30, lei na Marca v5.0)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03b-hierarquia-de-uso-da-paleta-decisao-de-2026-07.md) — Hierarquia de uso da paleta (70/20/10): qual cor é âncora, apoio ou acento. · ≈ 512 tokens
- [§03c Dataviz — escalas de dado (Fase 5: DT v1.3 e categórica estendida v1.5, ambas **`estável`**)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03c-dataviz-escalas-de-dado-fase-5-dt-v1-3-e.md) — Dataviz: escalas de dado (sequencial, divergente, categórica) — para qualquer gráfico. · ≈ 5313 tokens
- [§03d Material — vidro e metal (F10.1, v1.24](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03d-material-vidro-e-metal-f10-1-v1-24-v1-25-v1-26.md) — Material vidro e metal: os tokens da camada (--seed-mat-*) e a calibração por escopo. · ≈ 3780 tokens
- [§03e Pílula do rail, camadas, véu do diálogo e item de menu — leva 30 (folha de 2026-10-10, resposta dele «a, a, a»)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03e-pilula-do-rail-camadas-veu-do-dialogo-e-item-de.md) — Leva 30: pílula do rail, escala de camadas, véu do diálogo, item de menu. · ≈ 697 tokens
- [§03f Painel lateral à direita — largura e piso do conteúdo (`SH-P62`, folha 11)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03f-painel-lateral-a-direita-largura-e-piso-do.md) — Painel lateral à direita: largura de abertura, largura mínima e piso do conteúdo. · ≈ 589 tokens
- [§05 Acessibilidade — pares auditados (WCAG 2.1, medidos programaticamente em 2026-07-30)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-acessibilidade-pares-auditados-wcag-2-1-medidos.md) — Acessibilidade: os pares de contraste auditados (WCAG 2.1) e a errata do número desta regra. · ≈ 1454 tokens
- [§05-b A TINTA SOBRE FUNDO DE MARCA — três tokens, um por fundo (v1.15, 2026-08-17)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-b-a-tinta-sobre-fundo-de-marca-tres-tokens-um-por.md) *(supersede parcial pelo §05-d)* — A tinta sobre fundo de marca: três tokens, um por fundo (parcialmente supersedido pelo §5-d). · ≈ 1301 tokens
- [§05-c A TINTA SOBRE O BOTÃO DESTRUTIVO (v1.16, 2026-08-18) — fecha a AD-P1](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-c-a-tinta-sobre-o-botao-destrutivo-v1-16-2026-08.md) — A tinta sobre o botão destrutivo (fecha a AD-P1). · ≈ 535 tokens
- [§05-d SUPERSEDE do §5-b — a tinta sobre a marca é BRANCA, e a superfície desce um degrau (v1.17, 2026-08-18)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-d-supersede-do-5-b-a-tinta-sobre-a-marca-e-branca.md) — SUPERSEDE do §5-b: tinta branca sobre a marca, e a superfície desce um degrau (vigente). · ≈ 716 tokens
- [§05-e NENHUM TOKEN NASCEU EM 2026-08-18 (noite) — e os três fatos de camada que a sessão registrou](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-e-nenhum-token-nasceu-em-2026-08-18-noite-e-os.md) — Três fatos de camada registrados sem token novo (2026-08-18). · ≈ 837 tokens
- [§05-g A TINTA DE MARCA NÃO SOBREVIVE A NENHUMA SUPERFÍCIE DE INTERAÇÃO — nasce `text-brand-strong` (v1.19, 2026-08-20)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-g-a-tinta-de-marca-nao-sobrevive-a-nenhuma.md) — text-brand-strong: a tinta de marca que sobrevive à superfície suave e de interação. · ≈ 1551 tokens
- [§05-f A SUPERFÍCIE VERMELHA SÓLIDA TEM TRÊS NOMES NO ACERVO, e um deles tem VALOR DIVERGENTE (2026-08-18)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-f-a-superficie-vermelha-solida-tem-tres-nomes-no.md) — A superfície vermelha sólida tem três nomes e um valor divergente no acervo: qual vale. · ≈ 595 tokens
- [§06 O que este arquivo NÃO cobre (fronteiras)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/06-o-que-este-arquivo-nao-cobre-fronteiras.md) — O que este arquivo NÃO cobre: tokens de componente (camada 3) vivem no seed-componentes. · ≈ 552 tokens
- [§07 Pendências explícitas](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/07-pendencias-explicitas.md) — Pendências explícitas dos tokens (série TK-P): o que ainda não foi decidido. · ≈ 921 tokens
- [§08 Registro de decisões desta entrega (com alternativas descartadas)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/08-registro-de-decisoes-desta-entrega-com.md) — Registro das decisões desta entrega, com as alternativas descartadas — o porquê de cada camada. · ≈ 783 tokens

## Histórico — não é regra

As fatias abaixo guardam COMO a decisão chegou aqui (changelog, histórico por seção e as seções que são registro por natureza: versionamento, log, registro do documento ou da sessão). Elas não governam nada: a regra vigente está na lista acima. Abra uma destas só se a pergunta for sobre o passado.

- [histórico da §03 Histórico da seção §03 — Camada 2 — Semânticos (light + dark) (não é regra)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03-historico.md) **[histórico — não é regra]** · ≈ 125 tokens
- [histórico da §03c Histórico da seção §03c — Dataviz — escalas de dado (Fase 5: DT v1.3 e categórica estendida v1.5, ambas **`estável`**) (não é regra)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/03c-historico.md) **[histórico — não é regra]** · ≈ 712 tokens
- [histórico da §05-g Histórico da seção §05-g — A TINTA DE MARCA NÃO SOBREVIVE A NENHUMA SUPERFÍCIE DE INTERAÇÃO — nasce `text-brand-strong` (v1.19, 2026-08-20) (não é regra)](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/05-g-historico.md) **[histórico — não é regra]** · ≈ 101 tokens
- [§09 Versionamento](https://ds.seed.eng.br/10-publicacao/ia/seed-tokens/09-versionamento.md) **[histórico — não é regra]** — Versionamento dos gêmeos JSON/CSS: qual versão governa e o changelog de cada uma. · ≈ 16952 tokens