cc-viewer 1.6.182 → 1.6.183

package/concepts/it/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## Definizione
+Modifica un task esistente — il suo stato, contenuto, proprietà, metadati o archi di dipendenza. È così che i task progrediscono attraverso il loro ciclo di vita e come il lavoro viene passato tra Claude Code, teammate e subagenti.
 
-Aggiorna lo stato, il contenuto o le dipendenze di un task nella lista dei task.
+## Quando usare
 
-## Parametri
-
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `taskId` | string | Sì | ID del task da aggiornare |
-| `status` | enum | No | Nuovo stato: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | No | Nuovo titolo |
-| `description` | string | No | Nuova descrizione |
-| `activeForm` | string | No | Testo al presente progressivo mostrato durante l'esecuzione |
-| `owner` | string | No | Nuovo responsabile del task (nome dell'agent) |
-| `metadata` | object | No | Metadati da unire (impostare a null per eliminare una chiave) |
-| `addBlocks` | string[] | No | Lista degli ID dei task bloccati da questo task |
-| `addBlockedBy` | string[] | No | Lista degli ID dei task prerequisiti che bloccano questo task |
-
-## Flusso degli stati
-
-```
-pending → in_progress → completed
-```
-
-`deleted` può essere raggiunto da qualsiasi stato e rimuove permanentemente il task.
-
-## Scenari d'uso
-
-**Adatto per:**
-- Contrassegnare un task come `in_progress` quando si inizia il lavoro
-- Contrassegnare un task come `completed` quando il lavoro è terminato
-- Impostare le dipendenze tra i task
-- Aggiornare il contenuto del task quando i requisiti cambiano
-
-**Regole importanti:**
-- Contrassegnare come `completed` solo quando il task è completamente terminato
-- In caso di errori o blocchi, mantenere `in_progress`
-- Non contrassegnare come `completed` in caso di test falliti, implementazione incompleta o errori non risolti
-
-## Note
-
-- Prima dell'aggiornamento, ottenere lo stato più recente del task tramite TaskGet per evitare dati obsoleti
-- Dopo aver completato un task, chiamare TaskList per trovare il prossimo task disponibile
+- Far transitare un task attraverso il workflow di stato mentre ci lavori.
+- Rivendicare un task assegnando te stesso (o un altro agente) come `owner`.
+- Affinare il `subject` o la `description` una volta che impari di più sul problema.
+- Registrare dipendenze appena scoperte con `addBlocks` / `addBlockedBy`.
+- Allegare `metadata` strutturati come ID di ticket esterni o suggerimenti di priorità.
 
-## Testo originale
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## Parametri
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+- `taskId` (string, obbligatorio): Il task da modificare. Ottienilo da `TaskList` o `TaskCreate`.
+- `status` (string, opzionale): Uno tra `pending`, `in_progress`, `completed`, `deleted`.
+- `subject` (string, opzionale): Titolo imperativo sostitutivo.
+- `description` (string, opzionale): Descrizione dettagliata sostitutiva.
+- `activeForm` (string, opzionale): Testo spinner al presente continuo sostitutivo.
+- `owner` (string, opzionale): Handle di agente o teammate che si assume la responsabilità del task.
+- `metadata` (object, opzionale): Chiavi di metadati da fondere nel task. Imposta una chiave a `null` per eliminarla.
+- `addBlocks` (array of strings, opzionale): ID di task che questo task blocca.
+- `addBlockedBy` (array of strings, opzionale): ID di task che devono completarsi prima di questo.
 
-## Fields You Can Update
+## Workflow di stato
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
+Il ciclo di vita è deliberatamente lineare: `pending` → `in_progress` → `completed`. `deleted` è terminale e usato per ritirare task su cui non si lavorerà mai.
 
-## Status Workflow
+- Imposta `in_progress` nel momento in cui inizi effettivamente il lavoro, non prima. Solo un task alla volta dovrebbe essere `in_progress` per un dato proprietario.
+- Imposta `completed` solo quando il lavoro è completamente fatto — criteri di accettazione soddisfatti, test che passano, output scritto. Se appare un blocker, mantieni il task `in_progress` e aggiungi un nuovo task che descriva cosa deve essere risolto.
+- Non marcare mai un task come `completed` quando i test stanno fallendo, l'implementazione è parziale o hai incontrato errori irrisolti.
+- Usa `deleted` per task cancellati o duplicati; non riutilizzare un task per lavoro non correlato.
 
-Status progresses: `pending` → `in_progress` → `completed`
+## Esempi
 
-Use `deleted` to permanently remove a task.
+### Esempio 1
 
-## Staleness
+Rivendica un task e inizialo.
 
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### Esempio 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+Completa il lavoro e registra una dipendenza di follow-up.
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## Note
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` si fonde chiave per chiave; passare `null` per una chiave la rimuove. Chiama prima `TaskGet` se non sei sicuro del contenuto corrente.
+- `addBlocks` e `addBlockedBy` appendono archi; non rimuovono quelli esistenti. Modificare il grafo distruttivamente richiede un workflow dedicato — consulta il proprietario del team prima di riscrivere le dipendenze.
+- Mantieni `activeForm` sincronizzato quando cambi `subject` così che il testo dello spinner continui a leggersi naturalmente.
+- Non marcare un task come `completed` per silenziarlo. Se l'utente ha cancellato il lavoro, usa `deleted` con una breve motivazione in `description`.
+- Leggi l'ultimo stato di un task con `TaskGet` prima di aggiornare — i teammate potrebbero averlo cambiato tra la tua ultima lettura e la tua scrittura.

package/concepts/it/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Definizione
+Stabilisce un nuovo team di collaborazione con una lista di task condivisa e un canale di messaggistica inter-agente. Un team è la primitiva di coordinamento per il lavoro multi-agente — la sessione principale agisce come leader e istanzia teammate nominati via il tool `Agent`.
 
-Crea un nuovo team per coordinare più agent che lavorano su un progetto. I team permettono l'esecuzione parallela dei task tramite una lista di task condivisa e la messaggistica tra agent.
+## Quando usare
+
+- L'utente richiede esplicitamente un team, uno swarm, una crew o una collaborazione multi-agente.
+- Un progetto ha diversi workstream chiaramente indipendenti che beneficiano di specialisti dedicati (ad esempio frontend, backend, test, docs).
+- Hai bisogno di una lista di task condivisa persistente che più agenti aggiornano man mano che fanno progressi.
+- Vuoi teammate nominati e indirizzabili che possano scambiare messaggi via `SendMessage` piuttosto che chiamate subagente one-shot.
+
+NON usare per una singola ricerca delegata o un singolo fan-out parallelo — semplici chiamate `Agent` sono più leggere e sufficienti.
 
 ## Parametri
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|-----------|------|--------------|-------------|
-| `team_name` | string | Sì | Nome del nuovo team |
-| `description` | string | No | Descrizione / scopo del team |
-| `agent_type` | string | No | Tipo / ruolo del responsabile del team |
+- `team_name` (string, obbligatorio): Identificatore univoco per il team. Usato come nome di directory sotto `~/.claude/teams/` e come argomento `team_name` quando si istanziano i teammate.
+- `description` (string, obbligatorio): Breve dichiarazione dell'obiettivo del team. Mostrata a ogni teammate al momento dello spawn e scritta nella configurazione del team.
+- `agent_type` (string, opzionale): Persona subagente predefinita applicata ai teammate che non la sovrascrivono. Valori tipici sono `general-purpose`, `Explore` o `Plan`.
+
+## Esempi
+
+### Esempio 1: Creare un team di refactor
 
-## Cosa viene creato
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **File di configurazione del team**: `~/.claude/teams/{team-name}/config.json` — memorizza la lista dei membri e i metadati
-- **Directory della lista dei task**: `~/.claude/tasks/{team-name}/` — lista dei task condivisa per tutti i membri del team
+Dopo la creazione, istanzia teammate con `Agent` usando `team_name: "refactor-crew"` e valori `name` distinti come `db-lead`, `migrations` e `tests`.
 
-I team hanno una corrispondenza 1:1 con le liste dei task.
+### Esempio 2: Creare un team di indagine
 
-## Flusso di lavoro del team
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — creare il team e la sua lista dei task
-2. **TaskCreate** — definire i task per il team
-3. **Agent** (con `team_name` + `name`) — avviare i membri del team che si uniscono al team
-4. **TaskUpdate** — assegnare i task ai membri tramite `owner`
-5. I membri lavorano sui task e comunicano tramite **SendMessage**
-6. Terminare i membri al completamento, poi **TeamDelete** per la pulizia
+Ogni teammate istanziato eredita `Explore` come persona predefinita, coerentemente con la natura investigativa in sola lettura del lavoro.
 
-## Strumenti correlati
+## Note
 
-| Strumento | Scopo |
-|-----------|-------|
-| `TeamDelete` | Rimuovere il team e le directory dei task |
-| `SendMessage` | Comunicazione tra agent all'interno del team |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gestire la lista dei task condivisa |
-| `Agent` | Avviare i membri del team che si uniscono al team |
+- Solo un team può essere guidato alla volta da una data sessione. Finisci o elimina il team corrente prima di crearne un altro.
+- Un team è 1:1 con una lista di task condivisa. Il leader possiede la creazione, assegnazione e chiusura dei task; i teammate aggiornano lo stato dei task su cui stanno lavorando.
+- La configurazione del team è persistita in `~/.claude/teams/{team_name}/config.json`, e la directory dei task vive accanto ad essa. Questi file sopravvivono tra sessioni finché non rimossi esplicitamente con `TeamDelete`.
+- I teammate sono istanziati usando il tool `Agent` con `team_name` corrispondente più un `name` distinto. Il `name` diventa l'indirizzo usato da `SendMessage`.
+- Scegli un `team_name` che sia filesystem-safe (lettere, cifre, trattini, underscore). Evita spazi o slash.
+- Scrivi la `description` così che un teammate nuovo, leggendola a freddo, capisca l'obiettivo del team senza ulteriore contesto. Diventa parte del prompt di avvio di ogni teammate.

package/concepts/it/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Definizione
+Smantella il team attualmente attivo, rimuovendo la sua directory di configurazione e la directory dei task condivisi. È la controparte di pulizia di `TeamCreate` ed è tipicamente chiamato dopo che l'obiettivo del team è stato raggiunto e tutti i teammate si sono spenti.
 
-Rimuove un team e le relative directory dei task quando il lavoro di collaborazione multi-agent è completato. È la controparte di pulizia di TeamCreate.
+## Quando usare
 
-## Comportamento
+- Il team ha completato il suo lavoro e il rapporto finale è stato consegnato all'utente.
+- Il team è stato creato per errore o il suo scope è cambiato così drasticamente che ricominciare da capo è più pulito che continuare.
+- Hai bisogno di creare un nuovo team ma ce n'è già uno attivo — elimina prima quello vecchio, poiché solo un team può essere guidato alla volta.
+- Un team è diventato stantio tra sessioni e il suo stato persistito sotto `~/.claude/teams/` non è più necessario.
 
-- Rimuove la directory del team: `~/.claude/teams/{team-name}/`
-- Rimuove la directory della lista dei task: `~/.claude/tasks/{team-name}/`
-- Cancella il contesto del team dalla sessione corrente
+NON chiamare mentre i teammate sono ancora in esecuzione — spegnili prima via `SendMessage` con un `shutdown_request`, attendi ogni `shutdown_response`, poi elimina.
 
-**Importante**: TeamDelete fallirà se il team ha ancora membri attivi. I membri del team devono prima essere terminati correttamente tramite richieste di shutdown di SendMessage.
+## Parametri
 
-## Utilizzo tipico
+`TeamDelete` non accetta parametri nella sua invocazione tipica. Opera sul team attualmente attivo posseduto dalla sessione chiamante.
 
-TeamDelete viene chiamato alla fine di un flusso di lavoro del team:
+## Esempi
 
-1. Tutti i task sono completati
-2. I membri del team vengono terminati tramite `SendMessage` con `shutdown_request`
-3. **TeamDelete** rimuove le directory del team e dei task
+### Esempio 1: Spegnimento di routine dopo il successo
 
-## Strumenti correlati
+1. Trasmetti una richiesta di shutdown al team:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Attendi che ogni teammate risponda con un `shutdown_response`.
+3. Chiama `TeamDelete()` per rimuovere la directory del team e la directory dei task.
 
-| Strumento | Scopo |
-|-----------|-------|
-| `TeamCreate` | Creare un nuovo team e la sua lista dei task |
-| `SendMessage` | Comunicare con i membri del team / inviare richieste di shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gestire la lista dei task condivisa |
-| `Agent` | Avviare i membri del team che si uniscono al team |
+### Esempio 2: Sostituire un team mal configurato
+
+Se `TeamCreate` è stato chiamato con `agent_type` o `description` sbagliati, assicurati prima che nessun teammate sia stato istanziato (o spegnili), poi:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Note
+
+- `TeamDelete` fallisce se qualsiasi teammate è ancora attivo. La risposta di errore elenca i teammate vivi — invia a ciascuno un `shutdown_request` via `SendMessage`, attendi il loro `shutdown_response` e riprova.
+- L'eliminazione è irreversibile dalla prospettiva del tool. La configurazione del team in `~/.claude/teams/{team_name}/config.json` e la sua directory dei task vengono rimosse dal disco. Se hai bisogno che la lista dei task sia preservata, esporta o copia la directory prima di eliminare.
+- Solo la sessione leader che ha creato il team può eliminarlo. Un teammate istanziato non può chiamare `TeamDelete` sul proprio team.
+- Eliminare il team non annulla alcuna modifica al filesystem che i teammate hanno fatto nel repository. Queste sono normali modifiche tracciate da git e devono essere annullate separatamente se indesiderate.
+- Dopo che `TeamDelete` restituisce con successo, la sessione è libera di chiamare `TeamCreate` di nuovo per un nuovo team.

package/concepts/it/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Definizione
+Recupera i contenuti di una pagina web pubblica, converte l'HTML in Markdown ed esegue un piccolo modello ausiliario sul risultato usando un prompt in linguaggio naturale per estrarre le informazioni di cui hai bisogno.
 
-Recupera il contenuto di una pagina web dall'URL specificato, converte l'HTML in markdown e lo elabora con un modello AI in base al prompt.
+## Quando usare
+
+- Leggere una pagina di documentazione pubblica, un post di blog o un RFC referenziato nella conversazione.
+- Estrarre un fatto specifico, uno snippet di codice o una tabella da un URL noto senza caricare l'intera pagina nel contesto.
+- Riassumere note di release o changelog da una risorsa web aperta.
+- Controllare il riferimento API pubblico di una libreria quando il sorgente non è nel repository locale.
+- Seguire un link che l'utente ha incollato nella chat per rispondere a una domanda di follow-up.
 
 ## Parametri
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `url` | string (URI) | Sì | URL completo da recuperare |
-| `prompt` | string | Sì | Descrive quali informazioni estrarre dalla pagina |
+- `url` (string, obbligatorio): Un URL assoluto completamente formato. Un semplice `http://` viene automaticamente aggiornato a `https://`.
+- `prompt` (string, obbligatorio): L'istruzione passata al piccolo modello di estrazione. Descrivi esattamente cosa estrarre dalla pagina, come "list all exported functions" o "return the minimum supported Node version".
+
+## Esempi
+
+### Esempio 1: Estrarre un valore predefinito di configurazione
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+Il tool recupera la pagina docs di Vite, la converte in Markdown e restituisce una risposta breve come "Default is `5173`; accepts a number only."
 
-## Scenari d'uso
+### Esempio 2: Riassumere una sezione di changelog
 
-**Adatto per:**
-- Ottenere il contenuto di pagine web pubbliche
-- Consultare documentazione online
-- Estrarre informazioni specifiche da una pagina web
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**Non adatto per:**
-- URL che richiedono autenticazione (Google Docs, Confluence, Jira, GitHub, ecc.) — cercare prima uno strumento MCP dedicato
-- URL di GitHub — preferire l'uso della CLI `gh`
+Utile quando l'utente chiede "what changed in Node 20.11" e la pagina di release è lunga.
 
 ## Note
 
-- L'URL deve essere un URL valido e completo
-- HTTP viene automaticamente aggiornato a HTTPS
-- I risultati possono essere riassunti se il contenuto è troppo grande
-- Include una cache auto-pulente di 15 minuti
-- Quando l'URL reindirizza a un host diverso, lo strumento restituisce l'URL di reindirizzamento e occorre effettuare una nuova richiesta con il nuovo URL
-- Se è disponibile uno strumento web fetch fornito da MCP, preferire quello
-
-## Testo originale
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- `WebFetch` fallisce su qualsiasi URL che richieda autenticazione, cookie o VPN. Per Google Docs, Confluence, Jira, risorse GitHub private o wiki interni, usa invece un server MCP dedicato che fornisca accesso autenticato.
+- Per qualsiasi cosa ospitata su GitHub (PR, issue, blob di file, risposte API), preferisci la CLI `gh` attraverso `Bash` piuttosto che fare scraping dell'UI web. `gh pr view`, `gh issue view` e `gh api` restituiscono dati strutturati e funzionano contro repository privati.
+- I risultati possono essere riassunti quando la pagina recuperata è molto grande. Se hai bisogno di testo esatto, restringi il `prompt` per chiedere un estratto letterale.
+- Una cache auto-pulente di 15 minuti è applicata per URL. Chiamate ripetute alla stessa pagina durante una sessione sono quasi istantanee ma possono restituire contenuto leggermente stantio. Se la freschezza importa, menzionalo nel prompt o aspetta la scadenza della cache.
+- Se l'host target emette un redirect cross-host, il tool restituisce il nuovo URL in un blocco di risposta speciale e non lo segue automaticamente. Re-invoca `WebFetch` con il target del redirect se vuoi ancora il contenuto.
+- Il prompt è eseguito da un modello più piccolo e veloce dell'assistente principale. Mantienilo stretto e concreto; il ragionamento complesso a più passi è meglio gestito leggendo tu stesso il Markdown grezzo dopo il fetch.
+- Non passare mai segreti, token o identificatori di sessione incorporati nell'URL — i contenuti della pagina e le query string riflesse nell'output possono essere loggati da servizi upstream.

package/concepts/it/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Definizione
+Esegue una ricerca web live e restituisce risultati classificati che l'assistente usa per fondare la sua risposta su informazioni correnti oltre il cutoff di addestramento del modello.
 
-Esegue una query su motore di ricerca, restituendo risultati di ricerca per ottenere informazioni aggiornate.
+## Quando usare
+
+- Rispondere a domande su eventi attuali, release recenti o notizie dell'ultima ora.
+- Cercare l'ultima versione di una libreria, framework o strumento CLI.
+- Trovare documentazione o post di blog quando l'URL esatto è sconosciuto.
+- Verificare un fatto che potrebbe essere cambiato da quando il modello è stato addestrato.
+- Scoprire più prospettive su un argomento prima di recuperare qualsiasi singola pagina con `WebFetch`.
 
 ## Parametri
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `query` | string | Sì | Query di ricerca (minimo 2 caratteri) |
-| `allowed_domains` | string[] | No | Includi solo risultati da questi domini |
-| `blocked_domains` | string[] | No | Escludi risultati da questi domini |
+- `query` (string, obbligatorio): La query di ricerca. Lunghezza minima 2 caratteri. Includi l'anno corrente quando chiedi informazioni "più recenti" o "recenti" così che i risultati siano freschi.
+- `allowed_domains` (array of strings, opzionale): Restringe i risultati solo a questi domini, ad esempio `["nodejs.org", "developer.mozilla.org"]`. Utile quando ti fidi di una fonte specifica.
+- `blocked_domains` (array of strings, opzionale): Esclude risultati da questi domini. Non passare lo stesso dominio sia a `allowed_domains` che a `blocked_domains`.
+
+## Esempi
+
+### Esempio 1: Ricerca di versione con l'anno corrente
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+Restituisce annunci ufficiali ed evita siti aggregatori di bassa qualità.
+
+### Esempio 2: Escludere fonti rumorose
 
-## Scenari d'uso
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**Adatto per:**
-- Ottenere informazioni aggiornate oltre la data di cutoff della conoscenza del modello
-- Cercare eventi attuali e dati recenti
-- Cercare la documentazione tecnica più recente
+Mantiene i risultati focalizzati su advisory dei vendor e tracker di sicurezza.
 
 ## Note
 
-- I risultati di ricerca vengono restituiti in formato hyperlink markdown
-- Dopo l'uso, è obbligatorio aggiungere una sezione "Sources:" alla fine della risposta, elencando gli URL pertinenti
-- Supporta il filtro per dominio (inclusione/esclusione)
-- Usare l'anno corrente nelle query di ricerca
-- Disponibile solo negli Stati Uniti
-
-## Testo originale
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- Quando usi `WebSearch` in una risposta, devi aggiungere una sezione `Sources:` alla fine della tua risposta elencando ogni risultato citato come hyperlink Markdown nella forma `[Title](URL)`. È un requisito obbligatorio, non opzionale.
+- `WebSearch` è disponibile solo per utenti negli Stati Uniti. Se il tool non è disponibile nella tua regione, ripiega su `WebFetch` contro un URL noto o chiedi all'utente di incollare contenuto rilevante.
+- Ogni chiamata esegue la ricerca in un singolo round-trip — non puoi fare streaming o paginare. Affina la query se il primo set di risultati è fuori bersaglio.
+- Il tool restituisce snippet e metadati, non contenuti di pagina completi. Per leggere in profondità un risultato specifico, segui con `WebFetch` usando l'URL restituito.
+- Usa `allowed_domains` per imporre fonti autoritative per domande sensibili alla sicurezza come CVE o compliance, e `blocked_domains` per tagliare fuori le SEO farm che clonano la documentazione.
+- Mantieni le query brevi e basate su parole chiave. Le domande in linguaggio naturale funzionano ma tendono a restituire risposte conversazionali piuttosto che fonti primarie.
+- Non inventare URL basati sull'intuizione di ricerca — esegui sempre la ricerca e cita ciò che il tool ha effettivamente restituito.

package/concepts/it/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Definizione
+Crea un nuovo file o sostituisce completamente i contenuti di uno esistente sul filesystem locale. Poiché sostituisce tutto al percorso target, dovrebbe essere riservato a creazione autentica o riscritture complete intenzionali.
 
-Scrive contenuto nel file system locale. Se il file esiste già, viene sovrascritto.
+## Quando usare
 
-## Parametri
+- Creare un nuovo file sorgente, test o configurazione che non esiste ancora
+- Generare una nuova fixture, snapshot o file di dati da zero
+- Eseguire una riscrittura completa dove un `Edit` incrementale sarebbe più complesso che ricominciare
+- Emettere un artefatto richiesto come uno schema, migrazione o script di build che l'utente ti ha esplicitamente chiesto di produrre
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `file_path` | string | Sì | Percorso assoluto del file (deve essere assoluto) |
-| `content` | string | Sì | Contenuto da scrivere |
+## Parametri
 
-## Scenari d'uso
+- `file_path` (string, obbligatorio): Percorso assoluto del file da scrivere. Qualsiasi directory genitore deve esistere già.
+- `content` (string, obbligatorio): Il testo completo da scrivere nel file. Diventa l'intero corpo del file.
 
-**Adatto per:**
-- Creare nuovi file
-- Quando è necessario riscrivere completamente il contenuto di un file
+## Esempi
 
-**Non adatto per:**
-- Modificare contenuto parziale di un file — usare Edit
-- Non creare proattivamente file di documentazione (*.md) o README, a meno che l'utente non lo richieda esplicitamente
+### Esempio 1: Creare un nuovo modulo helper
+Chiama `Write` con `file_path: "/Users/me/app/src/utils/slugify.ts"` e fornisci l'implementazione come `content`. Usa questo solo dopo aver verificato che il file non esista già.
 
-## Note
+### Esempio 2: Rigenerare un artefatto derivato
+Dopo che il sorgente dello schema cambia, riscrivi `/Users/me/app/generated/schema.json` in una chiamata `Write` usando il JSON appena generato come `content`.
 
-- Se il file di destinazione esiste già, è necessario prima leggerlo tramite Read, altrimenti l'operazione fallisce
-- Sovrascrive l'intero contenuto del file esistente
-- Preferire Edit per modificare file esistenti, Write è solo per creare nuovi file o riscritture complete
+### Esempio 3: Sostituire un piccolo file di fixture
+Per una fixture di test usa e getta dove ogni riga cambia, `Write` può essere più chiaro di una sequenza di chiamate `Edit`. Leggi prima il file, conferma lo scope, poi sovrascrivi.
 
-## Testo originale
-
-<textarea readonly>Writes a file to the local filesystem.
+## Note
 
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- Prima di sovrascrivere un file esistente, devi chiamare `Read` su di esso nella sessione corrente. `Write` si rifiuta di cancellare contenuto non visto.
+- Preferisci `Edit` per qualsiasi modifica che tocchi solo parte di un file. `Edit` invia solo il diff, che è più veloce, più sicuro e più facile da revisionare.
+- Non creare proattivamente documentazione Markdown, file `README.md` o changelog a meno che l'utente non li richieda esplicitamente.
+- Non aggiungere emoji, testo promozionale o banner decorativi a meno che l'utente non richieda quello stile.
+- Verifica prima che la directory genitore esista con una chiamata `Bash` `ls`; `Write` non crea cartelle intermedie.
+- Fornisci il contenuto esattamente come vuoi che venga persistito; non c'è templating o post-processing.