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

---
name: worklog
description: >
  Registo de trabalho + reflexão unificado v4.0. Analisa sessão, regista trabalho, identifica padrões, sugere acções.
  /reflect é alias (mesmo resultado). Variantes: /reflect deep (análise profunda), /reflect week (revisão semanal).
  Auto-trigger >10 tool calls. Auto-alerts degradação >15%, error rate >10%.
  Use when "worklog", "reflect", "reflexão", "registar trabalho", "log", "análise", "melhoria", "insight", ao parar timer.
author: Descomplicar® Crescimento Digital
version: 4.0.0
quality_score: 95
user_invocable: true
category: productivity
tags: [log, trabalho, reflexao, auto-melhoria, produtividade, time-tracking, memory, pdca, alerts]
desk_task: 1554
desk_project: 65
desk_discussion_logs: 31
desk_discussion_reflexoes: 32
desk_discussion_accoes: 33
allowed-tools: Read, Write, Bash, mcp__desk-crm-v3, mcp__mcp-time, mcp__memory-supabase, mcp__ssh-unified
mcps: desk-crm-v3, mcp-time, memory-supabase, ssh-unified
dependencies:
  skills: [sdk, metrics]
  mcps: [desk-crm-v3, memory-supabase]
auto_trigger:
  enabled: true
  threshold_tool_calls: 10
  background: true
  alerts:
    - performance_degradation: 15
    - error_rate: 10
    - kb_offline: 3
---

# /worklog v4.0 - Registo de Trabalho + Reflexão

Skill unificada: regista trabalho, analisa sessão, sugere acções, guarda memória.

**`/reflect` = alias de `/worklog`** (mesmo resultado).

---

## Comandos

| Comando | Função |
|---------|--------|
| `/worklog` | Registo + reflexão da sessão |
| `/reflect` | Alias de `/worklog` |
| `/worklog view` | Ver últimos registos |
| `/reflect deep` | Análise profunda com histórico |
| `/reflect week` | Revisão semanal (segundas via /today) |

---

## Storage

| Tipo | Discussão | ID |
|------|-----------|-----|
| **Logs + Reflexões** | Logs | 31 |
| **Reflexões Profundas** | Reflexões | 32 |
| **Acções** | Acções de Melhoria | 33 |

**Projecto:** #65 (DES Stack Workflow) | **Staff:** 25 (AikTop)

---

## Protocolo Principal (/worklog e /reflect)

```
1. Obter hora via mcp__mcp-time__current_time
2. Verificar timer activo em ~/.claude-work/active-timer.json
3. ANALISAR sessão:
   - Ficheiros modificados (Edit/Write calls)
   - MCPs usados
   - Erros e soluções
   - Padrões detectados
   - Eficiência (tool calls vs resultado)
4. VERIFICAR se há algo novo a documentar
   - Se sessão vazia/sem dados → NÃO gerar
5. Gerar comentário HTML (ver formato abaixo)
6. mcp__desk-crm-v3__add_discussion_comment({
     discussion_id: 31,
     content: html,
     staff_id: 25
   })
7. SE acções sugeridas:
   mcp__desk-crm-v3__add_discussion_comment({
     discussion_id: 33,
     content: accoes_html,
     staff_id: 25
   })
8. SE insight valioso → save_memory Supabase
9. Confirmar
```

**Output:**

```markdown
Worklog registado!

Tarefa: #1446 - Documentação Skills
Duração: 2h 15m
Discussão: #31 (Logs)
Acções: 2 sugeridas (#33)
Memória: Guardada / N/A
```

---

## Formato Comentário HTML (Discussão #31)

```html
<h4>YYYY-MM-DD HH:MM - Título da Sessão</h4>

<p><strong>Projecto:</strong> Nome</p>
<p><strong>Tarefa:</strong> #ID - Nome</p>
<p><strong>Duração:</strong> ~XXh YYm</p>
<p><strong>Resultado:</strong> Concluído | Parcial | Bloqueado</p>

<h4>Trabalho Realizado</h4>
<ul>
  <li>Acção 1</li>
  <li>Acção 2</li>
</ul>

<h4>Ficheiros Modificados</h4>
<ul>
  <li><code>path/file.ext</code> - descrição</li>
</ul>

<h4>Problemas / Soluções</h4>
<ul>
  <li><strong>Problema:</strong> Descrição
      <br><strong>Solução:</strong> Como foi resolvido</li>
</ul>

<h4>Padrões Detectados</h4>
<ul>
  <li>Padrão identificado e impacto</li>
</ul>

<h4>Acções Sugeridas</h4>
<p><em>Detalhes na discussão #33</em></p>
<ul>
  <li>[Tipo] Descrição breve</li>
</ul>

<h4>Próximos Passos</h4>
<ol>
  <li>Tarefa pendente 1</li>
</ol>
```

---

## Formato Acções (Discussão #33)

Cada acção num comentário separado:

```html
<p>- [ ] [Tipo] Descrição da acção</p>
<p><strong>Origem:</strong> Worklog YYYY-MM-DD HH:MM</p>
<p><strong>Prioridade:</strong> P1/P2/P3</p>
<p><strong>Contexto:</strong> Breve explicação</p>
```

