cc-viewer 1.2.0 → 1.2.2

package/concepts/es/CacheRebuild.md

@@ -0,0 +1,40 @@
+# Cache Rebuild (Reconstrucción de caché)
+
+## Contexto
+
+El mecanismo de prompt caching de Anthropic concatena secuencialmente system → tools → messages (hasta el cache breakpoint) de la solicitud para formar la clave de caché. Cuando la clave de caché coincide exactamente con la solicitud anterior, la API devuelve `cache_read_input_tokens` (acierto de caché); cuando la clave de caché cambia, la API recrea la caché y devuelve una gran cantidad de `cache_creation_input_tokens`, es decir, una reconstrucción de caché.
+
+La reconstrucción de caché implica facturación adicional de tokens (el precio de cache creation es mayor que el de cache read), por lo que identificar la causa de la reconstrucción tiene valor directo para la optimización de costos.
+
+## Clasificación de causas de reconstrucción de caché
+
+cc-viewer compara los cuerpos de dos solicitudes MainAgent consecutivas para determinar con precisión la causa de la reconstrucción de caché:
+
+| reason | Significado | Método de determinación |
+|--------|-------------|------------------------|
+| `ttl` | Caché expirada | Han pasado más de 5 minutos desde la última solicitud MainAgent |
+| `system_change` | Cambio en el system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Cambio en las definiciones de herramientas | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Cambio de modelo | `prev.model !== curr.model` |
+| `msg_truncated` | Pila de mensajes truncada | La solicitud actual tiene menos mensajes que la anterior, generalmente por truncamiento al desbordar la ventana de contexto |
+| `msg_modified` | Mensajes históricos modificados | El contenido de los mensajes prefijo no coincide (en adición normal, el prefijo debería ser idéntico) |
+| `key_change` | Cambio de clave desconocido | Fallback cuando ninguna de las condiciones anteriores coincide |
+
+## Prioridad de determinación
+
+1. Primero se verifica el intervalo de tiempo — si supera los 5 minutos, se determina directamente como `ttl`, sin comparar el body
+2. Luego se verifican secuencialmente model, system, tools, messages
+3. Una solicitud puede coincidir con múltiples causas simultáneamente (por ejemplo, cambio de modelo + cambio de system prompt), en cuyo caso el array `reasons` contiene todos los elementos coincidentes y el tooltip los muestra en líneas separadas
+
+## Escenarios comunes
+
+- **`ttl`**: El usuario pausó la operación por más de 5 minutos y luego continuó, la caché expiró naturalmente
+- **`system_change`**: Claude Code actualizó el system prompt (por ejemplo, cargó un nuevo CLAUDE.md, cambios en project instructions)
+- **`tools_change`**: La conexión/desconexión de un MCP server causó cambios en la lista de herramientas disponibles
+- **`model_change`**: El usuario cambió de modelo mediante el comando `/model`
+- **`msg_truncated`**: Una conversación larga activó la gestión de la ventana de contexto, Claude Code truncó los mensajes anteriores
+- **`msg_modified`**: Claude Code editó mensajes históricos (por ejemplo, `/compact` reemplazó mensajes originales con resúmenes comprimidos)
+
+## Visualización en cc-viewer
+
+En la lista de solicitudes, las solicitudes con reconstrucción de caché muestran un indicador de punto rojo en la línea de cache. Al pasar el ratón se muestra un tooltip con la descripción específica de la causa de reconstrucción (soporta 18 idiomas).

