Skip to content
All writing
/desenvolvimento-wordpress 11 min read

Desenvolvimento Agêntico: Porque os Developers de WordPress Têm de o Adotar Já

Descobre como o desenvolvimento agêntico com o WordPress MCP transforma a criação de plugins. Aprende a programar com IA supervisionada usando o Claude Code para construir plugins 10x mais depressa, mantendo controlo total e qualidade.

O desenvolvimento agêntico está a transformar a criação de plugins WordPress. No último ano, construí todos os meus plugins com desenvolvimento agêntico supervisionado, não com IA sozinha, mas com IA sob a minha supervisão. Esses plugins andam neste momento em sites WordPress enterprise sem um único problema crítico. O resultado? Desenvolvimento 10x mais rápido, código de melhor qualidade e controlo total. Aqui fica porque é que o desenvolvimento agêntico está prestes a tornar-se inegociável para os developers de WordPress, e exatamente como montar o teu ambiente hoje.

Índice

O Problema: Desenvolver em WordPress é Demasiado Lento

Vamos falar do que se está realmente a passar no desenvolvimento WordPress neste momento.

Tens um cliente que precisa de um plugin custom. Talvez seja um sistema de membership, uma ferramenta de bookings, ou uma integração complicada com uma API de terceiros. Sabes exatamente o que tem de ser feito, mas estás a olhar para dias ou semanas de trabalho:

  • Escrever código boilerplate
  • Configurar tabelas na base de dados
  • Criar interfaces de admin
  • Construir endpoints REST API
  • Escrever testes
  • Debugar edge cases

E o pior? Provavelmente estás a copiar e colar código de projetos antigos, a mexer em nomes de variáveis, a torcer para não te ter escapado nada. É lento, propenso a erros, e chato.

Entretanto, os teus concorrentes estão a usar IA para fazer em horas o que tu fazes em dias. O fosso aumenta todos os dias.

Porque “Usa Lá IA” Não é a Resposta

Antes que penses que te estou a dizer para atirar tudo ao ChatGPT e fazer ship do que sai, espera.

Já vi o que acontece quando developers, sobretudo juniores, tratam a IA como uma máquina mágica de imprimir código. Recebem código que funciona… até não funcionar. Aí ficam sem ideia de como corrigir porque nunca perceberam o que estavam a construir.

Foi disto que escrevi no meu post sobre vibe coding. Há uma diferença enorme entre usar IA como muleta e usá-la como ferramenta poderosa.

A resposta verdadeira é desenvolvimento agêntico supervisionado: a IA trata do trabalho repetitivo, mas tu és o arquiteto, o revisor e o controlo de qualidade. Cada linha de código é lida por ti. Cada decisão é validada. Nada vai para produção sem testes locais.

O Que é Desenvolvimento Agêntico?

Desenvolvimento agêntico significa dar a agentes de IA tarefas específicas dentro de um ambiente controlado, onde podem:

  • Ler o teu codebase existente
  • Perceber a estrutura do teu site WordPress
  • Gerar código a partir dos teus requisitos
  • Testar o que criam
  • Iterar com base em feedback

A palavra-chave aqui é supervisionado. Não estás a entregar o controlo; estás a delegar execução, mantendo a supervisão.

Pensa nisto assim: em vez de escreveres cada linha de código à mão, descreves o que queres em linguagem corrente, revês o trabalho da IA, e corriges. É como ter um developer júnior que escreve a 1000 palavras por minuto, mas que continua a precisar da tua orientação.

As Objecções (E Porque Estão Erradas)

Ouço as mesmas preocupações sempre que falo desta abordagem:

“É demasiado caro.”

Não, não é. Faz as contas: se cobras 100€ à hora e a IA corta o teu tempo de desenvolvimento de 40 horas para 4 horas, poupaste 3.600€ em tempo. Mesmo que as ferramentas custem 200€ por mês, recuperas isso em poucas horas. O ROI é instantâneo.

