← Todos os projetos

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.

Organização
TCE-MS
Período
2024 · Em andamento
Meu papel
Documentação para IA, tokens e ponte Figma ↔ código
Ferramentas
FigmaAngularDesign tokensFigma MCPClaude CodeGitHub CopilotAgent Skills

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.

© 2026 Fabiano Braz. Todos os direitos reservados.

Feito com Angular · fabianobraz.com.br