Files
claude-plugins/gestao/skills/today/SKILL.md
T
ealmeida b6690a75fd feat(today): v11.0 — migração para cron local desktop (CT 102 eliminado)
- Remove SSH dev, todos os logs lidos localmente em /media/ealmeida/Dados/Dev/claude_automations_dev/
- Actualiza descrição, arquitectura e tabela de agentes
- Adiciona weekly-digest-podcast, improvement-evaluator, gitea-ci-cleaner
- Remove referência ao ct-backup-unlock-watchdog (CT 102 eliminado)
2026-04-20 13:28:44 +01:00

9.7 KiB

name, description, context
name description context
today Checkup diário - dashboard agregador que lê resultados dos agentes cron locais (desktop) e recolhe dados frescos via skills interactivas. Usar quando "checkup", "hoje", "today", "rotina", início de dia. fork

/today v11.0 - Checkup Diario (Agregador)

Le resultados dos agentes cron locais (desktop, crontab ealmeida) + invoca skills interactivas. Nao duplica trabalho automatizado.

Nota migração (20-04-2026): CT 102 eliminado. Todos os agentes migrados para crontab local em /media/ealmeida/Dados/Dev/claude_automations_dev/. SSH "dev" descontinuado.


Arquitectura

CRON (desktop local, crontab ealmeida)    /today (interactivo, sob pedido)
├── imap-triage     (4h)                   ├── Le logs locais do cron
├── auto-expense    (4h +15min)            ├── /daily-digest (dados frescos)
├── ticket-triage   (4h +30min)            ├── /tasks-overview (dados frescos)
├── aiktop-tasks    (15min)                ├── /cleanup-downloads (se necessario)
├── infra-check     (diario 7h)            ├── Specs/Sprints scan
├── wp-update       (segunda 23h)          ├── Rotinas especiais por dia
├── intelligence-*  (researcher/scorer/    └── Dashboard + Obsidian + Supabase
│                    selector/publisher)
└── weekly-digest-podcast (quinta 20h)

Regra Fundamental

Fases 1-2 sao silenciosas. Executar tudo antes de mostrar output. O utilizador so ve o dashboard final.


Protocolo

Fase 0: Verificacoes

1. mcp__mcp-time__current_time -> data, dia da semana
2. mcp__memory-supabase__search_memories("today checkup YYYY-MM-DD")
   -> Se ja existe hoje: perguntar se quer re-executar

Fase 1: Ler resultados dos agentes cron (silencioso)

3. Ler logs LOCAIS (Bash tail — sem SSH, tudo corre no desktop):

   Base: /media/ealmeida/Dados/Dev/claude_automations_dev/

   a) IMAP (ultimo report):
      tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/imap-triage/imap-triage.log
      cat ~/.claude-work/today-imap-DD-MM-YYYY.json (se existir)

   b) Ticket triage (ultimo log):
      tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/ticket-triage/ticket-triage.log

   c) Auto-expense (ultimo log):
      tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/auto-expense/auto-expense.log

   d) Infra check (ultimo log):
      tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/infra-check/infra-check.log

   e) AikTop tasks (ultimo log):
      tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/aiktop-tasks/aiktop-tasks.log

   f) SE segunda — wp-update (ultimo log):
      tail -50 /media/ealmeida/Dados/Dev/claude_automations_dev/wp-update/wp-update.log

   g) Intelligence pipeline:
      tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/daily-selector/daily-selector.log
      tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-publisher/intelligence-publisher.log
      tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-researcher/intelligence-researcher.log
      tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-scorer/intelligence-scorer.log

   h) HEARTBEAT WP — ultimo post em descomplicar.pt categoria 1188 (noticias):
      mcp__ssh-unified__ssh_execute(server="server", command="cd /home/ealmeida/public_html && wp post list --post_type=post --category=1188 --posts_per_page=1 --fields=ID,post_title,post_date --format=csv --allow-root 2>&1 | tail -2")
      -> Calcular idade do ultimo post
      -> Se >26h sem post novo: ALERTA "Requer Atencao Urgente" + contexto:
         * Pipeline deveria publicar ate 5 noticias/dia (selector 06:30 + slots 09/11/13/15:30/17:30)
         * Verificar logs daily-selector + publisher (passo g)
         * Stock Supabase: scored>=7 count via curl REST
         * Verificar se desktop teve downtime (uptime / journalctl) — agentes correm no desktop local

4. DETECTAR PROBLEMAS nos logs:
   - Cron nao correu (log desactualizado >8h)
   - Exit codes != 0
   - Erros ou falhas nos logs
   - HEARTBEAT WP >26h sem post novo em cat 1188
   -> Adicionar a seccao "Requer Atencao Urgente"

Fase 2: Recolha de dados frescos (silencioso)

5. Invocar /daily-digest
   -> Timer, tickets, facturas, leads, propostas, agenda
   -> Output: dashboard markdown

6. Invocar /tasks-overview
   -> Tarefas overdue, pendentes, em curso, workflows sugeridos
   -> Output: tarefas markdown

7. SE >10 ficheiros em ~/Transferencias:
   -> Invocar /cleanup-downloads

Fase 2b: Sprint/Spec Activos (silencioso)

