İçeriğe geç

Blockstudio ile Vibe Kodlama

Andrej Karpathy, Şubat ayında 2025 “vibe coding” terimini, istediğinizi yapay zekâya anlattığınız ve onun kodu yazdığı bir iş akışını tanımlamak için ortaya attı. Bir yıl sonra bu uygulama olgunlaşarak onun artık “agentic engineering” dediği şeye dönüştü: geliştiriciler kodu satır satır yazmak yerine yapay zekâ ajanlarını yönetiyor.

Blockstudio bunun için geliştirildi. Dosya tabanlı mimarisi, derleme araçlarının olmaması ve öngörülebilir proje yapısı, onu yapay zekâ destekli WordPress geliştirme için en iyi ortamlardan biri yapıyor.

Bu kılavuz, proje kurulumundan tam site oluşturmaya kadar, Blockstudio ile yapay zekâ kodlama ajanlarını kullanmaya yönelik pratik yöntemleri ele alıyor.

Blockstudio neden yapay zekâ ajanlarıyla iyi çalışıyor

Veritabanları değil, dosyalar

Yapay zekâ kodlama ajanları dosyaları okur ve yazar. Temel arayüzleri budur. Blockstudio her şeyi dosya sisteminde tutar: her blok için bir block.json ve şablon dosyası, her sayfa için bir page.json, her desen için bir pattern.json. Yönetilecek veritabanı girdileri, tıklanacak yönetici UI veya çalıştırılacak derleme adımı yoktur.

Bu önemlidir, çünkü dosya sistemleri ve kabuk komutları LLM’ler için en büyük ön eğitim verisi kaynaklarından biridir. Her model dosyaları okuma, yazma ve düzenlemeyle ilgili milyonlarca örnek görmüştür. WordPress geliştirme iş akışınız bu arayüzle eşleştiğinde, ajanlar çok az talimatla çalışabilir.

Öngörülebilir yapı

Her Blockstudio bloğu aynı yapıyı izler:

Kod
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

Bu tutarlılık sayesinde bir blok oluşturmuş bir ajan yüz blok oluşturabilir. Sürpriz, özel durum veya gizli yapılandırma yoktur. Aynı yapı sayfalar (page.json + şablon), desenler (pattern.json + şablon) ve uzantılar (extend.json) için de geçerlidir.

Dosya olarak tam sayfalar

Geleneksel WordPress sayfa oluşturma; blokları sürüklemeyi, ayarları yapılandırmayı ve yönetici arayüzünden kaydetmeyi gerektirir. Yapay zekâ ajanları bunların hiçbirini yapamaz. Dosyalara ihtiyaç duyarlar.

Blockstudio’ın dosya tabanlı sayfaları bu sorunu tamamen çözer. Bir page.json sayfa meta verilerini tanımlar, bir index.php şablonu ise blok yapısını HTML kullanarak belirler:

Kod
pages/about/
├── page.json     # Title, slug, post type, template lock
└── index.php     # Block structure as HTML
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>

Bir ajan, temel bloklar, özel bloklar, şablon kilitleme ve düzenleme kontrolleri dahil olmak üzere tüm bir WordPress sayfasını yalnızca iki dosya yazarak oluşturabilir. Kaynağı WordPress’ye uygulamak için wp bs pages sync komutunu çalıştırın; yönetici arayüzünü açmak bu eşitlemeyi kendiliğinden yapmaz.

Bu, yapay zekâ destekli geliştirmenin en güçlü özelliklerinden biridir. Sayfa düzenini tarif edip düzenleyicide elle oluşturmak yerine, bunu bir ajana anlatırsınız ve ajan şablonu yazar. Sonuç sürüm denetiminde tutulabilir, yeniden üretilebilir ve saniyeler içinde yinelenerek geliştirilebilir.

Derleme adımı yok

