ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: refactor 30+ skills to Anthropic progressive disclosure pattern

Browse Source 
- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Emanuel Almeida
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
Download Patch File Download Diff File Expand all files Collapse all files

185
gestao/skills/report-templates/SKILL.md Normal file
View File

@@ -0,0 +1,185 @@
---
name: report-templates
description: Templates de comunicacao com clientes — updates mensais, status de projecto, relatorios de incidente e revisoes mensais. Usar quando "relatorio cliente", "report cliente", "update cliente", "status projecto", "incidente", "revisao mensal", "comunicar cliente", "resumo projecto", "enviar report", "preparar relatorio".
---
# /report-templates — Comunicacao com Clientes
Templates profissionais para comunicacao Descomplicar® com clientes. Gera documentos em HTML (Desk CRM) ou Markdown (Hub/email).
---
## Comandos
| Comando | Template | Uso |
|---------|----------|-----|
| `/report-templates update [cliente]` | client-update.md | Update mensal de progresso |
| `/report-templates status [projecto_id]` | project-status.md | Status detalhado de projecto |
| `/report-templates incidente [descricao]` | incident-report.md | Relatorio de incidente |
| `/report-templates mensal [cliente] [mes]` | monthly-review.md | Revisao mensal completa |
---
## Parametros
| Parametro | Descricao | Exemplo |
|-----------|-----------|---------|
| `--format html` | Output HTML para Desk CRM (default) | `--format html` |
| `--format md` | Output Markdown para Hub/email | `--format md` |
| `--lang pt` | Lingua do documento (default: pt) | `--lang pt` |
| `--desk` | Publicar como comentario no Desk CRM | `--desk` |
---
## Workflow de Execucao
```
1. IDENTIFICAR tipo de comunicacao:
- "update", "progresso", "mensal simples" -> client-update
- "status", "estado", "projecto" -> project-status
- "incidente", "problema", "falha", "downtime" -> incident-report
- "revisao mensal", "mensal completo", "revisao periodo" -> monthly-review
2. RECOLHER dados do Desk CRM:
a. mcp__desk-crm-v3__get_project({ project_id }) — se aplicavel
b. mcp__desk-crm-v3__get_tasks({ project_id }) — tarefas do periodo
c. mcp__desk-crm-v3__get_project_time_tracking({ project_id }) — horas
d. mcp__desk-crm-v3__get_invoices({ project_id }) — facturacao
e. mcp__desk-crm-v3__search_customers({ name }) — dados cliente
3. CARREGAR template de references/:
- client-update.md / project-status.md / incident-report.md / monthly-review.md
4. PREENCHER placeholders com dados reais
5. GERAR output no formato pedido (html ou md)
6. SE --desk: publicar via mcp__desk-crm-v3__add_task_comment
```
---
## Tom de Comunicacao Descomplicar
**Principios:**
- Profissional mas directo — sem jargao desnecessario
- Dados primeiro — factos antes de interpretacao
- Transparente em problemas — nunca esconder dificuldades
- Orientado para accao — cada ponto tem proximo passo claro
- Portugues europeu sempre — sem brasileirismos
**O que evitar:**
- Linguagem vaga ("estamos a trabalhar nisso")
- Promessas sem datas ("em breve")
- Excesso de adjectivos ("excelente progresso fantástico")
- Emojis em documentos formais
- Estimativas sem base nos dados
---
## Formatos de Output
### HTML (Desk CRM)
```html
<h4>Titulo da Seccao</h4>
<ul><li>Item</li></ul>
<table>
<tr><th>Coluna</th><th>Valor</th></tr>
<tr><td>Dado</td><td>Valor</td></tr>
</table>
<p><strong>Proximo passo:</strong> accao concreta com data</p>
<hr>
<p><em>Relatorio gerado em DD-MM-YYYY | Descomplicar®</em></p>
```
### Markdown (Hub / Email)
```markdown
## Titulo
| Coluna | Valor |
|--------|-------|
| Dado | Valor |
**Proximo passo:** accao concreta com data
---
*Relatorio gerado em DD-MM-YYYY | Descomplicar®*
```
---
## Templates Disponiveis
| Ficheiro | Template | Quando usar |
|----------|----------|-------------|
| `references/client-update.md` | Update mensal simples | Comunicacao periodica de progresso |
| `references/project-status.md` | Status de projecto | Revisao de milestone, reuniao de acompanhamento |
| `references/incident-report.md` | Relatorio de incidente | Qualquer problema que afectou o cliente |
| `references/monthly-review.md` | Revisao mensal completa | Fim de mes, revisao estrategica |
---
## Exemplos de Uso
### Update mensal simples
```
/report-templates update "SFV 360"
```
Recolhe dados do projecto SFV-360, preenche template client-update, gera HTML para Desk CRM.
### Status de projecto com markdown
```
/report-templates status 80 --format md
```
Gera relatorio de status do projecto #80 em Markdown para enviar por email.
### Relatorio de incidente
```
/report-templates incidente "Downtime servidor producao 2h"
```
Gera relatorio formal de incidente com timeline, impacto e plano de accao.
### Revisao mensal publicada no Desk
```
/report-templates mensal "CTF BigData" "Fevereiro 2026" --desk
```
Gera revisao mensal completa e publica como comentario na tarefa Desk do cliente.
---
## Integracao com Outras Skills
| Skill | Uso |
|-------|-----|
| `/report` | Dados agregados de periodo (horas, tarefas, facturas) |
| `/time` | Timesheets detalhados para incluir no relatorio |
| `/desk` | Contexto do projecto e cliente |
---
## Anti-Patterns
- **Nunca** gerar relatorio sem dados reais do Desk CRM
- **Nunca** incluir valores financeiros estimados como factos
- **Nunca** enviar relatorio de incidente sem plano de accao definido
- **Nunca** usar tom informal em relatorios de incidente
---
## Changelog
### v1.0.0 (2026-03-10)
- Versao inicial
- 4 templates: client-update, project-status, incident-report, monthly-review
- Suporte HTML e Markdown
- Integracao com Desk CRM
---
*Skill v1.0.0 | 2026-03-10 | Descomplicar®*

