Modulul 07 · 15 min

Cele 6 Layere de Memorie

Cum pastreaza agentul AI context si cunostinte intre sesiuni.

Problema: Memoria efemera

Un LLM nu are memorie nativa intre sesiuni. Fiecare conversatie noua incepe de la zero. Sistemul v2.1 rezolva asta prin 6 layere de memorie, fiecare cu un rol specific si un nivel diferit de persistenta.

💡 Analogie

Gandeste-te la layere ca la memoria umana: Layer 1 (CLAUDE.md) e ca instinctul — mereu prezent. Layer 6 (Obsidian) e ca un jurnal — il consulti cand ai nevoie.

Vizualizarea celor 6 layere

Click pe un layer pentru detalii

Layer 1: CLAUDE.md

Mereu in context, mereu citit. Contine regulile fundamentale: principii, workflow PAUL, anti-pattern-uri. Este "constitutia" agentului.

Limita: trebuie sa ramana sub 150 de linii de instructiuni ca sa nu consume prea mult din context window.

Layer 2: Auto Memory (MEMORY.md)

Agentul poate salva notite in MEMORY.md. Primele 200 de linii sunt incarcate automat la fiecare sesiune. Aici salveaza:

Pattern-uri confirmate prin multiple interactiuni
Decizii arhitecturale importante
Preferinte de workflow ale utilizatorului
Solutii la probleme recurente

Layer 3: MCP Memory Server

Un knowledge graph stocat in .claude/memory.json. Spre deosebire de MEMORY.md (text liber), acest layer stocheaza entitati si relatii structurate.

// Exemplu de entitati in knowledge graph:
Entity: "TDD Workflow"
  → relatie: "used_in" → "Phase 001"
  → relatie: "requires" → "test framework"

Entity: "Phase 001"
  → relatie: "status" → "completed"
  → relatie: "produced" → "validate-structure.sh"

ℹ️ Info

MCP Memory este accesibil prin Model Context Protocol — agentul il poate interoga in orice moment, fara sa-l incarce tot in context.

Layer 4: STATE.md

Singura sursa de adevar pentru pozitia curenta. Citit la inceputul fiecarei sesiuni, actualizat la sfarsitul fiecareia. Am explorat STATE.md in detaliu in Modulul 02.

Layer 5: Session Persistence

Folosind flag-urile --continue si --resume, agentul poate relua o conversatie anterioara cu tot contextul intact.

# Continua ultima sesiune
claude --continue

# Alege o sesiune specifica
claude --resume

⚠️ Atentie

Session persistence nu inlocuieste STATE.md. Sesiunile au durata limitata si nu sunt o sursa de adevar pe termen lung.

Layer 6: Obsidian Vault

Directorul docs/ este un vault Obsidian — versiunea human-readable si vizuala a memoriei agentului:

Session notes auto-generate (docs/30-sessions/)
ADR-uri — Architecture Decision Records (docs/20-architecture/adr/)
Graph view — relatii vizuale intre concepte
Dataview dashboards — query-uri dinamice pe fisiere

Igiena memoriei

Reguli pentru a mentine memoria curata si utila:

La finalul sesiunii: salveaza descoperirile critice in MCP memory
Foloseste /compact la breakpoint-uri logice (intre task-uri)
Foloseste /clear intre task-uri complet necorelate
La start sesiune: citeste STATE.md → verifica ultima sesiune → continua

🚫 Anti-pattern

Nu stoca informatii temporare in layere permanente. Detaliile unei sesiuni specifice nu apartin in CLAUDE.md sau MCP memory — doar concluziile confirmate.

Exercitiu

Identifica unde se afla fiecare layer in acest proiect. Deschide .claude/memory.json si observa structura knowledge graph-ului. Apoi verifica docs/30-sessions/ pentru un exemplu de session note.

Verifica-ti cunostintele

Care layer de memorie este un knowledge graph structurat cu entitati si relatii?