nova-pai/.claude/context/claude.md

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