Hoppa till innehåll

Vibecoding med Blockstudio

Andrej Karpathy myntade termen “vibe coding” i februari 2025 för att beskriva ett arbetsflöde där du berättar för en AI vad du vill ha och den skriver koden. Ett år senare har metoden utvecklats till det han nu kallar “agentic engineering”: utvecklare som orkestrerar AI-agenter i stället för att skriva kod rad för rad.

Blockstudio byggdes för detta. Dess filbaserade arkitektur, avsaknad av byggverktyg och förutsägbara projektstruktur gör det till en av de bästa miljöerna för AI-assisterad WordPress-utveckling.

Den här guiden går igenom praktiska mönster för att använda AI-kodningsagenter med Blockstudio, från projektkonfiguration till att generera en hel webbplats.

Varför Blockstudio fungerar bra med AI-agenter

Filer, inte databaser

AI-kodningsagenter läser och skriver filer. Det är deras främsta gränssnitt. Blockstudio håller allt i filsystemet: en block.json och en mallfil per block, en page.json per sida, en pattern.json per mönster. Inga databasposter att hantera, ingen admin-UI att klicka sig igenom och inget byggsteg att köra.

Det här spelar roll eftersom filsystem och skalkommandon utgör en av de största källorna till förträningsdata för LLM:er. Varje modell har sett miljontals exempel på hur man läser, skriver och organiserar filer. När ditt WordPress-utvecklingsflöde använder samma gränssnitt kan agenter arbeta med minimala instruktioner.

Förutsägbar struktur

Varje Blockstudio-block följer samma mönster:

Kod
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

Den här konsekvensen innebär att en agent som har byggt ett block kan bygga hundra. Inga överraskningar, inga specialfall, ingen dold konfiguration. Samma mönster gäller för sidor (page.json + mall), mönster (pattern.json + mall) och tillägg (extend.json).

Hela sidor som filer

Traditionell sidbyggnad i WordPress kräver blockredigeraren: dra block, konfigurera inställningar och spara via admin. AI-agenter kan inte göra något av det. De behöver filer.

Blockstudios filbaserade sidor löser problemet helt. En page.json definierar sidans metadata, och en mall i index.php definierar blockstrukturen med HTML:

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

En agent kan skapa en stomme för en hel WordPress-sida, komplett med kärnblock, anpassade block, malllåsning och redigeringskontroller, genom att skriva två filer. Kör wp bs pages sync för att tillämpa källan på WordPress; att öppna admin utför aldrig den synkroniseringen automatiskt.

Det här är en av de mest kraftfulla funktionerna för AI-assisterad utveckling. I stället för att beskriva en sidlayout och sätta ihop den manuellt i redigeraren beskriver du den för en agent, som skriver mallen. Resultatet versionshanteras, kan återskapas och går att vidareutveckla på några sekunder.

Inget byggsteg

Det finns inget att kompilera, paketera eller transpilerera. En agent skapar en fil, och den fungerar direkt. SCSS kompileras på serversidan. ES-moduler löses vid körning. Tailwind CSS kompileras vid varje förfrågan från frontend. Återkopplingen mellan att “agenten skriver kod” och att “koden körs i webbläsaren” är så snabb den kan bli.

Varför Tailwind CSS är rätt val

Blockstudio stöder både vanlig CSS och Tailwind CSS, men Tailwind har en betydande fördel när du arbetar med AI-agenter.

LLM:er kan Tailwind mycket väl

Tailwind CSS används i tiotusentals projekt med öppen källkod. Det driver gränssnitten för Claude.ai, Vercel, Shopify, Cursor och OpenAIs egna produkter. Den här utbredningen i träningsdata innebär att LLM:er genererar Tailwind-klasser med hög precision och sällan hittar på verktyg som inte finns.

Klassernas vokabulär är begränsad och väldefinierad. En agent kan inte hitta på en CSS-egenskap som inte finns, vilket minskar stilfel dramatiskt jämfört med fri CSS där agenten kan generera ogiltiga selektorer eller misstolka kaskadbeteendet.

