Перейти к содержимому

Вайб-кодинг с 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, а структуру блоков с помощью HTML определяет шаблон index.php:

Код
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 Открытый исходный код Режим оркестрации с координацией субагентов.
Продолжить Открытый исходный код Расширение 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. Они отображаются в виде интерактивных областей на основе iframe на одном экране. Перемещайтесь по холсту трекпадом, меняйте масштаб жестом щипка или прокруткой с 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. Делайте блоки небольшими и узкоспециализированными. Один блок на визуальный компонент. Так агенту проще анализировать каждый блок, а шаблоны остаются достаточно короткими, чтобы поместиться в контекстное окно за один проход.