Retrospectiva de Sesión
Revisa una sesión de trabajo con un agente de IA para encontrar oportunidades de mejora. La retrospectiva se desarrolla mediante un diálogo interactivo: observa lo que sucedió, discute los hallazgos con el usuario y luego presenta recomendaciones accionables.
El objetivo es mejorar la eficiencia de la colaboración del usuario con la IA: mejores prompts, mejor documentación, mejores herramientas, mejores flujos de trabajo.
Inicio Rápido
Retrospectiva de esta sesión
/retro
¿Qué podría mejorar de esta sesión?
Revisión de sesión — encuentra oportunidades de optimización
Cuándo Usarlo
- Al finalizar una sesión de trabajo para reflexionar y capturar aprendizajes
- Después de una sesión con fricciones, correcciones o soluciones alternativas
- Cuando se desea mejorar las instrucciones del agente, habilidades, hooks o flujos de trabajo
- Cuando se tiene curiosidad sobre qué habilidades de la comunidad podrían ayudar con los patrones observados en la sesión
- Periódicamente para mantener prácticas de desarrollo saludables
Cómo Funciona
El flujo que se describe a continuación es una guía típica — adáptalo naturalmente a la conversación. No todas las sesiones necesitan todos los pasos; una sesión corta sin problemas puede requerir solo una observación rápida y seguir adelante.
Observación
Revisa la conversación de la sesión e identifica libremente cualquier cosa digna de mención. No te limites a categorías predefinidas: deja que las observaciones surjan naturalmente de lo que realmente sucedió.
Para cada observación, proporciona un hallazgo de una línea y una recomendación accionable inicial. Incluso si el usuario no profundiza, cada observación debe ofrecer una conclusión útil.
Después del análisis abierto, utiliza las 15 dimensiones en dimensions.md como lista de verificación de seguridad — revisa si el análisis abierto pasó por alto algo. Solo agrega hallazgos adicionales que realmente valga la pena mencionar.
Incluye ambos:
- Hallazgos reactivos: cosas que salieron mal o se corrigieron
- Hallazgos proactivos: cosas que salieron bien pero no están documentadas, o buenas prácticas que podrían codificarse
Profundización Interactiva
Presenta las observaciones una por una con un indicador de progreso (ej. [2/6]). Para cada observación, da la recomendación inicial y pregunta si el usuario desea profundizar.
El usuario puede:
- Decir que sí — se anota para profundizar
- Decir que no — se continúa (la recomendación inicial sigue vigente)
- Agregar contexto o correcciones
- Mencionar observaciones que la IA pasó por alto
- Decir "suficiente" para saltar las restantes y continuar
Después de repasar todas las observaciones, si el usuario seleccionó alguna para profundizar, evalúa qué elementos realmente necesitan investigación mediante subagentes frente a los que son lo suficientemente claros para actuar directamente. Presenta esta evaluación y pide al usuario que confirme antes de lanzar subagentes.
Cada subagente sigue el ciclo en subagent-guide.md: investigar a fondo la observación, analizar las causas raíz, diseñar soluciones concretas y presentar los hallazgos con una recomendación.
Resultados y Discusión
Presenta los resultados de cada subagente uno por uno con progreso. El usuario puede:
- Discutir el resultado y hacer preguntas de seguimiento
- Aceptar una opción recomendada
- Solicitar modificaciones
- Saltar al siguiente resultado
Recomendaciones de Acción
Después de discutir todos los resultados, compila las acciones confirmadas en un resumen de recomendaciones. Para cada acción, presenta qué hacer y por qué. Si el usuario pide persistir (ej. "escríbelo"), genera un resumen en markdown en el chat — no escribas archivos.
Cierra la retrospectiva explícitamente: dile al usuario que la retrospectiva ha finalizado y que las acciones recomendadas las debe iniciar él cuando esté listo.
Pautas
SÍ HACER
- Dejar que las observaciones surjan del contenido real de la sesión, no de una plantilla fija
- Ofrecer conclusiones accionables para cada observación, incluso sin profundizar
- Respetar el tiempo del usuario — si una sesión fue limpia, decirlo y ser breve
- Pedir permiso antes de lanzar subagentes
- Para correcciones: investigar si la causa raíz es una convención faltante, documentación poco clara o una habilidad que necesita mejora
- Para buenas prácticas: sugerir codificarlas antes de que se olviden
- Al analizar habilidades: verificar la propiedad primero (mantenida por uno mismo vs. de la comunidad) para dar consejos adecuados
- Presentar los hallazgos con una recomendación y su fundamento
NO HACER
- Ejecutar ninguna acción (ej. commit, push, modificar archivos). Esta habilidad es solo para análisis y recomendaciones
- Interpretar el acuerdo del usuario (ej. "sí", "suena bien", "adelante") como una solicitud de ejecución. Dichas respuestas son solo acuses de recibo
- Actuar sobre cualquier instrucción antes de que la retrospectiva se cierre explícitamente. Solo una instrucción nueva y específica después de que la retrospectiva haya concluido es una solicitud válida de acción
- Forzar una secuencia de fases rígida — adaptarse a la conversación
- Analizar en exceso sesiones con problemas mínimos
- Lanzar subagentes sin permiso del usuario
- Recomendar cambios sin explicar el porqué
- Omitir la opción "no hacer nada / saltar" al presentar opciones
- Ser crítico con los prompts o el flujo de trabajo del usuario — ser constructivo
Archivos de Referencia
- dimensions.md — 15 dimensiones de análisis utilizadas como lista de verificación de seguridad
- subagent-guide.md — Cómo los subagentes investigan, analizan y presentan hallazgos
Notas
- Las 15 dimensiones son una lista de verificación, no una rúbrica de puntuación. La mayoría de las sesiones solo tendrán señal en algunas dimensiones.
- El análisis de patrones entre sesiones está disponible si el usuario desea revisar varias sesiones — preguntar sobre el alcance al inicio si no está claro.
- Herramientas relacionadas que el usuario puede invocar por separado después de una retrospectiva: hookify, claude-md-management, skill-creator, brainstorming. La retrospectiva no invoca estas herramientas directamente.