Files

T

ealmeida 19f89e0d69 feat(gestao): adicionar skill /monday-briefing v1.0

Briefing semanal automatizado com 4 componentes:
1. Trend Researcher — tendências de mercado via WebSearch
2. Analytics Reporter — métricas Desk CRM + Moloni + Calendar
3. Growth Hacker — 1 acção concreta com 3 passos
4. Reality Checker — contra-argumentos e pressupostos

Suporta argumentos: terminal (default), inbox, email.
Agendável via /schedule segunda 9h.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-07 01:30:00 +01:00

7.3 KiB

Raw Permalink Blame History

name, description, context

name	description	context
monday-briefing	Briefing semanal automatizado com 4 componentes — tendências de mercado, métricas chave, acção da semana e contra-argumentos. Usar quando "monday", "briefing segunda", "resumo semanal", "briefing semana", "monday briefing".	fork

/monday-briefing v1.0

Briefing semanal com 4 perspectivas: tendências, métricas, acção e realidade.

Protocolo

Passo 1: Recolher data e período

mcp__mcp-time__current_time → data actual
Calcular:
  - semana_actual: Segunda a Domingo desta semana
  - semana_anterior: Segunda a Domingo da semana passada
  - periodo_atual: "Semana W{N} ({DD Mmm} – {DD Mmm YYYY})"

Passo 2: Recolher dados em paralelo

Executar TUDO em paralelo. Registar erros sem bloquear — continuar com dados disponíveis.

Em paralelo:

[A] DESK CRM — Métricas da semana
  mcp__desk-crm-v3__get_tasks({ date_from: inicio_semana_anterior, date_to: fim_semana_anterior, status: 5 })
  → tarefas_concluidas_semana_ant
  mcp__desk-crm-v3__get_tasks({ date_from: inicio_semana, date_to: fim_semana, status: [1,2,3] })
  → tarefas_abertas_semana_atual
  mcp__desk-crm-v3__get_timesheets({ date_from: inicio_semana_anterior, date_to: fim_semana_anterior })
  → horas_semana_ant
  mcp__desk-crm-v3__get_tickets({ status: [1,2,3] })
  → tickets_abertos

[B] MOLONI — Facturação da semana
  mcp__moloni-mcp__list_documents({
    document_type: "invoice",
    date_from: inicio_semana_anterior,
    date_to: fim_semana_anterior
  })
  → facturas_semana_ant (valor total + contagem)
  mcp__moloni-mcp__list_documents({
    document_type: "invoice",
    date_from: inicio_semana,
    date_to: fim_semana
  })
  → facturas_semana_atual (se já existirem)

[C] DESK CRM — Leads e pipeline
  mcp__desk-crm-v3__get_leads({ status: [7,14], limit: 20 })
  → leads_novos
  mcp__desk-crm-v3__get_estimates({ status: [3,4], limit: 20 })
  → propostas_pipeline

[D] TENDÊNCIAS — WebSearch
  WebSearch: "marketing digital tendencias semana {data_atual}"
  WebSearch: "SEO updates {mes} {ano}"
  WebSearch: "WordPress news {mes} {ano}"
  → 3 tendências relevantes ao negócio Descomplicar

[E] GOOGLE WORKSPACE — Agenda da semana
  mcp__google-workspace__calendar_get_events({
    user_google_email: "emanuelalmeidaa@gmail.com",
    time_min: "{inicio_semana}T00:00:00Z",
    time_max: "{fim_semana}T23:59:59Z"
  })
  → eventos_semana

Passo 3: Calcular métricas comparativas

Calcular variações:
  delta_horas = horas_semana_ant vs semana anterior a essa (% variação)
  delta_facturas = valor_semana_ant vs média das últimas 4 semanas
  taxa_conclusao = tarefas_concluidas / (tarefas_concluidas + abertas) * 100

SE dados incompletos: usar "N/D" e indicar fonte em falta

Passo 4: Gerar briefing em 4 secções

Output

# Monday Briefing — {periodo_atual}
*Gerado em {data_hora_atual} | Descomplicar®*

---

## 1. Trend Researcher — O Que Mudou Esta Semana

> Tendências relevantes para o negócio (marketing digital, SEO, WordPress, automação)

**[Tendência 1]**
_Fonte: [URL]_
Impacto potencial: [curto resumo do que muda para a Descomplicar]

**[Tendência 2]**
_Fonte: [URL]_
Impacto potencial: [curto resumo]

**[Tendência 3]**
_Fonte: [URL]_
Impacto potencial: [curto resumo]

---

## 2. Analytics Reporter — Métricas vs Semana Anterior

