cc-viewer 1.6.182 → 1.6.183

package/concepts/es/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## Definición
+Modifica una tarea existente — su estado, contenido, propiedad, metadatos o aristas de dependencia. Así es como las tareas progresan a través de su ciclo de vida y cómo se traspasa trabajo entre Claude Code, compañeros y subagentes.
 
-Actualiza el estado, contenido o relaciones de dependencia de una tarea en la lista de tareas.
+## Cuándo usar
+
+- Transicionar una tarea a través del flujo de estados mientras trabajas en ella.
+- Reclamar una tarea asignándote a ti mismo (u otro agente) como `owner`.
+- Refinar el `subject` o `description` una vez que aprendes más sobre el problema.
+- Registrar dependencias recién descubiertas con `addBlocks` / `addBlockedBy`.
+- Adjuntar `metadata` estructurada como IDs de tickets externos o pistas de prioridad.
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `taskId` | string | Sí | ID de la tarea a actualizar |
-| `status` | enum | No | Nuevo estado: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | No | Nuevo título |
-| `description` | string | No | Nueva descripción |
-| `activeForm` | string | No | Texto en gerundio mostrado cuando está en progreso |
-| `owner` | string | No | Nuevo responsable de la tarea (nombre del agent) |
-| `metadata` | object | No | Metadatos a fusionar (establecer como null para eliminar una clave) |
-| `addBlocks` | string[] | No | Lista de IDs de tareas bloqueadas por esta tarea |
-| `addBlockedBy` | string[] | No | Lista de IDs de tareas previas que bloquean esta tarea |
+- `taskId` (string, obligatorio): La tarea a modificar. Obtenlo de `TaskList` o `TaskCreate`.
+- `status` (string, opcional): Uno de `pending`, `in_progress`, `completed`, `deleted`.
+- `subject` (string, opcional): Título imperativo de reemplazo.
+- `description` (string, opcional): Descripción detallada de reemplazo.
+- `activeForm` (string, opcional): Texto del indicador en presente continuo de reemplazo.
+- `owner` (string, opcional): Handle del agente o compañero que asume la responsabilidad de la tarea.
+- `metadata` (object, opcional): Claves de metadatos a fusionar con la tarea. Establece una clave a `null` para eliminarla.
+- `addBlocks` (array de strings, opcional): IDs de tareas que esta tarea bloquea.
+- `addBlockedBy` (array de strings, opcional): IDs de tareas que deben completarse antes que esta.
 
 ## Flujo de estados
 
-```
-pending → in_progress → completed
-```
-
-`deleted` puede ser alcanzado desde cualquier estado, elimina permanentemente la tarea.
-
-## Casos de uso
-
-**Adecuado para:**
-- Marcar una tarea como `in_progress` al comenzar a trabajar
-- Marcar una tarea como `completed` al terminar el trabajo
-- Establecer relaciones de dependencia entre tareas
-- Actualizar el contenido de la tarea cuando cambian los requisitos
-
-**Reglas importantes:**
-- Solo marcar como `completed` cuando la tarea está completamente terminada
-- Mantener como `in_progress` cuando se encuentran errores o bloqueos
-- No marcar como `completed` cuando las pruebas fallan, la implementación es parcial o hay errores sin resolver
-
-## Notas
-
-- Antes de actualizar, se debe obtener el estado más reciente de la tarea mediante TaskGet para evitar datos obsoletos
-- Después de completar una tarea, llamar a TaskList para encontrar la siguiente tarea disponible
-
-## Texto original
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
+El ciclo de vida es deliberadamente lineal: `pending` → `in_progress` → `completed`. `deleted` es terminal y se usa para retirar tareas que nunca se trabajarán.
 
-**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
+- Establece `in_progress` en el momento en que realmente comienzas el trabajo, no antes. Solo una tarea a la vez debe estar `in_progress` para un propietario dado.
+- Establece `completed` solo cuando el trabajo esté completamente hecho — criterios de aceptación cumplidos, pruebas pasando, salida escrita. Si aparece un bloqueante, mantén la tarea en `in_progress` y añade una nueva tarea que describa lo que debe resolverse.
+- Nunca marques una tarea como `completed` cuando las pruebas están fallando, la implementación es parcial o te encuentras con errores sin resolver.
+- Usa `deleted` para tareas que están canceladas o duplicadas; no reutilices una tarea para trabajo no relacionado.
 
