Design system que ninguém usa é documentação cara

Já vi biblioteca impecável, com nomenclatura consistente, token bem pensado e documentação caprichada, sendo ignorada por todo o time seis meses depois do lançamento.

O sistema estava certo. O problema é que ele foi desenhado para quem construiu, não para quem ia usar.

A pergunta certa não é se o sistema está bem feito. É se pegar o componente pronto é mais rápido do que refazer na mão. Quando não é, ninguém pega, e não adianta cobrar disciplina.

O QUE FAZ ALGUÉM USAR

Encontrar em menos de um minuto. Se a busca não devolve o componente pelo nome que a pessoa usaria naturalmente, o componente não existe.

Resolver o caso real, não o caso ideal. Se o botão do sistema não tem o estado que aquela tela precisa, a pessoa não vai pedir o estado, vai copiar e adaptar. E ali o sistema já rachou.

Ter um caminho claro para o que falta. Sem isso, cada exceção vira uma versão paralela, e em um ano existem quatro botões primários.

Nada disso é sobre qualidade de desenho. É sobre atrito.

COMEÇAR PEQUENO E COM DONO

Sistema que nasce completo costuma nascer errado, porque foi construído a partir de suposição. Prefiro começar pelos cinco componentes que aparecem em toda tela e deixar o resto crescer sob demanda.

Cada peça que entra tem que ter sido pedida duas vezes por gente diferente. Isso filtra quase tudo.

E precisa ter alguém responsável. Não um comitê, uma pessoa. Sistema sem dono vira terra de ninguém em três meses.

O melhor sinal de que está funcionando não é o número de componentes. É quando alguém do time reclama que falta um. Reclamar é sinal de uso.