É 2023. Estou tentando aprender mais sobre a API da OpenAI. Eu aprendo construindo, então precisava criar algo que fosse útil e tivesse a ver com o que eu conheço melhor: WordPress. Pesquisando, não achei nenhuma solução open source, 100% integrada ao WordPress, com alguns recursos que eu considerava importantes: controle fino de tom, texto que levasse em conta a categoria e um calendário de publicação próprio. Tudo o que existia era SaaS fechado ou ferramenta paga sem personalização de verdade.
Então construí a minha.
Foi assim que o WP-AutoInsight nasceu: um plugin com um único provedor, só a OpenAI, que cuidava de gerar posts agendados.
A versão 1 era simples: chave de API nas configurações, um cron e algumas opções básicas de tom. Funcionava. Mostrei pra alguns clientes, e eles gostaram.
Aí começaram os pedidos.
"Dá pra usar o Claude em vez do ChatGPT?" "Dá pra gerar imagem também?" "Dá pra transcrever um áudio e transformar num post?"
Cada um desses recursos podia ter sido um plugin separado. Em vez disso, comecei a usar IA (Claude, Copilot, de vez em quando Gemini) pra me ajudar a escrever, refatorar e estender o código. A versão 3.2.0 já suportava OpenAI, Claude, Gemini e Perplexity, além de DALL-E 3, Nano Banana e Stability AI pra imagens, com transcrição de áudio e geração de infográficos como extras.
Nada disso estava nos planos da versão 1.
Comece pelo plugin certo
Antes de usar IA pra estender qualquer coisa, a primeira pergunta é se você está estendendo o plugin certo.
Parece óbvio, mas é fácil cair na armadilha: você acha um plugin que faz 60% do que o cliente precisa, decide cobrir o resto com código gerado por IA e, três horas depois, está depurando hooks que nunca foram feitos pra serem mexidos de fora. O ecossistema de plugins do WordPress é grande o bastante pra que quase sempre exista outro plugin que já faz 80% do que você precisa e tem pontos de extensão documentados. Procure esse antes de começar a estender.
Um bom sinal prático é a documentação. Plugin bem documentado costuma ter estrutura de hooks limpa e padrões que outros desenvolvedores já descobriram. Essa informação também chega ao seu modelo de IA, seja pelo que ele aprendeu no treino, seja porque você colou a documentação no prompt. Plugin sem documentação não é beco sem saída, mas quer dizer mais vai e volta.
Mantenha o seu código fora da pasta do plugin que não é seu
Depois de decidir o que estender, a decisão de estrutura importa mais que o código em si.
O instinto é colar o código personalizado no functions.php. Funciona até o dia em que você troca de tema, e aí começa a arqueologia manual pra descobrir quais personalizações precisam ser salvas. O padrão melhor, seja o código escrito por você ou gerado por IA, é um plugin companheiro independente, que se pendura nas actions e filters do plugin que você quer estender.
A IA ajuda aqui porque monta rápido o esqueleto do plugin companheiro. Passe pra ela o código-fonte ou a documentação relevante, descreva o que você quer interceptar e peça um plugin que use os hooks certos. O resultado costuma sair uns 70% aproveitável. Você testa, corrige os casos extremos que ela não previu, resolve as particularidades do ambiente que ela não tinha como saber e publica. O que levaria um dia inteiro do zero leva uma tarde.
O plugin companheiro também facilita a manutenção. Quando o plugin original atualiza, você só confere se os hooks que você usa continuam se comportando igual, em vez de desembaraçar código personalizado enfiado no meio da arquitetura de outra pessoa.
Onde a IA ajuda, e onde ela falha
Usar IA pra estender plugins de WordPress não é a mesma coisa que deixar a IA construir plugins. O resultado exige alguém que conheça arquitetura de plugins de WordPress o bastante pra avaliar.
O que funciona bem: refatoração. Jogue no Claude Code uma função que ficou complicada demais ao longo de seis meses e peça pra limpar a estrutura sem mudar o comportamento. Ele respeita as convenções do WordPress (sanitização, verificação de nonce, lugar certo dos hooks) bem o bastante pra que o resultado costume ser um bom ponto de partida. Pra portar uma integração existente pra uma API nova, o caminho é ainda mais direto: comece pela sua implementação que funciona, descreva as diferenças na especificação da API nova e peça pra adaptar o código.
O que falha: casos extremos e suposições sobre o ambiente. A IA não sabe que a hospedagem daquele cliente tem certas funções de PHP bloqueadas. Não sabe que tem um plugin de terceiro rodando que briga com a abordagem que ela está sugerindo. Não sabe que o WooCommerce do cliente está três versões principais atrasado. Você ainda precisa saber essas coisas, e ainda precisa testar em staging antes de qualquer coisa chegar perto da produção.
O valor de usar IA pra expandir um plugin está em deixar ela fazer as partes chatas. O desenvolvedor por trás das mudanças continua sendo você.
O caso do WP-AutoInsight
O WP-AutoInsight é o exemplo mais claro que eu tenho desse fluxo acontecendo ao longo do tempo. Adicionar suporte ao Gemini num plugin que já tinha integração com OpenAI e Claude quis dizer partir de uma implementação de provedor existente e adaptar: as chamadas de API, o tratamento de erro, a interface de escolha de modelo e o jeito como as respostas viram conteúdo de post. O Claude cuidou da adaptação estrutural. Eu cuidei dos bugs de roteamento, das diferenças de formato de resposta de cada modelo e do fato de que o streaming do Gemini não se comporta igual ao da OpenAI.
Hoje o plugin tem recursos que eu nunca planejei na primeira versão. Essa expansão coube num tempo razoável porque a IA absorveu o trabalho de esqueleto e eu me concentrei nas partes que exigiam critério de verdade.
É uma proporção que se sustenta.
Uma coisa que vale dizer
Código WordPress gerado por IA precisa de revisão de segurança como qualquer código. Sanitize as entradas. Verifique os nonces. Confira as permissões antes de mexer em dados. Os modelos de IA conhecem esses padrões e costumam aplicar, mas "costumam" não basta quando o código roda no site de produção de um cliente. Gaste uns minutos a mais conferindo.
O post sobre estratégia de manutenção WordPress que escrevi cobre um pouco mais do contexto de manter instalações personalizadas estáveis ao longo do tempo. Vale a leitura se você faz esse tipo de extensão pra clientes com frequência.
Se você trabalha com plugins de WordPress que precisam de extensões sob medida, seja uma integração nova, a refatoração de código herdado ou a inclusão de recursos de IA, isso é trabalho de plugins e integração de IA no WordPress. Me conta o que o plugin precisa fazer.