-- 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
+## Ejemplos
 
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+### Ejemplo 1
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+Reclamar una tarea y comenzarla.
 
-## Fields You Can Update
-
-- **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
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-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
+### Ejemplo 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+Terminar el trabajo y registrar una dependencia de seguimiento.
 
-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"}
-```
+## Notas
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` fusiona clave por clave; pasar `null` para una clave la elimina. Llama primero a `TaskGet` si no estás seguro del contenido actual.
+- `addBlocks` y `addBlockedBy` agregan aristas; no eliminan las existentes. Editar el grafo destructivamente requiere un flujo dedicado — consulta con el propietario del equipo antes de reescribir dependencias.
+- Mantén `activeForm` sincronizado cuando cambies `subject` para que el texto del indicador siga leyéndose con naturalidad.
+- No marques una tarea como `completed` para silenciarla. Si el usuario canceló el trabajo, usa `deleted` con una breve justificación en `description`.
+- Lee el último estado de una tarea con `TaskGet` antes de actualizar — los compañeros pueden haberla cambiado entre tu última lectura y tu escritura.

package/concepts/es/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Definición
+Establece un nuevo equipo de colaboración con una lista de tareas compartida y un canal de mensajería entre agentes. Un equipo es la primitiva de coordinación para trabajo multiagente — la sesión principal actúa como líder y genera compañeros con nombre mediante la herramienta `Agent`.
 
-Crea un nuevo equipo para coordinar múltiples agentes trabajando en un proyecto. Los equipos permiten la ejecución paralela de tareas mediante una lista de tareas compartida y mensajería entre agentes.
+## Cuándo usar
+
+- El usuario solicita explícitamente un equipo, enjambre, tripulación o colaboración multiagente.
+- Un proyecto tiene varios flujos de trabajo claramente independientes que se benefician de especialistas dedicados (p. ej. frontend, backend, pruebas, documentación).
+- Necesitas una lista de tareas compartida persistente que varios agentes actualicen a medida que avanzan.
+- Quieres compañeros con nombre y direccionables que puedan intercambiar mensajes vía `SendMessage` en lugar de llamadas de subagente de una sola vez.
+
+NO uses esto para una sola búsqueda delegada o una dispersión paralela puntual — las llamadas simples `Agent` son más ligeras y suficientes.
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `team_name` | string | Sí | Nombre para el nuevo equipo |
-| `description` | string | No | Descripción / propósito del equipo |
-| `agent_type` | string | No | Tipo / rol del líder del equipo |
+- `team_name` (string, obligatorio): Identificador único para el equipo. Se usa como nombre de directorio bajo `~/.claude/teams/` y como el argumento `team_name` al generar compañeros.
+- `description` (string, obligatorio): Declaración corta del objetivo del equipo. Se muestra a cada compañero al generarse y se escribe en la configuración del equipo.
+- `agent_type` (string, opcional): Persona de subagente por defecto aplicada a compañeros que no la sobrescriban. Valores típicos son `general-purpose`, `Explore` o `Plan`.
+
+## Ejemplos
+
+### Ejemplo 1: Crear un equipo de refactor
 
-## Qué crea
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **Archivo de configuración del equipo**: `~/.claude/teams/{team-name}/config.json` — almacena la lista de miembros y metadatos
-- **Directorio de lista de tareas**: `~/.claude/tasks/{team-name}/` — lista de tareas compartida para todos los compañeros de equipo
+Tras la creación, genera compañeros con `Agent` usando `team_name: "refactor-crew"` y valores `name` distintos como `db-lead`, `migrations` y `tests`.
 
-Los equipos tienen una correspondencia 1:1 con las listas de tareas.
+### Ejemplo 2: Crear un equipo de investigación
 
-## Flujo de trabajo del equipo
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — crear el equipo y su lista de tareas
-2. **TaskCreate** — definir tareas para el equipo
-3. **Agent** (con `team_name` + `name`) — generar compañeros de equipo que se unen al equipo
-4. **TaskUpdate** — asignar tareas a los compañeros mediante `owner`
-5. Los compañeros trabajan en las tareas y se comunican mediante **SendMessage**
-6. Detener a los compañeros al terminar, luego **TeamDelete** para limpiar
+Cada compañero generado hereda `Explore` como su persona por defecto, lo que coincide con la naturaleza investigativa de solo lectura del trabajo.
 