173
gestao/skills/report-templates/references/client-update.md Normal file
View File

@@ -0,0 +1,173 @@
# 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)
```html
<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)
```markdown
**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®*

235
gestao/skills/report-templates/references/incident-report.md Normal file
View File

@@ -0,0 +1,235 @@
# Template: Relatorio de Incidente
**Tipo:** Comunicacao formal de incidente ao cliente
**Quando usar:** Qualquer situacao que afectou o servico, dados ou experiencia do cliente
**Tom:** Formal, transparente, orientado para resolucao e prevencao
**Extensao:** 1-2 paginas. Nao minimizar nem exagerar
**Principio cardinal:** Comunicar o incidente antes que o cliente pergunte. Transparencia activa.
---
## Classificacao de Severidade
| Nivel | Codigo | Criterio | Prazo comunicacao |
|-------|--------|----------|------------------|
| Critico | P1 | Servico completamente indisponivel ou perda de dados | 1 hora |
| Alto | P2 | Funcionalidade principal degradada | 4 horas |
| Medio | P3 | Funcionalidade secundaria afectada | 24 horas |
| Baixo | P4 | Problema menor sem impacto operacional | 72 horas |
---
## Estrutura do Template
### HTML (Desk CRM)
```html
<h4>Relatorio de Incidente — {{TITULO_INCIDENTE}}</h4>
<p>
<strong>Referencia:</strong> INC-{{ANO}}-{{NUMERO}} |
<strong>Severidade:</strong> <span style="color:{{COR_SEVERIDADE}}">{{NIVEL_SEVERIDADE}}</span> |
<strong>Estado:</strong> {{ESTADO_INCIDENTE}}
</p>
<h4>Resumo</h4>
<p>{{DESCRICAO_RESUMO}}</p>
<h4>Impacto</h4>
<table>
<tr>
<th>Dimensao</th>
<th>Detalhe</th>
</tr>
<tr>
<td>Inicio</td>
<td>{{DATA_INICIO}} {{HORA_INICIO}}</td>
</tr>
<tr>
<td>Fim / Resolucao</td>
<td>{{DATA_FIM}} {{HORA_FIM}} ({{DURACAO}} de impacto)</td>
</tr>
<tr>
<td>Servicos afectados</td>
<td>{{SERVICOS_AFECTADOS}}</td>
</tr>
<tr>
<td>Utilizadores afectados</td>
<td>{{UTILIZADORES_AFECTADOS}}</td>
</tr>
<tr>
<td>Dados afectados</td>
<td>{{DADOS_AFECTADOS}}</td>
</tr>
</table>
<h4>Cronologia</h4>
<table>
<tr>
<th>Hora</th>
<th>Evento</th>
</tr>
<tr>
<td>{{HORA_1}}</td>
<td>{{EVENTO_1}}</td>
</tr>
<tr>
<td>{{HORA_2}}</td>
<td>{{EVENTO_2}}</td>
</tr>
<tr>
<td>{{HORA_3}}</td>
<td>{{EVENTO_3}}</td>
</tr>
<tr>
<td>{{HORA_RESOLUCAO}}</td>
<td>Incidente resolvido — servico normalizado</td>
</tr>
</table>
<h4>Causa Raiz</h4>
<p>{{CAUSA_RAIZ}}</p>
<p><em>Nota: {{NOTA_CAUSA_RAIZ_SE_INVESTIGACAO_PENDENTE}}</em></p>
<h4>Accoes de Remediacao</h4>
<ul>
<li><strong>Imediata (concluida):</strong> {{ACCAO_IMEDIATA}}</li>
<li><strong>Curto prazo ({{DATA_CURTO_PRAZO}}):</strong> {{ACCAO_CURTO_PRAZO}}</li>
<li><strong>Preventiva ({{DATA_PREVENTIVA}}):</strong> {{ACCAO_PREVENTIVA}}</li>
</ul>
<h4>Compensacao</h4>
<p>{{COMPENSACAO_SE_APLICAVEL}}</p>
<p>Pedimos desculpa pelo inconveniente causado. Estamos comprometidos a prevenir recorrencia.</p>
<p>Para questoes adicionais: <a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> | 911 510 005</p>
<hr>
<p>
<strong>Descomplicar®</strong> |
<em>Relatorio emitido em {{DATA_EMISSAO}}</em>
</p>
```
### Markdown (Email / Hub)
```markdown
# Relatorio de Incidente — {{TITULO_INCIDENTE}}
**Referencia:** INC-{{ANO}}-{{NUMERO}} | **Severidade:** {{NIVEL_SEVERIDADE}} | **Estado:** {{ESTADO_INCIDENTE}}
---
## Resumo
{{DESCRICAO_RESUMO}}
## Impacto
| Dimensao | Detalhe |
|----------|---------|
| Inicio | {{DATA_INICIO}} {{HORA_INICIO}} |
| Fim / Resolucao | {{DATA_FIM}} {{HORA_FIM}} ({{DURACAO}}) |
| Servicos afectados | {{SERVICOS_AFECTADOS}} |
| Utilizadores afectados | {{UTILIZADORES_AFECTADOS}} |
| Dados afectados | {{DADOS_AFECTADOS}} |
## Cronologia
| Hora | Evento |
|------|--------|
| {{HORA_1}} | {{EVENTO_1}} |
| {{HORA_2}} | {{EVENTO_2}} |
| {{HORA_3}} | {{EVENTO_3}} |
| {{HORA_RESOLUCAO}} | Incidente resolvido — servico normalizado |
## Causa Raiz
{{CAUSA_RAIZ}}
## Accoes de Remediacao
- **Imediata (concluida):** {{ACCAO_IMEDIATA}}
- **Curto prazo ({{DATA_CURTO_PRAZO}}):** {{ACCAO_CURTO_PRAZO}}
- **Preventiva ({{DATA_PREVENTIVA}}):** {{ACCAO_PREVENTIVA}}
## Compensacao
{{COMPENSACAO_SE_APLICAVEL}}
---
Pedimos desculpa pelo inconveniente causado.
Para questoes: info@descomplicar.pt | 911 510 005
*Relatorio emitido em {{DATA_EMISSAO}} | Descomplicar®*
```
---
## Placeholders — Guia de Preenchimento
| Placeholder | Instrucoes de Preenchimento |
|-------------|---------------------------|
| `{{TITULO_INCIDENTE}}` | Descricao curta e factual: "Downtime servidor producao", "Falha autenticacao", "Perda dados formulario" |
| `{{NUMERO}}` | Sequencial do ano: 001, 002... Verificar incidentes anteriores |
| `{{NIVEL_SEVERIDADE}}` | P1 Critico / P2 Alto / P3 Medio / P4 Baixo |
| `{{ESTADO_INCIDENTE}}` | Resolvido / Em investigacao / Monitorizado |
| `{{DESCRICAO_RESUMO}}` | 2-3 frases: o que aconteceu, quando, impacto imediato |
| `{{DURACAO}}` | Ex: "2h 15min", "45min", "4h" |
| `{{CAUSA_RAIZ}}` | Tecnico mas acessivel. Se ainda em investigacao: "A investigacao esta em curso. Actualizacao prevista para DD-MM-YYYY." |
| `{{COMPENSACAO}}` | Se N/A: omitir seccao. Se aplicavel: credito, extensao, horas extra |
### Cores por Severidade (HTML)
| Nivel | Cor |
|-------|-----|
| P1 Critico | `#e53e3e` |
| P2 Alto | `#d69e2e` |
| P3 Medio | `#dd6b20` |
| P4 Baixo | `#38a169` |
---
## Exemplo Preenchido
```
Relatorio de Incidente — Downtime Servidor Producao
Referencia: INC-2026-003 | Severidade: P2 Alto | Estado: Resolvido
Resumo:
No dia 08-03-2026, entre as 14:22 e as 16:37, o servidor de producao
esteve inacessivel durante 2h 15min devido a uma falha de memoria
no servico de cache. Todos os servicos foram restaurados as 16:37.
Impacto:
- Duracao: 2h 15min
- Servicos afectados: Portal web, API integracao
- Utilizadores afectados: todos os utilizadores activos (~45)
- Dados: sem perda de dados confirmada
Causa Raiz:
Fuga de memoria no servico Redis apos actualizacao de versao
aplicada em manutencao preventiva às 13:00. A versao 7.2.1 tem
um bug conhecido com configuracoes de maxmemory-policy = allkeys-lru.
Accoes:
- Imediata: Rollback Redis para versao 7.0.15 (concluido)
- Curto prazo (12-03-2026): Adicionar alertas de memoria no sistema de monitorizacao
- Preventiva (31-03-2026): Procedimento de teste em staging antes de actualizacoes
```
---
## Notas de Uso
- Nunca minimizar o impacto — o cliente ja sabe o que sentiu
- Se a causa raiz nao for conhecida no momento de envio, dizer claramente com data de actualizacao
- Accoes preventivas devem ser reais e com datas — nao compromissos vagos
- Em P1/P2, comunicar primeiro por telefone, depois enviar relatorio formal
- Guardar registo em Desk CRM como comentario na tarefa do cliente (discussao #31)
---
*Template v1.0.0 | 2026-03-10 | Descomplicar®*

297
gestao/skills/report-templates/references/monthly-review.md Normal file
View File

@@ -0,0 +1,297 @@
# 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)
```html
<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)
```markdown
# 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®*

210
gestao/skills/report-templates/references/project-status.md Normal file
View File

@@ -0,0 +1,210 @@
# Template: Status de Projecto
**Tipo:** Relatorio de estado detalhado de projecto
**Frequencia:** Por milestone, reuniao de acompanhamento, ou pedido do cliente
**Tom:** Tecnico mas acessivel, orientado para decisao
**Extensao:** 1-2 paginas (equivalente)
---
## Estrutura do Template
### HTML (Desk CRM)
```html
<h4>Status do Projecto — {{NOME_PROJECTO}}</h4>
<p>
<strong>Data:</strong> {{DATA_HOJE}} |
<strong>Periodo:</strong> {{PERIODO_INICIO}} a {{PERIODO_FIM}} |
<strong>Status:</strong> <span style="color:{{COR_STATUS}}">{{STATUS_LABEL}}</span>
</p>
<h4>Resumo Executivo</h4>
<table>
<tr>
<th>Metrica</th>
<th>Valor</th>
<th>Nota</th>
</tr>
<tr>
<td>Progresso</td>
<td>{{PROGRESSO_PERCENTAGEM}}%</td>
<td>{{NOTA_PROGRESSO}}</td>
</tr>
<tr>
<td>Horas gastas</td>
<td>{{HORAS_GASTAS}}h / {{HORAS_ESTIMADAS}}h</td>
<td>{{BURN_RATE}}% consumido</td>
</tr>
<tr>
<td>Tarefas</td>
<td>{{TAREFAS_CONCLUIDAS}} / {{TAREFAS_TOTAL}}</td>
<td>{{TAREFAS_EM_CURSO}} em curso</td>
</tr>
<tr>
<td>Deadline</td>
<td>{{DEADLINE}}</td>
<td>{{DIAS_RESTANTES}} dias restantes</td>
</tr>
</table>
<h4>Fases e Milestones</h4>
<table>
<tr>
<th>Fase</th>
<th>Status</th>
<th>Conclusao</th>
</tr>
<tr>
<td>{{FASE_1_NOME}}</td>
<td>{{FASE_1_STATUS}}</td>
<td>{{FASE_1_DATA}}</td>
</tr>
<tr>
<td>{{FASE_2_NOME}}</td>
<td>{{FASE_2_STATUS}}</td>
<td>{{FASE_2_DATA}}</td>
</tr>
<tr>
<td>{{FASE_3_NOME}}</td>
<td>{{FASE_3_STATUS}}</td>
<td>{{FASE_3_DATA}}</td>
</tr>
</table>
<h4>Tarefas em Destaque</h4>
<ul>
<li><strong>Concluidas recentemente:</strong> {{TAREFAS_RECENTES}}</li>
<li><strong>Em curso agora:</strong> {{TAREFAS_ACTIVAS}}</li>
<li><strong>A iniciar em seguida:</strong> {{PROXIMAS_TAREFAS}}</li>
</ul>
<h4>Riscos e Bloqueadores</h4>
<ul>
<li>{{RISCO_1}} — <strong>Mitigacao:</strong> {{MITIGACAO_1}}</li>
<li>{{RISCO_2}} — <strong>Mitigacao:</strong> {{MITIGACAO_2}}</li>
</ul>
<h4>Financeiro</h4>
<table>
<tr>
<th>Descricao</th>
<th>Valor</th>
<th>Status</th>
</tr>
<tr>
<td>{{FATURA_1_DESC}}</td>
<td>{{FATURA_1_VALOR}}EUR</td>
<td>{{FATURA_1_STATUS}}</td>
</tr>
</table>
<h4>Proximas Accoes</h4>
<ul>
<li>{{ACCAO_1}} — responsavel: {{RESPONSAVEL_1}} — data: {{DATA_ACCAO_1}}</li>
<li>{{ACCAO_2}} — responsavel: {{RESPONSAVEL_2}} — data: {{DATA_ACCAO_2}}</li>
</ul>
<hr>
<p>
<strong>Descomplicar®</strong> |
<a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> |
911 510 005
</p>
<p><em>Status gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}</em></p>
```
### Markdown (Email / Hub)
```markdown
# Status do Projecto — {{NOME_PROJECTO}}
**Data:** {{DATA_HOJE}} | **Periodo:** {{PERIODO_INICIO}} — {{PERIODO_FIM}} | **Status:** {{STATUS_LABEL}}
---
## Resumo Executivo
| Metrica | Valor | Nota |
|---------|-------|------|
| Progresso | {{PROGRESSO_PERCENTAGEM}}% | {{NOTA_PROGRESSO}} |
| Horas | {{HORAS_GASTAS}}h / {{HORAS_ESTIMADAS}}h | {{BURN_RATE}}% consumido |
| Tarefas | {{TAREFAS_CONCLUIDAS}} / {{TAREFAS_TOTAL}} | {{TAREFAS_EM_CURSO}} em curso |
| Deadline | {{DEADLINE}} | {{DIAS_RESTANTES}} dias restantes |
## Fases e Milestones
| Fase | Status | Conclusao |
|------|--------|-----------|
| {{FASE_1_NOME}} | {{FASE_1_STATUS}} | {{FASE_1_DATA}} |
| {{FASE_2_NOME}} | {{FASE_2_STATUS}} | {{FASE_2_DATA}} |
| {{FASE_3_NOME}} | {{FASE_3_STATUS}} | {{FASE_3_DATA}} |
## Tarefas em Destaque
- **Concluidas recentemente:** {{TAREFAS_RECENTES}}
- **Em curso agora:** {{TAREFAS_ACTIVAS}}
- **A iniciar em seguida:** {{PROXIMAS_TAREFAS}}
## Riscos e Bloqueadores
- {{RISCO_1}} — **Mitigacao:** {{MITIGACAO_1}}
- {{RISCO_2}} — **Mitigacao:** {{MITIGACAO_2}}
## Financeiro
| Descricao | Valor | Status |
|-----------|-------|--------|
| {{FATURA_1_DESC}} | {{FATURA_1_VALOR}}EUR | {{FATURA_1_STATUS}} |
## Proximas Accoes
- {{ACCAO_1}} — {{RESPONSAVEL_1}} — {{DATA_ACCAO_1}}
- {{ACCAO_2}} — {{RESPONSAVEL_2}} — {{DATA_ACCAO_2}}
---
Descomplicar® | info@descomplicar.pt | 911 510 005
*Status gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}*
```
---
## Placeholders — Mapeamento Desk CRM
| Placeholder | Fonte | MCP Call |
|-------------|-------|----------|
| `{{NOME_PROJECTO}}` | `project.name` | `get_project` |
| `{{PROGRESSO_PERCENTAGEM}}` | `project.progress` | `get_project` |
| `{{HORAS_GASTAS}}` | Soma timesheets | `get_project_time_tracking` |
| `{{HORAS_ESTIMADAS}}` | `project.estimated_hours` | `get_project` |
| `{{BURN_RATE}}` | Calculado: gastas/estimadas*100 | — |
| `{{TAREFAS_CONCLUIDAS}}` | Count tasks status=completed | `get_tasks` |
| `{{TAREFAS_TOTAL}}` | Count all tasks | `get_tasks` |
| `{{TAREFAS_EM_CURSO}}` | Count tasks status=in_progress | `get_tasks` |
| `{{DEADLINE}}` | `project.deadline` | `get_project` |
| `{{DIAS_RESTANTES}}` | Calculado | `mcp-time` |
| `{{FATURA_*}}` | Facturas do projecto | `get_invoices` |
### Status Labels e Cores
| Status | Label | Cor HTML |
|--------|-------|----------|
| Em prazo | No Prazo | `#38a169` (verde) |
| Risco moderado | Em Risco | `#d69e2e` (amarelo) |
| Atrasado | Atrasado | `#e53e3e` (vermelho) |
| Concluido | Concluido | `#2b6cb0` (azul) |
| Em pausa | Em Pausa | `#4a5568` (cinza) |
---
## Notas de Uso
- Se o burn rate ultrapassar 80% com menos de 80% de progresso, assinalar como risco
- Riscos sem mitigacao definida nao devem ser apresentados ao cliente sem plano de accao
- Fases devem corresponder a milestones acordados no arranque do projecto
- Dados financeiros incluir apenas se o utilizador tem permissao (staff ID 1 = Emanuel)
- Se nao existirem riscos conhecidos, omitir a seccao (nao colocar "sem riscos identificados")
---
*Template v1.0.0 | 2026-03-10 | Descomplicar®*