Derlenecek, paketlenecek veya dönüştürülecek bir şey yoktur. Ajan bir dosya oluşturur ve dosya hemen çalışır. SCSS sunucu tarafında derlenir. ES modülleri çalışma zamanında çözümlenir. Tailwind CSS her ön yüz isteğinde derlenir. “Ajan kodu yazar” ile “kod tarayıcıda çalışır” arasındaki geri bildirim döngüsü olabilecek en kısadır.

Tailwind CSS neden doğru seçim

Blockstudio hem normal CSS hem de Tailwind CSS kullanımını destekler, ancak Tailwind yapay zekâ ajanlarıyla çalışırken önemli bir avantaja sahiptir.

LLM’ler Tailwind’ı çok iyi tanır

Tailwind CSS on binlerce açık kaynak depoda kullanılıyor. Claude.ai, Vercel, Shopify, Cursor ve OpenAI’ın kendi ürünlerinin arayüzlerine güç veriyor. Eğitim verilerinde bu kadar yaygın olması, LLM’lerin Tailwind sınıflarını yüksek doğrulukla üretmesini ve var olmayan yardımcı sınıfları nadiren uydurmasını sağlar.

Sınıf söz varlığı sınırlı ve iyi tanımlanmıştır. Bir ajan var olmayan bir CSS özelliği uyduramaz; bu da ajanın geçersiz seçiciler üretebildiği veya basamaklandırma davranışını yanlış anlayabildiği serbest biçimli CSS kullanımına kıyasla stil hatalarını büyük ölçüde azaltır.

Stiller biçimlendirmenin içinde

Tailwind ile tüm stil bilgileri HTML şablonunda bir arada bulunur. Ajan, bir öğenin tüm görsel tanımını tek yerde görür. Ayrı .css dosyalarına başvurması, basamaklandırma sırasını anlaması veya özgüllük çakışmalarını izlemesi gerekmez.

Bu, şablonun zaten tek dosya olduğu Blockstudio blokları için özellikle kullanışlıdır. Ajan, stilleri uygulanmış eksiksiz bir bileşeni tek seferde oluşturabilir:

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

Çakışma olmadan paralel ajanlar

Tailwind stilleri her şablonla sınırlı olduğundan, birden fazla ajan (veya geliştirici) farklı bloklar üzerinde aynı anda CSS birleştirme çakışmaları olmadan çalışabilir. Bir bileşendeki değişikliklerin yanlışlıkla diğerini bozabileceği ortak bir stil sayfası yoktur. Her blok kendi içinde bağımsızdır.

Bu yöntem, Blockstudio’in kapsamlı stillerini (style.scoped.css) kullanan normal CSS projelerinde de işe yarar; ancak Tailwind, CSS dosyasını tamamen ortadan kaldırır ve böylece ajanın her blok için yönetmesi gereken dosya sayısı bir azalır.

Normal CSS de kullanılabilir

Tailwind kullanmak zorunlu değildir. Blockstudio’in varlık işlem hattı, blok için ad alanı tanımlanmış kapsamlı stiller dahil .css ve .scss dosyalarını otomatik olarak işler. Projeniz farklı bir CSS yöntemi kullanıyorsa ajanlar onunla da çalışabilir. Tailwind’ın avantajı, eğitim verilerindeki yaygınlığı ve stillerin biçimlendirmeyle bir arada bulunması sayesinde LLM’lerin bu yöntemde daha başarılı olmasıdır.

Yapay zekâ kodlama ajanları

Aşağıdaki CLI araçlarının tümü, Blockstudio projeleriyle kutudan çıktığı gibi çalışabilir. Dosyaları okur ve yazar, kabuk komutlarını çalıştırır ve bağlam dosyalarından proje yapısını anlarlar.

Terminal ajanları (CLI)

