claude-plugins/plugins/learn/commands/reflect.md

---
description: Sintetizează patterns din mai multe sesiuni și curăță duplicatele
---

# Reflecție și Sinteză Memory

Analizează toate domeniile și:
1. Identifică duplicate în cadrul și între domenii
2. Consolidează patterns similare
3. Propune mutări între domenii
4. Identifică candidați pentru promovare în CLAUDE.md sau în `global`

## Workflow

### 1. Scanează Toate Fișierele de Memorie

Încarcă toate `claude-learn-*.md` din `.claude/rules/`:
- backend, frontend, database, testing, deployment, global
- + orice domeniu custom

Dacă nu există niciun fișier:
```
ℹ️ Nu există încă fișiere de memorie.
Rulează /learn:analyze pentru a crea primul entry.
```

### 2. Construiește Index Global

Pentru toate entries din toate domeniile:
- Colectează tags
- Colectează titluri
- Mapează dependencies între domenii

### 3. Analizează Conținut

#### 3.1 Duplicate Intra-Domeniu
Entries similare în același domeniu:
```
🔄 Duplicate în [backend]:
- "API Rate Limiting" și "Rate Limit Middleware" sunt similare
```

#### 3.2 Duplicate Cross-Domeniu
Entries similare în domenii diferite:
```
🔄 Duplicate cross-domain:
- [backend] "TypeScript Strict Mode"
- [frontend] "TypeScript Configuration"
→ Propun consolidare în [global]
```

#### 3.3 Entries în Domeniu Greșit
Bazat pe tags și path-uri din exemple:
```
⚠️ Posibile entries în domeniu greșit:
- [backend] "CSS Grid Layout" → propun mutare în [frontend]
- [testing] "Database Migrations" → propun mutare în [database]
```

#### 3.4 Candidați pentru Global
Patterns care apar în 2+ domenii sau au tags universale:
```
⭐ Candidați pentru [global]:
- Tag "typescript" apare în backend (5), frontend (4), testing (2)
- Tag "error-handling" apare în backend (3), frontend (2)
```

#### 3.5 Candidați pentru CLAUDE.md
Patterns frecvente (3+ entries cu aceleași tags):
```
⭐ Candidați pentru CLAUDE.md:
- "api" (7 entries) → propun secțiune "API Conventions"
- "vue" (5 entries) → propun secțiune "Vue Development"
```

#### 3.6 Entries Învechite
Entries mai vechi de 90 zile:
```
🗑️ Posibil învechite (>90 zile):
- [backend] "Express 4.x Middleware" - 120 zile
- [frontend] "Webpack 4 Config" - 95 zile
```

### 4. Prezintă Raport

```
📊 Raport Reflecție Memory

Statistici per domeniu:
┌────────────┬──────────┬─────────┐
│ Domain     │ Patterns │ Gotchas │
├────────────┼──────────┼─────────┤
│ backend    │ 12       │ 5       │
│ frontend   │ 8        │ 3       │
│ database   │ 4        │ 2       │
│ global     │ 2        │ 1       │
├────────────┼──────────┼─────────┤
│ TOTAL      │ 26       │ 11      │
└────────────┴──────────┴─────────┘

🔄 Duplicate găsite: 3
- [backend] "API Rate Limiting" ↔ "Rate Limit Middleware"
- [backend/frontend] "TypeScript Strict" (cross-domain)
- ...

⚠️ Domeniu greșit: 2
- [backend] "CSS Grid" → frontend
- [testing] "DB Migrations" → database

⭐ Promovare în [global]: 2
- "TypeScript Configuration" (apare în 3 domenii)
- "Error Handling Pattern" (apare în 2 domenii)

⭐ Promovare în CLAUDE.md: 1
- "API Conventions" (7 entries cu tag "api")

🗑️ Învechite: 2
- [backend] "Express 4.x" - 120 zile
- [frontend] "Webpack 4" - 95 zile

Acțiuni disponibile:
- [consolidate] - Consolidează duplicatele
- [move] - Mută entries în domeniile corecte
- [promote-global] - Mută candidații în [global]
- [promote-claude] - Adaugă în CLAUDE.md
- [archive] - Arhivează entries vechi
- [all] - Toate acțiunile
- [none] - Doar raportul
```

### 5. Consolidează Duplicate (dacă selectat)

Pentru duplicate intra-domeniu:
- Merge în entry-ul mai recent/complet
- Șterge duplicatul
- Păstrează toate tags-urile

Pentru duplicate cross-domeniu:
- Creează entry nou în `global`
- Șterge din domeniile originale

### 6. Mută în Domeniu Corect (dacă selectat)

- Mută entry-ul în fișierul domeniului corect
- Șterge din fișierul original
- Actualizează statisticile ambelor fișiere

### 7. Promovează în Global (dacă selectat)

- Creează entry consolidat în `claude-learn-global.md`
- Opțional: șterge duplicatele din domeniile originale

### 8. Promovează în CLAUDE.md (dacă selectat)

- Identifică CLAUDE.md din proiect
- Propune secțiuni noi bazate pe patterns frecvente
- Prezintă diff pentru aprobare

```markdown
## Propunere pentru CLAUDE.md

### API Conventions

Bazat pe 7 patterns din memory:

- All API responses follow the format: `{data, error, meta}`
- Use middleware for validation
- Rate limit all public endpoints

[Accept? y/n/edit]
```

### 9. Arhivează Vechi (dacă selectat)

Două opțiuni:
1. Mută în secțiune `## Archived` la sfârșitul fișierului
2. Șterge complet (cu confirmare explicită)

### 10. Confirmă

```
✅ Reflecție completă:

Acțiuni efectuate:
- 2 duplicate consolidate
- 2 entries mutate în domeniile corecte
- 1 pattern promovat în [global]
- 1 secțiune adăugată în CLAUDE.md
- 2 entries arhivate

Statistici actualizate:
- Total: 24 patterns, 10 gotchas în 5 domenii
- Global: 3 patterns, 1 gotcha
```

## Când să rulezi /learn:reflect

- După 10+ sesiuni de /learn:analyze
- Când ai 20+ entries total
- Când observi duplicate evidente
- Înainte de release-uri mari
- Lunar, pentru mentenanță