Programação com IA de Blockstudio
Andrej Karpathy cunhou o termo “vibe coding” em fevereiro 2025 para descrever um fluxo de trabalho em que você explica à IA o que quer e ela escreve o código. Um ano depois, a prática amadureceu e se tornou o que ele agora chama de “engenharia agêntica”: desenvolvedores coordenando agentes de IA em vez de escrever código linha por linha.
Blockstudio foi criado para isso. Sua arquitetura baseada em arquivos, a ausência de ferramentas de compilação e a estrutura previsível do projeto fazem dele um dos melhores ambientes para o desenvolvimento WordPress assistido por IA.
Este guia aborda padrões práticos para usar agentes de programação com IA no Blockstudio, desde a configuração do projeto até a geração de sites completos.
Por que Blockstudio funciona bem com agentes de IA
Arquivos, não bancos de dados
Agentes de programação com IA leem e escrevem arquivos. Essa é a interface principal deles. Blockstudio mantém tudo no sistema de arquivos: um block.json e um arquivo de modelo por bloco, um page.json por página, um pattern.json por padrão. Não há entradas de banco de dados para gerenciar, nenhuma UI administrativa para percorrer com cliques, nem etapa de compilação para executar.
Isso importa porque sistemas de arquivos e comandos de shell representam algumas das maiores fontes de dados de pré-treinamento para LLMs. Todos os modelos já viram milhões de exemplos de leitura, escrita e organização de arquivos. Quando seu fluxo de trabalho de desenvolvimento com WordPress corresponde a essa interface, os agentes conseguem trabalhar com instruções mínimas.
Estrutura previsível
Todos os blocos Blockstudio seguem o mesmo padrão:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Essa consistência significa que um agente que já criou um bloco consegue criar cem. Não há surpresas, casos especiais nem configurações ocultas. O mesmo padrão vale para páginas (page.json + modelo), padrões (pattern.json + modelo) e extensões (extend.json).
Páginas completas como arquivos
A criação tradicional de páginas WordPress exige o editor de blocos: arrastar blocos, configurar opções e salvar pelo painel administrativo. Agentes de IA não conseguem fazer nada disso. Eles precisam de arquivos.
As páginas baseadas em arquivos do Blockstudio resolvem isso por completo. Um page.json define os metadados da página, e um modelo index.php define a estrutura dos blocos usando HTML:
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
<h1 blockEditingMode="contentOnly">About Us</h1>
<p blockEditingMode="contentOnly">Our story.</p>
</block>
<div key="team">
<h2>The Team</h2>
<block name="my/team-member" />
<block name="my/team-member" />
</div>
Um agente pode estruturar uma página WordPress inteira, com blocos principais e personalizados, bloqueio de modelo e controles de edição, escrevendo apenas dois arquivos. Execute wp bs pages sync para aplicar o código-fonte a WordPress; abrir o painel administrativo não realiza essa sincronização automaticamente.
Esse é um dos recursos mais poderosos para o desenvolvimento assistido por IA. Em vez de descrever o layout de uma página e montá-la manualmente no editor, você o descreve a um agente e ele escreve o modelo. O resultado fica sob controle de versão, é reproduzível e pode ser iterado em segundos.
Sem etapa de compilação
Não há nada para compilar, empacotar ou transpil ar. Um agente cria um arquivo e ele funciona imediatamente. SCSS é compilado no servidor. Os módulos ES são resolvidos em tempo de execução. Tailwind CSS é compilado a cada solicitação do frontend. O ciclo de feedback entre “o agente escreve o código” e “o código roda no navegador” é o mais curto possível.
Por que Tailwind CSS é a escolha certa
Blockstudio oferece suporte tanto a CSS convencional quanto a Tailwind CSS, mas Tailwind tem uma vantagem significativa ao trabalhar com agentes de IA.
Os LLMs conhecem muito bem Tailwind
Tailwind CSS é usado em dezenas de milhares de repositórios de código aberto. Ele alimenta as interfaces de Claude.ai, Vercel, Shopify, Cursor e dos próprios produtos da OpenAI. Essa presença nos dados de treinamento faz com que os LLMs gerem classes Tailwind com alta precisão e raramente inventem utilitários inexistentes.
O vocabulário de classes é finito e bem definido. Um agente não pode inventar uma propriedade CSS inexistente, o que reduz drasticamente os erros de estilo em comparação com CSS livre, em que o agente poderia gerar seletores inválidos ou interpretar mal o comportamento da cascata.
Os estilos ficam na marcação
Com Tailwind, todas as informações de estilo ficam junto do modelo HTML. O agente vê em um só lugar a descrição visual completa de um elemento. Não é preciso consultar arquivos .css separados, entender a ordem da cascata nem acompanhar conflitos de especificidade.
Isso é especialmente poderoso para blocos Blockstudio, cujo modelo já é um único arquivo. O agente pode gerar um componente completo e estilizado em uma só etapa:
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
<h2 class="text-2xl font-bold text-gray-900">
<?php echo $a['title']; ?>
</h2>
<p class="mt-4 text-gray-600 leading-relaxed">
<?php echo $a['description']; ?>
</p>
</div>
Agentes paralelos sem conflitos
Como os estilos Tailwind têm escopo restrito a cada modelo, vários agentes (ou desenvolvedores) podem trabalhar simultaneamente em blocos diferentes sem CSS conflitos de mesclagem. Não há uma folha de estilos compartilhada em que alterações em um componente acabem quebrando outro. Cada bloco é independente.
Isso também funciona bem com CSS convencional ao usar os estilos com escopo restrito de Blockstudio (style.scoped.css), mas Tailwind elimina totalmente o arquivo CSS, o que significa um arquivo a menos para o agente gerenciar por bloco.
CSS convencional também funciona
Tailwind não é obrigatório. O pipeline de recursos de Blockstudio processa arquivos .css e .scss automaticamente, inclusive estilos com escopo restrito ao bloco. Se seu projeto usa outra metodologia de CSS, os agentes também podem trabalhar com ela. A vantagem de Tailwind é simplesmente que os LLMs lidam melhor com ele graças à cobertura nos dados de treinamento e à proximidade dos estilos com a marcação.
Agentes de programação com IA
As seguintes ferramentas de CLI podem trabalhar com projetos Blockstudio sem configuração adicional. Elas leem e escrevem arquivos, executam comandos de shell e entendem a estrutura do projeto a partir de arquivos de contexto.
Agentes de terminal (CLI)
| Ferramenta | Provedor | Observações |
|---|---|---|
| Claude Code | Anthropic | Agente voltado ao terminal. Lê CLAUDE.md para obter contexto do projeto. |
| Codex CLI | OpenAI | CLI de código aberto criado em Rust. Também disponível como aplicativo para computador. |
| Gemini CLI | De código aberto, com janela de contexto de 1M tokens. Lê GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Agentes paralelos especializados em exploração, tarefas, planejamento e revisão. |
| Aider | Código aberto | Compatível com mais de 100 provedores de LLM, incluindo modelos locais. |
| OpenCode | Código aberto | TUI de terminal com integração LSP. Compatível com mais de 75 provedores. |
| Amazon Q Developer CLI | AWS | Plano gratuito disponível. Excelente para projetos integrados ao AWS. |
Agentes para IDEs
| Ferramenta | Provedor | Observações |
|---|---|---|
| Cursor | Cursor | Fork do VS Code com IA integrada. Também tem um CLI (beta). |
| Windsurf | Cognition AI | Fork do VS Code com assistente agêntico Cascade. |
| Cline | Código aberto | Extensão VS Code com aprovação etapa por etapa. Também tem um CLI. |
| Kilo Code | Código aberto | Modo de orquestração com subagentes coordenados. |
| Continue | Código aberto | Extensão VS Code/JetBrains com agentes assíncronos de CI/CD. |
| Augment Code | Augment | Voltado a empresas, com indexação aprofundada da base de código. |
Todas essas ferramentas podem criar e editar arquivos em um diretório de projeto Blockstudio. Os agentes de terminal são particularmente adequados porque o desenvolvimento Blockstudio não exige recursos específicos de IDE: é totalmente baseado em arquivos.
Configurando seu projeto para agentes de IA
O arquivo de contexto do LLM
Blockstudio inclui um arquivo de contexto pronto que indexa a documentação completa do framework. Não é um resumo nem um guia de consulta rápida: cada documento aparece uma vez, com sua rota, finalidade e identificadores correspondentes, para que um agente encontre a página que responde à pergunta e abra somente ela. O texto integral de cada documento e esquema continua disponível em um segundo arquivo para ferramentas que precisam de todo o conteúdo de uma só vez.
Ative-o no seu blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
O índice agora está disponível em your-site.com/blockstudio-llm.txt, e o texto integral em your-site.com/blockstudio-llm-full.txt. Indique o índice à sua ferramenta de IA e ela poderá acessar todo o Blockstudio API sem instruções adicionais. Consulte a documentação de integração com IA para ver a configuração específica de cada ferramenta.
Isso dispensa escrever instruções específicas para o framework. Um agente com acesso a blockstudio-llm.txt pode descobrir como criar blocos, definir campos, escrever modelos, configurar Tailwind, preparar páginas e usar todos os hooks oferecidos por Blockstudio.
Arquivos de contexto específicos do projeto
A maioria dos agentes de programação com IA também lê um arquivo de contexto no nível do projeto com instruções específicas para sua base de código. A convenção varia de acordo com a ferramenta:
| Arquivo | Ferramenta |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI e outras |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Como blockstudio-llm.txt já cobre o framework, o arquivo de contexto do projeto só precisa descrever o que é exclusivo dele: estrutura de diretórios, convenções de nomenclatura, comandos e limites.
Se você instalar blockstudio/phpstan, não precisará escrever essa descrição manualmente. vendor/bin/blockstudio-agents gera um AGENTS.md a partir do seu blockstudio.json e dos seus próprios arquivos, indicando o que o projeto cria, quais recursos estão ativados, o que a análise rejeitará e quais comandos se aplicam. Ele se recusa a sobrescrever um arquivo que não criou e preserva suas anotações quando você o gera novamente.
# My WordPress Site
Built with Blockstudio 7. File-based blocks with Tailwind CSS.
Fetch https://example.com/blockstudio-llm.txt for full framework docs.
## Structure
- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings
## Conventions
- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates
## Commands
- `wp server` - Start local development server
Ferramentas de desenvolvimento para fluxos de trabalho com IA
Blockstudio inclui duas ferramentas de desenvolvimento projetadas especificamente para o desenvolvimento assistido por IA.
Canvas
O canvas oferece uma visão geral, semelhante a um Figma, de todas as páginas Blockstudio, renderizadas como quadros de trabalho em iframes ativos em uma única visualização. Desloque a tela com o trackpad e aproxime ou afaste com o gesto de pinça ou Ctrl+rolagem.
Isso é útil ao trabalhar com agentes de IA porque oferece uma visão geral de todas as páginas sem trocar de aba nem navegar pelo painel administrativo WordPress. Quando um agente modifica um modelo de página, você vê o resultado imediatamente. Ative o modo ao vivo para que o canvas seja atualizado automaticamente quando os arquivos mudarem.
Ative-o em blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Depois, acesse /wp-admin/admin.php?page=blockstudio-canvas. Alterne entre a visualização de páginas (quadros de trabalho em largura total) e a visualização de blocos (grade de todos os blocos registrados com valores padrão).
Element Grabber
O seletor de elementos resolve um problema comum nos fluxos de trabalho com IA: informar ao agente qual arquivo renderiza um elemento específico da página.
Adicione ?blockstudio-devtools a qualquer URL do frontend e mantenha pressionado Cmd+C (Mac) ou Ctrl+C (Windows) por 100ms. Um seletor em forma de mira é ativado e destaca os blocos Blockstudio enquanto você passa o cursor. Clique em um elemento para copiar seu contexto para a área de transferência:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Cole isso na sua ferramenta de programação com IA e o agente saberá imediatamente o caminho do arquivo, a estrutura HTML e o elemento para o qual você está apontando. Chega de procurar manualmente os caminhos dos arquivos de modelo.
Ative-o em blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Padrões práticos
Criando um bloco
O fluxo de trabalho mais simples: descreva o que você quer e deixe o agente criar.
Prompt:
Crie um bloco de depoimento com campos para o depoimento (textarea), o nome do autor (texto), o cargo do autor (texto) e a foto do autor (arquivos). Use Tailwind para a estilização. O depoimento deve usar uma fonte grande e itálica, com uma aspa decorativa.
O agente criará:
blockstudio/testimonial/
├── block.json
└── index.php
Criando uma página completa
As páginas baseadas em arquivos do Blockstudio permitem que um agente estruture uma página WordPress inteira como modelo. É aí que está o verdadeiro ganho: em vez de criar blocos um por um, o agente monta toda a estrutura da página com todos os blocos em uma só etapa.
Prompt:
Crie uma página “Sobre” com uma seção principal, uma grade da equipe e um formulário de contato como espaço reservado. Use os blocos existentes sempre que possível e crie novos quando necessário. Associe-a ao post ID 2. Bloqueie o modelo, mas permita editar o conteúdo dos títulos e parágrafos.
O agente cria:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Além dos blocos personalizados aos quais fizer referência (e.g., blockstudio/team-member/). Execute
wp bs pages sync para criar o post WordPress com o bloqueio do modelo e
os controles de edição. A página inteira fica sob controle de versão e é reproduzível.
Criando um site completo
É aqui que a arquitetura do Blockstudio realmente se destaca. Um único prompt pode gerar um site inteiro, pois cada elemento é um arquivo:
Prompt:
Crie um site de portfólio com estas páginas: Início, Trabalho, Sobre, Contato. Crie blocos personalizados para: seção principal, grade de projetos, cartão de projeto, integrante da equipe, informações de contato e rodapé. Use um tema escuro com Tailwind. Configure Tailwind em blockstudio.json com uma paleta de cores personalizada.
O agente cria os diretórios dos blocos, os modelos de página, um blockstudio.json com a configuração Tailwind e, opcionalmente, padrões para seções reutilizáveis. Tudo é enviado para git como um único conjunto de alterações.
Fluxos de trabalho com agentes em paralelo
Algumas ferramentas (o aplicativo para computador Codex, GitHub Copilot CLI, Kilo Code) permitem executar vários agentes em paralelo. A arquitetura do Blockstudio, com um arquivo por bloco, torna isso seguro:
- Agente 1: cria o bloco principal e a página inicial
- Agente 2: cria o bloco de cartão de projeto e a página de trabalho
- Agente 3: cria o bloco do formulário de contato e a página de contato
Como cada bloco tem seu próprio diretório e os estilos Tailwind ficam junto dos modelos, esses agentes não entrarão em conflito. O único arquivo compartilhado é blockstudio.json, que normalmente só precisa ser configurado uma vez, no início.
Dicas para obter melhores resultados
-
Indique o arquivo de contexto do LLM. Os agentes produzem código Blockstudio significativamente melhor quando conseguem acessar a documentação do framework. Sempre indique
blockstudio-llm.txte forneça umAGENTS.mdgerado para o próprio projeto. -
Seja específico quanto aos tipos de campo. Em vez de "adicione um campo de imagem", diga "adicione um campo de arquivos com
allowedTypes: ['image']ereturnFormat: 'object'". Quanto mais precisas forem as definições dos campos, menos iterações serão necessárias. -
Comece com um bloco e depois amplie. Peça ao agente para criar um bloco corretamente, revise seus padrões e depois peça que crie os demais seguindo as mesmas convenções. Isso estabelece uma referência que melhora os resultados seguintes.
-
Revise o resultado. Vibe coding não significa aceitar código às cegas. Confira se os tipos de campo correspondem ao que você espera, se os modelos são renderizados corretamente e se as classes Tailwind produzem o resultado visual desejado. O código gerado por IA deve ser revisado antes de ser publicado.
-
Use esquemas
block.json. Blockstudio fornece um esquema JSON emhttps://blockstudio.dev/schema/block. Adicionar"$schema"ao seu block.json oferece aos agentes feedback de validação e evita configurações malformadas. -
Mantenha os blocos pequenos e focados. Use um bloco por componente visual. Assim, fica mais fácil para o agente raciocinar sobre cada bloco e os modelos permanecem curtos o bastante para caber em uma única passagem pela janela de contexto.