Animalia Copilot
Plugin do Figma que auditava tokens de design em segundos — e encontrou erros que revisões humanas ignoravam
Construí do zero um plugin interno para validar o uso correto de tokens do Animalia Design System — conceito, design e código — enquanto trabalhava como designer no time de Governança da TOTVS.
- Papel
- Conceito, Design e Desenvolvimento
- Contexto
- TOTVS
- Tipo
- Plugin interno para Figma
Contexto
O Animalia sustenta dezenas de produtos distribuídos por múltiplas marcas dentro da TOTVS. Para funcionar bem, ele depende de uma coisa que parece simples, mas raramente é: todos usando os tokens certos, da marca certa, vinculados às variáveis certas.
Na prática, isso não acontecia. Os erros mais comuns eram:
- Tokens corretos aplicados sem vínculo com a variável — via conta-gotas, copiando o valor sem a referência
- Confusão entre temas de marcas diferentes coexistindo no mesmo ecossistema
- Valores hardcoded no lugar de tokens semânticos
- Estilos desvinculados que passavam despercebidos em revisão
Revisões humanas demoravam cerca de 30 minutos por tela — e mesmo assim deixavam erros passar. Não por descuido, mas porque consultar cada token, cruzar com cada variável e registrar o que estava errado era um trabalho lento e fragmentado demais para ser feito com consistência.
A ferramenta
O Animalia Copilot nasce dessa fricção. Um plugin para Figma, construído em TypeScript puro com a Figma Plugin API, que faz a varredura automática de qualquer arquivo de design.
Para cada problema encontrado, o plugin criava um comentário no ponto exato do arquivo — com o que estava errado e o link direto para a seção da documentação que explicava como corrigir.
A ideia não era apenas apontar o erro: era ensinar a correção no contexto onde ela precisava acontecer.
O plugin verificava:
- Se o token estava sendo usado — ou se o designer copiou o valor pelo conta-gotas, sem vínculo com a variável
- Se o token era da marca correta para aquele produto
- Se a variável vinculada era a versão semântica correta, e não apenas um valor coincidentemente igual
Foram 3 meses construindo em paralelo com as demandas regulares do time. Ao ser finalizado, o plugin foi publicado na comunidade interna da TOTVS dentro do Figma.
O que aconteceu depois do lançamento
Nos primeiros dias, chegaram vários retornos com a mesma percepção: 'o plugin deve estar com algum problema — está apontando muita coisa errada.'
Não estava.
Quando os designers foram verificar os comentários com calma — inspecionando cada token apontado — viram que o plugin estava correto em todos os casos. O que parecia 'muita coisa errada' era, de fato, muita coisa errada.
O resultado mais inesperado: o plugin identificou erros na própria biblioteca de ícones interna do Animalia — uma falha que estava no design system há algum tempo sem que nenhuma revisão humana tivesse capturado. Precisamos pausar para corrigir o DS com base no que a ferramenta encontrou.
Uma ferramenta que aponta erros no próprio sistema que você construiu é desconfortável. Também é o maior sinal de que ela está funcionando.
Impacto
Até a minha saída da TOTVS, cerca de 50 designers estavam usando o plugin — adoção que começou no meu time e se expandiu para outros times da empresa nos eventos internos que organizávamos.
- Varredura de uma tela: de ~30 minutos (humano) para ~5 segundos
- Encontrou erros que revisões manuais consistentemente deixavam passar
- Identificou falhas na biblioteca de ícones do próprio Animalia
- Gerou uma rodada de correções no design system a partir dos resultados
- Adotado por ~50 designers na TOTVS
O que esse projeto me ensinou
Construir uma ferramenta para designers — sendo designer — foi um dos projetos mais tecnicamente e humanamente complexos que já enfrentei.
Automação não substitui julgamento — ela libera espaço para ele
Construir para designers é um desafio de design com usuários exigentes
Um produto interno tem o mesmo ciclo de vida que qualquer outro produto
Quando a ferramenta aponta erros no sistema, você usa ela para melhorar o sistema
Você está lidando com inconsistências de escala?
Se o seu time também enfrenta desafios de adoção, governança ou consistência em design systems, posso contribuir com perspectiva técnica e de produto.
