# Yapay zekâ odaklı blok geliştirme

Dosyalar ve derleme adımı gerektirmemesi, ajanların iyi olduğu şeyler.

[Dokümantasyonu okuyun](https://blockstudio.dev/tr/docs/dev/ai/)

Sessiz bir ekran kaydı: bir kodlama ajanı, tek bir istemden 10 özel blok ve 6 sayfa içeren eksiksiz bir WordPress sitesi oluşturuyor.

## Bir bloğu tarif edin, bir blok alın

Yapay zekâ kodlama ajanları tek bir istemden bloklar, sayfalar ve kalıplar oluşturabilir. Grafik arayüzü veya veritabanı yok, yalnızca dosyalar var.

~/starter-theme

❯ Üç kademeli, aylık/yıllık geçiş düğmeli ve her kademe için bir CTA içeren bir fiyatlandırma bloğu oluşturun.

✓ Oluşturuldu pricing/block.json

✓ Oluşturuldu pricing/index.php

✓ Oluşturuldu pricing/style.css

❯ Şimdi giriş bölümü ve SSS bölümü olan bir fiyatlandırma sayfası oluşturun.

✓ Oluşturuldu pages/pricing/page.json

✓ Oluşturuldu pages/pricing/index.php

Dosyalar

blockstudio/

├── pricing/ Yeni

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Yeni

├── page.json

└── index.php

## Her şey dosya tabanlı

Bloklar, sayfalar, desenler ve uzantılar, JSON yapılandırması ve şablonları içeren dizinlerdir. Ajanlar bunları doğrudan okuyup yazabilir.

## Veritabanı yapılandırması gerekmez

Tıklayarak gezmeniz gereken yönetim panelleri yok. Her ayar bir JSON anahtarıdır; böylece bir ajan tarayıcı açmadan kitaplığı oluşturabilir.

## Öngörülebilir yapı

Her blok aynı düzeni izler: block.json, bir şablon ve isteğe bağlı stiller. Düzeni bir kez öğrenin.

## Tahmin değil, bağlam

Belgelerin kısa bir dizini ve tamamını isteyen araçlar için tam metin.

### Ajanın önce okuduğu bir dizin

`blockstudio-llm.txt` her belgeyi bir kez listeler; belgeye ait yolu, kaynak dosyayı, amacı, ayarları, kancaları, PHP işlevlerini ve CLI komutlarını belirtir. Yaklaşık 11k token boyutundaki bu dizinin tamamını okuyan ajan, ardından yalnızca ihtiyaç duyduğu sayfayı açar.

`blockstudio-llm-full.txt`, araçların tüm içerik derlemini alabilmesi için her belgeyi ve JSON şemasını yaklaşık 169k token boyutunda tek bir dosyada sunar. `ai.enableContextGeneration` özelliğini etkinleştirin; siteniz her ikisini de sunar.

[Yapay zekâ entegrasyonu belgeleri](https://blockstudio.dev/tr/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.
```

## Projeniz için bir sözleşme

Belgeler Blockstudio konusunu açıklar. AGENTS.md ise ajanın değiştirmek üzere olduğu projeyi açıklar.

### Tek komut AGENTS.md yazar

`vendor/bin/blockstudio-agents`, içinde çalıştığı projeyi açıklar: neler içerdiğini, `blockstudio.json` özelliklerinin hangilerini etkinleştirdiğini, hangi analizlerin reddedeceğini ve geçerli komutları.

Her satır dosyalarınızdan, ayarlarınızdan veya seçili analiz ön ayarından gelir. Yeniden oluşturma, elle yazdığınız notları korur; sözleşme güncel değilse `--check` başarısız olur.

[Proje sözleşmesi](https://blockstudio.dev/tr/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.
```

## Hatalar commit öncesinde yakalanır

Her biri bir öncekini kapsayan dört analiz ön ayarı ve her commit’te bunları çalıştıran bir kanca.

### block.json bilen analiz

`blockstudio/phpstan` ön ayarları bloklarınızı, sayfalarınızı ve ayarlarınızı okur. `block.json` tarafından hiç tanımlanmamış bir alanı okuyan veya onu kaçışlamadan çıktıya veren bir şablon analizden geçemez.

Şablonlar, yanlarındaki `block.json` dosyasından yazılan tür tanımlı bir `$a` okur; her alan türü için somut bir PHP türü bulunur ve `Db::get()`, `db.php` tarafından biçimlendirilen kayıtları döndürür. Yanlış yazılmış bir ayar yolu veya kanca adı, en yakın geçerli ad önerilerek hata verir.

`githooks.commit` değerini ayarlayıp `vendor/bin/blockstudio-githooks sync` komutunu çalıştırın: yönetilen commit öncesi kancası aynı analizi yürütür, böylece bozuk bir blok commit’e ulaşmaz.

[Analiz ön ayarları](https://blockstudio.dev/tr/docs/dev/phpstan/#analysis-presets)

blockstudio.json

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

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

Bir şablonun okuduğu her $a anahtarı block.json içinde bulunur; kancalar, ayar yolları ve blok etiketleri gerçektir.

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

Tema başlıkları, tanımlı varlıklar, %selector% kapsamı, alan varsayılanları ve tekrarlayıcı sınırları.

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

PHPStan maksimumu, kaçışlanmış çıktı, harici komut çalıştırmama, geçerli Tailwind sınıfları ve temiz JavaScript.

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

Extreme teması ve sizin sağladığınız canlı bir WordPress render yoklaması. Kabuk olmadan çalışır; başarısız bir render bulgu olarak kaydedilir.

## [Twig, Blade ve betikler](https://blockstudio.dev/tr/docs/dev/phpstan/#what-it-checks)

Twig, Blade ve blok etiketleri aynı alanlara göre denetlenir. Extreme katmanı ayrıca JavaScript ve Interactivity yönergelerini işaretlemenizle ve depolanan verilerle karşılaştırarak okur.

## [Mevcut projeler](https://blockstudio.dev/tr/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

Bir PHPStan temel çizgisi, kaydedilmiş bulguları engellerken yeni kodun tüm ön ayar koşullarını karşılamasını sağlar. blockstudioScanRoots, kök dizinin dışındaki blok kütüphanelerini okur; paketteki taslaklar da herkese açık API için tür tanımlarını sağlar.

## PHP üzerinden envanter ve oluşturma

Birkaç çağrıyla bir aracı, projenin neler kaydettiğini görüp herhangi bir bölümünü oluşturabilir ve neleri depoladığını kontrol edebilir.

### Projeye sorun, yanıtı oluşturun

`Canvas::inventory()`, bir projenin kaydettiği her sayfayı, bloğu, deseni, Site Editor şablonunu, şablon parçasını ve UI örneğini hiçbir şeyi oluşturmadan listeler.

`Render::document()` bunlardan herhangi birini, kullandığı öğelerle birlikte eksiksiz bir HTML belgesi olarak oluşturur; böylece ajan çalışmasını düzenleyicinin dışında denetleyebilir.

`Canvas::documents()`, tam olarak seçtiğiniz kayıtları render eder. `Render::composition()` ve `Render::content()`, iç içe bildirimleri veya serileştirilmiş blok içeriğini HTML olarak döndürür; `Ui::inventory()` ve `Ui::examples()` ise birlikte gelen bileşen ailelerini, her biri render edilebilir tek bir bildirimle listeler.

Tek bir blok için `bs_block_fields()`, `bs_block_extension_fields()`, `bs_block_values()` ve `bs_block_assets()` render etmeden alanlarını, değerlerini ve varlıklarını döndürür; `bs_validate_block()` ise kaydetmeden önce depolanmış öznitelikleri denetler.

[Programatik oluşturma](https://blockstudio.dev/tr/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']);
```

## Sayfa başına yarıdan az token

Ajanlar düz HTML yazar. Blockstudio, eşitleme sırasında bunu serileştirilmiş WordPress blok işaretlemesine dönüştürür: oluşturulacak ve yanlış yapılabilecek daha az şey.

### Blockstudio

Ajanların yazdığı

Yaklaşık 135 belirteç

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

Ayrıştırıcının bunun için yazdığı

Yaklaşık 310 belirteç

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

Yukarıdaki iki panelde ölçüldü: HTML içindeki 540 karakter, stok ayrıştırıcının bunun için yazdığı blok biçimlendirmesindeki 1,233 karakterle karşılaştırıldı ve belirteç başına olağan karakter tahmini olan dörde bölündü. Biçimlendirme, okunması kolay olsun diye satır sonları eklenerek gösterilmiştir.

## Daha az çıktı üretimi

Ajanlar blok ayraçları, oluşturulan sınıflar veya sarmalayıcı işaretlemesi olmadan HTML yazar.

## Hata yapma olasılığı azalır

Ayrıştırıcı, daha basit girdiden geçerli blok çıktısı oluşturulmasını garanti eder.

## Daha hızlı ve daha uygun maliyetli

Daha az çıktı token’ı, daha hızlı yanıtlar ve daha düşük model maliyetleri demektir.

## Her yapay zekâ kodlama aracıyla çalışır

Dosyaları okuyup yazabilen her ajan, kutudan çıktığı gibi Blockstudio ile çalışır.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## Yapay zekâ iş akışı için tasarlandı

Bloklar, sayfalar, desenler, ayarlar. Her şey bir ajanın okuyabileceği, yazabileceği ve değiştirebileceği bir dosyadır.

## Blok başına iki dosya

Bir JSON yapılandırması ve bir şablon, bloğun tamamını oluşturur. Küçük kapsam, ilk denemede güvenilir üretim sağlar.

## 27 alan türü

Metinler, dosyalar, tekrarlayıcılar, renkler, tarihler ve daha fazlası JSON içinde tanımlanır. Seçenekler gönderilerden, terimlerden ve kullanıcılardan doldurulur.

## JSON şema doğrulaması

Her yapılandırmanın bir şeması vardır; bu şema ajanlara kesin kurallar sunar ve hataları hemen yakalar.

## Otomatik kayıt

Dosyaları bir dizine bırakın; bloklar ek bir yapılandırma listesine gerek kalmadan otomatik olarak kaydedilir.

## Tuval genel görünümü

Yönetilen her sayfa veya varsayılan değerleriyle birlikte her blok, yakınlaştırılabilir tek bir görünümde.

## Canlı tuval

Canlı mod, kaydetme işleminden yaklaşık bir saniye sonra etkilenen çalışma yüzeylerini Server-Sent Events üzerinden yeniler. Bir çalışma yüzeyine odaklanmak için etiketine tıklayın.

## Yerleşik Tailwind

TailwindPHP her sayfanın kullandığı sınıfları, Node yapılandırması gerektirmeden derler.

## Element Grabber

Bir öğenin şablon yolunu ve işaretlemesini kopyalayarak ajana anında bağlam sağlayın.

## HTML bloklara

Sayfalar ve desenler, yerel WordPress bloklarına dönüşen düz dosyalardır.

## Render duman testi

wp bs blocks render, her bloğu bir sayfanın render ettiği şekilde render eder ve bir şablon bildirim, uyarı veya hata oluşturduğunda 1 koduyla çıkar.

## Depolanan içerik denetimleri

wp bs blocks validate, yazıların kaydedilmiş alanlarını denetler; pages sync ise bir bloğun depoladığı ancak hiç render etmediği öznitelikler hakkında uyarır.

## Terminalden inceleyin

Ayarları, özel alanları ve varlıkları wp bs ile listeleyin; bir kod parçasını veya dosyayı wp bs tailwind compile ya da wp bs scss compile ile derleyin.

Plus

## Resmî uzantı kiti

Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.

- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu

[Plus edinin](https://blockstudio.dev/tr/plus/)
