Vibecoding s Blockstudio
Andrej Karpathy zaviedol vo februári 2025 pojem „vibe coding“ na označenie pracovného postupu, pri ktorom opíšete umelej inteligencii, čo chcete, a ona napíše kód. O rok neskôr sa táto prax rozvinula do toho, čo teraz nazýva „agentic engineering“: vývojári koordinujú agentov umelej inteligencie namiesto písania kódu riadok po riadku.
Blockstudio bol vytvorený práve na tento účel. Vďaka architektúre založenej na súboroch, nulovým nárokom na nástroje na zostavovanie a predvídateľnej štruktúre projektu patrí medzi najlepšie prostredia na vývoj WordPress s pomocou umelej inteligencie.
Táto príručka sa venuje praktickým postupom pri používaní agentov umelej inteligencie na programovanie s Blockstudio, od nastavenia projektu až po generovanie celého webu.
Prečo sa Blockstudio dobre hodí na prácu s agentmi umelej inteligencie
Súbory, nie databázy
Agenti umelej inteligencie na programovanie čítajú a zapisujú súbory. To je ich hlavný spôsob práce. Blockstudio uchováva všetko v súborovom systéme: block.json a súbor šablóny pre každý blok, page.json pre každú stránku a pattern.json pre každý vzor. Netreba spravovať záznamy v databáze, preklikávať sa administračným UI ani spúšťať zostavenie.
Je to dôležité, pretože súborové systémy a príkazy shellu patria k najväčším zdrojom tréningových dát pre LLM. Každý model videl milióny príkladov čítania, zapisovania a usporadúvania súborov. Keď váš pracovný postup vývoja v WordPress používa rovnaký spôsob práce, agentom stačí minimum pokynov.
Predvídateľná štruktúra
Každý blok Blockstudio má rovnakú štruktúru:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Vďaka tejto jednotnosti dokáže agent, ktorý vytvoril jeden blok, vytvoriť aj sto ďalších. Nič ho neprekvapí, neexistujú výnimky ani skryté nastavenia. Rovnaký vzor platí pre stránky (page.json + šablóna), vzory (pattern.json + šablóna) aj rozšírenia (extend.json).
Celé stránky ako súbory
Pri tradičnom vytváraní stránok WordPress treba použiť editor blokov: presúvať bloky, nastavovať ich a ukladať cez administráciu. Agenti umelej inteligencie to nedokážu. Potrebujú súbory.
Stránky Blockstudio založené na súboroch tento problém úplne riešia. Súbor page.json definuje metadáta stránky a šablóna index.php určuje štruktúru blokov pomocou 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 dokáže pripraviť celú stránku WordPress vrátane základných a vlastných blokov, uzamknutia šablóny a ovládacích prvkov na úpravu, a to zapísaním dvoch súborov. Spustením wp bs pages sync použijete zdrojové súbory v WordPress; samotným otvorením administrácie sa táto synchronizácia nevykoná.
Je to jedna z najužitočnejších funkcií pre vývoj s pomocou umelej inteligencie. Namiesto opisovania rozloženia stránky a jej ručného skladania v editore ho opíšete agentovi a ten napíše šablónu. Výsledok je spravovaný vo verziovacom systéme, reprodukovateľný a dá sa upraviť v priebehu niekoľkých sekúnd.
Bez zostavovania
Nič netreba kompilovať, zoskupovať ani transpilovať. Agent vytvorí súbor a ten hneď funguje. SCSS sa kompiluje na strane servera. Moduly ES sa načítavajú za behu. Tailwind CSS sa kompiluje pri každej požiadavke z frontendu. Cyklus od zápisu kódu agentom po jeho spustenie v prehliadači je taký krátky, ako sa len dá.
Prečo je Tailwind CSS správna voľba
Blockstudio podporuje bežné CSS aj Tailwind CSS, no pri práci s agentmi umelej inteligencie má Tailwind výraznú výhodu.
LLM poznajú Tailwind veľmi dobre
Tailwind CSS sa používa v desaťtisícoch open-source repozitárov. Poháňa rozhrania produktov Claude.ai, Vercel, Shopify, Cursoru aj OpenAI. Vďaka tomu, že je taký rozšírený v tréningových dátach, LLM generujú triedy Tailwind s vysokou presnosťou a len zriedka si vymýšľajú neexistujúce pomocné triedy.
Slovník tried je konečný a presne definovaný. Agent si nemôže vymyslieť vlastnosť CSS, ktorá neexistuje, čím sa výrazne znižuje počet chýb v štýloch v porovnaní s voľným CSS, pri ktorom môže agent vytvoriť neplatné selektory alebo nesprávne pochopiť kaskádu štýlov.
Štýly sú priamo v značkách
V Tailwind sú všetky informácie o štýloch priamo v šablóne HTML. Agent vidí úplný vizuálny opis prvku na jednom mieste. Nemusí hľadať informácie v samostatných súboroch .css, zisťovať poradie kaskády ani sledovať konflikty špecifickosti.
Je to obzvlášť užitočné pri blokoch Blockstudio, ktorých šablóna je už v jednom súbore. Agent dokáže na jeden záťah vytvoriť celý naštýlovaný komponent:
<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>
Paralelní agenti bez konfliktov
Keďže štýly Tailwind sú obmedzené na jednotlivé šablóny, viacerí agenti (alebo vývojári) môžu súčasne pracovať na rôznych blokoch bez konfliktov pri zlučovaní CSS. Zmeny v jednom komponente nemôžu omylom narušiť iný, pretože neexistuje spoločný súbor so štýlmi. Každý blok je samostatný.
Funguje to dobre aj s bežným CSS, ak používate štýly s obmedzeným rozsahom v Blockstudio (style.scoped.css), ale Tailwind úplne odstraňuje súbor CSS, takže agent musí pre každý blok spravovať o jeden súbor menej.
Funguje aj bežné CSS
Tailwind nie je povinné. Spracovanie zdrojových súborov v Blockstudio automaticky zvládne súbory .css a .scss vrátane štýlov s obmedzeným rozsahom, ktoré sú viazané na konkrétny blok. Ak váš projekt používa inú metodiku CSS, agenti môžu pracovať aj s ňou. Výhodou Tailwind je iba to, že LLM ho vďaka pokrytiu v tréningových dátach a umiestneniu štýlov priamo v značkách zvládajú lepšie.
Agenti umelej inteligencie na programovanie
Všetky nasledujúce nástroje CLI dokážu pracovať s projektmi Blockstudio hneď po inštalácii. Čítajú a zapisujú súbory, spúšťajú príkazy shellu a z kontextových súborov rozpoznajú štruktúru projektu.
Agenti v termináli (CLI)
| Nástroj | Poskytovateľ | Poznámky |
|---|---|---|
| Claude Code | Anthropic | Agent zameraný na terminál. Na získanie kontextu projektu číta CLAUDE.md. |
| Codex CLI | OpenAI | Open-source CLI vytvorený v Rust. Dostupný aj ako desktopová aplikácia. |
| Gemini CLI | Open-source s kontextovým oknom pre 1M tokenov. Číta GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Špecializovaní paralelní agenti na skúmanie, úlohy, plánovanie a kontrolu. |
| Aider | Open source | Podporuje viac ako 100 poskytovateľov LLM vrátane lokálnych modelov. |
| OpenCode | Open source | Terminálové textové rozhranie s integráciou LSP. Podporuje viac ako 75 poskytovateľov. |
| Amazon Q Developer CLI | AWS | Dostupná bezplatná verzia. Vhodný najmä pre projekty integrované s AWS. |
Agenti v integrovanom vývojovom prostredí
| Nástroj | Poskytovateľ | Poznámky |
|---|---|---|
| Cursor | Cursor | Odnož VS Code so zabudovanou umelou inteligenciou. Má aj CLI (beta). |
| Windsurf | Cognition AI | Odnož VS Code s agentickým asistentom Cascade. |
| Cline | Open source | Rozšírenie VS Code s postupným schvaľovaním. Má aj CLI. |
| Kilo Code | Open source | Režim koordinátora s koordinovanými podriadenými agentmi. |
| Pokračovať | Open source | Rozšírenie VS Code/JetBrains s asynchrónnymi agentmi CI/CD. |
| Augment Code | Augment | Zameraný na podniky, s dôkladným indexovaním kódovej základne. |
Všetky tieto nástroje dokážu vytvárať a upravovať súbory v adresári projektu Blockstudio. Agenti v termináli sú na to obzvlášť vhodní, pretože vývoj v Blockstudio nepotrebuje funkcie špecifické pre IDE: celý je založený na súboroch.
Príprava projektu na prácu s agentmi umelej inteligencie
Kontextový súbor pre LLM
Blockstudio obsahuje vopred pripravený kontextový súbor, ktorý indexuje kompletnú dokumentáciu frameworku. Nejde o súhrn ani stručnú príručku: každý dokument je uvedený raz spolu so svojou cestou, účelom a identifikátormi, ktoré obsahuje. Agent tak nájde stránku s odpoveďou na otázku a otvorí iba túto stránku. Úplný text všetkých dokumentov a schém je k dispozícii v druhom súbore, ktorý umožňuje nástrojom načítať celý súborový korpus naraz.
Povoľte ho vo svojom blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Index je teraz dostupný na adrese your-site.com/blockstudio-llm.txt a úplný text na adrese your-site.com/blockstudio-llm-full.txt. Nasmerujte svoj nástroj umelej inteligencie na index a získa prístup k celému Blockstudio API bez ďalších pokynov. Pokyny na nastavenie konkrétnych nástrojov nájdete v dokumentácii o integrácii umelej inteligencie.
Vďaka tomu nemusíte sami písať pokyny špecifické pre framework. Agent s prístupom k blockstudio-llm.txt zistí, ako vytvárať bloky, definovať polia, písať šablóny, nastavovať Tailwind, vytvárať stránky a používať všetky hooky, ktoré Blockstudio poskytuje.
Kontextové súbory špecifické pre projekt
Väčšina agentov umelej inteligencie na programovanie číta aj kontextový súbor na úrovni projektu s pokynmi špecifickými pre vašu kódovú základňu. Zvyklosti sa líšia podľa nástroja:
| Súbor | Nástroj |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI a ďalšie |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Keďže blockstudio-llm.txt už pokrýva framework, v kontextovom súbore projektu stačí opísať jeho osobitosti: rozloženie adresárov, konvencie pomenovania, príkazy a obmedzenia.
Ak si nainštalujete blockstudio/phpstan, tento opis nemusíte písať ručne. vendor/bin/blockstudio-agents vytvorí súbor AGENTS.md z vášho blockstudio.json a vlastných súborov projektu. Uvedie, čo projekt vytvára, ktoré funkcie sú povolené, ktoré nálezy analýza odmietne a ktoré príkazy sú k dispozícii. Neprepíše súbor, ktorý nevytvoril, a pri opätovnom generovaní 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árske nástroje pre pracovné postupy s umelou inteligenciou
Blockstudio obsahuje dva vývojárske nástroje navrhnuté špeciálne na vývoj s pomocou umelej inteligencie.
Plátno
plátno je prehľad podobný Figma všetkých stránok Blockstudio, zobrazených ako živé kresliace plochy v prvkoch iframe v jednom zobrazení. Posúvajte sa pomocou trackpadu a približujte alebo odďaľujte gestom zovretia či stlačením Ctrl+kolieskom.
Pri práci s agentmi umelej inteligencie je to užitočné, pretože získate vizuálny prehľad každej stránky bez prepínania kariet alebo prechádzania administráciou WordPress. Keď agent upraví šablónu stránky, výsledok uvidíte okamžite. Zapnite živý režim a plátno sa pri zmene súborov automaticky obnoví.
Povoľte ho v blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Potom prejdite na /wp-admin/admin.php?page=blockstudio-canvas. Prepínajte medzi zobrazením stránok (plnošírkové kresliace plochy) a zobrazením blokov (mriežka všetkých registrovaných blokov s predvolenými hodnotami).
Výber prvkov
výber prvkov rieši častý problém pri práci s agentmi umelej inteligencie: ako agentovi oznámiť, ktorý súbor vykresľuje konkrétny prvok na stránke.
Pridajte ?blockstudio-devtools k ľubovoľnej adrese URL frontendu a potom na 100 ms podržte Cmd+C (Mac) alebo Ctrl+C (Windows). Aktivuje sa výberový zameriavač, ktorý pri pohybe kurzora zvýrazňuje bloky Blockstudio. Kliknutím na prvok skopí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 svojho nástroja na programovanie s umelou inteligenciou a agent okamžite zistí cestu k súboru, štruktúru HTML aj prvok, na ktorý ukazujete. Už nemusíte ručne hľadať cesty k súborom šablón.
Povoľte ho v blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktické postupy
Vytvorenie jedného bloku
Najjednoduchší postup: opíšte, čo chcete, a nechajte agenta, aby to vytvoril.
Pokyn:
Vytvor blok s referenciou, ktorý bude obsahovať polia pre citát (textarea), meno autora (text), rolu autora (text) a fotografiu autora (files). Na úpravu štýlov použi Tailwind. Citát má byť veľkým kurzívnym písmom s ozdobným úvodzovkovým znamienkom.
Agent vytvorí:
blockstudio/testimonial/
├── block.json
└── index.php
Vytvorenie celej stránky
Vďaka stránkam Blockstudio založeným na súboroch môže agent pripraviť celú stránku WordPress ako šablónu. Práve tu sa ukazuje ich skutočná sila: namiesto postupného vytvárania blokov agent na jeden záťah vytvorí kompletnú štruktúru stránky so všetkými blokmi.
Pokyn:
Vytvor stránku „O nás“ s úvodnou sekciou, mriežkou tímu a zástupným textom kontaktného formulára. Ak je to možné, použi existujúce bloky a podľa potreby vytvor nové. Priraď ju k ID príspevku 2. Uzamkni šablónu, ale povoľ úpravu obsahu nadpisov a odsekov.
Agent vytvorí:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
A tiež všetky vlastné bloky, na ktoré sa odkazuje (e.g, blockstudio/team-member/). Spustením
wp bs pages sync vytvoríte príspevok WordPress s uzamknutou šablónou a
ovládacími prvkami na úpravu. Celá stránka je spravovaná vo verziovacom systéme a reprodukovateľná.
Vytvorenie celého webu
Tu sa naplno prejaví sila architektúry Blockstudio. Jediným pokynom možno vygenerovať celý web, pretože každý výstup je súbor:
Pokyn:
Vytvor portfóliový web s týmito stránkami: Domov, Práca, O nás, Kontakt. Vytvor vlastné bloky pre úvodnú sekciu, mriežku projektov, kartu projektu, člena tímu, kontaktné údaje a pätu stránky. Použi tmavú tému s Tailwind. Nastav Tailwind v blockstudio.json s vlastnou paletou farieb.
Agent vytvorí adresáre blokov, šablóny stránok a blockstudio.json s konfiguráciou Tailwind, prípadne aj vzory pre opakovane použiteľné sekcie. Všetko sa uloží do git ako jedna sada zmien.
Paralelné pracovné postupy agentov
Niektoré nástroje (desktopová aplikácia Codex, GitHub Copilot CLI, Kilo Code) podporujú súbežnú prácu viacerých agentov. Vďaka architektúre Blockstudio, kde má každý blok vlastný súbor, je to bezpečné:
- Agent 1: vytvorí úvodný blok a domovskú stránku
- Agent 2: vytvorí blok karty projektu a stránku s prácami
- Agent 3: vytvorí blok kontaktného formulára a kontaktnú stránku
Keďže každý blok má vlastný adresár a štýly Tailwind sú priamo v šablónach, agenti si nebudú navzájom prekážať. Jediný spoločný súbor je blockstudio.json, ktorý zvyčajne stačí nastaviť raz na začiatku.
Tipy na lepšie výsledky
-
Odkážte na kontextový súbor pre LLM. Agenti vytvoria výrazne kvalitnejší kód Blockstudio, keď majú prístup k dokumentácii frameworku. Vždy ich nasmerujte na
blockstudio-llm.txta pre samotný projekt im poskytnite vygenerovaný súborAGENTS.md. -
Presne určte typy polí. Namiesto „pridaj pole pre obrázok“ povedzte „pridaj pole typu files s
allowedTypes: ['image']areturnFormat: 'object'“. Čím presnejšie definujete polia, tým menej úprav bude potrebných. -
Začnite jedným blokom a potom rozšírte projekt. Nechajte agenta správne vytvoriť jeden blok, skontrolujte jeho vzory a potom ho požiadajte, aby podľa rovnakých konvencií vytvoril aj zvyšok. Tak vznikne predloha, ktorá zlepší ďalšie výstupy.
-
Skontrolujte výsledok. Vibe coding neznamená slepo prijímať kód. Skontrolujte, či typy polí zodpovedajú vášmu zámeru, šablóny sa správne vykresľujú a triedy Tailwind vytvárajú požadovaný vizuálny výsledok. Kód vygenerovaný umelou inteligenciou treba pred nasadením skontrolovať.
-
Používajte schémy
block.json. Blockstudio poskytuje schému JSON na adresehttps://blockstudio.dev/schema/block. Pridaním"$schema"do svojho block.json získajú agenti spätnú väzbu o validácii a predídu sa chybné konfigurácie. -
Bloky navrhujte malé a účelové. Pre každý vizuálny komponent vytvorte jeden blok. Agentovi sa bude ľahšie analyzovať a šablóny budú dosť krátke na spracovanie v rámci jedného priechodu kontextovým oknom.