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