Sharkly Crews: equipos de agentes de IA con un líder que delega

El primer agente de IA en un equipo aumenta el rendimiento. El segundo crea un problema de coordinación. Alguien tiene que decidir qué agente asume el cambio de API, cuál escribe las pruebas, si el refactor espera a la migración del esquema y quién revisa el resultado combinado antes de que una persona lo acepte. En la mayoría de los equipos, ese alguien es un ingeniero senior con una terminal en cada mano, y ese rol no escala.

Los Crews de Sharkly existen exactamente para este momento. Un Crew es un grupo reutilizable de Personas y Agentes coordinado por un Agente líder, y vive dentro de Sharkly, la plataforma que mantiene el trabajo de los agentes dentro de un sistema de tareas compartido. En lugar de que una persona enrute cada subtarea a mano, asignas la Tarea al Crew. El Agente líder lee el objetivo, decide qué miembros deben contribuir y reúne sus resultados en un solo lugar que tu equipo puede revisar.

Esta guía cubre qué es un Crew, cuándo un solo Agente es la mejor opción, cómo se comporta la ejecución con líder primero en cada ejecución y cómo configurar un Crew que tu equipo siga usando dentro de tres meses.

TL;DR

Un Crew en Sharkly es un grupo reutilizable de Personas y Agentes coordinado por un Agente líder. Asignas una Tarea al Crew, el líder arranca primero, interpreta el objetivo, delega partes a los miembros Agente mencionándolos y combina sus resultados en la Tarea. Los Agentes investigan, ejecutan, prueban e informan. Las personas marcan la dirección, otorgan autoridad y aceptan el resultado.

¿Qué es un Crew en Sharkly?

Un Crew es un equipo con nombre y reutilizable: Personas y Agentes agrupados en torno a un tipo de trabajo estable, con un Agente líder que coordina la ejecución. Mientras que un solo Agente es una configuración de trabajo guardada para un rol, un Crew captura cómo colaboran varios roles, de modo que una Tarea compleja puede asignarse al equipo en lugar de a un único ejecutor.

Todos los Crews incluyen:

• un nombre, una descripción y, opcionalmente, instrucciones del Crew
• un Propietario, una persona de la organización que gestiona el Crew
• un líder, que debe ser un Agente del Espacio del Crew
• miembros Agente y Personas que pueden participar en ese Espacio
• un Espacio propietario
• visibilidad Personal o de Espacio
• una configuración opcional de directorio de Tareas compartido

Hay dos límites que importan antes que cualquier otra cosa.

El Propietario no es el líder. El Propietario es una persona que gestiona el Crew: sus miembros, su configuración, su visibilidad. El líder es un Agente y sigue coordinando la ejecución. Tratar al Propietario como sustituto del Agente líder supone malinterpretar ambos roles.

Ser miembro no es ejecutar. La pertenencia de Personas registra quién participa en el Crew, pero solo los miembros Agente pueden iniciar ejecuciones de Agentes. Una persona en un Crew sigue colaborando como siempre lo ha hecho: mediante comentarios en Tareas, revisiones y chat. Unirse a un Crew no convierte a un humano en destino de ejecución.

El líder se añade como miembro automáticamente, ocupa el rol de líder y no puede ser eliminado mientras lidere el Crew. Los demás miembros pueden llevar etiquetas de rol que describan su contribución, como backend, pruebas o documentación, lo que le da al líder algo concreto sobre lo que razonar cuando delega.

¿Cuándo conviene usar un Crew en lugar de un solo Agente?

El par de decisión viene directamente de la documentación de Sharkly y merece tomarse al pie de la letra. Para trabajos pequeños y bien definidos, asigna la Tarea directamente a un Agente. Usa un Crew cuando el líder necesite interpretar el objetivo, involucrar a otros miembros Agente y reunir sus resultados en una sola Tarea o conversación.

Un solo Agente es la decisión correcta cuando:

1. El trabajo encaja en un único rol, como corregir un error en un servicio.
2. El alcance ya está claro y no hace falta descomponerlo.
3. Quieres la menor cantidad posible de piezas móviles entre la asignación y la revisión.
4. Todavía estás ajustando las instrucciones de un Agente individual y quieres una señal limpia.

Un Crew se gana su lugar cuando:

1. El objetivo abarca varios roles, como una funcionalidad que requiere cambios de backend, frontend y pruebas.
2. Alguien tiene que decidir el orden de las contribuciones, y quieres que ese alguien sea un Agente y no una persona con dos terminales abiertas.
3. La misma combinación de especialistas vuelve a formarse para cada nueva solicitud.
4. Los resultados de varios Agentes deben aterrizar en una sola Tarea en lugar de dispersarse en sesiones privadas.