package/concepts/es/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Definición
+
+MainAgent es la cadena de solicitudes principal de Claude Code en estado no agent team. Cada interacción del usuario con Claude Code produce una serie de solicitudes API, donde las solicitudes MainAgent constituyen la cadena de conversación central — llevan el system prompt completo, las definiciones de herramientas y el historial de mensajes.
+
+## Método de identificación
+
+En cc-viewer, MainAgent se identifica mediante `req.mainAgent === true`, marcado automáticamente por `interceptor.js` durante la captura de la solicitud.
+
+Condiciones de determinación (deben cumplirse todas):
+- El cuerpo de la solicitud contiene el campo `system` (system prompt)
+- El cuerpo de la solicitud contiene el array `tools` (definiciones de herramientas)
+- El system prompt contiene texto característico de "Claude Code"
+
+## Diferencias con SubAgent
+
+| Característica | MainAgent | SubAgent |
+|----------------|-----------|----------|
+| system prompt | Prompt principal completo de Claude Code | Prompt simplificado específico para la tarea |
+| Array tools | Contiene todas las herramientas disponibles | Generalmente solo contiene las pocas herramientas necesarias para la tarea |
+| Historial de mensajes | Acumula el contexto completo de la conversación | Solo contiene mensajes relacionados con la subtarea |
+| Comportamiento de caché | Tiene prompt caching (TTL de 5 minutos) | Generalmente sin caché o con caché pequeña |
+
+## Significado en cc-viewer
+
+- **Seguimiento de caché**: El estado de prompt caching de las solicitudes MainAgent afecta directamente los costos. Monitoreando la proporción entre `cache_creation_input_tokens` y `cache_read_input_tokens`, se puede determinar la tasa de aciertos de caché
+- **Análisis de pérdida de caché**: Cuando las solicitudes MainAgent muestran una gran cantidad de cache creation (en lugar de cache read), indica que la caché se perdió y fue reconstruida; cc-viewer marca estas solicitudes con un indicador de punto rojo
+- **Análisis de la cadena principal**: La secuencia de solicitudes MainAgent refleja el proceso completo de interacción del usuario con Claude Code, siendo los datos centrales para el análisis del comportamiento de la sesión
+- **Reconstrucción de sesión**: cc-viewer reconstruye la vista de conversación (Chat Mode) a través del historial de mensajes de las solicitudes MainAgent

package/concepts/es/Tool-AskUserQuestion.md

@@ -0,0 +1,54 @@
+# AskUserQuestion
+
+## Definición
+
+Hace preguntas al usuario durante la ejecución para obtener aclaraciones, verificar suposiciones o solicitar decisiones.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `questions` | array | Sí | Lista de preguntas (1-4 preguntas) |
+| `answers` | object | No | Respuestas recopiladas del usuario |
+| `annotations` | object | No | Anotaciones para cada pregunta (como notas de vista previa de selección) |
+| `metadata` | object | No | Metadatos para seguimiento y análisis |
+
+Cada objeto `question`:
+
+| Campo | Tipo | Requerido | Descripción |
+|-------|------|-----------|-------------|
+| `question` | string | Sí | Texto completo de la pregunta, debe terminar con signo de interrogación |
+| `header` | string | Sí | Etiqueta corta (máximo 12 caracteres), se muestra como chip de etiqueta |
+| `options` | array | Sí | 2-4 opciones |
+| `multiSelect` | boolean | Sí | Si se permite selección múltiple |
+
+Cada objeto `option`:
+
+| Campo | Tipo | Requerido | Descripción |
+|-------|------|-----------|-------------|
+| `label` | string | Sí | Texto de visualización de la opción (1-5 palabras) |
+| `description` | string | Sí | Descripción de la opción |
+| `markdown` | string | No | Contenido de vista previa (para comparación visual de diseños ASCII, fragmentos de código, etc.) |
+
+## Casos de uso
+
+**Adecuado para:**
+- Recopilar preferencias o requisitos del usuario
+- Aclarar instrucciones ambiguas
+- Obtener decisiones durante la implementación
+- Ofrecer opciones de dirección al usuario
+
+**No adecuado para:**
+- Preguntar "¿está bien el plan?" — se debe usar ExitPlanMode
+
+## Notas
+
+- El usuario siempre puede seleccionar "Other" para proporcionar una entrada personalizada
+- La opción recomendada se coloca en primer lugar, con "(Recommended)" al final del label
+- La vista previa `markdown` solo es compatible con preguntas de selección única
+- Las opciones con `markdown` cambian a un diseño lado a lado
+- En modo de planificación, se usa para aclarar requisitos antes de definir el plan
+
+## Significado en cc-viewer
+
+Las llamadas a AskUserQuestion aparecen en el registro de solicitudes como content blocks `tool_use`, conteniendo las definiciones de preguntas y opciones. Las respuestas del usuario aparecen en el historial de mensajes de solicitudes posteriores.

