A busca por uma solução eficiente para traduzir automaticamente um blog técnico levou um desenvolvedor da Codeminer42 a construir seu próprio plugin WordPress em tempo recorde. Após tentativas frustradas com plugins populares do mercado, a equipe optou por desenvolver uma solução personalizada utilizando Claude Code, completando o projeto funcional em apenas 48 horas de trabalho.
Frustração com soluções existentes motiva desenvolvimento próprio
Quando a necessidade de publicar versões em português dos posts em inglês do blog de engenharia surgiu, a primeira abordagem foi buscar soluções prontas no ecossistema WordPress. O Polylang apareceu como alternativa promissora inicialmente, mas rapidamente revelou problemas significativos. Logo após a instalação, todos os links do site começaram a retornar erro 404, um comportamento que se mostrou “normal” segundo a documentação, exigindo ajustes manuais nas configurações de permalinks.
As dificuldades aumentaram quando a equipe descobriu que a funcionalidade de integração com IA para traduções automáticas ficava atrás de um paywall. Mesmo que conseguissem configurar corretamente o plugin, não havia justificativa para adquirir uma versão profissional apenas para tradução automática. Essa limitação, combinada com os problemas técnicos encontrados, levou à decisão de desenvolver uma solução própria que atendesse especificamente às necessidades do projeto.
Arquitetura desenvolvida em um dia com Claude Code
No primeiro dia de desenvolvimento, o foco foi estabelecer uma arquitetura robusta que minimizasse a fricção com o ambiente WordPress existente. O desenvolvedor orientou o Claude Code para seguir uma abordagem de Test-Driven Development (TDD), resultando em uma estrutura que evita problemas comuns de plugins que “quebram” sites quando ativados. A solução priorizou segurança e simplicidade de desinstalação desde o início.
A arquitetura final utiliza primitivos do WordPress: uma taxonomia personalizada chamada cm_language para marcar posts com seu idioma, metadados _cm_translation_group com UUID compartilhado para vincular traduções, e um padrão provider para backends de tradução com IA. Notavelmente, a implementação não requer tabelas customizadas no banco de dados, simplificando a manutenção e reduzindo potenciais conflitos.
Cobertura de testes abrangente desde o início
A abordagem de TDD resultou em uma suíte de testes extensa que cobriu funcionalidades críticas desde o primeiro dia. Os 156 testes PHPUnit com 323 assertions alcançaram aproximadamente 80% de cobertura na parte core do plugin. As funcionalidades testadas incluíram configuração de idioma com suporte a idioma padrão, vinculação bidirecional de traduções baseada em UUID, todos os três provedores de tradução com HTTP mocking, reescrita de URL com prefixos de idioma, geração de tags hreflang e REST API com filtragem por idioma.
Segundo dia dedicado a testes reais e ajustes
O segundo dia de desenvolvimento concentrou-se em validar o plugin em ambientes mais próximos da produção. Utilizando o Chrome DevTools MCP, o desenvolvedor configurou uma instalação do WordPress com o mesmo tema usado em produção e testou a instalação e configuração completa do plugin. Embora os testes iniciais tenham funcionado perfeitamente, a implantação em ambiente real revelou desafios adicionais.
Na instalação de produção, que utilizava o editor clássico em vez do Gutenberg, foram necessários ajustes específicos para garantir compatibilidade. Outro problema significativo surgiu quando o plugin alterou inadvertidamente a query da página inicial, exigindo correções na lógica de filtragem de conteúdo. Essas idas e vindas foram aceleradas pela combinação do Claude Code com o Chrome DevTools MCP, permitindo validação rápida e identificação de problemas.
Fluxo de tradução automatizado e eficiente
O fluxo final de tradução implementado pelo plugin segue uma sequência otimizada. Quando um autor clica em “Translate with AI” em um post em inglês, o sistema primeiro adquire um lock baseado em transient com Time To Live (TTL) de 5 minutos para evitar traduções duplicadas. Em seguida, o plugin envia título e conteúdo separadamente para o provedor de IA configurado.
Após receber as traduções, o sistema cria um novo draft post com o conteúdo traduzido. Os posts são vinculados bidirecionalmente através de UUIDs compartilhados, permitindo navegação fácil entre versões linguísticas. Todo o processo é automatizado, reduzindo significativamente o trabalho manual necessário para publicar conteúdo multilíngue.
A importância do prompt na qualidade da tradução
Uma descoberta crucial durante o desenvolvimento foi que a qualidade da tradução depende mais do prompt enviado à IA do que do provedor específico escolhido. O desenvolvedor implementou regras de formatação específicas no prompt: preservar Markdown, não converter blocos de código em parágrafos, manter backticks e seguir regras de linguagem claras (não inflar o texto, não usar linguagem promocional, não forçar a “regra dos três”).
Essas regras combatem tendências comuns das IAs de tradução, como transformar “Isto está quebrado” em “isto representa um desafio significativo”. Mantendo a tradução honesta e técnica, o conteúdo preserva seu valor informativo original enquanto se adapta ao novo idioma.
Resultados tangíveis em tempo recorde
O projeto foi concluído com resultados impressionantes: 14 classes e 1.581 linhas de código PHP, zero tabelas customizadas no banco de dados, e uma suíte de testes robusta. A implementação demonstra como ferramentas de IA generativa podem acelerar significativamente o desenvolvimento de soluções complexas quando combinadas com expertise técnica existente.
A experiência também destacou a importância de testar em ambientes que espelham a produção, já que diferenças entre ambientes de desenvolvimento e produção podem revelar problemas críticos. A combinação de Claude Code com ferramentas de desenvolvimento web tradicionais provou ser particularmente eficaz para validação rápida e solução de problemas.
O caso ilustra uma tendência crescente no desenvolvimento de software: em vez de depender exclusivamente de soluções prontas do mercado, equipes técnicas estão utilizando ferramentas de IA generativa para criar soluções personalizadas que atendem precisamente às suas necessidades específicas. A capacidade de desenvolver um plugin WordPress funcional e bem testado em apenas dois dias demonstra como essas ferramentas estão redefinindo o que é possível em prazos de desenvolvimento tradicionalmente mais longos. O projeto completo, incluindo todos os detalhes técnicos, está disponível no blog da Codeminer42 em português, traduzido justamente pelo plugin desenvolvido.
