Três lugares fazendo a mesma coisa de três jeitos.

Você tá num repo de dois anos. Precisa fazer um dialog de confirmação. Procura "dialog" no codebase. Encontra três: um que usa shadcn direto, um que é um wrapper próprio chamado ConfirmModal, e um terceiro que é JSX inline com role="dialog" e tabindex manual.

Nenhum deles tá errado. Todos funcionam. O problema é que ninguém sabe qual usar. A próxima pessoa vai escolher pelo instinto, e vai surgir um quarto jeito. Tá criada a dívida.

Standards não é sobre ser chato

É sobre não ter que decidir duas vezes. Numa codebase com standard, a pergunta "como eu faço X?" tem uma resposta. Numa sem, tem três — e um debate por PR.

O custo acumulado não é o tempo de escrever três dialogs em vez de um. É o tempo de escolher toda vez. É o medo de mexer em código existente porque você não sabe se ele tá seguindo a convenção certa. É a revisão que vira prosa porque "aqui no nosso time a gente prefere assim".

Inconsistência nunca é a resposta. Respeita o sistema ou substitui.

Como eu traduzo isso

Toda vez que eu vejo duas formas de fazer a mesma coisa no codebase, eu paro e decido: uma fica, a outra migra. Se as duas fazem sentido em contextos diferentes, explicito os contextos — não deixo implícito no código. Se as duas são equivalentes, escolho uma por critério arbitrário (a que tem mais chamadas, a mais recente, a que o linter já aprova) e passo por cima.

O EON Studio (design system que mantenho na 4P) é esse mesmo princípio aplicado: tokens → primitivos → componentes → padrões → docs. Cinco camadas, uma resposta por camada. Se você precisar de algo que não tá lá, a regra é adicionar a camada, não improvisar na última milha.

Onde isso falha

Falha quando o "standard" é só preferência. Preferência muda com humor, com pessoa nova no time, com a última thread do Twitter. Standard se sustenta em argumento — "usamos X porque X resolve o problema Y que apareceu no projeto Z em 2023". Esse nível de explicação é o que separa manual de religião.

Se você não consegue defender o standard, não é standard. É só uma opinião com privilégio.