Design systems · Passo 6 · 8 min de leitura
Medir a adoção
Dizer que todo mundo usa o sistema não é uma medida. O que contar no design e no código, o que as análises de biblioteca do Figma mostram e em quais planos estão, por que os detaches importam mais do que as inserções, quão atrasados os times estão nas versões, e como ler os números junto com o que as pessoas dizem.
Adoção não é se os times usam o sistema. É quanto do que o usuário vê é feito com ele, e se quem constrói escolheria o sistema de novo. Um número só não diz isso. Uma contagem de inserções no Figma diz que as pessoas arrastam componentes para o arquivo; não diz que elas mantêm esses componentes, nem que o código os usa, nem que alguém está satisfeito. Meça algumas coisas, dos dois lados, e pergunte sempre por quê.
O que você vai conseguir fazer depois de ler:
- Escolher medidas de adoção para o design, para o código e para as pessoas
- Ler as análises de biblioteca do Figma e saber de qual plano elas precisam
- Tratar detaches e atraso de versão como sinais, não como falhas
- Mostrar a adoção com honestidade, com números de exemplo, de um jeito que leve a decisões
1. Quatro perguntas, não um número
| Pergunta | Medida | De onde vem |
|---|---|---|
| É usado no design? | Inserções, instâncias, times usando a biblioteca | Análises de biblioteca do Figma |
| É mantido como é? | Detaches, comparados com as inserções | Análises de biblioteca do Figma |
| É usado no que vai ao ar? | Porcentagem de telas ou componentes do sistema, no código | Uma varredura do código |
| Está atualizado? | Produtos na major mais recente | Versões do pacote em cada produto |
| As pessoas querem? | Satisfação, perguntas, contribuições | Uma pesquisa curta, o canal de ajuda |
São cinco linhas para quatro perguntas, de propósito: "usado" tem dois lados, design e código, e eles podem discordar. Um time pode usar todos os componentes do Harbour no Figma e refazer todos no código.
2. O que as análises de biblioteca do Figma mostram
As análises de biblioteca do Figma contam, entre outras coisas, as inserções ("the number of times a component from the library was inserted into a file", quantas vezes um componente da biblioteca foi inserido num arquivo), os times usando a biblioteca e os detaches, registrados "any time someone uses the Detach instance setting", toda vez que alguém usa a opção de desvincular a instância, e o mesmo vale para estilos e variáveis. Por componente, você vê o total de instâncias, quantos times usam e em quantos arquivos (Figma, View and explore library analytics).
O que saber antes de confiar, tudo da mesma página:
- Plano: as análises estão nos planos Education (K-12), Organization, Government e Enterprise; a página de planos lista "Design system analytics" para Organization e Enterprise, não para o Professional (Figma, Plans and features). A Library Analytics API é só do Enterprise.
- Histórico: os dados se atualizam todo dia e vão até um ano para trás. Estilos e variáveis são registrados desde 10 de outubro de 2024.
- Pontos cegos: o uso em rascunhos de outras pessoas não é registrado, componentes aninhados não contam como inserção, e você só vê arquivos de times abertos para a organização.
Então um número que parece baixo pode ser um time trabalhando em rascunhos. Pergunte antes de se preocupar.
3. Detach é uma pergunta, não um crime
Um detach quer dizer que alguém precisou que o componente fizesse algo que ele não faz. Às vezes é engano. Muitas vezes é pesquisa que você não precisou fazer:
- Um componente desvinculado por muitos times → falta algo no componente. Veja o que as pessoas mudaram depois do detach.
- Um time desvinculando tudo → ele não confia no sistema, ou não conhece. Converse com ele (Trazer os times para o sistema).
- Detaches subindo depois de uma versão → a versão quebrou algo de que as pessoas dependiam (Versões e releases).
Leia os detaches a cada 100 inserções, e não como número absoluto, para um mês movimentado não parecer uma crise.
4. Um painel, com números de exemplo
Telas do console feitas principalmente com componentes do Harbour
Porcentagem de telas, 2026, de uma varredura trimestral do código (0 a 100%)
- 22%T1: 22%
- 41%T2: 41%
- 58%T3: 58%
- 71%T4: 71%
Detaches a cada 100 inserções, biblioteca Figma do Harbour
Mesmos trimestres, das análises de biblioteca do Figma (0 a 20)
- 18T1: 18
- 14T2: 14
- 9T3: 9
- 7T4: 7
Os números desta figura são inventados para este curso, para mostrar a forma. Duas medidas, de dois lugares, cada uma no seu gráfico: o uso no código sobe, os detaches no Figma caem. Juntas, dizem que os times usam o Harbour e mantêm os componentes como são. Sozinha, qualquer uma pode enganar: uso alto no código com muitos detaches quer dizer que o código está certo e o Figma não; poucos detaches com pouco uso no código quer dizer que o design adora e o desenvolvimento não constrói.
Como o Harbour mede o lado do código: uma vez por trimestre, um script lista as telas do console da equipe e conta, em cada uma, quantos componentes de interface vêm de @tidewater/harbour e quantos são locais. Uma tela conta como "no Harbour" quando a maioria vem do sistema. É uma medida grosseira, e honesta sobre o que conta.
5. Pessoas, não só contagens
- Uma pesquisa curta, duas vezes por ano: quanto o sistema é útil, o que falta, você escolheria de novo. A pergunta de exemplo de Brad Frost é um bom começo: "On a scale from one to five, how useful is the pattern documentation? Any suggestions?", de um a cinco, quanto a documentação é útil, e alguma sugestão? (Brad Frost, Atomic Design, capítulo 5).
- O canal de ajuda: as perguntas mais frequentes são a sua próxima documentação ou a sua próxima correção.
- Contribuições de fora do time do sistema: o sinal mais forte de que os times pensam no sistema como deles (Modelos de contribuição).
6. Use os números para decidir, não para ranquear
- Escolha uma meta por medida, por trimestre, e a decisão que ela dispara: "Se o Cartão de travessia continuar acima de 15 detaches a cada 100 inserções no próximo trimestre, a gente redesenha."
- Nunca ranqueie os times por adoção em público. Isso transforma um sinal numa nota, e as pessoas começam a manipular.
- Mostre a tendência, não uma foto. Um trimestre diz pouco; quatro contam uma história.
- Marque números de exemplo e estimativas como tal, sempre. O valor do sistema para o negócio é a próxima pergunta, e está em Mostrar o valor de um design system.
7. Erros comuns
- Contar inserções e chamar isso de adoção.
- Medir só o Figma e nunca olhar o que vai ao ar.
- Tratar todo detach como falha.
- Comparar times em vez de tendências.
- Um gráfico com duas escalas, onde dá para contar qualquer história.
- Números sem nenhuma decisão ligada a eles.
8. Vocabulário
| Termo | Significado |
|---|---|
| Adoção | Quanto do que vai ao ar é feito com o sistema, e se as pessoas escolhem o sistema |
| Inserção | Colocar um componente da biblioteca num arquivo |
| Detach | Desfazer o vínculo de uma instância com o componente principal, que para de receber atualizações |
| Cobertura | A porcentagem de telas ou componentes de um produto que vêm do sistema |
| Atraso de versão | Quão atrás da versão mais recente um produto está |
| Análises de biblioteca | Os dados de uso do Figma para uma biblioteca publicada |
9. Experimente (sem ferramentas)
- Escreva as quatro perguntas da seção 1 para o seu sistema.
- Para cada uma, escreva o que você contaria e de onde viria. Marque as que você não consegue medir hoje.
- Para uma delas, escreva uma meta para o próximo trimestre e a decisão que ela dispararia.
Perguntas para refletir: Se você só pudesse medir uma coisa, qual seria, e o que ela deixaria de fora? Quem ficaria chateado se você publicasse os números, e por quê?
10. Se você já pratica
- Olhe os dez componentes com mais detaches e abra três das instâncias desvinculadas: o que as pessoas mudaram?
- Acrescente uma medida do lado do código, se você só tem as do Figma.
- Acompanhe o atraso de versão por produto e leve para toda revisão de versão.
- Mande a pesquisa semestral e publique o que você vai mudar por causa dela.
Checklist
Para saber mais
- Figma Help Center: View and explore library analytics · Figma plans and features (conferidos em novembro de 2026)
- Brad Frost, Atomic Design, capítulo 5: Maintaining design systems
Livros, cursos e vídeos para ir mais fundo
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
Trazer os times para o sistema · Mostrar o valor de um design system · Versões e releases · Modelos de contribuição · Definindo sucesso · Métricas de design system