● Comunidad
BayramAnnakov
⚡ Instantáneo
claude-reflect
por BayramAnnakov · BayramAnnakov/claude-reflect
Claude Code que aprende silenciosamente de cómo lo corriges — capturando reglas, preferencias y elogios, y luego escribiéndolos en CLAUDE.md / AGENTS.md.
claude-reflect se ejecuta en segundo plano durante las sesiones de Claude Code, observando momentos en que corriges, elogias o repites preferencias. Destila esos momentos en reglas duraderas y actualiza CLAUDE.md y AGENTS.md para que las sesiones futuras las hereden. Alternativa ligera a curar manualmente un archivo de instrucciones.
Por qué usarlo
Características clave
- Detecta correcciones implícitas («en realidad, hazlo así») y señales positivas
- Redacta adiciones de reglas; tú apruebas antes de que lleguen a CLAUDE.md
- Las mismas reglas aparecen en AGENTS.md para herramientas que no son Claude
- Consolidación periódica elimina reglas contradictorias u obsoletas
- Actualizaciones basadas en diff mantienen el historial de git legible
Demo en vivo
Cómo se ve en la práctica
listo
Casos de uso
Usos del mundo real: claude-reflect
Cuándo usarlo: Quieres que CLAUDE.md se mantenga al día con tus preferencias sin que sea una tarea de escritura.
Flujo
-
Trabajar normalmente
Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Copiado
→ La skill captura en silencio — no lo notas
-
Revisión al final del día
Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Copiado
→ 5–10 reglas candidatas con procedencia (qué sesión, qué prompt)
-
Hacer commit del diff
Apply approved rules and commit CLAUDE.md.✓ Copiado
→ Diff limpio de git; reglas ahora en vigor
Resultado: CLAUDE.md que crece contigo, sin costo de mantenimiento manual.
Errores comunes
- La skill captura contexto de una sola vez como reglas duraderas — Revisa siempre los candidatos diarios; rechaza cualquier cosa situacional
Cuándo usarlo: Múltiples devs corrigen a Claude en cosas similares; quieres un conjunto de reglas compartidas.
Flujo
-
Recopilar borradores por desarrollador
Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Copiado
→ Rama con N borradores pendientes
-
Fusionar sesiones
Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Copiado
→ Conjunto de reglas comunes
-
Desplegar
Merge to main. New AGENTS.md applies to everyone.✓ Copiado
→ El equipo usa el mismo baseline; las reglas locales por dev permanecen
Resultado: Estandarización de abajo hacia arriba sin un comité de proceso.
Errores comunes
- Los devs más vocales dominan; se pierden los patrones de los más callados — Asegúrate de que todos ejecuten la skill; pondera por eventos de reflexión, no por ediciones de archivos
Cuándo usarlo: Tu CLAUDE.md tiene ahora 600 líneas y el contexto de Claude está sobrecargado.
Flujo
-
Puntuar la relevancia
Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Copiado
→ Puntuación por regla
-
Proponer eliminaciones
Suggest 30 rules to remove (stale or obsolete).✓ Copiado
→ Lista de eliminaciones con justificación
-
Diff + commit
Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Copiado
→ CLAUDE.md más delgado
Resultado: CLAUDE.md que se lee realmente, no que se hojea.
Errores comunes
- Podar una regla que no se aplicó porque Claude la estaba respetando — En caso de duda, conserva — pero márcala con 'última verificación' para revisarla el próximo trimestre
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
pro-workflow para captura explícita, claude-reflect para la pasiva — aprendizaje de dos canales
Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Copiado
Cambios de reglas revisables mediante PR
Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- Ninguna — local
- Tokens por llamada
- La captura en segundo plano es gratuita; la revisión/consolidación usa LLM local si está configurado
- Monetario
- Gratuito
- Consejo
- Aprueba candidatos de forma conservadora — calidad sobre cantidad
Seguridad
Permisos, secretos, alcance
Ámbitos mínimos: filesystem-write
Almacenamiento de credenciales: Estado de la skill en .claude/reflect/; haz commit al repositorio si quieres compartirlo
Salida de datos: Ninguna por defecto
- Los logs de reflexión pueden incluir fragmentos de código sensibles — agrega el log sin procesar al gitignore; haz commit solo de las reglas destiladas
Resolución de problemas
Errores comunes y soluciones
No se capturan candidatos
Verifica que la skill está invocada en el preámbulo de CLAUDE.md; revisa .claude/reflect/log para ver entradas
Los candidatos son ruido
Ajusta la sensibilidad del disparador; captura solo de correcciones explícitas, no del chat genérico
AGENTS.md diverge de CLAUDE.md
Ejecuta consolidate periódicamente; la herramienta está diseñada para mantenerlos sincronizados pero las ediciones manuales los separan
El prompt de aprobación es abrumador
Ejecuta review con --limit 5 diariamente; crea un hábito en lugar de hacer 50 a la vez
Alternativas
claude-reflect vs otros
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| pro-workflow-skill | Prefieres captura explícita y orquestación de worktrees | Más manual; más potente para trabajo en paralelo |
| Manual CLAUDE.md curation | Eres lo suficientemente disciplinado como para escribir reglas tú mismo | Frecuentemente descuidado; depende de la fuerza de voluntad |