Modulul 05 · 15 min

Obsidian Vault

Memoria vizuala human-readable — Layer 6 din cele 6 layere de memorie.

De ce Obsidian?

Celelalte 5 layere de memorie sunt optimizate pentru agent. Obsidian vault-ul este optimizat pentru om. Este locul unde:

Vezi Graph View — relatii vizuale intre decizii, sesiuni, ADR-uri
Navighezi cu Wikilinks — click pe [[STATE]] si ajungi direct acolo
Folosesti Dataview — query-uri dinamice pe toate fisierele MD
Ai daily notes — jurnalul zilnic al proiectului

Structura vault-ului

docs/                          # Vault-ul Obsidian
├── 00-index/
│   └── HOME.md                # Entry point cu Quick Links
├── 10-gsd/
│   ├── today.md               # Daily note
│   ├── backlog.md             # Dashboard cu Dataview queries
│   └── done.md                # Task-uri completate
├── 20-architecture/
│   ├── OVERVIEW.md            # Diagrama sistemului
│   └── adr/                   # Architecture Decision Records
│       └── ADR-001-stack-v21.md
├── 30-sessions/               # Auto-generate de Stop hook
│   └── 2026-02-24-1237-session.md
├── 40-decisions/              # Decizii non-arhitecturale
├── 50-reference/              # Material de referinta
├── my-notes/                  # DOAR utilizator (agent NU scrie aici)
└── claude-output/             # Output generativ al agentului

🚫 Zona protejata

docs/my-notes/ este rezervat exclusiv utilizatorului. Agentul nu scrie niciodata in acest director — este un safe space pentru notitele tale personale.

Unde scrie agentul?

Agentul are acces de scriere doar in 4 locuri din vault:

docs/30-sessions/Session notes auto-generate la Stop

docs/20-architecture/adr/Architecture Decision Records noi

docs/10-gsd/today.mdDaily note actualizata

docs/claude-output/Output generativ (analize, drafturi, research)

Plugins recomandate

DataviewQuery-uri pe fisierele MD — backlog dashboard, task-uri filtrate, statistici

TemplaterTemplates cu JS inline — session notes, ADR-uri cu campuri auto-populate

GitAuto-commit vault — sincronizeaza cu repo-ul Git al proiectului

TasksTask management — due dates, filtre, sintaxa: - [ ] task #tag due:YYYY-MM-DD

Conventii vault

Frontmatter YAML obligatoriu pe fiecare fisier: date, tags
Link-uri interne in format Wikilink: [[Pagina Target]]
Task-uri in sintaxa Obsidian Tasks: - [ ] task #tag due:2026-03-01
Dataview queries nu se modifica manual — sunt generate de template

Session notes — exemplu

La fiecare Stop, hook-ul genereaza automat un fisier ca acesta:

---
type: session
project: ai-thinking-system
date: 2026-02-24
time: 12:37
phase: "Phase 004 — Documentatie"
focus: "Tutorial docs"
next: "Setup guide completare"
state_fresh: true
---

# Sesiune — 2026-02-24 12:37

## Context rapid
- STATE: [[STATE]]
- Current Phase: **Phase 004 — Documentatie**
- Active Focus: **Tutorial docs**

## Ce am facut in sesiunea asta
- Creat setup-guide.md cu 10 pasi
- Creat cheat-sheet.md
- Creat troubleshooting.md

💡 Tip

In Obsidian, click pe [[STATE]] te duce direct la .planning/STATE.md. Aceasta navigare rapida este un avantaj major fata de un folder simplu de fisiere.

Exercitiu

Deschide docs/ in Obsidian (File → Open folder as vault). Activeaza Graph View si observa cum session notes, ADR-uri si overview-ul sunt interconectate prin Wikilinks.

Verifica-ti cunostintele

In ce directoare din vault poate scrie agentul?