cc-viewer 1.6.182 → 1.6.183

package/concepts/fr/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Définition
+Démantèle l'équipe actuellement active, en supprimant son répertoire de configuration et son répertoire de tâches partagé. C'est le pendant de nettoyage de `TeamCreate` et il est typiquement appelé après que l'objectif de l'équipe a été atteint et que tous les coéquipiers ont été arrêtés.
 
-Supprime une équipe et ses répertoires de tâches associés lorsque le travail de collaboration multi-agent est terminé. C'est le pendant de nettoyage de TeamCreate.
+## Quand l'utiliser
 
-## Comportement
+- L'équipe a terminé son travail et le rapport final a été remis à l'utilisateur.
+- L'équipe a été créée par erreur ou son périmètre a tellement changé qu'il est plus propre de repartir de zéro que de continuer.
+- Vous devez créer une nouvelle équipe mais une est déjà active — supprimez d'abord l'ancienne, puisqu'une seule équipe peut être dirigée à la fois.
+- Une équipe est devenue obsolète au fil des sessions et son état persisté sous `~/.claude/teams/` n'est plus nécessaire.
 
-- Supprime le répertoire de l'équipe : `~/.claude/teams/{team-name}/`
-- Supprime le répertoire de liste de tâches : `~/.claude/tasks/{team-name}/`
-- Efface le contexte de l'équipe de la session courante
+N'appelez PAS pendant que des coéquipiers sont encore en cours d'exécution — arrêtez-les d'abord via `SendMessage` avec un `shutdown_request`, attendez chaque `shutdown_response`, puis supprimez.
 
-**Important** : TeamDelete échouera si l'équipe a encore des membres actifs. Les coéquipiers doivent d'abord être arrêtés proprement via des demandes d'arrêt SendMessage.
+## Paramètres
 
-## Utilisation typique
+`TeamDelete` ne prend aucun paramètre dans son invocation typique. Il opère sur l'équipe actuellement active détenue par la session appelante.
 
-TeamDelete est appelé en fin de flux de travail d'équipe :
+## Exemples
 
-1. Toutes les tâches sont terminées
-2. Les coéquipiers sont arrêtés via `SendMessage` avec `shutdown_request`
-3. **TeamDelete** supprime les répertoires de l'équipe et des tâches
+### Exemple 1 : arrêt de routine après succès
 
-## Outils associés
+1. Diffuser une demande d'arrêt à l'équipe :
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Attendre que chaque coéquipier réponde avec un `shutdown_response`.
+3. Appeler `TeamDelete()` pour supprimer le répertoire d'équipe et le répertoire de tâches.
 
-| Outil | Rôle |
-|-------|------|
-| `TeamCreate` | Créer une nouvelle équipe et sa liste de tâches |
-| `SendMessage` | Communiquer avec les coéquipiers / envoyer des demandes d'arrêt |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gérer la liste de tâches partagée |
-| `Agent` | Démarrer des coéquipiers qui rejoignent l'équipe |
+### Exemple 2 : remplacer une équipe mal configurée
+
+Si `TeamCreate` a été appelé avec le mauvais `agent_type` ou `description`, assurez-vous d'abord qu'aucun coéquipier n'a été lancé (ou arrêtez-les), puis :
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Notes
+
+- `TeamDelete` échoue si un coéquipier est encore actif. La réponse d'erreur liste les coéquipiers en vie — envoyez à chacun un `shutdown_request` via `SendMessage`, attendez leur `shutdown_response` et réessayez.
+- La suppression est irréversible du point de vue de l'outil. La configuration de l'équipe à `~/.claude/teams/{team_name}/config.json` et son répertoire de tâches sont supprimés du disque. Si vous avez besoin de préserver la liste de tâches, exportez ou copiez le répertoire avant de supprimer.
+- Seule la session chef qui a créé l'équipe peut la supprimer. Un coéquipier généré ne peut pas appeler `TeamDelete` sur sa propre équipe.
+- Supprimer l'équipe ne rétablit pas les modifications du système de fichiers que les coéquipiers ont apportées dans le dépôt. Ce sont des modifications suivies par git ordinaires et doivent être annulées séparément si indésirables.
+- Après le retour réussi de `TeamDelete`, la session est libre d'appeler `TeamCreate` à nouveau pour une nouvelle équipe.

