Système de Playbooks

Note: Cette page décrit l'implémentation technique de notre philosophie d'Ingénierie Constitutionnelle. Si vous n'avez pas encore lu les fondements philosophiques, nous recommandons de commencer par là pour comprendre le "pourquoi" derrière les playbooks.

Le système de Playbooks est la solution de deuxième génération de Hatcher au problème du contexte dans le développement IA. Là où les fichiers statiques comme Claude.md fournissent un point de départ, les Playbooks offrent un système dynamique, centralisé et gouvernable qui agit comme une véritable Constitution d'Entreprise pour vos agents IA.

Que Sont les Playbooks?

Les Playbooks sont des fichiers de configuration structurés qui capturent:

• Standards de Codage: Formatage, conventions de nommage et préférences de style
• Décisions Architecturales: Patterns de composants, approches de gestion d'état
• Spécificités Framework: Meilleures pratiques et patterns spécifiques aux bibliothèques
• Règles Métier: Logique et contraintes spécifiques au domaine

Structure des Playbooks

Un Playbook de base suit cette structure:

{
  "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 Intégrés

Hatcher est livré avec des Playbooks organisés pour les frameworks populaires:

Playbooks Vue.js

• Vue 3 + TypeScript: Patterns de composition modernes
• Nuxt.js: Conventions SSR et routage basé sur fichiers
• Pinia: Meilleures pratiques de gestion d'état

Playbooks React

• React + TypeScript: Composants fonctionnels et hooks
• Next.js: App Router et composants serveur
• Zustand: Gestion d'état légère

Playbooks Universels

• Standards TypeScript: Définitions de types et génériques
• CSS-in-JS: Patterns styled-components et emotion
• Testing: Conventions Jest et Cypress

Créer des Playbooks Personnalisés

Règles Spécifiques à l'Équipe

Créez des Playbooks qui capturent les conventions uniques de votre équipe:

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

Contexte Spécifique au Projet

Ajoutez des connaissances spécifiques au projet:

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

Héritage de Playbooks

Les Playbooks supportent l'héritage pour une configuration évolutive:

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

Intégration IA

Hatcher injecte automatiquement le contexte pertinent des Playbooks dans les prompts IA:

Sélection de Contexte

• Automatique: Basé sur les types de fichiers et la structure du projet
• Manuel: Spécifiez explicitement quels Playbooks utiliser
• Intelligent: Apprend de vos préférences au fil du temps

Amélioration des Prompts

Les moteurs IA reçoivent un contexte structuré comme:

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 & Partage

Playbooks Communautaires

Parcourez et installez des Playbooks créés par la communauté:

• Spécifiques au framework: Patterns optimisés pour les bibliothèques populaires
• Spécifiques à l'industrie: Connaissances du domaine pour différents secteurs
• Testés en équipe: Conventions du monde réel de projets réussis

Publier Vos Playbooks

Partagez l'expertise de votre équipe:

hatcher playbook publish acme-corp-standards

Gestion des Versions

• Versionnage Sémantique: Suivez les changements et la compatibilité
• Notifications de Mise à Jour: Restez à jour avec les améliorations de la communauté
• Support de Rollback: Revenez en toute sécurité sur les mises à jour problématiques

Configuration

Playbooks Globaux

Définissez les Playbooks par défaut pour tous les projets:

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

Override de Projet

Spécifiez les Playbooks spécifiques au projet dans hatcher.config.json:

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

Chargement Conditionnel

Chargez différents Playbooks selon le contexte:

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

Meilleures Pratiques

Commencez Simple

Commencez avec les bases du framework et ajoutez progressivement des règles spécifiques à l'équipe:

1. Installez le Playbook Framework: Obtenez 80% de couverture instantanément
2. Ajoutez des Règles d'Équipe: Capturez les conventions uniques
3. Affinez au Fil du Temps: Mettez à jour en fonction de l'utilisation réelle

Maintenez-le à Jour

• Révisions Régulières: Mettez à jour les Playbooks au fur et à mesure que les patterns évoluent
• Feedback d'Équipe: Impliquez toute l'équipe dans la maintenance des Playbooks
• Contrôle de Version: Suivez les changements de Playbooks aux côtés du code

Mesurez l'Impact

• Métriques de Cohérence: Suivez l'adhérence aux patterns définis
• Améliorations de Vitesse: Mesurez les gains de vélocité de développement
• Indicateurs de Qualité: Surveillez la réduction des retours de revue de code

Fonctionnalités Futures

Playbooks Générés par IA

Générez automatiquement des Playbooks en analysant les bases de code existantes.

Validation en Temps Réel

Retour en direct pendant que vous codez, garantissant la conformité aux Playbooks.

Collaboration d'Équipe

Workflows d'édition et d'approbation collaboratifs pour les mises à jour de Playbooks.

Le système de Playbooks transforme l'IA d'un générateur de code générique en un membre spécialisé de votre équipe qui comprend vos exigences et conventions exactes.

Créez Votre Premier Playbook

Transformez l'IA en un membre d'équipe spécialisé qui suit vos standards exacts

Commencez à Construire des Playbooks→

Vos patterns. Vos standards. Appliqués de manière cohérente.