Sistem Playbooks

Catatan: Halaman ini menjelaskan implementasi teknis dari filosofi Constitutional Engineering kami. Jika Anda belum membaca tentang fondasi filosofisnya, kami merekomendasikan untuk memulai dari sana untuk memahami "mengapa" di balik playbooks.

Sistem Playbooks adalah solusi generasi kedua Hatcher untuk masalah konteks dalam pengembangan AI. Di mana file statis seperti Claude.md memberikan titik awal, Playbooks menawarkan sistem yang dinamis, terpusat, dan dapat diatur yang bertindak sebagai Konstitusi Korporat sejati untuk agen AI Anda.

Apa Itu Playbooks?

Playbooks adalah file konfigurasi terstruktur yang menangkap:

• Standar Coding: Format, konvensi penamaan, dan preferensi gaya
• Keputusan Arsitektur: Pola komponen, pendekatan manajemen state
• Spesifik Framework: Praktik dan pola terbaik khusus library
• Aturan Bisnis: Logika dan batasan spesifik domain

Struktur Playbook

Playbook dasar mengikuti struktur ini:

{
  "name": "Vue 3 Component Standards",
  "version": "1.0.0",
  "framework": "vue",
  "rules": [
    {
      "category": "components",
      "type": "naming",
      "pattern": "PascalCase",
      "description": "All Vue components must use PascalCase naming"
    },
    {
      "category": "composition",
      "type": "api",
      "preference": "composition-api",
      "description": "Prefer Composition API over Options API"
    }
  ],
  "examples": [
    {
      "title": "Standard Component Structure",
      "code": "..."
    }
  ]
}

Playbooks Bawaan

Hatcher dilengkapi dengan Playbooks yang dikurasi untuk framework populer:

Playbooks Vue.js

• Vue 3 + TypeScript: Pola komposisi modern
• Nuxt.js: Konvensi SSR dan routing berbasis file
• Pinia: Praktik terbaik manajemen state

Playbooks React

• React + TypeScript: Komponen fungsional dan hooks
• Next.js: App Router dan server components
• Zustand: Manajemen state ringan

Playbooks Universal

• TypeScript Standards: Definisi tipe dan generics
• CSS-in-JS: Pola styled-components dan emotion
• Testing: Konvensi Jest dan Cypress

Membuat Playbooks Kustom

Aturan Spesifik Tim

Buat Playbooks yang menangkap konvensi unik tim Anda:

{
  "name": "Acme Corp Standards",
  "extends": ["vue3-typescript"],
  "rules": [
    {
      "category": "api",
      "type": "structure",
      "pattern": "services/api/*.service.ts",
      "description": "All API calls must go through service layer"
    },
    {
      "category": "components",
      "type": "props",
      "requirement": "interfaces",
      "description": "Component props must use TypeScript interfaces"
    }
  ]
}

Konteks Spesifik Proyek

Tambahkan pengetahuan spesifik proyek:

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

Pewarisan Playbook

Playbooks mendukung pewarisan untuk konfigurasi yang dapat diskalakan:

Universal TypeScript
    ↓
Vue 3 + TypeScript
    ↓
Acme Corp Standards
    ↓
Project-Specific Rules

Integrasi AI

Hatcher secara otomatis menyuntikkan konteks Playbook yang relevan ke dalam prompt AI:

Pemilihan Konteks

• Otomatis: Berdasarkan tipe file dan struktur proyek
• Manual: Tentukan secara eksplisit Playbooks mana yang digunakan
• Cerdas: Belajar dari preferensi Anda seiring waktu

Peningkatan Prompt

Mesin AI menerima konteks terstruktur seperti:

CONTEXT: Vue 3 Component Creation
PLAYBOOK: vue3-typescript, acme-corp-standards
RULES:
- Use Composition API with <script setup>
- Props must use TypeScript interfaces
- Components must be PascalCase
- API calls go through service layer

Marketplace & Berbagi

Playbooks Komunitas

Jelajahi dan instal Playbooks yang dibuat oleh komunitas:

• Spesifik framework: Pola yang dioptimalkan untuk library populer
• Spesifik industri: Pengetahuan domain untuk sektor berbeda
• Teruji tim: Konvensi dunia nyata dari proyek sukses

Menerbitkan Playbooks Anda

Bagikan keahlian tim Anda:

hatcher playbook publish acme-corp-standards

Manajemen Versi

• Semantic Versioning: Lacak perubahan dan kompatibilitas
• Notifikasi Update: Tetap terkini dengan perbaikan komunitas
• Dukungan Rollback: Kembalikan update bermasalah dengan aman

Konfigurasi

Playbooks Global

Tetapkan Playbooks default untuk semua proyek:

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

Override Proyek

Tentukan Playbooks spesifik proyek di hatcher.config.json:

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

Pemuatan Kondisional

Muat Playbooks berbeda berdasarkan konteks:

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

Praktik Terbaik

Mulai Sederhana

Mulai dengan dasar framework dan tambahkan aturan spesifik tim secara bertahap:

1. Instal Framework Playbook: Dapatkan cakupan 80% secara instan
2. Tambahkan Aturan Tim: Tangkap konvensi unik
3. Perbaiki Seiring Waktu: Update berdasarkan penggunaan nyata

Jaga Tetap Terkini

• Tinjauan Berkala: Update Playbooks saat pola berkembang
• Umpan Balik Tim: Libatkan seluruh tim dalam pemeliharaan Playbook
• Version Control: Lacak perubahan Playbook bersama kode

Ukur Dampak

• Metrik Konsistensi: Lacak kepatuhan terhadap pola yang ditentukan
• Peningkatan Kecepatan: Ukur peningkatan kecepatan pengembangan
• Indikator Kualitas: Pantau pengurangan umpan balik code review

Fitur Masa Depan

Playbooks yang Dihasilkan AI

Hasilkan Playbooks secara otomatis dengan menganalisis codebase yang ada.

Validasi Real-time

Umpan balik langsung saat Anda coding, memastikan kepatuhan Playbook.

Kolaborasi Tim

Alur kerja editing dan persetujuan kolaboratif untuk update Playbook.

Sistem Playbooks mengubah AI dari generator kode generik menjadi anggota tim khusus yang memahami persyaratan dan konvensi Anda dengan tepat.

Buat Playbook Pertama Anda

Ubah AI menjadi anggota tim khusus yang mengikuti standar Anda dengan tepat

Mulai Membangun Playbooks→

Pola Anda. Standar Anda. Diterapkan secara konsisten.