8. Glob: /media/ealmeida/Dados/Dev/**/SPEC.md (profundidade max 3)
   -> Para cada encontrado: Ler frontmatter (15 linhas)
   -> Filtrar: status != "completed"
   -> Extrair: titulo (linha # SPEC:), status, weight, scope done/total

9. Glob: /media/ealmeida/Dados/Dev/**/SPRINT.md
   -> Para cada encontrado: Ler frontmatter
   -> Filtrar: status == "active"
   -> Extrair: sprint_id, tasks done/total, checkpoint_done, end_date

Fase 2c: Rotinas Especiais

10. SE SEGUNDA:
    -> Planeamento semanal (tarefas da semana + capacidade)

11. SE SEXTA:
    -> Sugerir manutencao e revisao semanal

Fase 3: Output Final

12. AGREGAR resultados de cron + skills:
    - Logs do cron (Fase 1)
    - Dados frescos do /daily-digest e /tasks-overview (Fase 2)
    - Specs/Sprints (Fase 2b)

13. DASHBOARD ao utilizador (formato abaixo)

14. CRIAR NOTA OBSIDIAN:
    Path: /media/ealmeida/Dados/Hub/00-Inbox/DD-MM-YYYY-checkup.md
    Conteudo: dashboard completo

15. GUARDAR em Supabase:
    mcp__memory-supabase__save_memory({
      content: "Checkup diario - X tickets, Y tarefas, Z urgentes, cron OK/FALHA",
      tags: ["today", "checkup", "DD-MM-YYYY"]
    })

Formato Dashboard

## Checkup Diario - DD-MM-YYYY (Dia-da-Semana)

---

## Requer Atencao Urgente
[Alertas: cron falhado, erros infra, seguranca, notificacoes criticas]

---

## 3 Prioridades Hoje
1. [ ] [Mais urgente]
2. [ ] [Segunda]
3. [ ] [Terceira]

---

## Workflows Sugeridos
[Do /tasks-overview]

---

## Sprint / Spec Activos
[Projectos com spec/sprint activo: nome, progresso, checkpoint]
[Se nenhum: "Nenhum sprint/spec activo"]

---

## Resumo do Dia
[Do /daily-digest: timer, tickets, facturas, tarefas, leads, agenda]

---

## Agentes Cron (desktop local)

| Agente | Ultima execucao | Status | Resumo |
|--------|----------------|--------|--------|
| imap-triage | HH:MM | OK/FALHA | X contas, Y emails |
| auto-expense | HH:MM | OK/SKIP | Z despesas criadas |
| ticket-triage | HH:MM | OK/FALHA | W tickets processados |
| aiktop-tasks | HH:MM | OK/FALHA | N tarefas executadas |
| infra-check | HH:MM | OK/FALHA | X/4 MCPs operacionais |
| wp-update [se seg] | HH:MM | OK/FALHA | X/16 sites actualizados |

---

## Auto-Processamento (ultimas 24h)
[Resumo agregado: despesas criadas, tickets fechados, emails limpos]

Nota Obsidian

---
title: Checkup DD-MM-YYYY
date: DD-MM-YYYY
type: checkup
status: active
---

Filename: DD-MM-YYYY-checkup.md (Regra #45: formato DD-MM-YYYY)


Anti-Patterns

  • NUNCA invocar /ticket-triage, /imap-triage, /auto-expense, /infra-check, /wp-update (correm no cron)
  • NUNCA mostrar output antes de terminar Fase 1 e 2
  • NUNCA mostrar mais de 3 prioridades (PHDA)
  • NUNCA executar sem verificar data/hora primeiro
  • SEMPRE ler logs do cron antes de mostrar dashboard
  • SEMPRE alertar se algum agente cron nao correu nas ultimas 8h

Referencia

Componente Tipo Responsabilidade
imap-triage Cron desktop (*/4h) Triagem IMAP 13 contas + dedup Supabase
auto-expense Cron desktop (15 */4h) Criacao automatica de despesas
ticket-triage Cron desktop (30 */4h) Auto-process tickets (SPAM, facturas)
aiktop-tasks Cron desktop (*/15min) Executa tarefas AikTop do Desk CRM
infra-check Cron desktop (07h) Health check gateway + MCPs
wp-update Cron desktop (seg 23h) Actualizacoes WordPress 16 sites
weekly-digest-podcast Cron desktop (quinta 20h) Digest semanal para podcast
improvement-evaluator Cron desktop (*/30min) Avaliador de melhorias (HTTP @reboot)
gitea-ci-cleaner Cron desktop (45 */4h) Limpeza de runs CI Gitea
daily-selector Cron desktop (06:30) Selector ate 5 noticias/dia diversas → status=scheduled
intelligence-publisher Cron desktop (5 slots 09/11/13/15:30/17:30) Publica slots scheduled em descomplicar.pt
intelligence-researcher Cron desktop (9/14/20) Fetch 214 RSS → Supabase
intelligence-scorer Cron desktop (0/30 min) Score OpenRouter gpt-oss-20b
HEARTBEAT WP Check ao vivo wp post list cat=1188 → idade do ultimo post. Alerta se >26h
/daily-digest Skill (interactivo) Timer, tickets, facturas, leads, agenda
/tasks-overview Skill (interactivo) Tarefas pendentes/overdue + workflows
/cleanup-downloads Skill (interactivo) Limpeza pasta Transferencias
/spec + /sprint Scan local Specs e sprints activos

Repo agentes: git.descomplicar.pt/ealmeida/claude_automations_dev


Self-Healing

Antes de executar, ler ~/.claude-work/healing/today.jsonl (se existir). Cada linha é um padrão de erro conhecido:

{"date":"YYYY-MM-DD","issue":"descrição do problema","fix":"como evitar","source":"user|auto"}

Se encontrares um padrão relevante ao contexto actual, aplica o fix preventivamente. Após cada erro ou correcção do utilizador nesta skill, adicionar nova linha ao healing log com o padrão aprendido.


Skill v11.0.0 | 20-04-2026 | Descomplicar® — CT 102 eliminado, cron 100% local desktop

Healing Log