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
- Leer
workflow.md→ extraer work_hours_start, work_hours_end, break_strategy - Leer
preferences.md→ extraer timezone - Calcular hora local actual
- Si fuera de horario → nudge "Fuera de horario" (una vez)
- Si fin de semana y silence_weekends → nudge "Fin de semana" (una vez)
- 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
- 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):
- Calcular tiempo transcurrido desde último break o inicio
- Si elapsed ≥ duración_foco de la estrategia:
- Insertar nudge "Break debido" al final de la respuesta actual
- Tono amable, nunca imperativo
- Si hora_actual > work_hours_end (primera vez):
- Insertar nudge "Fuera de horario"
- No repetir salvo que el usuario pida continuar explícitamente
- 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 pauseresetea el contador
Flujo: Configure
- 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
- Presentar estrategias con tabla comparativa (de wellbeing-config.md)
- Dejar que el usuario elija o configure custom
- Preguntar umbrales: max_daily_hours, silence_weekends
- Persistir todo en workflow.md (preservar campos existentes)
- Confirmar: "✅ Wellbeing Guardian configurado. Tu estrategia: {strategy}"
Flujo: Status
- Leer configuración actual de workflow.md
- Calcular tiempo de sesión actual
- Calcular breaks tomados (del contexto de sesión)
- 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
- Registrar momento de pausa
- Si --reason proporcionado → categorizar (work, personal, hydration, focus-break)
- Mostrar nudge "Post-descanso" cuando el usuario vuelva
- Resetear contador de foco
Flujo: Breaks (historial)
- Mostrar breaks registrados en la sesión actual
- Si --week: agregar breaks de la semana (si hay log persistente)
- Formato tabla: hora, duración, razón
- Calcular break_compliance_score: (tomados / esperados) × 100
Flujo: Report
- Leer historial de sesiones (contexto actual + log si existe)
- Calcular métricas:
- Horas totales de trabajo
- Breaks tomados vs esperados (compliance %)
- Tiempo medio de foco continuo
- Incidencias fuera de horario
- Generar break_compliance_score para burnout-radar
- Presentar resumen + 1-2 recomendaciones personalizadas
- 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_weekendssin excepciones - No enviar datos de bienestar a sistemas externos