Para agentes

Como um agente (Claude Code, Cursor, Zorro) constrói interface com o anticaos: especifica, procura, usa, verifica e entrega.

Fluxo

1
Especifica
Antes de escolher componente, escreve o problema. Se algo não estiver claro, pergunta.
2
Procura
Lê o índice de componentes: quando usar, quando evitar e o que usar no lugar. Só cria se nada servir, e diz por quê.
3
Verifica
Roda o checador nos arquivos que mexeu e corrige até passar. Confere estados, foco visível e rótulos.
4
Entrega
Diz o que fez, o que criou de novo e onde testar. Não faz merge nem deploy sozinho.
5
Registra
Se criou algo reutilizável, propõe trazer para o anticaos.

Template de pedido

shows:       o que a tela mostra
actions:     o que a pessoa pode fazer
states:      vazio, carregando, erro, sucesso, desabilitado
sensitivity: tem dado pessoal, financeiro, de saúde? (pergunte)
audience:    quem usa e em que contexto (celular, pressa, primeira vez)

Regra de tokens

#0a0a0a, text-gray-500, rgba(…)text-foreground, text-muted-foreground, bg-muted…

text-[10px], text-[13px]text-3xs, text-2xs, text-xs, text-sm ou um papel type-*

rounded-[20px]rounded-glass, rounded-xl…

z-50, z-[9999]z-(--z-modal), z-(--z-float)…

shadow-[0_8px_…]shadow-float, shadow-glass, shadow-sm…

backdrop-blur-[35px]backdrop-blur-glass

Se o token não existe, o agente usa o mais próximo e aponta a lacuna — não inventa.

verificar

node <caminho-do-anticaos>/scripts/check-tokens.mjs src/components/arquivo.tsx

Arquivos para agentes

AGENTS.mdRegras para qualquer agente que construa interface com o anticaos

docs/COMPONENTS.mdÍndice gerado: quando usar, quando evitar, variantes, acessibilidade

src/tokens/tokens.jsonTokens em W3C DTCG, cada um com descrição de uso

src/components/components.jsonOs metadados dos componentes em JSON (vai no pacote)