Nos dois primeiros artigos desta série vimos como preparar um computador para trabalhar com vibe coding e o sistema para desenvolver corretamente com vibe coding, organizando o trabalho com duas IAs, Linear, Notion e GitHub.
Essa era a base para qualquer desenvolvimento, para todo o tipo de sites, aplicações ou software.
Agora vamos ser mais específicos, porque quero mostrar-te como estou a aplicar tudo isto a este site, que funciona em WordPress e está em funcionamento há mais de quinze anos.
E isso representa duas diferenças fundamentais.
A primeira é que não é a mesma coisa criar uma aplicação nova de raiz, onde não há nada para estragar, e começar a modificar algo que já existe com vários milhares de URLs, plugins, dez idiomas, uma quantidade de plugins e visitas todos os dias.
Aqui não podemos deixar o Codex alterar seja o que for e publicar diretamente, porque podemos melhorar uma coisa e estragar outras três pelo caminho.
A segunda é que estamos perante um CMS com uma base de dados, vários milhares de ficheiros próprios, interligados segundo regras já estabelecidas. Não estamos a falar de criar sites estáticos com Astro para o teu negócio, como te contava naquele artigo.
Neste tutorial vou explicar-te:
- Como preparei as bases.
- Que limites imponho à IA.
- Como desenvolvo.
- Como publico.
- E que problemas encontrei.
Para que possas reproduzir o sistema no teu próprio site.
Não importa muito se usas Genesis, como eu, ou outro tema, nem onde tens o alojamento contratado.
Mas atenção, vou partir do princípio de que já tens instaladas as ferramentas dos artigos anteriores e conheces o procedimento geral de trabalho. Aqui vamos concentrar-nos exclusivamente no WordPress.
Passo 1. Ter o WordPress a funcionar no nosso computador
A primeira coisa de que precisamos é de uma cópia local do site. Ou seja, uma instalação que funcione no nosso próprio computador e na qual possamos experimentar sem tocar no site que toda a gente está a ver.
Eu utilizo o LocalWP, uma ferramenta que nos permite executar o WordPress com o seu servidor web, PHP e base de dados. Aqui tens um tutorial bastante detalhado sobre como clonar o WordPress localmente. Se ainda não tens uma cópia do teu site, começa por aí e depois volta a este artigo.
O que nos interessa agora é que o LocalWP esteja a funcionar e que possamos abrir o nosso site local no navegador, aceder à administração e verificar que os plugins e as páginas se comportam como esperamos.
A partir daqui começa o trabalho com o Codex que, se te lembras do nosso segundo artigo, é a IA analista e programadora.
A primeira coisa que lhe vamos pedir é que localize os ficheiros da nossa instalação, identifique o tema e verifique onde vai trabalhar.
Parece uma parvoíce, mas é importante que o código modificado pela IA seja exatamente o mesmo que o nosso WordPress local está a executar.
Aliás, aconteceu-me precisamente isso. Durante os testes manuais de uma correção, parecia que a alteração não funcionava, até descobrirmos (o agente e eu) que o LocalWP estava a utilizar um ramo Git diferente daquele que continha o código corrigido.
Contarei esse caso mais adiante, porque é bastante revelador. Por agora, basta ter uma coisa clara: antes de desenvolver, o Codex tem de verificar que está a trabalhar nos ficheiros certos.
Só precisas de garantir que o teu WordPress local funciona e indicar-lhe a localização do projeto, caso não consiga encontrá-lo.
Passo 2. Deixar o Codex conhecer o nosso WordPress
Já temos uma cópia a funcionar. Agora precisamos de explicar ao Codex o que vai encontrar.
E aqui o WordPress tem uma particularidade: é tão flexível e poderoso que cada instalação é um mundo.
Uma pode utilizar um tema clássico, outra um tema de blocos, outra o Elementor e outra uma combinação de plugins que modificam os modelos, as consultas ou até o comportamento do editor.
Na Cultura Digital, por exemplo, utilizo o Genesis Sample como tema filho de Genesis, o Polylang para gerir dez idiomas, o ACF para os campos personalizados e o Yoast para SEO. Também tenho vários plugins próprios e outras extensões que fazem parte do site há bastante tempo.
Tudo isto importa.
Exemplo: imagina que quero melhorar o aspeto das categorias. O Codex poderia escrever um modelo PHP válido, mas que não respeitasse as traduções, a paginação ou alguma funcionalidade que já implementámos. O código não apresenta erros e, mesmo assim, o resultado está errado.
Por isso, antes de lhe pedir que desenvolva alguma coisa, encarregamo-lo de analisar a instalação.
Primeiro prompt: analisar o nosso WordPress
Podes começar com algo deste género:
Vamos preparar esta instalação de WordPress para trabalhar com desenvolvimento assistido por IA.
Analisa o projeto sem modificar ficheiros.
Identifica a instalação local, o tema ativo, a existência de um tema filho, os plugins relevantes, os ficheiros personalizados e as dependências que possam afetar futuros desenvolvimentos.
Verifica a relação entre o LocalWP, a pasta de trabalho e o Git.
Propõe que código deve ser sujeito a controlo de versões e que elementos devem ficar fora do repositório.
Não modifiques o núcleo do WordPress, plugins de terceiros, credenciais nem a base de dados.
Explica claramente os resultados, identifica os riscos e pede as decisões necessárias antes de continuar.
O Codex começará a inspecionar o projeto e acabará por nos apresentar as suas conclusões.
Convém confirmar que identificou corretamente o tema, as dependências importantes e os ficheiros nos quais vamos trabalhar.
Também deve distinguir o código dos dados.
No WordPress, os artigos, as páginas, as etiquetas, as categorias e muitas opções dos plugins estão numa base de dados. As imagens, por sua vez, costumam ser guardadas em wp-content/uploads/.
Isto significa que, pelo menos no meu caso, o meu repositório GitHub não é uma cópia completa do WordPress.
Utilizo-o para controlar o código que desenvolvo com IA, enquanto a base de dados e os ficheiros multimédia não ficam sujeitos a controlo de versões.
É uma diferença importante em relação a outros projetos de programação, porque recuperar uma versão anterior do código não significa recuperar automaticamente o estado anterior do site.
Mas é muito mais fácil de gerir e está alinhado com o que pretendo: não vou mexer nas funcionalidades do núcleo nem do tema principal; só vou fazer duas coisas:
- Alterar ficheiros específicos do tema filho.
- Desenvolver plugins à medida das minhas necessidades.
E cada caminho é diferente.
Passo 3. Decidir que ficheiros a IA pode modificar
Depois de o Codex conhecer a nossa instalação, temos de decidir até onde o queremos deixar mexer.
Sou bastante restritivo, pelas razões que expliquei acima. Não considero necessário mexer em 99% dos ficheiros do WordPress para conseguir o que se pretende. Por isso, em vez de permitir que o Codex modifique qualquer ficheiro, defini uma lista de sete ficheiros do tema filho que podem fazer parte do nosso sistema de publicação.
| Ficheiro | Para que o utilizamos |
| functions.php | Funções e hooks do tema |
| style.css | Estilos e apresentação |
| front-page.php | Página inicial |
| category.php | Páginas de categorias |
| tag.php | Páginas de etiquetas |
| inc/i18n.php | Internacionalização |
| inc/post-i18n.php | Funções relacionadas com artigos multilingues |
Porquê sete? Porque foram os ficheiros em que mexi para transformar o design da minha página de captação de leads e venda de formação numa revista digital multilingue.
No teu site podem ser três, dez ou quantos forem necessários. O importante é que não seja uma decisão improvisada sempre que pedes algo ao Codex. Se um desenvolvimento precisar de mais algum, a IA deve explicar porquê e pedir autorização.
Por exemplo, o Codex pode considerar conveniente criar um novo ficheiro PHP dentro de uma pasta inc. Não há problema se houver justificação, mas primeiro quero saber para que precisa dele e autorizar a sua integração no projeto.
Além disso, mesmo tendo sete ficheiros autorizados, cada alteração mexe apenas nos que são necessários. Se uma mudança afetar unicamente style.css, o Codex não deve aproveitar para reorganizar functions.php, mesmo que considere isso conveniente. Pode sugeri-lo e avaliamos, mas não o altera sem permissão.
Temos de configurar pessoalmente todas estas restrições?
Não. Essa é precisamente uma das vantagens de trabalhar com o Codex. Eu explico as regras e ele encarrega-se de as incorporar na documentação do projeto.
No meu caso utilizo AGENTS.md, que reúne as instruções operacionais, e outro documento técnico com informações sobre a estrutura do site, as suas dependências e as decisões que fomos tomando.
Assim, quando abrimos uma nova sessão, o Codex pode consultar esses ficheiros e recuperar o contexto sem termos de explicar tudo novamente.
Segundo prompt: estabelecer as regras do projeto
Vamos a establecer las reglas de desarrollo de este WordPress.
Utilizaremos como referencia los archivos del tema hijo que has identificado y que yo autorice expresamente.
Prepara una lista cerrada de archivos que podrán modificarse y publicarse mediante nuestro sistema.
No incluyas el núcleo de WordPress, plugins de terceros, archivos sensibles, base de datos ni contenidos.
Si una futura tarea necesita ampliar esa lista, deberás justificarlo y solicitar autorización antes de hacerlo.
Prepara o actualiza AGENTS.md y la documentación técnica del proyecto.
Establece también que los cambios se desarrollarán en ramas independientes, se probarán localmente y requerirán autorización antes de integrarse y publicarse.
No prepares todavía ningún despliegue a producción.
No segundo artigo já expliquei em pormenor como organizamos o trabalho, por isso não vou repetir aqui todo esse procedimento. O importante é que agora essas regras ficam adaptadas à nossa instalação específica do WordPress.
Passo 4. Pedir ao Codex para configurar o GitHub e a publicação
Até aqui já:
- Analisámos o WordPress.
- Delimitámos os ficheiros a alterar.
Mas ainda falta resolver algo fundamental: como vamos levar para o site publicado as alterações que desenvolvemos no LocalWP?
Obviamente, embora pudéssemos, não vamos fazê-lo manualmente, descarregando os ficheiros e enviando-os por FTP.
É para isso, entre outras coisas, que utilizamos o GitHub.
Vamos pedir ao Codex que prepare um sistema baseado em GitHub Actions que permita publicar ficheiros do tema filho na Webempresa através de FTPS.
O que fiz foi explicar ao Codex como queria trabalhar:
- Queria que todas as alterações ficassem registadas no GitHub, com os respetivos ramos, commits e pull requests.
- Não queria que publicar código no repositório significasse atualizar automaticamente o meu site. Primeiro integramos o código e depois, quando eu autorizar, publicamo-lo.
- Pedi-lhe que a implantação fosse seletiva. Se o Codex modificar functions.php, quero poder publicar apenas esse ficheiro, sem voltar a enviar todos os outros.
- O sistema tem de respeitar a nossa lista de sete ficheiros autorizados.
O Codex tratou de resolver a parte técnica, pedindo-me que aceitasse as permissões necessárias. Depois, o Antigravity verificou o funcionamento e as restrições.
Terceiro prompt: configurar o GitHub e a implantação
Quando tiveres decidido os limites da tua instalação, podes utilizar este prompt:
Quero que prepares o sistema de controlo de versões e publicação deste projeto WordPress.
Configura o repositório GitHub utilizando apenas o código autorizado.
Prepara um procedimento de implantação compatível com o meu alojamento, propondo a alternativa técnica mais adequada.
A publicação deve ser executada manualmente e permitir selecionar apenas os ficheiros da lista autorizada.
Não permitas que um commit, push ou merge provoque automaticamente uma implantação em produção.
Não incluas credenciais, bases de dados, cópias de segurança nem ficheiros sensíveis no GitHub.
Não alargues automaticamente a lista de ficheiros que podem ser publicados.
Prepara a configuração e um procedimento de testes sem publicar ainda nada.
Documenta que acessos preciso de disponibilizar e que ações exigem a minha autorização.
Como dizia, talvez tenhas de intervir manualmente para iniciar sessão no GitHub, autorizar alguma ligação ou introduzir as credenciais do alojamento no local adequado.
Isso é normal. O Codex pode preparar as integrações, mas não deve pedir-te que coles palavras-passe ou chaves privadas diretamente numa conversa.
Depois de configurar o sistema, passamo-lo ao Antigravity para verificar que respeita os nossos limites e não permite publicar ficheiros inesperados.
Com os testes concluídos e as ligações preparadas, podemos começar a desenvolver.
Passo 5. Vamos ao nosso primeiro desenvolvimento no WordPress
Agora sim, chegámos à parte interessante.
Já temos o ambiente local a funcionar, o Codex conhece o nosso projeto, o GitHub está configurado e estabelecemos que ficheiros podem ser modificados.
Só falta decidir o que queremos fazer.
Para começar, recomendo uma melhoria relativamente simples e que possas verificar visualmente. Na Cultura Digital trabalhei, por exemplo, em melhorar a forma como os artigos são apresentados nas páginas de etiquetas.
Queria melhorar a apresentação, destacando os artigos que considero relevantes, sem perder funcionalidades que já estavam a funcionar, sobretudo as relacionadas com Polylang e SEO.
Primeiro explicamos ao Codex o que pretendemos
É aqui que entra a minha parte do trabalho.
Não preciso de dizer-lhe em que ficheiro de PHP deve mexer ou se um modelo precisa de uma consulta adicional. O que tenho de fazer é explicar claramente o resultado que procuro e o que quero preservar.
Por exemplo:
Quero melhorar a apresentação dos artigos nas páginas de etiquetas do meu WordPress.
É necessário preservar as imagens destacadas, a paginação, os metadados e o funcionamento dos plugins relacionados.
Analisa o código atual e prepara um mockup e um plano de implementação.
Identifica os ficheiros que precisarias de modificar e verifica se estão autorizados.
Tem em conta os idiomas disponíveis e os possíveis efeitos no SEO.
Não escrevas código ainda.
Para quando o plano estiver pronto para uma auditoria independente.
Repara que ainda não lhe estamos a pedir que programe nada.
Primeiro queremos saber:
- Que design propõe (caso eu próprio não o tenha definido, pois nesse caso poderia fornecê-lo diretamente)
- Que ficheiros terá de modificar.
- Como tenciona verificar que a solução funciona.
É isto que desenvolvemos no segundo artigo da série: separar a análise e o planeamento da implementação.
Agora entra o Antigravity
Quando o Codex termina a proposta, passo-a ao Antigravity.
O seu trabalho é analisá-la de forma independente, procurar possíveis problemas e verificar que não nos esquecemos de nenhuma dependência importante.
Por exemplo, pode detetar que uma solução aparentemente correta não tem em conta a forma como o Genesis constrói determinadas partes da página, que uma consulta poderia ser demasiado pesada ou que falta verificar o resultado noutros idiomas.
Nem sempre encontrará problemas importantes. Às vezes aprovará a proposta praticamente tal como está; outras vezes obrigar-nos-á a revê-la.
Para isso podemos utilizar este prompt:
Audita de forma independente este plano de desenvolvimento para WordPress.
Verifica a sua viabilidade, segurança, compatibilidade, âmbito e procedimento de testes.
Confirma se respeita os ficheiros autorizados e se pode afetar o funcionamento atual do site.
Identifica riscos e erros que devam ser corrigidos antes da implementação.
Não modifiques código.
Apresenta um veredito GO, GO condicionado ou NO-GO, justificando as observações relevantes.
Se o Antigravity encontrar algo que valha a pena corrigir, entregamos as suas conclusões ao Codex.
E assim, entre um e outro, vamos afinando a solução sem ter de resolver pessoalmente cada divergência técnica.
Quando o plano estiver suficientemente verificado, autorizo a implementação.
O Codex escreve o código e verifica o resultado
Agora o Codex cria um ramo independente, modifica os ficheiros autorizados e executa os testes necessários.
No nosso exemplo, não bastaria verificar que as categorias aparecem corretamente em espanhol. Como temos dez idiomas, também deve confirmar que a alteração não afetou as traduções, as ligações ou a apresentação das outras versões.
Posso abrir o LocalWP e dar uma vista de olhos ao resultado para confirmar que é aquilo que queria.
Não preciso de rever cada linha de código. Para isso existem os testes técnicos e a auditoria seguinte.
Uma segunda revisão antes de publicar
Quando o Codex termina, voltamos ao Antigravity.
Mas agora pedimos-lhe algo diferente.
Antes tinha auditado um plano. Agora tem de rever a implementação real: que ficheiros foram modificados, que código foi acrescentado, que testes foram executados e se a solução respeita as restrições.
Isto é importante porque uma proposta tecnicamente correta pode acabar mal implementada.
Se o Antigravity encontrar algum problema, devolvemos as observações ao Codex. Se aprovar o resultado, podemos avançar para o GitHub.
E também aqui não precisamos de complicar. O Codex pode preparar os commits, enviar o ramo e criar a pull request correspondente.
Continuamos a ser nós a autorizar a integração desse trabalho na versão principal do projeto.
Passo 6. Publicar a alteração sem mexer no resto do WordPress
Com o código terminado, testado e auditado, ainda nos falta um último passo.
Temos de o levar para produção.
No nosso sistema, fazer merge de uma pull request não publica nada automaticamente. E isto é de propósito. Lembra-te:
- Primeiro autorizamos a integração do código no GitHub.
- Depois autorizamos a sua publicação no WordPress, no alojamento de produção.
Suponhamos que a melhoria anterior exigiu alterar tag.php e style.css.
Quando o Codex preparar a implantação, vai propor o envio desses dois ficheiros, não dos sete que temos autorizados nem, claro, da instalação inteira do WordPress.
O procedimento exato depende do sistema que tiveres configurado. Como viste, utilizo GitHub Actions e FTPS, mas podes empregar outro mecanismo compatível com o teu alojamento.
O importante é que o Codex não tenha permissão para publicar quaisquer ficheiros por iniciativa própria.
Depois de concluída a publicação, o Codex verifica se o procedimento terminou corretamente e executa as verificações técnicas que tiver disponíveis.
Posso abrir as páginas afetadas e confirmar que a melhoria está a funcionar.
E há aqui outro pormenor a recordar: o WordPress costuma trabalhar com diferentes sistemas de cache. No meu caso, o WP Rocket, pelo que em determinadas intervenções é preciso confirmar que o site não continua a mostrar uma versão anterior.
Só quando o resultado tiver sido verificado em produção (eliminando o eventual efeito da cache) consideramos a tarefa concluída.
De qualquer forma, o facto de o GitHub indicar que a implantação terminou corretamente não significa que o site esteja a funcionar como esperamos. É por isso que mantemos essa última verificação.
E assim esta via de desenvolvimento estaria concluída.
Passo 7. E se em vez de modificar o tema quisermos criar um plugin?
Até agora trabalhámos exclusivamente com o nosso tema filho, mas o WordPress permite desenvolver funcionalidades que nada têm a ver com o design das páginas.
E não faz sentido colocar todas em functions.php.
Utilizo vários plugins próprios, como YG AI Polylang Bridge, que usamos no nosso sistema de traduções, ou YG Yoast Primary Category Repair, para reutilizar categorias primárias do Yoast em determinados locais.
São ferramentas que desenvolvemos para resolver necessidades específicas do nosso site.
Nestes casos, o procedimento geral é praticamente o mesmo: explico ao Codex do que preciso, ele prepara um plano, o Antigravity audita-o, o Codex desenvolve a funcionalidade e depois fazemos outra auditoria ao código.
Também mantemos o histórico de versões no GitHub.
A diferença importante está na forma como publicamos esses plugins.
Os nossos plugins não são implantados juntamente com o tema filho
Lembra-te de que estabelecemos uma lista de sete ficheiros autorizados para a implantação do tema. Os plugins personalizados não fazem parte dessa lista.
Por isso, quando desenvolvo um, versiono-o e audito-o tal como qualquer outra alteração, mas depois instalo ou atualizo o respetivo pacote manualmente no LocalWP e em produção.
Assim mantenho um histórico de alterações e posso recuperar versões anteriores sem permitir que o workflow mexa em ficheiros de plugins.
E aqui surge outra pergunta: como sabemos se uma funcionalidade deve ser implementada no tema ou como plugin?
No meu caso, troco ideias com o Codex e peço-lhe que analise as alternativas. Dou-lhe o meu ponto de vista, até EU próprio formar uma ideia do que é preferível.
Como orientação, se estivermos a modificar a apresentação de um modelo, provavelmente é melhor trabalhar no tema filho. Se estivermos a criar uma ferramenta que deve continuar a funcionar mesmo que mudemos de tema, um plugin costuma fazer mais sentido.
Podes pedir ao Codex que analise as questões técnicas com um prompt como este:
Quero desenvolver uma nova funcionalidade para o meu WordPress.
Analisa se é preferível implementá-la no tema filho ou através de um plugin personalizado.
Tem em conta a sua manutenção, as atualizações e as dependências.
Diz-me as vantagens e desvantagens de cada opção.
Se propuseres um plugin, deve ter controlo de versões independente no GitHub.
Não o incluas no workflow de implantação do tema.
Prepara um plano de desenvolvimento, testes, auditoria e publicação.
Não implementes nada antes de eu rever a proposta.
Depois de definir a solução, começamos o nosso procedimento habitual.
Como vês, o que muda é a forma de integrar e publicar a funcionalidade, não a maneira de a planear e rever.
Passo 8. Cuidado com a base de dados e os ficheiros de configuração
Há uma questão do WordPress que merece uma secção própria, porque é fácil esquecê-la quando começamos a desenvolver com IA.
Nem tudo o que vemos e configuramos na administração está guardado nos ficheiros do tema.
Os artigos, as páginas, os metadados, as taxonomias e grande parte das definições dos plugins ficam na base de dados.
Decidi não a sujeitar a controlo de versões no GitHub e não permitir que o Codex execute alterações SQL indiscriminadas em produção.
Isso não significa que não possamos utilizar IA para trabalhar com conteúdos. Aliás, já realizei operações em lote através da API do WordPress, por exemplo para atribuir etiquetas a artigos em diferentes idiomas.
A diferença é que essas operações têm um objetivo concreto, utilizam mecanismos do WordPress e são realizadas com restrições previamente definidas.
Não se trata de abrir o acesso à base de dados e deixar a IA alterar o que considerar conveniente porque, como expliquei no início, há regras do WordPress que convém não ignorar. E que a IA pode não respeitar se lhe deres liberdade total.
Na realidade, é o mesmo que faria com uma equipa de desenvolvimento humana. Não se mexe na base de dados, salvo em casos muito específicos.
Um exemplo de desenvolvimento fora dos limites.
Enquanto investigava a lentidão da administração, o Codex encontrou uma configuração incorreta em functions.php.
Era utilizada uma constante para tentar limitar o número de revisões que o WordPress conserva de cada artigo.
O problema é que essa constante tem de ser definida antes de o WordPress carregar o tema. Como estava em functions.php, entrava em vigor demasiado tarde, não aplicava o limite esperado e gerava avisos PHP.
O Codex preparou uma solução que, na verdade, exigia duas operações.
A primeira era eliminar a linha incorreta de functions.php. É um dos sete ficheiros autorizados, portanto não há problema.
A segunda era definir corretamente o limite de revisões em wp-config.php, o ficheiro de configuração do WordPress. Este não está no nosso repositório, nem quero incluí-lo, porque contém informações sensíveis da instalação.
Por isso, o Codex podia preparar as instruções e os testes, mas a alteração em produção tinha de ser feita separadamente. No meu caso, fi-la manualmente no painel do alojamento.
Além disso, era necessário tomar uma decisão que a IA não podia tomar por mim: quantas versões anteriores queria conservar. Quase não utilizo as revisões, mas também não quero ficar sem a possibilidade de recuperar um artigo se cometer um erro. Sou eu que decido o número adequado, não o Codex nem o Antigravity.
Este caso parece-me bastante elucidativo porque demonstra que não podemos tratar todas as alterações do WordPress como se consistissem apenas em modificar e publicar ficheiros PHP.
Às vezes é preciso mexer na configuração; outras vezes, realizar operações sobre os dados. Essas intervenções precisam do seu próprio procedimento, embora o Codex continue a tratar do trabalho técnico.
Passo 9. Quem faz cada coisa no meu sistema
Depois de todo este percurso, penso que já ficou bastante claro como desenvolvo com IA no WordPress, mas vou resumir.
O meu papel consiste sobretudo em explicar o que quero alcançar, tomar decisões quando existem várias alternativas e autorizar as operações importantes.
O Codex realiza a análise, propõe a solução, prepara a documentação, configura as ferramentas, escreve o código e executa os testes técnicos.
O Antigravity analisa de forma independente tanto os planos como as implementações.
E assim vamos avançando de uma fase para a seguinte.
| Fase | O que fazes tu | O que faz o Codex | O que faz o Antigravity |
| Objetivo | Explicas o que precisas | Analisa os requisitos | — |
| Preparação | Aprovas as restrições | Configura o projeto e o GitHub | Revê a configuração |
| Planeamento | Avalias a proposta | Desenha a solução | Audita o plano |
| Desenvolvimento | Autorizas | Escreve e testa o código | — |
| Testes | Verificas o resultado quando necessário | Executa e documenta os testes | Audita a implementação |
| GitHub | Autorizas a integração | Gere ramos, commits e PR | — |
| Implantação | Autorizas a publicação | Executa o procedimento permitido | — |
| Verificação | Aceitas o resultado | Verifica a produção e documenta | Pode analisar incidentes |
| Conclusão | Confirmas o objetivo | Atualiza a tarefa depois de verificar a produção | — |
Pode parecer um procedimento bastante elaborado para alterar algumas linhas de PHP. E, consoante a intervenção, é mesmo.
Mas é importante perceber que a maioria destes passos não sou eu que os executo pessoalmente.
Não estou a rever cada consulta SQL, a escrever testes ou a verificar todos os ficheiros um a um. O Codex e o Antigravity tratam de boa parte desse trabalho.
A minha intervenção concentra-se nas decisões que realmente exigem o meu critério.
Além disso, ter as tarefas e decisões documentadas permite-nos terminar uma sessão e continuar noutro dia sem começar do zero.
Claro que este sistema não garante a ausência de erros. Ambas as ferramentas podem enganar-se e uma auditoria independente não substitui todos os testes que um desenvolvimento possa exigir.
Mas, para o tipo de trabalho que faço aqui na Cultura Digital, é uma forma bastante razoável de avançar sem depender completamente dos meus limitados conhecimentos de programação.
Conclusão: desenvolver WordPress com IA sem nos tornarmos programadores
Depois de utilizar vibe coding tanto para aplicações independentes como para WordPress, continuo a pensar que este último é um ambiente um pouco mais complicado.
Numa aplicação desenvolvida de raiz, costumamos ter um controlo mais direto sobre todos os ficheiros. No WordPress, pelo contrário, dependemos do núcleo do CMS, do tema, dos plugins, da base de dados e de configurações que podem estar distribuídas por vários locais.
Isso torna algumas operações menos simples e obriga-nos a tomar mais precauções, mas não significa que tenhamos de abdicar da IA para melhorar os nossos sites.
No fundo, é uma questão de método. Expliquei-te o sistema que utilizo e que funciona para mim, e sei bem que não é o único possível. Aliás, provavelmente irei mudar algumas coisas à medida que apareçam novas ferramentas ou descubra melhores formas de trabalhar.
Mas, por enquanto, funciona bastante bem. E uma coisa é certa: agora posso considerar desenvolvimentos em WordPress que antes teriam exigido contratar um programador ou passar muito tempo a investigar sozinho.
Com este artigo encerramos a série. Já preparámos o computador para vibe coding, organizámos o nosso sistema e vimos como aplicar o procedimento a um WordPress real.
Agora cabe-te escolher uma pequena melhoria no teu próprio site e experimentá-la. Assim descobres o sistema, as suas particularidades e começas a fazer coisas que antes nem considerarias.
Pelo menos, foi isso que me aconteceu.
Perguntas frequentes
Preciso de saber PHP para desenvolver WordPress com o Codex?
Não precisas de dominar PHP para começar com modificações simples, embora seja conveniente conhecer o funcionamento básico do WordPress e ter claro o que queres alcançar.
O Codex pode escrever o código e o Antigravity revê-lo, mas isso não elimina a necessidade de fazer testes. Quando trabalhamos com funcionalidades complexas ou sensíveis, também pode ser recomendável uma revisão técnica especializada.
Posso utilizar este procedimento com qualquer tema do WordPress?
Sim, embora tenhas de adaptar os ficheiros autorizados à estrutura da tua instalação.
Na Cultura Digital utilizamos Genesis Sample, mas podes trabalhar com outros temas. Não recomendo modificar diretamente ficheiros que possam ser substituídos por uma atualização. O Codex pode ajudar-te a decidir se precisas de um tema filho ou de um plugin personalizado.
Tenho de aprender a configurar GitHub Actions?
Não necessariamente. Encarreguei o Codex dessa parte.
O importante é explicar-lhe o que queremos: publicação manual, ficheiros autorizados, credenciais protegidas e separação entre a integração do código e a sua implantação.
Depois temos de testar e auditar a configuração antes de a utilizar no nosso site real.
Por que razão utilizas o Codex e o Antigravity em vez de uma única IA?
Porque prefiro que quem revê o trabalho não seja a mesma ferramenta que o desenvolveu.
O Codex prepara as soluções e o Antigravity analisa-as de forma independente, tanto antes como depois da implementação.
Isso não significa que detetem absolutamente todos os erros, mas permite-nos confrontar as decisões técnicas sem depender de uma única opinião.
Posso criar plugins completos com o Codex?
Sim. Já utilizamos vários plugins personalizados desenvolvidos com este procedimento.
Mantemos o controlo de versões no GitHub e seguimos o mesmo ciclo de testes e auditorias que para o tema filho.
A diferença é que os instalamos manualmente no LocalWP e em produção, sem os incluir no workflow de implantação do tema.
Por que não guardas a base de dados do WordPress no GitHub?
Porque o Git foi concebido para controlar alterações nos nossos ficheiros de código, enquanto a base de dados contém informação constantemente modificada pelo WordPress.
Além disso, o Git não substitui um sistema de cópias de segurança.
Por isso mantemos separados o código sujeito a controlo de versões e as cópias de segurança de conteúdos, configurações e ficheiros multimédia.
O Codex pode modificar a base de dados?
Pode desenvolver operações controladas através das funções ou API do WordPress, mas não lhe permitimos executar consultas SQL indiscriminadas em produção.
Quando precisamos de modificar dados, definimos exatamente o que deve mudar, como o verificaremos e que cópias de segurança são necessárias.
Posso utilizar este sistema com WooCommerce?
Sim, mas uma loja exige precauções adicionais.
Não é a mesma coisa modificar um modelo e desenvolver algo que possa afetar encomendas, pagamentos, inventário ou dados dos clientes.
O procedimento geral continua a ser válido, embora os testes e as autorizações devam ser adaptados ao risco de cada intervenção.
O que acontece se o Codex precisar de modificar um ficheiro que não está autorizado?
Tem de explicar porquê e pedir permissão.
Depois podemos alargar a lista, autorizar uma exceção específica ou decidir implementar a funcionalidade como plugin.
O que evitamos é que o Codex aumente automaticamente as permissões de publicação sempre que precisa de resolver alguma coisa.
É obrigatório utilizar Linear e Notion?
Não. Utilizamo-los para organizar tarefas, requisitos e decisões, mas podes começar com o GitHub e bons ficheiros de instruções.
O importante é que o Codex consiga recuperar o contexto do projeto e que não dependamos exclusivamente do histórico de uma conversa.
O que faço se o Codex e o Antigravity não estiverem de acordo?
Peço-lhes que confrontem os seus argumentos com o código e os testes.
Não se trata de escolher a resposta que soa mais convincente. Se houver uma divergência técnica importante, devemos identificar que verificação a pode resolver.
Normalmente, o Codex revê as observações do Antigravity, ajusta o plano ou a implementação e voltamos a auditar aquilo que tiver mudado.

Deixe um comentário