claude-plugins/gestao/skills/report-5w2h/SKILL.md

name, description

name	description
report	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:

# 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

• 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)