157 lines
4.9 KiB
Markdown
157 lines
4.9 KiB
Markdown
# 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
|