---
name: review-corrections
description: >
  Analisa correcções feitas pelo utilizador nas últimas sessões e gera sugestões
  de regras para CLAUDE.md. Lê ~/.claude-work/corrections.jsonl, agrupa por padrão,
  e propõe melhorias concretas. Usar semanalmente (via /schedule) ou quando há >5
  correcções acumuladas. Faz parte do loop de auto-melhoria (Eixo 3, Stack Q2 2026).
---

# /review-corrections — Análise de Correcções e Auto-melhoria

Analisa padrões de correcção do utilizador para melhorar o CLAUDE.md autonomamente.

---

## Workflow

### Passo 1 — Ler ficheiro de correcções

```bash
cat ~/.claude-work/corrections.jsonl
```

Cada linha é um JSON:
```json
{"ts":"2026-04-06T14:30:00","type":"correction","prompt":"não assim, usa grep","session":"abc","cwd":"/Hub/"}
```

### Passo 2 — Agrupar por padrão

Categorias de correcção:

| Padrão | Keywords | Acção sugerida |
|--------|---------|----------------|
| **Ferramenta errada** | "usa grep", "não uses bash", "usa read" | Regra de preferência de ferramenta |
| **Língua/formato** | "em português", "sem emojis", "com acentos" | Regra de output |
| **Abordagem** | "não assim", "de outra forma", "mais simples" | Regra de heurística |
| **Scope** | "não faças isso", "não toques em", "só X" | Regra de limites |
| **Verificação** | "verifica primeiro", "não inventar", "confirma" | Regra anti-alucinação |

### Passo 3 — Gerar sugestões de regras

Para cada padrão com ≥2 ocorrências, propor regra no formato:

```markdown
**Regra candidata:**
> [Padrão detectado N vezes] → Sugestão: "Nunca [X], sempre [Y]"

**Evidência:**
- "prompt1" (data)
- "prompt2" (data)

**Proposta CLAUDE.md:**
| NN | [Texto da regra concisa] |
```

### Passo 4 — Apresentar ao utilizador

```markdown
## Revisão de Correcções — [data]

**Total analisado:** N correcções em M sessões
**Padrões encontrados:** P

### Regras candidatas (aprovação necessária)

[lista de propostas]

### Limpar ficheiro?
[ ] Sim — arquivar em ~/.claude-work/corrections-archive-YYYY-MM.jsonl
[ ] Não — manter para próxima revisão
```

### Passo 5 — Aplicar regras aprovadas

Se o utilizador aprovar uma regra:
1. Abrir `~/.claude/CLAUDE.md`
2. Adicionar na tabela de REGRAS CORE com número sequencial
3. Confirmar: "Regra #NN adicionada."

Se o utilizador recusar:
- Arquivar correcção com tag `rejected`
- Não propor de novo

---

## Quando usar

- **Semanal** (via `/schedule` às segundas-feiras com `/today`)
- **Manual** quando corrections.jsonl tem >5 entradas
- **Após incidente** (mesmo erro 2+ vezes consecutivos)

---

## Integração auto-trigger

O hook `capture-corrections.sh` regista automaticamente em `~/.claude-work/corrections.jsonl`.
Esta skill consome esse ficheiro e fecha o loop de auto-melhoria.

**Loop completo:**
```
Correcção utilizador
  → capture-corrections.sh (regista)
  → /review-corrections (analisa)
  → CLAUDE.md (actualiza)
  → Comportamento melhora
```

---

## Anti-patterns

- Nunca aplicar regras sem aprovação explícita do utilizador
- Nunca propor regras com <2 ocorrências (pode ser caso isolado)
- Nunca eliminar regras existentes — apenas adicionar ou reformular

---

*Skill v1.0.0 | 06-04-2026 | Descomplicar®*

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
