CR8-OS/retro-bot

¿Qué hace retro-bot?

Una skill para realizar retrospectivas ágiles ligeras sobre sesiones de colaboración con Claude, mejorando gradualmente el proceso de trabajar con Claude.

El ciclo principal: después de que tú y Claude completen un trabajo, se toman unos minutos para hacerse tres preguntas juntos:

• ¿Qué funcionó bien? (seguir haciendo esto)
• ¿Qué no funcionó bien? (fricción, repetición de trabajo, confusión, tokens desperdiciados)
• ¿Qué deberíamos cambiar? (mejoras concretas en skills, indicaciones o procesos)

Los cambios se aplican de inmediato y cada retrospectiva se guarda como una instantánea en un archivo persistente. Con el tiempo, esto construye un registro de auditoría continuo de cómo ha evolucionado tu flujo de trabajo con Claude, y se acumula en una configuración que se vuelve significativamente más rápida con cada sesión.

---

Fase 0 — Configuración del Directorio de Archivo (solo la primera ejecución)

Antes de que comience la retrospectiva, verifica si se ha configurado un directorio de archivo de retrospectivas. Busca en Claude.md un bloque como este:

## Retro-Bot
archive_dir: [ruta]

Si ya está configurado: continúa directamente a la Fase 1. No es necesario preguntar de nuevo.

Si no está configurado: pregunta al usuario una vez, claramente:

"Antes de empezar — ¿dónde quieres guardar las instantáneas de las retrospectivas? Esta es una configuración única. Dame una ruta de carpeta (por ejemplo, H:\My Drive\Retros o ~/Documentos/retros) y a partir de ahora guardaré cada retrospectiva allí automáticamente."

Una vez que el usuario proporcione una ruta:

1. Agrega el siguiente bloque a Claude.md (crea el archivo si no existe):

   ## Retro-Bot
   archive_dir: [la ruta que dieron]
   

2. Crea el directorio si no existe
3. Crea un archivo retro-log.md vacío en ese directorio (consulta la Fase 6 para su formato)
4. Confirma: "Entendido — el archivo de retrospectivas se ha establecido en [ruta]. Todas las retrospectivas futuras se guardarán allí."

Luego continúa a la Fase 1.

---

Fase 1 — Leer el Contexto de la Sesión

Lee la transcripción de la sesión para entender lo que realmente sucedió. Si tu entorno proporciona una herramienta de historial de sesiones o transcripciones, úsala ahora para obtener el registro completo de lo que ocurrió. (En Cowork, esto está disponible automáticamente; en Claude Code, usa /transcript o el equivalente si está disponible). Incluso sin la transcripción completa, extrae de lo que sabes: qué skills se usaron, qué archivos se crearon, qué comentarios dio el usuario durante la sesión, dónde hubo que rehacer cosas.

Si el usuario invoca esta skill inmediatamente después de una sesión, ya tienes el contexto. Si la invoca más tarde con una descripción, trabaja a partir de eso.

Pide al usuario que confirme en qué sesión/trabajo quiere hacer la retrospectiva si no está claro.

---

Fase 2 — Claude Comienza con Observaciones

Ve primero. No esperes a que el usuario enumere quejas: comparte lo que tú notaste. Esto modela un buen comportamiento de retrospectiva, muestra que estabas prestando atención y a menudo saca a la luz cosas que el usuario no registró conscientemente pero reconocerá de inmediato.

Enmarca las observaciones con honestidad y especificidad:

• "Noté que tuve que volver a renderizar la SOW dos veces porque el primer formato de tabla no se abría correctamente en Word — eso es un problema de configuración de la skill que puedo arreglar."
• "Me diste el resumen del cliente en tres mensajes separados en lugar de un solo bloque — vale la pena señalarlo como un patrón de trabajo que ralentiza las cosas."
• "Las skills de creador de alcance y creador de SOW produjeron números consistentes — eso se sintió fluido."
• "No estaba seguro de qué formato de exportación necesitabas hasta que me lo dijiste a mitad de camino — una pregunta rápida al principio habría ahorrado un viaje de ida y vuelta."

Mantén de 3 a 5 observaciones. Sé directo, no defensivo. Eres un participante, no un testigo.

---

Fase 3 — Invitar la Opinión del Usuario

Después de tu apertura, invita al usuario a agregar, modificar o refutar:

"Esas son mis observaciones. ¿Qué hay en tu lista? ¿Algo que me haya perdido, algo que formularías de manera diferente, o cosas que quieras asegurarte de que capturemos?"

Los puntos de fricción del usuario a menudo son diferentes a los tuyos. Pueden señalar cosas que fueron confusas, problemas de calidad de salida que no mencionaron en el momento, molestias del proceso o cosas que se sintieron geniales y que deberían preservarse. Captura todo.

---

Fase 4 — Construir el Tablero de Retrospectiva

Una vez que ambos hayan contribuido, presenta el tablero completo. Sé específico: los elementos vagos no producen elementos de acción útiles.

## ✅ Funcionó Bien
- [cosa específica que salió bien]
- ...