Araç Sağlayıcı Notlar
Claude Code Anthropic Terminal öncelikli ajan. Proje bağlamı için CLAUDE.md dosyasını okur.
Codex CLI OpenAI Rust ile oluşturulmuş açık kaynak CLI. Masaüstü uygulaması da vardır.
Gemini CLI Google 1M token bağlam penceresine sahip açık kaynak. GEMINI.md dosyasını okur.
GitHub Copilot CLI GitHub Keşif, görev, planlama ve inceleme için uzmanlaşmış paralel ajanlar.
Aider Açık kaynak Yerel modeller dahil 100+ LLM sağlayıcısını destekler.
OpenCode Açık kaynak LSP tümleştirmeli terminal TUI. 75+ sağlayıcıyı destekler.
Amazon Q Developer CLI AWS Ücretsiz planı vardır. AWS tümleşik projelerde güçlüdür.

IDE ajanları

Araç Sağlayıcı Notlar
Cursor Cursor Yerleşik yapay zekâya sahip VS Code çatallaması. Ayrıca CLI (beta) özelliği de var.
Windsurf Cognition AI Cascade ajan asistanı bulunan VS Code çatallaması.
Cline Açık kaynak Adım adım onay sunan VS Code uzantısı. Ayrıca CLI özelliği de var.
Kilo Code Açık kaynak Koordineli alt ajanlarla düzenleyici modu.
Continue Açık kaynak Eşzamansız CI/CD ajanlarına sahip VS Code/JetBrains uzantısı.
Augment Code Augment Derin kod tabanı indekslemesiyle kurumsal kullanıma odaklanır.

Bu araçların tümü, dosyaları Blockstudio proje dizininde oluşturup düzenleyebilir. Terminal ajanları özellikle uygundur, çünkü Blockstudio geliştirme IDE’ye özgü özellik gerektirmez; tamamen dosya tabanlıdır.

Projenizi yapay zekâ ajanlarına hazırlama

LLM bağlam dosyası

Blockstudio, çerçeve belgelerinin tamamını indeksleyen, önceden oluşturulmuş bir bağlam dosyasıyla gelir. Bu bir özet veya başvuru kılavuzu değildir: her belge, rotası, amacı ve sahip olduğu tanımlayıcılarla bir kez listelenir; böylece ajan bir soruyu yanıtlayan tek sayfayı bulup yalnızca onu açabilir. Tüm belgelerin ve şemaların tam metni, bütün külliyatı tek seferde isteyen araçlar için ikinci bir dosyada bulunur.

Bunu blockstudio.json içinde etkinleştirin:

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

Dizin artık your-site.com/blockstudio-llm.txt adresinde, tam metin ise your-site.com/blockstudio-llm-full.txt adresinde kullanılabilir. Yapay zekâ aracınızı dizine yönlendirin; ek talimat gerekmeksizin tüm Blockstudio API içeriğine erişebilir. Araca özgü kurulum için yapay zekâ tümleştirme belgelerine bakın.

Bu, çerçeveye özgü talimatları kendiniz yazma gereğini ortadan kaldırır. blockstudio-llm.txt erişimi olan bir ajan blok oluşturmayı, alan tanımlamayı, şablon yazmayı, Tailwind yapılandırmayı, sayfa kurulumunu ve Blockstudio’ın sunduğu her kancayı nasıl kullanacağını bulabilir.

Projeye özgü bağlam dosyaları

Çoğu yapay zekâ kodlama ajanı, kod tabanınıza özgü talimatlar içeren proje düzeyinde bir bağlam dosyasını da okur. Kullanılan kural araca göre değişir:

Dosya Araç
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI ve diğerleri
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

blockstudio-llm.txt çerçeveyi zaten kapsadığı için proje bağlam dosyanızda yalnızca projenize özgü olanları açıklamanız yeterlidir: dizin düzeni, adlandırma kuralları, komutlar ve sınırlar.

blockstudio/phpstan yüklerseniz bu açıklamayı elle yazmanız gerekmez. vendor/bin/blockstudio-agents, blockstudio.json dosyanızdan ve kendi dosyalarınızdan bir AGENTS.md oluşturur; projenin ne ürettiğini, hangi özelliklerin etkin olduğunu, hangi analizlerin neleri reddedeceğini ve kullanılabilir komutları listeler. Kendisinin oluşturmadığı bir dosyanın üzerine yazmayı reddeder ve dosyayı yeniden oluşturduğunuzda kendi notlarınızı korur.

