claude-plugins/gestao/skills/report-templates/references/monthly-review.md

Template: Revisao Mensal

Tipo: Revisao estrategica mensal com cliente Quando usar: Fim de mes, reuniao mensal de acompanhamento, revisao de contrato Tom: Estrategico, baseado em dados, orientado para decisao conjunta Extensao: 2-3 paginas. O mais completo dos 4 templates

Diferenca face ao client-update: A revisao mensal inclui analise comparativa, discussao estrategica e decisoes para o mes seguinte. O update e apenas informativo.

---

Estrutura do Template

HTML (Desk CRM)

<h4>Revisao Mensal — {{NOME_PROJECTO}} | {{MES_ANO}}</h4>
<p>
  <strong>Cliente:</strong> {{NOME_CLIENTE}} |
  <strong>Periodo:</strong> 01-{{MES_NUM}}-{{ANO}} a {{ULTIMO_DIA}}-{{MES_NUM}}-{{ANO}} |
  <strong>Elaborado por:</strong> Descomplicar®
</p>

<h4>1. Resumo Executivo</h4>
<p>{{PARAGRAFO_RESUMO_EXECUTIVO}}</p>

<table>
  <tr>
    <th>Metrica</th>
    <th>{{MES_ATUAL}}</th>
    <th>{{MES_ANTERIOR}}</th>
    <th>Variacao</th>
  </tr>
  <tr>
    <td>Horas trabalhadas</td>
    <td>{{HORAS_MES}}</td>
    <td>{{HORAS_MES_ANT}}</td>
    <td>{{VAR_HORAS}}</td>
  </tr>
  <tr>
    <td>Tarefas concluidas</td>
    <td>{{TAREFAS_MES}}</td>
    <td>{{TAREFAS_MES_ANT}}</td>
    <td>{{VAR_TAREFAS}}</td>
  </tr>
  <tr>
    <td>Progresso geral</td>
    <td>{{PROGRESSO_MES}}%</td>
    <td>{{PROGRESSO_MES_ANT}}%</td>
    <td>+{{VAR_PROGRESSO}}pp</td>
  </tr>
  <tr>
    <td>Valor entregue</td>
    <td>{{VALOR_MES}}EUR</td>
    <td>{{VALOR_MES_ANT}}EUR</td>
    <td>{{VAR_VALOR}}</td>
  </tr>
</table>

<h4>2. Trabalho Realizado</h4>

<h5>Entregas Concluidas</h5>
<ul>
  <li><strong>{{ENTREGA_1}}:</strong> {{DESCRICAO_ENTREGA_1}}</li>
  <li><strong>{{ENTREGA_2}}:</strong> {{DESCRICAO_ENTREGA_2}}</li>
  <li><strong>{{ENTREGA_3}}:</strong> {{DESCRICAO_ENTREGA_3}}</li>
</ul>

<h5>Tarefas por Area</h5>
<table>
  <tr>
    <th>Area</th>
    <th>Tarefas</th>
    <th>Horas</th>
  </tr>
  <tr>
    <td>{{AREA_1}}</td>
    <td>{{AREA_1_TAREFAS}}</td>
    <td>{{AREA_1_HORAS}}h</td>
  </tr>
  <tr>
    <td>{{AREA_2}}</td>
    <td>{{AREA_2_TAREFAS}}</td>
    <td>{{AREA_2_HORAS}}h</td>
  </tr>
</table>

<h4>3. Estado do Projecto</h4>
<table>
  <tr>
    <th>Componente</th>
    <th>Estado</th>
    <th>Notas</th>
  </tr>
  <tr>
    <td>{{COMPONENTE_1}}</td>
    <td>{{ESTADO_1}}</td>
    <td>{{NOTA_1}}</td>
  </tr>
  <tr>
    <td>{{COMPONENTE_2}}</td>
    <td>{{ESTADO_2}}</td>
    <td>{{NOTA_2}}</td>
  </tr>
</table>