-## Herramientas relacionadas
+## Notas
 
-| Herramienta | Propósito |
-|-------------|-----------|
-| `TeamDelete` | Eliminar el equipo y los directorios de tareas |
-| `SendMessage` | Comunicación entre agentes dentro del equipo |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gestionar la lista de tareas compartida |
-| `Agent` | Generar compañeros de equipo que se unen al equipo |
+- Solo se puede liderar un equipo a la vez desde una sesión dada. Termina o elimina el equipo actual antes de crear otro.
+- Un equipo es 1:1 con una lista de tareas compartida. El líder posee la creación, asignación y cierre de tareas; los compañeros actualizan el estado de las tareas en las que están trabajando.
+- La configuración del equipo se persiste en `~/.claude/teams/{team_name}/config.json`, y el directorio de tareas vive junto a ella. Estos archivos sobreviven entre sesiones hasta que se eliminen explícitamente con `TeamDelete`.
+- Los compañeros se generan usando la herramienta `Agent` con un `team_name` coincidente más un `name` distinto. El `name` se convierte en la dirección usada por `SendMessage`.
+- Elige un `team_name` que sea seguro para el sistema de archivos (letras, dígitos, guiones, guiones bajos). Evita espacios o barras.
+- Escribe la `description` de modo que un compañero nuevo, leyéndola en frío, pueda entender el objetivo del equipo sin más contexto. Se convierte en parte del prompt de arranque de cada compañero.

package/concepts/es/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Definición
+Desmantela el equipo activo actual, eliminando su directorio de configuración y el directorio de tareas compartidas. Es la contraparte de limpieza de `TeamCreate` y típicamente se llama después de que el objetivo del equipo se haya logrado y todos los compañeros se hayan apagado.
 
-Elimina un equipo y sus directorios de tareas asociados cuando el trabajo de colaboración multi-agent ha concluido. Es la contrapartida de limpieza de TeamCreate.
+## Cuándo usar
 
-## Comportamiento
+- El equipo ha completado su trabajo y el informe final ha sido entregado al usuario.
+- El equipo se creó por error o su ámbito ha cambiado tan drásticamente que empezar de cero es más limpio que continuar.
+- Necesitas crear un nuevo equipo pero ya hay uno activo — elimina el viejo primero, ya que solo se puede liderar un equipo a la vez.
+- Un equipo se ha vuelto obsoleto a lo largo de sesiones y su estado persistido bajo `~/.claude/teams/` ya no es necesario.
 
-- Elimina el directorio del equipo: `~/.claude/teams/{team-name}/`
-- Elimina el directorio de tareas: `~/.claude/tasks/{team-name}/`
-- Limpia el contexto del equipo de la sesión actual
+NO llames mientras los compañeros sigan en ejecución — apágalos primero vía `SendMessage` con un `shutdown_request`, espera cada `shutdown_response` y luego elimina.
 
-**Importante**: TeamDelete fallará si el equipo todavía tiene miembros activos. Los compañeros de equipo deben cerrarse primero correctamente mediante solicitudes de apagado de SendMessage.
+## Parámetros
 
-## Uso típico
+`TeamDelete` no recibe parámetros en su invocación típica. Opera sobre el equipo activo actual propiedad de la sesión que llama.
 
-TeamDelete se llama al final de un flujo de trabajo de equipo:
+## Ejemplos
 
-1. Todas las tareas están completadas
-2. Los compañeros de equipo se cierran mediante `SendMessage` con `shutdown_request`
-3. **TeamDelete** elimina los directorios del equipo y de tareas
+### Ejemplo 1: Apagado rutinario tras el éxito
 
-## Herramientas relacionadas
+1. Haz broadcast de una solicitud de apagado al equipo:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Espera a que cada compañero responda con un `shutdown_response`.
+3. Llama a `TeamDelete()` para eliminar el directorio del equipo y el directorio de tareas.
 
