Mejora Kaizen

¿Qué hace Mejora Kaizen?

Transforma los hallazgos del análisis de .planning/kaizen/ en mejoras accionables — hooks, parches de agente, refinamientos de skill, actualizaciones de CLAUDE.md y scripts de automatización.

Requisito previo: Los hallazgos del análisis deben existir en .planning/kaizen/ (generados por la skill de análisis de transcripciones).

Tipos de mejora

Cada categoría de salida a continuación tiene una plantilla de delegación:

1. Generación de hooks — denegación/redirección en PreToolUse, inyección de contexto en SubagentStart, compuertas de calidad en Stop
2. Refinamiento de prompt de agente — correcciones quirúrgicas a los prompts del sistema del agente vía @subagent-refactorer
3. Parches de skill — añadir conocimiento faltante a las skills vía /plugin-creator:skill-creator
4. Actualizaciones de CLAUDE.md — reglas de comportamiento para todo el proyecto
5. Automatización de scripts — reemplazar flujos de trabajo manuales repetitivos con scripts o skills

Para plantillas detalladas y ejemplos, consulta Plantillas de mejora.

Para la base de conocimiento del Bucle de Refinamiento Autónomo (ARL) — detalles de implementación de la Capa 3, requisitos previos y síntesis de investigación — consulta Conocimiento ARL.

Flujo de trabajo

flowchart TD
    Start([Leer hallazgos del análisis]) --> Parse[Extraer antipatrones con frecuencia y evidencia]
    Parse --> Score[Puntuar por frecuencia × impacto]
    Score --> Top[Seleccionar hallazgos principales]
    Top --> Type{¿Tipo de mejora?}
    Type -->|Mal uso repetido de herramienta| Hook[Generar hook — denegar/redirigir]
    Type -->|Problema de comportamiento del agente| Agent[Generar conjunto de instrucciones de parche de agente]
    Type -->|Carencia de conocimiento| Skill[Generar conjunto de instrucciones de parche de skill]
    Type -->|Problema a nivel de proyecto| Claude[Generar adición a CLAUDE.md]
    Type -->|Flujo de trabajo manual| Script[Generar propuesta de automatización]
    Hook --> Output[Escribir en .planning/kaizen/improvements/]
    Agent --> Output
    Skill --> Output
    Claude --> Output
    Script --> Output
    Output --> Install{¿flag --install?}
    Install -->|Sí| Apply[Escribir hooks en settings, aplicar parches]
    Install -->|No| Draft[Dejar como propuestas para revisión]

Generación de hooks

Leer hallazgos → generar configuración de hook + script opcional. Para patrones asignados a cada tipo de antipatrón, pautas y ejemplos, consulta Patrones de hook.

Protocolo de delegación

Las mejoras son conjuntos de instrucciones para agentes especialistas, no ediciones directas. Sigue una delegación enfocada en resultados:

• Describe el problema con evidencia (IDs de sesión, llamadas a herramientas, frecuencia)
• Indica el resultado deseado
• Deja que el agente especialista determine el enfoque de implementación
• Nunca prescribas cambios de código específicos en el prompt de delegación

Modos de salida

Modo borrador (predeterminado)

Escribe todas las propuestas en .planning/kaizen/improvements/ como archivos markdown. Cada archivo contiene:

• Resumen del hallazgo con evidencia
• Mejora propuesta
• Prompt de delegación para el agente especialista adecuado
• Puntuación de prioridad

Modo instalación (flag --install)

Solo para hooks — escribe directamente en .claude/settings.json o hooks/hooks.json. Otros tipos de mejora siempre producen prompts de delegación (nunca ediciones directas).

Puntuación de prioridad

Clasifica las mejoras por:

1. Frecuencia × Impacto — ocurrencias entre sesiones × costo por ocurrencia
2. Potencial de automatización — hooks > scripts > documentación
3. Radio de explosión — todo el proyecto > un solo agente > una sola sesión
4. Costo de implementación — hook (minutos) < CLAUDE.md (minutos) < skill (horas) < agente (días)