claude-reflect (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

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

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: claude-reflect

Evoluir o CLAUDE.md sem curação manual

👤 Devs solo que detestam manter arquivos de documentação ⏱ ~5 min beginner

Quando usar: Você quer que o CLAUDE.md acompanhe suas preferências sem ser um fardo de escrita.

Pré-requisitos

Skill instalada — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
Reflexão habilitada — Adicione use claude-reflect ao preâmbulo do CLAUDE.md do seu projeto

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

Combine com: filesystem

Construir convenções de IA de toda a equipe a partir de correções coletivas

👤 Tech leads padronizando fluxos de trabalho com IA ⏱ ~60 min intermediate

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

Combine com: github

Auditar e remover regras desatualizadas do CLAUDE.md

👤 Usuários antigos do CLAUDE.md ⏱ ~25 min intermediate

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

claude-reflect-skill + pro-workflow-skill

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

claude-reflect-skill + github

Mudanças de regras revisáveis via PR

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
watch_session	—	Processo em segundo plano sempre ativo
review_candidates	since?	Loop de aprovação diário / semanal
consolidate	scope?	Deduplicação periódica / resolução de contradições
score_rules	—	Auditoria pré-limpeza
apply_to_files	approved_ids[], files[]	Aplicar candidatos aprovados no CLAUDE.md / AGENTS.md

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

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills