É 2023. Estou tentando aprender mais sobre a API do OpenAI. Aprendo criando, então tinha que criar algo que pudesse ser útil e de alguma forma relacionado ao que conheço melhor: WordPress. Fazendo uma pesquisa, não consegui encontrar nenhuma solução open-sourced, 100% integrada ao WordPress, e que tivesse alguns recursos importantes: controles de tom específicos, saída ciente de categoria e seu próprio cronograma de publicação. Tudo que havia disponível era SaaS fechado ou ferramentas pagas sem customização real.
Então construí a minha própria.
É assim que WP-AutoInsight começou; como um plugin com um único provedor, apenas OpenAI, que lidava com geração de posts agendados.
A versão 1 era simples: chave de API nas configurações, um cron job, e algumas opções básicas de tom. Funcionava. Mostrei para alguns clientes, e eles gostaram.
E então os pedidos começaram a chegar.
"Podemos usar Claude em vez de ChatGPT?" "Pode gerar imagens também?" "Pode transcrever áudio e transformar isso em um post?"
Cada um desses recursos poderia ter sido um plugin separado. Em vez disso, comecei a usar IA (Claude, Copilot, ocasionalmente Gemini) para me ajudar a escrever, refatorar e estender o código. A versão 3.2.0 agora suporta OpenAI, Claude, Gemini, Perplexity, além de DALL-E 3, Nano Banana e Stability AI para imagens, com transcrição de áudio e geração de infográficos como extras.
Nada disso estava planejado na versão 1.
Comece com o Plugin Certo
Antes de usar IA para estender qualquer coisa, a primeira pergunta é se você está estendendo o plugin certo.
Isso parece óbvio, mas é fácil cair em uma armadilha: você encontra um plugin que faz 60% do que o cliente precisa, decide fechar a lacuna com código gerado por IA, e três horas depois, você está debugando hooks que não foram projetados para serem tocados externamente. O ecossistema de plugins do WordPress é grande o suficiente para que outro plugin geralmente exista, um que já faça 80% do que você precisa e tenha pontos de extensão documentados. Procure por esse antes de começar a estender.
Um sinal prático é a documentação. Plugins com documentação completa geralmente têm estruturas de hook limpas e padrões estabelecidos que outros desenvolvedores já descobriram. Essa informação também está disponível para seu modelo de IA — através de dados de treinamento ou colando a documentação relevante diretamente no seu prompt. Um plugin sem docs não é um beco sem saída, mas significa mais idas e vindas.
Mantenha Seu Código Fora da Pasta do Plugin Que Você Não Escreveu
Depois de identificar o que estender, a decisão estrutural importa mais do que o código em si.
O instinto é colar código customizado em functions.php. Isso funciona até você mudar de tema, e então você está fazendo arqueologia manual tentando descobrir quais customizações você precisa salvar. O padrão melhor, quer você esteja escrevendo o código você mesmo ou gerando-o com IA, é um plugin companion autônomo que se conecta às ações e filtros do plugin alvo.
IA é útil aqui porque pode scaffolding rapidamente a estrutura do plugin companion. Dê a ela o código-fonte ou documentação relevante, descreva o que você quer interceptar, e peça para ela escrever um plugin que use os hooks corretos. A saída geralmente chega a 70% utilizável. Você testa, corrige os casos extremos que ela perdeu, lida com as questões específicas do ambiente que ela não podia saber, e lança. O que teria levado um dia inteiro do zero leva uma tarde.
A abordagem de plugin companion também torna a manutenção mais tratável. Quando o plugin original é atualizado, você está verificando se os hooks que está usando ainda se comportam da mesma maneira — não desenredando código customizado misturado na arquitetura de outra pessoa.
Como IA Pode Ajudar, e Onde Falha
Usar IA para estender plugins do WordPress não é a mesma coisa que deixar IA construir plugins. A saída requer alguém que conheça o suficiente sobre arquitetura de plugins do WordPress para avaliar.
O que funciona bem: refatoração. Alimente Claude Code com uma função que cresceu muito complexa ao longo de seis meses, peça para limpar a estrutura sem alterar o comportamento. Ela respeita convenções do WordPress (sanitização, verificação de nonce, colocação de hook) bem o suficiente para que a saída geralmente seja um bom ponto de partida. Para portar uma integração existente para uma nova API, o padrão é ainda mais direto: comece com sua implementação funcionando, descreva as diferenças na especificação da nova API, e peça para adaptar o código.
O que falha: casos extremos e pressupostos de ambiente. IA não sabe que a configuração de hosting específica do seu cliente tem certas funções PHP restritas. Não sabe que você tem um plugin de terceiro rodando que entra em conflito com a abordagem que está sugerindo. Não sabe que a instalação WooCommerce do cliente está três versões principais atrasada. Você ainda precisa saber essas coisas, e você ainda precisa testar em staging antes de qualquer coisa chegar perto de produção.
O valor de usar IA para expandir um plugin está em deixá-la trabalhar nas partes tediosas. Você ainda é o desenvolvedor por trás das mudanças.
O Caso WP-AutoInsight
WP-AutoInsight é o exemplo mais claro que tenho deste fluxo de trabalho se desenrolando ao longo do tempo. Adicionar suporte a Gemini a um plugin que já tinha integrações com OpenAI e Claude significava começar a partir de uma implementação de provedor existente e adaptá-la — as chamadas de API, o tratamento de erros, a UI de seleção de modelo, e a forma como respostas são formatadas em conteúdo de post. Claude lidou com a adaptação estrutural. Eu lidei com os bugs de roteamento, as diferenças de formato de resposta específicas do modelo, e o fato de que o comportamento de streaming do Gemini não é idêntico ao do OpenAI.
O plugin agora tem recursos que nunca planejei na primeira versão. Essa expansão foi possível em um período de tempo razoável porque IA absorveu o trabalho de scaffolding, e eu foquei nas partes que realmente exigiam julgamento.
É uma proporção sustentável.
Uma Coisa Vale a Pena Dizer
Código WordPress gerado por IA precisa de uma revisão de segurança da mesma forma que qualquer código. Sanitize inputs. Verifique nonces. Valide capacidades antes de tocar dados. Modelos de IA conhecem esses padrões e geralmente os aplicarão, mas "geralmente" não é bom o suficiente quando o código roda no site de produção de um cliente. Gaste alguns minutos extras verificando.
O post WordPress Maintenance Strategy que escrevi cobre um pouco mais do contexto mais amplo sobre manter instalações customizadas estáveis ao longo do tempo — vale a pena ler se você está regularmente fazendo esse tipo de trabalho de extensão para clientes.
Se você está trabalhando com plugins do WordPress que precisam de extensões customizadas, seja novas integrações, refatoração de código herdado, ou adição de capacidades de IA, esse é o tipo de trabalho que faço.