Design system · IA
TCE Components 2.0
Design system institucional do TCE-MS, em Angular. Escrevi a documentação que pessoas e IA leem antes de montar uma tela, e medi o efeito dela em teste cego.
Contexto
Os analistas passaram a prototipar telas com assistentes de IA. Sem uma referência clara, cada IA inventava o próprio design system: cores soltas, componentes refeitos à mão e contratos da biblioteca usados do jeito errado, muitas vezes sem erro aparente. A pergunta era como fazer a IA usar de verdade a biblioteca e as Foundations do tribunal.
O que eu fiz
- Documentação de cada componente tirada do código-fonte, não da aparência: exemplo pronto para copiar e armadilhas no topo. Onde o dado não existe no código, o texto diz isso em vez de supor.
- Uma fonte única: os fatos sobre a biblioteca moram em um só lugar, e as demais instruções apenas apontam para ela.
- Teste cego A/B antes de escalar: a mesma tarefa de tela, o mesmo modelo de IA (Claude Sonnet 4.6, via GitHub Copilot), três rodadas por grupo. Sem a documentação, 5 erros graves de API por rodada; com ela, nenhum.
- Prioridade pelo uso real: contagem dos componentes nos sistemas que já usam a biblioteca, em vez de documentar tudo por palpite.
- Distribuição junto com o pacote: quem instala a biblioteca recebe a documentação, um arquivo de instrução e uma skill de prototipagem no padrão aberto Agent Skills, que funciona no Claude Code e no GitHub Copilot.
- Piloto com analistas, com uma bancada pronta para ver a tela rodando.
- Levantamento de padrões da biblioteca e de lacunas de acessibilidade, levado ao time.
- Tokens de design com nomenclatura e validação; Figma com variáveis integrado ao código por MCP.
- Documentação e Foundations publicadas na versão oficial da biblioteca.