package/concepts/fr/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Définition
+Récupère le contenu d'une page web publique, convertit le HTML en Markdown et exécute un petit modèle auxiliaire sur le résultat à l'aide d'une invite en langage naturel pour extraire les informations dont vous avez besoin.
 
-Récupère le contenu d'une page web à partir d'une URL spécifiée, convertit le HTML en markdown et traite le contenu avec un modèle d'IA selon le prompt.
+## Quand l'utiliser
+
+- Lire une page de documentation publique, un article de blog ou une RFC référencé dans la conversation.
+- Extraire un fait spécifique, un extrait de code ou un tableau d'une URL connue sans charger la page entière dans le contexte.
+- Résumer des notes de version ou des changelogs d'une ressource web ouverte.
+- Consulter la référence d'API publique d'une bibliothèque lorsque le code source n'est pas dans le dépôt local.
+- Suivre un lien que l'utilisateur a collé dans le chat pour répondre à une question de suivi.
 
 ## Paramètres
 
-| Paramètre | Type | Requis | Description |
-|-----------|------|--------|-------------|
-| `url` | string (URI) | Oui | URL complète à récupérer |
-| `prompt` | string | Oui | Décrit quelles informations extraire de la page |
+- `url` (string, requis) : une URL absolue bien formée. Le simple `http://` est automatiquement mis à niveau en `https://`.
+- `prompt` (string, requis) : l'instruction passée au petit modèle d'extraction. Décrivez exactement ce qu'il faut extraire de la page, par exemple « list all exported functions » ou « return the minimum supported Node version ».
+
+## Exemples
+
+### Exemple 1 : extraire une valeur de configuration par défaut
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+L'outil récupère la page de documentation Vite, la convertit en Markdown et renvoie une courte réponse telle que « Default is `5173`; accepts a number only. »
 
-## Cas d'utilisation
+### Exemple 2 : résumer une section de changelog
 
-**Adapté pour :**
-- Récupérer le contenu de pages web publiques
-- Consulter la documentation en ligne
-- Extraire des informations spécifiques de pages 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 adapté pour :**
-- URLs nécessitant une authentification (Google Docs, Confluence, Jira, GitHub, etc.) — chercher d'abord des outils MCP dédiés
-- URLs GitHub — préférer utiliser le CLI `gh`
+Utile lorsque l'utilisateur demande « qu'est-ce qui a changé dans Node 20.11 » et que la page de version est longue.
 
 ## Notes
 
