# Flujos de trabajo {#workflows}
> Guarda una secuencia de trabajo para varios agentes y reutilízala en otras tareas.
Un flujo de trabajo indica a Admiral qué agentes deben participar, en qué orden, qué recibe cada uno y cómo combinar los resultados. Guárdalo una vez y reutilízalo en tareas similares. No es un perfil de agente ni un plan: coordina varias ejecuciones que revisas antes de comenzar.
## Usa un flujo integrado {#use-a-built-in-workflow}
Clarvis incluye `audit`, `implement` y `research`. Selecciona Admiral en `/agent` y pide el flujo por su nombre:
```text
Use the audit workflow to review the authentication changes. Explain the work and cost before
running it.
```
Antes de iniciar cualquier líder, Clarvis pide revisar las rondas, los agentes y el número de ejecuciones paralelas. Aprobar inicia solo la primera ronda. Tras cada ronda, Admiral recibe un punto de control guardado y decide si continúa o se detiene.
Las imágenes muestran una ejecución real de `release-review` con un líder y un perfil de demostración aislado. Sigue la misma revisión y persistencia que los flujos integrados.
Paso 1: selecciona Admiral. La cabecera confirma la capacidad de flujos del agente principal.Paso 2: revisa antes de ejecutar. Ningún líder empieza hasta revisar la ronda, el perfil y el número de ejecuciones y aprobar explícitamente.Paso 3: sigue el árbol. La barra lateral mantiene visibles líderes, estados, duración e iteraciones junto al resultado del gestor.
::: warning Atención
Ejecutar un flujo siempre requiere revisión interactiva. El modo de impresión puede explicarlo, pero no aprobarlo ni ejecutarlo.
:::
## Escribe un flujo de trabajo {#author-a-workflow}
Crea esta estructura:
```text
.clarvis/workflows/release-review/
├── WORKFLOW.md
└── briefs/
└── inspect.md
```
Añade `.clarvis/workflows/release-review/WORKFLOW.md`:
```md
---
name: release-review
description: Review a release target through one evidence-gathering leader.
args:
- target
rounds:
- id: inspect
title: Review {{args.target}}
type: free
profile: explorer
over: once
brief: briefs/inspect.md
---
Summarize the review for a human. Lead with blockers, then risks, then evidence that the target is
ready.
```
Añade `.clarvis/workflows/release-review/briefs/inspect.md`:
```md
Review {{args.target}} for release readiness.
Inspect manifests, release notes, public documentation, and the checks that cover the changed
surface. Return concrete blockers and risks with repository paths. Do not modify the workspace.
```
El directorio y el campo `name` deben coincidir. La primera ronda debe usar `over: once`. Las rutas de los documentos `brief` son relativas al directorio del flujo.
## Ejecuta tu flujo {#run-your-workflow}
Selecciona Admiral y pide:
```text
Use the release-review workflow for target candidate. Explain its cost before running it.
```
Los argumentos como `target` son obligatorios si se declaran. `/workflow` es el navegador de historial y del árbol de agentes; no es un editor ni un lanzador de definiciones. Mientras una secuencia espera, esa vista y la sección Parallel work muestran `awaiting_manager`, la revisión del punto de control y la próxima ronda propuesta. Una decisión repetida o desactualizada no puede iniciar dos veces la misma ronda.
Paso 4: vuelve a abrir la ejecución. Usa /workflow para inspeccionar el árbol guardado después de terminar.Paso 5: revisa las pruebas. Abre un líder para leer su resultado completo y sus totales, no solo la síntesis.
## Añade más rondas {#add-more-rounds}
Cada ronda declara:
- un `id` único;
- un `type`: `discovery`, `findings`, `verdict` o `free`;
- un `profile` de agente opcional;
- un selector `over`;
- un `title` breve;
- una ruta relativa `brief`.
Los selectores tienen una sintaxis deliberadamente reducida:
- `once` ejecuta un líder;
- `each(scan.items)` ejecuta uno por elemento;
- `each(scan.items where needs_verification)` filtra elementos con valor verdadero;
- `each(scan.items where severity = high)` filtra por valor;
- `all(scan.items)` envía toda la colección a un líder.
Usa `fanout` solo para copias de una ronda realmente independientes. Las rondas repetidas pueden detenerse si no hay resultados nuevos o si alcanzan un límite de presupuesto.
## Controla los recursos {#control-workflow-resources}
Los ajustes opcionales afectan a todo el árbol:
```json
{
"workflows": {
"max_concurrency": 4,
"max_total_leaders": 32,
"budget_tokens": 640000000
}
}
```
La concurrencia por defecto es `4` y el máximo es `20`. `max_total_leaders` vale `32` por defecto y limita los registros correctos de líderes durante toda la vida del gestor; terminar un líder no devuelve una plaza. El presupuesto auxiliar de tokens es `640000000` por defecto. Usa `null` solo si quieres quitar deliberadamente ese límite. Abarca los hijos internos del gestor, todos los líderes y sus subagentes. El gestor usa su presupuesto de ejecución principal independiente y no consume esta cuenta.
::: tip Cómo se comparte el presupuesto
Las llamadas activas al modelo comparten los tokens disponibles. Un líder que espera una plaza de concurrencia no reserva tokens, y la capacidad no usada se devuelve al terminar una llamada. Así, los hijos del gestor, líderes y subagentes reutilizan el presupuesto restante.
Antes de iniciar una ronda, Clarvis comprueba si cabe completa en el límite acumulado de líderes. No inicia solo una parte de una ronda que lo supere. Agotar los tokens hace fallar a los líderes afectados y al flujo; revisa todos los resultados en `/workflow`.
:::
Los flujos del espacio sustituyen por completo a los globales o integrados del mismo nombre. Una sustitución mal formada se ignora y queda disponible la definición válida de menor prioridad.
## Consulta también {#see-also}
- [Agentes](/es-ES/guide/agents)
- [Uso diario](/es-ES/guide/daily-use)
- [Ámbitos y confianza](/es-ES/explanation/scopes-and-trust)
- [Solución de problemas](/es-ES/operations/troubleshooting)
---
[HTML canónico](https://clarvis.dev/es-ES/guide/workflows)
[Índice de documentación](https://clarvis.dev/es-ES/llms.txt)