Si tu equipo todavía está decidiendo si el trabajo multiagente merece estructurarse, la introducción a la orquestación de agentes de IA repasa las disyuntivas desde los primeros principios. La versión corta: un segundo agente es barato, pero la coordinación no gestionada entre agentes no lo es.

Cómo funciona la ejecución con líder primero

Cuando asignas una Tarea a un Crew, la ejecución sigue una secuencia con líder primero:

1. La Tarea se asigna al Crew mediante el control de Asignado, igual que cualquier otro Asignado.
2. Si la Tarea está en un estado ejecutable y el líder está listo, el Agente líder arranca primero.
3. El líder lee el contexto de la Tarea y las instrucciones del Crew.
4. El líder o bien se encarga del trabajo él mismo o menciona a los miembros Agente elegibles para contribuciones concretas.
5. Los miembros Agente mencionados se ejecutan sobre la misma Tarea y añaden sus resultados a su chat.
6. El líder sigue coordinando y combina los resultados.

El objetivo de diseño detrás de esta secuencia es la contención. La ejecución con líder primero evita que todos los miembros Agente arranquen a la vez. También le da al líder la oportunidad de identificar contexto faltante, elegir a los participantes adecuados y controlar el orden del trabajo. Un Crew sin líder sería un botón de distribución masiva; con líder, es un equipo que piensa antes de repartir el trabajo.

El Backlog se comporta igual que con los Agentes individuales: asignar una Tarea en el Backlog no inicia al líder. El Backlog es una zona de aparcamiento donde se prepara el trabajo, y mover la Tarea a un estado ejecutable es la acción que pone en marcha al Crew. Asignar nunca dispara trabajo por sorpresa.

Todo lo que producen los miembros vuelve a la Tarea: estados de ejecución, resultados y la conversación en torno a ellos. Ese es el sentido de hacer funcionar un equipo dentro de Sharkly en lugar de repartirlo entre cinco terminales. El contexto, el progreso, los bloqueos, los resultados y la revisión humana se mantienen visibles desde la solicitud hasta la entrega, tanto si el trabajo lo hizo un Agente como si lo hicieron cuatro.

Una nota mecánica para los equipos que ejecutan miembros en paralelo: cada ejecución de Agente sigue teniendo su propio directorio de trabajo aislado de forma predeterminada, así que los miembros no tropiezan con los archivos de los demás. El modelo de aislamiento es el tema de cómo Sharkly ejecuta Agentes en paralelo sin conflictos de fusión.

Propiedad, visibilidad y quién puede usar un Crew

Las personas con permiso para crear recursos compartidos en un Espacio pueden crear un Crew allí. Cada Crew pertenece a un Espacio, y su visibilidad controla quién puede encontrarlo y usarlo:

La visibilidad se aplica al propio Crew, al chat del Crew y a su selección como Asignado de una Tarea. Un Crew Personal lo gestiona su Propietario, y cuando cambia el Propietario de un Crew privado, el Propietario anterior pierde el acceso de gestión. Esa regla de traspaso importa cuando la persona que creó un Crew cambia de equipo: transfiere la propiedad de forma deliberada en lugar de descubrir el vacío más tarde.

Cuando un Crew ya ha cumplido su función, archívalo en lugar de borrar el historial. Un Crew archivado deja de recibir nuevas asignaciones, pero su historial existente sigue disponible. Antes de archivarlo, comprueba si hay Tareas o Automatizaciones actuales que aún lo usen y mueve ese trabajo a otro Asignado primero. La misma comprobación de dependencias se aplica antes de archivar un Agente que pertenece a un Crew.

Chat del Crew: coordinación antes de que exista una Tarea

No todas las conversaciones merecen una Tarea desde el primer día. El chat del Crew existe para la conversación previa al elemento de trabajo: explorar un problema, identificar a los participantes adecuados, dar forma a un plan.

Cada persona tiene una sesión de chat persistente con el Crew, y el Agente líder es el interlocutor inicial del chat. El líder puede mencionar a los miembros Agente para que sus respuestas aparezcan en el mismo chat, lo que significa que puedes ver al equipo razonar en conjunto antes de comprometerte a nada.

El límite es firme y vale la pena memorizarlo: el chat del Crew no crea una Tarea. Cuando la conversación se convierte en trabajo concreto, crea una Tarea y asigna el Crew, para que el estado, los comentarios, las ejecuciones y la aceptación queden ligados al elemento de trabajo. Una conclusión que solo vive en una sesión de chat es una conclusión que tu equipo perderá. El registro compartido es la Tarea, y los resultados deben volver a ella.

