Pular para o conteúdo

Fundamentos

Princípios

Seis regras. Quando um componente novo não cabe nelas, a regra muda antes do componente.

As seis regras#

01

Papel e vidro

Papel guarda dado e decisão. Vidro só no que navega por cima: barras, busca, compositor, toast.

02

A coruja é o agente

Nenhum ícone genérico de IA. A coruja pisca quando vigia e ganha órbita quando trabalha.

03

Mono é máquina

Índices, IDs, rótulos e estados em mono. O que a pessoa lê fica em Inter; o que decide, em Sora.

04

Raios concêntricos

Raio interno = externo − padding. Cartão 16 com 4 de respiro abriga controle 12.

05

Uma margem só

16 · 24 · 40 por largura. Nenhuma tela inventa o próprio padding lateral.

06

Luz, não faixa

Tom aparece como ponto e brilho. Nada de barra colorida no topo do cartão.

Papel e vidro, na prática#

O dado mora em papel opaco. O vidro fica por cima, só no que se move com a pessoa.

vidro · navega por cima⌘K

papel · guarda o dado

Mercado Aurora

R$ 26,3k

papel · guarda o dado

Farmácia Norte

R$ 26,3k

Mono é máquina#

Três vozes com papéis que não se trocam.

a pessoa lê · Inter

A cobrança foi paga pelo cliente e está esperando liquidação.

a pessoa decide · Sora

R$ 1.200

a máquina registra · mono

PG-24A7-96F844 · 2026-09-25T14:02Z

A coruja é o agente#

Nenhum brilho, robô ou varinha. Quem age é a coruja, e o estado dela diz o que está acontecendo.

Faça

  • Coruja em órbita enquanto o agente lê e escreve.
  • Coruja piscando onde o agente está disponível.

Evite

  • Ícone de brilho (Sparkles) para dizer "IA".
  • Spinner genérico enquanto o agente trabalha.
  • Avatar de robô ou rosto humano para o agente.

Luz, não faixa#

Tom aparece como ponto e brilho. Nada de barra colorida no topo do cartão.

assim

38%

conciliado

não assim

38%

Faixa no topo grita e compete com o dado.

Quando a regra muda#

Se um componente novo não cabe nas seis regras, ele não entra torto. Abra uma proposta explicando o problema real, onde aparece e por que a regra atual não serve. A regra muda primeiro, com registro no changelog; o componente vem depois.