package/concepts/es/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## Definición
+
+Ejecuta comandos shell con configuración de tiempo de espera opcional. El directorio de trabajo persiste entre comandos, pero el estado del shell (variables de entorno, etc.) no persiste.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `command` | string | Sí | Comando bash a ejecutar |
+| `description` | string | No | Descripción breve del comando |
+| `timeout` | number | No | Tiempo de espera (milisegundos), máximo 600000, por defecto 120000 |
+| `run_in_background` | boolean | No | Si se ejecuta en segundo plano |
+
+## Casos de uso
+
+**Adecuado para:**
+- Operaciones git (commit, push, branch, etc.)
+- Comandos de gestión de paquetes npm/yarn
+- Operaciones docker
+- Comandos de compilación y construcción
+- Listar contenido de directorios (`ls`)
+- Otros comandos del sistema que requieren ejecución en shell
+
+**No adecuado para:**
+- Leer archivos — usar Read
+- Buscar nombres de archivos — usar Glob
+- Buscar contenido de archivos — usar Grep
+- Editar archivos — usar Edit
+- Escribir archivos — usar Write
+- Mostrar información al usuario — mostrar directamente en el texto de respuesta
+- Procesos de larga duración (dev server, modo watch) — recomendar al usuario ejecutar manualmente
+
+## Notas
+
+- Las rutas con espacios deben estar entre comillas dobles
+- La salida que exceda 30000 caracteres será truncada
+- Los comandos en segundo plano obtienen resultados mediante TaskOutput
+- Usar preferentemente rutas absolutas, evitar `cd`
+- Los comandos independientes pueden ejecutar múltiples Bash en paralelo
+- Los comandos con dependencias se encadenan con `&&`
+- El entorno shell se inicializa desde el profile del usuario (bash o zsh)
+
+## Significado en cc-viewer
+
+Las llamadas a Bash aparecen en el registro de solicitudes como pares de content blocks `tool_use` (conteniendo el comando) y `tool_result` (conteniendo la salida). La salida de la ejecución del comando puede usarse para analizar el comportamiento operativo del modelo.

package/concepts/es/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## Definición
+
+Edita archivos mediante reemplazo exacto de cadenas. Reemplaza `old_string` por `new_string` en el archivo.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `file_path` | string | Sí | Ruta absoluta del archivo a modificar |
+| `old_string` | string | Sí | Texto original a reemplazar |
+| `new_string` | string | Sí | Nuevo texto de reemplazo (debe ser diferente de old_string) |
+| `replace_all` | boolean | No | Si se reemplazan todas las coincidencias, por defecto `false` |
+
+## Casos de uso
+
+**Adecuado para:**
+- Modificar segmentos específicos de código en archivos existentes
+- Corregir bugs, actualizar lógica
+- Renombrar variables (con `replace_all: true`)
+- Cualquier escenario que requiera modificación precisa del contenido de un archivo
+
+**No adecuado para:**
+- Crear archivos nuevos — usar Write
+- Reescrituras a gran escala — puede requerir Write para sobrescribir el archivo completo
+
+## Notas
+
+- Se debe haber leído el archivo previamente con Read antes de usar, de lo contrario dará error
+- `old_string` debe ser único en el archivo, de lo contrario la edición falla. Si no es único, proporcionar más contexto para hacerlo único, o usar `replace_all`
+- Al editar texto se debe mantener la indentación original (tab/espacios), no incluir el prefijo de número de línea de la salida de Read
+- Preferir editar archivos existentes en lugar de crear nuevos
+- `new_string` debe ser diferente de `old_string`
+
+## Significado en cc-viewer
+
+Las llamadas a Edit aparecen en el registro de solicitudes como content blocks `tool_use`, cuyo `input` contiene `old_string` y `new_string`, lo que permite rastrear qué modificaciones hizo el modelo en los archivos.

