claude-plugins/gestao/skills/today/SKILL.md

name, description, author, version, quality_score, user_invocable, category, tags, desk_task, desk_project, allowed-tools, mcps, dependencies

name	description	author	version	quality_score	user_invocable	category	tags	desk_task	desk_project	allowed-tools	mcps	dependencies
today	Checkup diário v7.5 - IMAP triaging, auto-despesas, Obsidian note, Supabase. Triagem emails 12 contas IMAP + tickets CRM + despesas auto + nota diaria. Use when "checkup", "hoje", "today", "rotina", início de dia.	Descomplicar® Crescimento Digital	7.5.0	92	true	productivity	rotina checkup dashboard crm tickets invoices timer monday saturday imap email	1416	65	Read, Write, mcp__desk-crm-v3, mcp__mcp-time, mcp__google-workspace, mcp__imap, mcp__memory-supabase	desk-crm-v3, mcp-time, google-workspace, imap, memory-supabase	skills ticket invoice time crm wp-update cleanup-downloads

/today v7.5 - Checkup Diário

Hub central que orquestra skills Desk + IMAP para visao completa do dia.

---

Protocolo Principal

REGRA FUNDAMENTAL: Fases 1-2 sao SILENCIOSAS e OBRIGATORIAS. Executar TUDO antes de mostrar qualquer output ao utilizador. O utilizador so ve o resumo final com as accoes ja tomadas.

FASE 1 - SILENCIOSA (executar tudo, sem output)
  1. mcp__mcp-time__current_time → Verificar dia da semana
  2. Verificar ultima execucao (memory-supabase: "today checkup YYYY-MM-DD")
  3. AUTO-PROCESSAR despesas de tickets (ver seccao Auto-Process)
  4. AUTO-FECHAR Tickets SPAM
  5. IMAP Triagem - 12 contas (ver seccao IMAP abaixo)
  6. Limpeza Downloads (via /cleanup-downloads) → SE >10 ficheiros

FASE 2 - RECOLHA (queries em paralelo, sem output)
  7. Timer Activo
  8. Tickets abertos (status 1,2,3)
  9. Facturas Vencidas
  10. Tarefas Prioritarias (urgentes + alta + vencidas)
  11. Leads Novos (status 7, 14)
  12. Propostas pendentes (status 4)
  13. Agenda do Dia (Google Calendar)

FASE 3 - OUTPUT + PERSISTENCIA
  14. Resumo do auto-processamento (despesas, SPAM, emails)
  15. Notificacoes de sistema que requerem revisao manual
  16. Dashboard (timer, tickets, facturas, tarefas, leads, agenda)
  17. 3 Prioridades do dia
  18. SE SEGUNDA → Planeamento semanal + /wp-update
  19. SE SEXTA → Sugerir manutencao WordPress
  20. SE SABADO → Consolidacao memorias
  21. Criar nota Obsidian (Passo 9)
  22. Guardar em Supabase (Passo 10)

---

Secções do Checkup

1. Timer Activo

Verificar ~/.claude-work/active-timer.json
Se activo:
  🟢 Timer: #1446 - Documentação (2h 15m)
  ⚠️ Se >4h: "Timer activo há muito tempo!"

2. Tickets Abertos

mcp__desk-crm-v3__get_tickets({ status: [1,2,3] })

## 🎫 Tickets (4)
🔴 #234 - Erro login (TechCorp) - 2h
🟠 #232 - Bug funcionalidade (StartupX) - 1d
🟢 #230 - Dúvida (ClienteY) - 2d

3. Facturas Vencidas

mcp__desk-crm-v3__overdue_invoices_report()

## 💰 Facturas Vencidas (2)
| # | Cliente | Valor | Dias |
|---|---------|-------|------|
| INV-040 | OldClient | €950 | 15 |
| INV-038 | SlowPay | €2.100 | 22 |
**Total:** €3.050

4. Tarefas Prioritárias

