Vibekoodausta Blockstudio:lla
Andrej Karpathy loi helmikuussa 2025 termin ”vibe coding” kuvaamaan työnkulkua, jossa kerrot tekoälylle, mitä haluat, ja se kirjoittaa koodin. Vuotta myöhemmin käytäntö on kehittynyt siihen, mitä hän nyt kutsuu ”agenttiseksi ohjelmistokehitykseksi”: kehittäjät ohjaavat tekoälyagentteja sen sijaan, että kirjoittaisivat koodia rivi riviltä.
Blockstudio on suunniteltu tätä varten. Tiedostopohjainen arkkitehtuuri, build-työkalujen puuttuminen ja ennakoitava projektirakenne tekevät siitä yhden parhaista ympäristöistä tekoälyavusteiseen WordPress-kehitykseen.
Tässä oppaassa esitellään käytännön toimintatapoja tekoälykoodausagenttien käyttöön Blockstudion kanssa projektin määrityksestä kokonaisen sivuston luontiin.
Miksi Blockstudio toimii hyvin tekoälyagenttien kanssa
Tiedostoja, ei tietokantoja
Tekoälykoodausagentit lukevat ja kirjoittavat tiedostoja. Se on niiden ensisijainen käyttöliittymä. Blockstudio pitää kaiken tiedostojärjestelmässä: block.jsonn ja mallitiedoston jokaista lohkoa kohti, page.jsonn jokaista sivua kohti ja pattern.jsonn jokaista kuviota kohti. Ei hallittavia tietokantamerkintöjä, ei läpikäytäviä ylläpidon UIja eikä suoritettavaa build-vaihetta.
Tämä on tärkeää, koska tiedostojärjestelmät ja komentotulkin komennot ovat suurimpia LLM-mallien esikoulutusdatan lähteitä. Jokainen malli on nähnyt miljoonia esimerkkejä tiedostojen lukemisesta, kirjoittamisesta ja järjestämisestä. Kun WordPress-kehitystyönkulkusi vastaa tätä käyttöliittymää, agentit pystyvät työskentelemään vähäisillä ohjeilla.
Ennakoitava rakenne
Jokainen Blockstudio-lohko noudattaa samaa kaavaa:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Johdonmukaisuuden ansiosta agentti, joka on rakentanut yhden lohkon, osaa rakentaa sata. Ei yllätyksiä, poikkeustapauksia tai piilotettuja määrityksiä. Sama kaava pätee sivuihin (page.json + malli), kuvioihin (pattern.json + malli) ja laajennuksiin (extend.json).
Kokonaiset sivut tiedostoina
Perinteinen WordPress-sivujen rakentaminen edellyttää lohkoeditoria: lohkojen raahaamista, asetusten määrittämistä ja tallentamista ylläpidon kautta. Tekoälyagentit eivät pysty tekemään tätä. Ne tarvitsevat tiedostoja.
Blockstudion tiedostopohjaiset sivut ratkaisevat tämän täysin. page.json määrittää sivun metatiedot, ja index.php-malli määrittää lohkorakenteen käyttäen HTMLa:
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>
Agentti voi luoda kokonaisen WordPress-sivun rungon, johon kuuluvat ydinsisällön lohkot, mukautetut lohkot, mallin lukitus ja muokkausohjaimet, kirjoittamalla vain kaksi tiedostoa. Suorita wp bs pages sync ottaaksesi lähteen käyttöön kohteessa WordPress; ylläpidon avaaminen ei synkronoi niitä automaattisesti.
Tämä on yksi tekoälyavusteisen kehityksen tehokkaimmista ominaisuuksista. Sen sijaan, että kuvailisit sivun asettelun ja kokoaisit sen käsin editorissa, kuvailet sen agentille, joka kirjoittaa mallin. Tulos on versionhallittu ja toistettavissa, ja siihen voi tehdä muutoksia sekunneissa.
Ei build-vaihetta
Mitään ei tarvitse kääntää, niputtaa tai muuntaa. Agentti luo tiedoston, ja se toimii heti. SCSS käännetään palvelinpuolella. ES-moduulit ratkaistaan suorituksen aikana. Tailwind CSS käännetään jokaisella frontend-pyynnöllä. Palautesilmukka agentin kirjoittaman koodin ja selaimessa suoritettavan koodin välillä on mahdollisimman lyhyt.
Miksi Tailwind CSS on oikea valinta
Blockstudio tukee sekä tavallista CSSa että Tailwind CSSta, mutta Tailwindlla on merkittävä etu tekoälyagenttien kanssa työskenneltäessä.
LLM-mallit tuntevat Tailwindn erittäin hyvin
Tailwind CSSa käytetään kymmenissä tuhansissa avoimen lähdekoodin repositorioissa. Se toimii käyttöliittymien pohjana tuotteissa Claude.ai, Vercel, Shopify, Cursor ja OpenAIn omat tuotteet. Laaja esiintyvyys koulutusdatassa tarkoittaa, että LLM-mallit tuottavat Tailwind-luokkia tarkasti eivätkä juuri keksi olemattomia apuluokkia.
Luokkasanasto on rajallinen ja tarkasti määritelty. Agentti ei voi keksiä olematonta CSS-ominaisuutta, mikä vähentää tyylivirheitä huomattavasti verrattuna vapaamuotoiseen CSSiin, jossa agentti saattaa luoda virheellisiä valitsimia tai ymmärtää periytymisjärjestyksen väärin.
Tyylit ovat merkinnän yhteydessä
Tailwindssa kaikki tyylitiedot ovat samassa paikassa HTML-mallin kanssa. Agentti näkee elementin täydellisen visuaalisen kuvauksen yhdessä paikassa. Erillisiä .css-tiedostoja ei tarvitse vertailla, periytymisjärjestystä ymmärtää tai tarkistaa tyylien tarkkuuskonflikteja.
Tämä on erityisen hyödyllistä Blockstudio-lohkoissa, joissa malli on jo valmiiksi yksittäinen tiedosto. Agentti voi luoda kokonaisen tyylitellyn komponentin yhdellä kertaa:
<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>
Rinnakkaiset agentit ilman konflikteja
Koska Tailwindn tyylit rajautuvat kuhunkin malliin, useat agentit (tai kehittäjät) voivat työskennellä eri lohkojen parissa samanaikaisesti ilman CSS-yhdistämiskonflikteja. Yhteistä tyylitiedostoa ei ole, joten yhden komponentin muutokset eivät vahingossa riko toista. Jokainen lohko on itsenäinen kokonaisuus.
Tämä toimii hyvin myös tavallisen CSSn kanssa, kun käytössä ovat Blockstudion rajatut tyylit (style.scoped.css), mutta Tailwind poistaa koko CSS-tiedoston, jolloin agentin hallittavaksi jää yksi tiedosto vähemmän lohkoa kohti.
Tavallinen CSS toimii silti
Tailwind ei ole pakollinen. Blockstudion resurssiputki käsittelee automaattisesti .css– ja .scss-tiedostot, myös lohkon nimiavaruuteen rajatut tyylit. Jos projektissasi käytetään muuta CSS-menetelmää, agentit voivat työskennellä senkin kanssa. Tailwindn etuna on vain se, että LLM-mallit osaavat käyttää sitä paremmin koulutusdatan laajuuden ja tyylien sekä merkinnän sijainnin ansiosta.
Tekoälykoodausagentit
Kaikki seuraavat CLI-työkalut toimivat Blockstudio-projekteissa suoraan käyttövalmiina. Ne lukevat ja kirjoittavat tiedostoja, suorittavat komentotulkin komentoja ja päättelevät projektin rakenteen kontekstitiedostoista.
Pääteagentit (CLI)
| Työkalu | Tarjoaja | Huomautukset |
|---|---|---|
| Claude Code | Anthropic | Päätteeseen keskittyvä agentti. Lukee CLAUDE.mdn projektin kontekstia varten. |
| Codex CLI | OpenAI | Avoimen lähdekoodin CLI, joka on rakennettu Rustlla. Saatavilla myös työpöytäsovelluksena. |
| Gemini CLI | Avoimen lähdekoodin työkalu, jossa on 1M tokenin konteksti-ikkuna. Lukee GEMINI.mdn. |
|
| GitHub Copilot CLI | GitHub | Erikoistuneet rinnakkaisagentit tutkimiseen, tehtäviin, suunnitteluun ja tarkistukseen. |
| Aider | Avoin lähdekoodi | Tukee yli 100 LLM-palveluntarjoajaa, mukaan lukien paikalliset mallit. |
| OpenCode | Avoin lähdekoodi | Päätteen TUI, jossa on LSP-integraatio. Tukee yli 75 palveluntarjoajaa. |
| Amazon Q Developer CLI | AWS | Maksuton versio saatavilla. Sopii hyvin AWS-integroituihin projekteihin. |
IDE-agentit
| Työkalu | Tarjoaja | Huomautukset |
|---|---|---|
| Cursor | Cursor | VS Code-haara, jossa on sisäänrakennettu tekoäly. Saatavilla myös CLI (beta). |
| Windsurf | Cognition AI | VS Code-haara, jossa on Cascade-agenttiavustaja. |
| Cline | Avoin lähdekoodi | VS Code-laajennus, jossa muutokset hyväksytään vaiheittain. Saatavilla myös CLI. |
| Kilo Code | Avoin lähdekoodi | Orkestrointitila koordinoiduilla aliagenteilla. |
| Continue | Avoin lähdekoodi | VS Code/JetBrains-laajennus, jossa on asynkronisia CI/CD-agentteja. |
| Augment Code | Augment | Suunnattu yrityksille; koodikannan indeksointi on kattava. |
Kaikilla näillä työkaluilla voi luoda ja muokata tiedostoja Blockstudio-projektihakemistossa. Pääteagentit sopivat siihen erityisen hyvin, koska Blockstudio-kehityksessä ei tarvita IDE-kohtaisia ominaisuuksia: kaikki perustuu tiedostoihin.
Projektin määrittäminen tekoälyagentteja varten
LLM-mallien kontekstitiedosto
Blockstudio sisältää valmiin kontekstitiedoston, joka indeksoi koko viitekehyksen dokumentaation. Se ei ole yhteenveto tai pikaopas: jokainen dokumentti on listattu kerran reittinsä, tarkoituksensa ja omistamiensa tunnisteiden kanssa. Näin agentti löytää kysymykseen vastaavan sivun ja avaa vain sen. Kaikkien dokumenttien ja skeemojen koko teksti on saatavilla toisessa tiedostossa työkaluille, jotka haluavat koko aineiston kerralla.
Ota se käyttöön blockstudio.jsonssa:
{
"ai": {
"enableContextGeneration": true
}
}
Hakemisto on nyt saatavilla osoitteessa your-site.com/blockstudio-llm.txt ja koko teksti osoitteessa your-site.com/blockstudio-llm-full.txt. Osoita tekoälytyökalu hakemistoon, niin se pääsee käsiksi koko Blockstudio APIoon ilman lisäohjeita. Katso tekoälyintegraation dokumentaatiosta työkalukohtaiset määritysohjeet.
Tämä poistaa tarpeen kirjoittaa viitekehyskohtaiset ohjeet itse. Agentti, jolla on pääsy blockstudio-llm.txton, löytää ohjeet lohkojen luomiseen, kenttien määrittämiseen, mallien kirjoittamiseen, Tailwindn määrittämiseen, sivujen luontiin ja kaikkien Blockstudion tarjoamien koukkujen käyttöön.
Projektikohtaiset kontekstitiedostot
Useimmat tekoälykoodausagentit lukevat myös projektitason kontekstitiedoston, joka sisältää koodikantaasi koskevia ohjeita. Käytäntö vaihtelee työkalun mukaan:
| Tiedosto | Työkalu |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI ja muut |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Koska blockstudio-llm.txt kattaa jo viitekehyksen, projektin kontekstitiedostossa tarvitsee kuvata vain projektisi erityispiirteet: hakemistorakenne, nimeämiskäytännöt, komennot ja rajaukset.
Jos asennat blockstudio/phpstan, sinun ei tarvitse kirjoittaa kuvausta itse. vendor/bin/blockstudio-agents luo AGENTS.mdn blockstudio.jsonsta ja omista tiedostoistasi. Se listaa, mitä projekti luo, mitkä ominaisuudet ovat käytössä, minkä analyysi hylkää ja mitä komentoja voi käyttää. Se ei korvaa tiedostoa, jota se ei ole luonut, ja säilyttää omat muistiinpanosi, kun luot sen uudelleen.
# 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
Tekoälytyönkulkujen kehittäjätyökalut
Blockstudio sisältää kaksi kehittäjätyökalua, jotka on suunniteltu erityisesti tekoälyavusteiseen kehitykseen.
Canvas
Canvas on Figma-tyylinen yleiskuva kaikista Blockstudio-sivuistasi. Sivut näkyvät reaaliaikaisina iframe-työalueina yhdessä näkymässä. Panoroi ohjauslevyllä ja lähennä nipistämällä tai Ctrl+vierityksellä.
Tästä on hyötyä tekoälyagenttien kanssa työskenneltäessä, koska näet kaikkien sivujen visuaalisen yleiskuvan vaihtamatta välilehteä tai siirtymättä WordPressn ylläpitoon. Kun agentti muokkaa sivumallia, näet tuloksen heti. Ota live-tila käyttöön, niin canvas päivittyy automaattisesti tiedostojen muuttuessa.
Ota se käyttöön blockstudio.jsonssa:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Siirry sitten osoitteeseen /wp-admin/admin.php?page=blockstudio-canvas. Vaihda sivunäkymän (täysleveät työalueet) ja lohkonäkymän (ruudukko kaikista rekisteröidyistä lohkoista oletusarvoineen) välillä.
Element Grabber
Element Grabber ratkaisee yleisen ongelman tekoälytyönkuluissa: kuinka kertoa agentille, mikä tiedosto tuottaa tietyn sivulla olevan elementin.
Lisää ?blockstudio-devtools mihin tahansa frontendin URLiin ja pidä sitten painettuna Cmd+C (Mac) tai Ctrl+C (Windows) 100 ms. Tähtäinvalitsin aktivoituu ja korostaa Blockstudio-lohkoja osoittimen liikkuessa. Kopioi elementin konteksti leikepöydälle napsauttamalla elementtiä:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Liitä tämä tekoälykoodaustyökaluusi, niin agentti saa heti tietää tiedostopolun, HTML-rakenteen ja osoittamasi elementin. Mallitiedostojen polkuja ei enää tarvitse etsiä käsin.
Ota se käyttöön blockstudio.jsonssa:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Käytännön toimintatapoja
Yksittäisen lohkon rakentaminen
Yksinkertaisin työnkulku: kuvaile, mitä haluat, ja anna agentin luoda se.
Kehote:
Luo suosituslohko, jossa on kentät lainaukselle (textarea), kirjoittajan nimelle (text), kirjoittajan roolille (text) ja kirjoittajan valokuvalle (files). Käytä tyylittelyyn Tailwinda. Lainauksen tulee olla suurella kursivoidulla fontilla, ja siinä tulee olla koristeellinen lainausmerkki.
Agentti luo:
blockstudio/testimonial/
├── block.json
└── index.php
Kokonaisen sivun rakentaminen
Blockstudion tiedostopohjaisten sivujen ansiosta agentti voi luoda rungon kokonaiselle WordPress-sivulle mallina. Tässä on todellinen hyöty: sen sijaan, että lohkot rakennettaisiin yksi kerrallaan, agentti luo koko sivurakenteen kaikkine lohkoineen yhdellä kertaa.
Kehote:
Luo ”Tietoja”-sivu, jossa on pääosio, tiimiruudukko ja yhteydenottolomakkeen paikkamerkki. Käytä olemassa olevia lohkoja mahdollisuuksien mukaan ja luo uusia tarpeen mukaan. Kiinnitä se viestin tunnukseen 2. Lukitse malli, mutta anna otsikoiden ja kappaleiden sisältöä muokata.
Agentti luo:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Lisäksi kaikki sen käyttämät mukautetut lohkot (e.g., blockstudio/team-member/). Suorita
wp bs pages sync luodaksesi WordPress-viestin mallilukituksineen ja
muokkausohjaimineen. Koko sivu on versionhallittu ja toistettavissa.
Kokonaisen sivuston rakentaminen
Tässä Blockstudion arkkitehtuuri pääsee todella oikeuksiinsa. Yhdellä kehotteella voi luoda kokonaisen sivuston, koska jokainen osa on tiedosto:
Kehote:
Rakenna portfoliosivusto, jossa on seuraavat sivut: Etusivu, Työt, Tietoja, Yhteystiedot. Luo mukautetut lohkot seuraaville osioille: pääosio, projektiruudukko, projektikortti, tiimin jäsen, yhteystiedot ja alatunniste. Käytä tummaa teemaa ja Tailwinda. Määritä Tailwind kohteessa blockstudio.json mukautetulla väripaletilla.
Agentti luo lohkokansiot, sivumallit, blockstudio.json-tiedoston Tailwind-määrityksillä ja haluttaessa uudelleenkäytettävien osioiden kuviot. Kaikki tallennetaan git-järjestelmään yhtenä muutossarjana.
Rinnakkaiset agenttityönkulut
Jotkin työkalut (Codex-työpöytäsovellus, GitHub Copilot CLI, Kilo Code) tukevat useiden agenttien rinnakkaista suorittamista. Blockstudion lohko kerrallaan -tiedostoarkkitehtuuri tekee tämän turvalliseksi:
- Agentti 1: rakentaa päälohkon ja etusivun
- Agentti 2: rakentaa projektikorttilohkon ja työsivun
- Agentti 3: rakentaa yhteydenottolomakkeen lohkon ja yhteystietosivun
Koska jokainen lohko on omassa hakemistossaan ja Tailwindn tyylit ovat mallien yhteydessä, agentit eivät joudu ristiriitoihin keskenään. Ainoa yhteinen tiedosto on blockstudio.json, joka tarvitsee yleensä määrittää vain kerran alussa.
Vinkkejä parempiin tuloksiin
-
Viittaa LLM-mallien kontekstitiedostoon. Agentit tuottavat huomattavasti parempaa Blockstudio-koodia, kun ne pääsevät käsiksi viitekehyksen dokumentaatioon. Osoita ne aina tiedostoon
blockstudio-llm.txtja anna niille projektia varten luotuAGENTS.md. -
Määritä kenttätyypit tarkasti. Älä sano vain ”lisää kuvakenttä”, vaan ”lisää files-kenttä, jossa on
allowedTypes: ['image']jareturnFormat: 'object'”. Mitä tarkemmin määrittelet kentät, sitä vähemmän tarvitaan muokkauskierroksia. -
Aloita yhdestä lohkosta ja laajenna sitten. Anna agentin rakentaa yksi lohko oikein, tarkista sen toimintatavat ja pyydä sitten rakentamaan loput samojen käytäntöjen mukaisesti. Näin syntyy esimerkki, joka parantaa myöhempää tulosta.
-
Tarkista tulos. Vibe coding ei tarkoita koodin hyväksymistä sokeasti. Tarkista, että kenttätyypit vastaavat tarkoitustasi, mallit näkyvät oikein ja Tailwind-luokat tuottavat halutun visuaalisen tuloksen. Tekoälyn luoma koodi tulee tarkistaa ennen julkaisua.
-
Käytä
block.json-skeemoja. Blockstudio tarjoaa JSON-skeeman osoitteessahttps://blockstudio.dev/schema/block. Lisää"$schema"tiedostoon block.json, niin agentit saavat palautetta tarkistuksesta ja virheelliset määritykset estyvät. -
Pidä lohkot pieninä ja rajattuina. Yksi lohko kutakin visuaalista komponenttia kohti. Näin agentin on helpompi käsitellä kutakin lohkoa, ja mallit pysyvät tarpeeksi lyhyinä mahtuakseen yhteen konteksti-ikkunaan.