# Vývoj bloků nativní pro AI

Soubory a žádný krok sestavení – přesně to agentům vyhovuje.

[Přečíst dokumentaci](https://blockstudio.dev/cs/docs/dev/ai/)

Němý záznam obrazovky: kódovací agent vytvoří kompletní web WordPress s 10 vlastními bloky a 6 stránkami na základě jediného zadání.

## Popište blok, získejte blok

Kódovací agenti s umělou inteligencí mohou z jediného zadání připravit kostru bloků, stránek a vzorů. Bez grafického rozhraní a databáze, jen soubory.

~/starter-theme

❯ Vytvořte cenový blok se třemi tarify, přepínačem měsíční/roční platby a výzvou k akci pro každý tarif.

✓ Vytvořeno pricing/block.json

✓ Vytvořeno pricing/index.php

✓ Vytvořeno pricing/style.css

❯ Teď vytvořte stránku s cenami, úvodní sekcí a sekcí FAQ.

✓ Vytvořeno pages/pricing/page.json

✓ Vytvořeno pages/pricing/index.php

Soubory

blockstudio/

├── pricing/ Nové

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Nové

├── page.json

└── index.php

## Všechno založené na souborech

Bloky, stránky, vzory a rozšíření jsou adresáře s konfigurací JSON a šablonami. Agenti je přirozeně čtou a upravují.

## Bez konfigurace databáze

Žádné proklikávání administračních panelů. Každé nastavení je klíč JSON, takže agent může připravit knihovnu bez prohlížeče.

## Předvídatelná struktura

Každý blok se řídí stejnou konvencí: block.json, šablona a volitelné styly. Naučte se tento vzor jednou.

## Kontext místo odhadů

Stručný index dokumentace a celý text pro nástroje, které jej potřebují kompletní.

### Index, který agent přečte jako první

`blockstudio-llm.txt` uvádí každý dokument jednou, včetně jeho trasy, zdrojového souboru, účelu a nastavení, hooků, funkcí PHP a příkazů CLI, které spravuje. Při velikosti asi 11k tokenů jej agent přečte celý a pak otevře jen potřebnou stránku.

`blockstudio-llm-full.txt` obsahuje každý dokument a schéma JSON v jednom souboru o velikosti asi 169k tokenů pro nástroje, které potřebují celý korpus. Zapněte `ai.enableContextGeneration` a váš web bude poskytovat obojí.

[Dokumentace k integraci AI](https://blockstudio.dev/cs/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.
```

## Smlouva pro váš projekt

Dokumentace popisuje Blockstudio. AGENTS.md popisuje projekt, který se agent chystá změnit.

### Jeden příkaz vytvoří AGENTS.md

`vendor/bin/blockstudio-agents` popisuje projekt, ve kterém běží: jeho obsah, funkce, které `blockstudio.json` povoluje, co analýza odmítne a příslušné příkazy.

Každý řádek vychází z vašich souborů, nastavení nebo zvolené předvolby analýzy. Opětovné vygenerování zachová ručně napsané poznámky a `--check` selže, pokud je smlouva zastaralá.

[Smlouva projektu](https://blockstudio.dev/cs/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.
```

## Chyby zachycené před potvrzením

Čtyři předvolby analýzy, z nichž každá zahrnuje předchozí, a hook, který je spustí při každém commitu.

### Analýza, která zná block.json

Předvolby `blockstudio/phpstan` čtou vaše bloky, stránky a nastavení. Analýza selže, pokud šablona čte pole, které její `block.json` nedeklarovalo, nebo jej vypíše bez escapování.

Šablony čtou typovaný `$a` načtený z přilehlého `block.json`, s konkrétním typem PHP pro každý typ pole, a `Db::get()` vrací záznamy odpovídající struktuře `db.php`. Při překlepu v cestě k nastavení nebo názvu hooku se zobrazí návrh nejbližšího existujícího názvu.

Nastavte `githooks.commit` a spusťte `vendor/bin/blockstudio-githooks sync`: spravovaný hook před potvrzením spustí stejnou analýzu, takže se chybný blok nikdy nedostane do commitu.

[Předvolby analýzy](https://blockstudio.dev/cs/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Každý klíč $a, který šablona čte, existuje v block.json; hooky, cesty nastavení a značky bloků jsou skutečné.

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

Hlavičky šablon, deklarované prostředky, rozsah %selector%, výchozí hodnoty polí a limity opakovačů.

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

Maximum PHPStan, escapovaný výstup, žádné spouštění shellu, platné třídy Tailwind a čisté JavaScript.

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

Šablona Extreme a živá renderovací sonda WordPress, kterou dodáte. Spouští se bez shellu a neúspěšné vykreslení se zaznamená jako nález.

## [Twig, Blade a skripty](https://blockstudio.dev/cs/docs/dev/phpstan/#what-it-checks)

Twig, Blade i značky bloků se kontrolují podle stejných polí. Vrstva Extreme také porovnává JavaScript a direktivy Interactivity s vaším značkováním a úložišti.

## [Stávající projekty](https://blockstudio.dev/cs/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Základní konfigurace PHPStan potlačí dříve zaznamenané nálezy, zatímco nový kód musí splňovat celý profil. blockstudioScanRoots načítá knihovny bloků mimo kořenovou složku a přibalené definice typů pokrývají veřejné API.

## Inventář a vykreslování z PHP

Několik volání umožní agentovi zjistit, co projekt registruje, vykreslit libovolnou jeho část a zkontrolovat, co uložil.

### Zeptejte se na projekt, vykreslete odpověď

`Canvas::inventory()` vrací každou stránku, blok, vzor, šablonu editoru webu, část šablony a příklad UI registrovaný projektem, aniž by cokoli vykreslovalo.

`Render::document()` vykreslí kteroukoli z nich jako kompletní dokument HTML s přesně těmi prostředky, které použil, takže agent může zkontrolovat svou práci mimo editor.

`Canvas::documents()` vykreslí přesně ty záznamy, které vyberete. `Render::composition()` a `Render::content()` vracejí vnořené deklarace nebo serializovaný obsah bloku jako HTML a `Ui::inventory()` a `Ui::examples()` vypisují rodiny přibalených komponent, každou s jednou deklarací připravenou k vykreslení.

Pro jeden blok vracejí `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` a `bs_block_assets()` jeho pole, hodnoty a assety, aniž by jej vykreslily; `bs_validate_block()` kontroluje uložené atributy před jejich uložením.

[Programové vykreslování](https://blockstudio.dev/cs/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']);
```

## Méně než polovina tokenů na stránku

Agenti píší prosté HTML. Blockstudio je při synchronizaci převede na serializované značky bloků WordPress: méně kódu ke generování a méně prostoru pro chyby.

### Blockstudio

Co zapisují agenti

Přibližně 135 tokenů

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

Co pro něj zapisuje parser

Přibližně 310 tokenů

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 -->
```

Měřeno na dvou panelech výše: 540 znaků HTML oproti 1,233 znakům značek bloku, které pro něj zapisuje standardní parser; výsledek se dělí čtyřmi, což je obvyklý odhad počtu znaků na token. Značky jsou zobrazené s přidanými zalomeními řádků pro lepší čitelnost.

## Méně výstupu ke generování

Agenti píší HTML bez oddělovačů bloků, generovaných tříd a obalových značek.

## Méně prostoru pro chyby

Parser z jednoduššího vstupu zaručí platný výstup bloku.

## Rychlejší a levnější

Méně výstupních tokenů znamená rychlejší odpovědi a nižší náklady na model.

## Funguje s každým nástrojem AI pro programování

Každý agent, který umí číst a zapisovat soubory, funguje s Blockstudio ihned po instalaci.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Navrženo pro pracovní postupy s AI

Bloky, stránky, vzory, nastavení. Všechno je soubor, který agent může číst, zapisovat a upravovat.

## Dva soubory na blok

Konfigurace JSON a šablona tvoří celý blok. Malý rozsah zajišťuje spolehlivé generování napoprvé.

## 27 typů polí

Text, soubory, opakovače, barvy, data a další položky definované v JSON. Výběrová pole čerpají možnosti z příspěvků, termínů a uživatelů.

## Ověřování schématu JSON

Každá konfigurace má schéma, které agentům poskytuje přesná pravidla a okamžitě zachytí chyby.

## Automatická registrace

Vložte soubory do adresáře a bloky se zaregistrují automaticky bez dalšího seznamu konfigurace.

## Přehled plátna

Všechny spravované stránky, případně všechny bloky včetně jejich výchozích hodnot, v jednom zobrazení s možností přibližování.

## Živé plátno

Živý režim obnoví dotčená kreslicí plátna prostřednictvím Server-Sent Events zhruba sekundu po uložení. Kliknutím na popisek zaměříte jedno kreslicí plátno.

## Vestavěné Tailwind

TailwindPHP kompiluje třídy použité na každé stránce bez konfigurace Node.

## Element Grabber

Zkopírujte cestu k šabloně a značky prvku jako okamžitý kontext pro agenta.

## HTML na bloky

Stránky a vzory jsou obyčejné soubory, které se mění v nativní bloky WordPress.

## Testovací vykreslení

wp bs blocks render vykreslí každý blok stejně jako stránka a skončí s kódem 1, pokud šablona vyvolá oznámení, varování nebo chybu.

## Kontroly uloženého obsahu

wp bs blocks validate kontroluje uložená pole příspěvků a stránek; sync upozorní na atributy, které blok ukládá, ale nikdy nevykreslí.

## Kontrola z terminálu

Vypište nastavení, vlastní pole a assety pomocí wp bs a zkompilujte úryvek nebo soubor příkazem wp bs tailwind compile či wp bs scss compile.

Plus

## Oficiální sada rozšíření

Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.

- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord

[Získat Plus](https://blockstudio.dev/cs/plus/)
