Flujos de trabajo

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

Clarvis incluye audit, implement y research. Selecciona Admiral en /agent y pide el flujo por su nombre:

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.

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

Crea esta estructura:

.clarvis/workflows/release-review/
├── WORKFLOW.md
└── briefs/
    └── inspect.md

Añade .clarvis/workflows/release-review/WORKFLOW.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:

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

Selecciona Admiral y pide:

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

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

Los ajustes opcionales afectan a todo el árbol:

{
  "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.

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

• Agentes
• Uso diario
• Ámbitos y confianza
• Solución de problemas