-| Herramienta | Propósito |
-|-------------|-----------|
-| `TeamCreate` | Crear un nuevo equipo y su lista de tareas |
-| `SendMessage` | Comunicarse con los compañeros / enviar solicitudes de apagado |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gestionar la lista de tareas compartida |
-| `Agent` | Generar compañeros de equipo que se unen al equipo |
+### Ejemplo 2: Reemplazar un equipo mal configurado
+
+Si `TeamCreate` fue llamado con el `agent_type` o `description` equivocado, primero asegúrate de que no se hayan generado compañeros aún (o apágalos), luego:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Notas
+
+- `TeamDelete` falla si algún compañero sigue activo. La respuesta de error lista los compañeros vivos — envía a cada uno un `shutdown_request` vía `SendMessage`, espera su `shutdown_response` y reintenta.
+- La eliminación es irreversible desde la perspectiva de la herramienta. La configuración del equipo en `~/.claude/teams/{team_name}/config.json` y su directorio de tareas se eliminan del disco. Si necesitas preservar la lista de tareas, exporta o copia el directorio antes de eliminar.
+- Solo la sesión líder que creó el equipo puede eliminarlo. Un compañero generado no puede llamar a `TeamDelete` sobre su propio equipo.
+- Eliminar el equipo no revierte los cambios del sistema de archivos que los compañeros hicieron en el repositorio. Esos son ediciones ordinarias rastreadas por git y deben revertirse por separado si no se desean.
+- Tras el retorno exitoso de `TeamDelete`, la sesión es libre de llamar a `TeamCreate` nuevamente para un nuevo equipo.

package/concepts/es/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Definición
+Recupera el contenido de una página web pública, convierte el HTML a Markdown y ejecuta un modelo auxiliar pequeño sobre el resultado usando un prompt en lenguaje natural para extraer la información que necesitas.
 
-Obtiene el contenido de una página web de una URL especificada, convierte el HTML a markdown y procesa el contenido con un modelo de IA según el prompt.
+## Cuándo usar
+
+- Leer una página de documentación pública, un post de blog o un RFC referenciado en la conversación.
+- Extraer un dato específico, fragmento de código o tabla de una URL conocida sin cargar la página completa en el contexto.
+- Resumir notas de lanzamiento o changelogs de un recurso web abierto.
+- Consultar la referencia de API pública de una librería cuando la fuente no está en el repositorio local.
+- Seguir un enlace que el usuario pegó en el chat para responder una pregunta de seguimiento.
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `url` | string (URI) | Sí | URL completa a obtener |
-| `prompt` | string | Sí | Describe qué información extraer de la página |
+- `url` (string, obligatorio): Una URL absoluta completamente formada. El `http://` plano se actualiza automáticamente a `https://`.
+- `prompt` (string, obligatorio): La instrucción pasada al modelo de extracción pequeño. Describe exactamente qué extraer de la página, como "listar todas las funciones exportadas" o "devolver la versión mínima soportada de Node".
+
+## Ejemplos
+
+### Ejemplo 1: Extraer un valor por defecto de configuración
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+La herramienta obtiene la página de documentación de Vite, la convierte a Markdown y devuelve una respuesta corta como "El valor por defecto es `5173`; acepta solo un número."
 
-## Casos de uso
+### Ejemplo 2: Resumir una sección de changelog
 
-**Adecuado para:**
-- Obtener contenido de páginas web públicas
-- Consultar documentación en línea
-- Extraer información específica de páginas web
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**No adecuado para:**
-- URLs que requieren autenticación (Google Docs, Confluence, Jira, GitHub, etc.) — buscar primero herramientas MCP dedicadas
-- URLs de GitHub — preferir usar el CLI `gh`
+Útil cuando el usuario pregunta "¿qué cambió en Node 20.11?" y la página de lanzamiento es larga.
 
 ## Notas
 
