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

Вайб-кодування з Blockstudio

Андрей Карпаті у лютому 2025 запровадив термін «вайб-кодинг» для опису робочого процесу, у якому ви розповідаєте ШІ, що хочете отримати, а він пише код. За рік ця практика переросла в те, що він тепер називає «агентною інженерією»: розробники координують роботу ШІ-агентів замість того, щоб писати код рядок за рядком.

Blockstudio створено саме для цього. Його файлова архітектура, відсутність інструментів збирання та передбачувана структура проєкту роблять його одним із найкращих середовищ для розробки WordPress за допомогою ШІ.

У цьому посібнику описано практичні способи використання агентів для написання коду з ШІ у Blockstudio: від налаштування проєкту до створення повноцінного сайту.

Чому Blockstudio добре працює з ШІ-агентами

Файли, а не бази даних

Агенти для написання коду з ШІ читають і записують файли — це їхній основний спосіб взаємодії. У Blockstudio усе зберігається у файловій системі: block.json і файл шаблону для кожного блоку, page.json для кожної сторінки, pattern.json для кожного патерна. Не потрібно керувати записами в базі даних, переходити розділами адмінки через UI чи запускати процес збирання.

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

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

Кожен блок Blockstudio має однакову структуру:

Код
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

Завдяки такій узгодженості агент, який створив один блок, зможе створити й сотню. Жодних несподіванок, особливих випадків чи прихованих налаштувань. Така сама структура діє для сторінок (page.json + шаблон), патернів (pattern.json + шаблон) і розширень (extend.json).

Повноцінні сторінки як файли

Для створення сторінки у традиційному WordPress потрібен редактор блоків: перетягування блоків, налаштування параметрів і збереження через адмінку. ШІ-агенти нічого з цього зробити не можуть. Їм потрібні файли.

Файлові сторінки Blockstudio повністю розв’язують цю проблему. Файл page.json задає метадані сторінки, а шаблон index.php визначає структуру блоків за допомогою HTML:

Код
pages/about/
├── page.json     # Title, slug, post type, template lock
└── index.php     # Block structure as HTML
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>

Агент може створити каркас цілої сторінки WordPress, додавши основні й користувацькі блоки, заблокувавши шаблон і налаштувавши елементи редагування — усе це, записавши лише два файли. Запустіть wp bs pages sync, щоб застосувати вихідний код до WordPress; саме відкриття адмінки не запускає цю синхронізацію автоматично.

Це одна з найпотужніших можливостей для розробки за допомогою ШІ. Замість того щоб описувати макет сторінки й вручну збирати його в редакторі, ви описуєте його агенту, і він створює шаблон. Результат зберігається під контролем версій, його можна відтворити й доопрацювати за лічені секунди.

Без етапу збирання

Нічого не потрібно компілювати, об’єднувати в пакети чи транспілювати. Агент створює файл, і той одразу працює. SCSS компілюється на сервері. Модулі ES обробляються під час виконання. Tailwind CSS компілюється з кожним запитом до фронтенду. Зворотний зв’язок між написанням коду агентом і його виконанням у браузері — якнайшвидший.

Чому варто вибрати Tailwind CSS

Blockstudio підтримує звичайний CSS і Tailwind CSS, але Tailwind має суттєву перевагу під час роботи з ШІ-агентами.

LLM дуже добре знають Tailwind

Tailwind CSS використовують у десятках тисяч репозиторіїв із відкритим кодом. Він працює в інтерфейсах Claude.ai, Vercel, Shopify, Cursor і власних продуктів OpenAI. Через таку поширеність у навчальних даних LLM дуже точно генерують класи Tailwind і рідко вигадують неіснуючі утиліти.

Набір класів обмежений і чітко визначений. Агент не може вигадати властивість CSS, якої не існує, що значно зменшує кількість помилок стилізації порівняно з довільним CSS, де агент може створити недійсні селектори або неправильно зрозуміти поведінку каскаду.

Стилі — безпосередньо в розмітці

У Tailwind уся інформація про стилі розміщена безпосередньо в шаблоні HTML. Агент бачить повний опис вигляду елемента в одному місці. Не потрібно звірятися з окремими файлами .css, з’ясовувати порядок каскаду чи відстежувати конфлікти специфічності.

Це особливо зручно для блоків Blockstudio, шаблон яких уже складається з одного файла. Агент може за один прохід створити повністю стилізований компонент:

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

Паралельна робота агентів без конфліктів

Оскільки стилі Tailwind обмежені окремими шаблонами, кілька агентів (або розробників) можуть одночасно працювати над різними блоками без конфліктів злиття в CSS. Спільної таблиці стилів, де зміни одного компонента можуть випадково зламати інший, немає. Кожен блок самодостатній.

Це також добре працює зі звичайним CSS, якщо використовувати стилі Blockstudio, обмежені компонентом (style.scoped.css), але Tailwind повністю усуває файл CSS — агенту потрібно керувати на один файл менше для кожного блока.

