---
name: report
description: Report 5W2H+PDCA ao terminar tarefa/etapa — estrutura formal de conclusão com análise de resultados, documentação e memória. Integrado no domínio TASK-COMPLETION-REPORT do CARL.
---

# /report v1.0 — 5W2H + PDCA Report

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

Protocolo formal ao terminar tarefa/etapa. Estrutura: 5W2H (QUÊ/QUEM/QUANDO/ONDE/POR QUÊ/COMO/CUSTO) + PDCA (Plan/Do/Check/Act).

---

## Comandos

| Comando | Função |
|---------|--------|
| `/report` | Report completo 5W2H+PDCA (interactivo) |
| `/report --quick` | Versão resumida (3 campos) |
| `/report --auto` | Auto-detectado de contexto (git, ficheiros, etc) |

---

## Protocolo Principal (/report)

```
1. RECOLHER 5W2H (interactivo ou auto-detectado):
   QUÊ    → O que foi entregue/resultado (deliverable)
   QUEM   → Executor (staff_id 25 ou outro)
   QUANDO → Timestamp início/fim
   ONDE   → Ficheiro/pasta/sistema/Desk task
   POR QUÊ → Objectivo/motivação original
   COMO   → Método/processo aplicado
   CUSTO  → Tempo estimado vs. real (em minutos)

2. RECOLHER PDCA (estruturado):
   PLAN   → Spec original, success criteria, scope
   DO     → Passos executados, decisões, desvios documentados
   CHECK  → Resultado vs. criteria, gaps detectados, testes
   ACT    → Ajustes necessários, próximas acções, melhorias

3. DOCUMENTAR:
   a. Se novo ficheiro/sistema → README secção "Estrutura"
   b. Se processo → criar PROC-*.md em Hub/06-Operacoes/Procedimentos/
   c. CHANGELOG.md → linha em ## [Unreleased] com resumo
   d. Se SEM docs relevantes → omitir

4. GUARDAR MEM0 (Wayland v2):
   - subject | predicate | object (máx 80 chars)
   - tags: mínimo 2 (task, feature, bugfix, etc)
   - tier: project ou global
   - Dedup: pesquisar com mcp__mem_search_memories antes (IJFW descontinuado — Mem0 é o store canónico)

5. GUARDAR EM DESK (se .desk-project detectado):
   - Discussão #33 (Acções de Melhoria)
   - Format: <h4>5W2H Report — [tarefa/etapa]</h4><p>...</p>
   - HTML estruturado com tabela 5W2H + PDCA
   - staff_id: 25

6. OUTPUT:
   - Resumo visual com tabela 5W2H
   - PDCA análise em markdown
   - Link memória/Desk se criado
   - Timestamp execução
```

---

## Exemplo: Report Completo

**Input:**
```
/report
```

**Processamento (interactivo):**
```
5W2H REPORT — Qual a tarefa/etapa?
> Criar skill /qw

QUÊ (Deliverable)?
> Skill /qw com recapitulação rápida + mem0

QUEM (executor)?
> claude (staff_id 25)

QUANDO (inicio/fim)?
> Auto-detectado: 16:00 - 16:45 (45 min)

ONDE (ficheiro/sistema)?
> ~/.claude/plugins/.../gestao/skills/qw/

POR QUÊ (objectivo)?
> Complemento leve ao /worklog para sesões curtas

COMO (método)?
> Criação skill (SKILL.md + README + prompts)

CUSTO (estimado vs real)?
> Estimado: 30 min, Real: 45 min
```

**Output:**

```markdown
# 5W2H Report — Criar skill /qw

| Campo | Resposta |
|-------|----------|
| QUÊ | Skill /qw para recapitulação rápida |
| QUEM | claude (staff_id 25) |
| QUANDO | 2026-07-02 16:00–16:45 (45 min) |
| ONDE | ~/.claude/plugins/.../gestao/skills/qw/ |
| POR QUÊ | Complemento /worklog para sesões curtas |
| COMO | Criação skill (SKILL.md + README + prompts) |
| CUSTO | Est: 30 min → Real: 45 min (+50% desvio) |

## PDCA

### PLAN
- Objectivo: Skill recapitulação rápida
- Criteria: <2 min execução, mem0 integrado, docs actualizados
- Scope: SKILL.md, README, 2 prompts

### DO
- Criado SKILL.md com protocolo (v1.0)
- Criado README.md com guia + exemplos
- Criado prompts/base.md e examples.md (6 exemplos)
- Plugin gestao actualizado (v1.5.0)
- Desvio: Tempo +50% (escopo expandiu com docs extras)

### CHECK
- ✅ SKILL.md conforme template
- ✅ README com 3 flags
- ✅ Prompts documentados
- ✅ Plugin integrado
- ⚠️ Teste /qw ainda pendente (não validado)

### ACT
- Próximo: Teste manual /qw
- Validar mem0 entries
- Considerar symlink OpenCode
- Documentar tempo real em CHANGELOG

---

## MEM0

ID: mem0_xyz123  
Entry: "Skill /qw criada | propósito | recapitulação rápida sesões"  
Tags: skill, gestao, mem0, recapitulacao  
Tier: global

---

## DOCS UPDATED

✅ plugin.json (v1.4.0 → 1.5.0)  
✅ CHANGELOG.md (entrada [1.5.0])  
✅ SKILL.md criado  
✅ README.md criado  

---

⏱️ Report duração: 2 min 15s | Estado: COMPLETO
```

---

## Flags

### `--quick`
Apenas 3 campos obrigatórios:
```
QUÊ (deliverable)?
COMO (método)?
RESULTADO (sucesso)?
```

### `--auto`
Auto-detecta contexto:
- Git: commits, ficheiros alterados
- Desk: task_id, tempo loggado
- .desk-project: extrai dados
- Timestamp: agora vs. timer activo

---

## Integração CARL

Domínio: **TASK-COMPLETION-REPORT**  
Triggers: "concluído", "finalizado", "pronto", "terminado", "etapa completa"  
Auto-disparo: Sem confirmação (injecção automática)  
Output: Desk #33 ou mem0 conforme contexto

---

## Estrutura 5W2H Obrigatória

| Sigla | Campo | Obrigatório | Max |
|-------|-------|-------------|-----|
| W | QUÊ (What) | Sim | 120 chars |
| W | QUEM (Who) | Sim | 50 chars |
| W | QUANDO (When) | Sim | timestamp |
| W | ONDE (Where) | Sim | path/sistema |
| W | POR QUÊ (Why) | Sim | 100 chars |
| H | COMO (How) | Sim | 150 chars |
| H | CUSTO (How much) | Sim | tempo (min) |

---

## PDCA Obrigatória

| Fase | Campo | Detalhe |
|------|-------|---------|
| **P** | PLAN | Spec original, criteria, scope |
| **D** | DO | Passos, decisões, desvios |
| **C** | CHECK | Resultado vs criteria, gaps |
| **A** | ACT | Ajustes, próximas acções |

---

## Checklist Implementação

- [x] SKILL.md criada
- [ ] Skill registada em plugin.json
- [ ] CARL domínio TASK-COMPLETION-REPORT activado
- [ ] Teste manual: `/report`
- [ ] Teste flag: `--quick`
- [ ] Teste flag: `--auto`
- [ ] Validar Desk #33 entry
- [ ] Validar mem0 entry

---

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