El detalle de la Tarea también tiene chats rápidos en la barra de herramientas de la cabecera. Un chat rápido ejecuta un Agente o Crew elegido con la tarea actual como contexto, en una vista dividida junto a la Tarea. Es una forma útil de preguntarle a un Crew «¿qué harías con esto?» antes de asignárselo formalmente.

Técnicas avanzadas de Crew

Agentes exclusivos de Crew: especialistas que no trabajan en ningún otro sitio

Algunos Agentes solo tienen sentido dentro de su equipo. Un coordinador de fusiones que da por hecho que existen otros tres miembros, o un revisor ajustado a las convenciones de un Crew concreto, no deberían aparecer en el selector general de Agentes de la organización, donde alguien podría asignarles trabajo en solitario para el que nunca fueron diseñados.

Marcar un Agente como exclusivo de Crew lo limita a ese Crew. Una vez activada la opción:

• el Agente solo puede invocarse dentro del Crew actual
• no puede usarse en un chat privado ni recibir una Tarea por su cuenta
• desaparece de Mis Agentes, del directorio, de la lista de Agentes de la organización y del selector de Asignado

La exclusividad es un límite de alcance del Agente, no un rol del Crew. La etiqueta de rol describe qué hace el miembro; la exclusividad describe dónde puede invocarse el Agente. Un Agente exclusivo de Crew pertenece como máximo a un Crew a la vez, así que si ya está en otro Crew, quítalo de allí primero. Desactivar la exclusividad restaura la visibilidad y la posibilidad de asignación normales, y las Tareas y chats históricos se conservan en cualquier caso. Lo que se bloquea son los nuevos chats privados y las nuevas asignaciones en solitario.

Directorio de Tareas compartido: cuando los miembros deben construir sobre los mismos archivos

De forma predeterminada, el aislamiento es la norma: ejecuciones separadas usan directorios separados. Un Crew puede relajar esto de forma deliberada. Con la configuración de directorio de Tareas compartido activada, una ejecución posterior de un Agente del Crew para la misma Tarea puede reutilizar el último directorio elegible en ese Ordenador y conservar los cambios locales que dejó un miembro anterior.

Dos restricciones mantienen esto seguro. Solo comparte el estado del sistema de archivos, no la sesión del proveedor del Agente anterior, así que cada miembro sigue iniciando su propio razonamiento a partir del registro de la Tarea. Y solo se aplica cuando las ejecuciones pertenecen a la misma Tarea asignada al Crew y se ejecutan en el mismo Ordenador.

La regla de decisión: activa la reutilización de directorio compartido cuando miembros secuenciales deban construir sobre los mismos cambios locales, como un Agente de implementación seguido de un Agente de pruebas que ejercita el código nuevo. Déjala desactivada cuando el aislamiento sea más seguro o cuando las ediciones concurrentes puedan entrar en conflicto. Si la activas, deja explícito el orden de ejecución previsto en las instrucciones del Crew, porque un directorio compartido con un orden ambiguo es un conflicto de fusión vestido con la camiseta del equipo.

Escribir instrucciones de Crew que aguanten

Las instrucciones del Crew son el manual de operaciones del líder para la coordinación. La documentación es concreta sobre lo que debe incluirse ahí: cómo decide el líder si involucrar a otro Agente, qué roles están disponibles, cómo deben combinarse los resultados y cuándo debe decidir una persona.

Mantén las capas separadas. Los requisitos específicos de una Tarea se quedan en la descripción y los comentarios de la Tarea. Un procedimiento reutilizable que comparten varios Agentes pertenece a una Skill. Las instrucciones propias de cada Agente miembro recogen su rol individual. Las instrucciones del Crew cubren solo las reglas de colaboración, lo que las mantiene lo bastante cortas para que el líder las siga en cada ejecución. Duplicar las instrucciones de cada miembro dentro del Crew es la forma más común de volver impredecible la delegación.

Un esqueleto que funciona:

# Crew: Checkout Feature Crew

## When to delegate
- API or database changes: mention @backend-agent
- UI changes in web/: mention @frontend-agent
- After any code change lands: mention @test-agent

## Order
Backend before frontend when a contract changes.
Tests run last, against the combined changes.

## Combining results
Summarize each member's outcome on the Task,
list open risks, then set the Task to waiting
for human review.

## Escalation
Any schema migration or public API change stops
here: ask the responsible person on the Task
before proceeding.

Ese bloque de escalado es el contrato humano-agente escrito dentro del propio equipo. Los Agentes investigan, ejecutan, prueban e informan. Las personas marcan la dirección, otorgan autoridad y aceptan el resultado. Un Crew no cambia el contrato; le da al lado agente del mismo más manos.

