Vibe kódolás Blockstudio segítségével
Andrej Karpathy 2025. februárjában alkotta meg a „vibe coding” kifejezést 2025 annak a munkafolyamatnak a leírására, amelyben elmondod egy MI-nek, mit szeretnél, az pedig megírja a kódot. Egy évvel később ez a gyakorlat kiforrottabbá vált: ma már „agentic engineering”-nek nevezi, amikor a fejlesztők MI-ügynököket irányítanak ahelyett, hogy sorról sorra írnák a kódot.
A Blockstudio erre készült. Fájlalapú architektúrája, buildeszközök hiánya és kiszámítható projektstruktúrája az MI-vel támogatott WordPress fejlesztés egyik legjobb környezetévé teszi.
Ez az útmutató gyakorlati mintákat mutat be az MI-kódoló ügynökök Blockstudio projektekben való használatához, a projekt beállításától a teljes webhely létrehozásáig.
Miért működik jól a Blockstudio az MI-ügynökökkel?
Fájlok, nem adatbázisok
Az MI-kódoló ügynökök fájlokat olvasnak és írnak. Ez az elsődleges kezelőfelületük. A Blockstudio minden elemet a fájlrendszerben tárol: minden blokkhoz egy block.json fájlt és egy sablonfájlt, minden oldalhoz egy page.json fájlt, minden mintához pedig egy pattern.json fájlt. Nincsenek kezelendő adatbázis-bejegyzések, végigkattintandó adminisztrációs UI felületek vagy futtatandó buildlépések.
Ez azért fontos, mert a fájlrendszerek és a parancsértelmező parancsai jelentik az LLM-ek előtanítási adatainak egyik legnagyobb forrását. Minden modell több millió példát látott már fájlok olvasására, írására és rendszerezésére. Ha a WordPress-fejlesztési munkafolyamatod ugyanezt a kezelőfelületet követi, az ügynökök minimális útmutatással is tudnak dolgozni.
Kiszámítható struktúra
Minden Blockstudio blokk ugyanazt a mintát követi:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Ennek az egységességnek köszönhetően egy ügynök, amely már létrehozott egy blokkot, akár százat is létre tud hozni. Nincsenek meglepetések, különleges esetek vagy rejtett konfigurációk. Ugyanez a minta érvényes az oldalakra (page.json + sablon), a mintákra (pattern.json + sablon) és a bővítményekre (extend.json) is.
Teljes oldalak fájlokként
A hagyományos WordPress-oldalkészítéshez a blokk szerkesztő szükséges: blokkok húzása, beállítások megadása, mentés az adminisztrációs felületen. Az MI-ügynökök ezeket nem tudják elvégezni. Fájlokra van szükségük.
A Blockstudio fájlalapú oldalai teljesen megoldják ezt. Egy page.json határozza meg az oldal metaadatait, egy index.php sablon pedig a blokkstruktúrát a HTML használatával:
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>
Egy ügynök két fájl megírásával teljes WordPress-oldalt hozhat létre, alapblokkokkal, egyéni blokkokkal, sablonzárral és szerkesztési vezérlőkkel együtt. Futtasd a wp bs pages sync parancsot, hogy a forrást alkalmazd a WordPress elemre; az adminisztrációs felület megnyitása önmagában nem végzi el ezt a szinkronizálást.
Ez az MI-vel támogatott fejlesztés egyik leghatékonyabb funkciója. Ahelyett, hogy leírnád az oldal elrendezését, majd kézzel állítanád össze a szerkesztőben, elmondhatod egy ügynöknek, és az megírja a sablont. Az eredmény verziókövethető és reprodukálható, ráadásul másodpercek alatt továbbfejleszthető.
Nincs buildlépés
Semmit sem kell lefordítani, csomagolni vagy transzpilálni. Az ügynök létrehoz egy fájlt, és az rögtön működik. A SCSS szerveroldalon fordul le. Az ES-modulok futásidőben oldódnak fel. A Tailwind CSS minden frontendkérésnél lefordul. A lehető legrövidebb a visszacsatolás az „ügynök megírja a kódot” és a „kód fut a böngészőben” között.
Miért a Tailwind CSS a megfelelő választás?
A Blockstudio támogatja a hagyományos CSS-t és a Tailwind CSS-t is, de az Tailwind jelentős előnyt kínál az MI-ügynökökkel végzett munkában.
Az LLM-ek jól ismerik a Tailwind-t
A Tailwind CSS több tízezer nyílt forráskódú adattárban használatos. Ez biztosítja a Claude.ai, a Vercel, a Shopify, a Cursor és az OpenAI saját termékeinek felületeit is. Mivel sokszor szerepel a tanítóadatokban, az LLM-ek nagy pontossággal generálnak Tailwind osztályokat, és ritkán találnak ki nem létező segédosztályokat.
Az osztályok készlete véges és jól meghatározott. Az ügynök nem találhat ki nem létező CSS-tulajdonságot, így a szabadon írt CSS-hez képest jelentősen kevesebb stílushiba fordul elő, hiszen ott az ügynök érvénytelen szelektorokat generálhat, vagy félreértheti a lépcsőzetes szabályok működését.
A stílusok a jelölésben vannak
A Tailwind használatakor minden stílusinformáció az HTML sablonban található. Az ügynök egy helyen látja az elem teljes vizuális leírását. Nem kell külön .css fájlok között keresgélnie, megértenie a lépcsőzetes sorrendet vagy nyomon követnie a specificitási ütközéseket.
Ez különösen hasznos a Blockstudio blokkoknál, ahol a sablon eleve egyetlen fájl. Az ügynök egy lépésben létrehozhat egy teljes, stílusokkal ellátott komponenst:
<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>
Párhuzamos ügynökök ütközések nélkül
Mivel a Tailwind stílusai sablononként külön vannak kezelve, több ügynök (vagy fejlesztő) dolgozhat egyszerre különböző blokkokon CSS-es összeolvasztási ütközések nélkül. Nincs közös stíluslap, ahol az egyik komponens módosítása véletlenül elrontaná a másikat. Minden blokk önálló egység.
Ez a hagyományos CSS-vel is jól működik, ha a Blockstudio sablonhoz kötött stílusait (style.scoped.css) használod, de az Tailwind teljesen kiküszöböli az CSS fájlt, így blokkonként eggyel kevesebb fájlt kell kezelnie az ügynöknek.
A hagyományos CSS továbbra is használható
Az Tailwind használata nem kötelező. A Blockstudio eszközlánca automatikusan kezeli az .css és .scss fájlokat, beleértve a blokkhoz névtérrel ellátott, sablonhoz kötött stílusokat is. Ha a projekted más CSS-módszertant használ, az ügynökök azzal is tudnak dolgozni. Az Tailwind előnye egyszerűen az, hogy az LLM-ek a tanítóadatok lefedettsége és a stílusok, valamint a jelölés egy helyen való tárolása miatt jobban boldogulnak vele.
MI-kódoló ügynökök
Az alábbi CLI-eszközök mindegyike azonnal használható Blockstudio-projektekben. Fájlokat olvasnak és írnak, parancsértelmező-parancsokat futtatnak, és a kontextusfájlokból megértik a projekt felépítését.
Parancssori ügynökök (CLI)
| Eszköz | Szolgáltató | Megjegyzések |
|---|---|---|
| Claude Code | Anthropic | Elsősorban terminálban használható ügynök. A projekt kontextusához a CLAUDE.md fájlt olvassa. |
| Codex CLI | OpenAI | Nyílt forráskódú CLI, Rust készült. Asztali alkalmazásként is elérhető. |
| Gemini CLI | Nyílt forráskódú, egymillió tokenes kontextusablakkal. A GEMINI.md fájlt olvassa. |
|
| GitHub Copilot CLI | GitHub | Felfedezésre, feladatokra, tervezésre és ellenőrzésre szakosodott párhuzamos ügynökök. |
| Aider | Nyílt forráskódú | Több mint 100 LLM-szolgáltatót támogat, a helyi modelleket is beleértve. |
| OpenCode | Nyílt forráskódú | Terminálos TUI LSP-integrációval. Több mint 75 szolgáltatót támogat. |
| Amazon Q Developer CLI | AWS | Ingyenes csomag is elérhető. Különösen jól használható AWS-integrált projektekhez. |
IDE-ügynökök
| Eszköz | Szolgáltató | Megjegyzések |
|---|---|---|
| Cursor | Cursor | VS Code-elágazás beépített MI-vel. CLI-t is kínál (béta). |
| Windsurf | Cognition AI | VS Code-elágazás Cascade ügynöki asszisztenssel. |
| Cline | Nyílt forráskódú | VS Code-bővítmény lépésenkénti jóváhagyással. CLI-t is kínál. |
| Kilo Code | Nyílt forráskódú | Koordinált alügynökökkel működő vezérlő mód. |
| Continue | Nyílt forráskódú | VS Code/JetBrains-bővítmény aszinkron CI/CD-ügynökökkel. |
| Augment Code | Augment | Vállalatokra szabott, mély kódbázis-indexeléssel. |
Ezek az eszközök mindegyike képes fájlokat létrehozni és szerkeszteni egy Blockstudio projektkönyvtárban. A terminálos ügynökök különösen alkalmasak erre, mert a Blockstudio fejlesztéshez nincs szükség IDE-specifikus funkciókra: teljesen fájlalapú.
A projekt beállítása MI-ügynökökhöz
Az LLM kontextusfájlja
A Blockstudio előre elkészített kontextusfájlt biztosít, amely a keretrendszer teljes dokumentációját indexeli. Ez nem összefoglaló vagy puska: minden dokumentum egyszer szerepel benne az útvonalával, rendeltetésével és a hozzá tartozó azonosítókkal, így az ügynök megkeresheti a kérdésre választ adó oldalt, és csak azt nyithatja meg. Egy második fájl a dokumentumok és sémák teljes szövegét is tartalmazza azoknak az eszközöknek, amelyek egyszerre a teljes anyagot szeretnék betölteni.
Engedélyezd a blockstudio.json fájlban:
{
"ai": {
"enableContextGeneration": true
}
}
Az index ezután a your-site.com/blockstudio-llm.txt címen, a teljes szöveg pedig a your-site.com/blockstudio-llm-full.txt címen érhető el. Irányítsd az MI-eszközödet az indexre, és további útmutatás nélkül hozzáfér a teljes Blockstudio API-dokumentációhoz. Az eszközönkénti beállításhoz lásd az MI-integrációs dokumentációt.
Ezzel nincs szükség saját, keretrendszer-specifikus útmutatások írására. A blockstudio-llm.txt-hez hozzáférő ügynök meg tudja keresni, hogyan kell blokkokat létrehozni, mezőket meghatározni, sablonokat írni, a Tailwind-t beállítani, oldalakat létrehozni és használni a keretrendszer összes hookját (Blockstudio).
Projektspecifikus kontextusfájlok
A legtöbb MI-kódoló ügynök a projekt szintjén megadott kontextusfájlt is beolvassa, amely a kódbázisra vonatkozó útmutatásokat tartalmaz. Az egyes eszközök eltérő fájlneveket használnak:
| Fájl | Eszköz |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI és mások |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Mivel a blockstudio-llm.txt már lefedi a keretrendszert, a projekt kontextusfájljában elég a projekt egyedi jellemzőit leírnod: a könyvtárak elrendezését, az elnevezési konvenciókat, a parancsokat és a korlátozásokat.
Ha telepíted a blockstudio/phpstan eszközt, nem kell kézzel megírnod ezt a leírást. A vendor/bin/blockstudio-agents a blockstudio.json alapján és a saját fájljaidból állít elő egy AGENTS.md fájlt. Felsorolja, mit készít a projekt, mely funkciók vannak engedélyezve, mit utasít el az elemzés, valamint az alkalmazható parancsokat. Nem ír felül olyan fájlt, amelyet nem ő hozott létre, újrageneráláskor pedig megőrzi a saját jegyzeteidet.
# 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
Fejlesztői eszközök MI-vel támogatott munkafolyamatokhoz
A Blockstudio két, kifejezetten az MI-vel támogatott fejlesztésre készült fejlesztői eszközt kínál.
Vászon
A vászon a Figma-hoz hasonló áttekintést ad az összes Blockstudio-oldaladról: az élő iframe-es rajztáblák egyetlen nézetben jelennek meg. A görgetőpadon pásztázhatsz, a nagyításhoz pedig csippents vagy görgess a Ctrl billentyű nyomva tartásával.
Ez MI-ügynökökkel végzett munka közben azért hasznos, mert minden oldalról vizuális áttekintést ad, anélkül hogy lapot kellene váltanod vagy a WordPress adminisztrációs felületén kellene navigálnod. Ha egy ügynök módosít egy oldalsablont, azonnal láthatod az eredményt. Élő módra váltva a vászon automatikusan frissül, amikor megváltoznak a fájlok.
Engedélyezd a blockstudio.json fájlban:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Ezután navigálj ide: /wp-admin/admin.php?page=blockstudio-canvas. Válts az oldalak nézetére (teljes szélességű rajztáblák) vagy a blokkok nézetére (az összes regisztrált blokk rácsos elrendezése alapértelmezett értékekkel).
Elemkijelölő
Az elemkijelölő megold egy gyakori problémát az MI-vel támogatott munkafolyamatokban: annak megállapítását, hogy melyik fájl jeleníti meg az oldal egy adott elemét.
Illeszd be a(z) ?blockstudio-devtools kódot bármelyik frontend URL részre, majd tartsd lenyomva a Cmd+C (Mac) vagy Ctrl+C (Windows) billentyűkombinációt 100ms-ig. Megjelenik a célkeresztválasztó, amely rámutatáskor kiemeli a(z) Blockstudio blokkokat. Kattints egy elemre a hozzá tartozó kontextus vágólapra másolásához:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Illeszd ezt be az MI-kódoló eszközödbe, és az ügynök azonnal megismeri a fájl elérési útját, a HTML struktúráját és azt az elemet, amelyre mutatsz. Nem kell többé kézzel megkeresned a sablonfájlok elérési útját.
Engedélyezd a blockstudio.json fájlban:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Gyakorlati minták
Egyetlen blokk létrehozása
A legegyszerűbb munkafolyamat: mondd el, mit szeretnél, az ügynök pedig létrehozza.
Utasítás:
Hozz létre egy véleményblokkot idézet (textarea), szerző neve (text), szerzői beosztás (text) és szerzői fotó (files) mezőkkel. A stílushoz a Tailwind-t használd. Az idézet legyen nagy, dőlt betűs, és kapjon egy díszes idézőjelet.
Az ügynök létrehozza:
blockstudio/testimonial/
├── block.json
└── index.php
Teljes oldal létrehozása
A Blockstudio fájlalapú oldalai lehetővé teszik, hogy az ügynök egy teljes WordPress-oldalt hozzon létre sablonként. Itt mutatkozik meg igazán az előnye: ahelyett, hogy egyenként építené fel a blokkokat, az ügynök egyetlen lépésben hozza létre a teljes oldalstruktúrát és az összes blokkot.
Utasítás:
Hozz létre egy „Rólunk” oldalt nyitó résszel, csapatrácsos elrendezéssel és kapcsolatfelvételi űrlaphelyőrzővel. Ahol lehet, használj meglévő blokkokat, ahol szükséges, hozz létre újakat. Rendeld a 2-es bejegyzésazonosítóhoz. Zárold a sablont, de tedd szerkeszthetővé a címsorok és bekezdések tartalmát.
Az ügynök létrehozza:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Emellett az összes hivatkozott egyéni blokkot is létrehozza (e.g, blockstudio/team-member/). Futtasd a wp bs pages sync parancsot, hogy létrehozd a WordPress bejegyzést a sablon zárolásával és a szerkesztési vezérlőkkel együtt. A teljes oldal verziókövethető és reprodukálható.
Teljes webhely létrehozása
Itt mutatkozik meg igazán a Blockstudio architektúrájának ereje. Egyetlen utasítással teljes webhely hozható létre, mivel minden elem fájl:
Utasítás:
Készíts portfólió-webhelyet a következő oldalakkal: Kezdőlap, Munkák, Rólunk, Kapcsolat. Hozz létre egyéni blokkokat a következőkhöz: nyitó rész, projekt- rács, projektkártya, csapattag, kapcsolattartási adatok és lábléc. Használj sötét témát Tailwind-val. Állítsd be a Tailwind-t a blockstudio.json rendszerben egyéni színpalettával.
Az ügynök létrehozza a blokk könyvtárait, az oldalsablonokat, egy blockstudio.json-t Tailwind konfigurációval, valamint igény szerint újrafelhasználható szakaszokhoz mintákat. Minden egyetlen módosításkészletként kerül a git-ba.
Párhuzamos ügynöki munkafolyamatok
Egyes eszközök (a Codex asztali alkalmazás, a GitHub Copilot CLI és a Kilo Code) több ügynök párhuzamos futtatását támogatják. A Blockstudio blokkonként külön fájlt használó architektúrája biztonságossá teszi ezt:
- 1. ügynök: létrehozza a nyitó blokkot és a kezdőlapot
- 2. ügynök: létrehozza a projektkártya blokkot és a munkák oldalt
- 3. ügynök: létrehozza a kapcsolatfelvételi űrlap blokkját és a kapcsolat oldalt
Mivel minden blokk saját könyvtárban van, a Tailwind stílusai pedig a sablonokban találhatók, az ügynökök nem akadnak össze egymással. Csak az blockstudio.json fájl közös, amelyet általában elég egyszer, a munka kezdetén beállítani.
Tippek a jobb eredményekhez
-
Hivatkozz az LLM kontextusfájljára. Az ügynökök lényegesen jobb Blockstudio-kódot készítenek, ha hozzáférnek a keretrendszer dokumentációjához. Mindig mutass rá az
blockstudio-llm.txtfájlra, és adj nekik egy generáltAGENTS.mdfájlt magáról a projektről. -
Add meg pontosan a mezőtípusokat. Ahelyett, hogy azt mondanád: „adj hozzá egy képmezőt”, fogalmazz így: „adj hozzá egy files mezőt a következőkkel:
allowedTypes: ['image']ésreturnFormat: 'object'.” Minél pontosabban határozod meg a mezőket, annál kevesebb módosításra lesz szükség. -
Kezdj egy blokkal, majd bővítsd a munkát. Kérd meg az ügynököt, hogy készítsen el helyesen egy blokkot, ellenőrizd a megoldásait, majd kérd meg, hogy a többit is ugyanezeket az irányelveket követve hozza létre. Így lesz egy olyan mintád, amely javítja a további eredményeket.
-
Ellenőrizd az eredményt. A vibe coding nem jelenti azt, hogy vakon el kell fogadnod a kódot. Nézd meg, hogy a mezőtípusok megfelelnek-e az igényeidnek, a sablonok megfelelően jelennek-e meg, és a Tailwind osztályok a kívánt vizuális eredményt adják-e. Az MI által generált kódot élesítés előtt ellenőrizni kell.
-
Használj
block.jsonsémákat. A Blockstudiohttps://blockstudio.dev/schema/blockcímen JSON sémát biztosít. Ha hozzáadod a"$schema"-t a block.json fájlodhoz, az ügynökök visszajelzést kapnak az érvényesítésről, és elkerülik a hibás konfigurációkat. -
Tartsd a blokkokat kicsinek és célratörőnek. Minden vizuális komponenshez egy blokkot használj. Így az ügynök könnyebben átlátja az egyes blokkokat, a sablonok pedig elég rövidek maradnak ahhoz, hogy egyetlen kontextusablakba beleférjenek.