ADR 0024 identificadores em ingles - BrunodosSantosVaz/big-bang GitHub Wiki

ADR-0024: Identificadores e CLI em inglês, com os nomes da v2 como aliases

  • Situação: aceita
  • Data: 2026-10-10
  • Dono: Bruno dos Santos Vaz (BrunodosSantosVaz)
  • Decisão: #221 (E1); implementação: #223 (E3), em andamento; release: #220 (v3.0.0).

Contexto e problema

O dono decidiu padronizar em inglês:

quero padronizar tudo em ingles

Depois, ele detalhou o alcance: identificadores e CLI em inglês; documentação, Wiki, skills e mensagens continuam em português do Brasil. Projetos existentes não podem quebrar ao atualizar.

Decisão e justificativa

  1. Uma tabela única (.bigbang/bb/names.py) traduz seções e chaves do bigbang.toml, valores-identificadores (padrao→normal, compilado→compiled, privado→private…), comandos e opções da CLI, labels, prefixos de branch, workflows, checks obrigatórios, ambiente, segredo e variáveis. Nenhum nome legado é escrito em dois lugares.
  2. bigbang.toml bilíngue, nunca misturado:
    • o arquivo é todo em português (v2) ou todo em inglês (v3); a mistura é recusada;
    • depois de carregado, ele responde nas duas línguas: projeto.modo e project.mode são visões do mesmo valor;
    • assim, scripts e código legados funcionam com um arquivo v3, e código v3 lê um arquivo legado;
    • as mensagens de erro de um arquivo v3 usam os nomes em inglês;
    • chaves só da v3: board.model, board.number, board.labels, workflow.model e project.mode = "autonomous".
  3. CLI em inglês (bb generate, bb verify, bb claim, bb decision, bb pipeline …), com cada nome e opção da v2 aceito como alias. O idioma das labels do projeto (board.labels) decide como bb decision grava a decisão; os hooks bloqueiam as labels de decisão nos dois idiomas.
  4. Migração por partes (bb migrate config|labels|board|workflow), cada uma com simulação e volta. Atualizar para a v3 não muda nada sozinho.

Consequências

  • Os aliases ficam durante toda a v3; a v4 os remove com nova migração.
  • Projetos novos nascem em inglês quando a esteira v3 estiver completa.
  • Os caminhos da camada do projeto (tests/aceite, docs/…) só mudam em projetos novos.