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

# 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