O que é garatuja nomeada e por que ela aparece no seu projeto
Você já deve ter se deparado com um arquivo cheio de camadas ou objetos sem identificação coerente e simplesmente criado mais confusão ainda. A garatuja nomeada é exatamente isso: um método de organização que tenta dar nomes coerentes a elementos que, por natureza, são gerados de forma automática ou semi-automática e acabam ficando soltos no meio do projeto. Não é uma ferramenta. É uma prática, e ela funciona melhor quando você para de tratar nomeação como algo automático e passa a tratá-la como uma etapa obrigatória do fluxo. O problema principal é que a maioria das pessoas só aplica nomenclatura depois que o trabalho já está avançado. Na minha experiência, quem trabalha com projetos que precisam ser revisados por outras pessoas — seja na equipe de design, no desenvolvimento ou em auditoria — descobre isso na marra. Um projeto com meia centena de elementos não identificados leva de duas a três horas para ser organizado manualmente, e ainda assim fica faltando pelo menos dois ou três itens que ninguém lembra o que eram.
Como aplicar garatuja nomeada no dia a dia
A abordagem mais direta que eu encontrei funciona assim: antes de qualquer coisa, você define um padrão. Não um padrão bonito ou criativo. Um padrão que resolva o problema imediato. O padrão que uso atualmente é composto por três partes separadas por hífen: tipo-identificador-versão. Por exemplo, um frame de interface fica assim: btn-cta-v2. Um componente de layout vira sec-hero-v1. Parece trivial, mas a diferença entre um projeto que qualquer pessoa consegue abrir e entender em dez minutos e um projeto que vira um quebra-cabeça é basicamente essa estrutura. O segredo é rodar a nomeação em lotes, não item por item. Eu uso scripts simples de automação que percorrem a lista de elementos do projeto e aplicam o padrão conforme o contexto. Se você trabalha com software que exporta listas de IDs ou nomes atuais, dá para fazer isso em poucos minutos. O processo que antes levava uma tarde inteira de renomeação manual caiu para cerca de quinze minutos quando eu padronizei o script.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Um detalhe que quase todo mundo ignora: a nomeação precisa ser consistente com a hierarquia do projeto, não apenas individual. Um elemento chamado btn-cta-v2 dentro de um grupo que se chama "telas" é diferente do mesmo nome dentro de um grupo chamado "componentes". A hierarquia é parte da nomenclatura. Sem ela, o sistema quebra na primeira revisita ao arquivo. Existe um ponto onde isso fica complicado demais e a prática perde a eficiência. Se o seu projeto tem mais de quinhentos elementos para nomear, o script sozinho não resolve. Nesse caso, o que funciona melhor é dividir o trabalho em camadas: primeiro você organiza os grandes grupos, depois aplica a nomenclatura dentro de cada grupo. Fiz isso em um projeto recente com cerca de oitocentos componentes e, mesmo assim, precisei passar duas vezes pelos mesmos arquivos para corrigir inconsistências que o script havia passado batido.
A parte mais útil da garatuja nomeada é a manutenção. Quando um arquivo já está com nomenclatura aplicada e você precisa adicionar algo novo, basta seguir o mesmo padrão e atualizar a versão. Isso evita aquela situação clássica de terminar o dia com cinco versões de um botão chamadas de formas diferentes, sem saber qual é a correta. Se você ainda não tem esse tipo de controle no seu fluxo de trabalho, a primeira dica é simples: pare de nomear os elementos como se fosse uma nota rápida. Trate cada nome como algo que vai sobreviver ao projeto. O resto é questão de manter a consistência.