Stilarna finns i markeringen

Med Tailwind ligger all stilinformation tillsammans i HTML-mallen. Agenten ser hela den visuella beskrivningen av ett element på ett ställe. Du behöver inte slå upp separata .css-filer, förstå kaskadordningen eller hålla reda på konflikter i specificitet.

Detta är särskilt kraftfullt för Blockstudio-block där mallen redan är en enda fil. Agenten kan skapa en komplett, formgiven komponent i ett enda svep:

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>

Parallella agenter utan konflikter

Eftersom Tailwind-stilarna är avgränsade till varje mall kan flera agenter (eller utvecklare) arbeta med olika block samtidigt utan CSS-sammanfogningskonflikter. Det finns inget delat formatmallblad där ändringar i en komponent av misstag går sönder för en annan. Varje block är fristående.

Detta fungerar också bra med vanlig CSS när du använder Blockstudios avgränsade stilar (style.scoped.css), men Tailwind gör att hela CSS-filen kan utelämnas, vilket innebär en fil mindre för agenten att hantera per block.

Vanlig CSS fungerar fortfarande

Tailwind är inte ett krav. Blockstudios tillgångspipeline hanterar .css– och .scss-filer automatiskt, inklusive avgränsade stilar som namnområdesindelas för blocket. Om ditt projekt använder en annan CSS-metod kan agenter arbeta med den också. Fördelen med Tailwind är helt enkelt att LLM:er är bättre på det tack vare täckningen i träningsdata och att stilarna finns tillsammans med markeringen.

AI-kodningsagenter

Följande CLI-verktyg fungerar med Blockstudio-projekt direkt. De läser och skriver filer, kör skalkommandon och förstår projektstrukturen utifrån kontextfiler.

Terminalagenter (CLI)

Verktyg Leverantör Anmärkningar
Claude Code Anthropic Terminalbaserad agent. Läser CLAUDE.md för projektkontext.
Codex CLI OpenAI Projekt med öppen källkod, CLI byggt i Rust. Finns även som skrivbordsapp.
Gemini CLI Google Projekt med öppen källkod och ett kontextfönster på 1M token. Läser GEMINI.md.
GitHub Copilot CLI GitHub Specialiserade parallella agenter för utforskning, uppgifter, planering och granskning.
Aider Öppen källkod Stöder fler än 100 LLM-leverantörer, inklusive lokala modeller.
OpenCode Öppen källkod Terminalbaserat TUI med LSP-integration. Stöder fler än 75 leverantörer.
Amazon Q Developer CLI AWS Kostnadsfri nivå finns. Passar bra för AWS-integrerade projekt.

IDE-agenter

Verktyg Leverantör Anmärkningar
Cursor Cursor VS Code-fork med inbyggd AI. Har även en CLI (beta).
Windsurf Cognition AI VS Code-fork med den agentiska assistenten Cascade.
Cline Öppen källkod VS Code-tillägg med stegvis godkännande. Har även en CLI.
Kilo Code Öppen källkod Orkestreringsläge med samordnade underagenter.
Continue Öppen källkod VS Code/JetBrains-tillägg med asynkrona CI/CD-agenter.
Augment Code Augment Inriktat på företag med djup indexering av kodbasen.

Alla dessa verktyg kan skapa och redigera filer i en Blockstudio-projektkatalog. Terminalagenterna passar särskilt bra eftersom Blockstudio-utveckling inte kräver några IDE-specifika funktioner: allt sker direkt i filer.

Konfigurera projektet för AI-agenter

LLM-kontextfilen

Blockstudio levereras med en förbyggd kontextfil som indexerar hela ramverkets dokumentation. Det är ingen sammanfattning eller fusklapp: varje dokument listas en gång med sin sökväg, sitt syfte och de identifierare det omfattar, så att en agent kan hitta den sida som besvarar en fråga och bara öppna den. Den fullständiga texten i alla dokument och scheman finns i en andra fil för verktyg som vill ha hela korpusen på en gång.

