# Exemplos de Uso — /qw

## Exemplo 1: Criar Ficheiro Novo

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

```bash
/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).

```bash
/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.

```bash
/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.

```bash
/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.

```bash
/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).

```bash
/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