# Pengembangan blok AI-native

Berkas dan tanpa proses build, sesuai keahlian agent.

[Baca dokumentasi](https://blockstudio.dev/id/docs/dev/ai/)

Rekaman layar tanpa suara: agen coding membangun situs WordPress lengkap dengan 10 blok kustom dan 6 halaman dari satu prompt.

## Jelaskan sebuah blok, dapatkan sebuah blok

Agen coding AI dapat membuat kerangka blok, halaman, dan pola dari satu prompt. Tanpa GUI dan database, hanya berkas.

~/starter-theme

❯ Buat blok harga dengan tiga tingkat, tombol bulanan/tahunan, dan CTA untuk setiap tingkat.

✓ Dibuat pricing/block.json

✓ Dibuat pricing/index.php

✓ Dibuat pricing/style.css

❯ Sekarang buat halaman harga dengan bagian hero dan FAQ.

✓ Dibuat pages/pricing/page.json

✓ Dibuat pages/pricing/index.php

File

blockstudio/

├── pricing/ Baru

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Baru

├── page.json

└── index.php

## Semuanya berbasis berkas

Blok, halaman, pola, dan ekstensi berupa direktori dengan konfigurasi dan templat JSON. Agent membaca dan menulisnya secara langsung.

## Tanpa konfigurasi basis data

Tak perlu mengeklik panel admin. Setiap pengaturan adalah kunci JSON, jadi agent dapat membuat kerangka pustaka tanpa browser.

## Struktur yang konsisten

Setiap blok mengikuti konvensi yang sama: block.json, sebuah templat, dan gaya opsional. Pelajari polanya sekali.

## Konteks, bukan tebakan

Indeks dokumentasi yang ringkas, beserta teks lengkap untuk alat yang membutuhkannya.

### Indeks yang dibaca agent terlebih dahulu

`blockstudio-llm.txt` mencantumkan setiap dokumen satu kali, lengkap dengan rute, berkas sumber, tujuan, serta pengaturan, hook, fungsi PHP, dan perintah CLI yang dimilikinya. Dengan sekitar 11k token, agent membacanya sekaligus, lalu membuka hanya halaman yang diperlukan.

`blockstudio-llm-full.txt` memuat setiap dokumen dan skema JSON dalam satu berkas, sekitar 169k token, untuk alat yang membutuhkan seluruh kumpulan. Aktifkan `ai.enableContextGeneration` agar situs Anda menyajikan keduanya.

[Dokumentasi integrasi AI](https://blockstudio.dev/id/docs/dev/ai/)

blockstudio-llm.txt

```
# Blockstudio documentation index

This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.

Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.
```

## Kontrak untuk proyek Anda

Dokumentasi menjelaskan Blockstudio. AGENTS.md menjelaskan proyek yang akan diubah oleh agent.

### Satu perintah menulis AGENTS.md

`vendor/bin/blockstudio-agents` menjelaskan proyek tempatnya berjalan: isi proyek, fitur yang diaktifkan `blockstudio.json`, hal yang akan ditolak analisis, dan perintah yang berlaku.

Setiap baris berasal dari berkas, pengaturan, atau preset analisis yang dipilih. Membuat ulang tetap mempertahankan catatan tulisan tangan Anda, dan `--check` gagal jika kontraknya sudah usang.

[Kontrak proyek](https://blockstudio.dev/id/docs/dev/phpstan/#project-contract-for-coding-agents)

AGENTS.md

```
# Blockstudio contract for Acme

## Project

- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.

## What this project contains

- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.
```

## Kesalahan ditemukan sebelum commit

Empat preset analisis, masing-masing mencakup preset sebelumnya, serta hook yang menjalankannya pada setiap commit.

### Analisis yang memahami block.json

Preset `blockstudio/phpstan` membaca blok, halaman, dan pengaturan Anda. Templat yang membaca field yang tidak pernah dideklarasikan oleh `block.json`, atau menampilkannya tanpa escape, akan gagal dianalisis.

Templat membaca `$a` bertipe dari `block.json` di sebelahnya, dengan tipe PHP konkret untuk setiap tipe field, dan `Db::get()` mengembalikan rekaman dengan bentuk yang ditentukan oleh `db.php`. Jalur pengaturan atau nama hook yang salah eja akan gagal dengan saran nama valid yang paling mirip.

Atur `githooks.commit` dan jalankan `vendor/bin/blockstudio-githooks sync`: hook pre-commit terkelola menjalankan analisis yang sama, sehingga blok yang rusak tidak pernah masuk ke commit.

[Preset analisis](https://blockstudio.dev/id/docs/dev/phpstan/#analysis-presets)

blockstudio.json

```
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}
```

## [base](https://blockstudio.dev/id/docs/dev/phpstan/#analysis-presets)

Setiap kunci $a yang dibaca templat tersedia di block.json; hook, jalur pengaturan, dan tag blok benar-benar ada.

## [theme](https://blockstudio.dev/id/docs/dev/phpstan/#analysis-presets)

Header tema, aset yang dideklarasikan, cakupan %selector%, nilai default field, dan batas repeater.

## [extreme-theme](https://blockstudio.dev/id/docs/dev/phpstan/#analysis-presets)

Batas maksimum PHPStan, output yang di-escape, tanpa menjalankan shell, kelas Tailwind yang valid, dan JavaScript yang bersih.

## [wordpress-render](https://blockstudio.dev/id/docs/dev/phpstan/#live-wordpress-rendering)

Tema Extreme ditambah probe render WordPress langsung yang Anda sediakan. Ini berjalan tanpa shell, dan render yang gagal menjadi temuan.

## [Twig, Blade, dan skrip](https://blockstudio.dev/id/docs/dev/phpstan/#what-it-checks)

Twig, Blade, dan tag blok diperiksa berdasarkan field yang sama. Lapisan Extreme juga membaca JavaScript dan direktif Interactivity berdasarkan markup dan penyimpanan Anda.

## [Proyek yang sudah ada](https://blockstudio.dev/id/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Baseline PHPStan menahan temuan yang tercatat sementara kode baru memenuhi preset lengkap. blockstudioScanRoots membaca pustaka blok di luar root, dan stub yang disertakan memberi tipe untuk API publik.

## Inventaris dan rendering dari PHP

Beberapa pemanggilan memungkinkan agen melihat apa yang didaftarkan sebuah proyek, merender bagian mana pun darinya, dan memeriksa data yang disimpannya.

### Tanyakan proyek, tampilkan jawabannya

`Canvas::inventory()` mengembalikan setiap halaman, blok, pola, templat Site Editor, bagian templat, dan contoh UI yang didaftarkan proyek, tanpa merender apa pun.

`Render::document()` merendernya sebagai dokumen HTML lengkap dengan aset yang benar-benar digunakannya, sehingga agent dapat memeriksa hasilnya di luar editor.

`Canvas::documents()` merender persis rekaman yang Anda pilih. `Render::composition()` dan `Render::content()` mengembalikan deklarasi bertingkat atau konten blok berserialisasi sebagai HTML, sedangkan `Ui::inventory()` dan `Ui::examples()` mencantumkan keluarga komponen bawaan dengan satu deklarasi yang dapat dirender untuk tiap keluarga.

Untuk satu blok, `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()`, dan `bs_block_assets()` mengembalikan field, nilai, dan asetnya tanpa merendernya, sedangkan `bs_validate_block()` memeriksa atribut tersimpan sebelum Anda menyimpannya.

[Rendering terprogram](https://blockstudio.dev/id/docs/blocks/rendering/#structured-compositions-and-complete-documents)

inspect.php

```
use Blockstudio\Canvas;
use Blockstudio\Render;

$project = Canvas::inventory(['blocks' => true]);

foreach ($project['inventory']['blocks'] as $block) {
  echo $block['name'] . "\n";
}

$doc = Render::document(
  ['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
  ['title' => 'Hero preview']
);

file_put_contents('hero.html', $doc['html']);
```

## Token per halaman kurang dari setengah

Agent menulis HTML biasa. Saat sinkronisasi, Blockstudio mengubahnya menjadi markup blok WordPress serialisasi: lebih sedikit yang perlu dibuat dan lebih sedikit peluang salah.

### Blockstudio

Yang ditulis agen

Sekitar 135 token

index.php

```
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>

<block name="core/columns">
  <block name="core/column">
    <h3>Lightning Fast</h3>
    <p>Pages load in under one second.</p>
  </block>
  <block name="core/column">
    <h3>Easy to Use</h3>
    <p>No technical skills required.</p>
  </block>
  <block name="core/column">
    <h3>SEO Optimized</h3>
    <p>Built-in best practices from day one.</p>
  </block>
</block>

<img src="/dashboard.jpg" alt="Dashboard" />
```

### WordPress

Yang ditulis parser untuk membuatnya

Sekitar 310 token

post_content

```
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Lightning Fast</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Pages load in under one second.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Easy to Use</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>No technical skills required.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">SEO Optimized</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Built-in best practices from day one.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->
```

Diukur dari dua panel di atas: 540 karakter HTML dibandingkan dengan 1,233 karakter markup blok yang ditulis parser bawaan untuknya, lalu dibagi empat, perkiraan umum jumlah karakter per token. Markup ditampilkan dengan pemisah baris agar mudah dibaca.

## Lebih sedikit output untuk dibuat

Agent menulis HTML tanpa pembatas blok, kelas yang dihasilkan, atau markup pembungkus.

## Lebih sedikit peluang salah

Parser menjamin output blok yang valid dari input yang lebih sederhana.

## Lebih cepat dan hemat

Token output yang lebih sedikit berarti respons lebih cepat dan biaya model lebih rendah.

## Kompatibel dengan setiap alat coding AI

Agent apa pun yang dapat membaca dan menulis berkas bisa langsung menggunakan Blockstudio.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Dirancang untuk alur kerja AI

Blok, halaman, pola, pengaturan. Semuanya berupa berkas yang dapat dibaca, ditulis, dan diubah oleh agent.

## Dua berkas per blok

Konfigurasi JSON dan templat sudah mencakup seluruh blok. Permukaan yang kecil membuat pembuatan pada percobaan pertama andal.

## 27 jenis field

Teks, berkas, repeater, warna, tanggal, dan lainnya ditentukan di JSON. Opsi pilihan mengambil data dari post, term, dan pengguna.

## Validasi skema JSON

Setiap konfigurasi memiliki skema yang memberi agent aturan pasti dan langsung mendeteksi kesalahan.

## Pendaftaran otomatis

Letakkan berkas di direktori dan blok akan didaftarkan otomatis, tanpa daftar konfigurasi tambahan.

## Ikhtisar kanvas

Setiap halaman yang dikelola, atau setiap blok beserta nilai default-nya, dalam satu tampilan yang dapat diperbesar.

## Kanvas langsung

Mode langsung memperbarui artboard yang terdampak melalui Server-Sent Events sekitar satu detik setelah penyimpanan. Klik label untuk memfokuskan satu artboard.

## Tailwind bawaan

TailwindPHP mengompilasi kelas yang digunakan tiap halaman, tanpa konfigurasi Node.

## Element Grabber

Salin jalur templat dan markup suatu elemen sebagai konteks langsung untuk agent.

## HTML menjadi blok

Halaman dan pola adalah berkas biasa yang menjadi blok WordPress bawaan.

## Uji render singkat

wp bs blocks render merender setiap blok seperti pada halaman dan keluar dengan kode 1 saat templat memunculkan notice, warning, atau error.

## Pemeriksaan konten tersimpan

wp bs blocks validate memeriksa field tersimpan pada pos, dan pages sync memperingatkan tentang atribut yang disimpan blok tetapi tidak pernah dirender.

## Periksa dari terminal

Cantumkan pengaturan, field khusus, dan aset dengan wp bs, lalu kompilasi cuplikan atau file dengan wp bs tailwind compile atau wp bs scss compile.

Plus

## Kit ekstensi resmi

Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.

- 500+ templat situs
- Instruksi sistem AI
- Pembaruan seumur hidup
- Komunitas privat Discord

[Dapatkan Plus](https://blockstudio.dev/id/plus/)
