| name | weekly-retro |
| version | 0.2.0 |
| description | Cadencia de retro semanal (P12): captura que ayudo, que friccion hubo, y promueve aprendizajes recurrentes a reglas persistentes. |
| owner | JM Labs |
| last_updated | "2026-06-11T00:00:00.000Z" |
| triggers | ["weekly-retro","retro-semanal"] |
| allowed-tools | ["Read","Write","Edit","Bash"] |
Weekly Retro
Ritual semanal de cierre: convierte la experiencia de la semana en mejoras
accionables y, cuando un patron se repite, en una regla persistente (la
promocion P12). No es un journal libre — produce un artefacto estructurado y,
condicionalmente, un cambio en la memoria operativa. [DOC]
When to use / not use
- Use: cierre de semana o de sprint; al detectar friccion repetida; cuando
quieras consolidar un aprendizaje en regla antes de que se pierda. [DOC]
- No uses: post-mortem de un incidente puntual (usa el flujo de incidentes);
retro de equipo multi-persona con facilitacion (esto es cadencia personal de
operador). [INFERENCIA]
Inputs
- Ventana: rango de la semana/sprite a revisar (default: ultimos 7 dias). [AUTOCOMPLETADO]
- Fuentes de evidencia: TAREAS.md / tasklog, changelog, hilos relevantes,
commits. Sin al menos una fuente verificable, marca
{VACIO_CRITICO} y pide. [DOC]
- Memoria destino: ruta del archivo de reglas/MEMORY donde aterriza una
promocion P12 (si el operador quiere promover). [SUPUESTO]
Outputs
- Bloque de retro estructurado: Ayudo / Friccion / Regla candidata, cada
item con su tag de evidencia. [DOC]
- Lista de acciones para la proxima semana (owner implicito = operador). [DOC]
- 0..n promociones P12: regla redactada + ruta destino, aplicada solo tras
confirmacion explicita del operador. [SUPUESTO]
Procedure
1. Discover
Define la ventana y abre las fuentes de evidencia (tasklog, changelog, hilos).
Si no hay ninguna fuente leible, detente con {VACIO_CRITICO}. [DOC]
2. Analyze — los tres ejes (P12)
- Que ayudo: que practica/herramienta/decision aceleró el trabajo. Cita la
fuente (
{EXTRAIDO_HILO}, {MEMORIA}, commit). [DOC]
- Que friccion: que costo tiempo o causó retrabajo. Distingue ruido de una
semana (no promover) de patron recurrente (candidato a regla). [INFERENCIA]
- Que se vuelve regla: solo asciende friccion vista >=2 veces o un acierto
que quieras volver default. Redacta la regla en imperativo, una linea. [INFERENCIA]
3. Execute
Escribe el bloque de retro. Para cada regla candidata, presenta el diff exacto
sobre el archivo de memoria destino y espera confirmacion antes de aplicar
(Write/Edit). Nunca promuevas en automatico. [SUPUESTO]
4. Validate
Corre el gate de abajo antes de cerrar. [DOC]
Validation gate (acceptance criteria)
Cierra solo si TODO se cumple — mapea a los checks de evals.json
(evidence, quality_criteria, upgrade_safety). El guardian verifica contra
assets/quality-rubric.json y assets/checklist.md (ver assets/README.md): [CONFIG]
Edge cases
- Sin evidencia legible →
{VACIO_CRITICO}, pide la fuente, no inventes la
semana. [DOC]
- Semana vacia / sin friccion → retro valido y corto; registra "sin patron
nuevo" y omite promocion. No fuerces una regla. [INFERENCIA]
- Friccion vista una sola vez → registrala como observacion, no la
asciendas a regla todavia. [INFERENCIA]
- Regla candidata contradice una regla ya en memoria → no sobrescribas;
expón el conflicto y pide al operador resolver. [SUPUESTO]
- Operador rechaza la promocion → conserva la observacion en el bloque de
retro para la proxima ventana. [INFERENCIA]
Anti-patterns
- Promover en automatico sin confirmacion (rompe
upgrade_safety). [CONFIG]
- Ascender ruido de una sola semana a regla (inflación de reglas). [INFERENCIA]
- Retro como prosa sin los tres ejes ni tags de evidencia. [DOC]
- Mezclar familias de tags (Jarvis vs Alfa) en el mismo bloque. [DOC]
Self-correction triggers
- Escribiste una regla pero no mostraste el diff destino → vuelve al paso 3. [INFERENCIA]
- Un item de Friccion no tiene fuente citable → degradalo a observacion o
marcalo
{POR_CONFIRMAR} con su verificacion. [DOC]
- La retro no produjo ni accion ni regla → revisa: ¿faltó leer una fuente? [INFERENCIA]
Evidence convention
Usa el set Jarvis OS (operador) de references/verification-tags.md:
{MEMORIA} {ADJUNTO} {EXTRAIDO_HILO} {WEB} {CONOCIMIENTO} {SUPUESTO}
{INFERENCIA} {AUTOCOMPLETADO} {POR_CONFIRMAR} {VACIO_CRITICO}. Una sola
familia por documento; un tag por claim; ante duda elige el mas debil. [DOC]
Assumptions and limits
- Cadencia personal de operador, no facilitacion de equipo. [SUPUESTO]
- No reemplaza revision experta en decisiones legales/medicas/financieras/
seguridad de alto riesgo. [DOC]
Related skills
workflow-forge — convierte una regla recurrente en flujo formal.quality-guardian — valida el gate de evidencia del bloque de retro.workspace-governance — gobierna donde aterrizan las promociones P12.