Звичайний CSS теж підходить

Tailwind не є обов’язковим. Конвеєр ресурсів Blockstudio автоматично обробляє файли .css і .scss, зокрема стилі, обмежені компонентом і прив’язані до блока. Якщо у вашому проєкті застосовують іншу методологію CSS, агенти теж можуть із нею працювати. Перевага Tailwind лише в тому, що LLM краще його знають завдяки поширеності в навчальних даних і спільному розміщенню стилів із розміткою.

Агенти для написання коду з ШІ

Усі наведені нижче інструменти CLI одразу сумісні з проєктами Blockstudio. Вони читають і записують файли, запускають команди оболонки й розуміють структуру проєкту з файлів контексту.

Агенти в терміналі (CLI)

Інструмент Розробник Примітки
Claude Code Anthropic Агент для роботи насамперед у терміналі. Читає CLAUDE.md, щоб отримати контекст проєкту.
Codex CLI OpenAI Інструмент CLI із відкритим кодом, створений на Rust. Також доступний як настільний застосунок.
Gemini CLI Google Інструмент із відкритим кодом і контекстним вікном на 1M токенів. Читає GEMINI.md.
GitHub Copilot CLI GitHub Спеціалізовані паралельні агенти для дослідження, виконання завдань, планування й перевірки.
Aider Відкритий код Підтримує 100+ провайдерів LLM, зокрема локальні моделі.
OpenCode Відкритий код Термінальний TUI з інтеграцією LSP. Підтримує понад 75 провайдерів.
Amazon Q Developer CLI AWS Доступний безкоштовний тариф. Добре підходить для проєктів з інтеграцією AWS.

Агенти в IDE

Інструмент Розробник Примітки
Cursor Cursor Форк VS Code зі вбудованим ШІ. Також має CLI (бета-версія).
Windsurf Cognition AI Форк VS Code з агентним помічником Cascade.
Cline Відкритий код Розширення VS Code із покроковим затвердженням. Також має CLI.
Kilo Code Відкритий код Режим оркестратора з координованими підлеглими агентами.
Continue Відкритий код Розширення VS Code/JetBrains з асинхронними агентами CI/CD.
Augment Code Augment Орієнтований на корпоративне використання, із глибокою індексацією кодової бази.

Усі ці інструменти можуть створювати й редагувати файли в каталозі проєкту Blockstudio. Агенти в терміналі особливо добре підходять для цього, адже розробка Blockstudio не потребує спеціальних функцій IDE: вона повністю ґрунтується на роботі з файлами.

Підготовка проєкту до роботи з ШІ-агентами

Файл контексту для LLM

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

Увімкніть його у своєму blockstudio.json:

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

Тепер покажчик доступний за адресою your-site.com/blockstudio-llm.txt, а повний текст — за адресою your-site.com/blockstudio-llm-full.txt. Вкажіть у своєму інструменті ШІ на покажчик, і він отримає доступ до всієї документації Blockstudio API без додаткових інструкцій. Докладніші вказівки щодо налаштування окремих інструментів наведено в документації з інтеграції ШІ.

Це позбавляє потреби самостійно писати інструкції для конкретного фреймворку. Агент із доступом до blockstudio-llm.txt може з’ясувати, як створювати блоки, визначати поля, писати шаблони, налаштовувати Tailwind, створювати сторінки й використовувати всі хуки, які надає Blockstudio.

Файли контексту для окремих проєктів

Більшість агентів для написання коду з ШІ також читають файл контексту на рівні проєкту, що містить інструкції для вашої кодової бази. Формат залежить від інструмента:

Файл Інструмент
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI та інші
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

Оскільки blockstudio-llm.txt уже охоплює фреймворк, у файлі контексту проєкту достатньо описати його особливості: структуру каталогів, правила іменування, команди й обмеження.

Якщо встановити blockstudio/phpstan, цей опис не доведеться писати вручну. vendor/bin/blockstudio-agents створює AGENTS.md на основі вашого blockstudio.json і власних файлів: у ньому перелічено, що створює проєкт, які функції ввімкнено, що відхилить аналізатор і які команди доступні. Він не перезаписує файли, створені не ним, і зберігає ваші нотатки під час повторного створення.

Markdown
# 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

Інструменти розробника для робочих процесів із ШІ

Blockstudio містить два інструменти розробника, створені спеціально для розробки за допомогою ШІ.

Полотно

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

Це зручно під час роботи з ШІ-агентами: ви бачите всі сторінки й не мусите перемикати вкладки чи переходити адмінкою WordPress. Коли агент змінює шаблон сторінки, результат одразу видно. Увімкніть режим реального часу, і полотно автоматично оновлюватиметься зі зміною файлів.

Увімкніть його в blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

Потім перейдіть до /wp-admin/admin.php?page=blockstudio-canvas. Перемикайтеся між переглядом сторінок (монтажні області на всю ширину) та блоків (сітка всіх зареєстрованих блоків зі значеннями за замовчуванням).

