Vibecoding z Blockstudio
Andrej Karpathy je februarja 2025 skoval izraz »vibe coding« za potek dela, pri katerem umetni inteligenci opišete, kaj želite, ta pa napiše kodo. Leto pozneje je praksa dozorela v to, čemur zdaj pravi »agentic engineering«: razvijalci usmerjajo agente umetne inteligence, namesto da bi pisali kodo vrstico za vrstico.
Blockstudio je bil ustvarjen prav za to. Njegova arhitektura, ki temelji na datotekah, odsotnost orodij za gradnjo in predvidljiva struktura projekta ga uvrščajo med najboljša okolja za razvoj WordPress s pomočjo umetne inteligence.
Ta vodnik predstavlja praktične vzorce za uporabo agentov umetne inteligence za programiranje z Blockstudio, od nastavitve projekta do izdelave celotnega spletnega mesta.
Zakaj Blockstudio dobro deluje z agenti umetne inteligence
Datoteke, ne podatkovne zbirke
Agenti umetne inteligence za programiranje berejo in pišejo datoteke. To je njihov glavni način dela. Blockstudio vse hrani v datotečnem sistemu: po en block.json in predlogovno datoteko za vsak blok, po en page.json za vsako stran in po en pattern.json za vsak vzorec. Ni treba upravljati vnosov v podatkovni zbirki, klikati po skrbniškem UI ali zagnati postopka gradnje.
To je pomembno, ker sta datotečni sistem in ukazna lupina med največjimi viri podatkov za predhodno učenje LLM-jev. Vsak model je videl milijone primerov branja, pisanja in razvrščanja datotek. Kadar se vaš razvojni potek dela z WordPress ujema s tem načinom dela, lahko agenti delujejo z minimalnimi navodili.
Predvidljiva struktura
Vsak blok Blockstudio sledi enakemu vzorcu:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Ta doslednost pomeni, da lahko agent, ki je izdelal en blok, izdela tudi sto blokov. Ni presenečenj, posebnih primerov ali skritih nastavitev. Enak vzorec velja za strani (page.json + predloga), vzorce (pattern.json + predloga) in razširitve (extend.json).
Celotne strani kot datoteke
Za izdelavo strani v tradicionalnem WordPress potrebujete urejevalnik blokov: vlečenje blokov, nastavitev možnosti in shranjevanje prek skrbniškega vmesnika. Agenti umetne inteligence tega ne zmorejo. Potrebujejo datoteke.
Funkcija Blockstudio strani na podlagi datotek to v celoti rešuje. Datoteka page.json določa metapodatke strani, predloga index.php pa strukturo blokov z uporabo 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 lahko pripravi celotno stran WordPress z osnovnimi in prilagojenimi bloki, zaklepanjem predloge ter kontrolniki za urejanje, in sicer tako, da zapiše le dve datoteki. Za uporabo izvorne vsebine v WordPress zaženite wp bs pages sync; odprtje skrbniškega vmesnika te sinhronizacije ne izvede samodejno.
To je ena najzmogljivejših funkcij za razvoj s pomočjo umetne inteligence. Namesto da opišete postavitev strani in jo ročno sestavite v urejevalniku, jo opišete agentu, ki napiše predlogo. Rezultat je pod nadzorom različic, ponovljiv in ga je mogoče v nekaj sekundah izboljšati.
Brez postopka gradnje
Ničesar ni treba prevesti, združiti ali pretvoriti. Agent ustvari datoteko in ta takoj deluje. SCSS se prevede na strežniku. Moduli ES se razrešijo med izvajanjem. Tailwind CSS se prevede ob vsaki zahtevi odjemalca. Povratna zanka med tem, ko agent napiše kodo, in njenim izvajanjem v brskalniku je tako kratka, kot je le mogoče.
Zakaj je Tailwind CSS prava izbira
Blockstudio podpira običajni CSS in Tailwind CSS, vendar ima Tailwind pomembno prednost pri delu z agenti umetne inteligence.
LLM-ji zelo dobro poznajo Tailwind
Tailwind CSS se uporablja v več deset tisoč odprtokodnih repozitorijih. Poganja vmesnike izdelkov, kot so Claude.ai, Vercel, Shopify, Cursor in izdelki podjetja OpenAI. Zaradi razširjenosti v podatkih za učenje LLM-ji zelo natančno ustvarjajo razrede Tailwind in le redko izmišljajo neobstoječe pripomočke.
Nabor razredov je končen in jasno določen. Agent si ne more izmisliti lastnosti CSS, ki ne obstaja, zato je napak pri oblikovanju bistveno manj kot pri pisanju poljubne kode CSS, kjer lahko agent ustvari neveljavne izbirnike ali napačno razume delovanje kaskade.
Slogi so zapisani v označevalni kodi
Pri Tailwind so vsi podatki o slogu shranjeni skupaj v predlogi HTML. Agent na enem mestu vidi celoten vizualni opis elementa. Ni mu treba iskati po ločenih datotekah .css, razumeti vrstnega reda kaskade ali spremljati sporov glede specifičnosti.
To je še posebej uporabno pri blokih Blockstudio, katerih predloga je že ena sama datoteka. Agent lahko v enem koraku ustvari popolno oblikovano komponento:
<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>
Vzporedni agenti brez sporov
Ker so slogi Tailwind omejeni na posamezne predloge, lahko več agentov (ali razvijalcev) hkrati dela na različnih blokih brez sporov pri združevanju CSS. Skupna datoteka s slogi ne obstaja, zato spremembe ene komponente ne morejo po nesreči pokvariti druge. Vsak blok je samostojen.
To dobro deluje tudi pri običajnem CSS, če uporabite sloge Blockstudio, omejene na komponento (style.scoped.css), vendar Tailwind v celoti odpravi datoteko CSS, kar pomeni, da mora agent za vsak blok upravljati eno datoteko manj.
Običajni CSS je še vedno uporaben
Tailwind ni obvezen. Zbirka orodij za vire v Blockstudio samodejno obravnava datoteke .css in .scss, vključno s slogi, omejenimi na komponento, ki dobijo imenski prostor bloka. Če vaš projekt uporablja drugo metodologijo CSS, lahko agenti delajo tudi z njo. Prednost uporabe Tailwind je zgolj v tem, da so LLM-ji zaradi obsega podatkov za učenje in bližine slogov označevalni kodi pri tem uspešnejši.
Agenti umetne inteligence za programiranje
Vsa naslednja orodja CLI lahko takoj uporabljate s projekti Blockstudio. Berejo in zapisujejo datoteke, izvajajo ukaze lupine ter razumejo strukturo projekta na podlagi kontekstnih datotek.
Agenti za terminal (CLI)
| Orodje | Ponudnik | Opombe |
|---|---|---|
| Claude Code | Anthropic | Agent, zasnovan predvsem za terminal. Za kontekst projekta bere CLAUDE.md. |
| Codex CLI | OpenAI | Odprtokodni CLI, izdelan z Rust. Na voljo je tudi kot namizna aplikacija. |
| Gemini CLI | Odprtokodno orodje z 1M žetoni v kontekstnem oknu. Bere GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Specializirani vzporedni agenti za raziskovanje, naloge, načrtovanje in pregled. |
| Aider | Odprtokodno | Podpira 100+ ponudnikov LLM-jev, vključno z lokalnimi modeli. |
| OpenCode | Odprtokodno | Terminalski TUI z integracijo LSP. Podpira več kot 75 ponudnikov. |
| Amazon Q Developer CLI | AWS | Na voljo je brezplačna različica. Odlično deluje s projekti, integriranimi z AWS. |
Agenti za IDE
| Orodje | Ponudnik | Opombe |
|---|---|---|
| Cursor | Cursor | VS Code različica z vgrajeno umetno inteligenco. Na voljo je tudi CLI (beta). |
| Windsurf | Cognition AI | Različica VS Code z vgrajenim agentom Cascade. |
| Cline | Odprtokodno | Razširitev VS Code s potrjevanjem po korakih. Na voljo je tudi CLI. |
| Kilo Code | Odprtokodno | Način orkestratorja z usklajenimi podrejenimi agenti. |
| Continue | Odprtokodno | Razširitev VS Code/JetBrains z asinhronimi agenti CI/CD. |
| Augment Code | Augment | Namenjeno podjetjem z naprednim indeksiranjem kodne zbirke. |
Vsa ta orodja lahko ustvarjajo in urejajo datoteke v projektnem imeniku Blockstudio. Agenti za terminal so še posebej primerni, ker razvoj z Blockstudio ne zahteva posebnih funkcij IDE-ja in temelji izključno na datotekah.
Priprava projekta za agente umetne inteligence
Kontekstna datoteka za LLM
Blockstudio vključuje vnaprej pripravljeno kontekstno datoteko, ki indeksira celotno dokumentacijo ogrodja. To ni povzetek ali priročnik: vsak dokument je naveden enkrat skupaj s svojo potjo, namenom in identifikatorji, za katere je pristojen, zato lahko agent poišče stran z odgovorom na vprašanje in odpre samo njo. Celotno besedilo vseh dokumentov in shem je na voljo v drugi datoteki za orodja, ki želijo hkrati pregledati celotno zbirko.
Omogočite jo v svojem blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Kazalo je zdaj na voljo na your-site.com/blockstudio-llm.txt, celotno besedilo pa na your-site.com/blockstudio-llm-full.txt. Usmerite svoje orodje AI na kazalo in dostopa lahko do celotne Blockstudio API brez dodatnih navodil. Za nastavitev posameznih orodij si oglejte dokumentacijo o integraciji z umetno inteligenco.
S tem vam ni treba več sami pisati navodil, prilagojenih ogrodju. Agent z dostopom do blockstudio-llm.txt lahko poišče navodila za ustvarjanje blokov, določanje polj, pisanje predlog, nastavitev Tailwind, pripravo strani in uporabo vseh kavljev, ki jih ponuja Blockstudio.
Kontekstne datoteke za posamezen projekt
Večina agentov umetne inteligence za programiranje bere tudi kontekstno datoteko na ravni projekta, ki vsebuje navodila, prilagojena vaši kodni zbirki. Uporabljena datoteka je odvisna od orodja:
| Datoteka | Orodje |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI in druga orodja |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Ker blockstudio-llm.txt že pokriva ogrodje, mora vaša kontekstna datoteka za projekt opisovati le posebnosti projekta: razporeditev imenikov, pravila poimenovanja, ukaze in omejitve.
Če namestite blockstudio/phpstan, vam tega opisa ni treba pisati ročno. vendor/bin/blockstudio-agents iz blockstudio.json in vaših datotek ustvari AGENTS.md, v katerem navede, kaj projekt ustvarja, katere funkcije so omogočene, kaj bo analiza zavrnila in kateri ukazi so na voljo. Datoteke, ki je ni ustvaril sam, ne prepiše; ob ponovni izdelavi pa ohrani vaše opombe.
# 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
Orodja za razvijalce pri delu z umetno inteligenco
Blockstudio vključuje dve orodji za razvijalce, zasnovani posebej za razvoj s pomočjo umetne inteligence.
Platno
platno ponuja pregled vseh vaših strani Blockstudio v slogu Figma, prikazanih kot delovne površine v živih okvirih iframe v enem pogledu. Pomikajte se s sledilno ploščico, povečujte pa s potezo za približevanje ali Ctrl+pomikom.
To je uporabno pri delu z agenti umetne inteligence, saj omogoča vizualni pregled vseh strani brez preklapljanja med zavihki ali brskanja po skrbniškem vmesniku WordPress. Ko agent spremeni predlogo strani, lahko rezultat vidite takoj. Vklopite način v živo in platno se bo samodejno osvežilo ob spremembi datotek.
Omogočite jo v blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Nato odprite /wp-admin/admin.php?page=blockstudio-canvas. Preklapljate lahko med pogledom strani (delovne površine čez celotno širino) in pogledom blokov (mreža vseh registriranih blokov s privzetimi vrednostmi).
Izbirnik elementov
izbirnik elementov rešuje pogost zaplet pri delu z agenti umetne inteligence: ugotavljanje, katera datoteka izriše določen element na strani.
Frontendu URL dodajte ?blockstudio-devtools, nato za 100 ms pridržite Cmd+C (Mac) ali Ctrl+C (Windows). Aktivira se izbirnik z nitnim križem, ki med premikanjem kazalca označuje bloke Blockstudio. Kliknite element, da kopirate njegov kontekst v odložišče:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Prilepite to v orodje umetne inteligence za programiranje in agent bo takoj poznal pot do datoteke, strukturo HTML in element, na katerega kažete. Iskanje poti do datotek predlog ni več potrebno.
Omogočite jo v blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktični vzorci
Izdelava posameznega bloka
Najpreprostejši potek dela: opišite, kaj želite, in pustite agentu, da to ustvari.
Poziv:
Ustvari blok s pričevanjem, ki vsebuje polja za citat (večvrstično besedilo), ime avtorja (besedilo), vlogo avtorja (besedilo) in fotografijo avtorja (datoteke). Za oblikovanje uporabi Tailwind. Citat naj bo v veliki ležeči pisavi z okrasnim narekovajem.
Agent bo ustvaril:
blockstudio/testimonial/
├── block.json
└── index.php
Izdelava celotne strani
Funkcija Blockstudio strani na podlagi datotek agentu omogoča, da celotno stran WordPress pripravi kot predlogo. Tu se pokaže vsa prednost: namesto postopne izdelave blokov agent v enem koraku ustvari celotno strukturo strani z vsemi bloki.
Poziv:
Ustvari stran »O nas« z uvodnim razdelkom, mrežo ekipe in nadomestnim obrazcem za stik. Kjer je mogoče, uporabi obstoječe bloke, po potrebi pa ustvari nove. Poveži jo z ID-jem objave 2. Predlogo zakleni, naslove in odstavke pa omogoči urejati kot vsebino.
Agent ustvari:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Poleg tega ustvari vse uporabljene prilagojene bloke (e.g., blockstudio/team-member/). Za ustvarjanje objave WordPress z zaklenjeno predlogo in kontrolniki za urejanje zaženi wp bs pages sync. Celotna stran je pod nadzorom različic in jo je mogoče znova ustvariti.
Izdelava celotnega spletnega mesta
Tu resnično pride do izraza arhitektura Blockstudio. Z enim samim pozivom lahko ustvarite celotno spletno mesto, saj je vsak element datoteka:
Poziv:
Izdelaj portfeljsko spletno mesto s temi stranmi: Domov, Delo, O nas, Stik. Ustvari prilagojene bloke za: uvodni razdelek, mrežo projektov, kartico projekta, člana ekipe, podatke za stik in nogo. Uporabi temno temo z Tailwind. V blockstudio.json nastavi Tailwind s prilagojeno barvno paleto.
Agent ustvari imenike blokov, predloge strani, blockstudio.json s konfiguracijo Tailwind in po želji vzorce za znova uporabne razdelke. Vse je vključeno v git kot en sam nabor sprememb.
Poteki dela z vzporednimi agenti
Nekatera orodja (namizna aplikacija Codex, GitHub Copilot CLI, Kilo Code) podpirajo vzporedno izvajanje več agentov. Arhitektura Blockstudio, ki za vsak blok uporablja svojo datoteko, to omogoča brez težav:
- Agent 1: izdela uvodni blok in domačo stran
- Agent 2: izdela blok s kartico projekta in stran z deli
- Agent 3: izdela blok z obrazcem za stik in stran s stiki
Ker je vsak blok v svojem imeniku, slogi Tailwind pa so shranjeni skupaj s predlogami, se ti agenti med seboj ne bodo ovirali. Edina skupna datoteka je blockstudio.json, ki jo je običajno treba nastaviti le enkrat na začetku.
Nasveti za boljše rezultate
-
Navedite kontekstno datoteko za LLM. Agenti ustvarijo bistveno boljšo kodo Blockstudio, če lahko dostopajo do dokumentacije ogrodja. Vedno jih usmerite na
blockstudio-llm.txtin jim za sam projekt zagotovite ustvarjeniAGENTS.md. -
Natančno določite vrste polj. Namesto »dodaj slikovno polje« recite »dodaj polje vrste files z
allowedTypes: ['image']inreturnFormat: 'object'«. Natančnejša kot je opredelitev polj, manj ponovitev bo potrebnih. -
Začnite z enim blokom, nato razširite obseg. Agent naj pravilno izdela en blok. Preglejte njegove vzorce, nato mu naročite, naj preostale izdela po enakih pravilih. Tako vzpostavite zgled, ki izboljša naslednje rezultate.
-
Preglejte rezultat. Vibe coding ne pomeni, da kodo sprejmete brez premisleka. Preverite, ali vrste polj ustrezajo vašim namenom, ali se predloge pravilno izrisujejo in ali razredi Tailwind ustvarijo ustrezen vizualni rezultat. Kodo, ustvarjeno z umetno inteligenco, je treba pregledati pred objavo.
-
Uporabite sheme
block.json. Blockstudio ponuja shemo JSON na naslovuhttps://blockstudio.dev/schema/block. Če v block.json dodate"$schema", agenti dobijo povratne informacije o preverjanju in se izognejo nepravilnim konfiguracijam. -
Bloki naj bodo majhni in osredotočeni. Za vsako vizualno komponento uporabite en blok. Tako agent lažje razume vsak blok, predloge pa ostanejo dovolj kratke, da jih lahko obdela v enem prehodu kontekstnega okna.