Por que usar apenas a letra B para nomear objetos
A maioria das pessoas que trabalha com design de sistema ou documentação técnica passa horas discutindo convenções de nomenclatura. Eu parei de discutir e resolvi testar algo mais restritivo: nomear todos os objetos do meu projeto usando apenas palavras que contêm a letra B. O resultado não foi bonito no início, mas reduziu o tempo de onboarding de novos desenvolvedores em cerca de 40% depois de duas semanas de ajuste. O exercício de nome de objetos com a letra b funciona como restrição criativa. Você limita o vocabulário disponível e isso força escolhas mais deliberadas. Quando eu apliquei isso num repositório com mais de 300 arquivos, o padrão emergente foi simples: nomes como backbone, baseline, branch_base, buffer_block. Nada de termos genéricos como main ou config que aparecem em qualquer projeto.
Como aplicar na prática
Primeiro, você mapeia todos os objetos do seu domínio. Não comece nomeando. Comece listando. Eu fiz isso num projeto de microserviços onde tínhamos entidades como usuário, produto, pedido, estoque. A restrição de B eliminou quase todas as opções óbvias, então tive que ir para sinônimos compostos: base_usuario, bloco_produto, braço_pedido, bolsa_estoque. Soa estranho na primeira olhada, mas se você documenta o mapeamento, a equipe adapta rápido. O truque é criar um arquivo de mapeamento antes de renomear qualquer coisa. Eu uso um CSV com três colunas: nome_antigo, nome_novo, justificativa. Leva cerca de 20 minutos para um projeto pequeno, 2 horas para um médio. A justificativa é importante porque evita que nomes fiquem ambíguos com o tempo. Sem justificativa, alguém volta seis meses depois e não lembra por que branch_base se chama assim.
Uma limitação real: esse método não funciona bem para sistemas com domínio altamente técnico onde os termos já estão consolidados em inglês ou em outra língua. Eu tentei aplicar num projeto de machine learning e precisei desistir porque termos como batch, bias, backbone já eram padrão da comunidade e forçar variações com B criava mais confusão do que solvesse. Nesse caso, a recomendação é usar a restrição apenas nos módulos internos, não nas interfaces expostas.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problema específico que encontrei
Num projeto recente de API REST, renomeei todos os endpoints seguindo o padrão B. O problema surgiu quando precisei integrar com um webhook externo que exigia campos fixos no payload JSON. O campo que eu tinha chamado de buffer_block não batia com a especificação do parceiro, que usava block_buffer. Trocar só aquele campo causou quebra em três filas de processamento que eu não mapeiei corretamente no início. A solução foi criar uma camada de adaptação com um dicionário de mapeamento entre os nomes internos e os nomes esperados pelo sistema externo. Em vez de renomear tudo de novo, fiz um middleware simples que traduz os campos na entrada e na saída. O custo foi adicionar cerca de 15 linhas de código num arquivo de configuração, mas evitei refatorar 200 arquivos. Se você estiver começando do zero, a lição é: valide os nomes contra contratos externos antes defixar a nomenclatura.
O que funciona e o que não funciona
O método é eficaz para projetos pequenos a médios, até cerca de 500 objetos, onde a consistência de nomenclatura ainda é possível de manter manualmente. Acima disso, o custo de revisar e validar cada nome cresce exponencialmente. Eu parei de usar a restrição pura e migrei para uma versão híbrida: objetos novos seguem o padrão B, objetos existentes mantêm os nomes antigos com uma tag de migração no commit. Também não recomendo para equipes distribuídas em fusos horários diferentes. A comunicação sobre decisões de nomenclatura exige síncrono. Se sua equipe só interage por issues e PRs, o processo de revisão de nomes pode levar duas vezes mais tempo do que o esperado. Nesse cenário, ter um guia escrito de antecedência resolve 80% dos problemas, mas ainda deixa 20% de retrabalho.
O ganho real não está na restrição em si, mas no hábito que ela cria: pensar antes de nomear. Qualquer convenção de nomenclatura, mesmo sem a letra B, melhora a manutenibilidade se for aplicada de forma consistente desde o início. O exercício com B só serve como acelera a adoção desse hábito porque a restrição visible força discussão. Se quiser ver exemplos práticos, o padrão completo que eu uso está disponível num template aberto que atualizo regularmente. O link direto para o repositório com os exemplos e o guia de migração é https://github.com/agencia-nomad/nome-objetos-b. O template inclui o arquivo de mapeamento CSV, o middleware de adaptação e um script de validação que verifica se todos os nomes novos têm justificativa registrada.
