Vibe-koodimine Blockstudio-ga
Andrej Karpathy võttis veebruaris 2025 kasutusele termini „vibe coding“, et kirjeldada töövoogu, kus annad tehisintellektile teada, mida soovid, ja see kirjutab koodi. Aasta hiljem on sellest praktikast välja kujunenud midagi, mida ta nimetab nüüd „agendipõhiseks arenduseks“: arendajad juhivad tehisintellekti agente, selle asemel et rida-realt koodi kirjutada.
Blockstudio on loodud just selleks. Failipõhine arhitektuur, ehitustööriistade puudumine ja etteaimatav projektistruktuur teevad sellest ühe parima keskkonna AI abil WordPress arendamiseks.
See juhend käsitleb praktilisi võtteid AI-koodiagentide kasutamiseks koos Blockstudio-iga alates projekti seadistamisest kuni terve saidi loomiseni.
Miks Blockstudio sobib AI-agentidega hästi
Failid, mitte andmebaasid
AI-koodiagendid loevad ja kirjutavad faile. See on nende peamine tööliides. Blockstudio hoiab kõike failisüsteemis: iga ploki jaoks block.json ja mallifail, iga lehe jaoks page.json, iga mustri jaoks pattern.json. Pole vaja hallata andmebaasikirjeid, klõpsida läbi haldusliidest UI ega käivitada ehitustoimingut.
See on oluline, sest failisüsteemid ja shell-käsud moodustavad ühe suurima LLM-ide eeltreeninguandmete allika. Iga mudel on näinud miljoneid näiteid failide lugemisest, kirjutamisest ja korraldamisest. Kui teie WordPress-arenduse töövoog kasutab sama liidest, saavad agendid töötada väheste juhistega.
Etteaimatav struktuur
Iga Blockstudio plokk järgib sama mustrit:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
See järjepidevus tähendab, et agent, kes on loonud ühe ploki, suudab luua sada. Üllatusi, erandeid ega peidetud seadistusi pole. Sama muster kehtib lehtede (page.json + mall), mustrite (pattern.json + mall) ja laienduste (extend.json) puhul.
Terved lehed failidena
Traditsiooniline WordPress lehtede loomine nõuab plokiredaktori kasutamist: plokkide lohistamist, seadete määramist ja haldusliidese kaudu salvestamist. AI-agendid ei saa seda teha. Nad vajavad faile.
Blockstudio failipõhised lehed lahendavad selle täielikult. page.json määrab lehe metaandmed ja index.php mall määrab plokkide struktuuri, kasutades 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 saab luua kogu WordPress lehe karkassi koos põhiplokkide, kohandatud plokkide, mallilukustuse ja muutmisjuhtnuppudega, kirjutades vaid kaks faili. Käivitage wp bs pages sync, et rakendada lähteandmed WordPress-ile; haldusliidese avamine seda sünkroonimist automaatselt ei käivita.
See on üks võimsamaid AI abil arendamise võimalusi. Selle asemel et lehe paigutust kirjeldada ja see redaktoris käsitsi kokku panna, kirjeldate seda agendile ja see kirjutab malli. Tulemus on versioonihalduses, korratav ja sekunditega muudetav.
Ehitusetapp puudub
Midagi pole vaja kompileerida, komplekteerida ega transpileerida. Agent loob faili ja see töötab kohe. SCSS kompileeritakse serveris. ES-moodulid lahendatakse käitusajal. Tailwind CSS kompileeritakse iga esilehe päringuga. Tagasiside agenti kirjutatud koodi ja brauseris töötava koodi vahel on võimalikult kiire.
Miks valida Tailwind CSS
Blockstudio toetab nii tavalist CSS-i kui ka Tailwind CSS-i, kuid Tailwind-il on AI-agentidega töötamisel märkimisväärne eelis.
LLM-id tunnevad Tailwind-i väga hästi
Tailwind CSS-i kasutatakse kümnetes tuhandetes avatud lähtekoodiga hoidlates. See annab jõudu järgmiste liidestele: Claude.ai, Vercel, Shopify, Cursor ja OpenAI enda tooted. Selline levik treeningandmetes tähendab, et LLM-id loovad Tailwind klasse täpselt ega hallutsineeri peaaegu kunagi olematuid utiliite.
Klasside sõnavara on piiratud ja selgelt määratletud. Agent ei saa välja mõelda olematut CSS omadust, mis vähendab kujundusvigu märgatavalt võrreldes vabavormilise CSS-iga, kus agent võib luua vigaseid selektoreid või mõista kaskaadi käitumist valesti.
Stiilid asuvad märgenduses
Tailwind-i puhul on kogu stiiliteave HTML mallis koos. Agent näeb elemendi täielikku visuaalset kirjeldust ühes kohas. Eraldi .css failidele viitamine, kaskaadi järjekorra mõistmine ega spetsiifilisuse konfliktide jälgimine pole vajalik.
See on eriti tõhus Blockstudio plokkide puhul, kus mall on juba üks fail. Agent saab ühe korraga luua tervikliku, kujundatud komponendi:
<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>
Paralleelsed agendid konfliktideta
Kuna Tailwind stiilid piirduvad iga malliga, saavad mitu agenti või arendajat töötada korraga eri plokkidega, ilma et tekiks CSS liitmisvastuolusid. Ühist stiililehte pole, kus ühe komponendi muudatus teise kogemata lõhuks. Iga plokk on iseseisev.
See toimib hästi ka tavalise CSS-iga, kui kasutada Blockstudio ulatusega piiratud stiile (style.scoped.css), kuid Tailwind jätab CSS faili täielikult ära, nii et agendil on iga ploki kohta üks fail vähem hallata.
Tavaline CSS töötab endiselt
Tailwind pole kohustuslik. Blockstudio varade töövoog käsitleb .css ja .scss faile automaatselt, sealhulgas ploki nimeruumiga piiratud stiile. Kui teie projekt kasutab teistsugust CSS meetodit, saavad agendid töötada ka sellega. Tailwind eelis seisneb lihtsalt selles, et treeningandmete rohkuse ning stiilide ja märgenduse koospaiknemise tõttu saavad LLM-id sellega paremini hakkama.
AI-koodiagendid
Järgmised CLI tööriistad saavad Blockstudio projektidega kohe töötada. Need loevad ja kirjutavad faile, käivitavad shell-käske ning mõistavad projektistruktuuri kontekstifailide põhjal.
Terminaliagendid (CLI)
| Tööriist | Pakkuja | Märkused |
|---|---|---|
| Claude Code | Anthropic | Terminalikeskne agent. Loeb projekti konteksti jaoks faili CLAUDE.md. |
| Codex CLI | OpenAI | Avatud lähtekoodiga CLI, loodud Rust-is. Saadaval ka töölauarakendusena. |
| Gemini CLI | Avatud lähtekoodiga, 1M tokeni kontekstiaknaga. Loeb faili GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Spetsialiseeritud paralleelagendid uurimiseks, ülesannete täitmiseks, planeerimiseks ja ülevaatuseks. |
| Aider | Avatud lähtekoodiga | Toetab enam kui 100 LLM-i pakkujat, sealhulgas kohalikke mudeleid. |
| OpenCode | Avatud lähtekoodiga | Terminali TUI LSP-integratsiooniga. Toetab enam kui 75 pakkujat. |
| Amazon Q Developer CLI | AWS | Saadaval on tasuta pakett. Sobib hästi AWS-iga integreeritud projektidele. |
IDE agendid
| Tööriist | Pakkuja | Märkused |
|---|---|---|
| Cursor | Cursor | VS Code haru sisseehitatud AI-ga. Saadaval on ka CLI (beeta). |
| Windsurf | Cognition AI | VS Code haru Cascade’i agendiga assistendiga. |
| Cline | Avatud lähtekoodiga | VS Code laiendus sammhaaval kinnitamisega. Saadaval on ka CLI. |
| Kilo Code | Avatud lähtekoodiga | Orkestreerimisrežiim koordineeritud alamagentidega. |
| Continue | Avatud lähtekoodiga | VS Code/JetBrains laiendus asünkroonsete CI/CD agentidega. |
| Augment Code | Augment | Ettevõtetele suunatud tööriist põhjaliku koodibaasi indekseerimisega. |
Kõik need tööriistad saavad Blockstudio projektikataloogis faile luua ja muuta. Terminaliagendid sobivad selleks eriti hästi, sest Blockstudio arendus ei vaja IDE-spetsiifilisi funktsioone: see põhineb täielikult failidel.
Projekti ettevalmistamine AI-agentide jaoks
LLM-i kontekstifail
Blockstudio sisaldab valmis kontekstifaili, mis indekseerib kogu raamistiku dokumentatsiooni. See pole kokkuvõte ega spikker: iga dokument on loetletud ühe korra koos selle marsruudi, eesmärgi ja selles määratletud tunnustega, nii et agent leiab küsimusele vastava lehe ja avab ainult selle. Kõigi dokumentide ja skeemide täistekst on teises failis kättesaadav tööriistadele, mis vajavad korraga kogu materjali.
Lülitage see oma blockstudio.json-is sisse:
{
"ai": {
"enableContextGeneration": true
}
}
Nüüd on register saadaval aadressil your-site.com/blockstudio-llm.txt ja täistekst aadressil your-site.com/blockstudio-llm-full.txt. Suunake oma AI-tööriist registri juurde, et see saaks kogu Blockstudio API materjalile lisajuhisteta ligi. Tööriistapõhise seadistuse leiate AI-integratsiooni dokumentatsioonist.
See vabastab teid vajadusest kirjutada raamistikupõhiseid juhiseid. Agent, kellel on ligipääs failile blockstudio-llm.txt, leiab teavet plokkide loomise, väljade määratlemise, mallide kirjutamise, Tailwind seadistamise, lehtede loomise ja iga Blockstudio pakutava konksu kasutamise kohta.
Projektipõhised kontekstifailid
Enamik AI-koodiagente loeb ka projektitaseme kontekstifaili, mis sisaldab teie koodibaasi juhiseid. Tava oleneb tööriistast:
| Fail | Tööriist |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI ja muud |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Kuna blockstudio-llm.txt katab juba raamistiku, peab projekti kontekstifail kirjeldama vaid teie projekti eripära: kataloogipaigutust, nimeandmistavasid, käske ja piire.
Kui paigaldate blockstudio/phpstan, ei pea te seda kirjeldust käsitsi kirjutama. vendor/bin/blockstudio-agents loob teie blockstudio.json ja failide põhjal AGENTS.md, kus on kirjas, mida projekt loob, millised funktsioonid on sisse lülitatud, mille analüüs tagasi lükkab ja millised käsud kehtivad. See ei kirjuta üle faili, mida ta ise pole loonud, ning säilitab teie märkmed faili uuesti loomisel.
# 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
AI töövoogude arendustööriistad
Blockstudio sisaldab kaht spetsiaalselt AI abil arendamiseks loodud arendustööriista.
Lõuend
Lõuend on Figma-i laadne ülevaade kõigist teie Blockstudio lehtedest, mis kuvatakse ühes vaates reaalajas iframe-lõuenditena. Liigutage puuteplaadil, suumige näpistusega või Ctrl+kerimisega.
See on AI-agentidega töötamisel kasulik, sest annab kõigist lehtedest visuaalse ülevaate ilma vahelehti vahetamata või WordPress haldusliideses navigeerimata. Kui agent muudab lehemalli, näete tulemust kohe. Lülitage sisse reaalajarežiim, et lõuend värskenduks failide muutumisel automaatselt.
Lülitage see sisse blockstudio.json-is:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Seejärel avage /wp-admin/admin.php?page=blockstudio-canvas. Valige lehevaade (täislaiuses lõuendid) või plokivaade (kõigi registreeritud plokkide ruudustik vaikeväärtustega).
Elemendi valija
Elemendi valija lahendab AI töövoogudes levinud probleemi: kuidas öelda agendile, milline fail lehel konkreetset elementi kuvab.
Lisa ?blockstudio-devtools mis tahes esiosa URL-le ja hoia seejärel klahve Cmd+C (Mac) või Ctrl+C (Windows) 100 ms all. Ristkursori valija aktiveerub ja tõstab kursori liigutamisel esile Blockstudio plokid. Lõikelauale kopeerimiseks klõpsa elemendil:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Kleepige see oma AI-koodi tööriista ja agent saab kohe teada failitee, HTML struktuuri ning elemendi, millele osutate. Mallifailide teid pole enam vaja käsitsi otsida.
Lülitage see sisse blockstudio.json-is:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktilised võtted
Ühe ploki loomine
Lihtsaim töövoog: kirjeldage soovitut ja laske agendil see luua.
Viip:
Loo iseloomustuse plokk väljadega tsitaadi (tekstiala), autori nime (tekst), autori ametikoha (tekst) ja autori foto (failid) jaoks. Kasuta kujundamiseks Tailwind-i. Tsitaat peaks olema suures kaldkirjas ning sellel peaks olema dekoratiivne jutumärk.
Agent loob:
blockstudio/testimonial/
├── block.json
└── index.php
Terve lehe loomine
Blockstudio failipõhised lehed võimaldavad agendil luua terve WordPress lehe mallina. Siin ongi peamine võit: selle asemel et plokke ükshaaval luua, koostab agent korraga kogu lehe struktuuri kõigi plokkidega.
Viip:
Loo „Meist“ leht päiseosa, meeskonna ruudustiku ja kontaktivormi kohatäitega. Võimaluse korral kasuta olemasolevaid plokke, vajaduse korral loo uusi. Seo see postituse ID-ga 2. Lukusta mall, kuid jäta pealkirjad ja lõigud sisus muudetavaks.
Agent loob:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Lisaks kõik viidatud kohandatud plokid (e.g, blockstudio/team-member/). Käivitage
wp bs pages sync, et luua WordPress postitus koos malli lukustuse ja
muutmisjuhtnuppudega. Kogu leht on versioonihalduses ja korratav.
Terve saidi loomine
Just siin paistab Blockstudio arhitektuur kõige selgemalt silma. Üks viip võib luua terve saidi, sest iga osa on fail:
Viip:
Loo portfooliosait järgmiste lehtedega: Avaleht, Tööd, Meist, Kontakt. Loo kohandatud plokid järgmiste jaoks: päiseosa, projektide ruudustik, projektikaart, meeskonnaliige, kontaktteave ja jalus. Kasuta tumedat kujundust Tailwind-iga. Seadista kohandatud värvipalett blockstudio.json-is, kasutades Tailwind-i.
Agent loob plokikataloogid, lehemallid, blockstudio.json koos Tailwind konfiguratsiooniga ning soovi korral korduvkasutatavate jaotiste mustrid. Kõik lisatakse git ühe muudatuste komplektina.
Paralleelsed agenditöövood
Mõned tööriistad (Codex töölauarakendus, GitHub Copilot CLI, Kilo Code) toetavad mitme agendi paralleelset käitamist. Blockstudio failipõhine plokiarhitektuur muudab selle ohutuks:
- Agent 1: loob päiseploki ja avalehe
- Agent 2: loob projektikaardi ploki ja tööde lehe
- Agent 3: loob kontaktivormi ploki ja kontaktilehe
Kuna iga plokk asub oma kataloogis ja Tailwind stiilid paiknevad mallides koos, ei teki agentide vahel konflikte. Ainus ühine fail on blockstudio.json, mis tuleb tavaliselt seadistada vaid alguses.
Nõuanded paremate tulemuste saamiseks
-
Viita LLM-i kontekstifailile. Agendid loovad märksa paremat Blockstudio koodi, kui neil on ligipääs raamistiku dokumentatsioonile. Suuna nad alati faili
blockstudio-llm.txtjuurde ja anna neile projekti enda jaoks genereeritudAGENTS.md. -
Määra väljade tüübid täpselt. Selle asemel et öelda „lisa pildiväli“, ütle „lisa failiväli atribuutidega
allowedTypes: ['image']jareturnFormat: 'object'“. Mida täpsemalt väljad määratled, seda vähem on vaja kordusi. -
Alusta ühest plokist ja laienda siis. Lase agendil üks plokk õigesti luua, vaata selle mustrid üle ja palu seejärel ülejäänud plokid samade tavade järgi luua. Nii saad näidise, mis parandab järgmisi tulemusi.
-
Vaata tulemus üle. Vibe coding ei tähenda koodi pimesi vastuvõtmist. Kontrolli, et väljatüübid vastaksid soovile, mallid kuvataks õigesti ja Tailwind klassid annaksid soovitud visuaalse tulemuse. Enne avaldamist tuleb AI loodud kood üle vaadata.
-
Kasuta
block.jsonskeeme. Blockstudio pakub aadressilhttps://blockstudio.dev/schema/blockJSON-skeemi."$schema"lisamine sinu block.json-ile annab agentidele valideerimise kohta tagasisidet ja hoiab ära vigased seadistused. -
Hoia plokid väikesed ja konkreetse eesmärgiga. Üks plokk visuaalse komponendi kohta. Nii on agendil lihtsam ploki üle arutleda ja mallid jäävad piisavalt lühikeseks, et mahtuda ühe korraga kontekstiaknasse.