# TEMPLATE: Retrospectiva
# Sistema: SIMCO - NEXUS v4.0
# Versión: 1.0.0
# Uso: Copiar a {proyecto}/orchestration/scrum/retrospectivas/RETRO-{YYYY-MM}.yml

# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════

retrospectiva:
  fecha: "{YYYY-MM-DD}"
  periodo: "{YYYY-MM}"                    # O "Sprint N" o "Épica X"
  proyecto: "{nombre_proyecto}"
  facilitador: "{quien lideró}"

# ═══════════════════════════════════════════════════════════════════════════════
# QUÉ FUNCIONÓ BIEN (Keep)
# ═══════════════════════════════════════════════════════════════════════════════

funcionó_bien:
  - categoria: "{proceso | tecnico | comunicacion | herramientas}"
    descripcion: "{qué funcionó}"
    impacto: "{por qué fue positivo}"
    mantener: true

  # Agregar más items...

# ═══════════════════════════════════════════════════════════════════════════════
# QUÉ NO FUNCIONÓ (Stop)
# ═══════════════════════════════════════════════════════════════════════════════

no_funcionó:
  - categoria: "{proceso | tecnico | comunicacion | herramientas}"
    descripcion: "{qué no funcionó}"
    impacto: "{qué consecuencias tuvo}"
    accion_propuesta: "{qué hacer diferente}"
    prioridad: alta | media | baja

  # Agregar más items...

# ═══════════════════════════════════════════════════════════════════════════════
# QUÉ PODEMOS MEJORAR (Try)
# ═══════════════════════════════════════════════════════════════════════════════

mejorar:
  - categoria: "{proceso | tecnico | comunicacion | herramientas}"
    descripcion: "{qué se puede mejorar}"
    propuesta: "{cómo mejorarlo}"
    esfuerzo: alto | medio | bajo
    impacto_esperado: alto | medio | bajo
    prioridad: alta | media | baja

  # Agregar más items...

# ═══════════════════════════════════════════════════════════════════════════════
# ANÁLISIS DE ERRORES DEL PERÍODO
# ═══════════════════════════════════════════════════════════════════════════════

errores:
  total_periodo: 0
  recurrentes: 0
  resueltos_definitivamente: 0

  patrones_identificados:
    - patron: "{descripción del patrón}"
      frecuencia: 0
      causa_comun: "{causa raíz}"
      accion_preventiva: "{qué hacer}"

  errores_destacados:
    - id: "ERR-XXX"
      aprendizaje: "{qué se aprendió}"

# ═══════════════════════════════════════════════════════════════════════════════
# MÉTRICAS DEL PERÍODO
# ═══════════════════════════════════════════════════════════════════════════════

metricas:
  tareas:
    completadas: 0
    planificadas: 0
    ratio: 0

  estimacion:
    desviacion_promedio: 0                # Porcentaje
    subestimadas: 0
    sobreestimadas: 0

  calidad:
    bugs_encontrados: 0
    bugs_en_produccion: 0
    tests_agregados: 0
    cobertura_delta: 0                    # Cambio en cobertura

  proceso:
    gates_fallidos: 0
    scope_creep_items: 0
    hus_derivadas: 0

# ═══════════════════════════════════════════════════════════════════════════════
# ACCIONES ACORDADAS
# ═══════════════════════════════════════════════════════════════════════════════

acciones:
  - id: "ACC-001"
    descripcion: "{acción específica}"
    categoria: "{proceso | tecnico | documentacion}"
    responsable: ""
    fecha_limite: ""
    estado: pendiente                     # pendiente | en_progreso | completada
    verificacion: "{cómo verificar que se hizo}"

  # Agregar más acciones...

# ═══════════════════════════════════════════════════════════════════════════════
# SEGUIMIENTO DE ACCIONES ANTERIORES
# ═══════════════════════════════════════════════════════════════════════════════

acciones_anteriores:
  - id: "ACC-XXX"
    de_retrospectiva: "{YYYY-MM}"
    descripcion: "{descripción}"
    estado: completada | en_progreso | cancelada
    resultado: "{qué pasó}"

# ═══════════════════════════════════════════════════════════════════════════════
# COMPROMISOS
# ═══════════════════════════════════════════════════════════════════════════════

compromisos:
  para_siguiente_periodo:
    - "{compromiso 1}"
    - "{compromiso 2}"

  experimentos:
    - descripcion: "{qué probar}"
      hipotesis: "{qué esperamos}"
      medicion: "{cómo medir éxito}"

# ═══════════════════════════════════════════════════════════════════════════════
# NOTAS ADICIONALES
# ═══════════════════════════════════════════════════════════════════════════════

notas: |
  # Notas libres de la retrospectiva

# ═══════════════════════════════════════════════════════════════════════════════
# CONTRIBUCIÓN A KNOWLEDGE BASE
# ═══════════════════════════════════════════════════════════════════════════════

contribucion_kb:
  lecciones_a_agregar:
    - descripcion: "{lección importante}"
      archivo: "lessons-learned/{nombre}.md"
      aplica_a: "todos | {proyecto específico}"

  patrones_identificados:
    - nombre: "{nombre del patrón}"
      archivo: "patterns/{nombre}.md"

  antipatrones:
    - nombre: "{antipatrón identificado}"
      archivo: "antipatterns/{nombre}.md"