“É demasiado complicado.”

É para isso que serve este post. Vou mostrar-te exatamente como montar tudo. Se consegues configurar um site WordPress, consegues configurar isto.

“A IA não funciona out of the box.”

Tens razão; se pedires ao ChatGPT para “construir-me um plugin”, vais receber lixo. Mas quando dás à IA as ferramentas certas (como o WordPress MCP server), o contexto certo e a supervisão certa, funciona em pleno.

“A IA engana-se.”

Sim, engana. Os humanos também. A diferença é que, com uso supervisionado e as ferramentas certas, os erros da IA são apanhados antes de se tornarem problemas. Tu revês cada linha. Testas localmente. Validas a lógica. A IA não toma as decisões finais; tu é que tomas.

“Não é fiável.”

Ando nisto há um ano. Todos os plugins que construí com assistência de IA estão neste momento em produção, em sites WordPress enterprise, sem problemas. A fiabilidade vem da supervisão, não da IA ser perfeita.

O Caminho Certo: Desenvolvimento Agêntico Supervisionado

Eis como isto funciona na prática:

1. Pequenos Passos de Cada Vez

Não peças à IA para construir um plugin inteiro de uma só vez. Parte por bocados:

  • “Cria o boilerplate do plugin”
  • “Adiciona um custom post type para bookings”
  • “Constrói a página de admin settings”
  • “Cria o endpoint REST API”

Cada passo é gerível, revisível e testável.

2. Lê Cada Linha

A sério. Cada linha de código que a IA gera, lê-la. Se não percebes alguma coisa, pede à IA para explicar. Não é só apanhar erros. É aprender e manter pleno conhecimento do teu codebase.

3. Sem Auto-Deploy

Nada vai para o ar sem testes locais primeiro. A IA pode gerar código, pode até correr testes, mas és tu que validas se funciona realmente num ambiente real.

4. Usa a IA para Testar o que foi Feito

Aqui fica um truque poderoso: depois de a IA gerar código, pede-lhe para escrever testes para esse código. Depois revê os testes. Ficas com duas camadas de validação.

5. Olha Bem para os Resultados

Não basta verificar se o código corre. Verifica se é seguro, se segue os WordPress coding standards, se é performante, se trata edge cases. A IA também ajuda nisto; pede-lhe para rever o próprio código à procura de problemas de segurança.

As Ferramentas de que Precisas

Vou ser específico sobre o que precisas para montar o teu ambiente de desenvolvimento agêntico supervisionado:

1. Claude Code ou OpenCode

São agentes de coding feitos especificamente para desenvolvimento supervisionado. Conseguem ler o teu codebase, fazer alterações, correr testes e iterar. Não são autocompletes; são parceiros de desenvolvimento a sério.

2. VS Code

O teu IDE fica igual. Estas ferramentas integram com o VS Code, por isso continuas a trabalhar num ambiente familiar.

3. WordPress MCP Server

É a viragem de jogo no desenvolvimento WordPress. O Model Context Protocol (MCP) server dá à IA acesso directo aos dados do teu site WordPress: posts, páginas, utilizadores, plugins, settings, tudo.

Eis como te ligas a um site WordPress usando o MCP server na configuração do OpenCode:

"pluginslab-mcp": {
    "type": "local",
    "command": ["npx", "-y", "@automattic/mcp-wordpress-remote@latest"],
    "environment": {
        "WP_API_URL": "https://pluginslab.com",
        "JWT_TOKEN": "XXXX"
    }
}

Substitui WP_API_URL pelo URL do teu site WordPress e JWT_TOKEN pelo teu token de autenticação. Agora a IA consegue buscar dados do site, criar posts, atualizar plugins e testar alterações. Sempre sob a tua supervisão.

4. Um Ambiente de Staging

Nunca testes em produção. O MCP server deve apontar para um site de staging onde podes testar e validar em segurança antes de fazer push para o ar.