## ❌ No Funcionó Bien
- [punto de fricción específico, causa raíz si se conoce]
- ...

## 🔧 Ideas de Cambio
- [sugerencia concreta vinculada a un elemento de "no funcionó bien"]
- ...

Pide al usuario que confirme antes de continuar:

"¿Esto lo captura? ¿Algo que agregar o ajustar antes de que decidamos qué hacer?"

---

Fase 5 — Mapear a Elementos de Acción

Para cada Idea de Cambio, determina el tipo y la prioridad:

Tipo	Cuándo usarlo
🔧 Actualización de skill	El problema provino de las instrucciones, el formato de salida o el comportamiento predeterminado de una skill
📋 Actualización de proyecto/sesión	Contexto o instrucciones limitadas a un proyecto, cliente o tipo de sesión específicos — no global
📝 Actualización de Claude.md	Falta de contexto que se aplica en todas partes, en todos los proyectos y sesiones
💡 Nota de proceso	Cambio de comportamiento — no se necesita edición de archivo, solo una forma diferente de trabajar
🆕 Nueva skill	La brecha es recurrente y lo suficientemente grande como para justificar su propia skill

La distinción clave entre una actualización de proyecto/sesión y una actualización de Claude.md es el alcance. Si el contexto debe aplicarse solo cuando se trabaja en un proyecto, cliente o tipo de sesión específicos, pertenece a la capa de proyecto/sesión. Si debe aplicarse siempre, en todas partes, para el usuario en cada trabajo, pertenece a Claude.md. Equivocarse en esto es costoso en cualquier dirección: demasiado en Claude.md crea ruido y fuga de contexto entre clientes; demasiado en los archivos de proyecto significa que tendrás que restablecer el contexto cada vez que cambies de proyecto.

Para cada elemento de acción, indica qué cambia, dónde, por qué es importante y si se debe actuar ahora o anotarlo para más tarde. Confirma antes de aplicar cualquier cosa:

"Esto es lo que propongo cambiar. ¿Quieres que continúe?"

Consulta references/action-item-types.md para obtener una guía detallada sobre cada tipo.

---

Fase 6 — Aplicar Cambios con Versionado

Aplica cada elemento de acción confirmado utilizando un patrón de versionado de copia primero — nunca sobrescribas el archivo de origen directamente. La regla: leer el actual → aplicar ediciones en memoria → escribir en un nuevo nombre de archivo de versión (por ejemplo, SKILL-v1.1.md) → mantener el archivo antiguo en archive/. Esto crea un historial recuperable sin una herramienta de versionado separada.

Actualizaciones de skill: Leer el actual → aplicar en memoria → escribir en un nuevo nombre de archivo de versión → archivar el antiguo → agregar entrada en el registro de cambios. Incrementa parche para correcciones pequeñas, menor para adiciones significativas, mayor para cambios de arquitectura.

Actualizaciones de proyecto/sesión: Identifica el archivo de instrucciones adecuado para el alcance del cambio; esto podría ser un CLAUDE.md a nivel de proyecto en la raíz de un repositorio o carpeta (Claude Code), una configuración de sesión de Cowork, un archivo de resumen permanente para un compromiso recurrente con un cliente, o instrucciones personalizadas limitadas a un tipo de sesión. Si el archivo no existe, créalo. Aplica el mismo patrón de copia primero que para cualquier otro cambio de archivo.

Destinos comunes:

• [carpeta-del-proyecto]/CLAUDE.md — se carga automáticamente en cada sesión de Claude Code para ese proyecto
• Un archivo de referencia permanente [nombre-del-cliente]-brief.md o [nombre-del-proyecto]-context.md
• Configuración de sesión de Cowork o aviso del sistema
• Instrucciones personalizadas de Claude.ai (Configuración de la cuenta → "¿Qué te gustaría que Claude supiera?")

Actualizaciones de Claude.md: Leer el actual → agregar nuevo contexto en la sección correcta → escribir nueva versión → archivar la anterior. Si no existe Claude.md, créalo.

Notas de proceso: Documenta en la instantánea de la retrospectiva (no se necesita un archivo separado).

Después de aplicar, confirma qué cambió:

"Hecho — actualicé [nombre de la skill] a la v1.1 y agregué una nota a Claude.md sobre [tema]."

---

Fase 7 — Guardar la Instantánea de la Retrospectiva y Actualizar el Registro de Auditoría

Esta fase es obligatoria: cada ejecución de retrospectiva debe producir una instantánea guardada, independientemente de cuántos elementos de acción se hayan aplicado. La instantánea es el registro; el registro de auditoría es el feed.

Paso 1: Guardar la Instantánea de la Retrospectiva

Guarda una instantánea completa de la retrospectiva en el archive_dir configurado. Formato del nombre del archivo:

[archive_dir]/YYYY-MM-DD-[descriptor-corto]-retro.md

Ejemplo: H:\My Drive\Retros\2026-05-15-construccion-doc-retro.md

Mantén los descriptores cortos (3–5 palabras, separadas por guiones): construccion-dashboard, borrador-contenido, analisis-datos-q2.

