adelaidasofia/claude-performance

O que claude-performance faz?

Camada de medição auto-aprimorável para Claude Code. Lê dados de sessão JSONL, calcula métricas de eficácia e escreve regras comportamentais no CLAUDE.md. Complementar ao claude-daily-journal e claude-insights.

Visão Geral

Esta skill fornece um mecanismo de autoavaliação e melhoria contínua para o Claude Code. Ao analisar sessões anteriores (gravadas em arquivos JSONL), ela identifica padrões de comportamento eficazes e áreas que precisam de ajuste, atualizando automaticamente as instruções no CLAUDE.md.

Funcionalidades

• Leitura de Sessões JSONL: Processa arquivos de log de sessão para extrair interações, decisões e resultados.
• Cálculo de Métricas: Avalia eficácia com base em critérios como conclusão de tarefas, qualidade das respostas e erros recorrentes.
• Geração de Regras: Cria ou modifica regras comportamentais no CLAUDE.md para orientar futuras interações.
• Integração com Ferramentas: Funciona em conjunto com claude-daily-journal (para registro diário) e claude-insights (para análises profundas).

Como Funciona

1. Coleta de Dados: A skill acessa os arquivos JSONL gerados pelas sessões do Claude Code.
2. Análise: Computa métricas como taxa de sucesso, tempo médio de resposta e padrões de erro.
3. Aplicação: Com base nos resultados, atualiza o CLAUDE.md com novas diretrizes, como:
   • "Sempre verificar a sintaxe antes de executar comandos."
   • "Preferir bibliotecas nativas a dependências externas."
   • "Documentar alterações em changelogs."

Pré-requisitos

• Claude Code configurado e em execução.
• Habilidades complementares: claude-daily-journal e claude-insights (recomendado).
• Acesso aos arquivos de log de sessão (geralmente em ~/.claude/logs/ ou diretório definido pelo usuário).

Uso

A skill opera automaticamente em segundo plano, mas pode ser acionada manualmente com:

claude run --skill adelaidasofia/claude-performance --action analyze

Para forçar uma atualização das regras:

claude run --skill adelaidasofia/claude-performance --action update-rules

Exemplo de Saída

Após a análise, o CLAUDE.md pode conter:

# Regras Comportamentais (Auto-geradas)
- Sempre usar logging estruturado (JSON) para facilitar debugging.
- Evitar loops infinitos; implementar timeout de 30 segundos.
- Priorizar soluções testadas antes de propor novas.

Notas

• As regras geradas são específicas para o projeto atual (por exemplo, CLAUDE.md no diretório raiz).
• Para melhor eficácia, execute a análise periodicamente ou após grandes mudanças no código.
• Consulte a documentação de claude-insights para métricas mais avançadas.

Licença

MIT