initializare

.claude/context/tools/claude.md

@@ -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