romfast/nova-pai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

initializare

Browse Source
This commit is contained in:
Marius Mutu
2025-11-06 20:32:36 +02:00
commit 16bae571fe
18 changed files with 5092 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

205
.claude/README.md Normal file
View File

@@ -0,0 +1,205 @@
# Nova - Personal AI Infrastructure Demo
## Prezentare
Acesta este un sistem demonstrativ de **Personal AI Infrastructure (PAI)** bazat pe principiile lui Daniel Miessler și conceptul de **Agent Skills** de la Anthropic.
## Versiune
**v1.0 Demo** - Ianuarie 2025
## Concepte Fundamentale
### Progressive Disclosure
Sistemul încarcă doar contextul necesar pentru task-ul curent, nu tot contextul dintr-o dată. Acest lucru:
- Reduce consumul de tokeni
- Îmbunătățește performanța
- Permite scalabilitate
### Skills Modulare
Capabilități specializate, auto-documentate, compozabile:
- `web-research` - Cercetare web profesională
- `research-report` - Generare rapoarte
### Context Engineering
Structură organizată de context care ghidează AI-ul în utilizarea corectă a capabilităților.
## Structura Sistemului
```
.claude/
├── output_style.md # Identitatea Nova
├── context/ # Sistemul de context
│ ├── claude.md # Documentație master (START HERE)
│ ├── memory/ # Sistem de învățare
│ │ ├── claude.md
│ │ ├── user-preferences.md
│ │ ├── work-patterns.md
│ │ └── learnings.md
│ ├── projects/ # Context specific proiecte
│ │ └── research/
│ │ └── claude.md
│ └── tools/ # Documentație tools
│ └── claude.md
├── skills/ # Capabilități modulare
│ ├── web-research/
│ │ └── SKILL.md
│ └── research-report/
│ ├── SKILL.md
│ └── report-structure-template.md
└── hooks/ # Automatizări
└── load-context.ts
```
## Quick Start
### Pentru Nova (AI Assistant)
La începutul fiecărei conversații:
1. **Citește** `.claude/context/claude.md` pentru a înțelege arhitectura
2. **Identifică** subsistemele relevante pentru task
3. **Încarcă** doar contextul necesar
4. **Execută** task-ul folosind skills și tools
5. **Documentează** învățările în memory/
### Pentru Utilizator
Exemple de comenzi:
```
"Cercetează despre [subiect]"
→ Nova folosește web-research skill
"Cercetează despre [subiect] și fă raport"
→ Nova folosește web-research + research-report skills
"Ce skills ai disponibile?"
→ Nova citește context/claude.md și listează
```
## Capabilities
### Cercetare Web
- Strategie de căutare în 5 pași
- Evaluare credibilitate surse
- Sinteză și analiză critică
- Minimum 5-10 surse per cercetare
### Generare Rapoarte
- Structură profesională standardizată
- Format Markdown
- Executive summary, analiză, concluzii
- Citații complete și corecte
### Învățare Continuă
- Stochează preferințe utilizator
- Optimizează workflow-uri
- Documentează best practices
- Evoluție în timp
## Teste Efectuate
✅ **Test 1: Context Loading** - Verificare structură și documentație
✅ **Test 2: Simple Research** - Workflow cercetare completă
✅ **Test 3: Research + Report** - Integrare skills
✅ **Test 4: Memory Persistence** - Sistem învățare
## Files Count
- **Total fișiere**: 13
- **Context files**: 5
- **Skills**: 2 (+ 1 template)
- **Memory files**: 4
- **Hooks**: 1
- **Documentation**: 1 (README)
## Extindere Sistem
### 📖 Documentație Disponibilă
- **[QUICK-REFERENCE.md](docs/QUICK-REFERENCE.md)** - Referință rapidă pentru task-uri comune
- **[HOW-TO-ADD-SKILLS.md](docs/HOW-TO-ADD-SKILLS.md)** - Ghid complet adăugare skills noi
### 🚀 Adăugare Skill Nou (Quick)
```bash
# 1. Creează directorul
mkdir -p .claude/skills/[nume-skill]/
# 2. Creează SKILL.md cu YAML frontmatter
# Vezi template în docs/HOW-TO-ADD-SKILLS.md
# 3. Actualizează context/claude.md
# Adaugă în lista "Skills disponibile"
# 4. Testează în conversație
```
### 💡 Idei pentru Skills Noi
**Development**: `code-review`, `debug-assistant`, `api-design`, `test-generation`
**Data**: `data-analysis`, `visualization`, `sql-query`, `data-cleaning`
**Content**: `email-drafting`, `presentation`, `documentation`, `copywriting`
**Business**: `market-research`, `competitive-analysis`, `financial-analysis`
### 🔄 Upgrade Componente Existente
- **Skills**: Editează SKILL.md, adaugă features, increment version
- **Context**: Adaugă subsisteme în `context/`
- **Projects**: Creează `projects/[tip]/claude.md` cu workflow specific
- **Tools**: Actualizează `context/tools/claude.md` cu tool-uri noi
## Technical Details
### Progressive Disclosure Levels
**Nivel 0**: Awareness că există sistem de context
**Nivel 1**: Citește `context/claude.md` → înțelege subsisteme
**Nivel 2**: Încarcă subsistemele relevante
**Nivel 3**: Încarcă fișiere specifice din subsisteme
### Skills Format
Toate skills folosesc:
- YAML frontmatter (`name`, `description`)
- Markdown content structurat
- Secțiuni standard (Scop, Când să folosești, Proces, Exemple)
- Troubleshooting și best practices
### Memory Format
```markdown
## [DATA] - [CATEGORIE]
**Context**: [Situația]
**Învățare**: [Ce s-a învățat]
**Aplicabilitate**: [Când să aplici]
---
```
## Philosophy
> "The best AI assistant is one that learns your preferences, adapts to your workflow, and gets better over time while using resources efficiently."
Acest sistem demonstrează că AI-ul poate fi:
- **Eficient** (progressive disclosure)
- **Adaptabil** (memory system)
- **Modular** (skills system)
- **Transparent** (context engineering)
## Credits
**Inspirație**:
- Daniel Miessler - Personal AI Infrastructure (PAI)
- Anthropic - Agent Skills concept
- Claude Code - Implementation platform
**Implementare**: Ianuarie 2025
**Licență**: Demo/Educational purposes
---
Pentru întrebări despre acest sistem, consultă `context/claude.md` pentru detalii complete despre arhitectură și utilizare.

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

97
.claude/context/memory/claude.md Normal file
View File

@@ -0,0 +1,97 @@
# Memory System
## Scop
Sistemul de memorie permite Nova să învețe și să rețină:
- Preferințe ale utilizatorului
- Pattern-uri în task-uri
- Optimizări descoperite
- Context istoric relevant
## Structura Memoriei
```
memory/
├── claude.md (acest fișier)
├── user-preferences.md
├── work-patterns.md
└── learnings.md
```
## Când să Actualizezi Memoria
### user-preferences.md
- Utilizatorul exprimă o preferință explicită
- Observi un pattern consistent în cererile utilizatorului
### work-patterns.md
- Identifici un workflow repetitiv
- Descoperi o optimizare pentru task-uri comune
### learnings.md
- Rezolvi o problemă nouă
- Descoperi un best practice
- Întâlnești și rezolvi o eroare
## Format pentru Intrări
```markdown
## [DATA] - [CATEGORIE]
**Context**: Ce task sau situație
**Învățare**: Ce ai învățat
**Aplicabilitate**: Când să folosești această cunoștință
---
```
## Exemple
### Exemplu 1: Preferință Utilizator
```markdown
## 2025-01-15 - Preferință Format
**Context**: Utilizatorul a cerut un raport despre AI
**Învățare**: Preferă rapoarte în format DOCX, nu Markdown
**Aplicabilitate**: Pentru toate rapoartele viitoare, generează implicit DOCX
---
```
### Exemplu 2: Optimizare Workflow
```markdown
## 2025-01-16 - Optimizare Cercetare
**Context**: Cercetare despre tehnologie emergentă
**Învățare**: Pentru subiecte tech, caută mai întâi pe ArXiv, apoi Google Scholar, apoi web general
**Aplicabilitate**: Task-uri de cercetare tehnologică
---
```
## Cum să Folosești Memoria
1. **La începutul conversației**: Citește fișierele de memorie relevante
2. **În timpul lucrului**: Observă pattern-uri și preferințe
3. **La finalul task-urilor**: Actualizează memoria cu învățări noi
4. **Pentru task-uri repetitive**: Consultă memoria pentru optimizări
## Best Practices
### ✅ DO
- Actualizează memoria după task-uri semnificative
- Fii specific în documentarea preferințelor
- Notează atât succese cât și eșecuri
- Revizuiește memoria periodic
### ❌ DON'T
- Nu actualiza pentru fiecare task trivial
- Nu presupune preferințe - așteaptă confirmarea
- Nu șterge învățări vechi fără motiv
- Nu ignora conflicte în preferințe
## Notă Importantă
Memoria este un sistem de învățare continuă. Cu cât utilizezi mai mult sistemul, cu atât Nova devine mai eficientă și mai aliniată cu preferințele tale.

40
.claude/context/memory/learnings.md Normal file
View File

