Siirry sisältöön

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:

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

Koodi
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>

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:

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>

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

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

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

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:

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

Koodi
@<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:

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

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

Koodi
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

  1. 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.txt ja anna niille projektia varten luotu AGENTS.md.

  2. Määritä kenttätyypit tarkasti. Älä sano vain ”lisää kuvakenttä”, vaan ”lisää files-kenttä, jossa on allowedTypes: ['image'] ja returnFormat: 'object'”. Mitä tarkemmin määrittelet kentät, sitä vähemmän tarvitaan muokkauskierroksia.

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

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

  5. Käytä block.json-skeemoja. Blockstudio tarjoaa JSON-skeeman osoitteessa https://blockstudio.dev/schema/block. Lisää "$schema" tiedostoon block.json, niin agentit saavat palautetta tarkistuksesta ja virheelliset määritykset estyvät.

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