cx-viewer 1.0.0

package/concepts/es/Tool-ExitPlanMode.md

@@ -0,0 +1,62 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+
+## How This Tool Works
+- You should have already written your plan to the plan file specified in the plan mode system message
+- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
+- This tool simply signals that you're done planning and ready for the user to review and approve
+- The user will see the contents of your plan file when they review it
+
+## When to Use This Tool
+IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+
+## Before Using This Tool
+Ensure your plan is complete and unambiguous:
+- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
+- Once your plan is finalized, use THIS tool to request approval
+
+**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+
+## Examples
+
+1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
+2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
+3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
+</textarea>

package/concepts/es/Tool-Glob.md

@@ -0,0 +1,39 @@
+# 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
+
+## Texto original
+
+<textarea readonly>- Fast file pattern matching tool that works with any codebase size
+- Supports glob patterns like "**/*.js" or "src/**/*.ts"
+- Returns matching file paths sorted by modification time
+- Use this tool when you need to find files by name patterns
+- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
+- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>

package/concepts/es/Tool-Grep.md

@@ -0,0 +1,57 @@
+# 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
+
+## Texto original
+
+<textarea readonly>A powerful search tool built on ripgrep
+
+  Usage:
+  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
+  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
+  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
+  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
+  - Use Agent tool for open-ended searches requiring multiple rounds
+  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
+  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
+</textarea>

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
+
+## Texto original
+
+<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>

package/concepts/es/Tool-Read.md

@@ -0,0 +1,56 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
+Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
+
+Usage:
+- The file_path parameter must be an absolute path, not a relative path
+- By default, it reads up to 2000 lines starting from the beginning of the file
+- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
+- Any lines longer than 2000 characters will be truncated
+- Results are returned using cat -n format, with line numbers starting at 1
+- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
+- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
+- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
+- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
+- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
+- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
+- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>

package/concepts/es/Tool-SendMessage.md

@@ -0,0 +1,41 @@
+# SendMessage
+
+## Definición
+
+Envía mensajes entre agentes dentro de un equipo. Se utiliza para comunicación directa, difusión y mensajes de protocolo (solicitudes/respuestas de apagado, aprobación de planes).
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `to` | string | Sí | Destinatario: nombre del compañero, o `"*"` para difundir a todos |
+| `message` | string / object | Sí | Mensaje de texto o objeto de protocolo estructurado |
+| `summary` | string | No | Vista previa de 5-10 palabras mostrada en la interfaz |
+
+## Tipos de mensaje
+
+### Texto plano
+Mensajes directos entre compañeros de equipo para coordinación, actualizaciones de estado y discusiones sobre tareas.
+
+### Solicitud de apagado
+Solicita a un compañero que se apague de forma ordenada: `{ type: "shutdown_request", reason: "..." }`
+
+### Respuesta de apagado
+El compañero aprueba o rechaza el apagado: `{ type: "shutdown_response", approve: true/false }`
+
+### Respuesta de aprobación de plan
+Aprueba o rechaza el plan de un compañero: `{ type: "plan_approval_response", approve: true/false }`
+
+## Difusión vs. Directo
+
+- **Directo** (`to: "nombre-del-compañero"`): Enviar a un compañero específico — preferido para la mayoría de las comunicaciones
+- **Difusión** (`to: "*"`): Enviar a todos los compañeros — usar con moderación, solo para anuncios críticos a nivel de equipo
+
+## Herramientas relacionadas
+
+| Herramienta | Propósito |
+|-------------|-----------|
+| `TeamCreate` | Crear un nuevo equipo |
+| `TeamDelete` | Eliminar el equipo al finalizar |
+| `Agent` | Generar compañeros de equipo que se unen al equipo |
+| `TaskCreate` / `TaskUpdate` / `TaskList` | Gestionar la lista de tareas compartida |

package/concepts/es/Tool-Skill.md

@@ -0,0 +1,56 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+
+How to invoke:
+- Use this tool with the skill name and optional arguments
+- Examples:
+  - `skill: "pdf"` - invoke the pdf skill
+  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
+  - `skill: "review-pr", args: "123"` - invoke with arguments
+  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+
+Important:
+- Available skills are listed in system-reminder messages in the conversation
+- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
+- NEVER mention a skill without actually calling this tool
+- Do not invoke a skill that is already running
+- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
+- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
+</textarea>

