claude-plugins/gestao/skills/qw/prompts/examples.md

Exemplos de Uso — /qw

Exemplo 1: Criar Ficheiro Novo

Contexto: Acabaste de criar novo-modulo.js com 150 linhas.

/qw

Processamento automático:

1. Detecta novo ficheiro: novo-modulo.js
2. Actualiza README.md secção "Estrutura" com: - novo-modulo.js — módulo XYZ
3. Cria memória mem0:
   • Subject: "novo-modulo.js"
   • Predicate: "criado para"
   • Object: "funcionalidade XYZ"
   • Tags: "feature", "javascript"
   • Tier: "project"

Output:

✅ Quick Wrap-up — 2026-07-02 14:23

📝 RESUMO
• novo-modulo.js criado — 150 linhas, export default class XYZ
• README actualizado — secção Estrutura
• Memória guardada — mem0 (feature/javascript)

📦 FICHEIROS
 + novo-modulo.js
 ~ README.md

💾 MEM0 ID: mem0_abc123...

⏱️ 38s | OK

---

Exemplo 2: Bugfix + Docs

Contexto: Corrigiste bug em auth.js linha 45 (return typo).

/qw

Processamento:

1. Detecta ficheiro alterado: auth.js
2. Actualiza CHANGELOG.md em ## [Unreleased]:

   - 2026-07-02 [auth] Corrigido typo return em validação token
   

3. Memória mem0:
   • Subject: "auth.js"
   • Predicate: "bugfix"
   • Object: "return typo validação token (linha 45)"
   • Tags: "bugfix", "javascript"

Output:

✅ Quick Wrap-up — 2026-07-02 14:25

📝 RESUMO
• auth.js corrigido — typo return em validação token (linha 45)
• CHANGELOG actualizado — entrada [Unreleased]
• Memória guardada — mem0 (bugfix/javascript)

📦 FICHEIROS
 ~ auth.js

💾 MEM0 ID: mem0_def456...

⏱️ 22s | OK

---

Exemplo 3: Usar Flag --docs

Contexto: Já refiste 3 ficheiros mas esqueceste de actualizar README.

/qw --docs

Processamento:

1. Detecta ficheiros alterados
2. Apenas actualiza README/CHANGELOG
3. Omite resumo e memória
4. Output minimalista

Output:

✅ Docs Updated — 2026-07-02 14:27

📦 FICHEIROS
 ~ README.md
 ~ CHANGELOG.md

⏱️ 8s | OK

---

Exemplo 4: Usar Flag --mem

Contexto: Descobriste um padrão interessante durante a sessão.

/qw --mem

Processamento:

1. Pede input: "Qual o insight para guardar?"
2. Utilizador responde: "Usar useCallback para memoização em loops React"
3. Formata e guarda em mem0
4. Output: apenas ID memória

Output:

💾 MEM0 Saved

ID: mem0_ghi789...
Entrada: "useCallback | memoização | loops React evita re-renders"
Tags: react, performance, padrão
Tier: global

⏱️ 15s | OK

---

Exemplo 5: Integração com Desk CRM

Contexto: Estás a trabalhar na tarefa #2401 do Desk.

/qw

Processamento automático (se .desk-project detectado):

1. Lê .desk-project → tarefa_id = 2401
2. Gera resumo com link à tarefa
3. Memória mem0 inclui ref task_id

Output:

✅ Quick Wrap-up — 2026-07-02 14:30

📝 RESUMO
• Tarefa #2401 — implementação API endpoint /users
• Documentação atualizada — docs/api.md com endpoint spec
• Memória guardada — mem0 com ref task #2401

📦 FICHEIROS
 + src/api/endpoints/users.js
 ~ docs/api.md

💾 MEM0 ID: mem0_jkl012... [task_id: 2401]

⏱️ 35s | OK

---

Exemplo 6: Nenhum Ficheiro Alterado

Contexto: Tiveste uma sessão de investigação/leitura apenas (sem edições).

/qw

Processamento:

1. Detecta: sem Edit/Write calls
2. Omite output (nada para registar)
3. Log silencioso: [QW] Nada para registar — sessão leitura

Output:

ℹ️ Quick Wrap-up

Nenhum ficheiro alterado nesta sessão. Omitido.

---

Checklist Implementação (Para Testar)

• Criar novo ficheiro, rodar /qw, verificar README/CHANGELOG
• Editar ficheiro existente, rodar /qw, verificar CHANGELOG
• Testar /qw --docs (só docs)
• Testar /qw --mem (só memória, com input)
• Verificar mem0 entries criadas em gateway.descomplicar.pt
• Testar em projecto com .desk-project (task link)
• Testar sem alterações (nada para registar)

---

Versão: 1.0 | 2026-07-02