Система Playbooks

Примечание: Эта страница описывает техническую реализацию нашей философии Constitutional Engineering. Если вы еще не читали о философском основании, рекомендуем начать с него, чтобы понять "почему" за playbooks.

Система Playbooks - это решение второго поколения от Hatcher для проблемы контекста в разработке с ИИ. В то время как статичные файлы вроде Claude.md дают отправную точку, Playbooks предлагают динамичную, централизованную и управляемую систему, которая действует как настоящая Корпоративная Конституция для ваших ИИ-агентов.

Что такое Playbooks?

Playbooks - это структурированные конфигурационные файлы, которые фиксируют:

• Стандарты кодирования: Форматирование, соглашения об именовании и предпочтения в стиле
• Архитектурные решения: Паттерны компонентов, подходы к управлению состоянием
• Особенности фреймворков: Лучшие практики и паттерны для конкретных библиотек
• Бизнес-правила: Доменная логика и ограничения

Структура Playbook

Базовый Playbook следует этой структуре:

{
  "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

Hatcher поставляется с курируемыми Playbooks для популярных фреймворков:

Playbooks для Vue.js

• Vue 3 + TypeScript: Современные композиционные паттерны
• Nuxt.js: Соглашения SSR и файловой маршрутизации
• Pinia: Лучшие практики управления состоянием

Playbooks для React

• React + TypeScript: Функциональные компоненты и хуки
• Next.js: App Router и серверные компоненты
• Zustand: Легковесное управление состоянием

Универсальные Playbooks

• Стандарты TypeScript: Определения типов и дженерики
• CSS-in-JS: Паттерны styled-components и emotion
• Тестирование: Соглашения Jest и Cypress

Создание пользовательских Playbooks

Правила для конкретной команды

Создавайте Playbooks, которые фиксируют уникальные соглашения вашей команды:

{
  "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"
    }
  ]
}

Контекст для конкретного проекта

Добавляйте знания о конкретном проекте:

{
  "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"]
      }
    ]
  }
}

Наследование Playbook

Playbooks поддерживают наследование для масштабируемой конфигурации:

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

Интеграция с ИИ

Hatcher автоматически внедряет релевантный контекст Playbook в промпты для ИИ:

Выбор контекста

• Автоматический: На основе типов файлов и структуры проекта
• Ручной: Явное указание, какие Playbooks использовать
• Умный: Обучение на основе ваших предпочтений со временем

Улучшение промптов

ИИ-движки получают структурированный контекст вроде:

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

Маркетплейс и обмен

Playbooks сообщества

Просматривайте и устанавливайте Playbooks, созданные сообществом:

• Для конкретных фреймворков: Оптимизированные паттерны для популярных библиотек
• Для конкретных индустрий: Доменные знания для разных секторов
• Проверенные командами: Реальные соглашения из успешных проектов

Публикация ваших Playbooks

Делитесь экспертизой вашей команды:

hatcher playbook publish acme-corp-standards

Управление версиями

• Семантическое версионирование: Отслеживание изменений и совместимости
• Уведомления об обновлениях: Следите за улучшениями сообщества
• Поддержка отката: Безопасный откат проблемных обновлений

Конфигурация

Глобальные Playbooks

Установите Playbooks по умолчанию для всех проектов:

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

Переопределение проекта

Укажите Playbooks для конкретного проекта в hatcher.config.json:

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

Условная загрузка

Загружайте разные Playbooks в зависимости от контекста:

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

Лучшие практики

Начинайте просто

Начните с основ фреймворка и постепенно добавляйте правила команды:

1. Установите Playbook фреймворка: Получите 80% покрытия мгновенно
2. Добавьте правила команды: Зафиксируйте уникальные соглашения
3. Уточняйте со временем: Обновляйте на основе реального использования

Поддерживайте актуальность

• Регулярные обзоры: Обновляйте Playbooks по мере эволюции паттернов
• Обратная связь команды: Вовлекайте всю команду в поддержку Playbook
• Контроль версий: Отслеживайте изменения Playbook вместе с кодом

Измеряйте влияние

• Метрики согласованности: Отслеживайте соблюдение определенных паттернов
• Улучшения скорости: Измеряйте прирост скорости разработки
• Индикаторы качества: Мониторьте уменьшение замечаний при код-ревью

Будущие функции

Playbooks, сгенерированные ИИ

Автоматическое создание Playbooks путем анализа существующих кодовых баз.

Валидация в реальном времени

Мгновенная обратная связь во время кодирования, обеспечивающая соответствие Playbook.

Командная совместная работа

Совместное редактирование и процессы утверждения обновлений Playbook.

Система Playbooks трансформирует ИИ из общего генератора кода в специализированного члена вашей команды, который понимает ваши точные требования и соглашения.

Создайте свой первый Playbook

Превратите ИИ в специализированного члена команды, следующего вашим точным стандартам

Начать создание Playbooks→

Ваши паттерны. Ваши стандарты. Применяемые последовательно.