Vibecoding с Blockstudio
Андрей Карпати измисля термина „vibe coding“ през февруари 2025, за да опише работен процес, при който описвате какво искате на изкуствен интелект и той пише кода. Една година по-късно практиката се е развила до това, което той вече нарича „агентно инженерство“: разработчиците координират AI агенти, вместо да пишат код ред по ред.
Blockstudio е създаден за това. Архитектурата му, базирана на файлове, липсата на инструменти за компилиране и предвидимата структура на проекта го превръщат в една от най-добрите среди за разработка на WordPress с помощта на AI.
Това ръководство разглежда практични модели за работа с AI агенти за програмиране и Blockstudio — от настройването на проекта до генерирането на цял сайт.
Защо Blockstudio работи добре с AI агенти
Файлове, а не бази данни
AI агентите за програмиране четат и записват файлове. Това е основният им интерфейс. 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 изисква редактора на блокове: плъзгате блокове, настройвате опциите и запазвате през администрацията. AI агентите не могат да правят това. Те имат нужда от файлове.
Blockstudio решава този проблем изцяло със своите страници, базирани на файлове. page.json задава метаданните на страницата, а шаблонът index.php определя структурата на блоковете чрез HTML:
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as 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; отварянето на администрацията не извършва тази синхронизация автоматично.
Това е една от най-мощните функции за разработка с помощта на AI. Вместо да описвате оформление на страница и ръчно да го сглобявате в редактора, описвате го на агент и той създава шаблона. Резултатът се контролира чрез версии, може да се възпроизведе и да се променя за секунди.
Без стъпка за компилиране
Няма нищо за компилиране, пакетиране или транспилиране. Агентът създава файл и той веднага работи. SCSS се компилира от сървъра. ES модулите се разрешават по време на изпълнение. Tailwind CSS се компилира при всяка заявка към фронтенда. Цикълът от момента, в който „агентът пише код“, до момента, в който „кодът работи в браузъра“, е възможно най-кратък.
Защо Tailwind CSS е правилният избор
Blockstudio поддържа както обикновен CSS, така и Tailwind CSS, но Tailwind има значително предимство при работа с AI агенти.
LLM познават отлично Tailwind
Tailwind CSS се използва в десетки хиляди хранилища с отворен код. С него са изградени интерфейсите на Claude.ai, Vercel, Shopify, Cursor и собствените продукти на OpenAI. Широкото му присъствие в обучаващите данни помага на LLM да генерират класове Tailwind с висока точност и рядко да измислят несъществуващи помощни класове.
Речникът на класовете е краен и ясно дефиниран. Агентът не може да измисли свойство на CSS, което не съществува, което значително намалява грешките в стиловете в сравнение със свободното писане на CSS, при което агентът може да генерира невалидни селектори или да разбере погрешно поведението на каскадата.
Стиловете са в маркировката
При Tailwind цялата информация за стиловете се намира заедно в шаблона HTML. Агентът вижда пълното визуално описание на елемента на едно място. Не е нужно да сверява отделни файлове .css, да разбира реда на каскадата или да проследява конфликти в специфичността.
Това е особено полезно за блокове в Blockstudio, при които шаблонът вече е в един файл. Агентът може да генерира завършен стилизиран компонент с един ход:
<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 се справят по-добре с него благодарение на покритието в обучаващите данни и съвместното разполагане на стиловете и маркировката.
AI агенти за програмиране
Всички изброени инструменти CLI могат да работят с проекти на Blockstudio веднага след инсталиране. Те четат и записват файлове, изпълняват команди в обвивката и разбират структурата на проекта от контекстни файлове.
Терминални агенти (CLI)
| Инструмент | Доставчик | Бележки |
|---|---|---|
| Claude Code | Anthropic | Агент с фокус върху терминала. Чете CLAUDE.md за контекст на проекта. |
| Codex CLI | OpenAI | Инструмент с отворен код CLI, създаден на Rust. Предлага се и като настолно приложение. |
| Gemini CLI | С отворен код, с контекстен прозорец от 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 с вграден AI. Има и 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 функции: тя е изцяло базирана на файлове.
Подготовка на проекта за AI агенти
Контекстният файл за LLM
Blockstudio включва предварително създаден контекстен файл, който индексира цялата документация на рамката. Това не е резюме или кратък справочник: всеки документ е посочен веднъж заедно с маршрута си, предназначението си и идентификаторите, които съдържа, така че агентът да открие страницата с отговора и да отвори само нея. Пълният текст на всеки документ и схема е наличен във втори файл за инструментите, които искат целия корпус наведнъж.
Активирайте го във вашия blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Индексът вече е достъпен на your-site.com/blockstudio-llm.txt, а пълният текст — на your-site.com/blockstudio-llm-full.txt. Насочете AI инструмента си към индекса и той ще получи достъп до цялата Blockstudio API без допълнителни инструкции. Вижте документацията за интеграция с AI за настройка според инструмента.
Така отпада нуждата сами да пишете специфични за рамката инструкции. Агент с достъп до blockstudio-llm.txt може да намери как се създават блокове, дефинират се полета, пишат се шаблони, конфигурира се Tailwind, настройват се страници и се използват всички куки, предоставени от Blockstudio.
Контекстни файлове за конкретния проект
Повечето AI агенти за програмиране четат и контекстен файл на ниво проект с инструкции, специфични за вашата кодова база. Името на файла зависи от инструмента:
| Файл | Инструмент |
|---|---|
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 и собствените ви файлове. В него са посочени какво създава проектът, кои функции са активирани, какво ще отхвърли анализът и кои команди се използват. Инструментът отказва да презапише файл, който не е създал, и запазва вашите бележки при повторното му генериране.
# 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
Инструменти за разработчици и AI работни процеси
Blockstudio включва два инструмента за разработчици, създадени специално за разработка с помощта на AI.
Платно
Платното е подобен на Figma преглед на всички ваши страници в Blockstudio, показани като интерактивни монтажни полета в iframe в един изглед. Премествайте изгледа с тракпада, увеличавайте с жест за мащабиране или Ctrl+scroll.
Това е полезно при работа с AI агенти, защото показва нагледно всички страници, без да превключвате раздели или да навигирате в администрацията на WordPress. Когато агент промени шаблон на страница, можете веднага да видите резултата. Активирайте режима на живо и платното ще се обновява автоматично при промяна на файловете.
Активирайте го в blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
След това отворете /wp-admin/admin.php?page=blockstudio-canvas. Превключвайте между изглед на страници (монтажни полета на цялата ширина) и изглед на блокове (решетка с всички регистрирани блокове и стойностите им по подразбиране).
Инструмент за избор на елементи
Инструментът за избор на елементи решава често срещан проблем при AI работните процеси: как да посочите на агента кой файл визуализира конкретен елемент на страницата.
Добавете ?blockstudio-devtools към всеки фронтенд URL, след което задръжте Cmd+C (Mac) или Ctrl+C (Windows) за 100ms. Активира се селектор с мерник, който откроява блоковете Blockstudio при посочване. Щракнете върху елемент, за да копирате контекста му в клипборда:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Поставете това в инструмента си за AI програмиране и агентът веднага ще разпознае пътя до файла, структурата на HTML и посочения от вас елемент. Няма нужда ръчно да търсите пътища до файловете с шаблони.
Активирайте го в blockstudio.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, който обикновено трябва да се настрои само веднъж в началото.
Съвети за по-добри резултати
-
Посочете контекстния файл за LLM. Агентите генерират значително по-добър код за Blockstudio, когато имат достъп до документацията на рамката. Винаги ги насочвайте към
blockstudio-llm.txtи им предоставяйте генериранAGENTS.mdза самия проект. -
Посочвайте конкретно типовете полета. Вместо „добави поле за изображение“, кажете „добави поле files с
allowedTypes: ['image']иreturnFormat: 'object'“. Колкото по-точно дефинирате полетата, толкова по-малко повторения ще са нужни. -
Започнете с един блок и после разширете. Нека агентът изгради правилно един блок, прегледайте моделите му и после го помолете да създаде останалите, като следва същите правила. Така ще установите образец, който подобрява следващите резултати.
-
Преглеждайте резултата. Vibe coding не означава да приемате кода на доверие. Проверете дали типовете полета отговарят на намеренията ви, шаблоните се визуализират правилно и класовете Tailwind дават желания визуален резултат. Преглеждайте генерирания от AI код, преди да го пуснете.
-
Използвайте схеми
block.json. Blockstudio предоставя схема на JSON наhttps://blockstudio.dev/schema/block. Добавянето на"$schema"към вашия block.json дава на агентите обратна връзка за валидирането и предотвратява невалидни конфигурации. -
Поддържайте блоковете малки и специализирани. По един блок за всеки визуален компонент. Така агентът по-лесно разсъждава върху всеки блок, а шаблоните остават достатъчно кратки, за да се поберат в един проход през контекстния прозорец.