Playbooks Sistemi

Playbooks sistemi, AI geliştirmede bağlam sorununa yönelik Hatcher'ın ikinci nesil çözümüdür. Claude.md gibi statik dosyalar bir başlangıç noktası sağlarken, Playbooks AI ajanlarınız için gerçek bir Kurumsal Anayasa görevi gören dinamik, merkezi ve yönetilebilir bir sistem sunar.

Playbooks Nedir?

Playbooks, takımınızın aşağıdaki özelliklerini yakalayan yapılandırılmış konfigürasyon dosyalarıdır:

• Kodlama Standartları: Biçimlendirme, adlandırma kuralları ve stil tercihleri
• Mimari Kararlar: Bileşen kalıpları, durum yönetimi yaklaşımları
• Çerçeve Özellikleri: Kütüphane özel en iyi uygulamalar ve kalıplar
• İş Kuralları: Alan özel mantık ve kısıtlamalar

Playbook Yapısı

Temel bir Playbook şu yapıyı takip eder:

{
  "name": "Vue 3 Bileşen Standartları",
  "version": "1.0.0",
  "framework": "vue",
  "rules": [
    {
      "category": "components",
      "type": "naming",
      "pattern": "PascalCase",
      "description": "Tüm Vue bileşenleri PascalCase adlandırma kullanmalıdır"
    },
    {
      "category": "composition",
      "type": "api",
      "preference": "composition-api",
      "description": "Options API yerine Composition API tercih edin"
    }
  ],
  "examples": [
    {
      "title": "Standart Bileşen Yapısı",
      "code": "..."
    }
  ]
}

Yerleşik Playbooks

Hatcher, popüler çerçeveler için özenle seçilmiş Playbooks ile birlikte gelir:

Vue.js Playbooks

• Vue 3 + TypeScript: Modern kompozisyon kalıpları
• Nuxt.js: SSR ve dosya tabanlı yönlendirme kuralları
• Pinia: Durum yönetimi en iyi uygulamaları

React Playbooks

• React + TypeScript: Fonksiyonel bileşenler ve hook'lar
• Next.js: App Router ve sunucu bileşenleri
• Zustand: Hafif durum yönetimi

Evrensel Playbooks

• TypeScript Standartları: Tip tanımları ve jenerikler
• CSS-in-JS: Styled-components ve emotion kalıpları
• Test: Jest ve Cypress kuralları

Özel Playbooks Oluşturma

Takım Özel Kuralları

Takımınızın benzersiz kurallarını yakalayan Playbooks oluşturun:

{
  "name": "Acme Corp Standartları",
  "extends": ["vue3-typescript"],
  "rules": [
    {
      "category": "api",
      "type": "structure",
      "pattern": "services/api/*.service.ts",
      "description": "Tüm API çağrıları servis katmanından geçmelidir"
    },
    {
      "category": "components",
      "type": "props",
      "requirement": "interfaces",
      "description": "Bileşen props'ları TypeScript arayüzleri kullanmalıdır"
    }
  ]
}

Proje Özel Bağlam

Proje özel bilgi ekleyin:

{
  "name": "E-ticaret Paneli",
  "extends": ["acme-corp-standards"],
  "context": {
    "domain": "e-commerce",
    "entities": ["Product", "Order", "Customer"],
    "apis": [
      {
        "name": "OrdersAPI",
        "baseUrl": "/api/orders",
        "methods": ["GET", "POST", "PUT", "DELETE"]
      }
    ]
  }
}

Playbook Kalıtımı

Playbooks, ölçeklenebilir konfigürasyon için kalıtımı destekler:

Evrensel TypeScript
    ↓
Vue 3 + TypeScript
    ↓
Acme Corp Standartları
    ↓
Proje Özel Kuralları

AI Entegrasyonu

Hatcher, ilgili Playbook bağlamını AI komutlarına otomatik olarak enjekte eder:

Bağlam Seçimi

• Otomatik: Dosya türleri ve proje yapısına dayalı
• Manuel: Hangi Playbooks'un kullanılacağını açıkça belirtin
• Akıllı: Zaman içinde tercihlerinizi öğrenin

Komut Geliştirme

AI motorları şu gibi yapılandırılmış bağlam alır:

BAĞLAM: Vue 3 Bileşen Oluşturma
PLAYBOOK: vue3-typescript, acme-corp-standards
KURALLAR:
- <script setup> ile Composition API kullanın
- Props TypeScript arayüzleri kullanmalıdır
- Bileşenler PascalCase olmalıdır
- API çağrıları servis katmanından geçer

Pazar Yeri ve Paylaşım

Topluluk Playbooks

Topluluk tarafından oluşturulan Playbooks'u göz atın ve kurun:

• Çerçeve özel: Popüler kütüphaneler için optimize edilmiş kalıplar
• Endüstri özel: Farklı sektörler için alan bilgisi
• Takım test edilmiş: Başarılı projelerden gerçek dünya kuralları

Playbooks'unuzu Yayınlama

Takımınızın uzmanlığını paylaşın:

hatcher playbook publish acme-corp-standards

Sürüm Yönetimi

• Anlamsal Sürümleme: Değişiklikleri ve uyumluluğu takip edin
• Güncelleme Bildirimleri: Topluluk iyileştirmelerine ayak uydurun
• Geri Alma Desteği: Sorunlu güncellemeleri güvenle geri alın

Konfigürasyon

Global Playbooks

Tüm projeler için varsayılan Playbooks ayarlayın:

{
  "globalPlaybooks": ["typescript-standards", "git-conventions"]
}

Proje Geçersiz Kılma

hatcher.config.json'da proje özel Playbooks belirtin:

{
  "playbooks": ["vue3-typescript", "team-standards", "./custom-playbook.json"]
}

Koşullu Yükleme

Bağlama dayalı farklı Playbooks yükleyin:

{
  "conditional": {
    "**/*.test.ts": ["testing-standards"],
    "src/components/**": ["component-standards"],
    "src/api/**": ["api-standards"]
  }
}

En İyi Uygulamalar

Basit Başlayın

Çerçeve temelleri ile başlayın ve kademeli olarak takım özel kuralları ekleyin:

1. Çerçeve Playbook Kurun: Anında %80 kapsama alın
2. Takım Kuralları Ekleyin: Benzersiz kuralları yakalayın
3. Zamanla İyileştirin: Gerçek kullanıma dayalı güncelleyin

Güncel Tutun

• Düzenli İncelemeler: Kalıplar geliştikçe Playbooks'u güncelleyin
• Takım Geri Bildirimi: Tüm takımı Playbook bakımına dahil edin
• Sürüm Kontrolü: Playbook değişikliklerini kod ile birlikte takip edin

Etkiyi Ölçün

• Tutarlılık Metrikleri: Tanımlı kalıplara uyumu takip edin
• Hız İyileştirmeleri: Geliştirme hızı kazanımlarını ölçün
• Kalite Göstergeleri: Azalan kod inceleme geri bildirimini izleyin

Gelecek Özellikler

AI Üretilen Playbooks

Mevcut kod tabanlarını analiz ederek otomatik olarak Playbooks üretin.

Gerçek Zamanlı Doğrulama

Kod yazarken canlı geri bildirim, Playbook uyumluluğunu sağlayın.

Takım İşbirliği

Playbook güncellemeleri için işbirlikçi düzenleme ve onay iş akışları.

Playbooks sistemi, AI'yı genel kod üreticisinden tam gereksinimlerinizi ve kurallarınızı anlayan takımınızın özel bir üyesine dönüştürür.