Aktivera det i din blockstudio.json:

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

Indexet finns nu på your-site.com/blockstudio-llm.txt och den fullständiga texten på your-site.com/blockstudio-llm-full.txt. Hänvisa ditt AI-verktyg till indexet, så får det tillgång till hela Blockstudio API utan ytterligare instruktioner. Se AI-integrationsdokumentationen för verktygsspecifik konfiguration.

Detta ersätter behovet av att själv skriva instruktioner som är specifika för ramverket. En agent med åtkomst till blockstudio-llm.txt kan hitta information om hur man skapar block, definierar fält, skriver mallar, konfigurerar Tailwind, skapar sidor och använder alla krokar som Blockstudio tillhandahåller.

Projektspecifika kontextfiler

De flesta AI-kodningsagenter läser också en kontextfil på projektnivå med instruktioner som är specifika för din kodbas. Konventionerna varierar mellan verktyg:

Fil Verktyg
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI med flera
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

Eftersom blockstudio-llm.txt redan täcker ramverket behöver projektets kontextfil bara beskriva det som är unikt för projektet: katalogstruktur, namnkonventioner, kommandon och begränsningar.

Om du installerar blockstudio/phpstan behöver du inte skriva den beskrivningen för hand. vendor/bin/blockstudio-agents genererar en AGENTS.md från din blockstudio.json och dina egna filer, med information om vad projektet innehåller, vilka funktioner som är aktiverade, vad analysen avvisar och vilka kommandon som gäller. Verktyget vägrar att skriva över en fil som det inte självt har skapat och bevarar dina anteckningar när du genererar om den.

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

Utvecklarverktyg för AI-arbetsflöden

Blockstudio innehåller två utvecklarverktyg som är särskilt utformade för AI-assisterad utveckling.

Canvas

canvas är en Figma-liknande översikt över alla dina Blockstudio-sidor, återgivna som levande iframe-artboards i en och samma vy. Panorera med styrplattan och zooma genom att nypa eller använda Ctrl+scroll.

Det här är användbart när du arbetar med AI-agenter, eftersom du får en visuell överblick över varje sida utan att byta flik eller navigera i WordPress-admin. När en agent ändrar en sidmall ser du resultatet direkt. Aktivera liveläge så uppdateras canvas automatiskt när filer ändras.

Aktivera det i blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

Gå sedan till /wp-admin/admin.php?page=blockstudio-canvas. Växla mellan sidvy (artboards i full bredd) och blockvy (rutnät med alla registrerade block och deras standardvärden).

Element Grabber

element grabber löser ett vanligt problem i AI-arbetsflöden: att tala om för agenten vilken fil som återger ett visst element på sidan.

Lägg till ?blockstudio-devtools i valfri URL för frontend och håll sedan Cmd+C (Mac) eller Ctrl+C (Windows) intryckt i 100ms. En hårkorsväljare aktiveras och markerar Blockstudio-block när du för pekaren över dem. Klicka på ett element för att kopiera dess kontext till urklippet:

Kod
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Klistra in detta i ditt AI-kodningsverktyg, så får agenten direkt veta sökvägen till filen, HTML-strukturen och vilket element du pekar på. Du behöver inte längre leta upp mallfilernas sökvägar manuellt.

Aktivera det i blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

Praktiska mönster

Skapa ett enskilt block

Det enklaste arbetsflödet: beskriv vad du vill ha och låt agenten skapa det.

Prompt:

Skapa ett rekommendationsblock med fält för citat (textarea), författarens namn (text), författarens roll (text) och författarens foto (files). Använd Tailwind för formgivningen. Citatet ska ha stor kursiv stil och ett dekorativt citationstecken.

Agenten skapar:

Kod
blockstudio/testimonial/
├── block.json
└── index.php

