Vibecoding dengan Blockstudio
Andrej Karpathy mencetuskan istilah “vibe coding” pada Februari 2025 untuk menggambarkan alur kerja saat Anda menjelaskan keinginan kepada AI dan AI menulis kodenya. Setahun kemudian, praktik ini berkembang menjadi apa yang kini ia sebut “rekayasa agentik”: pengembang mengatur agen AI alih-alih menulis kode baris demi baris.
Blockstudio dibuat untuk kebutuhan ini. Arsitektur berbasis berkas, tanpa alat build, dan struktur proyek yang konsisten menjadikannya salah satu lingkungan terbaik untuk pengembangan WordPress berbantuan AI.
Panduan ini membahas pola praktis untuk menggunakan agen pengodean AI dengan Blockstudio, mulai dari penyiapan proyek hingga pembuatan situs lengkap.
Alasan Blockstudio cocok dengan agen AI
Berkas, bukan basis data
Agen pengodean AI membaca dan menulis berkas. Itulah antarmuka utamanya. Blockstudio menyimpan semuanya di sistem berkas: sebuah block.json dan berkas templat untuk setiap blok, sebuah page.json untuk setiap halaman, serta sebuah pattern.json untuk setiap pola. Tidak ada entri basis data yang perlu dikelola, tidak ada UI admin yang harus diklik, dan tidak ada langkah build yang harus dijalankan.
Ini penting karena sistem berkas dan perintah shell merupakan salah satu sumber terbesar data prapelatihan untuk LLM. Setiap model telah melihat jutaan contoh membaca, menulis, dan mengatur berkas. Jika alur kerja pengembangan WordPress Anda menggunakan antarmuka yang sama, agen dapat bekerja dengan instruksi minimal.
Struktur yang konsisten
Setiap blok Blockstudio mengikuti pola yang sama:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Dengan konsistensi ini, agen yang telah membuat satu blok dapat membuat seratus blok. Tidak ada kejutan, kasus khusus, atau konfigurasi tersembunyi. Pola yang sama berlaku untuk halaman (page.json + templat), pola (pattern.json + templat), dan ekstensi (extend.json).
Halaman lengkap sebagai berkas
Pembuatan halaman WordPress secara tradisional memerlukan editor blok: menyeret blok, mengatur setelan, lalu menyimpan melalui admin. Agen AI tidak dapat melakukan semua itu. Agen memerlukan berkas.
Halaman berbasis berkas Blockstudio mengatasi masalah ini sepenuhnya. Sebuah page.json menentukan metadata halaman, sementara templat index.php menentukan struktur blok menggunakan 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>
Agen dapat membuat kerangka halaman WordPress lengkap, termasuk blok inti, blok kustom, penguncian templat, dan kontrol pengeditan, cukup dengan menulis dua berkas. Jalankan wp bs pages sync untuk menerapkan sumber ke WordPress; membuka admin tidak akan menyinkronkannya secara otomatis.
Ini salah satu fitur paling andal untuk pengembangan berbantuan AI. Alih-alih menjelaskan tata letak halaman lalu menyusunnya secara manual di editor, Anda menjelaskannya kepada agen dan agen menulis templatnya. Hasilnya terlacak versinya, dapat direproduksi, dan dapat disempurnakan dalam hitungan detik.
Tanpa langkah build
Tidak ada yang perlu dikompilasi, dipaketkan, atau ditranspilasi. Agen membuat berkas dan berkas itu langsung berfungsi. SCSS dikompilasi di sisi server. Modul ES diresolusikan saat runtime. Tailwind CSS dikompilasi pada setiap permintaan frontend. Siklus umpan balik antara “agen menulis kode” dan “kode berjalan di browser” menjadi sesingkat mungkin.
Alasan memilih Tailwind CSS
Blockstudio mendukung CSS reguler maupun Tailwind CSS, tetapi Tailwind memiliki keunggulan besar saat digunakan bersama agen AI.
LLM sangat memahami Tailwind
Tailwind CSS digunakan di puluhan ribu repositori sumber terbuka. Teknologi ini mendukung antarmuka Claude.ai, Vercel, Shopify, Cursor, serta produk OpenAI sendiri. Banyaknya penggunaan dalam data pelatihan membuat LLM menghasilkan kelas Tailwind dengan akurasi tinggi dan jarang mengada-adakan utilitas yang tidak ada.
Kosakata kelasnya terbatas dan terdefinisi dengan baik. Agen tidak dapat mengarang properti CSS yang tidak tersedia, sehingga kesalahan penataan berkurang drastis dibandingkan CSS bebas, yang dapat membuat agen menghasilkan pemilih tidak valid atau salah memahami perilaku kaskade.
Gaya berada di markup
Dengan Tailwind, semua informasi gaya berada bersama dalam templat HTML. Agen melihat deskripsi visual lengkap suatu elemen di satu tempat. Tidak perlu merujuk silang berkas .css terpisah, memahami urutan kaskade, atau melacak konflik spesifisitas.
Ini sangat berguna untuk blok Blockstudio, yang templatnya memang sudah berupa satu berkas. Agen dapat membuat komponen bergaya yang lengkap dalam sekali pengerjaan:
<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 paralel tanpa konflik
Karena gaya Tailwind dicakup oleh setiap templat, beberapa agen (atau pengembang) dapat mengerjakan blok berbeda secara bersamaan tanpa konflik penggabungan CSS. Tidak ada lembar gaya bersama yang membuat perubahan pada satu komponen merusak komponen lain secara tidak sengaja. Setiap blok berdiri sendiri.
Cara ini juga berfungsi baik dengan CSS reguler saat menggunakan gaya tercakup milik Blockstudio (style.scoped.css), tetapi Tailwind menghilangkan seluruh berkas CSS sehingga agen perlu mengelola satu berkas lebih sedikit untuk setiap blok.
CSS reguler tetap bisa digunakan
Tailwind tidak wajib digunakan. Pipeline aset Blockstudio menangani berkas .css dan .scss secara otomatis, termasuk gaya tercakup yang diberi namespace sesuai blok. Jika proyek Anda menggunakan metodologi CSS lain, agen juga dapat menggunakannya. Keunggulan Tailwind hanyalah LLM lebih mahir menggunakannya berkat cakupan data pelatihan dan gaya yang berada bersama markup.
Agen pengodean AI
Semua alat CLI berikut dapat langsung digunakan dengan proyek Blockstudio. Alat-alat ini membaca dan menulis berkas, menjalankan perintah shell, serta memahami struktur proyek dari berkas konteks.
Agen terminal (CLI)
| Alat | Penyedia | Catatan |
|---|---|---|
| Claude Code | Anthropic | Agen yang mengutamakan terminal. Membaca CLAUDE.md untuk konteks proyek. |
| Codex CLI | OpenAI | CLI sumber terbuka yang dibuat dengan Rust. Juga tersedia sebagai aplikasi desktop. |
| Gemini CLI | Sumber terbuka dengan jendela konteks 1M token. Membaca GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Agen paralel khusus untuk eksplorasi, tugas, perencanaan, dan peninjauan. |
| Aider | Sumber terbuka | Mendukung 100+ penyedia LLM, termasuk model lokal. |
| OpenCode | Sumber terbuka | TUI terminal dengan integrasi LSP. Mendukung 75+ penyedia. |
| Amazon Q Developer CLI | AWS | Tersedia paket gratis. Cocok untuk proyek yang terintegrasi dengan AWS. |
Agen IDE
| Alat | Penyedia | Catatan |
|---|---|---|
| Cursor | Cursor | Fork VS Code dengan AI bawaan. Juga memiliki CLI (beta). |
| Windsurf | Cognition AI | Fork VS Code dengan asisten agentik Cascade. |
| Cline | Sumber terbuka | Ekstensi VS Code dengan persetujuan langkah demi langkah. Juga memiliki CLI. |
| Kilo Code | Sumber terbuka | Mode orkestrator dengan subagen yang terkoordinasi. |
| Continue | Sumber terbuka | Ekstensi VS Code/JetBrains dengan agen CI/CD asinkron. |
| Augment Code | Augment | Berfokus pada perusahaan dengan pengindeksan basis kode mendalam. |
Semua alat ini dapat membuat dan mengedit berkas di direktori proyek Blockstudio. Agen terminal sangat cocok karena pengembangan Blockstudio tidak memerlukan fitur khusus IDE: semuanya berbasis berkas.
Menyiapkan proyek untuk agen AI
Berkas konteks LLM
Blockstudio menyertakan berkas konteks siap pakai yang mengindeks seluruh dokumentasi kerangka kerja. Berkas ini bukan ringkasan atau panduan singkat: setiap dokumen tercantum satu kali beserta rute, tujuan, dan pengenal yang menjadi tanggung jawabnya, sehingga agen dapat menemukan halaman yang menjawab pertanyaan lalu hanya membuka halaman tersebut. Teks lengkap setiap dokumen dan skema tetap tersedia dalam berkas kedua bagi alat yang memerlukan seluruh korpus sekaligus.
Aktifkan di blockstudio.json Anda:
{
"ai": {
"enableContextGeneration": true
}
}
Indeks kini tersedia di your-site.com/blockstudio-llm.txt, dan teks lengkapnya di your-site.com/blockstudio-llm-full.txt. Arahkan alat AI Anda ke indeks agar alat tersebut dapat mengakses seluruh Blockstudio API tanpa instruksi tambahan. Lihat dokumentasi integrasi AI untuk penyiapan khusus alat.
Ini menggantikan kebutuhan untuk menulis sendiri instruksi khusus kerangka kerja. Agen yang memiliki akses ke blockstudio-llm.txt dapat mencari cara membuat blok, menentukan bidang, menulis templat, mengonfigurasi Tailwind, menyiapkan halaman, dan menggunakan setiap hook yang disediakan Blockstudio.
Berkas konteks khusus proyek
Sebagian besar agen pengodean AI juga membaca berkas konteks tingkat proyek untuk memperoleh instruksi khusus bagi basis kode Anda. Konvensinya berbeda-beda menurut alat:
| Berkas | Alat |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI, dan lainnya |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Karena blockstudio-llm.txt sudah mencakup kerangka kerja, berkas konteks proyek Anda hanya perlu menjelaskan hal unik dari proyek, seperti tata letak direktori, konvensi penamaan, perintah, dan batasan.
Jika Anda memasang blockstudio/phpstan, Anda tidak perlu menulis deskripsi itu sendiri. vendor/bin/blockstudio-agents membuat AGENTS.md dari blockstudio.json dan berkas Anda, yang mencantumkan hal-hal yang dibuat proyek, fitur yang diaktifkan, hal-hal yang akan ditolak oleh analisis, serta perintah yang berlaku. Alat ini menolak menimpa berkas yang bukan dibuatnya dan mempertahankan catatan Anda saat berkas dibuat ulang.
# 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
Alat pengembang untuk alur kerja AI
Blockstudio menyertakan dua alat pengembang yang dirancang khusus untuk pengembangan berbantuan AI.
Kanvas
Kanvas adalah ikhtisar Figma atas semua halaman Blockstudio Anda, yang ditampilkan sebagai artboard iframe langsung dalam satu tampilan. Geser dengan trackpad, lalu perbesar dengan gerakan mencubit atau Ctrl+scroll.
Fitur ini berguna saat bekerja dengan agen AI karena memberi Anda gambaran visual semua halaman tanpa berpindah tab atau menavigasi admin WordPress. Saat agen mengubah templat halaman, Anda dapat langsung melihat hasilnya. Aktifkan mode langsung agar kanvas diperbarui otomatis saat berkas berubah.
Aktifkan di blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Lalu buka /wp-admin/admin.php?page=blockstudio-canvas. Beralihlah antara tampilan halaman (artboard selebar penuh) dan tampilan blok (kisi semua blok terdaftar beserta nilai default).
Penangkap Elemen
Penangkap elemen mengatasi masalah umum dalam alur kerja AI: memberi tahu agen berkas mana yang merender elemen tertentu pada halaman.
Tambahkan ?blockstudio-devtools ke URL frontend mana pun, lalu tahan Cmd+C (Mac) atau Ctrl+C (Windows) selama 100ms. Pemilih bidik akan aktif dan menyoroti blok Blockstudio saat Anda mengarahkan kursor. Klik elemen untuk menyalin konteksnya ke papan klip:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Tempelkan ini ke alat pengodean AI Anda agar agen langsung mengetahui jalur berkas, struktur HTML, dan elemen yang Anda tunjuk. Anda tak perlu lagi mencari jalur berkas templat secara manual.
Aktifkan di blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Pola praktis
Membuat satu blok
Alur kerja paling sederhana: jelaskan keinginan Anda dan biarkan agen membuatnya.
Prompt:
Buat blok testimoni dengan bidang untuk kutipan (textarea), nama penulis (teks), peran penulis (teks), dan foto penulis (berkas). Gunakan Tailwind untuk penataan gaya. Kutipan harus menggunakan huruf miring berukuran besar dengan tanda kutip dekoratif.
Agen akan membuat:
blockstudio/testimonial/
├── block.json
└── index.php
Membuat halaman lengkap
Halaman berbasis berkas milik Blockstudio memungkinkan agen membuat kerangka halaman WordPress lengkap sebagai templat. Di sinilah manfaat utamanya: alih-alih membuat blok satu per satu, agen membuat seluruh struktur halaman beserta semua bloknya sekaligus.
Prompt:
Buat halaman “Tentang” dengan bagian hero, kisi tim, dan formulir kontak placeholder. Gunakan blok yang sudah ada jika memungkinkan, buat blok baru jika diperlukan. Tetapkan ke ID postingan 2. Kunci templat, tetapi izinkan judul dan paragraf untuk diedit sebagai konten.
Agen membuat:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Ditambah blok kustom apa pun yang dirujuknya (e.g, blockstudio/team-member/). Jalankan
wp bs pages sync untuk membuat postingan WordPress dengan penguncian templat dan
kontrol pengeditannya. Seluruh halaman terlacak versinya dan dapat direproduksi.
Membuat situs lengkap
Arsitektur Blockstudio benar-benar unggul di sini. Satu prompt dapat menghasilkan seluruh situs karena setiap komponennya berupa berkas:
Prompt:
Buat situs portofolio dengan halaman berikut: Beranda, Karya, Tentang, Kontak. Buat blok kustom untuk: bagian hero, kisi proyek, kartu proyek, anggota tim, info kontak, dan footer. Gunakan tema gelap dengan Tailwind. Konfigurasikan Tailwind di blockstudio.json dengan palet warna kustom.
Agen membuat direktori blok, templat halaman, sebuah blockstudio.json dengan konfigurasi Tailwind, serta pola opsional untuk bagian yang dapat digunakan kembali. Semuanya di-commit ke git sebagai satu changeset.
Alur kerja agen paralel
Beberapa alat (aplikasi desktop Codex, GitHub Copilot CLI, Kilo Code) mendukung eksekusi beberapa agen secara paralel. Arsitektur Blockstudio yang menggunakan satu berkas per blok membuatnya aman:
- Agen 1: membuat blok hero dan halaman beranda
- Agen 2: membuat blok kartu proyek dan halaman karya
- Agen 3: membuat blok formulir kontak dan halaman kontak
Karena setiap blok memiliki direktori sendiri dan gaya Tailwind berada bersama di templat, agen-agen ini tidak akan saling bentrok. Satu-satunya berkas bersama adalah blockstudio.json, yang biasanya hanya perlu disiapkan sekali di awal.
Kiat untuk hasil yang lebih baik
-
Rujuk berkas konteks LLM. Agen menghasilkan kode Blockstudio yang jauh lebih baik jika dapat mengakses dokumentasi kerangka kerja. Selalu arahkan agen ke
blockstudio-llm.txtdan berikanAGENTS.mdyang dibuat khusus untuk proyek Anda. -
Jelaskan jenis bidang secara spesifik. Alih-alih mengatakan "tambahkan bidang gambar", katakan "tambahkan bidang berkas dengan
allowedTypes: ['image']danreturnFormat: 'object'." Definisi bidang yang lebih spesifik akan mengurangi jumlah iterasi. -
Mulai dengan satu blok, lalu kembangkan. Minta agen membuat satu blok dengan benar, tinjau polanya, lalu minta agen membuat sisanya dengan mengikuti konvensi yang sama. Ini menjadi acuan yang meningkatkan hasil berikutnya.
-
Tinjau hasilnya. Vibe coding bukan berarti menerima kode begitu saja. Pastikan jenis bidang sesuai dengan keinginan Anda, templat dirender dengan benar, dan kelas Tailwind menghasilkan tampilan visual yang tepat. Kode buatan AI perlu ditinjau sebelum dirilis.
-
Gunakan skema
block.json. Blockstudio menyediakan Skema JSON dihttps://blockstudio.dev/schema/block. Menambahkan"$schema"ke block.json memberi agen umpan balik validasi dan mencegah konfigurasi yang tidak valid. -
Buat blok tetap kecil dan terfokus. Satu blok untuk setiap komponen visual. Dengan begitu, agen lebih mudah memahami tiap blok dan templat cukup singkat untuk dimuat dalam satu jendela konteks.