package/concepts/es/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Definición
+
+Cambia Claude Code al modo de planificación, utilizado para explorar la base de código y diseñar un plan antes de la implementación.
+
+## Parámetros
+
+Sin parámetros.
+
+## Casos de uso
+
+**Adecuado para:**
+- Implementación de nuevas funcionalidades — requiere decisiones de arquitectura
+- Existen múltiples enfoques viables — requiere que el usuario elija
+- Las modificaciones de código afectan el comportamiento o la estructura existente
+- Cambios en múltiples archivos — posiblemente involucra 2-3 o más archivos
+- Requisitos poco claros — necesita explorar primero para entender el alcance
+- Las preferencias del usuario son importantes — la implementación puede tener múltiples direcciones razonables
+
+**No adecuado para:**
+- Correcciones de una línea o pocas líneas (errores tipográficos, bugs obvios)
+- El usuario ya dio instrucciones muy específicas
+- Tareas puramente de investigación/exploración — usar Task (tipo Explore)
+
+## Comportamiento en modo de planificación
+
+Después de entrar en modo de planificación, Claude Code:
+1. Usa las herramientas Glob, Grep, Read para explorar la base de código en profundidad
+2. Comprende los patrones y la arquitectura existentes
+3. Diseña un plan de implementación
+4. Envía el plan al usuario para aprobación
+5. Puede usar AskUserQuestion si necesita aclaraciones
+6. Sale mediante ExitPlanMode cuando el plan está listo
+
+## Notas
+
+- Esta herramienta requiere el consentimiento del usuario para entrar en modo de planificación
+- Si no está seguro de si se necesita planificación, es preferible planificar — alinear de antemano es mejor que rehacer
+
+## Significado en cc-viewer
+
+Las llamadas a EnterPlanMode aparecen en el registro de solicitudes como content blocks `tool_use`. Después de entrar en modo de planificación, la secuencia de solicitudes generalmente consiste principalmente en llamadas a herramientas exploratorias (Glob, Grep, Read), hasta que se llama a ExitPlanMode.

package/concepts/es/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Definición
+
+Sale del modo de planificación y envía el plan al usuario para su aprobación. El contenido del plan se lee del archivo de plan escrito previamente.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `allowedPrompts` | array | No | Lista de descripciones de permisos necesarios para implementar el plan |
+
+Cada elemento del array `allowedPrompts`:
+
+| Campo | Tipo | Requerido | Descripción |
+|-------|------|-----------|-------------|
+| `tool` | enum | Sí | Herramienta aplicable, actualmente solo soporta `Bash` |
+| `prompt` | string | Sí | Descripción semántica de la operación (como "run tests", "install dependencies") |
+
+## Casos de uso
+
+**Adecuado para:**
+- El plan está completo en modo de planificación, listo para enviar a aprobación del usuario
+- Solo para tareas de implementación que requieren escribir código
+
+**No adecuado para:**
+- Tareas puramente de investigación/exploración — no se necesita salir del modo de planificación
+- Querer preguntar al usuario "¿está bien el plan?" — esa es exactamente la función de esta herramienta, no usar AskUserQuestion para eso
+
+## Notas
+
+- Esta herramienta no acepta el contenido del plan como parámetro — lo lee del archivo de plan escrito previamente
+- El usuario verá el contenido del archivo de plan para aprobarlo
+- No usar AskUserQuestion para preguntar "¿está bien el plan?" antes de llamar a esta herramienta, es redundante
+- No mencionar "plan" en las preguntas, ya que el usuario no puede ver el contenido del plan antes de ExitPlanMode
+
+## Significado en cc-viewer
+
+La llamada a ExitPlanMode marca el final de la fase de planificación. En el registro de solicitudes, las solicitudes después de esta llamada generalmente se convierten en operaciones de implementación (Edit, Write, Bash, etc.).