Plantilla de Instantánea

# Retro Snapshot: [Descriptor de la Sesión]
**Fecha:** YYYY-MM-DD
**Tipo de sesión:** [construcción de SOW / análisis de datos / contenido / código / otro]
**Skills utilizadas:** [lista separada por comas]
**Formato de retrospectiva:** [WWW / Start-Stop-Continue / 4Ls / etc.]

---

## ✅ Funcionó Bien
- [elemento]

## ❌ No Funcionó Bien
- [elemento]

## 🔧 Ideas de Cambio Discutidas
- [elemento]

---

## Elementos de Acción y Resultados

| # | Cambio | Tipo | Destino | Estado |
|---|---|---|---|---|
| 1 | [descripción] | Actualización de skill | [skill] v1.0 → v1.1 | ✅ Aplicado |
| 2 | [descripción] | Actualización de proyecto/sesión | [CLAUDE.md del proyecto / resumen del cliente / config de sesión] | ✅ Aplicado |
| 3 | [descripción] | Actualización de Claude.md | Claude.md | ✅ Aplicado |
| 4 | [descripción] | Nota de proceso | — | 📝 Anotado |
| 5 | [descripción] | Nueva skill | [nombre] | 🔜 En cartera |

---

## Acuerdos de Proceso
[Cualquier acuerdo de comportamiento realizado durante esta retrospectiva — cosas que ambas partes acordaron hacer de manera diferente la próxima vez, que no se corresponden con un cambio de archivo]

## Preguntas Abiertas / Cartera
[Elementos anotados para más adelante, cosas que revisar o seguimientos de esta retrospectiva]

## Notas
[Cualquier contexto adicional que valga la pena conservar]

Paso 2: Actualizar el Registro de Auditoría

Después de guardar la instantánea, añade una línea a retro-log.md en el directorio de archivo. Este archivo es el feed continuo: un único registro visible de cada retrospectiva realizada.

Formato de retro-log.md (crear con este encabezado en la primera ejecución):

# Registro de Retrospectivas

Registro continuo de todas las sesiones de retro-bot.

| Fecha | Sesión | Aplicados | Anotados | En cartera | Instantánea |
|---|---|---|---|---|---|

Añade cada nueva retrospectiva como una fila:

| 2026-05-15 | Construcción de documento – propuesta extensa | 2 | 1 | 0 | [enlace](2026-05-15-propuesta-doc-retro.md) |

• Aplicados: número de elementos de acción con estado ✅ Aplicado
• Anotados: número de notas de proceso (📝 Anotado)
• En cartera: número de elementos marcados como 🔜 En cartera

Después de guardar ambos archivos, confirma:

"Instantánea de la retrospectiva guardada en [archive_dir]/[nombre del archivo] y el registro de auditoría actualizado. Ahora tienes [N] retrospectivas en el registro."

---

Tono y Espíritu

• Claude va primero — comparte tus observaciones antes de pedir las del usuario.
• Sé específico — "la tabla .docx no se renderizó porque los anchos de columna estaban codificados" es más útil que "el formato del archivo era incorrecto".
• Los pequeños cambios se acumulan — una corrección de 3 líneas que ahorra 10 minutos por sesión se suma rápidamente.
• No todo necesita arreglo — dos cambios bien elegidos superan a ocho cambios a medias.
• Mantenlo rápido — apunta a 10–15 minutos. Si se está alargando, estás resolviendo problemas en la retrospectiva en lugar de identificarlos. Guarda la resolución para la Fase 6.

---

Archivos de Referencia

• references/retro-formats.md — Formatos alternativos: 4Ls, Start/Stop/Continue, Mad/Sad/Glad, Sailboat. Leer cuando el usuario solicite un formato diferente o cuando la variedad sea más útil para la sesión que el WWW predeterminado.
• references/action-item-types.md — Guía detallada sobre actualización de skill vs. Claude.md vs. nota de proceso vs. nueva skill. Leer cuando el tipo de un elemento de acción sea ambiguo.

---

Registro de Cambios

Versión	Fecha	Cambio
v1.0	2026-05-26	Versión inicial — flujo de trabajo completo de retrospectiva, estructura de 6 fases, versionado de copia primero, plantilla de informe de retrospectiva
v1.1	2026-05-26	Añadida la Fase 0 de configuración del directorio de archivo (configuración única guardada en Claude.md), guardado obligatorio de instantánea de retrospectiva, registro de auditoría continuo (retro-log.md) con seguimiento de resultados por retrospectiva
v1.2	2026-05-26	Añadida la actualización de proyecto/sesión como un tipo de elemento de acción distinto — cubre CLAUDE.md del proyecto, configuración de sesión de Cowork, archivos de resumen del cliente, e Instrucciones personalizadas de Claude.ai; aclarada la distinción de alcance con Claude.md a nivel de usuario
v1.3	2026-05-29	Migrada a estructura de plugin (skills/retro-bot/SKILL.md), añadido .claude-plugin/plugin.json para compatibilidad con Claude Code