Vibecoding s Blockstudio
Andrej Karpathy v únoru 2025 zavedl termín „vibe coding“ pro pracovní postup, při kterém popíšete AI, co chcete, a ona napíše kód. O rok později se tato praxe vyvinula v to, čemu nyní říká „agentní inženýrství“: vývojáři koordinují AI agenty místo toho, aby psali kód řádek po řádku.
Blockstudio byl vytvořen právě pro tento účel. Díky své architektuře založené na souborech, nulovým nárokům na nástroje pro sestavení a předvídatelné struktuře projektu patří k nejlepším prostředím pro vývoj WordPress s podporou AI.
Tento průvodce představuje praktické postupy pro používání AI agentů pro programování s Blockstudio, od nastavení projektu až po vytvoření celého webu.
Proč Blockstudio dobře funguje s AI agenty
Soubory místo databází
AI agenti pro programování čtou a zapisují soubory. To je jejich hlavní rozhraní. Blockstudio uchovává vše v souborovém systému: jeden block.json a jeden soubor šablony pro každý blok, jeden page.json pro každou stránku a jeden pattern.json pro každý vzor. Není třeba spravovat záznamy v databázi, proklikávat se administrací UI ani spouštět sestavení.
Na tom záleží, protože souborové systémy a příkazy shellu patří mezi největší zdroje dat pro předtrénování LLM. Každý model viděl miliony příkladů čtení, zápisu a organizace souborů. Když váš pracovní postup vývoje WordPress odpovídá tomuto rozhraní, agenti mohou pracovat s minimem pokynů.
Předvídatelná struktura
Každý blok Blockstudio má stejnou strukturu:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Díky této jednotnosti dokáže agent, který vytvořil jeden blok, vytvořit i sto dalších. Žádná překvapení, žádné výjimky, žádná skrytá konfigurace. Stejný vzor platí pro stránky (page.json + šablona), vzory (pattern.json + šablona) a rozšíření (extend.json).
Celé stránky jako soubory
Tradiční tvorba stránek WordPress vyžaduje editor bloků: přetahování bloků, konfiguraci nastavení a ukládání přes administraci. AI agenti nic z toho neumí. Potřebují soubory.
Stránky Blockstudio založené na souborech tento problém zcela řeší. Soubor page.json definuje metadata stránky a šablona index.php určuje strukturu bloků pomocí 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>
Agent může připravit celou stránku WordPress včetně základních bloků, vlastních bloků, uzamčení šablony a ovládacích prvků pro úpravy, a to zápisem dvou souborů. Spuštěním wp bs pages sync se zdroj použije v WordPress; otevření administrace tuto synchronizaci nikdy neprovede automaticky.
Tohle je jedna z nejvýkonnějších funkcí pro vývoj s podporou AI. Místo popisu rozvržení stránky a ručního sestavování v editoru ji popíšete agentovi a ten napíše šablonu. Výsledek lze verzovat, znovu vytvořit a upravovat během několika sekund.
Bez sestavování
Není co kompilovat, balit ani převádět. Agent vytvoří soubor a ten okamžitě funguje. SCSS se kompiluje na straně serveru. Moduly ES se načítají za běhu. Tailwind CSS se kompiluje při každém požadavku na frontend. Smyčka zpětné vazby mezi „agent napíše kód“ a „kód běží v prohlížeči“ je tak krátká, jak jen může být.
Proč je Tailwind CSS správnou volbou
Blockstudio podporuje běžné CSS i Tailwind CSS, ale Tailwind má při práci s AI agenty značnou výhodu.
LLM velmi dobře znají Tailwind
Tailwind CSS se používá v desítkách tisíc open-source repozitářů. Využívají ho rozhraní Claude.ai, Vercel, Shopify, Cursoru i vlastních produktů OpenAI. Díky četnému zastoupení v trénovacích datech vytvářejí LLM třídy Tailwind velmi přesně a jen zřídka si vymýšlejí neexistující utility.
Slovní zásoba tříd je konečná a přesně definovaná. Agent si nemůže vymyslet vlastnost CSS, která neexistuje, což výrazně omezuje chyby ve stylování oproti volně psanému CSS, kde může agent vytvořit neplatné selektory nebo nesprávně pochopit chování kaskády.
Styly jsou přímo ve značkách
V Tailwind jsou veškeré informace o stylech přímo v šabloně HTML. Agent vidí úplný vizuální popis prvku na jednom místě. Nemusí hledat informace v samostatných souborech .css, zjišťovat pořadí kaskády ani sledovat konflikty specificity.
To je obzvlášť užitečné u bloků Blockstudio, jejichž šablona už tvoří jediný soubor. Agent může v jednom kroku vygenerovat kompletní nastylovanou komponentu:
<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>
Souběžná práce agentů bez konfliktů
Protože styly Tailwind jsou vymezené pro každou šablonu zvlášť, mohou na různých blocích současně pracovat různí agenti (nebo vývojáři), aniž by vznikaly konflikty při slučování CSS. Neexistuje sdílený soubor stylů, ve kterém by změna jedné komponenty omylem rozbila jinou. Každý blok je samostatný.
To dobře funguje i s běžným CSS, pokud používáte vymezené styly Blockstudio (style.scoped.css), ale Tailwind zcela odstraňuje soubor CSS, takže agent musí u každého bloku spravovat o jeden soubor méně.
Běžné CSS stále funguje
Tailwind není podmínkou. Datový proces Blockstudio automaticky zpracuje soubory .css a .scss, včetně stylů vymezených pro blok. Pokud váš projekt používá jinou metodiku CSS, agenti mohou pracovat i s ní. Výhodou Tailwind je pouze to, že mu LLM díky zastoupení v trénovacích datech a umístění stylů přímo ve značkách rozumějí lépe.
AI agenti pro programování
Následující nástroje CLI lze používat s projekty Blockstudio bez dalšího nastavování. Čtou a zapisují soubory, spouštějí příkazy shellu a z kontextových souborů rozpoznají strukturu projektu.
Agenti v terminálu (CLI)
| Nástroj | Poskytovatel | Poznámky |
|---|---|---|
| Claude Code | Anthropic | Agent zaměřený na terminál. Čte CLAUDE.md pro kontext projektu. |
| Codex CLI | OpenAI | Open-source CLI vytvořený v Rust. K dispozici také jako desktopová aplikace. |
| Gemini CLI | Open-source, kontextové okno o velikosti 1M tokenů. Čte GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Specializovaní souběžní agenti pro průzkum, úkoly, plánování a revizi. |
| Aider | Open source | Podporuje 100+ poskytovatelů LLM včetně lokálních modelů. |
| OpenCode | Open source | Terminálové TUI s integrací LSP. Podporuje více než 75 poskytovatelů. |
| Amazon Q Developer CLI | AWS | K dispozici bezplatná verze. Vhodný pro projekty integrované s AWS. |
Agenti v IDE
| Nástroj | Poskytovatel | Poznámky |
|---|---|---|
| Cursor | Cursor | Odvozenina VS Code s integrovanou AI. Má také CLI (beta). |
| Windsurf | Cognition AI | Odvozenina VS Code s asistentem Cascade pro práci s agenty. |
| Cline | Open source | Rozšíření VS Code s postupným schvalováním. Má také CLI. |
| Kilo Code | Open source | Režim orchestrace s koordinovanými podřízenými agenty. |
| Continue | Open source | Rozšíření VS Code/JetBrains s asynchronními agenty CI/CD. |
| Augment Code | Augment | Zaměřený na podniky, s hloubkovým indexováním kódové základny. |
Všechny tyto nástroje mohou vytvářet a upravovat soubory v adresáři projektu Blockstudio. Agenti v terminálu se k tomu hodí obzvlášť dobře, protože vývoj Blockstudio nevyžaduje funkce specifické pro IDE: vše je založeno na souborech.
Příprava projektu pro AI agenty
Kontextový soubor LLM
Blockstudio obsahuje předpřipravený kontextový soubor s indexem kompletní dokumentace frameworku. Nejde o shrnutí ani tahák: každý dokument je uveden jednou spolu se svou cestou, účelem a identifikátory, které obsahuje, takže agent najde stránku s odpovědí a otevře pouze ji. Úplný text všech dokumentů a schémat je dostupný v druhém souboru pro nástroje, které chtějí najednou celý souborový soubor.
Zapněte tuto funkci ve svém blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Index je nyní dostupný na your-site.com/blockstudio-llm.txt a celý text na your-site.com/blockstudio-llm-full.txt. Nasměrujte svůj AI nástroj na index a získá přístup k celé Blockstudio API bez dalších pokynů. Nastavení pro konkrétní nástroje najdete v dokumentaci k integraci AI.
Odpadá tak nutnost psát vlastní pokyny pro konkrétní framework. Agent s přístupem k blockstudio-llm.txt zjistí, jak vytvářet bloky, definovat pole, psát šablony, konfigurovat Tailwind, nastavovat stránky a používat všechny hooky, které Blockstudio nabízí.
Kontextové soubory specifické pro projekt
Většina AI agentů pro programování také čte kontextový soubor na úrovni projektu s pokyny specifickými pro vaši kódovou základnu. Konvence se liší podle nástroje:
| Soubor | Nástroj |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI a další |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Protože blockstudio-llm.txt už pokrývá framework, stačí v kontextovém souboru projektu popsat, co je pro váš projekt jedinečné: rozložení adresářů, konvence pojmenování, příkazy a omezení.
Pokud nainstalujete blockstudio/phpstan, nemusíte tento popis psát ručně. vendor/bin/blockstudio-agents vytvoří soubor AGENTS.md z vašeho blockstudio.json a vlastních souborů. Uvede, co projekt vytváří, které funkce jsou zapnuté, co analýza odmítne a které příkazy jsou k dispozici. Odmítne přepsat soubor, který sama nevytvořila, a při opětovném generování zachová vaše poznámky.
# 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
Vývojářské nástroje pro pracovní postupy s AI
Blockstudio obsahuje dva vývojářské nástroje vytvořené speciálně pro vývoj s podporou AI.
Plátno
Plátno je přehled všech vašich stránek Blockstudio podobný Figma, zobrazený jako živé artboardy v iframe v jediném pohledu. Posouvejte se trackpadem a přibližujte stažením prstů nebo klávesou Ctrl a kolečkem.
Při práci s AI agenty se hodí, protože poskytuje vizuální přehled všech stránek bez přepínání karet nebo procházení administrace WordPress. Když agent upraví šablonu stránky, výsledek uvidíte okamžitě. Zapněte živý režim a plátno se při změně souborů automaticky obnoví.
Zapněte tuto funkci v blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Poté přejděte na /wp-admin/admin.php?page=blockstudio-canvas. Přepínejte mezi zobrazením stránek (artboardy přes celou šířku) a zobrazením bloků (mřížka všech registrovaných bloků s výchozími hodnotami).
Výběr prvků
Výběr prvků řeší častý problém při práci s AI: jak agentovi sdělit, který soubor vykresluje konkrétní prvek na stránce.
Přidejte ?blockstudio-devtools k libovolné adrese URL frontendu a podržte Cmd+C (Mac) nebo Ctrl+C (Windows) po dobu 100 ms. Aktivuje se výběr zaměřovacím křížem a při najetí zvýrazní bloky Blockstudio. Kliknutím na prvek zkopírujete jeho kontext do schránky:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Vložte to do nástroje AI pro programování a agent okamžitě zjistí cestu k souboru, strukturu HTML i prvek, na který ukazujete. Už nemusíte ručně hledat cesty k souborům šablon.
Zapněte tuto funkci v blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktické postupy
Vytvoření jednoho bloku
Nejjednodušší pracovní postup: popište, co chcete, a nechte agenta, ať to vytvoří.
Pokyn:
Vytvoř blok s referencí a poli pro citaci (textarea), jméno autora (text), pozici autora (text) a fotografii autora (files). Pro stylování použij Tailwind. Citace má být velkým kurzívním písmem s ozdobným uvozovacím znaménkem.
Agent vytvoří:
blockstudio/testimonial/
├── block.json
└── index.php
Vytvoření celé stránky
Stránky Blockstudio založené na souborech umožňují agentovi připravit celou stránku WordPress jako šablonu. Právě tady se naplno projeví výhoda: místo postupného vytváření bloků agent v jednom kroku vytvoří kompletní strukturu stránky se všemi bloky.
Pokyn:
Vytvoř stránku „O nás“ s úvodní sekcí, mřížkou týmu a zástupným kontaktním formulářem. Kde to půjde, použij existující bloky, nové vytvoř podle potřeby. Přiřaď ji k ID příspěvku 2. Uzamkni šablonu, ale umožni upravovat obsah nadpisů a odstavců.
Agent vytvoří:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
A také všechny vlastní bloky, na které odkazuje (e.g, blockstudio/team-member/). Spuštěním
wp bs pages sync vytvoříte příspěvek WordPress s uzamčenou šablonou
a ovládacími prvky pro úpravy. Celou stránku lze verzovat a znovu vytvořit.
Vytvoření celého webu
Právě tady naplno vynikne architektura Blockstudio. Jediný pokyn může vytvořit celý web, protože každý prvek je soubor:
Pokyn:
Vytvoř portfolio web s těmito stránkami: Domů, Práce, O nás, Kontakt. Vytvoř vlastní bloky pro úvodní sekci, mřížku projektů, kartu projektu, člena týmu, kontaktní údaje a zápatí. Použij tmavý motiv s Tailwind. V blockstudio.json nastav Tailwind pomocí vlastní palety barev.
Agent vytvoří adresáře bloků, šablony stránek, blockstudio.json s konfigurací Tailwind a případně vzory pro opakovaně použitelné sekce. Vše se commitne do git jako jediná změnová sada.
Souběžné pracovní postupy agentů
Některé nástroje (desktopová aplikace Codex, GitHub Copilot CLI, Kilo Code) podporují souběžný běh více agentů. Architektura Blockstudio s jedním souborem pro každý blok zajišťuje bezpečnou souběžnou práci:
- Agent 1: vytvoří úvodní blok a domovskou stránku
- Agent 2: vytvoří blok karty projektu a stránku s pracemi
- Agent 3: vytvoří blok kontaktního formuláře a kontaktní stránku
Protože má každý blok vlastní adresář a styly Tailwind jsou umístěné přímo v šablonách, agenti si nebudou překážet. Jediný sdílený soubor je blockstudio.json, který obvykle stačí nastavit jednou na začátku.
Tipy pro lepší výsledky
-
Odkazujte na kontextový soubor LLM. Agenti vytvářejí výrazně lepší kód Blockstudio, když mají přístup k dokumentaci frameworku. Vždy je odkažte na
blockstudio-llm.txta poskytněte jim vygenerovaný souborAGENTS.mdpro samotný projekt. -
Upřesněte typy polí. Místo „přidej pole pro obrázek“ řekněte „přidej pole files s
allowedTypes: ['image']areturnFormat: 'object'“. Čím přesněji pole definujete, tím méně úprav bude potřeba. -
Začněte jedním blokem a pak rozšiřujte. Nechte agenta správně vytvořit jeden blok, zkontrolujte jeho postupy a potom ho požádejte, aby podle stejných konvencí vytvořil zbytek. Tím vznikne předloha, která zlepší další výstupy.
-
Zkontrolujte výstup. Vibe coding neznamená bezmyšlenkovité přijímání kódu. Ověřte, že typy polí odpovídají vašemu záměru, šablony se správně vykreslují a třídy Tailwind vytvářejí požadovaný vzhled. Kód vytvořený AI je před nasazením třeba zkontrolovat.
-
Používejte schémata
block.json. Blockstudio poskytuje schéma JSON na adresehttps://blockstudio.dev/schema/block. Přidáním"$schema"do vašeho block.json získají agenti zpětnou vazbu k ověření a předejdete chybným konfiguracím. -
Udržujte bloky malé a zaměřené. Jeden blok na jednu vizuální komponentu. Agent díky tomu snáze pochopí každý blok a šablony zůstanou dostatečně krátké, aby se vešly do jednoho průchodu kontextovým oknem.