package/concepts/es/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Definición
+
+Herramienta rápida de coincidencia de patrones de nombres de archivo, compatible con bases de código de cualquier tamaño. Devuelve rutas de archivos coincidentes ordenadas por tiempo de modificación.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `pattern` | string | Sí | Patrón glob (como `**/*.js`, `src/**/*.ts`) |
+| `path` | string | No | Directorio de búsqueda, por defecto el directorio de trabajo actual. No pasar "undefined" ni "null" |
+
+## Casos de uso
+
+**Adecuado para:**
+- Buscar archivos por patrón de nombre
+- Encontrar todos los archivos de un tipo específico (como todos los archivos `.tsx`)
+- Localizar archivos primero al buscar definiciones de clases específicas (como `class Foo`)
+- Se pueden lanzar múltiples llamadas Glob en paralelo en un solo mensaje
+
+**No adecuado para:**
+- Buscar contenido de archivos — usar Grep
+- Exploración abierta que requiere múltiples rondas de búsqueda — usar Task (tipo Explore)
+
+## Notas
+
+- Soporta sintaxis glob estándar: `*` coincide con un nivel, `**` coincide con múltiples niveles, `{}` coincide con múltiples opciones
+- Los resultados se ordenan por tiempo de modificación
+- Se recomienda más que el comando `find` de Bash
+
+## Significado en cc-viewer
+
+Las llamadas a Glob aparecen en el registro de solicitudes como pares de content blocks `tool_use` / `tool_result`. El `tool_result` contiene la lista de rutas de archivos coincidentes.

package/concepts/es/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Definición
+
+Potente herramienta de búsqueda de contenido basada en ripgrep. Soporta expresiones regulares, filtrado por tipo de archivo y múltiples modos de salida.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `pattern` | string | Sí | Patrón de búsqueda con expresión regular |
+| `path` | string | No | Ruta de búsqueda (archivo o directorio), por defecto el directorio de trabajo actual |
+| `glob` | string | No | Filtro de nombre de archivo (como `*.js`, `*.{ts,tsx}`) |
+| `type` | string | No | Filtro de tipo de archivo (como `js`, `py`, `rust`), más eficiente que glob |
+| `output_mode` | enum | No | Modo de salida: `files_with_matches` (por defecto), `content`, `count` |
+| `-i` | boolean | No | Búsqueda insensible a mayúsculas/minúsculas |
+| `-n` | boolean | No | Mostrar números de línea (solo modo content), por defecto true |
+| `-A` | number | No | Número de líneas a mostrar después de la coincidencia |
+| `-B` | number | No | Número de líneas a mostrar antes de la coincidencia |
+| `-C` / `context` | number | No | Número de líneas a mostrar antes y después de la coincidencia |
+| `head_limit` | number | No | Limitar el número de entradas de salida, por defecto 0 (ilimitado) |
+| `offset` | number | No | Omitir los primeros N resultados |
+| `multiline` | boolean | No | Habilitar modo de coincidencia multilínea, por defecto false |
+
+## Casos de uso
+
+**Adecuado para:**
+- Buscar cadenas o patrones específicos en la base de código
+- Encontrar ubicaciones de uso de funciones/variables
+- Filtrar resultados de búsqueda por tipo de archivo
+- Contar el número de coincidencias
+
+**No adecuado para:**
+- Buscar archivos por nombre — usar Glob
+- Exploración abierta que requiere múltiples rondas de búsqueda — usar Task (tipo Explore)
+
+## Notas
+
+- Usa sintaxis ripgrep (no grep), los caracteres especiales como llaves necesitan escape
+- El modo `files_with_matches` solo devuelve rutas de archivos, es el más eficiente
+- El modo `content` devuelve el contenido de las líneas coincidentes, soporta líneas de contexto
+- La coincidencia multilínea requiere establecer `multiline: true`
+- Siempre preferir usar la herramienta Grep en lugar de los comandos `grep` o `rg` en Bash
+
+## Significado en cc-viewer
+
+Las llamadas a Grep aparecen en el registro de solicitudes como pares de content blocks `tool_use` / `tool_result`. El `tool_result` contiene los resultados de búsqueda.