-- L'URL doit être une URL valide complète
-- HTTP est automatiquement mis à niveau vers HTTPS
-- Les résultats peuvent être résumés si le contenu est trop volumineux
-- Inclut un cache auto-nettoyant de 15 minutes
-- Quand l'URL redirige vers un hôte différent, l'outil renvoie l'URL de redirection et il faut refaire la requête avec la nouvelle URL
-- Si un outil web fetch fourni par MCP est disponible, préférer l'utiliser
-
-## Texte original
-
-<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` échoue sur toute URL nécessitant authentification, cookies ou VPN. Pour Google Docs, Confluence, Jira, les ressources GitHub privées ou les wikis internes, utilisez plutôt un serveur MCP dédié qui fournit un accès authentifié.
+- Pour tout ce qui est hébergé sur GitHub (PR, issues, blobs de fichiers, réponses d'API), préférez la CLI `gh` via `Bash` plutôt que de scraper l'UI web. `gh pr view`, `gh issue view` et `gh api` renvoient des données structurées et fonctionnent sur des dépôts privés.
+- Les résultats peuvent être résumés lorsque la page récupérée est très grande. Si vous avez besoin du texte exact, restreignez le `prompt` pour demander un extrait littéral.
+- Un cache auto-nettoyant de 15 minutes est appliqué par URL. Les appels répétés à la même page pendant une session sont quasi instantanés mais peuvent renvoyer du contenu légèrement obsolète. Si la fraîcheur importe, mentionnez-le dans l'invite ou attendez que le cache expire.
+- Si l'hôte cible émet une redirection cross-host, l'outil renvoie la nouvelle URL dans un bloc de réponse spécial et ne la suit pas automatiquement. Réinvoquez `WebFetch` avec la cible de redirection si vous voulez toujours le contenu.
+- L'invite est exécutée par un modèle plus petit et plus rapide que l'assistant principal. Gardez-la étroite et concrète ; le raisonnement complexe en plusieurs étapes est mieux géré en lisant vous-même le Markdown brut après la récupération.
+- Ne passez jamais de secrets, jetons ou identifiants de session intégrés dans l'URL — le contenu des pages et les chaînes de requête reflétés dans la sortie peuvent être enregistrés par les services en amont.

package/concepts/fr/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Définition
+Effectue une recherche web en direct et renvoie des résultats classés que l'assistant utilise pour ancrer sa réponse dans des informations actuelles au-delà de la date limite d'entraînement du modèle.
 
-Exécute des requêtes sur les moteurs de recherche et renvoie des résultats de recherche pour obtenir des informations à jour.
+## Quand l'utiliser
+
+- Répondre à des questions sur des événements actuels, des versions récentes ou des actualités de dernière minute.
+- Consulter la dernière version d'une bibliothèque, d'un framework ou d'un outil CLI.
+- Trouver de la documentation ou des articles de blog lorsque l'URL exacte est inconnue.
+- Vérifier un fait qui peut avoir changé depuis l'entraînement du modèle.
+- Découvrir plusieurs perspectives sur un sujet avant de récupérer une page unique avec `WebFetch`.
 
 ## Paramètres
 
-| Paramètre | Type | Requis | Description |
-|-----------|------|--------|-------------|
-| `query` | string | Oui | Requête de recherche (minimum 2 caractères) |
-| `allowed_domains` | string[] | Non | N'inclure que les résultats de ces domaines |
-| `blocked_domains` | string[] | Non | Exclure les résultats de ces domaines |
+- `query` (string, requis) : la requête de recherche. Longueur minimale de 2 caractères. Incluez l'année courante lorsque vous posez des questions sur des informations « latest » ou « recent » afin que les résultats soient frais.
+- `allowed_domains` (array de strings, optionnel) : limite les résultats à ces domaines uniquement, par exemple `["nodejs.org", "developer.mozilla.org"]`. Utile lorsque vous faites confiance à une source spécifique.
+- `blocked_domains` (array de strings, optionnel) : exclut les résultats de ces domaines. Ne passez pas le même domaine à la fois à `allowed_domains` et `blocked_domains`.
+
+## Exemples
+
+### Exemple 1 : recherche de version avec l'année courante
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+Renvoie les annonces officielles et évite les sites agrégateurs de faible qualité.
+
+### Exemple 2 : exclure les sources bruyantes
 
-## Cas d'utilisation
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**Adapté pour :**
-- Obtenir des informations à jour au-delà de la date de coupure des connaissances du modèle
-- Rechercher des événements actuels et des données récentes
-- Rechercher la documentation technique la plus récente
+Garde les résultats concentrés sur les avis des fournisseurs et les trackers de sécurité.
 
 ## Notes
 
-- Les résultats de recherche sont renvoyés au format d'hyperliens markdown
-- Après utilisation, une section « Sources: » doit être incluse à la fin de la réponse, listant les URLs pertinentes
-- Supporte le filtrage de domaines (inclusion/exclusion)
-- L'année en cours doit être utilisée dans les requêtes de recherche
-- Disponible uniquement aux États-Unis
-
-## Texte original
-
-<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>
+- Lorsque vous utilisez `WebSearch` dans une réponse, vous devez ajouter une section `Sources:` à la fin de votre réponse listant chaque résultat cité sous forme d'hyperlien Markdown au format `[Title](URL)`. C'est une exigence stricte, pas optionnelle.
+- `WebSearch` n'est disponible que pour les utilisateurs aux États-Unis. Si l'outil est indisponible dans votre région, repliez-vous sur `WebFetch` contre une URL connue ou demandez à l'utilisateur de coller le contenu pertinent.
+- Chaque appel effectue la recherche en un seul aller-retour — vous ne pouvez pas streamer ni paginer. Affinez la requête si le premier ensemble de résultats est hors cible.
+- L'outil renvoie des extraits et des métadonnées, pas le contenu complet des pages. Pour lire en profondeur un résultat spécifique, enchaînez avec `WebFetch` en utilisant l'URL renvoyée.
+- Utilisez `allowed_domains` pour imposer un sourcing autoritaire sur les questions de sécurité sensibles telles que les CVE ou la conformité, et `blocked_domains` pour éliminer les fermes SEO qui recopient la documentation.
+- Gardez les requêtes courtes et basées sur des mots-clés. Les questions en langage naturel fonctionnent mais tendent à renvoyer des réponses conversationnelles plutôt que des sources primaires.
+- N'inventez pas d'URL basées sur l'intuition de recherche — exécutez toujours la recherche et citez ce que l'outil a réellement renvoyé.

package/concepts/fr/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Définition
+Crée un nouveau fichier ou remplace entièrement le contenu d'un fichier existant sur le système de fichiers local. Comme il remplace tout au chemin cible, il doit être réservé à la création réelle ou aux réécritures complètes intentionnelles.
 
-Écrit du contenu dans le système de fichiers local. Si le fichier existe déjà, il est écrasé.
+## Quand l'utiliser
 
-## Paramètres
+- Créer un tout nouveau fichier source, de test ou de configuration qui n'existe pas encore
+- Générer une fixture, un snapshot ou un fichier de données à partir de zéro
+- Effectuer une réécriture complète lorsqu'un `Edit` incrémental serait plus complexe que de repartir de zéro
+- Émettre un artefact demandé tel qu'un schéma, une migration ou un script de build que l'utilisateur a explicitement demandé de produire
 
-| Paramètre | Type | Requis | Description |
-|-----------|------|--------|-------------|
-| `file_path` | string | Oui | Chemin absolu du fichier (doit être un chemin absolu) |
-| `content` | string | Oui | Contenu à écrire |
+## Paramètres
 
-## Cas d'utilisation
+- `file_path` (string, requis) : chemin absolu du fichier à écrire. Tous les répertoires parents doivent déjà exister.
+- `content` (string, requis) : texte complet à écrire dans le fichier. Cela devient le corps entier du fichier.
 
-**Adapté pour :**
-- Créer de nouveaux fichiers
-- Quand il faut réécrire complètement le contenu d'un fichier
+## Exemples
 
-**Non adapté pour :**
-- Modifier du contenu partiel d'un fichier — utiliser Edit
-- Ne pas créer proactivement des fichiers de documentation (*.md) ou README, sauf si l'utilisateur le demande explicitement
+### Exemple 1 : créer un nouveau module d'aide
+Appelez `Write` avec `file_path: "/Users/me/app/src/utils/slugify.ts"` et fournissez l'implémentation comme `content`. Utilisez-le uniquement après avoir vérifié que le fichier n'existe pas déjà.
 
-## Notes
+### Exemple 2 : régénérer un artefact dérivé
+Après que le source du schéma a changé, réécrivez `/Users/me/app/generated/schema.json` en un seul appel `Write` en utilisant le JSON fraîchement généré comme `content`.
 
-- Si le fichier cible existe déjà, il doit d'abord être lu avec Read, sinon l'opération échouera
-- Écrase tout le contenu du fichier existant
-- Préférer Edit pour éditer des fichiers existants, Write uniquement pour créer de nouveaux fichiers ou des réécritures complètes
+### Exemple 3 : remplacer un petit fichier de fixture
+Pour une fixture de test jetable où chaque ligne change, `Write` peut être plus clair qu'une séquence d'appels `Edit`. Lisez d'abord le fichier, confirmez la portée, puis écrasez.
 
-## Texte original
-
-<textarea readonly>Writes a file to the local filesystem.
+## Notes
 
-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>
+- Avant d'écraser un fichier existant, vous devez appeler `Read` dessus dans la session en cours. `Write` refuse d'écraser du contenu non lu.
+- Préférez `Edit` pour tout changement qui ne touche qu'une partie d'un fichier. `Edit` n'envoie que le diff, ce qui est plus rapide, plus sûr et plus facile à relire.
+- Ne créez pas de manière proactive de documentation Markdown, de `README.md` ou de fichiers changelog sauf si l'utilisateur les demande explicitement.
+- N'ajoutez pas d'emojis, de texte marketing ou de bannières décoratives sauf si l'utilisateur demande ce style.
+- Vérifiez d'abord que le répertoire parent existe avec un appel `Bash` `ls` ; `Write` ne crée pas de dossiers intermédiaires.
+- Fournissez le contenu exactement tel que vous voulez qu'il soit persisté ; il n'y a pas de templating ni de post-traitement.

package/concepts/fr/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## Définition
+Exécute un extrait de code dans un noyau ou un sandbox en direct fourni par une intégration IDE (par exemple le noyau Jupyter lié au notebook actuellement ouvert). L'outil n'est présent que lorsque Claude Code fonctionne aux côtés d'un pont IDE compatible tel que l'extension VS Code avec un noyau Jupyter sélectionné.
 
-Exécute du code Python dans le kernel Jupyter du fichier notebook actuel.
+## Quand l'utiliser
+
+- Exécuter un calcul rapide, une inspection de données ou un tracé sur l'état déjà chargé dans un noyau Jupyter actif.
+- Valider un extrait de code avant de le coller dans une cellule de notebook.
+- Explorer un dataframe, une variable ou un modèle en mémoire qui existe dans le noyau mais n'est pas sérialisé sur disque.
+- Produire un graphique ou un résultat numérique que l'utilisateur veut voir rendu inline dans l'IDE.
+
+N'utilisez PAS pour des scripts autonomes qui seraient mieux servis par `Bash` exécutant `python script.py`, ou pour du code qui doit persister à travers un noyau neuf.
 
 ## Paramètres
 
-| Paramètre | Type | Requis | Description |
-|-----------|------|--------|-------------|
-| `code` | string | Oui | Code Python à exécuter |
+- `code` (string, requis) : le code à exécuter dans le noyau courant. S'exécute comme s'il était collé dans une cellule de notebook — les variables définies persistent dans le noyau jusqu'à son redémarrage.
+- `language` (string, optionnel) : le langage de l'extrait lorsque le pont IDE prend en charge plusieurs noyaux. Le plus souvent omis ; par défaut le langage du noyau actif (généralement Python).
+
+## Exemples
+
+### Exemple 1 : inspecter un dataframe en mémoire
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+Renvoie les premières lignes, la forme et les dtypes de colonnes d'un dataframe déjà chargé dans le noyau.
 
-## Cas d'utilisation
+### Exemple 2 : vérification numérique rapide
 
-**Adapté pour :**
-- Exécuter du code dans un environnement Jupyter notebook
-- Tester des extraits de code
-- Analyse de données et calculs
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-**Non adapté pour :**
-- Exécution de code hors environnement Jupyter — utiliser Bash
-- Modifier des fichiers — utiliser Edit ou Write
+Effectue un calcul ponctuel sans créer de cellule de notebook.
 
 ## Notes
 
-- C'est un outil MCP (Model Context Protocol), fourni par l'intégration IDE
-- Le code s'exécute dans le kernel Jupyter actuel, l'état persiste entre les appels
-- Sauf demande explicite de l'utilisateur, éviter de déclarer des variables ou de modifier l'état du kernel
-- L'état est perdu au redémarrage du kernel
-
-## Texte original
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` est un outil de pont IDE. Il est indisponible dans les sessions de terminal classiques de Claude Code ; il n'apparaît que lorsque la session est connectée à un IDE qui expose un noyau (par exemple l'extension Jupyter de VS Code).
+- L'état persiste dans le noyau. Les variables définies par un appel `executeCode` restent visibles pour les appels ultérieurs, les cellules de notebook et l'utilisateur — attention aux effets de bord.
+- Le code de longue durée ou bloquant bloquera le noyau. Gardez les extraits courts ; pour un travail de plusieurs minutes, écrivez un véritable script et exécutez-le via `Bash`.
+- La sortie (sortie standard, valeurs de retour, images) est renvoyée à la session. Les très grandes sorties peuvent être tronquées par le pont IDE.
+- Pour les modifications de fichiers, préférez `Edit`, `Write` ou `NotebookEdit` — `executeCode` n'est pas un substitut à la création de fichiers source.

