# Memory-best-practices
SUMMARY: Hoe u herinneringen structureert voor effectieve recall — categorieën, sleutels, tags, prioriteiten.

Memory-best-practices
Hoe u herinneringen structureert bepaalt hoe nuttig ze zijn. Deze handleiding behandelt
patronen voor het categoriseren, taggen en prioriteren van herinneringen zodat de LLM
de juiste informatie op het juiste moment kan ophalen.
Categorieën: kies de meest specifieke
| Categorie | Gebruik voor | Voorbeeld |
|-----------|--------------|-----------|
|  | Gebruikersnaam, rol, contactgegevens |  |
|  | Voorkeuren, afkeuren, werkstijl |  |
|  | Verifieerbare feiten |  |
|  | Projectstatus, beslissingen |  |
|  | Vaardigheden van de gebruiker |  |
|  | Eerdere fouten om te vermijden |  |
|  | Sessie-relevante context |  |
|  | Diverse notities |  |
> [!TIP]
> Bij twijfel, gebruik  voor verifieerbare info en  voor al het andere.
> Over-categoriseer niet — beter een duidelijke  dan een verwarrende .
Sleutels: betekenisvolle identificatoren
Het -veld is de identificator van de herinnering. Gebruik betekenisvolle, stabiele sleutels:
Goede sleutels:
- 
- 
- 
- 
Slechte sleutels:
-  (niet betekenisvol)
-  (niet beschrijvend)
-  (datum helpt niet bij recall)
Sleutelnaamconventies
-  (kleine letters met underscores)
- Voorvoeg met categorie: , , 
- Gebruik beschrijvende zelfstandige naamwoorden, niet werkwoorden
- Houd onder 50 tekens
Tags: voor zoeken en filteren
Tags maken snelle filtering en zoekopdrachten mogelijk. Voeg 2-5 tags toe per herinnering:
[CODE BLOCK]
Tag-patronen
- Projectnamen: , , 
- Onderwerpen: , , , 
- Status: , , 
- Prioriteitsindicatoren: , 
> [!NOTE]
> Tags zijn niet hoofdlettergevoelig. Gebruik kleine letters voor consistentie.
Prioriteiten: wees realistisch
| Prioriteit | Gebruik voor | % van herinneringen |
|------------|--------------|---------------------|
|  | Gebruikersidentiteit, juridische info, onomkeerbare beslissingen | 5% |
|  | Actieve projecten, belangrijke voorkeuren | 20% |
|  | Meeste feiten, notities, context | 65% |
|  | Efemeer, leuk-om-te-weten | 10% |
> [!WARNING]
> Markeer niet alles . Als alles kritiek is, is niets dat.
> Reserveer  voor dingen die echte schade veroorzaken als ze vergeten worden.
Wanneer wel en niet opslaan
Sla altijd op
- Gebruikersidentiteit (naam, e-mail, rol)
- Langetermijnvoorkeuren
- Projectbeslissingen en rationaal
- Eerdere fouten en geleerde lessen
- Gemaakte toezeggingen aan de gebruiker
- Niet opslaan
- Tijdelijke staat (gebruik variabelen)
- Letterlijke gespreksgeschiedenis (chat-systeem handelt dit af)
- Gevoelige data (wachtwoorden, API-sleutels)
- Gemakkelijk af te leiden feiten (huidige datum, bestandsinhouden)
- Efemere context (gebruik -categorie met lage prioriteit)
Herinneringen bijwerken
POST  met dezelfde  +  werkt de bestaande herinnering bij:
[CODE BLOCK]
> [!TIP]
> Gebruik stabiele sleutels zodat u kunt bijwerken zonder duplicaten te maken. De LLM
> moet dezelfde sleutel opnieuw POSTen als info verandert, niet nieuwe herinneringen maken.
Memory-levenscyclus
[CODE BLOCK]
- Create: POST /memory met volledige context
- Active: Vaak ophalen, zo nodig bijwerken
- Stale: Nog relevant maar niet actief gebruikt (lagere prioriteit?)
- Archive: Stel prioriteit in op , bewaar voor historische referentie
- Delete: DELETE /memory/:id wanneer niet meer relevant
Periodieke opschoning
[CODE BLOCK]
Patroon: memory-overerving
Voor hiërarchische context (project → subproject → taak):
[CODE BLOCK]
De LLM kan dan  zoeken om alle gerelateerde herinneringen te vinden.
Patroon: beslissingslogboek
Sla beslissingen met rationaal op zodat de LLM ze niet heroverweegt:
[CODE BLOCK]
Patroon: foutvermijding
Sla fouten op met specifieke vermijdingsinstructies:
[CODE BLOCK]
Anti-patronen om te vermijden
> [!WARNING]
> - Gesprekslogs opslaan — chat-systeem handelt dit af
> - Volledige bestanden opslaan — gebruik script store of externe opslag
> - Efemere staat opslaan — gebruik variabelen
> - Geheimen opslaan — gebruik omgevingsvariabelen
> - Herinneringen dupliceren — gebruik stabiele sleutels
> - Over-taggen — 2-5 tags per herinnering is ideaal
> - Alles is kritiek — wees realistisch met prioriteiten
Volgende stappen
- Memory API
- Permanente LLM-agent
- Memory-tagging-strategie