Skapa en hel sida

Blockstudios filbaserade sidor låter en agent skapa en stomme för en hel WordPress-sida som en mall. Här visar sig den verkliga styrkan: i stället för att bygga block ett i taget skapar agenten hela sidstrukturen med alla block i ett enda svep.

Prompt:

Skapa en sida med en introduktionssektion, ett teamrutnät och en platshållare för kontaktformulär. Använd befintliga block där det går och skapa nya där det behövs. Koppla den till inläggs-ID 2. Lås mallen, men gör rubriker och stycken redigerbara som innehåll.

Agenten skapar:

Kod
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

Samt eventuella anpassade block som den hänvisar till (e.g., blockstudio/team-member/). Kör wp bs pages sync för att skapa inlägget av typen WordPress med malllåsning och redigeringskontroller. Hela sidan versionshanteras och kan återskapas.

Skapa en hel webbplats

Det är här Blockstudios arkitektur verkligen kommer till sin rätt. En enda prompt kan generera en hel webbplats eftersom varje artefakt är en fil:

Prompt:

Bygg en portföljwebbplats med sidorna Hem, Arbete, Om och Kontakt. Skapa anpassade block för introduktionssektion, projektrutnät, projektkort, teammedlem, kontaktuppgifter och sidfot. Använd ett mörkt tema med Tailwind. Konfigurera Tailwind i blockstudio.json med en anpassad färgpalett.

Agenten skapar blockkatalogerna, sidmallarna, en blockstudio.json med Tailwind-konfiguration och vid behov mönster för återanvändbara sektioner. Allt checkas in i git som en enda ändringsuppsättning.

Parallella agentarbetsflöden

Vissa verktyg (Codexs skrivbordsapp, GitHub Copilot CLI, Kilo Code) stöder flera agenter som körs parallellt. Blockstudios filbaserade arkitektur med ett block per fil gör detta säkert:

  • Agent 1: bygger introduktionsblocket och startsidan
  • Agent 2: bygger projektkortblocket och arbetssidan
  • Agent 3: bygger kontaktformulärblocket och kontaktsidan

Eftersom varje block har en egen katalog och Tailwind-stilarna finns i mallarna arbetar agenterna utan att hamna i konflikt med varandra. Den enda delade filen är blockstudio.json, som vanligtvis bara behöver konfigureras en gång i början.

Tips för bättre resultat

  1. Hänvisa till LLM-kontextfilen. Agenter producerar betydligt bättre Blockstudio-kod när de kan komma åt ramverkets dokumentation. Hänvisa dem alltid till blockstudio-llm.txt och ge dem en genererad AGENTS.md för själva projektet.

  2. Ange fälttyper tydligt. Säg till exempel inte "lägg till ett bildfält", utan "lägg till ett files-fält med allowedTypes: ['image'] och returnFormat: 'object'". Ju noggrannare fältdefinitionerna är, desto färre iterationer behövs.

  3. Börja med ett block och utöka sedan. Låt agenten bygga ett block korrekt, granska dess mönster och be den sedan bygga resten enligt samma konventioner. På så sätt skapas en referens som förbättrar kommande resultat.

  4. Granska resultatet. Vibe coding innebär inte att du ska godta kod utan eftertanke. Kontrollera att fälttyperna motsvarar dina avsikter, att mallarna återges korrekt och att Tailwind-klasserna ger rätt visuellt resultat. AI-genererad kod bör granskas innan den levereras.

  5. Använd block.json-scheman. Blockstudio tillhandahåller ett Schema för JSON på https://blockstudio.dev/schema/block. Lägg till "$schema" i din block.json så får agenterna valideringsfeedback och felaktiga konfigurationer förebyggs.

  6. Håll blocken små och fokuserade. Ett block per visuell komponent. Då blir varje block enklare för agenten att resonera kring och mallarna tillräckligt korta för att rymmas i en enda kontextfönsterpassering.