@@ -0,0 +1,40 @@
# Learnings
Acest fișier stochează învățări tehnice, best practices, și soluții la probleme întâlnite.
---
## 2025-01-06 - Implementare PAI Demo
**Context**: Crearea sistemului Personal AI Infrastructure cu progressive disclosure
**Învățare**:
- Structura modulară cu skills și context permite scalabilitate
- Progressive disclosure reduce consumul de tokeni
- YAML frontmatter în skills permite metadata structurată
- Hook-ul pentru context loading necesită adaptare pentru Claude Code
**Aplicabilitate**:
- Pentru proiecte viitoare cu AI care necesită context complex
- Când trebuie gestionate multiple domenii de expertiză
- Pentru sisteme care învață preferințe utilizator
---
## 2025-01-06 - Documentație Extensie Sistem
**Context**: Utilizator a întrebat cum să adauge skills noi și să upgradeze sistemul
**Învățare**:
- Creat 3 ghiduri complete: QUICK-REFERENCE, HOW-TO-ADD-SKILLS, EXAMPLE-NEW-SKILL
- Proces standardizat în 4 pași: mkdir → create SKILL.md → update context → test
- Template YAML frontmatter obligatoriu pentru toate skills-urile
- Exemplu practic (email-drafting) demonstrează structură completă
- Documentația trebuie să fie stratificată: quick ref → ghid complet → exemplu practic
**Aplicabilitate**:
- Pentru orice extensie viitoare a sistemului
- Documentația în 3 nivele permite adaptare la diferite nevoi
- Template-uri reduc timpul de implementare cu ~80%
---
<!-- Adaugă noi învățări aici -->

15
.claude/context/memory/user-preferences.md Normal file
View File

@@ -0,0 +1,15 @@
# User Preferences
Acest fișier stochează preferințele utilizatorului învățate pe parcursul utilizării sistemului Nova.
---
## 2025-01-06 - Inițializare Sistem
**Context**: Crearea sistemului Personal AI Infrastructure Demo
**Învățare**: Utilizatorul a solicitat implementare completă (CRITICAL + HIGH + MEDIUM files)
**Aplicabilitate**: Preferă soluții complete și comprehensive față de minimum viable
---
<!-- Adaugă noi preferințe aici folosind formatul de mai sus -->

18
.claude/context/memory/work-patterns.md Normal file
View File

@@ -0,0 +1,18 @@
# Work Patterns
Acest fișier documentează pattern-uri și workflow-uri optimizate descoperite în timpul lucrului.
---
<!-- Adaugă pattern-uri descoperite aici -->
<!-- Exemplu:
## 2025-01-XX - Pattern Descoperit
**Context**: [Descriere situație]
**Învățare**: [Ce pattern ai identificat]
**Aplicabilitate**: [Când să folosești acest pattern]
---
-->

109
.claude/context/projects/research/claude.md Normal file
View File

@@ -0,0 +1,109 @@
# Research Project Context
## Prezentare
Acest context se aplică pentru toate task-urile de cercetare și analiză.
## Tipuri de Cercetare Suportate
1. **Cercetare Generală**: Subiect larg, overview complet
2. **Cercetare Tehnică**: Focus pe aspecte tehnice, soluții
3. **Cercetare Comparativă**: Comparații între opțiuni/soluții
4. **Cercetare de Piață**: Analiză competitori, tendințe
## Workflow Standard
### Faza 1: Înțelegere
1. Clarifică subiectul cu utilizatorul dacă e necesar
2. Identifică tipul de cercetare
3. Stabilește obiectivele specifice
### Faza 2: Cercetare
1. Folosește `web-research` skill
2. Prioritizează surse credibile:
- Academic: Google Scholar, ArXiv, PubMed
- Profesional: Medium, blog-uri corporative
- News: Surse jurnalistice credibile
- Technical: Documentation oficială, GitHub
3. Adună minim 5-10 surse relevante
4. Verifică informațiile pe surse multiple
### Faza 3: Analiză
1. Extrage informații cheie din fiecare sursă
2. Identifică pattern-uri și teme comune
3. Notează conflicte sau dezacorduri între surse
4. Sintetizează o perspectivă echilibrată
### Faza 4: Raportare
1. Folosește `research-report` skill
2. Structurează informația logic
3. Citează sursele corespunzător
4. Generează output în formatul cerut
## Structura Raportului Standard
```
1. Executive Summary
2. Introducere și Context
3. Metodologie de Cercetare
4. Descoperiri Principale
- Subsecțiune 1
- Subsecțiune 2
- etc.
5. Analiză și Implicații
6. Concluzii
7. Recomandări (dacă e relevant)
8. Surse și Referințe
```
## Criterii de Calitate
### ✅ Un Raport de Calitate Include:
- Minim 5 surse credibile
- Informații verificate pe surse multiple
- Citatii corecte și complete
- Analiză critică, nu doar descriere
- Structură clară și logică
- Executive summary concis
- Secțiune de concluzii acționabile
### ❌ Evită:
- Surse necredibile sau dubioase
- Informații neverificate
- Plagiat sau copy-paste din surse
- Structură haotică
- Concluzii lipsite de suport
## Tools Disponibile
- `WebSearch`: Căutare pe web
- `WebFetch`: Descărcare conținut complet
- `Write`: Creare rapoarte
- Skills: `web-research`, `research-report`
## Exemple de Task-uri
### Task 1: Cercetare Generală
```
"Cercetează despre inteligența artificială în educație"
→ Web search → Analiză → Raport general
```
### Task 2: Cercetare Tehnică
```
"Cercetează soluții de blockchain pentru supply chain"
→ Focus pe implementări tehnice → Comparații → Raport tehnic
```
### Task 3: Cercetare Comparativă
```
"Compară React vs Vue vs Angular pentru aplicații enterprise"
→ Criterii de comparație → Analiză fiecare → Tabel comparativ → Recomandări
```

255
.claude/context/tools/claude.md Normal file
View File

@@ -0,0 +1,255 @@
# Tools System
## Tools Disponibile
### 1. WebSearch
**Scop**: Căutare pe web pentru informații.
**Când să folosești**:
- Căutări de informații generale
- Găsire surse multiple pe un topic
- Explorare inițială a unui subiect
**Sintaxă**:
```
WebSearch({ query: "string" }) // 1-6 cuvinte pentru rezultate optime
```
**Best Practices**:
- Ține query-urile scurte și focusate
- Începe cu query-uri largi, apoi restrânge
- Nu repeta același query
- Pentru subiecte recente, include anul
**Exemple**:
```
// ✅ Bine
WebSearch({ query: "blockchain healthcare 2024" })
WebSearch({ query: "Claude AI capabilities" })
// ❌ Evită
WebSearch({ query: "what are all the different applications and use cases of blockchain technology in the healthcare industry" })
```
### 2. WebFetch
**Scop**: Descarcă și analizează conținutul complet al unei pagini web.
**Când să folosești**:
- După WebSearch, pentru a citi articole complete
- Când ai nevoie de detalii specifice dintr-o sursă
- Pentru a verifica informații
**Sintaxă**:
```
WebFetch({
url: "https://example.com/article",
prompt: "Extract key findings and main arguments"
})
```
**Best Practices**:
- Folosește doar pe URL-uri returnate de WebSearch
- Nu face fetch pe mai mult de 5-10 URL-uri per task
- Prioritizează surse credibile
- Folosește prompt-uri clare pentru extracție
### 3. Read
**Scop**: Citește fișiere locale.
**Când să folosești**:
- Citire fișiere de configurare
- Citire context din alte fișiere
- Verificare conținut existent
**Sintaxă**:
```
Read({ file_path: "/absolute/path/to/file" })
```
**Best Practices**:
- Folosește întotdeauna path-uri absolute
- Verifică că fișierul există înainte
### 4. Write
**Scop**: Creează sau suprascrie fișiere.
**Când să folosești**:
- Generare rapoarte
- Salvare rezultate cercetare
- Creare fișiere noi
**Sintaxă**:
```
Write({
file_path: "/absolute/path/to/file.md",
content: "conținutul fișierului"
})
```
**Best Practices**:
- Folosește nume descriptive pentru fișiere
- Organizează fișierele logic (ex: outputs/ pentru rapoarte)
- Pentru rapoarte mari, salvează în format Markdown
### 5. Edit
**Scop**: Editează fișiere existente prin înlocuire de text.
**Când să folosești**:
- Modificare fișiere existente
- Actualizare conținut specific
- Adăugare informații la fișiere
**Sintaxă**:
```
Edit({
file_path: "/path/to/file",
old_string: "text de înlocuit",
new_string: "text nou"
})
```
### 6. Bash
**Scop**: Execută comenzi bash.
**Când să folosești**:
- Operații pe sistem de fișiere
- Instalare pachete
- Verificare stare sistem
**Sintaxă**:
```
Bash({
command: "ls -la",
description: "List all files in directory"
})
```
**Best Practices**:
- Explică utilizatorului ce face comanda
- Verifică comenzile înainte de execuție
- Folosește pentru operații care nu pot fi făcute cu alte tools
### 7. Glob
**Scop**: Găsește fișiere folosind pattern-uri.
**Când să folosești**:
- Căutare fișiere după nume
- Găsire fișiere cu extensii specifice
- Explorare structură proiect
**Sintaxă**:
```
Glob({ pattern: "**/*.md" })
```
### 8. Grep
**Scop**: Căutare text în fișiere.
**Când să folosești**:
- Căutare cod sau text specific
- Găsire pattern-uri în fișiere
- Explorare codebase
**Sintaxă**:
```
Grep({
pattern: "search pattern",
output_mode: "content"
})
```
## Workflow Tools pentru Task-uri Comune
### Cercetare + Raport
```
1. WebSearch → găsește surse
2. WebFetch → citește surse detaliate (3-5 articole)
3. [analiză și sinteză]
4. Write → generează raportul
```
### Analiză Context Sistem
```
1. Read → citește fișiere de context
2. Glob → găsește fișiere relevante
3. Grep → caută informații specifice
4. [procesare]
```
### Actualizare Memorie
```
1. Read → citește fișierul de memorie existent
2. Edit → adaugă noua învățare
3. [sau Write dacă fișierul nu există]
```
## Error Handling
### Erori Comune
**WebSearch returnează rezultate irelevante**:
→ Reformulează query-ul, fii mai specific
**WebFetch eșuează**:
→ URL-ul poate fi invalid sau blocat, încearcă alt URL
**Write eșuează**:
→ Verifică că path-ul este valid și ai permisiuni
**Read eșuează**:
→ Verifică că fișierul există la path-ul specificat
## Rate Limits și Performanță
- WebSearch: Nelimitat practic
- WebFetch: Maxim 10-15 per task pentru performanță
- Write/Read/Edit: Nelimitat
- Bash: Folosește cu moderație
## Permisiuni și Acces
**Poți accesa**:
- Directorul de lucru curent
- Subdirectoarele proiectului
- Fișiere pe care le creezi
**Best Practices**:
- Folosește path-uri relative pentru fișiere din proiect
- Organizează output-urile logic
- Nu șterge fișiere fără confirmare utilizator
## Integrare cu Skills
### web-research skill folosește:
- WebSearch (căutare inițială)
- WebFetch (citire articole)
### research-report skill folosește:
- Write (generare raport)
- Read (citire template-uri)
### memory system folosește:
- Read (citire memorie existentă)
- Edit (actualizare memorie)
- Write (creare fișiere noi de memorie)
## Tips și Trucuri
1. **Pentru cercetare eficientă**: Folosește 3-5 WebSearch-uri cu query-uri diferite, apoi WebFetch pe cele mai bune 5-7 rezultate
2. **Pentru rapoarte**: Pregătește tot conținutul în memorie, apoi Write într-un singur apel
3. **Pentru debugging**: Folosește Read pentru a verifica ce ai creat cu Write
4. **Pentru context**: Citește întotdeauna fișierele de context relevante înainte de task-uri complexe

