Перейти до вмісту

Розробка блоків для ШІ

Файли й відсутність етапу збірки — саме з цим агенти добре дають раду.

Запис екрана без звуку: агент для програмування створює повний сайт WordPress із 10 власними блоками та 6 сторінками за одним запитом.

Опишіть блок — отримайте блок

Агенти ШІ для програмування можуть створювати заготовки блоків, сторінок і шаблонів за одним запитом. Без графічного інтерфейсу й бази даних — лише файли.

~/starter-theme

❯ Створіть блок цін із трьома тарифами, перемикачем місячної/річної оплати та закликом до дії для кожного тарифу.

✓ Створено pricing/block.json

✓ Створено pricing/index.php

✓ Створено pricing/style.css

❯ Тепер створіть сторінку з цінами, головним блоком і розділом поширених запитань.

✓ Створено pages/pricing/page.json

✓ Створено pages/pricing/index.php

Файли

blockstudio/

├── pricing/ Нове

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Нове

├── page.json

└── index.php

Усе у файлах

Блоки, сторінки, патерни та розширення — це каталоги з конфігурацією JSON і шаблонами. Агенти нативно читають і редагують їх.

Без налаштування бази даних

Не потрібно переходити між панелями адміністратора. Кожен параметр — це ключ JSON, тож агент може створити структуру бібліотеки без браузера.

Передбачувана структура

Кожен блок відповідає одній конвенції: block.json, шаблон і необов’язкові стилі. Достатньо один раз засвоїти цей принцип.

Контекст, а не здогадки

Стислий індекс документації та повний текст для інструментів, яким потрібна вся інформація.

Індекс, який агент читає спочатку

blockstudio-llm.txt містить перелік усіх документів із маршрутами, вихідними файлами, призначенням, параметрами, хуками, функціями PHP та командами CLI, за які вони відповідають. Індекс обсягом близько 11k токенів агент може прочитати повністю, а потім відкрити лише потрібну сторінку.

blockstudio-llm-full.txt містить усі документи й схему JSON в одному файлі обсягом близько 169k токенів — для інструментів, яким потрібен увесь корпус. Увімкніть ai.enableContextGeneration, і ваш сайт надаватиме обидва файли.

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.

Контракт для вашого проєкту

Документація описує Blockstudio. AGENTS.md описує проєкт, який агент збирається змінити.

Одна команда створює AGENTS.md

vendor/bin/blockstudio-agents описує проєкт, у якому працює: що він містить, які можливості вмикає blockstudio.json, що відхилить аналіз і які команди доступні.

Кожен рядок береться з ваших файлів, параметрів або вибраного профілю аналізу. Повторна генерація зберігає написані вручну примітки, а --check завершується помилкою, якщо контракт застарів.

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.

Помилки виявляються до коміту

Чотири попередньо налаштовані рівні аналізу, кожен наступний охоплює попередній, і хук, який запускає їх під час кожного коміту.

Аналіз із розумінням block.json

Профілі blockstudio/phpstan аналізують ваші блоки, сторінки й параметри. Аналіз завершиться помилкою, якщо шаблон зчитує поле, не оголошене в block.json, або виводить його без екранування.

Шаблони читають типізований $a із файлу block.json поруч із ними; для кожного типу поля визначено конкретний тип PHP, а Db::get() повертає записи зі структурою, визначеною db.php. Якщо вказати шлях до налаштувань або назву хука з помилкою, система повідомить про це й запропонує найближчу правильну назву.

Задайте githooks.commit і запустіть vendor/bin/blockstudio-githooks sync: керований хук перед комітом запускає той самий аналіз, тож проблемний блок не потрапить у коміт.

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

base

Кожен ключ $a, який використовує шаблон, є в block.json; хуки, шляхи до параметрів і теги блоків справжні.

theme

Заголовки тем, оголошені ресурси, область дії %selector%, типові значення полів і межі повторювачів.

extreme-theme

Ліміт PHPStan, екранування виводу, без запуску команд оболонки, коректні класи Tailwind і чистий JavaScript.

wordpress-render

Тема Extreme та надана вами динамічна перевірка рендерингу WordPress. Вона працює без командної оболонки, а невдалий рендеринг стає зафіксованою проблемою.

Twig, Blade і скрипти

Twig, Blade і теги блоків перевіряються за однаковими полями. Рівень Extreme також перевіряє JavaScript і директиви Interactivity на відповідність вашій розмітці та сховищам.

Наявні проєкти