-- La URL debe ser una URL válida completa
-- HTTP se actualiza automáticamente a HTTPS
-- Los resultados pueden ser resumidos si el contenido es demasiado grande
-- Incluye caché con auto-limpieza de 15 minutos
-- Cuando la URL redirige a un host diferente, la herramienta devuelve la URL de redirección y se necesita hacer una nueva solicitud con la nueva URL
-- Si hay una herramienta web fetch proporcionada por MCP disponible, preferir usar esa
-
-## Texto 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` falla en cualquier URL que requiera autenticación, cookies o VPN. Para Google Docs, Confluence, Jira, recursos privados de GitHub o wikis internas, usa un servidor MCP dedicado que proporcione acceso autenticado.
+- Para cualquier cosa alojada en GitHub (PRs, issues, blobs de archivo, respuestas de API), prefiere el CLI `gh` a través de `Bash` en lugar de hacer scraping de la UI web. `gh pr view`, `gh issue view` y `gh api` devuelven datos estructurados y funcionan contra repositorios privados.
+- Los resultados pueden ser resumidos cuando la página obtenida es muy grande. Si necesitas texto exacto, acota el `prompt` para pedir un extracto literal.
+- Se aplica una caché autolimpiante de 15 minutos por URL. Las llamadas repetidas a la misma página durante una sesión son casi instantáneas pero pueden devolver contenido ligeramente obsoleto. Si la frescura importa, menciónalo en el prompt o espera a que pase la caché.
+- Si el host objetivo emite una redirección entre hosts, la herramienta devuelve la nueva URL en un bloque de respuesta especial y no la sigue automáticamente. Vuelve a invocar `WebFetch` con la URL de destino de la redirección si aún quieres el contenido.
+- El prompt es ejecutado por un modelo más pequeño y rápido que el asistente principal. Mantenlo estrecho y concreto; el razonamiento complejo de varios pasos se maneja mejor leyendo el Markdown crudo tú mismo tras obtenerlo.
+- Nunca pases secretos, tokens o identificadores de sesión incrustados en la URL — el contenido de la página y las cadenas de consulta reflejadas en la salida pueden ser registradas por servicios upstream.

package/concepts/es/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Definición
+Realiza una búsqueda web en vivo y devuelve resultados clasificados que el asistente usa para fundamentar su respuesta en información actual más allá del corte de entrenamiento del modelo.
 
-Ejecuta consultas en motores de búsqueda y devuelve resultados de búsqueda para obtener información actualizada.
+## Cuándo usar
+
+- Responder preguntas sobre eventos actuales, lanzamientos recientes o noticias de última hora.
+- Buscar la última versión de una librería, framework o herramienta CLI.
+- Encontrar documentación o posts de blog cuando la URL exacta es desconocida.
+- Verificar un hecho que puede haber cambiado desde que el modelo fue entrenado.
+- Descubrir múltiples perspectivas sobre un tema antes de obtener cualquier página individual con `WebFetch`.
 
 ## Parámetros
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `query` | string | Sí | Consulta de búsqueda (mínimo 2 caracteres) |
-| `allowed_domains` | string[] | No | Solo incluir resultados de estos dominios |
-| `blocked_domains` | string[] | No | Excluir resultados de estos dominios |
+- `query` (string, obligatorio): La consulta de búsqueda. Longitud mínima 2 caracteres. Incluye el año actual cuando preguntes por información "última" o "reciente" para que los resultados estén frescos.
+- `allowed_domains` (array de strings, opcional): Restringe los resultados solo a estos dominios, por ejemplo `["nodejs.org", "developer.mozilla.org"]`. Útil cuando confías en una fuente específica.
+- `blocked_domains` (array de strings, opcional): Excluye resultados de estos dominios. No pases el mismo dominio a `allowed_domains` y `blocked_domains`.
+
+## Ejemplos
+
+### Ejemplo 1: Búsqueda de versión con año actual
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+Devuelve anuncios oficiales y evita sitios agregadores de baja calidad.
+
+### Ejemplo 2: Excluir fuentes ruidosas
 
-## Casos de uso
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**Adecuado para:**
-- Obtener información actualizada más allá de la fecha de corte del conocimiento del modelo
-- Buscar eventos actuales y datos recientes
-- Buscar la documentación técnica más reciente
+Mantiene los resultados enfocados en avisos de proveedores y rastreadores de seguridad.
 
 ## Notas
 
-- Los resultados de búsqueda se devuelven en formato de hipervínculos markdown
-- Después de usar, se debe incluir una sección "Sources:" al final de la respuesta, listando las URLs relevantes
-- Soporta filtrado de dominios (incluir/excluir)
-- Se debe usar el año actual en las consultas de búsqueda
-- Solo disponible en Estados Unidos
-
-## Texto 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>
+- Cuando uses `WebSearch` en una respuesta, debes adjuntar una sección `Sources:` al final de tu respuesta listando cada resultado citado como un hiperenlace Markdown con la forma `[Title](URL)`. Este es un requisito estricto, no opcional.
+- `WebSearch` solo está disponible para usuarios en los Estados Unidos. Si la herramienta no está disponible en tu región, recurre a `WebFetch` contra una URL conocida o pide al usuario que pegue contenido relevante.
+- Cada llamada realiza la búsqueda en un solo viaje de ida y vuelta — no puedes hacer streaming ni paginar. Refina la consulta si el primer conjunto de resultados es desviado.
+- La herramienta devuelve fragmentos y metadatos, no el contenido completo de la página. Para leer un resultado específico en profundidad, sigue con `WebFetch` usando la URL devuelta.
+- Usa `allowed_domains` para forzar fuentes autoritativas en preguntas sensibles a seguridad como CVEs o cumplimiento, y `blocked_domains` para cortar granjas de SEO que replican documentación.
+- Mantén las consultas cortas y basadas en palabras clave. Las preguntas en lenguaje natural funcionan pero tienden a devolver respuestas conversacionales en lugar de fuentes primarias.
+- No inventes URLs basadas en intuición de búsqueda — siempre ejecuta la búsqueda y cita lo que la herramienta realmente devolvió.