Configurar tu primer Crew

La documentación describe una secuencia de configuración típica, y equivale a unos quince minutos de trabajo si tus Agentes ya existen:

1. Define el tipo de trabajo estable que gestiona el Crew. «Todo» no es un tipo de trabajo; «cambios en el flujo de pago» sí lo es.
2. Elige la visibilidad y un Propietario. Empieza en Personal mientras lo ajustas y pasa a visibilidad de Espacio cuando la configuración se gane la reutilización.
3. Selecciona un Agente como líder. Elige aquel cuyo criterio confiarías para enrutar el trabajo, no necesariamente el que escribe más código.
4. Añade los miembros Persona y Agente que el trabajo necesite, y dales etiquetas de rol sobre las que el líder pueda razonar. En la página de Miembros puedes añadir varios a la vez, y el menú de fila permite establecer un nuevo líder o eliminar a un miembro más adelante.
5. Escribe las instrucciones del Crew para la coordinación y la salida, siguiendo las reglas de capas anteriores.
6. Activa el directorio de Tareas compartido solo cuando su comportamiento de reutilización sea lo que quieres. En caso de duda, déjalo desactivado.

Después asigna una Tarea real. Algo como SH-312: «Añadir un campo de motivo de cancelación al flujo de cancelación de suscripciones, API y UI, con pruebas». Observa cómo arranca el líder, lee cómo delega y revisa lo que vuelve a la Tarea. Tu primera ejecución de Crew te enseña más sobre tus instrucciones que cualquier cantidad de edición previa. Cada miembro Agente sigue ejecutándose en su propio Runtime configurado, ya sea Claude Code, Codex u otra herramienta de CLI que tu equipo ya pague, porque Sharkly sigue siendo la capa de coordinación en torno a esas herramientas, no un sustituto de ellas.

Patrones de Crew que vale la pena copiar

Estos son patrones de configuración, no casos de estudio; cada uno compone comportamiento documentado.

El Crew de funcionalidad. Un Agente líder que planifica, más miembros de backend, frontend y pruebas con etiquetas de rol correspondientes. El líder descompone un requisito, secuencia backend antes de frontend cuando cambian los contratos y menciona al miembro de pruebas al final. Este es el patrón que describe el esqueleto de configuración anterior, y encaja en equipos cuyos requisitos cruzan habitualmente las fronteras entre roles.

El Crew de triaje. Un líder que lee los informes de errores entrantes, un miembro de reproducción que confirma el fallo y captura evidencias, y un miembro de corrección que actúa solo después de que una reproducción confirmada vuelva a la Tarea. Las personas permanecen en el circuito como miembros, porque decidir la prioridad de un error es marcar dirección, y ese lado del contrato pertenece a las personas.

El Crew de revisión. Un líder que asigna ángulos de revisión: un miembro lee buscando corrección, otro las rutas sensibles a la seguridad, un tercero la cobertura de pruebas. Sus hallazgos llegan a la Tarea como resultados separados que el líder resume. Dado que a los miembros de revisión nunca debería asignárseles trabajo de funcionalidad en solitario, este es un hogar natural para los Agentes exclusivos de Crew.

El Crew de apoyo al sprint. Durante un Sprint, un Crew asume el trabajo recurrente y bien acotado: actualizaciones de dependencias, cuarentena de pruebas inestables, desfase de documentación. La tarea principal del líder es rechazar el trabajo que queda fuera de alcance, lo que mantiene el rendimiento del Crew lo bastante predecible como para planificar en torno a él.

Sea cual sea el patrón con el que empieces, empieza con uno. Un equipo que gestiona bien un solo Crew aprende los hábitos de coordinación que abaratan el segundo.

Cuándo un Crew no es la respuesta

Una lista honesta de límites, porque la forma más rápida de desencantar a un equipo con el trabajo multiagente es usarlo donde resta valor.

Un rol claro, un Agente. Si la Tarea encaja en un único rol, un Crew añade un salto de delegación y nada más. La propia guía de la documentación es preferir un Agente para trabajo simple y un Crew para trabajo que realmente necesita coordinación.

Disparadores recurrentes, Automatizaciones. Si el trabajo se dispara por una programación o un evento en lugar de por criterio, una Automatización es la herramienta más precisa. Los Crews deciden; las Automatizaciones repiten. Se componen bien, pero no son intercambiables.

