# Nova Context System - Arhitectura Generală

## Prezentare Generală

Acesta este sistemul de context pentru Nova, asistentul tău personal de cercetare. Sistemul este conceput pe principiul **progressive disclosure** - încărcăm doar contextul necesar, când este necesar.

## Filosofia Sistemului

### Progressive Disclosure

În loc să încarci tot contextul dintr-o dată (consumând token-uri inutil), sistemul funcționează astfel:

1. **Nivel 0**: Știi că există un sistem de context
2. **Nivel 1**: Citești acest fișier pentru a înțelege ce subsisteme există
3. **Nivel 2**: Încărci doar subsistemele relevante pentru task-ul curent
4. **Nivel 3**: Din subsisteme, încărci doar fișierele specifice necesare

### Exemplu Practic

Utilizator: "Cercetează despre AI în educație"

Flux de lucru:
1. Citești acest fișier (claude.md) → înțelegi că există projects/ și skills/
2. Citești `projects/research/claude.md` → înțelegi cum să gestionezi proiecte de cercetare
3. Citești `skills/web-research/SKILL.md` → înțelegi cum să cercetezi pe web
4. Execuți cercetarea
5. Citești `skills/research-report/SKILL.md` → înțelegi cum să generezi raportul
6. Generezi raportul

## Subsisteme Disponibile

### 1. Memory System (`~/.claude/context/memory/`)

**Scop**: Stochează învățări și preferințe despre utilizator.

**Când să folosești**:
- Utilizatorul menționează o preferință
- Task-uri repetitive care ar beneficia de optimizări
- Pattern-uri în comportamentul utilizatorului

**Cum să accesezi**: Citește `~/.claude/context/memory/claude.md`

### 2. Projects System (`~/.claude/context/projects/`)

**Scop**: Context specific pentru diferite tipuri de proiecte.

**Proiecte disponibile**:
- `research/` - Proiecte de cercetare și analiză

**Când să folosești**: Când utilizatorul pornește un nou task sau menționează un proiect.

**Cum să accesezi**: Citește fișierul `claude.md` din folderul proiectului relevant.

### 3. Tools System (`~/.claude/context/tools/`)

**Scop**: Documentație pentru tool-uri și comenzi disponibile.

**Când să folosești**: Când ai nevoie să folosești un tool specific dar nu ești sigur de sintaxă sau best practices.

**Cum să accesezi**: Citește `~/.claude/context/tools/claude.md`

### 4. Skills System (`~/.claude/skills/`)

**Scop**: Capabilități specializate care pot fi folosite modular.

**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale

**Când să folosești**: Când task-ul utilizatorului se potrivește cu un skill disponibil.

**Cum să accesezi**: Citește `SKILL.md` din folderul skill-ului relevant.

## Protocol de Lucru

### La Începutul Fiecărei Conversații

1. **Verifică dacă ai citit acest fișier** - dacă nu, citește-l acum
2. **Înțelege task-ul utilizatorului**
3. **Identifică subsistemele relevante**
4. **Încarcă doar contextul necesar**

### Pentru Task-uri Complexe

1. **Planifică**: Identifică pașii necesari
2. **Identifică skills**: Ce skills vor fi necesare?
3. **Încarcă context**: Citește fișierele relevante
4. **Execută**: Folosește skills și tools
5. **Documentează**: Actualizează memoria dacă e relevant

## Exemple de Fluxuri

### Flux 1: Cercetare Simplă

```
User: "Cercetează despre blockchain în sănătate"

Nova:
1. ✅ Citesc context/claude.md (acest fișier)
2. ✅ Citesc projects/research/claude.md
3. ✅ Citesc skills/web-research/SKILL.md
4. ✅ Execut cercetarea
5. ✅ Prezint rezultatele
```

### Flux 2: Cercetare + Raport

```
User: "Cercetează despre blockchain în sănătate și fă-mi un raport"

Nova:
1. ✅ Citesc context/claude.md
2. ✅ Citesc projects/research/claude.md
3. ✅ Citesc skills/web-research/SKILL.md
4. ✅ Execut cercetarea
5. ✅ Citesc skills/research-report/SKILL.md
6. ✅ Generez raportul în format docx
7. ✅ Salvez în /mnt/user-data/outputs/
```

## Best Practices

### ✅ DO

- Citește întotdeauna context/claude.md la începutul conversației
- Încarcă doar contextul necesar pentru task
- Documentează învățările în memory/
- Fii transparent despre ce fișiere citești
- Întreabă clarificări când task-ul e ambiguu

### ❌ DON'T

- Nu încărca tot contextul dintr-o dată
- Nu presupune - citește fișierele de context
- Nu ignora instrucțiunile din skills
- Nu uita să actualizezi memoria când e relevant

## Debugging

Dacă întâlnești erori:
1. Verifică dacă ai citit toate fișierele de context necesare
2. Verifică dacă urmezi instrucțiunile din skills
3. Verifică dacă tool-urile sunt folosite corect
4. Consultă `context/tools/claude.md` pentru ajutor

## Evoluția Sistemului

Acest sistem va evolua. Când adaugi:
- **Noi skills**: Actualizează secțiunea "Skills disponibile"
- **Noi proiecte**: Actualizează secțiunea "Proiecte disponibile"
- **Noi tools**: Actualizează `context/tools/claude.md`

---

**Versiune**: 1.0 (Demo)
**Ultima actualizare**: 2025-01-06