Skip to content

Agente i18n l10n specialist

Petrus Silva Costa edited this page Aug 17, 2026 · 1 revision

Especialista em Internacionalização e Tradução (i18n-l10n-specialist)

Esta página descreve o agente i18n-l10n-specialist de forma didática. Se algum termo for novo, consulte o Glossário.

O que é / cargo

Este agente é o especialista em internacionalização e localização: ele prepara o produto para funcionar bem em vários idiomas e países. Os apelidos vêm do inglês: i18n significa internationalization (preparar o programa para aceitar vários idiomas) e l10n significa localization (traduzir e adaptar o conteúdo para um idioma e cultura específicos). A regra de ouro dele: preparar a arquitetura antes de traduzir, porque uma base mal preparada torna a tradução impossível.

Quando o Claude usa este agente

O Claude Code aciona este agente quando o pedido envolve idiomas, formatos regionais ou tradução. Exemplos de frases que costumam acionar o especialista:

  • "quero que o aplicativo funcione em inglês, espanhol e árabe".
  • "o texto está sendo cortado na versão em alemão".
  • "como mostrar datas e moedas no formato de cada país?".
  • "preciso suportar idiomas escritos da direita para a esquerda".
  • "como lidar com fusos horários diferentes?".
  • "como organizar o processo de tradução do produto?".

O que ele faz

  • Prepara a arquitetura para vários idiomas. Ele garante que todo texto visível fique guardado num catálogo de tradução, com uma chave estável (um nome fixo que identifica cada frase), em vez de ficar escrito direto no código.
  • Evita frases montadas por pedaços. Juntar pedaços de texto quebra em outras línguas, que mudam a ordem das palavras. Ele usa um padrão próprio (ICU) que lida com plural e gênero corretamente.
  • Formata datas, números e moedas conforme cada local, usando uma base de referência mundial confiável, em vez de inventar listas de países ou símbolos de moeda.
  • Testa a expansão do texto antes da tradução real. Algumas línguas ocupam mais espaço (o alemão costuma crescer de 30 a 40 por cento). Ele simula isso cedo para evitar que o texto fique cortado na tela.
  • Cuida das línguas escritas da direita para a esquerda, como o árabe, ajustando o sentido do layout, as margens e os ícones.
  • Usa o horário universal por dentro e converte para o fuso do usuário na hora de exibir, tratando corretamente o horário de verão.
  • Adapta a cultura, não só as palavras: cores, exemplos e imagens podem ter significados diferentes em cada país.
  • Organiza o processo de tradução. Ele monta o fluxo que extrai os textos, envia para a ferramenta de tradução, recebe de volta e gera as versões, com um glossário para manter os termos consistentes.

Cor e camada

Cor azul (operacional). Família: Suporte, Docs, Legal e Idiomas. Ele executa a preparação para idiomas e a localização, em parceria com a engenharia (que aplica a arquitetura) e com o redator técnico (para documentação em vários idiomas).

Manuais que ele consulta

  • ORG: governança e quem decide o que.
  • CONTRACT: a autoridade do projeto sobre o código e os contratos de funcionamento.

Exemplo de pedido

Você diz: "quero lançar o produto em português, inglês e árabe". O agente prepara a arquitetura para aceitar vários idiomas, retira os textos fixos do código para um catálogo com chaves estáveis, define os formatos de data e moeda de cada local, ajusta o layout para o árabe (escrito da direita para a esquerda) e propõe o processo de tradução com glossário, tudo antes de iniciar a tradução de fato.


Veja também Caetano (CTO), que coordena a área técnica, e os colegas de família support-engineer, technical-writer, compliance-legal e internal-auditor. Voltar para a Home.

Clone this wiki locally