Você pediu ao Claude Code para adicionar um estado de carregamento ao formulário de login. O estado de carregamento funciona. O botão também passou a dizer “Log in” em vez de “Sign in”, a mensagem de erro ficou mais simpática, e um dos títulos, de repente, está em caixa de frase. Ninguém pediu nada disso, todos os testes passam e, a menos que alguém leia o diff inteiro palavra por palavra, isso vai para produção.

Este post trata dessa falha específica: um copy já existente e aprovado sendo reescrito silenciosamente por um agente de código com IA, e o workflow que evita isso. Strings que os agentes criam hardcoded e sem chave são outro problema, abordado em por que as ferramentas de código com IA continuam adicionando strings hardcoded. Onde o copy do produto deve ficar, em geral, é a questão de arquitetura, tratada em copy de produto nativo do código. Aqui o foco é o incidente: a manhã de segunda-feira em que o texto mudou e ninguém decidiu que ele deveria mudar. O globalize.now é um sistema de gerenciamento de copy nativo do código, com localização embutida, e esse incidente é um dos motivos de ele existir.

Por que agentes de codificação com IA reescrevem o texto da interface?

Agentes de codificação com IA reescrevem o texto da interface porque enxergam prosa dentro dos componentes; uma vez que esse texto passa a viver atrás de chaves em um arquivo de idioma de origem, alterá-lo se torna uma edição explícita e revisável, em vez de um efeito colateral de outra tarefa qualquer.

Dentro de um componente, “Sign in” não tem nenhum status especial. É uma string literal em um atributo JSX, indistinguível de um className ou de um test id. O agente foi treinado em milhões de diffs nos quais melhorar código ao redor era um comportamento desejável, e, para um modelo, tornar um rótulo “mais claro” é o mesmo tipo de ação que renomear uma variável. Não há erro de tipo à espreita, nem teste falhando, nem anotação de responsável sobre as palavras. Reescrever não custa nada ao agente.

A mudança também passa pelo code review, pelo mesmo motivo. Quem revisa lê lógica. Uma alteração de texto fica no meio de um diff que legitimamente trata de um estado de carregamento, compila, renderiza e, se um teste de snapshot reclamar, a resposta de praxe é atualizar o snapshot, o que registra o novo texto como se tivesse sido aprovado.

Arquivos de regras como o AGENTS.md realmente impedem isso?

Arquivos de regras de agentes reduzem a frequência; eles não tornam o texto da interface intocável. É a arquitetura que torna a edição visível.

Tenha o arquivo de regras de qualquer forma: é a camada mais barata e funciona com frequência suficiente para valer trinta segundos. Este bloco funciona no AGENTS.md, no CLAUDE.md e nas regras do Cursor (.cursorrules ou .cursor/rules/):

## UI copy policy: do not modify user-facing text

- Never change user-visible strings (button labels, headings, empty states,
  error messages, tooltips, placeholder text) unless the task explicitly
  asks for a copy change.
- User-visible text lives in the source locale file (e.g. locales/en.json).
  Reference it by key. Never inline a new user-facing string in a component.
- If a task needs new user-facing text, add a key to the source locale file,
  reference it, and list the new key in your summary for copy review.
- Any diff to the source locale file is a copy change. Call it out
  separately: it needs its own approval, apart from code review.

Agora a parte honesta. Uma regra é contexto, e contexto disputa espaço. Em uma tarefa longa, a instrução é uma linha entre milhares de tokens de código e às vezes perde: para uma compactação, para um sub-agente que nunca a viu, para um padrão forte no arquivo ao redor. Pior: o agente que quebra a regra não avisa. Você não recebe nenhuma notificação de que o texto mudou; recebe um diff em que, por acaso, ele mudou. Uma convenção não é uma verificação.

Por isso o arquivo de regras é a primeira camada, e a camada em que você não deve confiar sozinha.

Como tornar uma edição de texto visível em vez de silenciosa?

Mova toda string visível ao usuário para fora dos componentes e coloque-a atrás de chaves em um arquivo de idioma de origem. A partir daí, um agente que queira mudar o seu texto precisa editar um arquivo cuja função inteira é o texto.

