fix(gestao): corrige YAML frontmatter invalido em qw/worklog, remove ijfw_memory_recall morto, recupera report-5w2h perdido, bump 1.6.1

2026-07-04 14:21:39 +01:00
parent 2439e3b41c
commit 49502c59da
8 changed files with 958 additions and 136 deletions
@@ -0,0 +1,136 @@
+# /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)