**Tipos:** `[CLAUDE.md]`, `[Skill]`, `[MCP]`, `[Workflow]`, `[Bug]`, `[Feature]`

---

## /worklog view

```
1. mcp__desk-crm-v3__get_project_discussions({ project_id: 65 })
2. Filtrar discussão #31
3. Mostrar últimos 5 comentários
```

---

## /reflect deep (Análise Profunda)

Análise mais detalhada que o worklog normal. Publica em discussão **#32** (Reflexões).

```
1. Ler comentários recentes de #31 (worklogs) e #32 (reflexões)
2. Analisar padrões repetidos
3. Comparar eficiência com sessões anteriores
4. Verificar TaskForces utilizadas (ver Integração TaskForce)
5. Gerar comentário detalhado em #32
6. Acções em #33
7. Memória Supabase
```

---

## /reflect week (Revisão Semanal)

Chamado automaticamente pelo `/today` às segundas-feiras. Publica em **#32**.

```
1. Ler comentários de #31 e #32 da semana
2. Agregar padrões e métricas
3. Gerar resumo semanal
4. Identificar melhorias prioritárias
```

**Formato:**

```html
<h4>Semana YYYY-WNN - Revisão</h4>

<h4>Métricas</h4>
<table>
  <tr><td>Sessões registadas</td><td>N</td></tr>
  <tr><td>Reflexões geradas</td><td>M</td></tr>
  <tr><td>Padrões detectados</td><td>P</td></tr>
</table>

<h4>Padrões Frequentes</h4>
<ol><li>Padrão A - Nx detectado</li></ol>

<h4>Melhorias Prioritárias</h4>
<ul>
  <li>[ ] [P1] Descrição</li>
  <li>[ ] [P2] Descrição</li>
</ul>

<h4>Plano Esta Semana</h4>
<ul>
  <li>Implementar: X</li>
  <li>Monitorar: Y</li>
</ul>
```

---

## Integração /time

Quando `/time stop` é executado:

```
1. Timer parado
2. Mostrar resumo (tarefa, duração)
3. Perguntar: "Criar worklog? [Sim/Não]"
4. Se sim → Gerar worklog com contexto do timer
```

---

## Auto-Save Memória

| Tipo | Exemplo | Guardar? |
|------|---------|----------|
| Solução técnica nova | Fix para erro MCP | Sim |
| Configuração sistema | Novo MCP configurado | Sim |
| Workaround descoberto | Bypass para bug | Sim |
| Padrão novo | "X funciona melhor que Y" | Sim |
| Decisão arquitectural | Escolha de abordagem | Sim |
| Trabalho rotineiro | Updates, limpeza | Não |

---

## Checklist de Reflexão

Perguntas ao analisar sessão:

- O sistema respondeu bem aos pedidos?
- Houve confusão ou mal-entendidos?
- Alguma tarefa repetitiva deveria ser skill?
- Faltou informação que deveria estar em memória?
- Alguma regra CLAUDE.md foi violada?
- Os MCPs funcionaram correctamente?
- Algum TaskForce foi utilizado? Registar métricas.

---

## Auto-Alerts Data-Driven

| Alerta | Threshold | Acção |
|--------|-----------|-------|
| Degradação performance | >15% vs baseline (7d) | Investigar causa |
| Error rate alto | >10% (30d) | Analisar erros |
| KB offline | 3 timeouts | Verificar MCP |

**Formato alerta:** Inclui componente, tipo, threshold, valor actual, investigação e acções sugeridas.

---

## Integração TaskForce (para /reflect deep)

```
1. LER ~/.claude/sdks/_registry.json
2. COMPARAR com skills/agents usados na sessão
3. SE match: adicionar secção "SDKs Utilizados" com tempo e baseline
```

---

## Auto-Trigger

| Trigger | Acção |
|---------|-------|
| >10 tool calls | Gerar worklog background |
| Parar timer | Oferecer criar worklog |
| Mudança de projecto | Fechar sessão anterior |
| Mesmo erro 2+ vezes | Analisar causa |
| Segunda-feira via /today | Revisão semanal |

---

## Anti-Patterns

- **NUNCA** criar worklog sem dados de sessão
- **NUNCA** usar Markdown em comentários (usar HTML)
- **NUNCA** guardar memória para trabalho rotineiro
- **NUNCA** duplicar reflexão e worklog (são o mesmo)

---

## Changelog

### v4.0.0 (2026-02-06)
- Fusão de /worklog e /reflect numa skill unificada
- /reflect torna-se alias de /worklog
- Discussão #31 recebe tudo (worklog + reflexão)
- Discussão #32 reservada para /reflect deep e /reflect week
- Checklist de reflexão integrado
- Auto-alerts data-driven integrados
- Integração TaskForce mantida para /reflect deep

### v3.0.0 (2026-02-05)
- Integração completa com /time
- Auto-trigger ao parar timer
- Formato HTML alinhado com Regra #27

---

*Skill v4.0.0 | 2026-02-06 | Descomplicar(R)*