Vibecoding z Blockstudio
Andrej Karpathy ukuł termin „vibe coding” w lutym 2025, aby opisać sposób pracy, w którym opisujesz AI, czego chcesz, a ono pisze kod. Rok później ta praktyka dojrzała do tego, co obecnie nazywa „inżynierią agentową”: programiści koordynują agentów AI zamiast pisać kod linijka po linijce.
Blockstudio powstało właśnie z myślą o tym. Architektura oparta na plikach, brak narzędzi do budowania i przewidywalna struktura projektu sprawiają, że jest to jedno z najlepszych środowisk do tworzenia WordPress z pomocą AI.
Ten przewodnik omawia praktyczne sposoby korzystania z agentów AI do programowania z Blockstudio, od konfiguracji projektu po generowanie całej witryny.
Dlaczego Blockstudio dobrze współpracuje z agentami AI
Pliki zamiast baz danych
Agenci AI do programowania odczytują i zapisują pliki. To ich podstawowy interfejs. Blockstudio przechowuje wszystko w systemie plików: plik block.json i plik szablonu dla każdego bloku, plik page.json dla każdej strony oraz plik pattern.json dla każdego wzorca. Nie trzeba zarządzać wpisami w bazie danych, przeklikiwać się przez panel administracyjny UI ani uruchamiać procesu budowania.
Ma to znaczenie, ponieważ systemy plików i polecenia powłoki należą do największych źródeł danych treningowych dla LLM-ów. Każdy model widział miliony przykładów odczytywania, zapisywania i porządkowania plików. Gdy Twój sposób pracy przy tworzeniu w WordPress odpowiada temu interfejsowi, agenci mogą działać przy minimalnej liczbie instrukcji.
Przewidywalna struktura
Każdy blok Blockstudio ma taką samą strukturę:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Dzięki tej spójności agent, który zbudował jeden blok, może zbudować ich sto. Nie ma niespodzianek, wyjątków ani ukrytej konfiguracji. Ten sam schemat dotyczy stron (page.json + szablon), wzorców (pattern.json + szablon) i rozszerzeń (extend.json).
Całe strony zapisane w plikach
Tworzenie stron w tradycyjnym WordPress wymaga edytora blokowego: przeciągania bloków, konfigurowania ustawień i zapisywania zmian w panelu administracyjnym. Agenci AI nie mogą tego robić. Potrzebują plików.
Strony Blockstudio oparte na plikach całkowicie rozwiązują ten problem. Plik page.json definiuje metadane strony, a szablon index.php określa strukturę bloków za pomocą 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 może przygotować całą stronę WordPress, wraz z podstawowymi i własnymi blokami, blokadą szablonu oraz kontrolkami edycji, zapisując tylko dwa pliki. Uruchom wp bs pages sync, aby zastosować źródło do WordPress; samo otwarcie panelu administracyjnego nie uruchamia tej synchronizacji.
To jedna z najpotężniejszych funkcji wspierających tworzenie z pomocą AI. Zamiast opisywać układ strony i ręcznie składać go w edytorze, opisujesz go agentowi, a ten zapisuje szablon. Rezultat jest objęty kontrolą wersji, można go odtworzyć i wprowadzać w nim zmiany w kilka sekund.
Bez etapu budowania
Nie ma niczego do kompilowania, łączenia w pakiet ani transpilowania. Agent tworzy plik i od razu można go użyć. SCSS jest kompilowany po stronie serwera. Moduły ES są rozwiązywane w czasie wykonywania. Tailwind CSS jest kompilowany przy każdym żądaniu frontendowym. Pętla informacji zwrotnej między „agent zapisuje kod” a „kod działa w przeglądarce” jest tak krótka, jak to tylko możliwe.
Dlaczego warto wybrać Tailwind CSS
Blockstudio obsługuje zarówno zwykłe CSS, jak i Tailwind CSS, ale Tailwind ma istotną przewagę podczas pracy z agentami AI.
LLM-y doskonale znają Tailwind
Tailwind CSS jest używany w dziesiątkach tysięcy repozytoriów open source. Odpowiada za interfejsy Claude.ai, Vercel, Shopify, Cursor oraz własnych produktów OpenAI. Ta powszechność w danych treningowych sprawia, że LLM-y z dużą dokładnością generują klasy Tailwind i rzadko wymyślają nieistniejące narzędzia.
Zestaw dostępnych klas jest skończony i dobrze określony. Agent nie może wymyślić właściwości CSS, która nie istnieje, co znacznie ogranicza błędy stylowania w porównaniu z dowolnym CSS, gdzie agent mógłby wygenerować nieprawidłowe selektory lub błędnie zrozumieć działanie kaskady.
Style są zapisane w znacznikach
W Tailwind wszystkie informacje o stylach znajdują się w szablonie HTML. Agent widzi pełny opis wyglądu elementu w jednym miejscu. Nie musi odwoływać się do osobnych plików .css, rozumieć kolejności kaskady ani śledzić konfliktów specyficzności.
Jest to szczególnie przydatne w przypadku bloków Blockstudio, których szablon już mieści się w jednym pliku. Agent może za jednym razem wygenerować kompletny, ostylowany komponent:
<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>
Praca wielu agentów bez konfliktów
Ponieważ style Tailwind są ograniczone do poszczególnych szablonów, wielu agentów (lub programistów) może jednocześnie pracować nad różnymi blokami bez konfliktów podczas scalania CSS. Nie ma wspólnego arkusza stylów, w którym zmiany jednego komponentu mogłyby przypadkowo zepsuć inny. Każdy blok jest samodzielny.
Działa to również ze zwykłym CSS, jeśli korzystasz z zakresowych stylów Blockstudio (style.scoped.css), ale Tailwind całkowicie eliminuje plik CSS, więc agent musi zarządzać o jednym plikiem mniej dla każdego bloku.
Zwykłe CSS nadal działa
Tailwind nie jest wymagany. Potok zasobów Blockstudio automatycznie obsługuje pliki .css i .scss, w tym style zakresowe przypisane do bloku. Jeśli Twój projekt korzysta z innej metodologii CSS, agenci też mogą z nią pracować. Zaletą Tailwind jest po prostu to, że LLM-y lepiej sobie z nim radzą dzięki obecności w danych treningowych oraz umieszczeniu stylów razem ze znacznikami.
Agenci AI do programowania
Wszystkie poniższe narzędzia CLI mogą od razu pracować z projektami Blockstudio. Odczytują i zapisują pliki, uruchamiają polecenia powłoki i rozpoznają strukturę projektu na podstawie plików kontekstowych.
Agenci terminalowi (CLI)
| Narzędzie | Dostawca | Uwagi |
|---|---|---|
| Claude Code | Anthropic | Agent zaprojektowany z myślą o terminalu. Odczytuje CLAUDE.md, aby poznać kontekst projektu. |
| Codex CLI | OpenAI | Oprogramowanie open source CLI zbudowane w Rust. Dostępne również jako aplikacja komputerowa. |
| Gemini CLI | Oprogramowanie open source z oknem kontekstu obejmującym 1 mln tokenów. Odczytuje GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Wyspecjalizowani agenci równolegli do eksploracji, wykonywania zadań, planowania i przeglądów. |
| Aider | Oprogramowanie open source | Obsługuje ponad 100 dostawców LLM, w tym modele lokalne. |
| OpenCode | Oprogramowanie open source | Terminalowy interfejs TUI z integracją LSP. Obsługuje ponad 75 dostawców. |
| Amazon Q Developer CLI | AWS | Dostępny bezpłatny plan. Dobrze sprawdza się w projektach zintegrowanych z AWS. |
Agenci IDE
| Narzędzie | Dostawca | Uwagi |
|---|---|---|
| Cursor | Cursor | Fork VS Code z wbudowaną AI. Ma też CLI (beta). |
| Windsurf | Cognition AI | Fork VS Code z asystentem agentowym Cascade. |
| Cline | Oprogramowanie open source | Rozszerzenie VS Code z zatwierdzaniem każdego kroku. Ma też CLI. |
| Kilo Code | Oprogramowanie open source | Tryb orkiestratora koordynujący agentów podrzędnych. |
| Continue | Oprogramowanie open source | Rozszerzenie VS Code/JetBrains z asynchronicznymi agentami CI/CD. |
| Augment Code | Augment | Skierowane do przedsiębiorstw, z zaawansowanym indeksowaniem bazy kodu. |
Wszystkie te narzędzia mogą tworzyć i edytować pliki w katalogu projektu Blockstudio. Agenci terminalowi sprawdzają się tu szczególnie dobrze, ponieważ tworzenie w Blockstudio nie wymaga funkcji specyficznych dla IDE i opiera się wyłącznie na plikach.
Przygotowanie projektu do pracy z agentami AI
Plik kontekstowy LLM
Blockstudio zawiera gotowy plik kontekstowy z indeksem pełnej dokumentacji frameworka. Nie jest to podsumowanie ani ściągawka: każdy dokument jest wymieniony raz, wraz ze swoją ścieżką, przeznaczeniem i identyfikatorami, za które odpowiada. Dzięki temu agent może znaleźć stronę z odpowiedzią na pytanie i otworzyć tylko ją. Pełny tekst wszystkich dokumentów i schematów pozostaje dostępny w drugim pliku dla narzędzi, które chcą od razu skorzystać z całego zbioru.
Włącz go w swoim blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Indeks jest teraz dostępny pod adresem your-site.com/blockstudio-llm.txt, a pełny tekst pod adresem your-site.com/blockstudio-llm-full.txt. Wskaż narzędziu AI indeks, a uzyska dostęp do całej dokumentacji Blockstudio API bez dodatkowych instrukcji. Konfigurację dla poszczególnych narzędzi opisano w dokumentacji integracji AI.
Dzięki temu nie musisz samodzielnie pisać instrukcji specyficznych dla frameworka. Agent z dostępem do blockstudio-llm.txt znajdzie informacje o tworzeniu bloków, definiowaniu pól, pisaniu szablonów, konfigurowaniu Tailwind, tworzeniu stron i korzystaniu ze wszystkich hooków udostępnianych przez Blockstudio.
Pliki kontekstowe specyficzne dla projektu
Większość agentów AI do programowania odczytuje również plik kontekstowy na poziomie projektu, zawierający instrukcje dotyczące konkretnej bazy kodu. Nazewnictwo zależy od narzędzia:
| Plik | Narzędzie |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI i inne |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Ponieważ blockstudio-llm.txt zawiera już informacje o frameworku, plik kontekstowy projektu musi opisywać tylko to, co jest dla niego specyficzne: układ katalogów, konwencje nazewnictwa, polecenia i ograniczenia.
Jeśli zainstalujesz blockstudio/phpstan, nie musisz ręcznie pisać tego opisu. vendor/bin/blockstudio-agents generuje AGENTS.md na podstawie blockstudio.json i Twoich własnych plików, wymieniając, co autorzy projektu, które funkcje są włączone, co odrzuci analiza oraz które polecenia mają zastosowanie. Odmawia nadpisania pliku, którego sam nie utworzył, i zachowuje Twoje własne notatki podczas ponownego generowania.
⟧
# 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
Narzędzia deweloperskie do pracy z AI
Blockstudio zawiera dwa narzędzia deweloperskie przeznaczone specjalnie do tworzenia z pomocą AI.
Canvas
canvas to Figma-podobny przegląd wszystkich stron Blockstudio, wyświetlanych jako interaktywne obszary robocze iframe w jednym widoku. Przesuwaj widok gładzikiem, a powiększaj i pomniejszaj przez uszczypnięcie lub przewijanie z klawiszem Ctrl.
Przy pracy z agentami AI przydaje się wizualny podgląd każdej strony bez przełączania kart ani poruszania się po panelu administracyjnym WordPress. Gdy agent zmodyfikuje szablon strony, od razu zobaczysz rezultat. Włącz tryb na żywo, aby canvas odświeżał się automatycznie po zmianie plików.
Włącz go w blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Następnie przejdź do /wp-admin/admin.php?page=blockstudio-canvas. Możesz przełączać się między widokiem stron (obszary robocze na całą szerokość) a widokiem bloków (siatka wszystkich zarejestrowanych bloków z wartościami domyślnymi).
Element Grabber
element grabber rozwiązuje częsty problem w pracy z AI: jak wskazać agentowi plik renderujący konkretny element na stronie.
Dodaj ?blockstudio-devtools do dowolnego URL frontendu, a następnie przytrzymaj Cmd+C (Mac) lub Ctrl+C (Windows) przez 100ms. Uruchomi się selektor celownika, który podświetli bloki Blockstudio podczas najeżdżania kursorem. Kliknij element, aby skopiować jego kontekst do schowka:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Wklej to do narzędzia AI do programowania, a agent od razu pozna ścieżkę pliku, strukturę HTML i wskazany element. Nie musisz już ręcznie wyszukiwać ścieżek do plików szablonów.
Włącz go w blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktyczne sposoby pracy
Tworzenie pojedynczego bloku
Najprostszy sposób pracy: opisz, czego chcesz, i pozwól agentowi to utworzyć.
Polecenie:
Utwórz blok rekomendacji z polami na cytat (textarea), imię i nazwisko autora (text), stanowisko autora (text) oraz zdjęcie autora (pliki). Do stylowania użyj Tailwind. Cytat powinien być zapisany dużą, pochyloną czcionką i zawierać ozdobny cudzysłów.
Agent utworzy:
blockstudio/testimonial/
├── block.json
└── index.php
Tworzenie całej strony
Strony Blockstudio oparte na plikach pozwalają agentowi przygotować całą stronę WordPress w formie szablonu. Tu widać ich największą zaletę: zamiast budować bloki jeden po drugim, agent za jednym razem tworzy pełną strukturę strony ze wszystkimi blokami.
Polecenie:
Utwórz stronę „O nas” z sekcją powitalną, siatką zespołu i formularzem kontaktowym z tekstem zastępczym. Jeśli to możliwe, użyj istniejących bloków, a w razie potrzeby utwórz nowe. Przypisz stronę do wpisu o ID 2. Zablokuj szablon, ale umożliw edycję treści nagłówków i akapitów.
Agent utworzy:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Oraz wszystkie użyte własne bloki (e.g, blockstudio/team-member/). Uruchom
wp bs pages sync, aby utworzyć wpis WordPress z blokadą szablonu
oraz kontrolkami edycji. Cała strona będzie objęta kontrolą wersji i możliwa do odtworzenia.
Tworzenie całej witryny
Właśnie tutaj architektura Blockstudio pokazuje pełnię swoich możliwości. Jedno polecenie może wygenerować całą witrynę, ponieważ każdy element jest plikiem:
Polecenie:
Zbuduj portfolio z następującymi stronami: Strona główna, Prace, O nas, Kontakt. Utwórz własne bloki dla sekcji powitalnej, siatki projektów, karty projektu, członka zespołu, danych kontaktowych i stopki. Użyj ciemnego motywu z Tailwind. Skonfiguruj Tailwind w blockstudio.json za pomocą własnej palety kolorów.
Agent tworzy katalogi bloków, szablony stron, plik blockstudio.json z konfiguracją Tailwind oraz, opcjonalnie, wzorce wielokrotnego użytku dla sekcji. Wszystko trafia do git jako pojedynczy zestaw zmian.
Równoległa praca agentów
Niektóre narzędzia (aplikacja komputerowa Codex, GitHub Copilot CLI, Kilo Code) obsługują równoległą pracę wielu agentów. Architektura Blockstudio, w której każdy blok ma własny plik, sprawia, że jest to bezpieczne:
- Agent 1: tworzy blok sekcji powitalnej i stronę główną
- Agent 2: tworzy blok karty projektu i stronę z pracami
- Agent 3: tworzy blok formularza kontaktowego i stronę kontaktową
Ponieważ każdy blok ma własny katalog, a style Tailwind znajdują się w szablonach, agenci nie będą sobie nawzajem przeszkadzać. Jedynym współdzielonym plikiem jest blockstudio.json, który zwykle trzeba skonfigurować tylko raz na początku.
Wskazówki, jak uzyskać lepsze rezultaty
-
Wskaż plik kontekstowy LLM. Agenci generują znacznie lepszy kod Blockstudio, gdy mają dostęp do dokumentacji frameworka. Zawsze wskaż im
blockstudio-llm.txti wygeneruj plikAGENTS.mdopisujący sam projekt. -
Podawaj dokładne typy pól. Zamiast „dodaj pole obrazu”, napisz „dodaj pole plików z
allowedTypes: ['image']ireturnFormat: 'object'”. Im dokładniej określisz pola, tym mniej będzie potrzebnych poprawek. -
Zacznij od jednego bloku, a potem zwiększaj skalę. Poproś agenta o poprawne zbudowanie jednego bloku, sprawdź jego wzorce, a następnie zleć mu tworzenie pozostałych według tych samych konwencji. W ten sposób powstanie wzorzec, który poprawi kolejne wyniki.
-
Sprawdź wynik. Vibe coding nie oznacza bezkrytycznego akceptowania kodu. Sprawdź, czy typy pól odpowiadają Twoim oczekiwaniom, szablony renderują się poprawnie, a klasy Tailwind dają właściwy efekt wizualny. Kod wygenerowany przez AI należy sprawdzić przed wdrożeniem.
-
Używaj schematów
block.json. Blockstudio udostępnia schemat JSON pod adresemhttps://blockstudio.dev/schema/block. Dodanie"$schema"do block.json zapewnia agentom informację zwrotną o walidacji i zapobiega nieprawidłowym konfiguracjom. -
Dbaj o to, by bloki były małe i wyspecjalizowane. Jeden blok na komponent wizualny. Dzięki temu agentowi łatwiej przeanalizować każdy blok, a szablony są na tyle krótkie, że mieszczą się w jednym oknie kontekstu.