package/concepts/es/Tool-Task.md

@@ -0,0 +1,51 @@
+# Task
+
+> **Nota:** En las versiones más recientes de Claude Code, esta herramienta ha sido renombrada a **Agent**. Consulte el documento [Tool-Agent](Tool-Agent).
+
+## 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

package/concepts/es/Tool-TaskCreate.md

@@ -0,0 +1,78 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
+It also helps the user understand the progress of the task and overall progress of their requests.
+
+## When to Use This Tool
+
+Use this tool proactively in these scenarios:
+
+- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
+- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
+- Plan mode - When using plan mode, create a task list to track the work
+- User explicitly requests todo list - When the user directly asks you to use the todo list
+- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
+- After receiving new instructions - Immediately capture user requirements as tasks
+- When you start working on a task - Mark it as in_progress BEFORE beginning work
+- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+
+## When NOT to Use This Tool
+
+Skip using this tool when:
+- There is only a single, straightforward task
+- The task is trivial and tracking it provides no organizational benefit
+- The task can be completed in less than 3 trivial steps
+- The task is purely conversational or informational
+
+NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+
+## Task Fields
+
+- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
+- **description**: Detailed description of what needs to be done, including context and acceptance criteria
+- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+
+**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+
+## Tips
+
+- Create tasks with clear, specific subjects that describe the outcome
+- Include enough detail in the description for another agent to understand and complete the task
+- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
+- Check TaskList first to avoid creating duplicate tasks
+</textarea>

package/concepts/es/Tool-TaskGet.md

@@ -0,0 +1,56 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- When you need the full description and context before starting work on a task
+- To understand task dependencies (what it blocks, what blocks it)
+- After being assigned a task, to get complete requirements
+
+## Output
+
+Returns full task details:
+- **subject**: Task title
+- **description**: Detailed requirements and context
+- **status**: 'pending', 'in_progress', or 'completed'
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.
+</textarea>

package/concepts/es/Tool-TaskList.md

@@ -0,0 +1,56 @@
+# 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
+
+## Texto original
+
+<textarea readonly>Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
+- To check overall progress on the project
+- To find tasks that are blocked and need dependencies resolved
+- After completing a task, to check for newly unblocked work or claim the next available task
+- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+
+## Output
+
+Returns a summary of each task:
+- **id**: Task identifier (use with TaskGet, TaskUpdate)
+- **subject**: Brief description of the task
+- **status**: 'pending', 'in_progress', or 'completed'
+- **owner**: Agent ID if assigned, empty if available
+- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+</textarea>

package/concepts/es/Tool-TaskOutput.md

@@ -0,0 +1,40 @@
+# TaskOutput
+
+## Definición
+
+Obtiene la salida de tareas en segundo plano en ejecución o completadas. Aplicable a shells en segundo plano, agents asíncronos y sesiones remotas.
+
+## Parámetros
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| `task_id` | string | Sí | ID de la tarea |
+| `block` | boolean | Sí | Si se bloquea esperando que la tarea termine, por defecto `true` |
+| `timeout` | number | Sí | Tiempo máximo de espera (milisegundos), por defecto 30000, máximo 600000 |
+
+## Casos de uso
+
+**Adecuado para:**
+- Verificar el progreso de agents en segundo plano iniciados mediante Task (`run_in_background: true`)
+- Obtener los resultados de ejecución de comandos Bash en segundo plano
+- Esperar a que una tarea asíncrona termine y obtener su salida
+
+**No adecuado para:**
+- Tareas en primer plano — las tareas en primer plano devuelven resultados directamente, no se necesita esta herramienta
+
+## Notas
+
+- `block: true` bloquea hasta que la tarea termine o se agote el tiempo
+- `block: false` se usa para verificación no bloqueante del estado actual
+- El ID de la tarea se puede encontrar mediante el comando `/tasks`
+- Aplicable a todos los tipos de tareas: shells en segundo plano, agents asíncronos, sesiones remotas
+
+## Texto original
+
+<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
+- Takes a task_id parameter identifying the task
+- Returns the task output along with status information
+- Use block=true (default) to wait for task completion
+- Use block=false for non-blocking check of current status
+- Task IDs can be found using the /tasks command
+- Works with all task types: background shells, async agents, and remote sessions</textarea>