Вибір елемента

Вибір елемента розв’язує поширену проблему в робочих процесах із ШІ: як повідомити агенту, який файл відображає певний елемент на сторінці.

Додайте ?blockstudio-devtools до будь-якого URL на фронтенді, а потім утримуйте Cmd+C (Mac) або Ctrl+C (Windows) протягом 100мс. Активується перехрестя, яке під час наведення підсвічує блоки Blockstudio. Клацніть елемент, щоб скопіювати його контекст у буфер обміну:

Код
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

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

Увімкніть його в blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

Практичні приклади

Створення окремого блока

Найпростіший робочий процес: опишіть, що вам потрібно, і дозвольте агенту це створити.

Запит:

Створи блок відгуку з полями для цитати (textarea), імені автора (text), посади автора (text) і фото автора (files). Для стилізації використовуй Tailwind. Цитата має бути великим курсивним шрифтом із декоративною лапкою.

Агент створить:

Код
blockstudio/testimonial/
├── block.json
└── index.php

Створення повноцінної сторінки

Файлові сторінки Blockstudio дають агенту змогу створити каркас цілої сторінки WordPress у вигляді шаблону. Саме тут ця можливість розкривається на повну: замість створювати блоки по одному, агент за один прохід формує структуру сторінки з усіма блоками.

Запит:

Створи сторінку «Про нас» із головним блоком, сіткою команди й заповнювачем форми зворотного зв’язку. За можливості використовуй наявні блоки, а за потреби створи нові. Закріпи її за ID запису 2. Заблокуй шаблон, але зроби заголовки й абзаци доступними для редагування.

Агент створить:

Код
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

А також будь-які користувацькі блоки, на які він посилається (e.g, blockstudio/team-member/). Запустіть wp bs pages sync, щоб створити запис WordPress із заблокованим шаблоном і засобами редагування. Уся сторінка зберігається під контролем версій і її можна відтворити.

Створення повноцінного сайту

Саме тут архітектура Blockstudio розкриває всі свої переваги. Один запит може згенерувати цілий сайт, адже кожен його елемент — це файл:

Запит:

Створи сайт-портфоліо з такими сторінками: головна, роботи, про нас, контакти. Створи користувацькі блоки для головного блока, сітки проєктів, картки проєкту, учасника команди, контактної інформації та нижнього колонтитула. Використай темну тему з Tailwind. Налаштуй Tailwind у blockstudio.json і додай власну палітру кольорів.

Агент створить каталоги блоків, шаблони сторінок, blockstudio.json із конфігурацією Tailwind, а за бажанням — і патерни для секцій повторного використання. Усе буде збережено в git одним набором змін.

Паралельні робочі процеси агентів

Деякі інструменти (настільний застосунок Codex, GitHub Copilot CLI, Kilo Code) підтримують паралельну роботу кількох агентів. Файлова архітектура Blockstudio, де кожен блок зберігається окремо, робить це безпечним:

  • Агент 1: створює головний блок і домашню сторінку
  • Агент 2: створює блок картки проєкту й сторінку робіт
  • Агент 3: створює блок форми зворотного зв’язку й сторінку контактів

Оскільки кожен блок має окремий каталог, а стилі Tailwind розміщені в шаблонах, агенти не конфліктуватимуть між собою. Спільний лише файл blockstudio.json, який зазвичай потрібно налаштувати один раз на початку.

Поради для кращого результату

  1. Посилайтеся на файл контексту LLM. Агенти створюють значно кращий код Blockstudio, коли мають доступ до документації фреймворку. Завжди надавайте їм blockstudio-llm.txt і створений для самого проєкту файл AGENTS.md.

  2. Уточнюйте типи полів. Замість «додай поле зображення» скажіть «додай поле files із allowedTypes: ['image'] та returnFormat: 'object'». Що точніше ви визначите поля, то менше буде ітерацій.

  3. Почніть з одного блока, а потім масштабуйте. Дайте агенту правильно створити один блок, перевірте його структуру, а тоді попросіть створити решту за тими самими правилами. Так ви отримаєте зразок, який покращить подальші результати.

  4. Перевіряйте результат. Вайб-кодинг не означає, що код слід приймати без перевірки. Переконайтеся, що типи полів відповідають вашим задумам, шаблони правильно відображаються, а класи Tailwind дають потрібний візуальний результат. Перевіряйте код, створений ШІ, перед випуском.

  5. Використовуйте схеми block.json. Blockstudio надає схему JSON за адресою https://blockstudio.dev/schema/block. Додайте "$schema" до свого block.json, щоб агенти отримували відгук про валідацію й не створювали некоректні конфігурації.

  6. Робіть блоки невеликими й вузькоспеціалізованими. Один блок на візуальний компонент. Так агенту легше працювати з кожним блоком, а шаблони залишаються достатньо короткими, щоб уміститися в один прохід контекстного вікна.