package/concepts/es/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Definición
+Crea un archivo nuevo o reemplaza completamente el contenido de uno existente en el sistema de archivos local. Como reemplaza todo en la ruta objetivo, debe reservarse para creación genuina o reescrituras completas intencionadas.
 
-Escribe contenido en el sistema de archivos local. Si el archivo ya existe, lo sobrescribe.
+## Cuándo usar
 
-## Parámetros
+- Crear un archivo fuente, prueba o configuración nuevos que aún no existen
+- Generar un fixture, snapshot o archivo de datos nuevo desde cero
+- Realizar una reescritura completa donde un `Edit` incremental sería más complejo que empezar de nuevo
+- Emitir un artefacto solicitado como un esquema, migración o script de compilación que el usuario pidió explícitamente producir
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| `file_path` | string | Sí | Ruta absoluta del archivo (debe ser ruta absoluta) |
-| `content` | string | Sí | Contenido a escribir |
+## Parámetros
 
-## Casos de uso
+- `file_path` (string, obligatorio): Ruta absoluta del archivo a escribir. Los directorios padre deben existir ya.
+- `content` (string, obligatorio): El texto completo a escribir en el archivo. Este se convierte en el cuerpo completo del archivo.
 
-**Adecuado para:**
-- Crear archivos nuevos
-- Cuando se necesita reescribir completamente el contenido de un archivo
+## Ejemplos
 
-**No adecuado para:**
-- Modificar contenido parcial de un archivo — usar Edit
-- No se deben crear proactivamente archivos de documentación (*.md) o README, a menos que el usuario lo solicite explícitamente
+### Ejemplo 1: Crear un módulo helper nuevo
+Llama a `Write` con `file_path: "/Users/me/app/src/utils/slugify.ts"` y proporciona la implementación como `content`. Usa esto solo después de verificar que el archivo no existe ya.
 
-## Notas
+### Ejemplo 2: Regenerar un artefacto derivado
+Tras cambiar la fuente del esquema, reescribe `/Users/me/app/generated/schema.json` en una sola llamada `Write` usando el JSON recién generado como `content`.
 
-- Si el archivo de destino ya existe, se debe leer primero con Read, de lo contrario fallará
-- Sobrescribe todo el contenido del archivo existente
-- Preferir usar Edit para editar archivos existentes, Write solo para crear archivos nuevos o reescrituras completas
+### Ejemplo 3: Reemplazar un archivo de fixture pequeño
+Para un fixture de prueba desechable donde cada línea cambia, `Write` puede ser más claro que una secuencia de llamadas `Edit`. Lee el archivo primero, confirma el ámbito y luego sobrescribe.
 
-## Texto original
-
-<textarea readonly>Writes a file to the local filesystem.
+## Notas
 
-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>
+- Antes de sobrescribir un archivo existente, debes llamar a `Read` sobre él en la sesión actual. `Write` se niega a aplastar contenido no visto.
+- Prefiere `Edit` para cualquier cambio que toque solo parte de un archivo. `Edit` envía solo el diff, lo cual es más rápido, más seguro y más fácil de revisar.
+- No crees proactivamente documentación Markdown, archivos `README.md` o changelogs a menos que el usuario los solicite explícitamente.
+- No añadas emojis, texto de marketing o banners decorativos a menos que el usuario pida ese estilo.
+- Verifica primero que el directorio padre existe con una llamada `ls` con `Bash`; `Write` no crea carpetas intermedias.
+- Proporciona el contenido exactamente como quieres que se persista; no hay plantillas ni postprocesado.