mcp__desk-crm-v3__get_tasks({ status: [1,4], priority: [3,4] })

## 📋 Tarefas Prioritárias (5)
🔴 Urgentes
| # | Tarefa | Projecto | Deadline |
|---|--------|----------|----------|
| #1450 | Implementar API | SFV-360 | Hoje |

🟠 Alta
| # | Tarefa | Projecto | Deadline |
|---|--------|----------|----------|
| #1448 | Documentação | Stack | Amanhã |

5. Agenda do Dia

mcp__google-workspace__get_events({
  user_google_email: "emanuelalmeidaa@gmail.com",
  time_min: "hoje 00:00",
  time_max: "hoje 23:59"
})

## 📅 Agenda Hoje
- 10:00 - Reunião Cliente X
- 14:30 - Call Equipa

---

IMAP Triagem (FASE 1 - Passo 5)

OBRIGATORIO: Processar 12 contas IMAP silenciosamente. Ver regras detalhadas em config/email-triage-rules.md

Contas IMAP (12)

emanuel, it, help, suporte, contabilidade, financeiro,
info, rh, mkt, design, news, aiktop

Para cada conta: imap_list_emails(account, folder="INBOX", limit=50)

Classificar cada email por ordem de prioridade:

1. SPAM → imap_delete_email(account, uid)
   - Subject: lottery, winner, urgent money, bitcoin investment
   - Remetente: *.ru, *.cn (excepto conhecidos)
   - Subject todo em MAIUSCULAS

2. PROMOCIONAL → imap_move_email(account, uid, "Promotions")
   - Subject: newsletter, promo, desconto, oferta
   - Remetente: *@marketing.*, *@news.*, *@promo.*

3. FACTURA/RECIBO → Registar para contabilidade
   - Subject: factura, invoice, recibo, receipt, pagamento, paid
   - Remetente de servico conhecido (ver mapeamento abaixo)
   - Registar para reencaminhar para contabilidade@descomplicar.pt

4. PRIORITARIO → Incluir no relatorio
   - Remetente: cliente conhecido (verificar DeskCRM)
   - Subject: urgente, problema, erro, critical, down
   - Threads activas (RE:, FW:)

Resumo IMAP no output

📧 Emails Processados
- X spam eliminados
- Y promocionais arquivados
- Z facturas para contabilidade
- W emails prioritarios pendentes

Excepcoes (NUNCA processar automaticamente)

- *@descomplicar.pt (internos)
- *@gov.pt, *@at.gov.pt, *@seg-social.pt (governo)
- *@tribunais.org.pt (tribunais)

---

Rotinas Semanais

Segunda-feira

1. Checkup normal (acima)
2. Planeamento semanal:
   - Todas as tarefas com deadline esta semana
   - Capacidade vs carga
   - Distribuicao por dia
   - Verificar estimativas de tempo (set_task_estimated_time se em falta)
3. Invocar /wp-update

Sexta-feira

1. Checkup normal (acima)
2. Sugerir manutencao WordPress:
   - Listar os 10 sites da rede
   - Oferecer checkup de seguranca

Sabado