package/concepts/es/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Definición
+
+Reemplaza, inserta o elimina celdas específicas en un Jupyter notebook (archivo .ipynb).
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `notebook_path` | string | Sí | Ruta absoluta del archivo notebook |
+| `new_source` | string | Sí | Nuevo contenido de la celda |
+| `cell_id` | string | No | ID de la celda a editar. En modo inserción, la nueva celda se inserta después de este ID |
+| `cell_type` | enum | No | Tipo de celda: `code` o `markdown`. Requerido en modo inserción |
+| `edit_mode` | enum | No | Modo de edición: `replace` (por defecto), `insert`, `delete` |
+
+## Casos de uso
+
+**Adecuado para:**
+- Modificar celdas de código o markdown en Jupyter notebooks
+- Agregar nuevas celdas a un notebook
+- Eliminar celdas de un notebook
+
+## Notas
+
+- `cell_number` tiene índice base 0
+- El modo `insert` inserta una nueva celda en la posición especificada
+- El modo `delete` elimina la celda en la posición especificada
+- La ruta debe ser absoluta
+
+## Significado en cc-viewer
+
+Las llamadas a NotebookEdit aparecen en el registro de solicitudes como content blocks `tool_use`, registrando las operaciones específicas de modificación del notebook.

package/concepts/es/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Definición
+
+Lee el contenido de archivos del sistema de archivos local. Soporta archivos de texto, imágenes, PDF y Jupyter notebook.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `file_path` | string | Sí | Ruta absoluta del archivo |
+| `offset` | number | No | Número de línea inicial (para lectura segmentada de archivos grandes) |
+| `limit` | number | No | Número de líneas a leer (para lectura segmentada de archivos grandes) |
+| `pages` | string | No | Rango de páginas PDF (como "1-5", "3", "10-20"), solo aplicable a PDF |
+
+## Casos de uso
+
+**Adecuado para:**
+- Leer archivos de código, archivos de configuración y otros archivos de texto
+- Ver archivos de imagen (Claude es un modelo multimodal)
+- Leer documentos PDF
+- Leer Jupyter notebooks (devuelve todas las celdas y salidas)
+- Leer múltiples archivos en paralelo para obtener contexto
+
+**No adecuado para:**
+- Leer directorios — usar el comando `ls` de Bash
+- Exploración abierta de la base de código — usar Task (tipo Explore)
+
+## Notas
+
+- La ruta debe ser absoluta, no relativa
+- Por defecto lee las primeras 2000 líneas del archivo
+- Las líneas que excedan 2000 caracteres serán truncadas
+- La salida usa formato `cat -n`, los números de línea comienzan en 1
+- Los PDF grandes (más de 10 páginas) deben especificar el parámetro `pages`, máximo 20 páginas por vez
+- Leer un archivo inexistente devuelve un error (no se bloquea)
+- Se pueden hacer múltiples llamadas Read en paralelo en un solo mensaje
+
+## Significado en cc-viewer
+
+Las llamadas a Read aparecen en el registro de solicitudes como pares de content blocks `tool_use` (llamada) y `tool_result` (contenido devuelto). El `tool_result` contiene el contenido real del archivo, lo que permite analizar qué archivos leyó el modelo.

