● Comunidade
BayramAnnakov
⚡ Instantâneo
claude-reflect
por BayramAnnakov · BayramAnnakov/claude-reflect
Claude Code que aprende silenciosamente com a forma como você o corrige — capturando regras, preferências e elogios, depois escrevendo-os no CLAUDE.md / AGENTS.md.
claude-reflect roda em segundo plano nas sessões do Claude Code, observando momentos em que você corrige, elogia ou reafirma preferências. Destila esses sinais em regras duráveis e atualiza CLAUDE.md e AGENTS.md para que sessões futuras as herdem. Alternativa leve à curação manual de um arquivo de instruções.
Por que usar
Principais recursos
- Detecta correções implícitas («na verdade, faça assim») e sinais positivos
- Rascunha adições de regras; você aprova antes que cheguem ao CLAUDE.md
- As mesmas regras aparecem no AGENTS.md para tooling fora do Claude
- Consolidação periódica remove regras contraditórias ou desatualizadas
- Atualizações baseadas em diff mantêm o histórico do git legível
Demo ao vivo
Como fica na prática
pronto
Casos de uso
Usos do mundo real: claude-reflect
Quando usar: Você quer que o CLAUDE.md acompanhe suas preferências sem ser um fardo de escrita.
Fluxo
-
Trabalhe normalmente
Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Copiado
→ Skill captura silenciosamente — você não percebe
-
Revisão no fim do dia
Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Copiado
→ 5–10 regras candidatas com proveniência (qual sessão, qual prompt)
-
Commitar o diff
Apply approved rules and commit CLAUDE.md.✓ Copiado
→ Diff limpo no git; regras agora em vigor
Resultado: CLAUDE.md que cresce com você, sem custo de manutenção manual.
Armadilhas
- Skill captura contexto pontual como regras duráveis — Sempre revise os candidatos diários; rejeite qualquer coisa situacional
Quando usar: Múltiplos devs corrigem o Claude nas mesmas coisas; você quer um conjunto de regras compartilhado.
Fluxo
-
Coletar rascunhos por desenvolvedor
Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Copiado
→ Branch com N rascunhos pendentes
-
Mesclar as sessões
Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Copiado
→ Conjunto de regras de terreno comum
-
Distribuir
Merge to main. New AGENTS.md applies to everyone.✓ Copiado
→ Time usa a mesma baseline; regras locais por dev permanecem
Resultado: Padronização bottom-up sem comitê de processos.
Armadilhas
- Devs mais ruidosos dominam; padrões dos quietos são perdidos — Certifique-se de que todos rodem a skill; pese por eventos de reflexão, não por edições de arquivo
Quando usar: Seu CLAUDE.md agora tem 600 linhas e o contexto do Claude está inflado.
Fluxo
-
Pontuar relevância
Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Copiado
→ Score por regra
-
Propor deleções
Suggest 30 rules to remove (stale or obsolete).✓ Copiado
→ Lista de remoções com justificativa
-
Diff + commitar
Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Copiado
→ CLAUDE.md mais enxuto
Resultado: CLAUDE.md que é de fato lido, não ignorado.
Armadilhas
- Remover uma regra que não foi aplicada porque o Claude a estava respeitando — Na dúvida, mantenha — mas marque com 'last verified' para re-verificar no próximo trimestre
Combinações
Combine com outros MCPs para 10× de alavancagem
pro-workflow para captura explícita, claude-reflect para passiva — aprendizado em dois canais
Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Copiado
Mudanças de regras revisáveis via PR
Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copiado
Custo e limites
O que custa rodar
- Cota de API
- Nenhuma — local
- Tokens por chamada
- Captura em segundo plano é gratuita; review/consolidate usa LLM local se configurado
- Monetário
- Gratuito
- Dica
- Aprove candidatos de forma conservadora — qualidade > quantidade
Segurança
Permissões, segredos, alcance
Escopos mínimos: filesystem-write
Armazenamento de credenciais: Estado da skill em .claude/reflect/; commite no repositório se quiser compartilhamento
Saída de dados: Nenhuma por padrão
- Logs de reflexão podem incluir trechos de código sensíveis — adicione o log bruto ao .gitignore; commite apenas regras destiladas
Solução de problemas
Erros comuns e correções
Nenhum candidato capturado
Verifique se a skill está invocada no preâmbulo do CLAUDE.md; verifique .claude/reflect/log por entradas
Candidatos são ruído
Ajuste a sensibilidade do gatilho; capture apenas de correções explícitas, não de chat genérico
AGENTS.md diverge do CLAUDE.md
Execute consolidate periodicamente; a tool é projetada para mantê-los sincronizados mas edições manuais os divergem
Prompt de aprovação avassalador
Execute review com --limit 5 diariamente; construa um hábito em vez de fazer 50 de uma vez
Alternativas
claude-reflect vs. outros
| Alternativa | Quando usar | Troca |
|---|
| pro-workflow-skill | Você prefere captura explícita e orquestração de worktrees | Mais manual; mais poderoso para trabalho paralelo |
| Curação manual do CLAUDE.md | Você tem disciplina suficiente para escrever as regras você mesmo | Frequentemente negligenciado; depende de força de vontade |