Markdown
# 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

Yapay zekâ iş akışları için geliştirici araçları

Blockstudio, yapay zekâ destekli geliştirme için özel olarak tasarlanmış iki geliştirici aracı içerir.

Tuval

tuval, tüm Blockstudio sayfalarınıza Figma benzeri bir genel bakış sunar; sayfalar tek bir görünümde canlı iframe çizim alanları olarak gösterilir. İzleme dörtgeniyle kaydırın, sıkıştırma hareketiyle veya Ctrl+scroll ile yakınlaştırın.

Bu özellik, sekmeler arasında geçiş yapmadan veya WordPress yönetici arayüzünde gezinmeden her sayfaya görsel olarak genel bir bakış sunduğu için yapay zekâ ajanlarıyla çalışırken faydalıdır. Bir ajan sayfa şablonunu değiştirdiğinde sonucu hemen görebilirsiniz. Canlı modu etkinleştirin; dosyalar değiştiğinde tuval otomatik olarak yenilenir.

blockstudio.json içinde etkinleştirin:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

Ardından /wp-admin/admin.php?page=blockstudio-canvas adresine gidin. Sayfa görünümü (tam genişlikte çizim alanları) ile blok görünümü (varsayılan değerleriyle tüm kayıtlı blokların ızgarası) arasında geçiş yapın.

Öğe Seçici

öğe seçici, yapay zekâ iş akışlarında sık karşılaşılan bir sorunu çözer: belirli bir sayfa öğesini hangi dosyanın oluşturduğunu ajana anlatmak.

?blockstudio-devtools öğesini herhangi bir ön yüz URL öğesine ekleyin, ardından 100ms boyunca Cmd+C (Mac) veya Ctrl+C (Windows) tuşlarını basılı tutun. Artı biçimindeki seçici etkinleşir ve üzerine geldiğinizde Blockstudio bloklarını vurgular. Bağlamını panoya kopyalamak için bir öğeye tıklayın:

Kod
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Bunu yapay zekâ kodlama aracınıza yapıştırdığınızda ajan dosya yolunu, HTML yapısını ve işaret ettiğiniz öğeyi hemen anlar. Şablon dosyası yollarını elle aramanıza gerek kalmaz.

blockstudio.json içinde etkinleştirin:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

Pratik yöntemler

Tek bir blok oluşturma

En basit iş akışı: istediğinizi anlatın ve bloğu ajana oluşturtun.

İstem:

Alıntı (textarea), yazar adı (text), yazarın rolü (text) ve yazarın fotoğrafı (files) alanlarına sahip bir müşteri yorumu bloğu oluştur. Stilleme için Tailwind kullan. Alıntı, dekoratif bir tırnak işaretiyle birlikte büyük ve italik bir yazı tipinde olmalı.

Ajan şunları oluşturur:

Kod
blockstudio/testimonial/
├── block.json
└── index.php

Tam bir sayfa oluşturma

Blockstudio’ın dosya tabanlı sayfaları, ajanın tüm bir WordPress sayfasını şablon olarak oluşturmasını sağlar. Asıl kazanç burada ortaya çıkar: ajan blokları tek tek oluşturmak yerine, tüm bloklarla birlikte sayfanın eksiksiz yapısını tek seferde oluşturur.

İstem:

Üst bölüm, ekip ızgarası ve iletişim formu yer tutucusu içeren bir “Hakkımızda” sayfası oluştur. Mümkün olduğunda mevcut blokları kullan, gerektiğinde yenilerini yaz. Sayfayı 2 numaralı gönderiye sabitle. Şablonu kilitle, ancak başlıkların ve paragrafların içeriğinin düzenlenmesine izin ver.

Ajan şunları oluşturur:

Kod
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

