Programare cu AI în Blockstudio
Andrej Karpathy a inventat termenul „vibe coding” în februarie 2025 pentru a descrie un flux de lucru în care îi spui unui AI ce vrei, iar acesta scrie codul. Un an mai târziu, practica s-a maturizat în ceea ce el numește acum „agentic engineering”: dezvoltatorii coordonează agenți AI în loc să scrie cod linie cu linie.
Blockstudio a fost creat pentru acest lucru. Arhitectura sa bazată pe fișiere, lipsa instrumentelor de compilare și structura previzibilă a proiectului îl fac unul dintre cele mai bune medii pentru dezvoltarea WordPress asistată de AI.
Acest ghid prezintă modele practice pentru utilizarea agenților AI de programare cu Blockstudio, de la configurarea proiectului până la generarea unui site complet.
De ce Blockstudio funcționează bine cu agenții AI
Fișiere, nu baze de date
Agenții AI de programare citesc și scriu fișiere. Aceasta este interfața lor principală. Blockstudio păstrează totul în sistemul de fișiere: un block.json și un fișier șablon pentru fiecare bloc, un page.json pentru fiecare pagină, un pattern.json pentru fiecare model. Nu există înregistrări în baze de date de gestionat, niciun UI de administrare prin care să navigați și niciun pas de compilare de rulat.
Acest lucru contează deoarece sistemele de fișiere și comenzile shell reprezintă una dintre cele mai mari surse de date de preantrenare pentru LLM-uri. Fiecare model a văzut milioane de exemple de citire, scriere și organizare a fișierelor. Când fluxul de lucru pentru dezvoltarea WordPress urmează aceeași interfață, agenții pot lucra cu instrucțiuni minime.
Structură previzibilă
Fiecare bloc Blockstudio urmează același tipar:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Această consecvență înseamnă că un agent care a creat un bloc poate crea o sută. Nu există surprize, cazuri speciale sau configurări ascunse. Același tipar se aplică paginilor (page.json + șablon), modelelor (pattern.json + șablon) și extensiilor (extend.json).
Pagini complete ca fișiere
Crearea tradițională a paginilor WordPress necesită editorul de blocuri: tragerea blocurilor, configurarea setărilor și salvarea prin panoul de administrare. Agenții AI nu pot face nimic din toate acestea. Au nevoie de fișiere.
Paginile bazate pe fișiere ale Blockstudio rezolvă complet această problemă. Un page.json definește metadatele paginii, iar un șablon index.php definește structura blocurilor folosind 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>
Un agent poate crea scheletul unei pagini WordPress complete, cu blocuri de bază, blocuri personalizate, blocarea șablonului și controale de editare, scriind doar două fișiere. Rulați wp bs pages sync pentru a aplica sursa în WordPress; deschiderea panoului de administrare nu sincronizează automat modificările.
Aceasta este una dintre cele mai puternice funcționalități pentru dezvoltarea asistată de AI. În loc să descrieți aspectul unei pagini și să o asamblați manual în editor, îi descrieți pagina unui agent, iar acesta scrie șablonul. Rezultatul este gestionat prin controlul versiunilor, reproductibil și poate fi îmbunătățit în câteva secunde.
Fără pas de compilare
Nu este nimic de compilat, împachetat sau transpilat. Agentul creează un fișier, iar acesta funcționează imediat. SCSS este compilat pe server. Modulele ES sunt rezolvate la execuție. Tailwind CSS este compilat la fiecare solicitare din frontend. Bucla de feedback dintre „agentul scrie cod” și „codul rulează în browser” este cât se poate de scurtă.
De ce Tailwind CSS este alegerea potrivită
Blockstudio acceptă atât CSS obișnuit, cât și Tailwind CSS, însă Tailwind are un avantaj semnificativ când lucrați cu agenți AI.
LLM-urile cunosc foarte bine Tailwind
Tailwind CSS este folosit în zeci de mii de depozite open-source. Stă la baza interfețelor pentru Claude.ai, Vercel, Shopify, Cursor și propriile produse ale OpenAI. Prezența sa frecventă în datele de antrenare înseamnă că LLM-urile generează clase Tailwind cu mare precizie și rareori inventează utilitare inexistente.
Vocabularul claselor este finit și bine definit. Un agent nu poate inventa o proprietate CSS care nu există, ceea ce reduce considerabil erorile de stilizare față de CSS liber, unde agentul ar putea genera selectori invalizi sau ar putea înțelege greșit comportamentul cascadei.
Stilurile sunt în marcaj
Cu Tailwind, toate informațiile de stilizare sunt incluse în șablonul HTML. Agentul vede într-un singur loc descrierea vizuală completă a unui element. Nu este nevoie să consulte fișiere .css separate, să înțeleagă ordinea cascadei sau să urmărească conflictele de specificitate.
Acest lucru este deosebit de util pentru blocurile Blockstudio, al căror șablon este deja un singur fișier. Agentul poate genera dintr-o singură încercare o componentă completă și stilizată:
<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>
Agenți paraleli fără conflicte
Deoarece stilurile Tailwind sunt limitate la fiecare șablon, mai mulți agenți (sau dezvoltatori) pot lucra simultan la blocuri diferite fără conflicte CSS de îmbinare. Nu există o foaie de stil comună în care modificările unei componente să le strice accidental pe celelalte. Fiecare bloc este autonom.
Acest lucru funcționează bine și cu CSS obișnuit, când folosiți stilurile cu domeniu de aplicare Blockstudio (style.scoped.css), dar Tailwind elimină complet fișierul CSS, ceea ce înseamnă un fișier în minus de gestionat de agent pentru fiecare bloc.
CSS obișnuit funcționează în continuare
Tailwind nu este obligatoriu. Fluxul de gestionare a resurselor din Blockstudio procesează automat fișierele .css și .scss, inclusiv stilurile cu domeniu de aplicare limitat la bloc. Dacă proiectul folosește o altă metodologie CSS, agenții pot lucra și cu aceasta. Avantajul lui Tailwind este pur și simplu că LLM-urile se descurcă mai bine cu el datorită prezenței ample în datele de antrenare și asocierii stilurilor cu marcajul.
Agenți AI de programare
Toate următoarele instrumente CLI pot lucra cu proiecte Blockstudio imediat, fără configurări suplimentare. Ele citesc și scriu fișiere, rulează comenzi shell și înțeleg structura proiectului pe baza fișierelor de context.
Agenți de terminal (CLI)
| Instrument | Furnizor | Note |
|---|---|---|
| Claude Code | Anthropic | Agent conceput în primul rând pentru terminal. Citește CLAUDE.md pentru contextul proiectului. |
| Codex CLI | OpenAI | CLI open-source creat în Rust. Disponibil și ca aplicație desktop. |
| Gemini CLI | Open-source, cu fereastră de context de 1M de tokenuri. Citește GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Agenți paraleli specializați pentru explorare, sarcini, planificare și revizuire. |
| Aider | Sursă deschisă | Acceptă peste 100 furnizori LLM, inclusiv modele locale. |
| OpenCode | Sursă deschisă | Interfață TUI de terminal cu integrare LSP. Acceptă peste 75 de furnizori. |
| Amazon Q Developer CLI | AWS | Este disponibil un nivel gratuit. Potrivit pentru proiecte integrate cu AWS. |
Agenți IDE
| Instrument | Furnizor | Note |
|---|---|---|
| Cursor | Cursor | Derivat din VS Code, cu AI integrat. Are și un CLI (beta). |
| Windsurf | Cognition AI | Derivat din VS Code, cu asistentul agentic Cascade. |
| Cline | Sursă deschisă | Extensie VS Code cu aprobare pas cu pas. Are și un CLI. |
| Kilo Code | Sursă deschisă | Mod de orchestrare cu subagenți coordonați. |
| Continuă | Sursă deschisă | Extensie VS Code/JetBrains cu agenți CI/CD asincroni. |
| Augment Code | Augment | Axat pe companii, cu indexare aprofundată a bazei de cod. |
Toate aceste instrumente pot crea și edita fișiere într-un director de proiect Blockstudio. Agenții de terminal sunt deosebit de potriviți deoarece dezvoltarea Blockstudio nu necesită funcționalități specifice unui IDE: se bazează exclusiv pe fișiere.
Configurarea proiectului pentru agenții AI
Fișierul de context pentru LLM
Blockstudio include un fișier de context creat în prealabil, care indexează documentația completă a frameworkului. Nu este un rezumat sau un ghid rapid: fiecare document este listat o singură dată, împreună cu ruta, scopul și identificatorii pe care îi conține, astfel încât un agent să găsească pagina care răspunde la o întrebare și să o deschidă doar pe aceea. Textul complet al fiecărui document și al fiecărei scheme rămâne disponibil într-un al doilea fișier pentru instrumentele care au nevoie de întregul corpus dintr-o dată.
Activați-l în blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Indexul este acum disponibil la your-site.com/blockstudio-llm.txt, iar textul complet la your-site.com/blockstudio-llm-full.txt. Indicați instrumentului AI indexul și acesta va putea accesa întregul Blockstudio API fără instrucțiuni suplimentare. Consultați documentația de integrare AI pentru instrucțiuni specifice fiecărui instrument.
Astfel, nu mai este nevoie să scrieți singuri instrucțiuni specifice frameworkului. Un agent cu acces la blockstudio-llm.txt poate afla cum să creeze blocuri, să definească câmpuri, să scrie șabloane, să configureze Tailwind, să creeze pagini și să folosească toate hook-urile oferite de Blockstudio.
Fișiere de context specifice proiectului
Majoritatea agenților AI de programare citesc și un fișier de context la nivel de proiect, cu instrucțiuni specifice bazei de cod. Convențiile diferă în funcție de instrument:
| Fișier | Instrument |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI și altele |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Deoarece blockstudio-llm.txt acoperă deja frameworkul, fișierul de context al proiectului trebuie doar să descrie ce este specific proiectului: structura directoarelor, convențiile de denumire, comenzile și limitele.
Dacă instalați blockstudio/phpstan, nu trebuie să scrieți manual această descriere. vendor/bin/blockstudio-agents generează un AGENTS.md pe baza fișierului blockstudio.json și a propriilor fișiere, listând ce creează autorii proiectului, ce funcționalități sunt activate, ce va respinge analiza și ce comenzi se aplică. Refuză să suprascrie un fișier pe care nu l-a creat și păstrează notele dumneavoastră când îl generați din nou.
# 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
Instrumente pentru dezvoltatori în fluxurile de lucru AI
Blockstudio include două instrumente pentru dezvoltatori concepute special pentru dezvoltarea asistată de AI.
Canvas
canvas oferă o vedere de ansamblu asemănătoare Figma asupra tuturor paginilor Blockstudio, afișate ca planșe iframe interactive într-o singură vizualizare. Deplasați-vă cu trackpadul și măriți sau micșorați cu gestul de apropiere a degetelor ori cu Ctrl+scroll.
Acest lucru este util când lucrați cu agenți AI, deoarece vă oferă o vedere de ansamblu vizuală asupra fiecărei pagini fără să schimbați filele sau să navigați în panoul de administrare WordPress. Când un agent modifică un șablon de pagină, puteți vedea imediat rezultatul. Activați modul live, iar canvasul se reîmprospătează automat când se schimbă fișierele.
Activați-l în blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Apoi navigați la /wp-admin/admin.php?page=blockstudio-canvas. Comutați între vizualizarea paginilor (planșe pe toată lățimea) și vizualizarea blocurilor (grilă cu toate blocurile înregistrate și valorile implicite).
Element Grabber
Element Grabber rezolvă o problemă frecventă în fluxurile de lucru AI: indicarea fișierului care redă un anumit element de pe pagină.
Adăugați ?blockstudio-devtools la orice adresă URL din frontend, apoi țineți apăsat Cmd+C (Mac) sau Ctrl+C (Windows) timp de 100ms. Se activează un selector tip reticul care evidențiază blocurile Blockstudio când treceți cursorul peste ele. Faceți clic pe un element pentru a-i copia contextul în clipboard:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Lipiți acest text în instrumentul AI de programare, iar agentul va afla imediat calea fișierului, structura HTML și elementul spre care indicați. Nu mai trebuie să căutați manual căile către fișierele șablon.
Activați-l în blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Modele practice
Crearea unui singur bloc
Cel mai simplu flux de lucru: descrieți ce doriți și lăsați agentul să creeze blocul.
Prompt:
Creați un bloc de testimoniale cu câmpuri pentru citat (textarea), numele autorului (text), rolul autorului (text) și fotografia autorului (files). Folosiți Tailwind pentru stilizare. Citatul ar trebui să aibă un font cursiv mare și un semn decorativ de citare.
Agentul va crea:
blockstudio/testimonial/
├── block.json
└── index.php
Crearea unei pagini complete
Paginile bazate pe fișiere ale Blockstudio permit unui agent să creeze scheletul unei pagini WordPress întregi sub formă de șablon. Aici se vede adevăratul avantaj: în loc să construiască blocurile unul câte unul, agentul creează dintr-o singură trecere structura completă a paginii, cu toate blocurile sale.
Prompt:
Creați o pagină „Despre” cu o secțiune principală, o grilă cu echipa și un formular de contact cu un substituent. Folosiți blocurile existente acolo unde este posibil și creați blocuri noi când este necesar. Asociați-o cu ID-ul de postare 2. Blocați șablonul, dar permiteți editarea conținutului din titluri și paragrafe.
Agentul creează:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
În plus, creează orice blocuri personalizate la care face referire (e.g., blockstudio/team-member/). Rulați
wp bs pages sync pentru a crea postarea WordPress cu blocarea șablonului și
controalele de editare. Întreaga pagină este gestionată prin controlul versiunilor și reproductibilă.
Crearea unui site complet
Aici arhitectura lui Blockstudio își arată cu adevărat punctele forte. Un singur prompt poate genera un site întreg, deoarece fiecare element este un fișier:
Prompt:
Creați un site web de portofoliu cu următoarele pagini: Acasă, Lucrări, Despre, Contact. Creați blocuri personalizate pentru: secțiunea principală, grila de proiecte, cardul proiectului, membrul echipei, informațiile de contact și subsol. Folosiți o temă întunecată cu Tailwind. Configurați Tailwind în blockstudio.json cu o paletă de culori personalizată.
Agentul creează directoarele blocurilor, șabloanele paginilor, un blockstudio.json cu configurația Tailwind și, opțional, modele pentru secțiuni reutilizabile. Totul este înregistrat în git ca un singur set de modificări.
Fluxuri de lucru cu agenți paraleli
Unele instrumente (aplicația desktop Codex, GitHub Copilot CLI, Kilo Code) permit rularea mai multor agenți în paralel. Arhitectura Blockstudio, cu câte un fișier pentru fiecare bloc, face acest lucru sigur:
- Agentul 1: creează blocul principal și pagina de pornire
- Agentul 2: creează blocul cardului de proiect și pagina cu lucrări
- Agentul 3: creează blocul formularului de contact și pagina de contact
Deoarece fiecare bloc are propriul director, iar stilurile Tailwind sunt incluse în șabloane, agenții nu se vor încurca unii pe alții. Singurul fișier comun este blockstudio.json, care de obicei trebuie configurat o singură dată, la început.
Sfaturi pentru rezultate mai bune
-
Indicați fișierul de context pentru LLM. Agenții produc cod Blockstudio mult mai bun atunci când au acces la documentația frameworkului. Indicați-le întotdeauna
blockstudio-llm.txtși oferiți-le unAGENTS.mdgenerat pentru proiectul propriu-zis. -
Precizați tipurile de câmpuri. În loc de „adăugați un câmp pentru imagine”, spuneți „adăugați un câmp files cu
allowedTypes: ['image']șireturnFormat: 'object'”. Cu cât definiți câmpurile mai precis, cu atât veți avea nevoie de mai puține iterații. -
Începeți cu un bloc, apoi extindeți. Lăsați agentul să creeze corect un bloc, verificați tiparele folosite și apoi cereți-i să creeze restul respectând aceleași convenții. Astfel, stabiliți un model de referință care îmbunătățește rezultatele ulterioare.
-
Revizuiți rezultatul. Vibe coding nu înseamnă să acceptați codul fără să-l verificați. Asigurați-vă că tipurile de câmpuri corespund intenției dumneavoastră, că șabloanele sunt afișate corect și că clasele Tailwind oferă rezultatul vizual dorit. Codul generat de AI trebuie verificat înainte de lansare.
-
Folosiți scheme
block.json. Blockstudio oferă o schemă JSON lahttps://blockstudio.dev/schema/block. Adăugarea lui"$schema"la block.json oferă agenților feedback de validare și previne configurațiile malformate. -
Păstrați blocurile mici și bine delimitate. Folosiți un bloc pentru fiecare componentă vizuală. Astfel, agentului îi va fi mai ușor să analizeze fiecare bloc, iar șabloanele vor rămâne suficient de scurte pentru a încăpea într-o singură fereastră de context.