Este é o passo que o arquivo de regras não consegue cumprir, e o mecanismo é simples. Quando os componentes referenciam t('auth.signIn') em vez de repetir "Sign in", duas coisas mudam ao mesmo tempo. Os diffs dos componentes deixam de conter copy, então o agente que trabalha no seu estado de carregamento não tem nada para reescrever ali. E toda mudança de copy, feita por agente ou por humano, cai em um único arquivo, onde uma linha alterada é o evento que importa, e não ruído ao redor dele. Percorrer o diff de um arquivo de locale leva segundos. Reverter uma reescrita indevida é uma linha.

Para ser preciso sobre o que isso entrega: o agente ainda pode editar o arquivo de locale. O ponto não é tornar as palavras intocáveis, e sim fazer com que mexer nelas deixe de ser efeito colateral e vire um ato legível e revisável. É a diferença entre descobrir pelo diff e descobrir por um cliente.

O argumento completo para manter a fonte da verdade na base de código (em vez de em uma ferramenta de design que sincroniza com ela) está no artigo-pilar, copy de produto nativo do código. Este post só precisa de uma consequência: copy com chaves é o que transforma o seu arquivo de regras de um pedido em algo verificável.

Como é o ponto de revisão na prática?

Trate qualquer diff no arquivo de idioma de origem como uma mudança de texto, e encaminhe-a para quem é responsável pelas palavras.

Na prática: coloque o diretório de locales no CODEOWNERS para que um responsável pelo copy seja solicitado em qualquer mudança nele. Adicione uma linha ao template de PR: "este PR altera o texto exibido ao usuário e isso era a tarefa?". E mantenha a exigência no arquivo de regras de que o agente liste as chaves alteradas no resumo; quando ele cumpre, a revisão é instantânea, e quando não cumpre, o hook do CODEOWNERS pega de qualquer jeito.

Em um time pequeno isso é mais leve do que parece. O diff do locale é curto, lê-se em linguagem simples, e "este botão agora deve dizer Log in?" é uma decisão que alguém toma em cinco segundos, desde que a pergunta realmente chegue até essa pessoa, que é todo o trabalho da barreira de verificação.

E se o agente já reescreveu o seu texto?

Primeiro, restaure o texto aprovado; depois, coloque as strings em chaves para que a próxima reescrita apareça como um diff.

Encontrar o estrago é um exercício de git: compare os componentes afetados com o último commit em que você confia e leia só as string literals. Restaure o que mudou. Se você não consegue dizer com segurança qual texto era o aprovado (o botão diz "Log in", a página de marketing diz "Sign in" e nenhum artefato registra qual está certo), você chegou ao estado mais profundo que esse incidente alimenta. Copy drift é o texto visível ao usuário divergindo da sua fonte aprovada entre superfícies e ao longo do tempo, sem uma única fonte da verdade da qual divergir. Esse termo, o que o causa e o que ele provoca adiante merece um artigo próprio: o que é copy drift.

Depois, coloque em chaves o que você restaurou, começando pelas strings que o agente tocou. Elas são, comprovadamente, as que estiveram na linha de fogo.

Onde a localização entra nisso?

Uma reescrita silenciosa é um incômodo em um idioma e um passivo em dez: toda tradução derivada do texto antigo agora está desatualizada, e nada avisa que é preciso retraduzir.

É aqui que o incidente com o agente se agrava. Publique o inglês reescrito e o seu alemão, japonês e espanhol continuam dizendo a coisa antiga: as superfícies agora discordam entre idiomas, e não apenas entre telas. Catálogos que saem de sincronia são um modo de falha à parte, com correções próprias, abordado em arquivos de tradução fora de sincronia.

Textos com chaves fecham esse ciclo também, porque uma string de origem alterada é um evento visível ao qual as traduções ficam atreladas, em vez de um literal que mudou discretamente. Esse é o design do globalize.now: o texto vive na base de código, com fonte única por trás de chaves, e a localização é a mesma operação, e não um adendo: conecte um repositório e todos os idiomas derivam dessa única fonte. Times que entregam com ferramentas de programação com IA esbarram nisso primeiro, e por isso escrevemos para desenvolvedores e para quem está construindo com ferramentas de IA.

Da próxima vez que um agente estiver mexendo nos seus componentes, a questão é se um rótulo alterado vai aparecer como uma decisão ou como uma surpresa. O globalize.now centraliza suas strings visíveis ao usuário no repositório que você conecta, e deriva todos os idiomas a partir dessa única fonte.

O globalize.now transforma textos fixos do app em arquivos de locale prontos para tradução e os mantém atualizados a cada novo lançamento.

Experimente o globalize.now grátis