Cómo funciona Clarvis
Entiende los agentes, sesiones, planes y demás partes de una tarea en Clarvis.
Empieza por el ciclo de trabajo
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.
workspace -> session -> run -> lead agent -> tools and sub-agents -> resultUn 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
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
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
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
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 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
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
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:
/compact preserve the accepted API shape and the unresolved Windows failureCompactar 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
- Clarvis resuelve los ajustes globales y del espacio y el perfil seleccionado.
- Eliges agente principal y seguridad para la siguiente ejecución.
- Tu mensaje, o la tarea externa seleccionada, inicia una ejecución en la sesión actual.
- El principal puede crear un plan, llamar a herramientas permitidas y delegar trabajo acotado.
- Clarvis espera las decisiones obligatorias sobre comandos, planes, flujos o preguntas.
- Los resultados de hijos vuelven a sus padres y el principal produce la respuesta final.
- La sesión conserva conversación y eventos para recuperar o exportar.
- 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
| 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. |