Базова конфігурація PHPStan приховує вже зафіксовані проблеми, доки новий код перевіряється за повним набором правил. blockstudioScanRoots знаходить бібліотеки блоків поза кореневою директорією, а вбудовані заглушки типізують публічний API.

Перелік і відображення з PHP

Кілька викликів дають змогу агенту побачити, що реєструє проєкт, відобразити будь-яку його частину та перевірити збережені дані.

Запитайте проєкт — відобразіть відповідь

Canvas::inventory() повертає всі зареєстровані в проєкті сторінки, блоки, патерни, шаблони редактора сайту, частини шаблонів і приклади UI, нічого не відображаючи.

Render::document() відображає будь-який із них як повний документ HTML з усіма використаними ресурсами, тож агент може перевірити результат поза редактором.

Canvas::documents() рендерить саме вибрані вами записи. Render::composition() і Render::content() повертають вкладені оголошення або серіалізований вміст блоку як HTML, а Ui::inventory() і Ui::examples() перелічують вбудовані родини компонентів, кожна з одним оголошенням для рендерингу.

Для одного блоку bs_block_fields(), bs_block_extension_fields(), bs_block_values() і bs_block_assets() повертають його поля, значення та ресурси без рендерингу, а bs_validate_block() перевіряє збережені атрибути перед їх збереженням.

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']);

Удвічі менше токенів на сторінку

Агенти пишуть звичайний HTML. Під час синхронізації Blockstudio перетворює його на серіалізовану розмітку блоків WordPress: менше генерувати й менше шансів помилитися.

Blockstudio

Що записують агенти

Приблизно 135 токенів
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

Що для цього записує парсер

Приблизно 310 токенів
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 -->

Виміряно за двома панелями вище: 540 символів у HTML порівняно з 1,233 символами розмітки блока, яку створює стандартний парсер; результат поділено на чотири — звичну оцінку кількості символів на токен. Розмітку показано з доданими для зручності читання розривами рядків.

Менше виводу для генерації

Агенти пишуть HTML без роздільників блоків, згенерованих класів і обгорткової розмітки.

Менше шансів помилитися

Парсер гарантує коректний вивід блоків на основі простішого вхідного тексту.

Швидше й дешевше

Менше токенів у виводі означає швидші відповіді й нижчі витрати на моделі.

Працює з усіма інструментами для програмування з ШІ

Будь-який агент, що вміє читати й записувати файли, одразу працює з Blockstudio.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

Створено для робочого процесу з ШІ

Блоки, сторінки, патерни, параметри. Усе — це файли, які агент може читати, записувати й змінювати.

Два файли на блок

Увесь блок — це конфігурація JSON і шаблон. Невеликий обсяг робить генерацію з першої спроби надійною.

27 типів полів

Текст, файли, повторювачі, кольори, дати та інше визначаються в JSON. Списки вибору заповнюються записами, термінами та користувачами.

Перевірка схеми JSON

Кожна конфігурація має схему, яка задає агентам точні правила й одразу виявляє помилки.

Автоматична реєстрація

Додайте файли до каталогу — і блоки зареєструються автоматично, без додаткового списку конфігурації.

Огляд на полотні

Кожна сторінка під керуванням або кожен блок із типовими значеннями — в одному масштабованому поданні.

Полотно наживо

У живому режимі змінені монтажні області оновлюються через Server-Sent Events приблизно за секунду після збереження. Клацніть мітку, щоб перейти до потрібної монтажної області.

Вбудований Tailwind

TailwindPHP компілює класи, які використовує кожна сторінка, без налаштування Node.

Element Grabber

Скопіюйте шлях до шаблону елемента та його розмітку, щоб одразу надати агенту контекст.

HTML для блоків

Сторінки й патерни — це звичайні файли, що перетворюються на нативні блоки WordPress.

Перевірка рендерингу

wp bs blocks render рендерить кожен блок так, як його рендерила б сторінка, і завершується з кодом 1, якщо шаблон викликає сповіщення, попередження або помилку.

Перевірка збереженого вмісту

wp bs blocks validate перевіряє збережені поля записів, а pages sync попереджає про атрибути, які блок зберігає, але ніколи не рендерить.

Перевірка з термінала

Переглядайте налаштування, користувацькі поля та ресурси за допомогою wp bs, а компілюйте фрагменти коду або файли за допомогою wp bs tailwind compile чи wp bs scss compile.

Plus

Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

  • Понад 500 шаблонів сайтів
  • Системні інструкції для ШІ
  • Оновлення назавжди
  • Приватна спільнота Discord