Ugrás a tartalomhoz

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:

Kód
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:

Kód
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>

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:

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>

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 Google 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:

JSON
{
  "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.

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

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:

JSON
{
  "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:

Kód
@<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:

JSON
{
  "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:

Kód
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:

Kód
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

  1. 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.txt fájlra, és adj nekik egy generált AGENTS.md fájlt magáról a projektről.

  2. 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'] és returnFormat: 'object'.” Minél pontosabban határozod meg a mezőket, annál kevesebb módosításra lesz szükség.

  3. 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.

  4. 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.

  5. Használj block.json sémákat. A Blockstudio https://blockstudio.dev/schema/block cí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.

  6. 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.