5. Agent Skills (Em Breve)

Skills são workflows pré-construídos que ensinam os agentes de IA a tratar de tarefas específicas em WordPress. Pensa neles como receitas: “como criar um custom post type”, “como adicionar uma página de settings”, “como integrar com WooCommerce”. Vamos escrever sobre isto em posts futuros.

Exemplo Real: Construir um Plugin com Supervisão

Deixa-me levar-te por um exemplo real de como isto funciona.

Cenário: Um cliente precisa de um plugin custom de bookings para o site WordPress.

Abordagem tradicional: 2 a 3 semanas de desenvolvimento.

Abordagem agêntica supervisionada: 2 a 3 dias.

O processo:

  1. Descrevo os requisitos à IA em linguagem corrente: “Precisamos de um sistema de bookings com custom post types, vista de calendário, notificações por email e integração com WooCommerce.”
  2. A IA faz perguntas de clarificação e propõe uma arquitetura. Eu revejo e aprovo.
  3. A IA gera o boilerplate do plugin. Eu revejo a estrutura de ficheiros e os coding standards.
  4. Passo a passo, a IA constrói cada funcionalidade. Depois de cada passo, leio o código, testo localmente no site de staging (ligado por MCP) e aprovo ou peço alterações.
  5. A IA escreve testes para cada componente. Eu revejo a cobertura de testes.
  6. Testo o workflow completo à mão em staging antes do deploy.

Tempo total poupado: 85%. Qualidade: superior ao desenvolvimento manual porque cada linha foi revista e testada.

A Evidência: O Que Aprendi num Ano de Desenvolvimento Agêntico

Eis o que te posso dizer pela experiência real:

  • Todos os plugins que construí com IA no último ano andam em instalações WordPress enterprise
  • Zero problemas críticos em produção
  • Tempo de desenvolvimento reduzido em cerca de 10x na maioria dos projetos
  • A qualidade do código é superior porque a supervisão obriga a uma revisão minuciosa
  • Aprendi mais no último ano do que nos cinco anteriores, porque ensinar a IA obriga-te a perceber os conceitos a fundo

A grande ideia: consistência. A IA não se cansa, não se esquece dos coding standards, não salta a documentação. Com as ferramentas certas e supervisão, produz código mais consistente do que humanos a trabalhar manualmente.

Como Começar Hoje

Pronto para experimentar? Eis o teu plano de ação passo a passo:

Passo 1: Instala o Claude Code ou o OpenCode

Escolhe o teu agente de coding:

  • Claude Code (comercial, da Anthropic)
  • OpenCode (alternativa open-source)

Ambos integram com o VS Code e suportam MCP servers.

Passo 2: Configura o WordPress MCP Server

  1. Instala o WordPress MCP server: npx -y @automattic/mcp-wordpress-remote@latest
  2. Configura o teu site WordPress para acesso à API (vais precisar de autenticação JWT)
  3. Adiciona a configuração MCP ao teu agente de coding (vê o exemplo de config acima)

Documentação completa: WordPress MCP Server no GitHub

Passo 3: Constrói o Teu Primeiro Plugin de Teste

Não comeces por um projeto de cliente. Começa por algo simples:

  • Um plugin que adiciona um custom post type
  • Uma página simples de admin settings
  • Um endpoint REST API que vai buscar dados de posts

Assim aprendes o workflow sem pressão.

Passo 4: Faz Deploy para o Site de Staging

Usa a ligação MCP para fazer deploy do plugin de teste para staging. Valida que tudo funciona. Parte coisas de propósito. Aprende a debugar com assistência de IA.

Passo 5: Escala

Quando estiveres à vontade com os básicos, passa a um projeto real. Começa pequeno, mantém a supervisão e ganha confiança.

Workflow Agêntico Supervisionado:

┌─────────────────────────────────────────────────────────────┐
│              SUPERVISED AGENTIC WORKFLOW                    │
└─────────────────────────────────────────────────────────────┘

    ┌──────────────────┐
    │  1. DESCRIBE     │
    │     TASK         │  ← You define requirements
    └────────┬─────────┘
             │
             ↓
    ┌──────────────────┐
    │  2. AI GENERATES │
    │      CODE        │  ← AI writes code
    └────────┬─────────┘
             │
             ↓
    ┌──────────────────┐
    │  3. DEVELOPER    │
    │     REVIEWS      │  ← You read & validate every line
    └────────┬─────────┘
             │
             ↓
    ┌──────────────────┐
    │  4. LOCAL        │
    │     TESTING      │  ← Test on staging via MCP
    └────────┬─────────┘
             │
      ┌──────┴──────┐
      │             │
   Issues?       All good?
      │             │
      └──> FIX ─────┘
             │
             ↓
    ┌──────────────────┐
    │  5. DEPLOY TO    │
    │    PRODUCTION    │  ← Ship with confidence
    └──────────────────┘

Key Principle: YOU maintain control at every step.

O Que Isto Significa Para o Teu Negócio

Vamos ao que interessa:

Para freelancers e agências:

  • Desenvolvimento 10x mais rápido significa que podes aceitar mais clientes ou cobrar preços premium por entregas rápidas
  • Qualidade consistente significa menos tickets de suporte e clientes mais felizes
  • Menos tempo em tarefas chatas significa mais tempo para estratégia e consultoria de alto valor

Para developers in-house:

  • Entregas mais rápidas, e a tua equipa parece estar cheia de rockstars
  • Menos dívida técnica graças a código consistente e revisto
  • Mais tempo livre para arquitetura e inovação

Para donos de negócios:

  • Leva os produtos ao mercado mais depressa
  • Reduz custos de desenvolvimento sem sacrificar qualidade
  • Constrói vantagem competitiva enquanto os outros ainda discutem se adotam IA

A Revolução das Skills (O Que Aí Vem)

Mencionei as agent skills atrás. Esta é a próxima evolução: workflows pré-construídos que ensinam aos agentes de IA as melhores práticas para tarefas específicas em WordPress.

Imagina ter acesso a uma biblioteca de skills do género:

  • “Constrói um sistema de import de produtos WooCommerce”
  • “Cria um plugin de membership com integração de pagamentos”
  • “Monta uma rede multisite com routing custom de subdomínios”

Cada skill codifica conhecimento de expert, coding standards e procedimentos de teste. Vais conseguir combinar skills como blocos de LEGO para construir sistemas complexos em horas em vez de semanas.

Vamos aprofundar as skills em posts futuros, fica atento.

Os Teus Próximos Passos

Eis o que quero que faças agora mesmo:

  1. Monta o teu ambiente seguindo os passos acima
  2. Constrói um plugin de teste usando desenvolvimento agêntico supervisionado
  3. Faz deploy para o teu site de staging e valida que funciona

É isso. Prova a ti próprio que isto funciona. Vais ficar pasmado com a velocidade a que consegues andar.

E se ficares atascado ou quiseres discutir esta abordagem, fala comigo. Estou sempre disponível para ajudar colegas developers de WordPress a subir de nível.

Recursos e Leitura Adicional

Documentação oficial:

Posts relacionados:

Considerações de segurança:

Precisas de Ajuda de um Expert?

Se procuras um developer de WordPress que perceba de desenvolvimento agêntico supervisionado e te possa ajudar a implementar esta abordagem no teu negócio, recomendo o Codeable. Eles validam os developers tanto na competência técnica como na integridade profissional.

Quero falar com um expert sobre isto!

Aviso de afiliação: Isto é um link para o Codeable, uma plataforma onde trabalho há quase 10 anos. Confio em todos os experts que eles aprovam. O link atribui-me como referrer da plataforma.

Tempo de leitura: ~12 minutos