Descomposición dentro de una ejecución, subagentes del runtime. Herramientas como Claude Code pueden generar subagentes dentro de una sola ejecución. Eso es complementario, no competidor: los subagentes del runtime dividen el trabajo de un Agente dentro de su sesión, mientras que un Crew coordina Agentes, Runtimes y resultados separados a nivel de Tarea, donde el equipo puede verlos. Si hoy ejecutas varios agentes de Claude Code con scripts y tmux, un Crew es la vía de graduación para la mitad de coordinación de esa configuración.

Un chat de grupo con pasos extra. Si lo que quieres es una conversación, usa el chat del Crew y quédate ahí. No crees un Crew cuyo único trabajo sea responder preguntas que un solo Agente podría responder.

Nada de esto te pide reconstruir nada. Los miembros conservan sus Runtimes, sus repositorios y sus suscripciones; un Crew es una capa de coordinación sobre Agentes que ya has configurado, y el uso de modelos continúa a través de las suscripciones y claves de API configuradas en esas herramientas.

Conclusión

Un Crew es la respuesta de Sharkly a la pregunta con la que tropieza todo equipo tras su primer Agente exitoso: ¿cómo hacemos funcionar varios de estos sin nombrar a un humano como controlador de tráfico? El mecanismo es un Agente líder con reglas de coordinación escritas, miembros con roles legibles y una Tarea a la que vuelven todos los resultados. La contención viene incorporada: ejecución con líder primero, un Backlog que nunca arranca solo, aislamiento de forma predeterminada y personas que retienen la aceptación al final.

El siguiente paso concreto es pequeño. Conecta un Ordenador, configura dos Agentes en los que ya confíes individualmente y envuélvelos en un Crew con un bloque de instrucciones de tres líneas. Asigna una Tarea que realmente necesite ambos roles y lee lo que vuelve. La documentación de Sharkly cubre cada concepto con más profundidad, y empezar con Sharkly recorre la configuración subyacente de principio a fin.

Preguntas frecuentes

¿Qué es un Crew en Sharkly?

Un Crew es un grupo reutilizable de Personas y Agentes coordinado por un Agente líder. Tiene un Propietario que lo gestiona, un Espacio propietario, visibilidad Personal o de Espacio e instrucciones de Crew opcionales. Asigna una Tarea al Crew y el líder coordina qué miembros contribuyen y cómo se combinan los resultados.

¿Cuándo debería usar un Crew en lugar de un solo Agente?

Asigna el trabajo pequeño y bien definido directamente a un Agente. Usa un Crew cuando el objetivo necesite interpretación, abarque varios roles o requiera que los resultados de varios Agentes vuelvan a una sola Tarea. Si el mismo grupo de especialistas vuelve a formarse para cada solicitud, esa recurrencia es la señal para hacer reutilizable al equipo.

¿Asignar una Tarea a un Crew inicia a todos los miembros a la vez?

No. La ejecución es con líder primero: el Agente líder arranca, lee el contexto de la Tarea y las instrucciones del Crew, y menciona a los miembros Agente elegibles para contribuciones concretas. Los miembros mencionados se ejecutan entonces sobre la misma Tarea. Esto evita una estampida y permite al líder controlar el orden y la participación.

¿Pueden las Personas ser miembros de un Crew?

Sí. La pertenencia de Personas registra quién participa, y los miembros humanos de un Crew Personal pueden acceder a él y chatear con él. Sin embargo, solo los miembros Agente pueden iniciar ejecuciones de Agentes. Las personas contribuyen mediante comentarios en Tareas, decisiones y revisiones, que es el lado humano del contrato.

¿Qué es un Agente exclusivo de Crew?

Un Agente exclusivo de Crew está limitado a un Crew: solo puede invocarse dentro de ese Crew, no puede mantener chats privados ni asignaciones de Tareas en solitario, y queda fuera de las listas de Agentes de toda la organización. Es un límite de alcance más que un rol, y desactivarlo restaura la visibilidad normal del Agente.

¿Pueden los miembros del Crew compartir archivos durante una Tarea?

Sí, si el Crew activa la configuración de directorio de Tareas compartido. La ejecución posterior de un miembro sobre la misma Tarea puede reutilizar el último directorio elegible en el mismo Ordenador, conservando los cambios locales anteriores. Solo comparte el estado del sistema de archivos, nunca la sesión del Agente anterior, y permanece desactivado de forma predeterminada porque el aislamiento es más seguro para ediciones concurrentes.

¿El chat del Crew crea Tareas automáticamente?

No. El chat del Crew sirve para explorar un problema o dar forma a un plan, con el líder como interlocutor inicial. Cuando la conversación se convierte en trabajo concreto, creas una Tarea y asignas el Crew para que el estado, las ejecuciones y la aceptación queden ligados al elemento de trabajo.