Aprova Total · Design System Agêntico
Um design system que a IA consegue usar Plataforma de estudos para o ENEM e vestibulares · setembro e outubro de 2026
Ferramentas: Claude, Figma, HTML/CSS e shadcn/ui
Explorar a vitrine ↗ O ponto de partida Com a chegada da IA ao processo de criação de telas, um problema ficou evidente: as interfaces geradas se afastavam dos padrões da Aprova Total. Mesmo com os componentes do Figma como referência, o resultado ainda exigia muitos ajustes.
Decidi transformar o design system que já existia no Figma em uma base documentada para a IA consultar. O DESIGN.md passou a ser a porta de entrada: reúne as orientações e aponta para as regras que os agentes devem seguir ao criar uma tela.
Meu papel Sou Product Designer na Aprova Total, onde o uso de IA já era uma demanda presente no time. Parti de um design system robusto, construído no Figma, e organizei sua tradução para uma documentação que pudesse orientar pessoas e agentes.
A IA me ajudou a estruturar a documentação e a implementação. As decisões de design continuaram comigo: a hierarquia dos botões, o comportamento dos componentes, os fluxos e a aprovação de novos padrões.
Como funciona Tokens que explicam onde cada valor deve ser usado. O sistema já tinha nomes definidos para fundos, textos, botões, campos e outros usos. Esses valores compartilhados são os tokens de design. A documentação os organiza em três camadas: valores básicos, funções de uso e aplicações nos componentes.
Por exemplo, o token do fundo da ação principal mantém a mesma função nos temas claro e escuro, mas recebe uma cor adequada a cada tema. Assim, o agente consulta uma regra existente para aplicar a cor, em vez de escolher um valor a cada nova tela.
Componentes explicados para quem decide. Criei uma vitrine para tornar essa documentação fácil de consultar. Ela reúne os componentes, suas variantes e hierarquias, exemplos interativos e orientações de faça e não faça. Quem desenvolve pode consultar o código disponível e usá-lo na implementação; os agentes também podem recorrer à mesma base para orientar suas escolhas.
Design System Tema escuro
Exemplo Faça / Não faça Código
Uma hierarquia clara para cada ação. Experimente o botão principal para ver o estado de carregamento.
Começar simulado Salvar rascunho Cancelar
Exemplo demonstrativo, sem envio de dados.
Primary · ação principal Secondary · ação de apoio Ghost · baixa ênfase
Decisões documentadas, antes do código. Faça Use rótulos como “Começar simulado”. Tenha uma ação principal por área. Mostre carregamento ao enviar. Explique o que falta para continuar. Não faça Use “Clique aqui” sem contexto. Coloque três ações principais lado a lado. Permita envios duplicados. Desabilite sem explicar o motivo.
React · shadcn/ui adaptado ao DS Copiar código
Exemplo de uso: requer o componente Button adaptado ao Design System no projeto.
Para quem programa Consulte o exemplo, confira as regras e copie o código para o projeto.
Para o agente As skills consultam a documentação e os tokens para escolher variantes, estados e propriedades.
Ver documentação completa ↗
Agentes com uma função cada. Organizei oito papéis no fluxo, com responsabilidades que vão do briefing à revisão e ao relatório diário. As skills orientam o trabalho dos agentes; a coordenação identifica quais são necessárias para cada pedido, e as decisões que precisam de aprovação voltam para mim.
COMO AS SKILLS COLABORAM
Papéis de uma equipe, traduzidos em skills Cada skill assume uma responsabilidade específica. A comparação ajuda a entender o trabalho; as decisões de design e a aprovação continuam humanas.
Briefing → Coordenação → Criação e conteúdo → Revisão
Briefing de produto Transforma pedidos em especificações. Transforma um pedido simples em um briefing com contexto, requisitos e critérios de entrega. O texto melhorado volta para aprovação de quem fez o pedido antes de orientar a execução.
at-melhorar-promptCoordenação de projeto Organiza o trabalho e aciona as skills. Atua como uma coordenação de projeto: organiza o pedido aprovado, identifica as skills necessárias e conduz o trabalho até a revisão.
at-gerenciar-projetoProduct Designer + implementação Compõe telas com os padrões do sistema. Compõe telas com os tokens, componentes e padrões documentados a partir do DESIGN.md. Usa o Figma como referência para o conteúdo, o fluxo e as decisões de design.
at-criar-telaDesign Systems Designer Propõe e documenta componentes. Quando o sistema não atende a uma necessidade, verifica as opções existentes e documenta uma proposta de componente ou padrão. A inclusão depende da minha aprovação.
at-criar-componenteUX Writer Cuida dos textos da interface. Escreve e revisa os textos da interface com base nas orientações de voz e tom da Aprova Total que incorporei à documentação.
at-escrever-texto-uiQA de interface Confere a aderência ao design system. Confere a aderência das telas ao design system, identifica desvios nos componentes, tokens e estados e aponta o que precisa ser corrigido.
at-revisar-telaEspecialista em acessibilidade Verifica barreiras de acesso e uso. Verifica contraste, navegação por teclado, foco e áreas de toque nas versões disponíveis. Também registra o que não pode ser avaliado com o material recebido.
at-auditoria-acessibilidadeRelatórios de fim do dia Resume entregas e pendências de aprovação. Reúne as alterações, entregas e pendências do dia em um relatório automático. Esse resumo me ajuda a acompanhar o trabalho e dar visibilidade aos gestores.
Conferência automática. As automações apoiam a conferência das entregas e o acompanhamento do trabalho. Ao final do dia, recebo um resumo do que foi alterado, entregue e do que ainda precisa de aprovação. As revisões de interface e acessibilidade ajudam a encontrar problemas antes da entrega.
O Figma como referência, a vitrine como acesso. O Figma continua sendo o guardião do design: é onde valido conteúdo, fluxos e propostas visuais. A documentação traduz essas decisões em orientações para implementação, e a vitrine facilita a consulta a cores, componentes, padrões e código.
Quando surge uma dúvida, o agente deve consultar essa base e trazer a decisão para revisão. Um novo padrão precisa ser validado antes de passar a orientar as próximas telas.
Próximo passo: ampliar o banco de imagens. A vitrine já apresenta regras para imagens e banners. Quero ampliar essa base com um acervo próprio da Aprova Total, para que os agentes possam usar imagens aprovadas ao compor novas telas.
Resultados 67 componentes documentados na vitrine 8 papéis de agentes, do briefing ao relatório diário 3 automações para apoiar a rotina de trabalho Orientações para temas claro e escuro e telas em desktop, tablet e mobile Na minha rotina, entregas que antes levavam cerca de uma semana passaram a levar aproximadamente um dia e meio. Essa é a percepção a partir do meu trabalho com o sistema: menos tempo corrigindo desvios e mais tempo para avaliar as decisões de design.
O que aprendi A IA ainda não entrega tudo pronto e sem ajustes. O ganho foi reduzir o retrabalho, dar critérios mais claros para a execução e tornar a revisão parte do processo.
O Figma define o conteúdo e o fluxo; o design system orienta a linguagem visual e os padrões de implementação. Os agentes ajudam a executar essa base, e eu continuo responsável por validar as decisões e a qualidade da entrega.
Simuladão Claro
04 dias 20 horas 11 min 00 seg
Mesmo componente · tema claro · contagem demonstrativa Simuladão Escuro
04 dias 20 horas 11 min 00 seg
Mesmo componente · tema escuro · contagem demonstrativa ← Voltar aos trabalhos Próximo projeto →