1. Checkup normal (acima)
2. Consolidacao de memorias:
   - Listar ~/.claude/projects/*/memory/MEMORY.md
   - Extrair "Padroes Descobertos" e "Solucoes"
   - Comentario na discussao #46 (Memorias)
   - Backup em memory-supabase

---

Persistencia (FASE 3 - Passos 21-22)

Passo 21: Nota Obsidian

Path: /media/ealmeida/Dados/GDrive/Cloud/EAL/Planeamento/00-Inbox/
Filename: YYYY-MM-DD-checkup.md

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

## Checkup Diario - YYYY-MM-DD
[Conteudo do relatorio com links CRM]

Passo 22: Supabase

mcp__memory-supabase__save_memory:
- content: "Checkup diario - X tickets, Y tarefas, Z urgentes, W emails"
- tags: ["today", "checkup", "YYYY-MM-DD"]
- metadata: { tickets, tasks, urgent, emails_processed, is_monday }

---

Output Final

## Checkup Diario - 2026-02-06 (Quinta)

### Timer
#1446 - Documentacao (2h 15m)

### Emails (IMAP)
- Spam eliminado: 5
- Promocional arquivado: 3
- Facturas contabilidade: 2
- Prioritarios: 1

### Tickets
- Abertos: 4 (1 urgente)

### Facturas
- Vencidas: 3.050EUR

### Tarefas
- Urgentes: 1
- Alta prioridade: 4

### Leads + Propostas
- Leads novos: 2
- Propostas pendentes: 1

### Agenda
- 10:00 - Reuniao Cliente X
- 14:30 - Call Equipa

---

### 3 Prioridades Hoje
1. [ ] #1450 - Implementar API (Urgente)
2. [ ] Contactar OldClient (factura 15 dias)
3. [ ] #1448 - Documentacao Stack

---

Auto-Process Tickets (FASE 1 - OBRIGATÓRIO)

EXECUTAR SILENCIOSAMENTE ANTES DE QUALQUER OUTPUT. Nao perguntar, nao mostrar preview. Processar e reportar no resumo final.

Passo 1: Recolher tickets abertos (status 1) de TODOS os departamentos

get_tickets({ status: 1, limit: 50 })

Passo 2: Classificar cada ticket

Para cada ticket aberto, aplicar por ordem de prioridade:

1. NOTIFICAÇÃO SISTEMA? (verificar PRIMEIRO)
   → Subject contem padrao protegido E remetente conhecido
   → NAO fechar. Guardar para "Requer Accao" no resumo.

2. DESPESA? (verificar SEGUNDO)
   → Email do remetente contem padrao de fornecedor conhecido (ver mapeamento)
   → Processar como despesa (ver passos abaixo)

3. SPAM? (verificar TERCEIRO)
   → Subject contem padrao SPAM
   → Fechar (status 5) com motivo

4. NEWSLETTER/INFORMATIVO?
   → Newsletters, updates de produtos, notificacoes genericas
   → Fechar (status 5) com motivo

5. NENHUM MATCH → Manter aberto para revisao

Passo 3: Processar Despesas

DADOS ESTAO NO HTML. A maioria dos fornecedores (Anthropic, Canva, Elastic Email) envia os dados no corpo do email, NAO como PDF anexo. Extrair valor, referencia e data do HTML do ticket.

Para cada ticket identificado como despesa:
  1. get_ticket(ticket_id) → ler HTML completo
  2. Extrair do HTML: valor, invoice/reference number, data, descricao
  3. Mapear email → categoria (tabela abaixo)
  4. create_expense(category_id, amount, date, note, reference, currency=2, tax)
  5. Fechar ticket (status 5) com "Despesa #ID criada"
  6. SE existe ticket duplicado (mesmo subject) → fechar duplicado tambem

Padroes SPAM (Fechar status 5)

Guest Post, SEO services, backlinks, partnership,
Purchase Order, WeTransfer, Prestige Awards

Notificacoes de Sistema (NUNCA auto-fechar)

Padroes protegidos (subject - case insensitive):

Legal Update, Legal Notice, Policy Change, Policy Update,
Deprecation, End of Life, EOL, Breaking Change,
Migration Required, Action Required, Action Needed,
Security Alert, Security Advisory, Security Notice,
API Change, API Update, Terms Update, Terms Change,
Service Disruption, Maintenance Required,
Compliance, GDPR, Data Processing, Data Processor,
Infrastructure Change, Platform Update, Product Update

Mapeamento Fornecedor → Categoria

Verificar pelo dominio do email do remetente, nao pelo departamento. Tickets de fornecedores conhecidos podem estar em QUALQUER departamento.

Padrao no Email	Categoria	ID	Tax
anthropic	Servicos IA e APIs	38	0
openai	Servicos IA e APIs	38	0
hetzner	Alojamento de Servidores	10	0
meo, meoempresas	Telecomunicacoes	1	1
centos-webpanel, cwp	Licencas Software	28	0
elasticemail	E-mail MKT	5	0
freepik, envato, canva	Plugins e Recursos de Design	9	0
moloni	Software Facturacao	11	1
everhour	Softwares Gestao	12	0
ptisp, namecheap	Registo de Dominios	13	0
vimeo	Plataformas Armazenamento	19	0
payproglobal	Servicos IA e APIs (CapSolver)	38	0
bdthemes	Plugins e Recursos de Design	9	0
staples, multipapel	Material Escritorio	15	1

Tickets a Saltar (NAO criar despesa)

Tipo	Indicador	Accao
Payment Confirmation	"Payment Confirmation" de CWP/centos-webpanel	Fechar (confirmacao pagamento, nao fatura)
Payment Receipt	"Payment Was Successfully Processed" de elasticemail	Fechar (recibo pagamento recorrente sem dados de fatura)
Notificacao bancaria	"Notificação de transferência" de bancobpi	Fechar (notificacao, nao fatura)
Duplicado	reference_no ja existe no CRM	Fechar (ja processado)
Ticket duplicado	Mesmo subject que outro ticket ja processado	Fechar como duplicado

NOTA: Receipts de Anthropic e Canva contem invoice number e valor → SAO despesas. "Receipt" so e motivo para saltar quando e apenas confirmacao de pagamento sem dados de fatura.

Campos Criticos

currency = 2 (EUR) → SEMPRE
tax = 1 → Fornecedores PT (MEO, Moloni, Staples)
tax = 0 → Fornecedores estrangeiros (Anthropic, Canva, Hetzner, etc.)

---

Referência de Skills

Secção	Skill	Comando
Timer	/time	/time
Tickets	/ticket	/ticket
Facturas	/invoice	/invoice overdue
Tarefas/Leads	/crm	/crm
Downloads	/cleanup-downloads	SE >10 ficheiros
WordPress	/wp-update	Segundas

---

Anti-Patterns

• NUNCA executar checkup sem verificar data/hora
• NUNCA duplicar logica de outras skills
• NUNCA mostrar mais de 3 prioridades (PHDA)
• NUNCA mostrar resumo ANTES de processar despesas e SPAM
• NUNCA perguntar ao utilizador se deve processar despesas (e automatico)
• NUNCA assumir que so dept 3 tem tickets de contabilidade (verificar email do remetente)
• NUNCA saltar receipt que contem invoice number e valor (e despesa)

---

Changelog

v7.5.0 (2026-02-06)

• IMAP TRIAGEM: Protocolo completo para 12 contas IMAP (spam, promo, facturas, prioritarios)
• NOTA OBSIDIAN: Criar nota diaria em /media/ealmeida/Dados/GDrive/Cloud/EAL/Planeamento/00-Inbox/
• SUPABASE SAVE: Guardar resumo checkup em memory-supabase com metricas
• LEADS + PROPOSTAS: Adicionar verificacao de leads novos e propostas pendentes na Fase 2
• SEXTA-FEIRA: Rotina de manutencao WordPress sugerida as sextas
• VERIFICAR EXECUCAO: Passo 2 verifica ultima execucao via memory-supabase
• EXCEPCOES IMAP: Dominos gov.pt, at.gov.pt, tribunais nunca processados automaticamente
• BUG FIX: Corrigido MCP IMAP (seq.fetch→fetch para operacoes UID-based)

v7.4.0 (2026-02-06)

• Protocolo 3 fases, scan todos departamentos, HTML fonte dados, mapeamento expandido

v7.3.0 (2026-02-05)

• Notificacoes de sistema protegidas

v7.2.0 (2026-02-05)

• Auto-despesas contabilidade (dept 3)

v7.1.0 (2026-02-05)

• Integracao com skills Desk

---

Skill v7.5.0 | 2026-02-06 | Descomplicar®