# Desenvolvimento de blocos nativo para IA

Arquivos e nenhuma etapa de build: exatamente o que os agentes fazem bem.

[Leia a documentação](https://blockstudio.dev/pt/docs/dev/ai/)

Uma gravação silenciosa da tela: um agente de programação cria um site WordPress completo, com 10 blocos personalizados e 6 páginas, a partir de um único prompt.

## Descreva um bloco, receba um bloco

Agentes de programação com IA podem criar a estrutura de blocos, páginas e padrões com um único prompt. Sem interface gráfica nem banco de dados: apenas arquivos.

~/starter-theme

❯ Crie um bloco de preços com três níveis, uma alternância entre mensal e anual e uma CTA para cada nível.

✓ Criado em pricing/block.json

✓ Criado em pricing/index.php

✓ Criado em pricing/style.css

❯ Agora crie uma página de preços com uma seção principal e uma de perguntas frequentes.

✓ Criado em pages/pricing/page.json

✓ Criado em pages/pricing/index.php

Arquivos

blockstudio/

├── pricing/ Novo

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Novo

├── page.json

└── index.php

## Tudo baseado em arquivos

Blocos, páginas, padrões e extensões são diretórios com configurações e modelos JSON. Agentes leem e gravam neles nativamente.

## Sem configuração de banco de dados

Sem painéis administrativos para navegar. Cada configuração é uma chave JSON, então um agente pode estruturar a biblioteca sem navegador.

## Estrutura previsível

Todos os blocos seguem a mesma convenção: block.json, um modelo e estilos opcionais. Aprenda o padrão uma vez.

## Contexto, sem suposições

Um índice compacto da documentação, além do texto completo para ferramentas que precisam de tudo.

### Um índice que o agente lê primeiro

`blockstudio-llm.txt` lista cada documento uma vez, com sua rota, arquivo de origem, finalidade e as configurações, hooks, funções PHP e comandos CLI que ele possui. Com cerca de 11k tokens, um agente o lê por inteiro e abre apenas a página necessária.

`blockstudio-llm-full.txt` reúne todos os documentos e todos os esquemas JSON em um arquivo, com cerca de 169k tokens, para ferramentas que precisam do corpus completo. Ative `ai.enableContextGeneration` e seu site servirá ambos.

[Documentação de integração com IA](https://blockstudio.dev/pt/docs/dev/ai/)

blockstudio-llm.txt

```
# Blockstudio documentation index

This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.

Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.
```

## Um contrato para seu projeto

A documentação descreve Blockstudio. AGENTS.md descreve o projeto que o agente está prestes a alterar.

### Um comando grava AGENTS.md

`vendor/bin/blockstudio-agents` descreve o projeto em que é executado: o que contém, quais recursos `blockstudio.json` habilita, o que a análise rejeitará e quais comandos se aplicam.

Cada linha vem dos seus arquivos, configurações ou da predefinição de análise selecionada. Gerar novamente preserva as notas escritas manualmente, e `--check` falha quando o contrato está desatualizado.

[Contrato do projeto](https://blockstudio.dev/pt/docs/dev/phpstan/#project-contract-for-coding-agents)

AGENTS.md

```
# Blockstudio contract for Acme

## Project

- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.

## What this project contains

- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.
```

## Erros detectados antes do commit

Quatro predefinições de análise, cada uma abrangendo a anterior, e um hook que as executa em cada commit.

### Análise que conhece block.json

As predefinições `blockstudio/phpstan` leem seus blocos, páginas e configurações. Se um modelo lê um campo que seu `block.json` não declarou ou o exibe sem escape, a análise falha.

Os modelos leem um `$a` tipado a partir do `block.json` ao lado deles, com um tipo PHP específico para cada tipo de campo, e `Db::get()` retorna registros estruturados por `db.php`. Um caminho de configuração ou nome de hook digitado incorretamente gera um erro com sugestão do nome real mais próximo.

Configure `githooks.commit` e execute `vendor/bin/blockstudio-githooks sync`: o hook de pré-commit gerenciado executa a mesma análise, impedindo que um bloco com erros chegue ao commit.

[Predefinições de análise](https://blockstudio.dev/pt/docs/dev/phpstan/#analysis-presets)

blockstudio.json

```
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}
```

## [base](https://blockstudio.dev/pt/docs/dev/phpstan/#analysis-presets)

Toda chave $a lida por um modelo existe em block.json; hooks, caminhos de configurações e tags de bloco são reais.

## [theme](https://blockstudio.dev/pt/docs/dev/phpstan/#analysis-presets)

Cabeçalhos de tema, recursos declarados, escopo %selector%, valores padrão dos campos e limites de repetidores.

## [extreme-theme](https://blockstudio.dev/pt/docs/dev/phpstan/#analysis-presets)

Máximo PHPStan, saída escapada, sem execução de comandos no shell, classes Tailwind válidas e JavaScript limpo.

## [wordpress-render](https://blockstudio.dev/pt/docs/dev/phpstan/#live-wordpress-rendering)

Tema Extreme com uma sonda de renderização WordPress em tempo real fornecida por você. Ela é executada sem shell, e uma falha de renderização gera um apontamento.

## [Twig, Blade e scripts](https://blockstudio.dev/pt/docs/dev/phpstan/#what-it-checks)

Twig, Blade e as tags de bloco são verificados em relação aos mesmos campos. A camada Extreme também verifica JavaScript e as diretivas de Interactivity em relação à sua marcação e aos dados armazenados.

## [Projetos existentes](https://blockstudio.dev/pt/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Uma linha de base PHPStan mantém os apontamentos registrados em espera enquanto o novo código atende ao preset completo. blockstudioScanRoots lê bibliotecas de blocos fora da raiz, e os stubs incluídos tipam a API pública API.

## Inventário e renderização de PHP

Com algumas chamadas, um agente pode ver o que um projeto registra, renderizar qualquer parte dele e verificar o que foi armazenado.

### Consulte o projeto e renderize a resposta

`Canvas::inventory()` retorna todas as páginas, blocos, padrões, modelos do Editor do site, partes de modelo e exemplos UI registrados por um projeto, sem renderizar nada.

`Render::document()` renderiza qualquer um deles como um documento HTML completo, incluindo exatamente os recursos utilizados, para que um agente possa verificar o trabalho fora do editor.

`Canvas::documents()` renderiza exatamente os registros que você seleciona. `Render::composition()` e `Render::content()` retornam declarações aninhadas ou conteúdo de bloco serializado como HTML, e `Ui::inventory()` e `Ui::examples()` listam as famílias de componentes incluídas, com uma declaração renderizável para cada uma.

Para um bloco, `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` e `bs_block_assets()` retornam seus campos, valores e recursos sem renderizá-lo, e `bs_validate_block()` verifica os atributos armazenados antes que você os salve.

[Renderização programática](https://blockstudio.dev/pt/docs/blocks/rendering/#structured-compositions-and-complete-documents)

inspect.php

```
use Blockstudio\Canvas;
use Blockstudio\Render;

$project = Canvas::inventory(['blocks' => true]);

foreach ($project['inventory']['blocks'] as $block) {
  echo $block['name'] . "\n";
}

$doc = Render::document(
  ['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
  ['title' => 'Hero preview']
);

file_put_contents('hero.html', $doc['html']);
```

## Menos da metade dos tokens por página

Agentes escrevem HTML simples. Na sincronização, Blockstudio o transforma em marcação de bloco WordPress serializada: menos para gerar e menos chances de errar.

### Blockstudio

O que os agentes escrevem

Cerca de 135 tokens

index.php

```
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>

<block name="core/columns">
  <block name="core/column">
    <h3>Lightning Fast</h3>
    <p>Pages load in under one second.</p>
  </block>
  <block name="core/column">
    <h3>Easy to Use</h3>
    <p>No technical skills required.</p>
  </block>
  <block name="core/column">
    <h3>SEO Optimized</h3>
    <p>Built-in best practices from day one.</p>
  </block>
</block>

<img src="/dashboard.jpg" alt="Dashboard" />
```

### WordPress

O que o analisador escreve para isso

Cerca de 310 tokens

post_content

```
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Lightning Fast</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Pages load in under one second.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Easy to Use</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>No technical skills required.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">SEO Optimized</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Built-in best practices from day one.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->
```

Medição dos dois painéis acima: 540 caracteres de HTML, comparados aos 1,233 caracteres da marcação de bloco que o analisador padrão escreve para isso; o resultado é dividido por quatro, a estimativa habitual de caracteres por token. A marcação é exibida com quebras de linha para facilitar a leitura.

## Menos saída para gerar

Agentes escrevem HTML sem delimitadores de bloco, classes geradas ou marcação de contêiner.

## Menos chances de errar

O analisador garante uma saída de bloco válida a partir da entrada mais simples.

## Mais rápido e econômico

Menos tokens de saída significam respostas mais rápidas e custos menores com modelos.

## Compatível com todas as ferramentas de programação com IA

Qualquer agente capaz de ler e gravar arquivos funciona com Blockstudio imediatamente.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Feito para o fluxo de trabalho com IA

Blocos, páginas, padrões, configurações. Tudo é um arquivo que um agente pode ler, gravar e modificar.

## Dois arquivos por bloco

Uma configuração JSON e um modelo compõem todo o bloco. A superfície reduzida torna confiável a geração na primeira tentativa.

## 27 tipos de campo

Texto, arquivos, repetidores, cores, datas e muito mais, definidos em JSON. As opções são preenchidas com publicações, termos e usuários.

## Validação de esquema JSON

Toda configuração tem um esquema, que fornece regras exatas aos agentes e detecta erros imediatamente.

## Registro automático

Coloque arquivos em um diretório e os blocos serão registrados automaticamente, sem outra lista de configurações.

## Visão geral da tela

Todas as páginas gerenciadas, ou todos os blocos com seus valores padrão, em uma única visualização com zoom.

## Tela de trabalho ao vivo

O modo ao vivo atualiza as pranchetas afetadas por Server-Sent Events cerca de um segundo após salvar. Clique em um rótulo para focar uma prancheta.

## Tailwind integrado

TailwindPHP compila as classes usadas em cada página, sem configuração de Node.

## Element Grabber

Copie o caminho do modelo e a marcação de um elemento para dar contexto imediato a um agente.

## HTML para blocos

Páginas e padrões são arquivos simples que se tornam blocos WordPress nativos.

## Teste rápido de renderização

wp bs blocks render renderiza cada bloco como uma página e encerra com 1 quando um modelo gera um aviso, uma advertência ou um erro.

## Verificações de conteúdo armazenado

wp bs blocks validate verifica os campos salvos das publicações, e pages sync avisa sobre atributos que um bloco armazena, mas nunca renderiza.

## Inspecione pelo terminal

Liste configurações, campos personalizados e recursos com wp bs, e compile um trecho ou arquivo com wp bs tailwind compile ou wp bs scss compile.

Plus

## O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord

[Obter Plus](https://blockstudio.dev/pt/plus/)