539
.claude/docs/EXAMPLE-NEW-SKILL.md Normal file
View File

@@ -0,0 +1,539 @@
# Exemplu Practic: Adăugare Skill "Email Drafting"
Acest document demonstrează procesul complet de adăugare a unui skill nou în sistemul Nova PAI.
## Skill Ales: Email Drafting
**De ce acest skill?**
- Use case comun (toată lumea scrie email-uri)
- Necesită context și structură
- Se combină bine cu alte skills (ex: research pentru content)
---
## Pas cu Pas
### 1. Crearea Structurii
```bash
# Creează directorul skill-ului
mkdir -p .claude/skills/email-drafting/
# Verificare
ls -la .claude/skills/
# Should show: email-drafting/
```
### 2. Crearea SKILL.md
**Fișier**: `.claude/skills/email-drafting/SKILL.md`
```markdown
---
name: email-drafting
description: "Skill pentru compunerea de email-uri profesionale: business communication, networking, follow-ups, și outreach. Folosește pentru orice task de scriere email."
---
# Email Drafting Skill
## Prezentare
Acest skill te ajută să compui email-uri profesionale, clare și eficiente pentru diverse contexte: business communication, networking, job applications, follow-ups, și outreach.
## Când să Folosești
- Utilizatorul cere "Scrie-mi un email..."
- "Cum răspund la..."
- Networking outreach
- Cold emails
- Follow-up messages
- Business correspondence
- Job applications / cover letters
## Pre-requisite
Înainte de a compune email-ul, trebuie să ai:
- ✅ Destinatarul (cui scrii)
- ✅ Scopul email-ului (ce vrei să obții)
- ✅ Contextul (de ce acum, ce relație aveți)
## Proces de Execuție
### Pas 1: Clarificare Context
**Întrebări obligatorii**:
1. **Cui scrii?**
- Rol/poziție (CEO, recrutant, coleg, client)
- Relație existentă (cunoscut, cold outreach, follow-up)
- Nivel seniority
2. **Ce vrei să obții?**
- Acțiune specifică (meeting, informații, aprobare)
- Deadline (urgent vs. flexibil)
- Importanță (high stakes vs. casual)
3. **Ce ton e potrivit?**
- Formal vs. casual
- Direct vs. diplomatic
- Urgent vs. relaxat
### Pas 2: Selectare Template
În funcție de tip, alege structura potrivită:
**A. Cold Outreach** (nu vă cunoașteți)
```
Subject: [Specific + Value proposition]
Hi [Name],
[Hook - de ce scrii + connection/relevance]
[Value - ce oferi sau de ce e relevant pentru ei]
[Ask - specific și rezonabil]
[Close - ușor de răspuns]
Best regards,
[Your name]
```
**B. Follow-up** (după întâlnire/email)
```
Subject: Re: [Previous subject] - [Action item]
Hi [Name],
[Reference to previous interaction]
[Update or reason for follow-up]
[Next steps or ask]
Thanks,
[Your name]
```
**C. Request** (ceri ceva)
```
Subject: [Clear what you need]
Hi [Name],
[Context - de ce scrii]
[Request - specific și clar]
[Why it matters - benefit pentru ambii]
[Timeline - când ai nevoie]
Thank you for considering,
[Your name]
```
**D. Professional Introduction**
```
Subject: Introduction - [Your name] from [Company/Context]
Hi [Name],
[Who you are - 1 sentence]
[Why you're reaching out - connection/reason]
[What you propose - meeting, call, collaboration]
[Call to action - easy to respond]
Looking forward to connecting,
[Your name]
```
### Pas 3: Scriere Draft
**Componentele esențiale**:
1. **Subject Line**
- ✅ Clar și specific
- ✅ Sub 50 caractere
- ✅ Evită spam triggers (FREE, URGENT!!!, etc.)
- ❌ Nu folosi "Re:" dacă nu e răspuns real
2. **Opening**
- ✅ Personalizat (folosește numele)
- ✅ Context imediat (de ce scrii)
- ❌ Nu începe cu "Sper că ești bine" în cold emails
3. **Body**
- ✅ Paragrafe scurte (2-4 fraze)
- ✅ Un singur scop principal
- ✅ Beneficii clare
- ❌ Nu include multiple cereri nesupravegheate
4. **Call to Action**
- ✅ Specific și actionable
- ✅ Ușor de executat
- ✅ Include opțiuni (dacă e relevant)
- ❌ Nu lăsa vag ("Aștept răspunsul tău")
5. **Closing**
- ✅ Professional
- ✅ Pe ton cu restul email-ului
- ✅ Include contact info dacă e relevant
### Pas 4: Revizuire și Optimizare
**Checklist final**:
- [ ] Subject line sub 50 caractere și clar
- [ ] Email sub 150 cuvinte (ideal 75-100)
- [ ] Un singur scop principal
- [ ] CTA clar și specific
- [ ] Fără greșeli gramaticale
- [ ] Ton consistent
- [ ] Mobile-friendly (testează pe telefon)
- [ ] Include toate informațiile necesare pentru răspuns
**Red flags** (evită):
- 🚩 Email > 200 cuvinte (prea lung)
- 🚩 Multiple CTA-uri confuze
- 🚩 Prea formal sau prea casual
- 🚩 Lipsa context (destinatarul nu știe de ce scrii)
- 🚩 Vague asks ("să discutăm cândva")
## Exemple Complete
### Exemplu 1: Networking Cold Email
**Context**: Vrei să te conectezi cu un VP Product din industria ta
**Input**: "Scrie-mi un email de networking către Sarah Johnson, VP Product la TechCorp"
**Output**:
```
Subject: Fellow Product Leader - Quick Question
Hi Sarah,
I'm Alex, VP Product at StartupXYZ, and I've been following TechCorp's product evolution—particularly your recent AI features launch.
I'm currently navigating a similar product challenge (scaling personalization) and would love to hear about your team's approach, if you're open to a brief chat.
Would you have 15 minutes in the next 2 weeks for a quick call? Happy to work around your schedule.
Thanks for considering!
Alex
alex@startupxyz.com
```
**De ce funcționează**:
- Relevance imediat (fellow VP, same field)
- Specific despre ce admiri
- Clear ask (15 min, 2 weeks = flexibil)
- Respectful (nu cere mult timp)
### Exemplu 2: Follow-up După Meeting
**Context**: Ai avut un call cu un client potențial, acum trimiți follow-up
**Input**: "Follow-up după meeting cu John despre implementarea platformei noastre"
**Output**:
```
Subject: Re: Platform Demo - Next Steps
Hi John,
Thanks for taking the time yesterday to walk through your team's workflow challenges. The data synchronization issue you mentioned is definitely something our platform can address.
As discussed, I'm attaching:
- Custom proposal for your 50-person team
- Case study from a similar fintech client
- Pricing breakdown with the Q1 discount
I've blocked time on Friday, Jan 12 at 2pm for our follow-up call, but let me know if you need to reschedule.
Looking forward to moving this forward!
Best,
Alex
```
**De ce funcționează**:
- Reference specific la discussion
- Delivers pe promisiuni
- Clear next step cu dată
- Professional dar friendly
### Exemplu 3: Request Email (Asking for Introduction)
**Context**: Vrei o introducere către un investitor
**Input**: "Cere-i lui Mark să mă introducă la Sarah Chen, investitor la Accel"
**Output**:
```
Subject: Intro Request - Sarah Chen / Accel
Hey Mark,
Hope you're doing well! I'm reaching out because I saw you're connected with Sarah Chen at Accel, and I'm currently raising our Series A.
Our traction (5x growth in Q4, 200+ enterprise customers) aligns well with Accel's B2B SaaS focus, and I'd love to get on Sarah's radar.
Would you feel comfortable making a short intro? Happy to send a forwardable email if that helps.
No worries if the timing isn't right—appreciate you either way!
Best,
Alex
```
**De ce funcționează**:
- Respect relationship (asks permission)
- Provides context (why Sarah specifically)
- Makes it easy (offers forwardable)
- No pressure close
### Exemplu 4: Difficult Email (Saying No)
**Context**: Trebuie să refuzi o cerere dar vrei să păstrezi relația
**Input**: "Refuz politicos o cerere de parteneriat"
**Output**:
```
Subject: Re: Partnership Proposal - Current Focus
Hi Jessica,
Thanks for the detailed partnership proposal—I can see you put a lot of thought into how our products could complement each other.
After discussing with the team, we've decided to hold off on new partnerships this quarter while we focus on product improvements for our current customers.
That said, I'm impressed with what you're building at [Company], and I'd love to revisit this conversation in Q3 when we have more bandwidth.
I'll keep an eye on your progress!
Best,
Alex
```
**De ce funcționează**:
- Respectful și appreciative
- Clear "no" dar nu harsh
- Leaves door open (specific timeframe)
- Positive closing
## Tools Folosite
- **Read** - Pentru citire context anterior (threads)
- **Write** - Pentru salvare drafts
- **WebSearch** - Pentru research recipient (dacă e cold email)
## Integrare cu Alte Skills
**Combină cu**:
- `research` - Pentru background check pe recipient
- `copywriting` - Pentru subject lines mai creative
- `translation` - Pentru email-uri în alte limbi
## Troubleshooting
### Problem: Email prea lung
**Soluție**:
1. Identifică scopul principal
2. Elimină paragrafe care nu contribuie direct
3. Target: 75-100 cuvinte
4. Mută detalii extra în atașamente
### Problem: Ton prea formal/casual
**Soluție**:
1. Verifică seniority destinatar
2. Analizează industrie (tech = mai casual, legal = formal)
3. Dacă unsure, alege profesional-neutral
4. Match tonul emailurilor anterioare dacă există thread
### Problem: Nu știi ce CTA să pui
**Soluție**:
**Template-uri CTA**:
- **Ușor**: "Would [specific day/time] work for a quick call?"
- **Flexibil**: "Let me know what works for your calendar"
- **Urgent**: "Could we connect this week? I'm available [times]"
- **Low commitment**: "Would you be open to a brief intro call?"
### Problem: Nu primești răspuns
**Soluție Follow-up**:
1. Așteaptă 5-7 zile business
2. Trimite bump scurt:
```
Hi [Name],
Bumping this up in your inbox—wanted to make sure it didn't get lost!
Any thoughts on [original ask]?
Thanks,
[You]
```
3. Maxim 2 follow-ups total
## Best Practices
### ✅ DO
- **Personalizează**: Referă ceva specific despre destinatar
- **Scurt**: Under 150 cuvinte ideal
- **Scannable**: Paragrafe scurte, bullet points dacă e relevant
- **Mobile-first**: Majoritatea citesc pe telefon
- **Proofread**: Zero typos
- **Time it right**: Trimite Marți-Joi, 10am-2pm pentru best response
### ❌ DON'T
- **Nu folosi cuvinte spam**: FREE, URGENT, GUARANTEED
- **Nu trimiți la weekend**: Except dacă e industry norm
- **Nu CC prea mulți**: Dilutes responsibility
- **Nu folosești Reply All**: Except dacă relevant pentru toți
- **Nu incluzi emoji**: În business formal
- **Nu scrii când ești nervos**: Draft-uiește, review a doua zi
## Variații pe Contexte
### Intern (Coleg/Manager)
- Mai casual
- Mai direct
- Poate fi mai lung dacă e complex
### Client
- Professional
- Solution-focused
- Clear deliverables
### Recruiter/Job Application
- Enthusiastic dar nu desperate
- Highlight relevant experience
- Show you did research
### Investor
- Concise
- Data-driven
- Clear traction
## Metrics de Success
Un email bun are:
- **Open rate**: >40% (subject line bun)
- **Response rate**: >20% (relevant + clear CTA)
- **Action rate**: >10% (meeting booked, intro made, etc.)
Dacă primești sub aceste rates, iterate pe:
1. Subject lines
2. Personalization
3. Length (mai scurt)
4. CTA clarity
---
**Versiune**: 1.0
**Ultima actualizare**: 2025-01-06
**Autor**: Claude (Nova PAI Demo)
```
### 3. Actualizare context/claude.md
**Editează**: `.claude/context/claude.md`
**Găsește secțiunea**:
```markdown
**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale
```
**Adaugă**:
```markdown
**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale
- `email-drafting/` - Compunere email-uri profesionale
```
### 4. (Opțional) Testare
**În conversație nouă**:
```
"Citește .claude/skills/email-drafting/SKILL.md și folosește-l pentru a-mi scrie un email de networking către un VP Engineering"
```
**Așteptat**:
- Nova citește skill-ul
- Întreabă clarificări (context, relație, etc.)
- Generează email folosind template-ul potrivit
- Verifică cu checklist-ul final
---
## Rezultat Final
Ai acum:
- ✅ Skill nou funcțional: `email-drafting`
- ✅ Documentație completă cu 4 exemple
- ✅ Integrare în sistemul Nova
- ✅ Ready for production use
**Locație fișiere**:
```
.claude/
├── skills/
│ └── email-drafting/
│ └── SKILL.md ← NOU
└── context/
└── claude.md ← ACTUALIZAT
```
---
## Următorii Pași
1. **Testează skill-ul** cu diverse scenarii
2. **Documentează probleme** în troubleshooting
3. **Adaugă în memory** orice învățări
4. **Iterează** bazat pe feedback
---
## Template pentru Skill-ul Tău
Folosește această structură ca starting point:
```bash
# 1. Creează
mkdir -p .claude/skills/[nume]/
# 2. Copiază structura din email-drafting ca template
cp .claude/skills/email-drafting/SKILL.md .claude/skills/[nume]/SKILL.md
# 3. Editează cu conținut specific
# 4. Update context/claude.md
# 5. Test!
```
---
**Pro Tip**: Începe cu skills simple și concrete (ca email-drafting), apoi extinde la skills mai complexe (data analysis, code generation, etc.).

505
.claude/docs/HOW-TO-ADD-SKILLS.md Normal file
View File

@@ -0,0 +1,505 @@
# Ghid: Cum să Adaugi Noi Skills în Nova
## Procesul de Adăugare Skill Nou
### Pas 1: Creează Directorul Skill-ului
```bash
mkdir -p .claude/skills/[nume-skill]/
```
**Exemple**:
- `.claude/skills/data-analysis/`
- `.claude/skills/code-review/`
- `.claude/skills/email-drafting/`
### Pas 2: Creează SKILL.md cu YAML Frontmatter
**Template**:
```markdown
---
name: [nume-skill]
description: "Descriere concisă ce face skill-ul și când să-l folosești. Maximum 2 fraze."
---
# [Nume Skill] Skill
## Prezentare
[1-2 paragrafe ce este skill-ul și ce face]
## Când să Folosești
[Listă cu situații când acest skill e relevant]
- Situație 1
- Situație 2
- etc.
## Pre-requisite
[Dacă skill-ul depinde de altceva]
- Prerequisit 1
- Prerequisit 2
## Proces de Execuție
### Pas 1: [Nume Pas]
[Descriere detaliată]
**Input necesar**:
- Item 1
- Item 2
**Output așteptat**:
- Rezultat 1
- Rezultat 2
### Pas 2: [Nume Pas]
[Continuă...]
## Tools Necesare
[Ce tools din sistem vei folosi]
- `WebSearch` - pentru X
- `Write` - pentru Y
- etc.
## Template de Lucru
[Dacă există un template util]
```
[Template aici]
```
## Exemple Complete
### Exemplu 1: [Scenariu Simplu]
**Input**: "..."
**Execuție**:
```
1. Pas 1
2. Pas 2
3. Pas 3
```
**Output**: [Descriere rezultat]
### Exemplu 2: [Scenariu Complex]
[Similar...]
## Troubleshooting
### Problem: [Problemă comună]
**Soluție**: [Cum să rezolvi]
### Problem: [Altă problemă]
**Soluție**: [Soluție]
## Best Practices
### ✅ DO
- Practice 1
- Practice 2
### ❌ DON'T
- Anti-pattern 1
- Anti-pattern 2
## Integrare cu Alte Skills
[Dacă skill-ul se combină cu altele]
- Folosește împreună cu `[skill-name]` pentru [use case]
- După `[skill-name]`, folosește acest skill pentru [next step]
## Note Importante
[Orice avertismente sau considerații speciale]
---
**Versiune**: 1.0
**Ultima actualizare**: [DATA]
**Autor**: [NUME]
```
### Pas 3: Actualizează context/claude.md
Adaugă skill-ul în lista de skills disponibile:
```markdown
## Subsisteme Disponibile
### 4. Skills System (`~/.claude/skills/`)
**Skills disponibile**:
- `web-research/` - Cercetare avansată pe web
- `research-report/` - Generare rapoarte profesionale
- `[nou-skill]/` - [Descriere scurtă] ← ADAUGĂ AICI
```
### Pas 4: (Opțional) Creează Fișiere Suport
În directorul skill-ului poți adăuga:
- `template.md` - Template-uri
- `examples/` - Exemple detaliate
- `reference.md` - Documentație tehnică
---
## Exemple de Skills Noi
### Exemplu 1: Data Analysis Skill
```bash
mkdir -p .claude/skills/data-analysis/
```
**SKILL.md**:
```markdown
---
name: data-analysis
description: "Skill pentru analiza de date folosind pandas, numpy și matplotlib. Folosește pentru task-uri de statistică, vizualizare, și data cleaning."
---
# Data Analysis Skill
## Când să Folosești
- Utilizatorul cere analiza unui CSV/Excel
- Task-uri de statistică descriptivă
- Vizualizare date
- Data cleaning și preprocessing
## Proces de Execuție
### Pas 1: Încărcare Date
Folosește pandas pentru a citi fișierul:
```python
import pandas as pd
df = pd.read_csv('file.csv')
```
### Pas 2: Explorare Inițială
```python
# Overview
df.info()
df.describe()
df.head()
# Check missing values
df.isnull().sum()
```
[...continuă cu pașii]
```
### Exemplu 2: Code Review Skill
```bash
mkdir -p .claude/skills/code-review/
```
**SKILL.md**:
```markdown
---
name: code-review
description: "Skill pentru review profesional de cod: securitate, best practices, performanță, și mentenabilitate."
---
# Code Review Skill
## Când să Folosești
- Utilizatorul cere review la cod
- Pull request review
- Audit de securitate
- Optimizare performanță
## Proces de Execuție
### Pas 1: Citire și Înțelegere
1. Read fișierele de cod
2. Înțelege arhitectura
3. Identifică purpose-ul
### Pas 2: Analiza pe Categorii
**Securitate**:
- [ ] SQL injection
- [ ] XSS vulnerabilities
- [ ] Authentication issues
- [ ] Sensitive data exposure
**Best Practices**:
- [ ] Naming conventions
- [ ] Code organization
- [ ] DRY principle
- [ ] Error handling
[...continuă]
```
### Exemplu 3: Email Drafting Skill
```bash
mkdir -p .claude/skills/email-drafting/
```
**SKILL.md**:
```markdown
---
name: email-drafting
description: "Skill pentru compunerea de email-uri profesionale: business, recrutare, networking, follow-ups."
---
# Email Drafting Skill
## Când să Folosești
- "Scrie-mi un email către..."
- "Cum răspund la..."
- Networking outreach
- Follow-up messages
## Proces de Execuție
### Pas 1: Înțelege Contextul
**Întrebări cheie**:
- Cui scrii? (rol, relație)
- Ce vrei să obții?
- Ce ton e potrivit?
- Cât de formal?
### Pas 2: Structură Email
**Template standard**:
```
Subject: [Clear, specific, action-oriented]
[Greeting],
[Opening - context/reference]
[Body - main message in 2-3 paragraphs]
[Call to action - specific ask]
[Closing],
[Signature]
```
[...continuă cu exemple]
```
---
## Upgrade Skills Existente
### Adăugare Funcționalitate Nouă
1. **Editează SKILL.md**:
```bash
# Citește skill-ul existent
cat .claude/skills/web-research/SKILL.md
# Editează și adaugă secțiune nouă
```
2. **Adaugă noul proces/pas**
3. **Actualizează versiunea**:
```markdown
**Versiune**: 1.1 ← increment
**Ultima actualizare**: 2025-01-XX
**Changelog**:
- v1.1: Adăugat suport pentru [feature]
- v1.0: Versiune inițială
```
### Îmbunătățire Exemple
Adaugă mai multe exemple în secțiunea "Exemple Complete":
```markdown
### Exemplu 3: [Nou Scenariu]
[Descriere completă]
```
### Adăugare Troubleshooting
În secțiunea "Troubleshooting", adaugă noi probleme rezolvate:
```markdown
### Problem: [Problemă nouă descoperită]
**Cauză**: [De ce se întâmplă]
**Soluție**: [Pași de rezolvare]
**Prevenire**: [Cum să eviți în viitor]
```
---
## Upgrade Sistem General
### 1. Adăugare Nou Subsistem
**Exemplu**: Adăugare "Templates System"
```bash
mkdir -p .claude/context/templates/
```
Creează `templates/claude.md`:
```markdown
# Templates System
## Scop
[Descriere subsistem nou]
## Când să folosești
[Situații]
## Template-uri disponibile
- template-1
- template-2
```
Actualizează `context/claude.md`:
```markdown
### 5. Templates System (`~/.claude/context/templates/`)
**Scop**: [Scurt]
**Când să folosești**: [Scurt]
**Cum să accesezi**: [Instrucțiuni]
```
### 2. Adăugare Nou Tip Proiect
```bash
mkdir -p .claude/context/projects/[new-type]/
```
**Exemple**:
- `projects/finance/` - Analiză financiară
- `projects/marketing/` - Marketing content
- `projects/coding/` - Development projects
Creează `projects/[type]/claude.md` cu workflow specific.
### 3. Upgrade Tools Documentation
Editează `context/tools/claude.md`:
```markdown
### [Număr]. [Nume Tool Nou]
**Scop**: [Ce face]
**Când să folosești**: [Situații]
**Sintaxă**:
```
[Cod exemplu]
```
**Best Practices**:
- Practice 1
- Practice 2
```
---
## Checklist Post-Adăugare
După ce adaugi un skill nou:
- [ ] SKILL.md creat cu YAML frontmatter valid
- [ ] Toate secțiunile completate (minimum: Prezentare, Când să folosești, Proces, Exemple)
- [ ] Minim 2 exemple complete incluse
- [ ] Troubleshooting section adăugată
- [ ] context/claude.md actualizat cu noul skill
- [ ] Testat skill-ul într-o conversație
- [ ] Documentat în memory/learnings.md dacă e relevant
---
## Tips pentru Skills de Calitate
### ✅ Best Practices
1. **Claritate**: Scrie de parcă utilizatorul nu știe nimic despre task
2. **Completitudine**: Include toate edge cases
3. **Exemple**: Minimum 2, ideal 3-4 scenarii diferite
4. **Troubleshooting**: Anticipează problemele comune
5. **Tools specifice**: Listează exact ce tools folosești
6. **Integrare**: Menționează cum se combină cu alte skills
### ❌ Ce să Eviți
1. **Ambiguitate**: "Fă cercetare bună" (prea vag)
2. **Presupuneri**: Nu presupune cunoștințe implicite
3. **Lips exemple**: Skill fără exemple concrete
4. **Overflow**: Nu încărca TOT într-un singur skill (păstrează modular)
5. **Duplicate**: Nu duplica logic din alte skills
---
## Versioning Skills
**Schema**: `MAJOR.MINOR`
- **MAJOR** (1.0 → 2.0): Schimbări majore în proces/workflow
- **MINOR** (1.0 → 1.1): Adăugare features, îmbunătățiri
**Changelog format**:
```markdown
**Changelog**:
- v1.2: Adăugat suport pentru format X
- v1.1: Îmbunătățit troubleshooting section
- v1.0: Versiune inițială
```
---
## Testare Skills Noi
### Test Manual
1. **Citește skill-ul** într-o conversație nouă
2. **Execută task-ul** urmând pașii din skill
3. **Verifică output-ul** vs. așteptări
4. **Documentează** orice probleme în troubleshooting
### Test Integrat
1. **Combină cu alte skills**
2. **Verifică flow-ul** natural între skills
3. **Testează edge cases**
---
## Resurse
- **Template blank**: Vezi secțiunea "Template" de mai sus
- **Exemple existente**: `.claude/skills/web-research/` și `.claude/skills/research-report/`
- **Documentație**: `.claude/context/claude.md`
---
**Întrebări?** Consultă `context/claude.md` sau creează un issue în memory/learnings.md

219
.claude/docs/QUICK-REFERENCE.md Normal file
View File

@@ -0,0 +1,219 @@
# Nova PAI - Quick Reference Card
## 🚀 Adăugare Skill Nou - 4 Pași
```bash
# 1. Creează directorul
mkdir -p .claude/skills/[nume-skill]/
# 2. Creează SKILL.md
cat > .claude/skills/[nume-skill]/SKILL.md << 'EOF'
---
name: [nume-skill]
description: "Scurtă descriere (max 2 fraze)"
---
# [Nume] Skill
## Prezentare
[Ce face skill-ul]
## Când să Folosești
- Situație 1
- Situație 2
## Proces de Execuție
### Pas 1: [Nume]
[Descriere]
### Pas 2: [Nume]
[Descriere]
## Exemple Complete
### Exemplu 1: [Scenariu]
**Input**: "..."
**Output**: ...
## Troubleshooting
### Problem: [Problemă]
**Soluție**: [Fix]
---
**Versiune**: 1.0
**Ultima actualizare**: [DATA]
EOF
# 3. Actualizează context/claude.md
# Adaugă în lista "Skills disponibile":
# - `[nume-skill]/` - [Descriere]
# 4. Testează
# În conversație: "Folosește skill-ul [nume-skill] pentru..."
```
---
## 📁 Structura Fișiere
### Skill Simplu
```
.claude/skills/[nume]/
└── SKILL.md
```
### Skill Complex
```
.claude/skills/[nume]/
├── SKILL.md
├── template.md
├── examples/
│ ├── example1.md
│ └── example2.md
└── reference.md
```
---
## 🔧 Upgrade Sistem
### Adaugă Subsistem Nou
```bash
mkdir -p .claude/context/[subsistem]/
# Creează [subsistem]/claude.md
# Actualizează context/claude.md secțiunea "Subsisteme Disponibile"
```
### Adaugă Tip Proiect Nou
```bash
mkdir -p .claude/context/projects/[tip]/
# Creează [tip]/claude.md cu workflow specific
# Actualizează context/claude.md
```
### Adaugă Tool Documentation
```bash
# Editează .claude/context/tools/claude.md
# Adaugă secțiune nouă cu sintaxă și best practices
```
---
## 📝 Template YAML Frontmatter
```yaml
---
name: skill-name
description: "Concise description in 1-2 sentences"
version: "1.0"
author: "Your Name"
tags: ["tag1", "tag2"]
requires: ["other-skill"] # optional
---
```
---
## ✅ Checklist Post-Skill
- [ ] YAML frontmatter valid
- [ ] Secțiune "Când să folosești"
- [ ] Proces în pași numerotați
- [ ] Minimum 2 exemple
- [ ] Troubleshooting section
- [ ] context/claude.md actualizat
- [ ] Testat în conversație
---
## 🎯 Skills Ideas
### Development
- `code-review` - Review cod profesional
- `debug-assistant` - Debugging workflow
- `api-design` - Design REST APIs
- `test-generation` - Generare teste
### Data & Analysis
- `data-analysis` - Pandas, numpy, stats
- `visualization` - Charts, graphs
- `sql-query` - Query optimization
- `data-cleaning` - Preprocessing data
### Content & Communication
- `email-drafting` - Email profesionale
- `presentation` - Slides și prezentări
- `documentation` - Docs tehnice
- `copywriting` - Marketing copy
### Business
- `market-research` - Analiză piață
- `competitive-analysis` - Analiză competitori
- `financial-analysis` - Analiză financiară
- `business-plan` - Business planning
---
## 🔄 Workflow Adăugare
```
Idee Skill → Template → Scriere → Test → Update Context → Deploy
↓ ↓ ↓ ↓ ↓ ↓
Validare SKILL.md Content Manual claude.md Production
```
---
## 📚 Fișiere Importante
| Fișier | Scop | Când Modifici |
|--------|------|---------------|
| `context/claude.md` | Master doc | La fiecare skill nou |
| `output_style.md` | Identitate | Schimbări personalitate |
| `context/tools/claude.md` | Tools docs | Tool nou/updated |
| `memory/learnings.md` | Învățări | Post probleme rezolvate |
---
## 💡 Tips
### ✅ DO
- Păstrează skills modulare și focusate
- Include multe exemple
- Documentează edge cases
- Testează înainte de deploy
### ❌ DON'T
- Nu face skills prea largi
- Nu duplica logică din alte skills
- Nu uita să updatezi context/claude.md
- Nu omite troubleshooting
---
## 🆘 Help
**Documentație completă**: `.claude/docs/HOW-TO-ADD-SKILLS.md`
**Exemple**: `.claude/skills/web-research/` și `/research-report/`
**Arhitectură**: `.claude/context/claude.md`
**README general**: `.claude/README.md`
---
## 🔗 Links Rapide
```bash
# Vezi toate skills
ls -la .claude/skills/
# Citește arhitectura
cat .claude/context/claude.md
# Ghid complet
cat .claude/docs/HOW-TO-ADD-SKILLS.md
# Template skill
cat .claude/docs/HOW-TO-ADD-SKILLS.md | grep -A50 "Template:"
```

185
.claude/hooks/load-context.ts Normal file
View File

@@ -0,0 +1,185 @@
/**
* Hook: load-context
*
* Purpose: Ensures Nova loads the appropriate context before responding
* to user requests, implementing the progressive disclosure pattern.
*
* Trigger: On user prompt submit
*
* This hook injects instructions to load context files based on the
* task type and requirements.
*/
/**
* IMPLEMENTATION NOTE:
*
* Claude Code hooks may differ from the Anthropic SDK shown below.
* This is a conceptual implementation that demonstrates the intended behavior.
*
* For Claude Code, hooks might be configured differently. This file serves as:
* 1. Documentation of the intended behavior
* 2. Reference for manual context loading
* 3. Template for future hook implementation
*
* MANUAL ALTERNATIVE:
* If hooks aren't supported, Nova should manually check at conversation start:
* - Have I read .claude/context/claude.md in THIS conversation?
* - If not, read it immediately
* - Load relevant subsystems based on the task
*/
// Conceptual Hook Implementation
export default {
name: 'load-context',
version: '1.0',
/**
* This function would be called before Nova sees the user's message
*/
async onUserPromptSubmit(context: any) {
// Check if this is the first message in the conversation
const isFirstMessage = context.conversationHistory.length === 0;
// Construct context loading reminder
const contextReminder = `
🔄 CONTEXT LOADING PROTOCOL
Before responding to this message, follow these steps:
1. ✅ Have you read ~/.claude/context/claude.md in THIS conversation?
- If NO: Read it now with the Read tool
- If YES: Proceed to step 2
2. ✅ Analyze the user's request to identify:
- Task type (research, report, analysis, etc.)
- Required skills (web-research, research-report, etc.)
- Relevant context subsystems (projects, tools, memory)
3. ✅ Load ONLY the relevant context files (progressive disclosure):
- For research tasks: Read context/projects/research/claude.md
- For web searches: Read skills/web-research/SKILL.md
- For report generation: Read skills/research-report/SKILL.md
- If using tools: Read context/tools/claude.md
- For repeat patterns: Read context/memory/claude.md
4. ✅ Proceed with the task using the loaded context
DO NOT:
- Skip reading context files
- Load all context at once
- Claim you've read files without actually using Read tool
- Ignore the progressive disclosure principle
---
User's message:
`;
// For first message, add stronger reminder
if (isFirstMessage) {
return {
...context,
userMessage: contextReminder + context.userMessage,
metadata: {
...context.metadata,
contextLoadingRequired: true,
firstMessage: true
}
};
}
// For subsequent messages, lighter reminder
const lightReminder = `
[System: Remember to load relevant context files if tackling a new type of task]
`;
return {
...context,
userMessage: lightReminder + context.userMessage
};
},
/**
* Optional: After Nova responds, check if context was properly loaded
*/
async onAssistantResponse(context: any) {
// This could verify that appropriate Read calls were made
// and warn if context loading was skipped
const readCalls = context.toolCalls?.filter((call: any) =>
call.tool === 'Read' && call.parameters.file_path.includes('.claude/context')
) || [];
if (context.metadata?.contextLoadingRequired && readCalls.length === 0) {
console.warn('Warning: Context loading was required but no context files were read');
}
return context;
}
};
/**
* CONFIGURATION INSTRUCTIONS:
*
* To enable this hook in Claude Code:
*
* 1. Check Claude Code documentation for hook configuration
* 2. Register this hook in the appropriate config file
* 3. Restart Claude Code or reload configuration
*
* If hooks are not supported:
* - Add instructions to output_style.md
* - Rely on context/claude.md instructions
* - Manually prompt for context loading at conversation start
*/
/**
* TESTING:
*
* To test if the hook is working:
*
* Test 1: Start new conversation
* User: "Hello"
* Expected: Nova should mention reading context/claude.md
*
* Test 2: Research task
* User: "Research quantum computing"
* Expected: Nova should read context/claude.md, projects/research/, and web-research skill
*
* Test 3: Continuation
* User: "Now make a report"
* Expected: Nova should read research-report skill (new task type)
*/
/**
* FALLBACK STRATEGY:
*
* If hooks don't work, add this to output_style.md:
*
* ```
* MANDATORY BEHAVIOR:
* At the start of EVERY conversation, you MUST:
* 1. Read ~/.claude/context/claude.md
* 2. Understand available subsystems
* 3. Load relevant context based on user's request
*
* For EVERY new task type, you MUST:
* 1. Check if you need additional context
* 2. Read relevant skill or context files
* 3. Follow the progressive disclosure pattern
* ```
*/
// Type definitions for reference
interface ConversationContext {
userMessage: string;
conversationHistory: Array<any>;
metadata?: {
contextLoadingRequired?: boolean;
firstMessage?: boolean;
};
toolCalls?: Array<{
tool: string;
parameters: any;
}>;
}

32
.claude/output_style.md Normal file
View File

@@ -0,0 +1,32 @@
# Nova - Asistent Personal de Cercetare
Tu ești **Nova**, un asistent personal de cercetare și analiză.
## Identitate și Rol
- **Rol Principal**: Ajuți utilizatorul să cerceteze subiecte complexe, să analizeze informații și să genereze rapoarte profesionale
- **Expertiză**: Cercetare web, analiză de conținut, sinteză de informații, raportare structurată
- **Limbă**: Răspunzi în română implicit, dar poți lucra și în engleză când e necesar
## Stil de Comunicare
- Profesional dar accesibil
- Concis în conversații, detaliat în rapoarte
- Transparent despre procesul de lucru
- Proactiv în sugestii și optimizări
## Comportament
- Întotdeauna citești contextul sistemului înainte de a răspunde
- Folosești progressive disclosure pentru a încărca doar contextul necesar
- Documentezi procesul de lucru în fișiere de memorie
- Întrebi clarificări când task-ul este ambiguu
## Acces la Context
Ai acces la:
- Sistemul de context din `~/.claude/context/`
- Skills specializate din `~/.claude/skills/`
- Memorie persistentă pentru a învăța preferințele utilizatorului
**IMPORTANT**: Înainte de orice task major, citește `~/.claude/context/claude.md` pentru a înțelege arhitectura sistemului.

377
.claude/skills/research-report/SKILL.md Normal file
View File

@@ -0,0 +1,377 @@
---
name: research-report
description: "Skill pentru generarea de rapoarte profesionale de cercetare în format Markdown sau DOCX. Folosește după ce ai finalizat cercetarea și ai toate informațiile."
---
# Research Report Generation Skill
## Prezentare
Acest skill te ghidează în crearea de rapoarte profesionale, bine structurate și formatate pentru cercetările efectuate.
## Când să Folosești
- Ai finalizat cercetarea cu `web-research` skill
- Utilizatorul cere explicit un raport
- Ai suficiente informații pentru un document complet (5+ surse)
- Task necesită documentare formală
## Pre-requisite
Înainte de a genera raportul, asigură-te că ai:
- ✅ Minim 5 surse credibile
- ✅ Informații cheie extrase și organizate
- ✅ Analiză și sinteză completă
- ✅ Lista completă de surse cu URL-uri
## Structura Raportului
### Template Standard
```markdown
# [TITLU RAPORT]
**Autor**: Nova (Asistent AI)
**Data**: [DATA]
**Subiect**: [SUBIECT CERCETARE]
---
## Executive Summary
[2-3 paragrafe care rezumă întregul raport]
[Răspunde la întrebările: Ce? De ce e important? Ce am descoperit? Ce înseamnă asta?]
---
## 1. Introducere
### 1.1 Context și Motivație
[De ce e relevant acest subiect?]
[Ce problemă sau întrebare adresează?]
### 1.2 Obiective
[Ce vrem să aflăm?]
[Ce întrebări specifice răspundem?]
### 1.3 Scop și Domeniu
[Ce acoperă raportul?]
[Ce NU acoperă (limitări)?]
---
## 2. Metodologie
### 2.1 Surse de Informații
[Ce tipuri de surse am folosit?]
- Academice
- Profesionale
- Industrie
- etc.
### 2.2 Criterii de Selecție
[Cum am evaluat credibilitatea?]
[Cum am filtrat informațiile?]
### 2.3 Perioada Analizată
[Ce interval de timp?]
[De ce acest interval?]
---
## 3. Descoperiri Principale
### 3.1 [Tema/Descoperire 1]
**Context**:
[Explicație și background]
**Detalii Cheie**:
- [Punct important 1]
- [Punct important 2]
- [Statistici/date relevante]
**Surse**:
- [Sursă 1] - [Author, Date]
- [Sursă 2] - [Author, Date]
### 3.2 [Tema/Descoperire 2]
[Repetă structura]
### 3.3 [Tema/Descoperire 3]
[Repetă structura]
---
## 4. Analiză și Implicații
### 4.1 Pattern-uri Identificate
[Ce teme comune am găsit?]
[Ce legături există între descoperiri?]
### 4.2 Perspective Multiple
[Unde există consens?]
[Unde există dezacord?]
[De ce există aceste diferențe?]
### 4.3 Implicații Practice
[Ce înseamnă aceste descoperiri în practică?]
[Cine e afectat și cum?]
[Ce oportunități sau riscuri există?]
---
## 5. Provocări și Limitări
### 5.1 Provocări Identificate
[Ce obstacole sau probleme am descoperit?]
### 5.2 Limitări ale Cercetării
[Ce nu am putut acoperi?]
[Ce întrebări rămân deschise?]
[Ce surse ne-au lipsit?]
---
## 6. Concluzii
### 6.1 Sinteza Descoperirilor
[Care sunt cele mai importante takeaways?]
[Cum răspundem la întrebările inițiale?]
### 6.2 Perspective de Viitor
[Cum ar putea evolua situația?]
[Ce ar trebui monitorizat?]
---
## 7. Recomandări
[Dacă e relevant pentru task]
### 7.1 Pentru Practicieni
[Acțiuni concrete pentru cei care implementează]
### 7.2 Pentru Cercetare Viitoare
[Ce domenii necesită mai multă cercetare?]
---
## 8. Referințe și Surse
### Surse Principale
1. **[Titlu Articol/Paper]**
- Autor(i): [...]
- Publicat: [Data]
- URL: [Link complet]
- Relevență: [De ce e important această sursă]
2. **[Titlu Articol/Paper]**
[Repetă formatul]
### Surse Secundare
[Liste surse adiționale consultate dar nu citate direct]
---
## Anexe
### Anexa A: [Titlu]
[Informații suplimentare, tabele, grafice]
### Anexa B: [Titlu]
[Alte informații relevante]
---
**Note**:
- [Orice note metodologice sau clarificări]
- [Disclaimer-e dacă e necesar]
**Contact**: Pentru întrebări despre acest raport, contactează [...]
```
## Generare Raport
### Pas 1: Pregătire Conținut
1. **Organizează informațiile colectate**:
- Grupează pe teme/secțiuni
- Ordonează logic
- Identifică ce merge în ce secțiune
2. **Pregătește citatiile**:
- Formatează toate sursele
- Verifică că ai URL-uri complete
- Asigură-te că ai date/autori
### Pas 2: Scriere
**Best Practices**:
✅ **DO**:
- Folosește limbaj clar și profesional
- Fii concis dar complet
- Structurează în paragrafe scurte (3-5 fraze)
- Folosește liste pentru enumerări
- Include headere și sub-headere clare
- Citează sursele în context
- Parafrazează, nu copia verbatim
❌ **DON'T**:
- Nu folosi jargon fără explicații
- Nu face paragrafe lungi (>7 fraze)
- Nu ignora conflicte între surse
- Nu omite limitările cercetării
- Nu exagera concluziile
- Nu copia text din surse
### Pas 3: Formatare
#### Pentru Markdown (.md)
```markdown
# Folosește headere ierarhic
## Nivel 2
### Nivel 3
**Bold pentru accent**
*Italic pentru emphasis*
- Liste cu bullet points
- Pentru enumerări
1. Liste numerotate
2. Pentru pași sau ordine
> Blockquotes pentru citate importante
`code` pentru termeni tehnici
[Link text](URL) pentru referințe
```
### Pas 4: Salvare
```
// ÎNTOTDEAUNA salvează în working directory sau outputs
Write({
file_path: "/mnt/e/proiecte/pai/outputs/raport-[subiect]-[data].md",
content: "[conținut complet]"
})
```
**Nomenclatură fișiere**:
- ✅ `raport-ai-education-2025-01.md`
- ✅ `research-blockchain-healthcare.md`
- ❌ `raport.md` (prea generic)
- ❌ `my document final v2.md` (naming haotic)
## Verificare Finală
Înainte de a prezenta raportul utilizatorului, verifică:
- [ ] Executive summary prezent și clar
- [ ] Toate secțiunile completate
- [ ] Minim 5 surse citate
- [ ] Surse formatate corect
- [ ] Concluzii bazate pe date
- [ ] Limitări menționate
- [ ] Fără copy-paste din surse
- [ ] Fără greșeli gramaticale majore
- [ ] Salvat cu nume descriptiv
- [ ] Link către fișier furnizat utilizatorului
## Prezentare către Utilizator
După generare:
```markdown
✅ Am finalizat cercetarea și raportul!
**Raport generat**: [Link către fișier]
**Rezumat rapid**:
- [Bullet point 1 - descoperire principală]
- [Bullet point 2 - descoperire principală]
- [Bullet point 3 - descoperire principală]
**Detalii**:
- Surse analizate: [X]
- Lungime raport: [Y] pagini/secțiuni
- Format: Markdown
Raportul include analiză detaliată, implicații practice, și liste complete de surse.
```
## Exemple Complete
### Exemplu 1: Raport Simplu
**Input**: "Cercetează despre machine learning în retail și fă raport"
**Output**: Raport de 5-7 pagini cu:
- Executive summary
- Overview ML în retail
- Use cases principale
- Beneficii și provocări
- Case studies
- Concluzii
- 8 surse citate
### Exemplu 2: Raport Comparativ
**Input**: "Compară soluțiile de cloud computing pentru startups"
**Output**: Raport de 8-10 pagini cu:
- Executive summary
- Criterii de comparație
- AWS vs Azure vs GCP
- Tabel comparativ
- Recomandări pe use case
- Analiza costurilor
- 12 surse citate
## Troubleshooting
### Problem: Raport prea scurt
**Soluție**:
- Expandează fiecare secțiune
- Adaugă mai mult context
- Include mai multe exemple
- Extinde analiza
### Problem: Prea multe informații
**Soluție**:
- Focusează pe cele mai relevante
- Mută detalii în anexe
- Rezumă în loc să descrii tot
- Prioritizează descoperiri cheie
### Problem: Surse insuficiente
**Soluție**:
- Întoarce-te la cercetare
- Caută pe niche topics
- Consultă surse academice
- Verifică bibliografii din surse existente
## Note Finale
**Amintește-ți**:
- Un raport bun e echilibrat între detaliu și conciziune
- Obiectivitatea e crucială
- Structura face raportul ușor de parcurs
- Sursele bune fac raportul credibil
- Analiza face raportul valoros
---
**Versiune**: 1.0
**Ultima actualizare**: 2025-01-06

164
.claude/skills/research-report/report-structure-template.md Normal file
View File

@@ -0,0 +1,164 @@
# [TITLU RAPORT]
**Autor**: Nova (Asistent AI)
**Data**: [DATA]
**Subiect**: [SUBIECT CERCETARE]
---
## Executive Summary
[2-3 paragrafe care rezumă întregul raport]
[Răspunde la întrebările: Ce? De ce e important? Ce am descoperit? Ce înseamnă asta?]
---
## 1. Introducere
### 1.1 Context și Motivație
[De ce e relevant acest subiect?]
[Ce problemă sau întrebare adresează?]
### 1.2 Obiective
[Ce vrem să aflăm?]
[Ce întrebări specifice răspundem?]
### 1.3 Scop și Domeniu
[Ce acoperă raportul?]
[Ce NU acoperă (limitări)?]
---
## 2. Metodologie
### 2.1 Surse de Informații
[Ce tipuri de surse am folosit?]
- Academice
- Profesionale
- Industrie
- etc.
### 2.2 Criterii de Selecție
[Cum am evaluat credibilitatea?]
[Cum am filtrat informațiile?]
### 2.3 Perioada Analizată
[Ce interval de timp?]
[De ce acest interval?]
---
## 3. Descoperiri Principale
### 3.1 [Tema/Descoperire 1]
**Context**:
[Explicație și background]
**Detalii Cheie**:
- [Punct important 1]
- [Punct important 2]
- [Statistici/date relevante]
**Surse**:
- [Sursă 1] - [Author, Date]
- [Sursă 2] - [Author, Date]
### 3.2 [Tema/Descoperire 2]
[Repetă structura]
### 3.3 [Tema/Descoperire 3]
[Repetă structura]
---
## 4. Analiză și Implicații
### 4.1 Pattern-uri Identificate
[Ce teme comune am găsit?]
[Ce legături există între descoperiri?]
### 4.2 Perspective Multiple
[Unde există consens?]
[Unde există dezacord?]
[De ce există aceste diferențe?]
### 4.3 Implicații Practice
[Ce înseamnă aceste descoperiri în practică?]
[Cine e afectat și cum?]
[Ce oportunități sau riscuri există?]
---
## 5. Provocări și Limitări
### 5.1 Provocări Identificate
[Ce obstacole sau probleme am descoperit?]
### 5.2 Limitări ale Cercetării
[Ce nu am putut acoperi?]
[Ce întrebări rămân deschise?]
[Ce surse ne-au lipsit?]
---
## 6. Concluzii
### 6.1 Sinteza Descoperirilor
[Care sunt cele mai importante takeaways?]
[Cum răspundem la întrebările inițiale?]
### 6.2 Perspective de Viitor
[Cum ar putea evolua situația?]
[Ce ar trebui monitorizat?]
---
## 7. Recomandări
[Dacă e relevant pentru task]
### 7.1 Pentru Practicieni
[Acțiuni concrete pentru cei care implementează]
### 7.2 Pentru Cercetare Viitoare
[Ce domenii necesită mai multă cercetare?]
---
## 8. Referințe și Surse
### Surse Principale
1. **[Titlu Articol/Paper]**
- Autor(i): [...]
- Publicat: [Data]
- URL: [Link complet]
- Relevență: [De ce e important această sursă]
2. **[Titlu Articol/Paper]**
[Repetă formatul]
### Surse Secundare
[Liste surse adiționale consultate dar nu citate direct]
---
## Anexe
### Anexa A: [Titlu]
[Informații suplimentare, tabele, grafice]
### Anexa B: [Titlu]
[Alte informații relevante]
---
**Note**:
- [Orice note metodologice sau clarificări]
- [Disclaimer-e dacă e necesar]
**Contact**: Pentru întrebări despre acest raport, contactează [...]

265
.claude/skills/web-research/SKILL.md Normal file
View File

@@ -0,0 +1,265 @@
---
name: web-research
description: "Skill pentru cercetare web avansată cu focus pe găsirea și evaluarea surselor credibile. Folosește acest skill când utilizatorul cere cercetare pe un subiect, analiză de informații sau găsire de surse."
---
# Web Research Skill
## Prezentare
Acest skill te ajută să efectuezi cercetări web profesionale, să evaluezi credibilitatea surselor și să extragi informații relevante.
## Când să Folosești
- Utilizatorul cere "cercetează despre..."
- Task-uri care necesită informații actualizate
- Când ai nevoie de multiple surse pe un subiect
- Pentru validare sau verificare de informații
## Proces de Cercetare
### Pas 1: Planificare
**Înainte de a începe căutarea**:
1. Înțelege exact ce caută utilizatorul:
- Ce întrebări specifice trebuie răspunse?
- Ce nivel de detaliu e necesar?
- Ce tip de surse sunt relevante?
2. Identifică tipul de cercetare:
- **Generală**: Overview complet pe subiect
- **Tehnică**: Detalii tehnice, implementări
- **Academică**: Studii, cercetări peer-reviewed
- **Comercială**: Produse, servicii, piață
3. Planifică strategia de căutare:
- Ce keywords să folosești?
- Ce surse să prioritizezi?
- Câte surse sunt necesare (minim 5-7)?
### Pas 2: Căutare Inițială
**Folosește WebSearch strategic**:
```
// Primul search: Larg, pentru overview
WebSearch({ query: "artificial intelligence education" })
// Al doilea search: Mai specific
WebSearch({ query: "AI personalized learning 2024" })
// Al treilea search: Focus pe aspecte specifice
WebSearch({ query: "AI classroom implementation challenges" })
```
**Best Practices pentru Query-uri**:
- ✅ Scurte: 2-4 cuvinte
- ✅ Specifice: Include termeni tehnici relevanți
- ✅ Actuale: Adaugă anul pentru info recentă
- ❌ Evită: Întrebări complete sau fraze lungi
### Pas 3: Evaluare Surse
**Pentru fiecare rezultat, evaluează**:
#### Credibilitate (Prioritate ÎNALTĂ)
**Surse de încredere ridicată** (prioritizează):
- 🟢 Academic: Google Scholar, ArXiv, PubMed, IEEE
- 🟢 Instituțional: .edu, .gov, organizații internaționale
- 🟢 Corporativ oficial: Blog-uri/docs de la companii majore
- 🟢 Media credibilă: NYT, BBC, Reuters, The Guardian
**Surse de încredere medie** (verifică cross-reference):
- 🟡 Medium, Towards Data Science
- 🟡 Blog-uri profesionale individuale
- 🟡 News sites mai mici dar credibile
**Surse de evitat** (nu cita):
- 🔴 Forumuri, Reddit, Quora (doar pentru lead-uri)
- 🔴 Site-uri fără autor sau dată
- 🔴 Content farms, clickbait
- 🔴 Surse evident biased fără disclosure
#### Relevanță
- Informația răspunde la întrebarea utilizatorului?
- E la nivel de detaliu potrivit?
- E actualizată (pentru subiecte care evoluează rapid)?
#### Acoperire
- Sursa oferă informații noi față de ce ai deja?
- Completează sau contrazice alte surse?
### Pas 4: Extragere Informații
**Pentru fiecare sursă relevantă**:
1. **Folosește WebFetch** pentru a citi conținutul complet:
```
WebFetch({ url: "https://credible-source.com/article", prompt: "Extract key findings and main arguments" })
```
2. **Extrage informații cheie**:
- Fapte principale
- Date și statistici
- Argumente pro/contra
- Limitări menționate
- Autori și credențiale
3. **Documentează sursa**:
- URL complet
- Titlu
- Autor (dacă disponibil)
- Dată publicare
- Snippet relevant
### Pas 5: Sinteză
**După ce ai adunat informații**:
1. **Organizează pe teme**:
- Grupează informații similare
- Identifică pattern-uri
- Notează contradicții
2. **Analizează critic**:
- Ce e consensul general?
- Unde există dezacord?
- Ce lipsește din imagine?
- Ce asumpții fac sursele?
3. **Formulează perspective**:
- Care e big picture?
- Ce implicații au informațiile?
- Ce întrebări rămân deschise?
## Template de Lucru
### Tracking Sheet Mental
Pe măsură ce cercetezi, ține minte:
```
Subiect: [...]
Întrebări cheie: [...]
Surse găsite:
1. [URL] - [Tip] - [Credibilitate] - [Informații cheie]
2. [URL] - [Tip] - [Credibilitate] - [Informații cheie]
...
Pattern-uri identificate:
- [...]
- [...]
Gaps în informații:
- [...]
- [...]
```
## Exemple de Cercetare
### Exemplu 1: Cercetare Generală
**Task**: "Cercetează despre blockchain în healthcare"
**Execuție**:
```
1. WebSearch({ query: "blockchain healthcare" })
→ Overview general, identificare subtopics
2. WebSearch({ query: "blockchain medical records 2024" })
→ Focus pe un use case specific
3. WebSearch({ query: "blockchain healthcare challenges" })
→ Perspective critice, limitări
4. WebFetch pe 5-7 articole credibile
5. Sinteză:
- Use cases principale
- Beneficii și provocări
- Stare actuală adoptare
- Perspective viitor
```
### Exemplu 2: Cercetare Tehnică
**Task**: "Cercetează cum funcționează RAG în LLM-uri"
**Execuție**:
```
1. WebSearch({ query: "RAG retrieval augmented generation" })
→ Overview tehnic
2. WebSearch({ query: "RAG implementation tutorial" })
→ Detalii de implementare
3. WebSearch({ query: "RAG vs fine-tuning LLM" })
→ Comparații, trade-offs
4. WebFetch pe documentații tehnice, papers
5. Sinteză:
- Explicație tehnică clară
- Arhitectură și componente
- Implementare practică
- Trade-offs și considerații
```
## Troubleshooting
### Problem: Rezultate irelevante
**Soluție**:
- Reformulează query cu termeni mai specifici
- Adaugă termeni tehnici sau jargon de domeniu
- Restrânge cu year sau domain
### Problem: Surse de calitate scăzută
**Soluție**:
- Adaugă "research", "study", "analysis" la query
- Caută direct pe Google Scholar, ArXiv
- Filtrează după .edu, .gov în rezultate
### Problem: Informații contradictorii
**Soluție**:
- Caută MAI MULTE surse pentru cross-reference
- Prioritizează surse peer-reviewed
- Prezintă ambele perspective în raport
- Notează explicit că există dezacord
### Problem: Subiect prea larg
**Soluție**:
- Întreabă utilizatorul pentru clarificări
- Focusează pe aspecte specifice
- Creează outline înainte de cercetare
## Output Final
După cercetare, ai:
- ✅ 5-10 surse credibile
- ✅ Informații cheie extrase și organizate
- ✅ Pattern-uri și teme identificate
- ✅ Perspective critice și echilibrate
- ✅ Lista completă de surse cu detalii
**Acum ești gata să generezi raportul** folosind `research-report` skill!
## Note Importante
- **NU copia verbatim din surse** - parafrazează și citează
- **NU ignora informații care nu confirmă o narațiune** - fii obiectiv
- **NU te opri la prima sursă** - caută multiple perspective
- **ÎNTOTDEAUNA verifică credibilitatea** surselor
---
**Ultima actualizare**: 2025-01-06
**Versiune**: 1.0