claude-plugins/gestao/skills/report-templates/references/client-update.md

Template: Update Mensal de Cliente

Tipo: Comunicacao periodica de progresso Frequencia: Mensal (ou quinzenal em projectos activos) Tom: Profissional, directo, orientado para dados Extensao: 1 pagina (equivalente)

---

Estrutura do Template

HTML (Desk CRM)

<h4>Update {{MES_ANO}} — {{NOME_PROJECTO}}</h4>

<p>Caro {{NOME_CLIENTE}},</p>
<p>Segue o update de progresso referente a {{MES_ANO}}.</p>

<h4>Trabalho Concluido</h4>
<ul>
  <li>{{TAREFA_1}}</li>
  <li>{{TAREFA_2}}</li>
  <li>{{TAREFA_3}}</li>
</ul>

<h4>Metricas do Periodo</h4>
<table>
  <tr>
    <th>Metrica</th>
    <th>Valor</th>
  </tr>
  <tr>
    <td>Horas dedicadas</td>
    <td>{{HORAS_TOTAL}}h</td>
  </tr>
  <tr>
    <td>Tarefas concluidas</td>
    <td>{{TAREFAS_CONCLUIDAS}}</td>
  </tr>
  <tr>
    <td>Progresso geral</td>
    <td>{{PROGRESSO_PERCENTAGEM}}%</td>
  </tr>
</table>

<h4>Em Curso</h4>
<ul>
  <li>{{ITEM_EM_CURSO_1}}</li>
  <li>{{ITEM_EM_CURSO_2}}</li>
</ul>

<h4>Proximos Passos</h4>
<ul>
  <li>{{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}</li>
  <li>{{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}</li>
</ul>

<p>Qualquer questao, estamos disponiveis.</p>

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

Markdown (Email / Hub)

**Update {{MES_ANO}} — {{NOME_PROJECTO}}**

Caro {{NOME_CLIENTE}},

Segue o update de progresso referente a {{MES_ANO}}.

---

**Trabalho Concluido**

- {{TAREFA_1}}
- {{TAREFA_2}}
- {{TAREFA_3}}

**Metricas do Periodo**

| Metrica | Valor |
|---------|-------|
| Horas dedicadas | {{HORAS_TOTAL}}h |
| Tarefas concluidas | {{TAREFAS_CONCLUIDAS}} |
| Progresso geral | {{PROGRESSO_PERCENTAGEM}}% |

**Em Curso**

- {{ITEM_EM_CURSO_1}}
- {{ITEM_EM_CURSO_2}}

**Proximos Passos**

- {{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}
- {{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}

Qualquer questao, estamos disponiveis.

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

---

Placeholders — Mapeamento Desk CRM

Placeholder	Fonte Desk CRM	MCP Call
{{NOME_PROJECTO}}	project.name	get_project
{{NOME_CLIENTE}}	customer.firstname	search_customers
{{MES_ANO}}	Calculado	mcp-time
{{HORAS_TOTAL}}	Timesheets do mes	get_project_time_tracking
{{TAREFAS_CONCLUIDAS}}	Tasks status=completed	get_tasks
{{PROGRESSO_PERCENTAGEM}}	project.progress	get_project
{{TAREFA_1..N}	Tasks recentes concluidas	get_tasks
{{ITEM_EM_CURSO_1..N}	Tasks status=in_progress	get_tasks
{{PROXIMO_PASSO_1..N}	Tasks status=not_started, por data	get_tasks
{{DATA_1..N}	task.due_date	get_tasks
{{DATA_HOJE}}	Hoje	mcp-time
{{PROJECTO_ID}}	project.id	get_project

---

Exemplo Preenchido

Update Fevereiro 2026 — Portal SFV-360

Caro Paulo Silva,

Segue o update de progresso referente a Fevereiro 2026.

Trabalho Concluido:
- Implementacao modulo de relatorios automaticos
- Integracao API energia solar (3 inversores)
- Correccao erro calculo producao acumulada

Metricas do Periodo:
- Horas dedicadas: 38h
- Tarefas concluidas: 8
- Progresso geral: 72%

Em Curso:
- Dashboard mobile (responsivo)
- Testes de carga base de dados

Proximos Passos:
- Entrega dashboard mobile — previsto para 15-03-2026
- Formacao utilizadores — previsto para 20-03-2026

---

Notas de Uso

• Incluir apenas tarefas relevantes para o cliente (excluir internas/tecnicas sem impacto visivel)
• Se o progresso diminuiu ou estagnou, explicar o motivo de forma clara
• Proximos passos devem ter sempre datas concretas
• Maximo 5 items por seccao — sintese e preferida
• Se existem bloqueadores que dependem do cliente, destacar em negrito

---

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