# Cómo funciona Clarvis {#how-clarvis-works}

> Entiende los agentes, sesiones, planes y demás partes de una tarea en Clarvis.

## Empieza por el ciclo de trabajo {#start-with-the-operator-loop}

Clarvis te ayuda a trabajar en un proyecto desde el terminal. Elige agente, modelo y ajustes de seguridad y describe el resultado deseado. El agente puede inspeccionar archivos, usar herramientas, modificar código, delegar o preguntar. Tú marcas el objetivo y decides qué acciones puede realizar.

```text
workspace -> session -> run -> lead agent -> tools and sub-agents -> result
```

Un **espacio de trabajo** es la carpeta del proyecto sobre la que actúa Clarvis. Determina los archivos, la configuración local y el historial de sesiones disponibles.

Una **sesión** es la conversación duradera de ese espacio. Conserva el historial y el uso de varios turnos. `/sessions` abre las sesiones, `/export` guarda la conversación completa y `/clear` archiva la actual antes de crear otra.

Una **ejecución** es el trabajo activo que sigue a una tarea enviada. Mientras está en marcha, los mensajes nuevos la orientan en lugar de crear otra ejecución simultánea. `/status` muestra agente, modelo, estado, tokens y coste.

## Los agentes definen cómo se hace el trabajo {#agents-define-how-work-is-done}

Un perfil de agente define system prompt, modelo, esfuerzo de razonamiento, permisos, presupuesto y capacidad de delegar. Puedes sustituir todo el system prompt de cualquier agente integrado. Usa `/agent` para elegir el principal de la siguiente ejecución o `/settings/agents` para editar un perfil.

El principal es responsable de la respuesta final. Si puede delegar, envía tareas planificadas a subagentes o inicia trabajos independientes y acotados. Cada hijo tiene perfil, contexto, herramientas y presupuesto propios. Los resultados vuelven al padre; la vista de actividad y la conversación muestran quién lleva cada rama, su estado y el resultado.

Delegar es útil para tareas independientes, pero no es paralelismo gratuito: cada hijo consume contexto y herramientas. El principal debe definir objetivos claros y evitar investigar lo mismo varias veces.

## Los flujos permiten reutilizar la coordinación {#workflows-make-orchestration-reusable}

Un flujo guarda una secuencia de trabajo para varios agentes. Úsalo para repetir un proceso, como investigar, implementar y revisar.

Escribe `/workflow` para consultar ejecuciones actuales y anteriores y sus árboles de gestores y agentes. Las definiciones se encuentran en los catálogos integrado, global o del espacio y Admiral las selecciona al iniciar. El flujo organiza las ejecuciones; la conversación sigue registrando lo ocurrido y los controles de seguridad habituales se aplican a cada herramienta.

## Los planes permiten revisar la intención {#plans-make-intent-inspectable}

Un plan es el registro ordenado con el que el agente descompone un objetivo en trabajo verificable. En modo normal puede crearlo y seguirlo durante la ejecución. Si activas la revisión, Clarvis espera tu decisión tras la propuesta y antes de implementar.

Un plan no es un flujo. El plan describe los pasos de un objetivo; el flujo define una estructura reutilizable de gestor y líderes que puede iniciar varias ejecuciones. Pulsa **Ctrl+P** para consultar el plan actual o el último, y usa `/plan` para alternar la revisión obligatoria en el espacio.

## La memoria conserva conocimiento del proyecto {#memory-carries-project-knowledge-forward}

La memoria es una wiki Markdown del espacio, separada de la conversación. Al comenzar, un resumen raíz limitado aporta conocimiento duradero al agente. Tras la ejecución, un indexado en segundo plano decide si los comandos verificados, decisiones, problemas u otro conocimiento no evidente merecen una actualización coherente. La mayoría de las ejecuciones no necesitan cambios.

Al ser Markdown y no una base vectorial, puedes inspeccionar y editar exactamente lo que reutilizarán las siguientes tareas. Configúrala en `/settings/memory` e indica en `memory-policy.md` qué merece conservarse.

## Tasks conecta la fuente externa de tareas {#tasks-connect-an-external-source-of-truth}

Tasks es una conexión opcional a un servicio externo. `/tasks` muestra sus elementos sin copiarlos a una base de datos de Clarvis. Elige **Work on task** para iniciar una ejecución vinculada en el proyecto actual.