package/concepts/es/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Definición
+
+Ejecuta una habilidad (skill) en la conversación principal. Las habilidades son capacidades especializadas que el usuario puede invocar mediante slash commands (como `/commit`, `/review-pr`).
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `skill` | string | Sí | Nombre de la habilidad (como "commit", "review-pr", "pdf") |
+| `args` | string | No | Argumentos de la habilidad |
+
+## Casos de uso
+
+**Adecuado para:**
+- El usuario ingresó un slash command en formato `/<skill-name>`
+- La solicitud del usuario coincide con la funcionalidad de una habilidad registrada
+
+**No adecuado para:**
+- Comandos CLI integrados (como `/help`, `/clear`)
+- Una habilidad que ya está en ejecución
+- Nombres de habilidades que no están en la lista de habilidades disponibles
+
+## Notas
+
+- Después de ser invocada, la habilidad se expande en un prompt completo
+- Soporta nombres completamente calificados (como `ms-office-suite:pdf`)
+- La lista de habilidades disponibles se proporciona en los mensajes system-reminder
+- Cuando se ve una etiqueta `<command-name>`, significa que la habilidad ya está cargada y se debe ejecutar directamente en lugar de llamar a esta herramienta nuevamente
+- No mencionar una habilidad sin haber llamado realmente a la herramienta
+
+## Significado en cc-viewer
+
+Las llamadas a Skill aparecen en el registro de solicitudes como content blocks `tool_use`. El prompt expandido de la habilidad afecta el system prompt o el contenido de los mensajes de solicitudes posteriores.

package/concepts/es/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Definición
+
+Inicia un sub-agent (SubAgent) para manejar de forma autónoma tareas complejas de múltiples pasos. Los sub-agents son subprocesos independientes, cada uno con su propio conjunto de herramientas y contexto dedicados.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `prompt` | string | Sí | Descripción de la tarea a ejecutar por el sub-agent |
+| `description` | string | Sí | Resumen breve de 3-5 palabras |
+| `subagent_type` | string | Sí | Tipo de sub-agent, determina el conjunto de herramientas disponibles |
+| `model` | enum | No | Especificar modelo (sonnet / opus / haiku), por defecto hereda del padre |
+| `max_turns` | integer | No | Número máximo de turnos agénticos |
+| `run_in_background` | boolean | No | Si se ejecuta en segundo plano; las tareas en segundo plano devuelven la ruta del output_file |
+| `resume` | string | No | ID del agent a reanudar, continúa desde la última ejecución |
+| `isolation` | enum | No | Modo de aislamiento, `worktree` crea un git worktree temporal |
+
+## Tipos de sub-agent
+
+| Tipo | Propósito | Herramientas disponibles |
+|------|-----------|--------------------------|
+| `Bash` | Ejecución de comandos, operaciones git | Bash |
+| `general-purpose` | Tareas generales de múltiples pasos | Todas las herramientas |
+| `Explore` | Exploración rápida de la base de código | Todas las herramientas excepto Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Diseñar planes de implementación | Todas las herramientas excepto Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Preguntas y respuestas sobre la guía de uso de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Configurar la barra de estado | Read, Edit |
+
+## Casos de uso
+
+**Adecuado para:**
+- Tareas complejas que requieren completarse de forma autónoma en múltiples pasos
+- Exploración de la base de código e investigación profunda (usar tipo Explore)
+- Trabajo paralelo que necesita entornos aislados
+- Tareas de larga duración que necesitan ejecutarse en segundo plano
+
+**No adecuado para:**
+- Leer rutas de archivos específicas — usar directamente Read o Glob
+- Buscar en 2-3 archivos conocidos — usar directamente Read
+- Buscar definiciones de clases específicas — usar directamente Glob
+
+## Notas
+
+- El sub-agent devuelve un solo mensaje al completarse, sus resultados no son visibles para el usuario y el agent principal necesita transmitirlos
+- Se pueden lanzar múltiples llamadas Task en paralelo en un solo mensaje para mejorar la eficiencia
+- Las tareas en segundo plano verifican el progreso mediante la herramienta TaskOutput
+- El tipo Explore es más lento que llamar directamente a Glob/Grep, usar solo cuando la búsqueda simple no es suficiente
+
+## Significado en cc-viewer
+
+Las llamadas a Task producen cadenas de solicitudes SubAgent, visibles en la lista de solicitudes como secuencias de sub-solicitudes independientes del MainAgent. Las solicitudes SubAgent generalmente tienen un system prompt simplificado y menos definiciones de herramientas, formando un contraste claro con el MainAgent.

