gonzalezpazmonica/wellbeing-guardian

Skill: Wellbeing Guardian

Regla: @docs/rules/domain/wellbeing-config.md Perfiles: @.claude/profiles/users/{slug}/workflow.md + preferences.md

Prerequisitos

• Perfil de usuario con campos wellbeing configurados en workflow.md
• Timezone definido en preferences.md

Flujo: Inicio de sesión

1. Leer workflow.md → extraer work_hours_start, work_hours_end, break_strategy
2. Leer preferences.md → extraer timezone
3. Calcular hora local actual
4. Si fuera de horario → nudge "Fuera de horario" (una vez)
5. Si fin de semana y silence_weekends → nudge "Fin de semana" (una vez)
6. Calcular próximo break según estrategia:
   • pomodoro: 25min desde inicio sesión
   • 52-17: 52min desde inicio sesión
   • 5-50: 50min desde inicio sesión
   • custom: custom_focus_min desde inicio sesión
7. Retornar contexto compacto (~25 tokens): ⏱️ Horario: {start}-{end} {tz} | Break: {strategy} {focus}/{break} | Próximo: tras {N}min

Flujo: Check periódico

Durante la conversación, verificar periódicamente (máximo cada 25min):

1. Calcular tiempo transcurrido desde último break o inicio
2. Si elapsed ≥ duración_foco de la estrategia:
   • Insertar nudge "Break debido" al final de la respuesta actual
   • Tono amable, nunca imperativo
3. Si hora_actual > work_hours_end (primera vez):
   • Insertar nudge "Fuera de horario"
   • No repetir salvo que el usuario pida continuar explícitamente
4. Si hora_actual entre lunch_break:
   • Sugerir pausa para comer si el usuario sigue activo

Reglas:

• Máximo 1 nudge por interacción — no saturar
• Escalado: si usuario ignora 3 nudges → reducir a 1 cada 45min
• Reset: /wellbeing-guardian pause resetea el contador

Flujo: Configure

1. Preguntar horario laboral:
   • "¿A qué hora empiezas normalmente?" → work_hours_start
   • "¿A qué hora terminas?" → work_hours_end
   • "¿Tienes franja de comida?" → lunch_break
   • "¿Algún horario de conciliación?" → conciliation
2. Presentar estrategias con tabla comparativa (de wellbeing-config.md)
3. Dejar que el usuario elija o configure custom
4. Preguntar umbrales: max_daily_hours, silence_weekends
5. Persistir todo en workflow.md (preservar campos existentes)
6. Confirmar: "✅ Wellbeing Guardian configurado. Tu estrategia: {strategy}"

Flujo: Status

1. Leer configuración actual de workflow.md
2. Calcular tiempo de sesión actual
3. Calcular breaks tomados (del contexto de sesión)
4. Mostrar:

   ⏱️ Sesión actual: {elapsed}min
   🎯 Estrategia: {strategy} ({focus}min foco / {break}min descanso)
   📊 Breaks hoy: {count} de {expected} esperados
   ⏭️ Próximo descanso: en {remaining}min
   🟩🟩🟩⬜⬜ Progreso hacia próximo break
   

Flujo: Pause

1. Registrar momento de pausa
2. Si --reason proporcionado → categorizar (work, personal, hydration, focus-break)
3. Mostrar nudge "Post-descanso" cuando el usuario vuelva
4. Resetear contador de foco

Flujo: Breaks (historial)

1. Mostrar breaks registrados en la sesión actual
2. Si --week: agregar breaks de la semana (si hay log persistente)
3. Formato tabla: hora, duración, razón
4. Calcular break_compliance_score: (tomados / esperados) × 100

Flujo: Report

1. Leer historial de sesiones (contexto actual + log si existe)
2. Calcular métricas:
   • Horas totales de trabajo
   • Breaks tomados vs esperados (compliance %)
   • Tiempo medio de foco continuo
   • Incidencias fuera de horario
3. Generar break_compliance_score para burnout-radar
4. Presentar resumen + 1-2 recomendaciones personalizadas
5. Si compliance < 60% → sugerir estrategia alternativa

Errores

| Error | Acción | |-------|--------| | Perfil sin wellbeing config | Sugerir /wellbeing-guardian configure | | Timezone no definido | Pedir timezone o asumir UTC | | Estrategia desconocida | Fallback a pomodoro | | Sin historial de breaks | Mostrar solo sesión actual |

Seguridad

• NUNCA registrar contenido de trabajo en logs de bienestar
• Datos de horario → perfil local, nunca en commits públicos
• Respetar silence_weekends sin excepciones
• No enviar datos de bienestar a sistemas externos