Leer y modificar tareas requieren permisos distintos. La escritura está desactivada por defecto y exige modo de trabajo, permisos del agente y compatibilidad del proveedor. Terminar una ejecución nunca cambia automáticamente el estado de la tarea externa.

## Los Extension Profiles definen las capacidades activas {#extension-profiles-define-the-active-capability-set}

Los plugins pueden añadir agentes, herramientas, hooks y otros servicios. Las skills aportan instrucciones reutilizables. Un Extension Profile enumera los plugins instalados y skills independientes disponibles para nuevas ejecuciones.

Puedes mantener perfiles separados para investigar, programar, revisar u otros trabajos y alternar entre ellos en el mismo espacio. Los perfiles globales se reutilizan en distintos espacios. Cada perfil propio incluye solo las extensiones que seleccionas.

Abre `/extensions` para buscar extensiones y elegir el conjunto activo. El editor permite revisar los cambios antes de aplicarlos. El navegador de Plugins también ofrece instalar y activar explícitamente. El código ejecutable del repositorio requiere aprobación del espacio. Clarvis registra el perfil y la huella de su contenido con cada ejecución y sesión.

## El contexto es menor que el historial {#context-is-smaller-than-the-transcript}

La sesión guardada es el registro duradero. El contexto del modelo es el conjunto limitado que se envía en cada llamada. Clarvis puede retirar contenido antiguo de la vista activa y compactar contexto para continuar sin reenviarlo todo.

Usa `/compact` para solicitarlo expresamente. Añade una instrucción breve si deben conservarse decisiones concretas:

```text
/compact preserve the accepted API shape and the unresolved Windows failure
```

Compactar no sustituye la conversación guardada. Usa `/export` para obtener el registro completo, incluido lo que ya no se muestra en la vista activa.

## Sigue una ejecución de principio a fin {#follow-one-run-from-start-to-finish}

1. Clarvis resuelve los ajustes globales y del espacio y el perfil seleccionado.
2. Eliges agente principal y seguridad para la siguiente ejecución.
3. Tu mensaje, o la tarea externa seleccionada, inicia una ejecución en la sesión actual.
4. El principal puede crear un plan, llamar a herramientas permitidas y delegar trabajo acotado.
5. Clarvis espera las decisiones obligatorias sobre comandos, planes, flujos o preguntas.
6. Los resultados de hijos vuelven a sus padres y el principal produce la respuesta final.
7. La sesión conserva conversación y eventos para recuperar o exportar.
8. Si hay memoria configurada, se programa una revisión de conocimiento en segundo plano.

Si la configuración no permite empezar con seguridad, `/doctor` explica qué comprobación bloquea y ofrece la pantalla adecuada para corregirlo.

## Términos de esta documentación {#terms-used-in-these-docs}

| Término       | Significado                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------- |
| System prompt | Instrucciones que definen el papel y la forma de trabajar de un agente. Puedes sustituir por completo el prompt integrado. |
| Skill         | Instrucciones reutilizables con scripts y referencias opcionales, cargadas cuando hacen falta.                             |
| MCP           | Model Context Protocol: una forma de conectar herramientas e información de otros servicios.                               |
| Hook          | Acción que se dispara con un evento, como una llamada a herramienta o el fin de una ejecución.                             |
| Snapshot      | Copia fija del conjunto de extensiones utilizado por una ejecución.                                                        |
| Fingerprint   | Huella calculada a partir del contenido para detectar cambios.                                                             |
| TUI           | Interfaz interactiva del terminal.                                                                                         |
| Kernel        | Parte de Clarvis que gestiona las ejecuciones, herramientas y ajustes del proyecto.                                        |

## Consulta también {#see-also}

- [Primeros pasos](/es-ES/getting-started)
- [Uso diario](/es-ES/guide/daily-use)
- [Agentes](/es-ES/guide/agents)
- [Planes](/es-ES/guide/plans)
- [Memoria](/es-ES/guide/memory)
- [Tareas](/es-ES/guide/tasks)
- [Flujos de trabajo](/es-ES/guide/workflows)
- [Extensiones](/es-ES/guide/extensions)
- [Ámbitos y confianza](/es-ES/explanation/scopes-and-trust)

---

[HTML canónico](https://clarvis.dev/es-ES/explanation/how-clarvis-works)

[Índice de documentación](https://clarvis.dev/es-ES/llms.txt)