Kaizen Improvement

Melhoria Kaizen

Transforme descobertas de análise de .planning/kaizen/ em melhorias acionáveis — hooks, patches de agente, refinamentos de skills, atualizações no CLAUDE.md e scripts de automação.

Pré-requisito: As descobertas de análise devem existir em .planning/kaizen/ (geradas pelo skill de análise de transcrições).

Tipos de Melhoria

Cada categoria de saída abaixo possui um modelo de delegação:

1. Geração de hooks — deny/redirect do PreToolUse, injeção de contexto do SubagentStart, gates de qualidade do Stop
2. Refinamento de prompts de agente — correções cirúrgicas nos prompts de sistema do agente via @subagent-refactorer
3. Patches de skills — adição de conhecimento ausente em skills via /plugin-creator:skill-creator
4. Atualizações no CLAUDE.md — regras comportamentais para todo o projeto
5. Automação de scripts — substituição de fluxos de trabalho manuais repetitivos por scripts ou skills

Para modelos detalhados e exemplos, consulte Modelos de Melhoria.

Para a base de conhecimento do Ciclo de Refinamento Autônomo (ARL) — detalhes de implementação da Camada 3, pré-requisitos e síntese de pesquisa — consulte Conhecimento ARL.

Fluxo de Trabalho

flowchart TD
    Start([Ler descobertas da análise]) --> Parse[Extrair anti-padrões com frequência e evidência]
    Parse --> Score[Pontuar por frequência × impacto]
    Score --> Top[Selecionar principais descobertas]
    Top --> Type{Tipo de melhoria?}
    Type -->|Uso repetido incorreto de ferramentas| Hook[Gerar hook — deny/redirect]
    Type -->|Problema de comportamento do agente| Agent[Gerar conjunto de instruções de patch do agente]
    Type -->|Lacuna de conhecimento| Skill[Gerar conjunto de instruções de patch da skill]
    Type -->|Problema em todo o projeto| Claude[Gerar adição ao CLAUDE.md]
    Type -->|Fluxo de trabalho manual| Script[Gerar proposta de automação]
    Hook --> Output[Escrever em .planning/kaizen/improvements/]
    Agent --> Output
    Skill --> Output
    Claude --> Output
    Script --> Output
    Output --> Install{Flag --install?}
    Install -->|Sim| Apply[Escrever hooks nas configurações, aplicar patches]
    Install -->|Não| Draft[Deixar como propostas para revisão]

Geração de Hooks

Leia as descobertas → gere a configuração do hook + script opcional. Para padrões mapeados para cada tipo de anti-padrão, diretrizes e exemplos, consulte Padrões de Hook.

Protocolo de Delegação

As melhorias são conjuntos de instruções para agentes especialistas, não edições diretas. Siga a delegação focada em resultados:

• Descreva o problema com evidência (IDs de sessão, chamadas de ferramentas, frequência)
• Declare o resultado desejado
• Deixe o agente especialista determinar a abordagem de implementação
• Nunca prescreva alterações de código específicas no prompt de delegação

Modos de Saída

Modo rascunho (padrão)

Escreva todas as propostas em .planning/kaizen/improvements/ como arquivos markdown. Cada arquivo contém:

• Resumo da descoberta com evidência
• Melhoria proposta
• Prompt de delegação para o agente especialista apropriado
• Pontuação de prioridade

Modo de instalação (flag --install)

Apenas para hooks — escreva diretamente em .claude/settings.json ou hooks/hooks.json. Outros tipos de melhoria sempre produzem prompts de delegação (nunca edições diretas).

Pontuação de Prioridade

Classifique as melhorias por:

1. Frequência × Impacto — ocorrências entre sessões × custo por ocorrência
2. Potencial de automação — hooks > scripts > documentação
3. Alcance — projeto inteiro > agente único > sessão única
4. Custo de implementação — hook (minutos) < CLAUDE.md (minutos) < skill (horas) < agente (dias)