### Produtividade
| Métrica | Semana Anterior | Esta Semana | Δ |
|---------|----------------|-------------|---|
| Horas registadas | X h | Y h | ±Z% |
| Tarefas concluídas | X | Y | ±Z |
| Tickets abertos | X | Y | ±Z |

### Pipeline Comercial
| Métrica | Valor | Estado |
|---------|-------|--------|
| Facturação semana ant | {valor} EUR | {vs média} |
| Leads novos | X | — |
| Propostas pendentes | X | Total: Y EUR |
| Propostas aceites | X | Total: Y EUR |

### Agenda da Semana
| Data | Evento |
|------|--------|
| {DD Mmm} | {evento} |
| … | … |

> Fontes: Desk CRM + Moloni + Google Calendar
> Dados Google Analytics / GSC: configurar via /n8n-webhook ou GSC MCP

---

## 3. Growth Hacker — 1 Acção Para Esta Semana

**Acção:** [Nome curto e concreto]

**Porquê agora:** [Justificação baseada nos dados das secções 1 e 2]

**3 Passos para executar:**

1. **[Passo 1]** — [Descrição detalhada, quem faz, quando]
2. **[Passo 2]** — [Descrição detalhada, ferramentas necessárias]
3. **[Passo 3]** — [Métrica de validação: como saber que funcionou]

**Tempo estimado:** X horas
**Impacto esperado:** [Métrica específica]

---

## 4. Reality Checker — Contra-Argumentos

> Questionar os pressupostos das secções anteriores antes de agir.

**Sobre as tendências (secção 1):**
- [Contra-argumento]: Pode ser que [tendência X] não se aplique porque [razão específica ao contexto Descomplicar]
- Pergunta a fazer: Temos capacidade para responder a esta tendência esta semana?

**Sobre as métricas (secção 2):**
- [Contra-argumento]: A variação de [±Z%] pode ser [sazonalidade / evento pontual / dado incompleto]
- Atenção: [Métrica Y] está a [subir/descer] — verificar se é tendência real ou ruído

**Sobre a acção (secção 3):**
- [Contra-argumento]: A acção proposta assume que [pressuposto] — validar antes de executar
- Risco principal: [O que pode correr mal e como mitigar]
- Alternativa mais simples: [Versão reduzida da acção com menor risco]

---

*Próximo briefing: Segunda, {data_prox_segunda} 09:00*
*Para agendar: `/schedule "monday-briefing" cron:"0 9 * * 1"`*

Envio Automático (opcional)

SE argumento "email":
  mcp__google-workspace__gmail_send_email({
    to: "emanuelalmeidaa@gmail.com",
    subject: "Monday Briefing — {periodo_atual}",
    body: {output_markdown_acima},
    format: "html"
  })

SE argumento "inbox" OU sem argumento:
  Guardar em: /media/ealmeida/Dados/Hub/00-Inbox/monday-briefing-{YYYY-MM-DD}.md
  Formato: frontmatter YAML + conteúdo markdown

SE argumento "terminal":
  Mostrar directamente no terminal (default)

Como Agendar

Para receber automaticamente todas as segundas às 9h:

# Via skill /schedule:
/schedule "monday-briefing" cron:"0 9 * * 1"

Fontes de Dados

Fonte	MCP / Ferramenta	Dados
Desk CRM	`mcp__desk-crm-v3`	Tarefas, tickets, timesheets, leads, propostas
Moloni	`mcp__moloni-mcp`	Facturação semanal
Google Calendar	`mcp__google-workspace`	Agenda da semana
Tendências	`WebSearch`	Novidades mercado digital
Google Analytics	n8n BI workflow	Sessions, conversões (a configurar)
Google Search Console	GSC MCP (quando disponível)	Keywords, cliques orgânicos

GA4 e GSC: quando MCPs dedicados estiverem configurados, adicionar ao Passo 2[A]. Ver /n8n-webhook para workflow BI existente.

Anti-Patterns

NUNCA bloquear o briefing por falta de dados GA4/GSC — usar "N/D" e continuar
NUNCA inventar tendências — apenas WebSearch com fontes verificáveis
NUNCA recomendar mais de 1 acção na secção 3 (Growth Hacker)
SEMPRE usar mcp-time para calcular períodos (nunca assumir datas)
SEMPRE incluir secção Reality Checker — é o que diferencia este briefing

Healing Log

{"date":"","issue":"","fix":"","source":"user|auto"}

Adicionar nova linha após cada erro corrigido.

Skill v1.0.0 | 07-04-2026 | Descomplicar®

7.3 KiB Raw Permalink Blame History Unescape Escape