---
name: qw
description: "Recapitulação rápida de sessão — resumo conciso do trabalho feito, actualização de docs e memória mem0. Uso: /qw ao finalizar tarefa ou sessão curta. Complemento leve ao /worklog."
---

# /qw v1.0 — Quick Wrap-up (Recapitulação Rápida)

**⚠️ EXECUÇÃO INLINE OBRIGATÓRIA — NUNCA FORK**

Protocolo simples e rápido (máx 2 min) para fechar sesões curtas ou tarefas isoladas. Complemento ao `/worklog` (pesado).

---

## Comandos

| Comando | Função |
|---------|--------|
| `/qw` | Recapitulação rápida + mem0 |
| `/qw --docs` | Actualizar docs (README, CHANGELOG) |
| `/qw --mem` | Guardar memória mem0 apenas |

---

## Protocolo Principal (/qw)

```
1. Obter hora actual (mcp__mcp-time__current_time)
2. RESUMIR sessão em máx 3 bullets:
   - Ficheiro(s) modificado(s) + linha brevíssima do quê
   - Problema resolvido / Tarefa finalizada
   - Padrão/insight (se relevante)
3. ACTUALIZAR docs (escolher 1):
   a. Se ficheiro novo: adicionar linha ao README (secção "Estrutura" ou similar)
   b. Se ficheiro existente alterado: actualizar CHANGELOG (formato: - YYYY-MM-DD Descrição)
   c. Se nenhum doc relevante: omitir
4. GUARDAR memória mem0:
   - Tipo: semantic (P3) — facto conciso e reutilizável
   - Tags: mínimo 2 (ex: "task", "bugfix" ou "feature", "integracao")
   - Conteúdo: "O que foi feito + resultado" (máx 80 chars)
   - tier: global se cross-projecto, project se específico
5. OUTPUT:
   - Resumo legível
   - Ficheiros afectados
   - Link memória (se criada)
```

---

## Exemplo de Uso

**Input:**
```
/qw
```

**Output (gerado automático):**
```
✅ Quick Wrap-up — 2026-07-02 16:45

📝 RESUMO
• qw/SKILL.md criada — skill recapitulação rápida
• docs atualizados — README.md com link nova skill
• memória guardada (mem0) — meta skill gestao/qw

📦 FICHEIROS
 - ~/.claude/plugins/.../gestao/skills/qw/SKILL.md (novo)
 - ~/.claude/plugins/.../gestao/README.md (actualizado)

💾 MEM0
 ID: mem0_xyz... 
 "Criada skill /qw para recapitulação sessões curtas"
 Tags: skill, gestao

---
⏱️ Duração: 45s | Estado: OK
```

---

## Storage

Memória mem0 (gateway.descomplicar.pt/v1/mem0/mcp):
- **Protocolos:** Wayland v2 (P5/P4/P3, tags, tier)
- **Limite:** máx 80 chars por entrada
- **Dedup:** pesquisar com `mcp__mem_search_memories` antes de gravar (IJFW foi descontinuado e removido — Mem0 é o único store canónico)
- **Tier:** `global` para skill/padrão cross-projecto, `project` para específico

---

## Variantes

### `/qw --docs` (Actualizar Docs)
Apenas actualiza README/CHANGELOG sem resumo:
```
- Procura README ou CHANGELOG na pasta actual (até 2 níveis acima)
- Insere/actualiza entrada
- Omite memória e resumo
```

### `/qw --mem` (Memória Apenas)
Apenas guarda mem0, sem resumo:
```
- Pede prompt: "Qual o insight para guardar?"
- Formata e guarda via mem0 MCP
- Output: ID memória apenas
```

---

## Integração com Plugin gestao

Local: `~/.claude/plugins/marketplaces/descomplicar-plugins/gestao/skills/qw/`

Ficheiros:
- `SKILL.md` — este ficheiro
- `prompts/` — templates de prompts (se necessário)

Regra CLAUDE.md: Skills gestao executam INLINE (nunca fork). Sem subagentes.

---

## Checklist Implementação

- [x] SKILL.md criada
- [ ] Skill registada em plugin.json (gestao)
- [ ] Prompts adicionados (se necessário)
- [ ] Teste manual: `/qw`
- [ ] Teste com --docs flag
- [ ] Teste com --mem flag
- [ ] Validação mem0 (verificar entrada criada)

---

**Versão:** 1.0 | **Data:** 2026-07-02 | **Plugin:** gestao | **Staff:** 25 (Claude)