Sistema de libros de jugadas

El sistema Playbooks es la solución de segunda generación de Hatcher al problema de contexto en el desarrollo de la IA. Cuando los archivos estáticos como Claude.md proporcionan un punto de partida, los libros de jugadas ofrecen un sistema dinámico, centralizado y gobernable que actúa como una verdadera constitución corporativa para sus agentes de IA.

¿Qué son los libros de jugadas?

Los libros de jugadas son archivos de configuración estructurados que capturan los de su equipo:

• Estándares de codificación: formateo, convenciones de nombres y preferencias de estilo
• Decisiones de arquitectura: Patrones de componentes, enfoques de gestión estatal
• Decobles de marco: Mejores prácticas y patrones específicos de la biblioteca
• Reglas comerciales: Lógica y restricciones específicas del dominio

Estructura del libro de jugadas

Un libro de jugadas básico sigue esta estructura:

{
"Nombre": "Vue 3 estándares de componentes",
"Versión": "1.0.0",
"Framework": "Vue",
"normas": [
{
"Categoría": "Componentes",
"Tipo": "Naming",
"Patrón": "Pascalcase",
"Descripción": "Todos los componentes VUE deben usar Naming Pascalcase"
},
{
"Categoría": "Composición",
"Tipo": "API",
"Preferencia": "Composición-API",
"Descripción": "Prefiere la API de composición sobre las opciones API"
}
]
"Ejemplos": [
{
"Título": "Estructura de componentes estándar",
"Código": "..."
}
]
}

Libros de jugadas incorporados

Hatcher barcos con libros de jugadas curados para marcos populares:

Vue.js Playbooks

• Vue 3 + TypeScript: Patrones de composición modernos
• nuxt.js: SSR y convenciones de enrutamiento basadas en archivos
• PCINIA: Las mejores prácticas de gestión estatal

React Playbooks

• React + TypeScript: Componentes y ganchos funcionales
• next.js: componentes del enrutador y servidor de la aplicación
• zustand: gestión estatal ligera

Los libros de jugadas universales

• Los estándares de TypeScript: Tipo Definiciones y genéricos -CSS-in-JS: Componentes de estilo y patrones de emoción
• Pruebas: Convenciones de Jest y Cypress

Creación de libros de jugadas personalizados

Reglas específicas del equipo

Cree libros de jugadas que capturen las convenciones únicas de su equipo:

{
"Nombre": "Estándares de Acme Corp",
"extiende": ["vue3-typescript"],
"normas": [
{
"Categoría": "API",
"Tipo": "Estructura",
"Patrón": "Servicios/API/*. Service.ts",
"Descripción": "Todas las llamadas de API deben pasar por la capa de servicio"
},
{
"Categoría": "Componentes",
"Tipo": "Props",
"requisito": "interfaces",
"Descripción": "Los accesorios de componentes deben usar interfaces de TypeScript"
}
]
}

Contexto específico del proyecto

Agregar conocimiento específico del proyecto:

{
"Nombre": "Dashboard de comercio electrónico",
"extiende": ["acme-corp-standards"],
"contexto": {
"dominio": "comercio electrónico",
"Entidades": ["producto", "pedido", "cliente"],
"API": [
{
"Nombre": "OrderSapi",
"BaseUrl": "/API/Orders",
"Métodos": ["Get", "Publicar", "poner", "Eliminar"]
}
]
}
}

herencia de libros de jugadas

Los libros de jugadas admiten la herencia para la configuración escalable:

Mecanografiado universal
↓
Vue 3 + TypeScript
↓
Estándares de Acme Corp
↓
Reglas específicas del proyecto

Integración de IA

Hatcher inyecta automáticamente el contexto de los libros de jugadas relevantes en las indicaciones de IA:

Selección de contexto

• Automático: basado en tipos de archivos y estructura de proyecto
• Manual: Especifique explícitamente qué libros de jugadas usar
• inteligente: Aprenda de sus preferencias con el tiempo

Mejora rápida

Los motores de IA reciben un contexto estructurado como:

Contexto: creación de componentes Vue 3
Playbook: Vue3-typescript, acme-corp-standards
NORMAS:
- Use la API de composición con <Script Setup>
- Los accesorios deben usar interfaces de TypeScript
- Los componentes deben ser Pascalcase
- Las llamadas de API pasan por la capa de servicio

mercado y compartir

Playbooks comunitarios

Explorar e instalar libros de jugadas creados por la comunidad:

• Marco específico: Patrones optimizados para bibliotecas populares
• ESPECÍTICO DE LA INDURSIÓN: Conocimiento de dominio para diferentes sectores -probado en equipo: Convenciones del mundo real de proyectos exitosos

Publicar tus libros de jugadas

Comparta la experiencia de su equipo:

Hatcher Playbook Publicar los estándares acme-corp

Administración de versiones

• Versiones semánticas: Cambios de seguimiento y compatibilidad
• Notificaciones de actualización: Manténgase actualizado con las mejoras de la comunidad
• Soporte de reversión: Revertir de forma segura actualizaciones problemáticas

Configuración

Libros de jugadas globales

Establecer libros de jugadas predeterminados para todos los proyectos:

{
"GlobalPlaybooks": ["TypeScript-Standards", "Git-Conventions"]
}

Anulación del proyecto

Especifique los libros de jugadas específicos del proyecto en hatcher.config.json:

{
"Playbooks": ["Vue3-Typescript", "Team-Standards", "./custom-playbook.json"]
}

Carga condicional

Cargue diferentes libros de jugadas basados ​​en el contexto:

{
"condicional": {
"**/*. Test.ts": ["Testing-Standards"],
"src/componentes/**": ["componente-standards"],
"Src/API/**": ["API-Standards"]
}
}

Las mejores prácticas

Empiece simple

Comience con los conceptos básicos del marco y agregue gradualmente las reglas específicas del equipo:

1. Instalar el libro de jugadas del marco: Obtenga una cobertura del 80% al instante
2. Agregar reglas de equipo: capturar convenciones únicas
3. Refina con el tiempo: Actualización basada en un uso real

Manténgalo actualizado

• Reseñas regulares: actualizar los libros de jugadas a medida que evolucionan los patrones
• Comentarios del equipo: Involucre a todo el equipo en el mantenimiento del libro de jugadas
• Control de la versión: rastrear los cambios en el libro de jugadas junto con el código

Impacto de medida

• Métricas de consistencia: Seguimiento de la adhesión a patrones definidos
• Mejoras de velocidad: Medir ganancias de velocidad de desarrollo
• Indicadores de calidad: monitorear la retroalimentación de revisión del código reducido

Características futuras

Libros de jugadas generados por AI

Genere automáticamente los libros de jugadas analizando las bases de código existentes.

Validación en tiempo real

Comentarios en vivo mientras codifica, asegurando el cumplimiento del libro de jugadas.

Colaboración del equipo

Flujos de trabajo de edición y aprobación de colaboración para actualizaciones de libros de jugadas.

El sistema de libros de jugadas transforma la IA de un generador de código genérico en un miembro especializado de su equipo que comprende sus requisitos y convenciones exactos.

Crea tu primer libro de jugadas

Transformar IA en un miembro de equipo especializado que sigue sus estándares exactos

Comience a construir libros de jugadas→