<h4>4. Facturacao e Financeiro</h4>
<table>
  <tr>
    <th>Descricao</th>
    <th>Valor</th>
    <th>Data</th>
    <th>Estado</th>
  </tr>
  <tr>
    <td>{{FATURA_1_DESC}}</td>
    <td>{{FATURA_1_VALOR}}EUR</td>
    <td>{{FATURA_1_DATA}}</td>
    <td>{{FATURA_1_ESTADO}}</td>
  </tr>
</table>
<p>
  <strong>Facturado no mes:</strong> {{TOTAL_FACTURADO}}EUR |
  <strong>Recebido:</strong> {{TOTAL_RECEBIDO}}EUR |
  <strong>Pendente:</strong> {{TOTAL_PENDENTE}}EUR
</p>

<h4>5. Analise e Observacoes</h4>
<p>{{ANALISE_QUALITATIVA}}</p>

<h5>O que correu bem</h5>
<ul>
  <li>{{PONTO_POSITIVO_1}}</li>
  <li>{{PONTO_POSITIVO_2}}</li>
</ul>

<h5>O que pode melhorar</h5>
<ul>
  <li>{{PONTO_MELHORIA_1}}</li>
  <li>{{PONTO_MELHORIA_2}}</li>
</ul>

<h4>6. Plano para {{MES_SEGUINTE}}</h4>
<ul>
  <li>{{OBJECTIVO_1}} — responsavel: {{RESP_1}} — data: {{DATA_OBJ_1}}</li>
  <li>{{OBJECTIVO_2}} — responsavel: {{RESP_2}} — data: {{DATA_OBJ_2}}</li>
  <li>{{OBJECTIVO_3}} — responsavel: {{RESP_3}} — data: {{DATA_OBJ_3}}</li>
</ul>

<h5>Decisoes Necessarias</h5>
<ul>
  <li>{{DECISAO_1}} — pendente: {{PENDENTE_QUEM_1}}</li>
  <li>{{DECISAO_2}} — pendente: {{PENDENTE_QUEM_2}}</li>
</ul>

<h4>7. Proxima Revisao</h4>
<p>
  <strong>Data proposta:</strong> {{DATA_PROXIMA_REVISAO}} |
  <strong>Formato:</strong> {{FORMATO_REUNIAO}}
</p>

<hr>
<p>
  <strong>Descomplicar®</strong> |
  <a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> |
  911 510 005
</p>
<p><em>Revisao gerada em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}</em></p>

Markdown (Email / Hub)

# Revisao Mensal — {{NOME_PROJECTO}} | {{MES_ANO}}

**Cliente:** {{NOME_CLIENTE}} | **Periodo:** 01-{{MES_NUM}}-{{ANO}} a {{ULTIMO_DIA}}-{{MES_NUM}}-{{ANO}}

---

## 1. Resumo Executivo

{{PARAGRAFO_RESUMO_EXECUTIVO}}

| Metrica | {{MES_ATUAL}} | {{MES_ANTERIOR}} | Variacao |
|---------|--------------|-----------------|----------|
| Horas trabalhadas | {{HORAS_MES}} | {{HORAS_MES_ANT}} | {{VAR_HORAS}} |
| Tarefas concluidas | {{TAREFAS_MES}} | {{TAREFAS_MES_ANT}} | {{VAR_TAREFAS}} |
| Progresso geral | {{PROGRESSO_MES}}% | {{PROGRESSO_MES_ANT}}% | +{{VAR_PROGRESSO}}pp |
| Valor entregue | {{VALOR_MES}}EUR | {{VALOR_MES_ANT}}EUR | {{VAR_VALOR}} |

## 2. Trabalho Realizado

**Entregas concluidas:**
- **{{ENTREGA_1}}:** {{DESCRICAO_ENTREGA_1}}
- **{{ENTREGA_2}}:** {{DESCRICAO_ENTREGA_2}}
- **{{ENTREGA_3}}:** {{DESCRICAO_ENTREGA_3}}