package/concepts/fr/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## Définition
+Récupère les diagnostics (erreurs, avertissements, indices) du serveur de langage depuis l'IDE connecté pour un fichier spécifique ou pour tous les fichiers que l'IDE a actuellement ouverts. Utilisé pour vérifier que les modifications de code compilent proprement avant de déclarer une tâche terminée.
 
-Obtient les informations de diagnostic du langage depuis VS Code, incluant les erreurs de syntaxe, erreurs de type, avertissements de lint, etc.
+## Quand l'utiliser
+
+- Après un `Edit` ou un `Write` pour confirmer que le changement n'a pas introduit d'erreur de type, d'erreur de syntaxe ou d'avertissement de lint.
+- Avant de terminer une tâche pour balayer chaque fichier ouvert à la recherche de problèmes non résolus.
+- Lors du diagnostic d'une erreur signalée par l'utilisateur — récupérer le message exact du compilateur ou du vérificateur de types de l'IDE évite de deviner.
+- Comme alternative légère à l'exécution d'un build complet ou d'une commande de test lorsque vous n'avez besoin que de vérifier la correction statique.
+
+Ne comptez PAS sur `getDiagnostics` comme remplacement de la suite de tests. Il rapporte ce que le serveur de langage voit, pas ce qui s'exécute en test ou en production.
 
 ## Paramètres
 
