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

description

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

## 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ță