claude-plugins/plugins/learn/rules/memory-format.md

paths

paths
.claude/rules/claude-learn-*.md

Claude Learn Memory Format

Acest fișier definește formatul pentru fișierele de memorie per domeniu.

Arhitectura Fișierelor

.claude/rules/
├── claude-learn-domains.md      # Configurația domeniilor
├── claude-learn-backend.md      # Memorie backend (paths: src/api/**)
├── claude-learn-frontend.md     # Memorie frontend (paths: src/components/**)
├── claude-learn-database.md     # Memorie database (paths: src/db/**)
├── claude-learn-testing.md      # Memorie testing (paths: **/*.test.ts)
├── claude-learn-deployment.md   # Memorie deployment (paths: Dockerfile, *.yml)
└── claude-learn-global.md       # Memorie globală (fără paths - mereu încărcat)

Template Fișier Domeniu

---
paths: src/api/**/*.ts, src/server/**/*.ts
---

# Claude Learn Memory: backend

Patterns și Gotchas pentru domeniul **backend**.

---

## Patterns

### {Titlu Descriptiv}
**Discovered**: {YYYY-MM-DD} (feature: {context-scurt})
**Source**: {source} | **Confidence**: {confidence} | **Reinforced**: 0
**Trigger**: "{fraza care a declanșat salvarea}"
**Description**: {Descriere clară a pattern-ului și când să-l folosești}

**Example** (`{file}:{lines}`):
\```{language}
{cod exemplu}
\```

**Tags**: {tag1}, {tag2}, {tag3}

---

## Gotchas

### {Titlu Descriptiv}
**Discovered**: {YYYY-MM-DD} (feature: {context-scurt})
**Source**: {source} | **Confidence**: {confidence} | **Reinforced**: 0
**Trigger**: "{fraza care a declanșat salvarea}"
**Problem**: {Ce problemă a apărut}
**Solution**: {Cum s-a rezolvat}

**Tags**: {tag1}, {tag2}, {tag3}

---

## Domain Statistics

- **Total Patterns**: 0
- **Total Gotchas**: 0
- **Total Reinforcements**: 0
- **Last Session**: -
- **Sessions Recorded**: 0
- **Last Cleanup**: -

Template Fișier Global

Fișierul claude-learn-global.md NU are frontmatter paths: și se încarcă întotdeauna:

# Claude Learn Memory: global

Patterns și Gotchas universale, aplicabile tuturor domeniilor.

---

## Patterns

...

## Gotchas

...

## Domain Statistics

...

---

Câmpuri Metadata (v2.1.0)

Fiecare entry include acum metadata pentru tracking și curățare.

Source

Cum a fost capturat entry-ul:

Valoare	Descriere	Scor Cleanup
explicit	Utilizatorul a cerut explicit salvarea ("ține minte", "remember")	+40
repeated	Corecție repetată de 2+ ori pe același subiect	+30
inferred	Dedus din conversație (eroare rezolvată, pattern detectat)	-10

Confidence

Nivelul de încredere în utilitatea entry-ului:

Valoare	Descriere	Scor Cleanup
high	Semnal puternic (comandă explicită, corecție repetată)	+20
medium	Semnal moderat (preferință inferată, referință istorică)	0
low	Semnal slab (one-time fix posibil util)	-20

Reinforced

Numărul de ori când entry-ul a fost folosit sau validat în sesiuni ulterioare.

Valoare	Interpretare	Scor Cleanup
0	Niciodată folosit	-30 (dacă > 30 zile)
1-2	Folosit ocazional	+20
3+	Entry valoros, foarte folosit	+50

Trigger

Fraza originală care a declanșat salvarea. Util pentru:

• Audit: de ce a fost salvat acest entry?
• Cleanup: context pentru decizia de ștergere
• Debugging: verificare sistem de detecție semnal

---

Format Pattern (Complet)

### {Titlu Descriptiv}
**Discovered**: {YYYY-MM-DD} (feature: {context-scurt})
**Source**: {source} | **Confidence**: {confidence} | **Reinforced**: {count}
**Trigger**: "{fraza care a declanșat salvarea}"
**Description**: {Descriere clară a pattern-ului și când să-l folosești}

**Example** (`{file}:{lines}`):
\```{language}
{cod exemplu}
\```

**Tags**: {tag1}, {tag2}, {tag3}

---

Format Gotcha (Complet)

### {Titlu Descriptiv}
**Discovered**: {YYYY-MM-DD} (feature: {context-scurt})
**Source**: {source} | **Confidence**: {confidence} | **Reinforced**: {count}
**Trigger**: "{fraza care a declanșat salvarea}"
**Problem**: {Ce problemă a apărut}
**Solution**: {Cum s-a rezolvat}

**Tags**: {tag1}, {tag2}, {tag3}

---

---

Convenții

1. Titluri: Folosește titluri descriptive, nu generice

   • ✅ "Vue Watch Needs Immediate Flag for Initial Load"
   • ❌ "Vue Problem"

2. Tags: Folosește kebab-case, maxim 5 tags per entry

   • ✅ vue, reactivity, watch, initialization
   • ❌ Vue.js, REACTIVITY, this is a tag

3. Exemple: Include întotdeauna cod exemplu când e posibil

4. Context: Folosește feature name scurt pentru context

   • ✅ (feature: user-dashboard)
   • ❌ (feature: implementing the new user dashboard with stats and charts)

5. Frontmatter: Fiecare fișier de domeniu (exceptând global) TREBUIE să aibă frontmatter cu paths:

   • Paths-urile trebuie să corespundă cu cele din claude-learn-domains.md

6. Trigger: Păstrează fraza originală, fără modificări

   • ✅ "ține minte să folosești camelCase"
   • ❌ "utilizatorul a cerut camelCase"

---

Backward Compatibility

Entries vechi fără câmpurile noi sunt tratate ca:

• Source: inferred
• Confidence: medium
• Reinforced: 0
• Trigger: ""

La prima editare sau reinforcement, metadata va fi adăugată automat.

---

Statistici Domeniu

Fiecare fișier de domeniu include statistici la final:

## Domain Statistics

- **Total Patterns**: {N}
- **Total Gotchas**: {M}
- **Total Reinforcements**: {R}
- **Last Session**: {YYYY-MM-DD}
- **Sessions Recorded**: {X}
- **Last Cleanup**: {YYYY-MM-DD}

Aceste statistici sunt actualizate automat de:

• /learn:analyze - incrementează patterns/gotchas, sessions
• /learn:cleanup - decrementează la ștergeri, actualizează Last Cleanup
• Reinforcement tracking - incrementează Total Reinforcements