Ayrıca başvurduğu tüm özel blokları da oluşturur (e.g., blockstudio/team-member/). Şablon kilitleme ve düzenleme kontrolleriyle birlikte WordPress gönderisini oluşturmak için wp bs pages sync komutunu çalıştırın. Sayfanın tamamı sürüm denetiminde tutulabilir ve yeniden üretilebilir.

Tam bir site oluşturma

Blockstudio’ın mimarisi asıl gücünü burada gösterir. Her öğe bir dosya olduğundan tek bir istem tüm siteyi oluşturabilir:

İstem:

Şu sayfalara sahip bir portföy sitesi oluştur: Ana Sayfa, Çalışmalar, Hakkımızda, İletişim. Şunlar için özel bloklar oluştur: üst bölüm, proje ızgarası, proje kartı, ekip üyesi, iletişim bilgileri ve alt bilgi. Tailwind içeren koyu bir tema kullan. Özel bir renk paletiyle blockstudio.json içinde Tailwind yapılandır.

Ajan blok dizinlerini, sayfa şablonlarını, Tailwind yapılandırmasına sahip bir blockstudio.json ve isteğe bağlı olarak yeniden kullanılabilir bölümler için desenler oluşturur. Her şey tek bir değişiklik kümesi olarak git içine kaydedilir.

Paralel ajan iş akışları

Bazı araçlar (Codex masaüstü uygulaması, GitHub Copilot CLI, Kilo Code) birden fazla ajanı paralel çalıştırmayı destekler. Blockstudio’ın blok başına dosya mimarisi bunu güvenli kılar:

  • Ajan 1: üst bölüm bloğunu ve ana sayfayı oluşturur
  • Ajan 2: proje kartı bloğunu ve çalışmalar sayfasını oluşturur
  • Ajan 3: iletişim formu bloğunu ve iletişim sayfasını oluşturur

Her blok kendi dizininde bulunduğu ve Tailwind stilleri şablonlarla bir arada tutulduğu için bu ajanlar birbiriyle çakışmaz. Paylaşılan tek dosya blockstudio.json dosyasıdır ve genellikle başlangıçta yalnızca bir kez kurulması gerekir.

Daha iyi sonuçlar için ipuçları

  1. LLM bağlam dosyasına başvurun. Ajanlar, çerçeve belgelerine erişebildiklerinde çok daha iyi Blockstudio kodu üretir. Onları daima blockstudio-llm.txt dosyasına yönlendirin ve projenin kendisi için oluşturulmuş bir AGENTS.md dosyası verin.

  2. Alan türlerini açıkça belirtin. "Bir görsel alanı ekle" demek yerine "allowedTypes: ['image'] ve returnFormat: 'object' içeren bir files alanı ekle" deyin. Alan tanımlarınız ne kadar kesin olursa gereken yineleme sayısı o kadar azalır.

  3. Tek bir blokla başlayıp ölçeği büyütün. Ajana önce bir bloğu doğru şekilde oluşturtun, kullanılan yöntemleri gözden geçirin ve ardından geri kalanını aynı kurallara uyarak oluşturmasını isteyin. Böylece sonraki çıktıları iyileştiren bir örnek oluşturursunuz.

  4. Çıktıyı gözden geçirin. Vibe coding, kodu sorgulamadan kabul etmek demek değildir. Alan türlerinin amacınıza uygun olduğunu, şablonların doğru görüntülendiğini ve Tailwind sınıflarının doğru görsel sonucu verdiğini kontrol edin. Yapay zekâ tarafından oluşturulan kod, yayımlanmadan önce incelenmelidir.

  5. block.json şemalarını kullanın. Blockstudio, https://blockstudio.dev/schema/block adresinde bir JSON Şeması sunar. block.json dosyanıza "$schema" eklemek, ajanlara doğrulama geri bildirimi verir ve hatalı yapılandırmaları önler.

  6. Blokları küçük ve odaklı tutun. Her görsel bileşen için bir blok kullanın. Böylece ajan her blok üzerinde daha kolay akıl yürütür ve şablonlar tek bir bağlam penceresi geçişine sığacak kadar kısa kalır.