package/concepts/es/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Definición
+
+Crea entradas estructuradas en la lista de tareas para rastrear el progreso, organizar tareas complejas y mostrar el avance del trabajo al usuario.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `subject` | string | Sí | Título breve de la tarea, usar forma imperativa (como "Fix authentication bug") |
+| `description` | string | Sí | Descripción detallada, incluyendo contexto y criterios de aceptación |
+| `activeForm` | string | No | Texto en gerundio mostrado cuando está en progreso (como "Fixing authentication bug") |
+| `metadata` | object | No | Metadatos arbitrarios adjuntos a la tarea |
+
+## Casos de uso
+
+**Adecuado para:**
+- Tareas complejas de múltiples pasos (más de 3 pasos)
+- El usuario proporcionó múltiples elementos pendientes
+- Rastrear trabajo en modo de planificación
+- El usuario solicita explícitamente usar una lista de tareas
+
+**No adecuado para:**
+- Una sola tarea simple
+- Operaciones simples de 3 pasos o menos
+- Consultas puramente conversacionales o informativas
+
+## Notas
+
+- Todas las tareas nuevas tienen estado inicial `pending`
+- `subject` usa forma imperativa ("Run tests"), `activeForm` usa gerundio ("Running tests")
+- Después de crear la tarea, se pueden establecer relaciones de dependencia (blocks/blockedBy) mediante TaskUpdate
+- Antes de crear, se debe llamar a TaskList para verificar si hay tareas duplicadas
+
+## Significado en cc-viewer
+
+TaskCreate es una operación interna de gestión de tareas de Claude Code, no produce solicitudes API independientes. Sin embargo, en el Chat Mode se puede ver el bloque tool_use donde el modelo llama a esta herramienta.

package/concepts/es/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Definición
+
+Obtiene los detalles completos de una tarea mediante su ID.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `taskId` | string | Sí | ID de la tarea a obtener |
+
+## Contenido devuelto
+
+- `subject` — Título de la tarea
+- `description` — Requisitos detallados y contexto
+- `status` — Estado: `pending`, `in_progress` o `completed`
+- `blocks` — Lista de tareas bloqueadas por esta tarea
+- `blockedBy` — Lista de tareas previas que bloquean esta tarea
+
+## Casos de uso
+
+**Adecuado para:**
+- Obtener la descripción completa y el contexto de una tarea antes de comenzar a trabajar
+- Entender las relaciones de dependencia de una tarea
+- Obtener los requisitos completos después de ser asignado a una tarea
+
+## Notas
+
+- Después de obtener la tarea, se debe verificar si la lista `blockedBy` está vacía antes de comenzar a trabajar
+- Usar TaskList para ver la información resumida de todas las tareas
+
+## Significado en cc-viewer
+
+TaskGet es una operación interna de gestión de tareas, no produce solicitudes API independientes.

package/concepts/es/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Definición
+
+Lista todas las tareas en la lista de tareas para ver el progreso general y el trabajo disponible.
+
+## Parámetros
+
+Sin parámetros.
+
+## Contenido devuelto
+
+Información resumida de cada tarea:
+- `id` — Identificador de la tarea
+- `subject` — Descripción breve
+- `status` — Estado: `pending`, `in_progress` o `completed`
+- `owner` — Responsable (agent ID), vacío indica no asignado
+- `blockedBy` — Lista de IDs de tareas incompletas que bloquean esta tarea
+
+## Casos de uso
+
+**Adecuado para:**
+- Ver qué tareas están disponibles (estado pending, sin owner, no bloqueadas)
+- Verificar el progreso general del proyecto
+- Encontrar tareas bloqueadas
+- Buscar la siguiente tarea después de completar una
+
+## Notas
+
+- Preferir procesar tareas en orden de ID (ID más bajo primero), ya que las tareas anteriores generalmente proporcionan contexto para las posteriores
+- Las tareas con `blockedBy` no pueden ser reclamadas hasta que se resuelvan las dependencias
+- Usar TaskGet para obtener los detalles completos de una tarea específica
+
+## Significado en cc-viewer
+
+TaskList es una operación interna de gestión de tareas, no produce solicitudes API independientes.