## 3. Estado do Projecto

| Componente | Estado | Notas |
|------------|--------|-------|
| {{COMPONENTE_1}} | {{ESTADO_1}} | {{NOTA_1}} |
| {{COMPONENTE_2}} | {{ESTADO_2}} | {{NOTA_2}} |

## 4. Facturacao

| Descricao | Valor | Estado |
|-----------|-------|--------|
| {{FATURA_1_DESC}} | {{FATURA_1_VALOR}}EUR | {{FATURA_1_ESTADO}} |

**Facturado:** {{TOTAL_FACTURADO}}EUR | **Recebido:** {{TOTAL_RECEBIDO}}EUR | **Pendente:** {{TOTAL_PENDENTE}}EUR

## 5. O que correu bem / O que melhorar

**Positivo:**
- {{PONTO_POSITIVO_1}}
- {{PONTO_POSITIVO_2}}

**Melhoria:**
- {{PONTO_MELHORIA_1}}
- {{PONTO_MELHORIA_2}}

## 6. Plano {{MES_SEGUINTE}}

- {{OBJECTIVO_1}} — {{RESP_1}} — {{DATA_OBJ_1}}
- {{OBJECTIVO_2}} — {{RESP_2}} — {{DATA_OBJ_2}}
- {{OBJECTIVO_3}} — {{RESP_3}} — {{DATA_OBJ_3}}

**Decisoes necessarias:**
- {{DECISAO_1}} — pendente: {{PENDENTE_QUEM_1}}

## 7. Proxima Revisao

**Data proposta:** {{DATA_PROXIMA_REVISAO}} | **Formato:** {{FORMATO_REUNIAO}}

---
Descomplicar® | info@descomplicar.pt | 911 510 005
*Revisao gerada em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}*

---

Placeholders — Mapeamento Desk CRM

Placeholder	Fonte	MCP Call
{{HORAS_MES}}	Timesheets do mes	get_project_time_tracking
{{HORAS_MES_ANT}}	Timesheets mes anterior	get_project_time_tracking (range)
{{TAREFAS_MES}}	Tasks concluidas no mes	get_tasks (filtro data)
{{PROGRESSO_MES}}	project.progress actual	get_project
{{TOTAL_FACTURADO}}	Soma facturas do mes	get_invoices
{{TOTAL_RECEBIDO}}	Facturas pagas	get_invoices (status=paid)
{{TOTAL_PENDENTE}}	Facturas pendentes	get_invoices (status=unpaid)

Estados de Componente

Estado	Significado
Concluido	Entregue e aceite
Em curso	Desenvolvimento activo
Pendente	Nao iniciado, na fila
Em revisao	Aguarda aprovacao cliente
Em pausa	Aguarda input externo
Bloqueado	Dependencia nao resolvida

---

Paragrafo de Resumo Executivo — Guia

O resumo executivo deve responder a 3 questoes em 3-4 frases:

1. O que foi feito este mes? (resultados concretos)
2. Onde estamos no projecto? (progresso, prazo)
3. O que e mais importante para o mes seguinte? (foco)

Exemplo:

Em Fevereiro 2026, concluimos a integracao com a API de energia solar
e o modulo de relatorios automaticos, elevando o progresso do projecto
para 72%. O projecto mantem-se dentro do prazo previsto para entrega
final a 31-03-2026. Em Marco, o foco sera o dashboard mobile e a
formacao de utilizadores.

---

Notas de Uso

• O paragrafo de resumo executivo e o elemento mais lido — escrever com cuidado
• Comparacao com mes anterior so incluir se os dados forem reais (nao simular)
• "O que pode melhorar" nao e critica — e comprometimento de melhoria continua
• Decisoes necessarias devem ter dono claro (Descomplicar ou Cliente)
• Propor sempre data para proxima revisao — nao deixar em aberto

---

Template v1.0.0 | 2026-03-10 | Descomplicar®