# /report — 5W2H + PDCA Report

Estrutura formal de conclusão de tarefas/etapas com análise 5W2H + PDCA.

## Uso Rápido

```bash
/report              # Report completo (interactivo)
/report --quick      # Versão resumida (3 campos)
/report --auto       # Auto-detectado de contexto
```

## O Que Faz

| Função | Tempo | Output |
|--------|-------|--------|
| **5W2H** | <2 min | Tabela QUÊ/QUEM/QUANDO/ONDE/POR QUÊ/COMO/CUSTO |
| **PDCA** | <2 min | Ciclo Plan/Do/Check/Act |
| **Docs** | <1 min | README, CHANGELOG, PROC se relevante |
| **Memória** | <1 min | Entry mem0 Wayland v2 |
| **Desk** | <1 min | Comment em discussão #33 se .desk-project |

## Exemplo

```bash
/report
```

**Output:**
```
# 5W2H Report — Criar skill /qw

| Campo | Resposta |
|-------|----------|
| QUÊ | Skill /qw para recapitulação rápida sesões |
| 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 de sesões curtas
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)

### CHECK
✅ SKILL.md conforme template
✅ README com 3 flags
✅ Prompts documentados
✅ Plugin integrado
⚠️ Teste /qw ainda pendente

### ACT
Próximo: Teste manual /qw
Validar mem0 entries criadas
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])

---

⏱️ Report: 2 min 15s | COMPLETO
```

## Integração CARL

**Domínio:** TASK-COMPLETION-REPORT  
**Triggers:** "concluído", "finalizado", "pronto", "terminado", "etapa completa"  
**Auto-disparo:** Sim (sem confirmação necessária)

## Estrutura 5W2H

| Campo | Descrição | Exemplo |
|-------|-----------|---------|
| **QUÊ** | Deliverable/resultado | "Skill /qw criada" |
| **QUEM** | Executor (staff_id) | "claude (25)" |
| **QUANDO** | Timestamp início-fim | "16:00–16:45 (45 min)" |
| **ONDE** | Ficheiro/pasta/sistema | "~/.claude/plugins/.../gestao/" |
| **POR QUÊ** | Objectivo/motivação | "Complemento /worklog para sesões curtas" |
| **COMO** | Método/processo | "Criação skill com SKILL.md + README + prompts" |
| **CUSTO** | Tempo estimado vs real | "Est: 30 min → Real: 45 min (+50%)" |

## Ciclo PDCA

1. **PLAN** — Spec original, criteria de sucesso, scope
2. **DO** — Passos executados, decisões, desvios documentados
3. **CHECK** — Resultado vs criteria, gaps, testes
4. **ACT** — Ajustes necessários, próximas acções, melhorias

## Flags

### `--quick`
Report resumido — apenas 3 campos (QUÊ, COMO, RESULTADO).

### `--auto`
Auto-detecta contexto:
- Git: commits e ficheiros alterados
- Desk: task_id e tempo loggado
- .desk-project: extrai dados de projecto
- Timer activo: usa duração real

## Output

- **Resumo visual:** Tabela 5W2H
- **Análise:** PDCA em markdown
- **Docs:** README/CHANGELOG/PROC actualizados
- **Memória:** Entry mem0 Wayland v2 criada
- **Desk:** Comment em #33 (se .desk-project)

---

**Versão:** 1.0 | **Data:** 2026-07-02 | **Autor:** Claude (staff_id 25)