# Het Memory-model
SUMMARY: Hoe herinneringen zijn gestructureerd — categorieën, sleutels, tags, prioriteiten, bronnen, verificatie.

Het Memory-model
Het memory-model van Synapse is ontworpen voor LLM-agents — gestructureerd genoeg voor
betrouwbare recall, flexibel genoeg voor elk domein.
Anatomie van een herinnering
[CODE BLOCK]
Velden
| Veld | Type | Vereist | Beschrijving |
|------|------|---------|--------------|
|  | string | auto | Unieke ID (memxxx) |
|  | enum | ✅ | Een van 8 categorieën |
|  | string | ✅ | Stabiele identificator (gebruikt voor updates) |
|  | string | ✅ | De memory-inhoud (willekeurige tekst) |
|  | string[] | – | Voor zoeken en filteren |
|  | enum | – | low, normal, high, critical (standaard: normal) |
|  | enum | auto | user, agent (wie heeft het opgeslagen) |
|  | bool | auto | Heeft een mens dit geverifieerd? |
|  | float | – | 0.0 tot 1.0 (standaard: 1.0 voor user, 0.7 voor agent) |
|  | timestamp | – | Wanneer deze herinnering vergeten moet worden |
|  | string | auto | Welke mind eigenaar is |
|  | timestamp | auto | Eerst opgeslagen |
|  | timestamp | auto | Laatst gewijzigd |
Categorieën
Acht categorieën dekken de veelvoorkomende LLM-agent-toepassingen:
| Categorie | Doel | Voorbeeldinhoud |
|-----------|------|-----------------|
|  | Wie de gebruiker is | "Gebruiker is Michael Schäfer, software engineer in Berlin" |
|  | Gebruikersvoorkeuren | "Geeft de voorkeur aan beknopte technische antwoorden" |
|  | Verifieerbare feiten | "Kantoor is in Berlin, tijdzone Europe/Berlin" |
|  | Projectstatus | "Synapse v1.5.0 uitgerold, bezig met v1.6.0 docs" |
|  | Vaardigheden van de gebruiker | "Gevorderd Python, 10+ jaar" |
|  | Eerdere fouten | "Vergeten npm-versie te verhogen — CI faalde" |
|  | Sessie-context | "Momenteel PR #42 aan het beoordelen" |
|  | Diverse notities | "Probeer Redis voor caching in volgende sprint" |
Sleutels: stabiele identificatoren
Het -veld is kritiek — het is hoe u herinneringen bijwerkt zonder duplicaten
te maken.
[CODE BLOCK]
Sleutelregels:
- Moet uniek zijn binnen (category, mind)
- Gebruik 
- Voorvoeg met categorie voor duidelijkheid: , 
- Houd stabiel — wijzig sleutels niet na aanmaak
Tags: voor zoeken
Tags maken snelle filtering en zoekopdrachten mogelijk:
[CODE BLOCK]
Tag-best-practices:
- 2-5 tags per herinnering (over-tag niet)
- Kleine letters voor consistentie
- Gebruik projectnamen, onderwerpen, technologieën
- Tags zijn niet hoofdlettergevoelig
Prioriteitsniveaus
| Prioriteit | Wanneer te gebruiken | Recall-gedrag |
|------------|----------------------|---------------|
|  | Identiteit, juridisch, onomkeerbaar | Altijd bovenaan recall |
|  | Actieve projecten, kernvoorkeuren | Prominent in recall |
|  | Meeste herinneringen (standaard) | Standaard recall-volgorde |
|  | Efemeer, leuk-om-te-weten | Kan worden samengevat |
 sorteert op prioriteit (critical eerst), dan op recentheid.
Bron: User versus Agent
Herinneringen worden getagd met :
-  — opgeslagen door een mens (via JWT of human-UI)
-  — opgeslagen door een LLM-agent (via Mind Key)
Dit beïnvloedt:
- Verificatie: -herinneringen worden automatisch geverifieerd, -herinneringen niet
- Betrouwbaarheid:  standaard 1.0,  0.7
- Recall:  markeert niet-geverifieerde herinneringen met "(unverified)"
> [!NOTE]
> Behandel -bron-herinneringen met gepast skepticisme. Ze kunnen zijn
> afgeleid of aangenomen in plaats van direct door de gebruiker gesteld.
Verificatie
De -vlag geeft aan dat een mens de herinnering heeft bevestigd:
- -herinneringen: automatisch geverifieerd ()
- -herinneringen: standaard niet-geverifieerd ()
Verifieer herinneringen via:
[CODE BLOCK]
> [!NOTE]
> Verificatie vereist JWT (mens-auth), niet Mind Key (agent-auth). Dit
> zorgt ervoor dat alleen mensen herinneringen als geverifieerd kunnen markeren.
Betrouwbaarheid
Het -veld (0.0 tot 1.0) geeft aan hoe betrouwbaar de herinnering is:
- 1.0 — direct door gebruiker gesteld
- 0.7 — door agent afgeleid
- 0.5 — onzeker, vereist verificatie
- 0.0 — expliciet betwijfeld
Stel betrouwbaarheid in bij opslaan:
[CODE BLOCK]
Verval
Stel  in voor tijdgevoelige herinneringen:
[CODE BLOCK]
Verlopen herinneringen worden niet geretourneerd door  (maar bestaan nog wel in DB).
Gebruik  om herinneringen te zien die binnenkort verlopen.
Memory-levenscyclus
[CODE BLOCK]
Recall-gedrag
 retourneert een platte-tekst samenvatting geoptimaliseerd voor LLM-context:
[CODE BLOCK]
- Gesorteerd op prioriteit (critical → low), dan op recentheid
- Niet-geverifieerde herinneringen gemarkeerd met 
- Tags inbegrepen voor context
- Platte tekst (geen JSON-parsing nodig)
Volgende stappen
- Memory API
- Memory-best-practices
- FTS5-zoekopdracht