-| Paramètre | Type | Requis | Description |
-|-----------|------|--------|-------------|
-| `uri` | string | Non | URI du fichier. Si non fourni, obtient les informations de diagnostic de tous les fichiers |
+- `uri` (string, optionnel) : l'URI du fichier (typiquement `file:///absolute/path`) dont récupérer les diagnostics. Lorsqu'omis, l'outil renvoie les diagnostics pour chaque fichier que l'IDE a actuellement ouvert.
 
-## Cas d'utilisation
+## Exemples
 
-**Adapté pour :**
-- Vérifier les problèmes sémantiques de syntaxe, types, lint, etc. du code
-- Vérifier si de nouvelles erreurs ont été introduites après l'édition du code
-- Remplacer les commandes Bash pour vérifier la qualité du code
+### Exemple 1 : vérifier un seul fichier après édition
 
-**Non adapté pour :**
-- Exécuter des tests — utiliser Bash
-- Vérifier les erreurs d'exécution — utiliser Bash pour exécuter le code
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## Notes
+Renvoie toute erreur TypeScript, avertissement ESLint ou autre message de serveur de langage pour `src/auth.ts`.
 
-- C'est un outil MCP (Model Context Protocol), fourni par l'intégration IDE
-- Disponible uniquement dans les environnements VS Code / IDE
-- Préférer cet outil aux commandes Bash pour vérifier les problèmes de code
+### Exemple 2 : balayer tous les fichiers ouverts
 
