initializare

This commit is contained in:
2025-11-06 20:32:36 +02:00
commit 16bae571fe
18 changed files with 5092 additions and 0 deletions

156
.claude/context/claude.md Normal file
View File

@@ -0,0 +1,156 @@
# 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