-## Texte original
+```
+getDiagnostics()
+```
+
+Renvoie les diagnostics sur chaque éditeur actuellement ouvert. Utile à la fin d'un refactoring multi-fichiers pour s'assurer que rien n'a régressé ailleurs.
+
+## Notes
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` est un outil de pont IDE. Il n'est disponible que lorsque Claude Code est connecté à une intégration IDE compatible (par exemple l'extension VS Code). Dans une session de terminal classique, l'outil n'apparaîtra pas.
+- Les résultats reflètent les serveurs de langage que l'IDE a chargés — TypeScript, Pyright, ESLint, rust-analyzer, etc. La qualité et la couverture dépendent de la configuration de l'IDE de l'utilisateur, pas de Claude Code.
+- Les diagnostics sont en direct. Après une modification, laissez au serveur de langage un moment pour réanalyser avant d'interpréter un résultat vide comme un succès — relancez si le fichier vient d'être enregistré.
+- Les niveaux de sévérité incluent typiquement `error`, `warning`, `information` et `hint`. Concentrez-vous d'abord sur `error` ; les avertissements peuvent être du style de projet intentionnel.
+- Pour les fichiers non ouverts dans l'IDE, le serveur de langage peut n'avoir aucun diagnostic à rapporter même si le fichier contient de vrais problèmes. Ouvrez le fichier ou exécutez le build pour une couverture faisant autorité.

package/concepts/fr/Tools.md

@@ -8,7 +8,7 @@ Voici l'index classifié de tous les outils.
 
 | Outil | Utilité |
 |-------|---------|
-| [Task](Tool-Task.md) | Lancer un sous-agent (SubAgent) pour gérer des tâches complexes multi-étapes |
+| [Agent](Tool-Agent.md) | Lancer un sous-agent (SubAgent) pour gérer des tâches complexes multi-étapes |
 | [TaskOutput](Tool-TaskOutput.md) | Obtenir la sortie des tâches en arrière-plan |
 | [TaskStop](Tool-TaskStop.md) | Arrêter une tâche en arrière-plan en cours d'exécution |
 | [TaskCreate](Tool-TaskCreate.md) | Créer une entrée dans la liste de tâches structurée |

package/concepts/it/SubAgent-Search.md

@@ -1,20 +1,52 @@
 # SubAgent: Search
 
-## Definizione
+## Scopo
 
-Search è un tipo di sotto-agente avviato dall'agente principale di Claude Code per eseguire ricerche nel codice sorgente. Esegue ricerche mirate di file e contenuto utilizzando strumenti come Glob, Grep e Read, quindi restituisce i risultati all'agente padre.
+Il subagente Search è un agente di esplorazione leggero e in sola lettura. Invialo quando hai bisogno di comprendere un codebase — trovare dove vive qualcosa, imparare come i componenti si incastrano o rispondere a domande strutturali — senza cambiare alcun file. È ottimizzato per molte piccole letture su molti file, restituendo un riepilogo conciso piuttosto che output di ricerca grezzi.
 
-## Comportamento
+Search non è un assistente general-purpose. Non può modificare codice, eseguire build, committare modifiche o aprire connessioni di rete oltre fetch in sola lettura. Il suo valore è che può bruciare un grande budget di esplorazione in parallelo senza consumare il contesto dell'agente principale, e poi restituire una risposta compatta.
 
-- Avviato automaticamente quando l'agente principale deve cercare o esplorare il codice sorgente
-- Viene eseguito in un contesto isolato con accesso in sola lettura
-- Usa Glob per la corrispondenza di pattern di file, Grep per la ricerca di contenuto e Read per l'ispezione di file
-- Restituisce i risultati della ricerca all'agente padre per ulteriore elaborazione
+## Quando usare
 
-## Quando appare
+- Devi rispondere a una domanda che richiede tre o più ricerche o letture distinte. Esempio: "How is authentication wired from the login route down to the session store?"
+- Il target è sconosciuto — non sai ancora quale file, modulo o simbolo guardare.
+- Hai bisogno di una panoramica strutturale di un'area sconosciuta del repo prima di fare modifiche.
+- Vuoi fare riferimento incrociato a più candidati (ad esempio, quale di diversi helper nominati in modo simile è effettivamente chiamato in produzione).
+- Hai bisogno di un riepilogo in stile letterario: "list every place that imports X and categorise by call site."
 
-I sotto-agenti Search appaiono tipicamente quando:
+Non usare Search quando:
 
-1. L'agente principale deve trovare file, funzioni o pattern di codice specifici
-2. L'utente richiede un'esplorazione ampia del codice sorgente
-3. L'agente sta esaminando dipendenze, riferimenti o pattern di utilizzo
+- Conosci già il file e la riga esatti. Chiama direttamente `Read`.
+- Un singolo `Grep` o `Glob` risponderà alla domanda. Eseguilo direttamente; inviare un subagente aggiunge overhead.
+- Il compito richiede editing, esecuzione di comandi o qualsiasi effetto collaterale. Search è in sola lettura per design.
+- Hai bisogno dell'output verbatim esatto di una chiamata tool. I subagenti riassumono; non fanno da proxy per risultati grezzi.
+
+## Livelli di accuratezza
+
+Scegli il livello che corrisponde all'importanza della domanda.
+
+- `quick` — alcune ricerche mirate, risposta best-effort. Usa quando hai bisogno di un puntatore rapido (ad esempio, "where is the env-var parsing logic?") e sei a tuo agio a iterare se la risposta è incompleta.
+- `medium` — il default. Diversi cicli di ricerca, verifica incrociata dei candidati e lettura completa dei file più rilevanti. Usa per domande tipiche "help me understand this area".
+- `very thorough` — esplorazione esaustiva. Il subagente inseguirà ogni traccia plausibile, leggerà il contesto circostante e ricontrollerà i risultati prima di riassumere. Usa quando la correttezza è importante (ad esempio, security review, pianificazione di migrazione) o quando una risposta incompleta causerà rilavoro.
+
+Un'accuratezza più alta costa più tempo e token all'interno del subagente, ma quei token restano all'interno del subagente — solo il riepilogo finale ritorna all'agente principale.
+
+## Tool disponibili
+
+Search ha accesso a tutti i tool in sola lettura che l'agente principale usa, e nient'altro:
+
+- `Read` — per leggere file specifici, inclusi intervalli parziali.
+- `Grep` — per ricerche di contenuto attraverso l'albero.
+- `Glob` — per localizzare file per pattern di nome.
+- `Bash` in modalità sola lettura — per comandi che ispezionano lo stato senza mutarlo (ad esempio `git log`, `git show`, `ls`, `wc`).
+- `WebFetch` e `WebSearch` — per leggere documentazione esterna quando quel contesto è richiesto.
+
+Tool di editing (`Write`, `Edit`, `NotebookEdit`), comandi shell che modificano stato e tool di task-graph (`TaskCreate`, `TaskUpdate` e così via) sono deliberatamente non disponibili.
+
+## Note
+
+- Dai al subagente Search una domanda specifica, non un argomento. "List every caller of `renderMessage` and note which ones pass a custom theme" restituisce una risposta utile; "tell me about rendering" no.
+- Il subagente restituisce un riepilogo. Se hai bisogno di percorsi di file esatti, richiedili esplicitamente nel tuo prompt.
+- Più domande indipendenti sono meglio inviate come subagenti Search paralleli piuttosto che un lungo prompt, così che ciascuna possa concentrarsi.
+- Poiché Search non può editare, abbinalo a un passo di edit di follow-up nell'agente principale una volta che sai cosa cambiare.
+- Tratta l'output di Search come evidenza, non verità assoluta. Per qualsiasi cosa di carico portante, apri tu stesso i file citati prima di agire.