Haz que los Agents sean miembros reales del equipo

Experiencia práctica sobre planificación, Agents de triaje, gestión del contexto y mantenimiento del tablero de tareas.

Estas prácticas son para quienes ya empezaron a probar Syfo y se preparan para incorporar Agents al trabajo diario del equipo. Para dividir canales y decidir cuántos Agents usar, consulta primero Guía de equipo y Canales y colaboración; aquí nos enfocamos en los hábitos de la colaboración diaria en los que es más fácil tropezar y que más productividad aportan.

En una frase: las personas dan los objetivos y los principios; la solución se la dejas al Agent. No estás manejando una herramienta, sino liderando un equipo que crece por sí mismo: pon tu energía en los requisitos, el criterio y la revisión final.

Deja que el Agent te ayude a planificar

No hace falta que te quiebres la cabeza pensando cómo configurarlo todo; deja la planificación misma en manos de un Agent:

Explícale a un Agent tu negocio, tus procesos y tu estructura organizativa, y pídele que sugiera cómo dividir los canales, qué Agents poner en cada canal y cuántos Agents asignar aproximadamente a una tarea.
Dale objetivos y restricciones (por ejemplo, «N sistemas por refactorizar, en cuántos días, con cuántas personas y qué recursos») y te propondrá un plan, incluso con el rol y el prompt de cada Agent; solo tienes que crearlos y pegarlos para empezar.
Si algo se desvía, corrígelo en cualquier momento: lo guardará en su memoria a largo plazo y se ajustará cada vez mejor a tu equipo.

Este es el paso clave para pasar de «manejar una herramienta» a «liderar un equipo de Agents».

Diseña bien el Agent de triaje / residente

Cuando se colabora en varios canales, normalmente hace falta un Agent «residente» que distribuya la información y coordine (como el mostrador de orientación de un hospital). Para aprovecharlo bien, sigue estos principios:

Una sola responsabilidad: el Agent residente solo distribuye y coordina; no hace desarrollo. Si se mete en los detalles del desarrollo, no le dará tiempo de hacer el triaje a tiempo y los mensajes se acumularán en cola.
Lo gobierna quien lo creó: sus principios de trabajo los ajusta y delimita su owner, y los demás no los modifican a su antojo; es como un colega que tiene un manager directo: el feedback se canaliza a través de ese manager.
Dale un marco, no una pila de reglas: no acumules cientos de reglas. Trabaja con él para abstraer un «marco de decisión + reglas de enrutamiento», deja que trabaje según ese marco y corrígelo si se desvía.
Las decisiones entre departamentos, en un solo grupo: para decisiones que involucran a varios departamentos, haz que los Agents de triaje de cada departamento y las personas que deciden conversen en el mismo canal; una vez que se pongan de acuerdo, cada uno lleva las tareas de vuelta a su departamento. No dejes que un solo Agent haga triaje entre dos sistemas grandes.

Gestiona el contexto y, de paso, ahorra dinero

El Agent es una sesión persistente; con el tiempo, el contexto se acumula y se vuelve más lento.

Restablece en los momentos libres: cuando esté libre, restablece la sesión manualmente o en lote; la memoria a largo plazo no se pierde, y el Agent, al reiniciarse, puede retomar desde el último punto de trabajo. El restablecimiento interrumpe las tareas en curso, así que hazlo cuando esté libre. Para operaciones en lote, usa “Restart Agents” o “Reset & restart” en la página de detalles de la computadora.
Controla la longitud del contexto: muchas tareas no necesitan un contexto muy largo. Cuanto más largo es el contexto, mayor es el costo y la latencia de cada solicitud; puedes ver cuánto contexto ocupa la sesión actual en la pestaña “Usage” de la página de detalles del Agent y luego decidir si restablecerla.
Elige el modelo según el caso: cada modelo tiene sus puntos fuertes en programación, redacción o estética, y también difieren en precio y velocidad. Prueba primero la misma tarea con dos o tres modelos, compara los resultados y el uso, y luego define tu opción predeterminada.

Solo si el reparto de trabajo está bien hecho el Agent tendrá «momentos libres» para restablecerse; si no, estará siempre ocupado y solo quedará libre de madrugada.

Escribir código con un Agent

Mira los resultados, no tanto el diff: cuando el modelo es lo bastante capaz, en lugar de revisar el código línea por línea, conviene validar viendo cómo funciona el resultado final. Si quieres ver los cambios, usa dos pantallas: en una conversas con el Agent y en la otra revisas el git diff y el historial de commits en VS Code; también puedes ver sus llamadas a herramientas y su razonamiento en la pestaña “Activity” de la página de detalles del Agent.
La calidad del código, como tarea aparte: además de las funcionalidades, pide periódicamente al Agent que divida archivos largos y haga limpiezas de mantenibilidad (mantén cada archivo por debajo de unos cientos de líneas para evitar conflictos cuando varios Agents modifican el mismo archivo); y acuerda de antemano las normas de código.
Usa git para las versiones y worktree para el trabajo en paralelo: git es la base de las versiones y los rollbacks. Cuando varios Agents desarrollan en paralelo en el mismo repositorio, usa git worktree (basta con decírselo al Agent). Los worktrees ocupan mucho disco; puedes enlazar con symlinks las dependencias ya instaladas en el directorio raíz para reutilizarlas, o borrarlos al terminar.

Acordar límites de autonomía y segunda confirmación

El Agent es capaz de diagnosticar y resolver problemas por su cuenta (por ejemplo, si un despliegue falla, revisa los logs y lo corrige). Si se detiene a cada rato a esperar confirmación, lo más probable es que los límites no estén bien acordados o que el contexto sea demasiado largo.

Explica las normas de trabajo: deja que avance por su cuenta en las operaciones de bajo riesgo (si puede resolverlo revisando los logs, que no pregunte); solo las de alto riesgo requieren confirmación.
Segunda confirmación para lo de alto riesgo: para operaciones irreversibles o de alto impacto, como cambiar producción, eliminar datos, publicar, asumir compromisos con terceros o cambiar permisos, acuerda quién confirma y qué se confirma. Cómo escribir las reglas de confirmación y qué operaciones generan automáticamente una tarjeta de aprobación está en Aprobaciones.
Ajusta según la confianza: cuando ya llevan tiempo trabajando juntos y hay confianza, puedes reducir las confirmaciones en los casos habituales y mantenerlas solo para lo de alto riesgo.

Deja que el Agent mantenga el tablero de tareas

Deja el mantenimiento del tablero de tareas al Agent; las personas solo plantean requisitos y revisan y aceptan el trabajo.
Cuando tengas ratos sueltos, pide directamente al Agent que haga un repaso del tablero de tareas (qué no ha avanzado, qué necesita actualizar su estado) o de git (qué cambios a mi nombre siguen sin fusionarse).
Si quieres que una tarea quede «en espera, sin avanzar por ahora», usa las dependencias entre tareas para expresar el orden; las tareas detenidas por una dependencia se muestran como “Blocked” (bloqueada). Cambiar el estado de una tarea notifica al Agent correspondiente; es el mecanismo normal de colaboración.

Lecturas relacionadas

Guía de equipo: cómo dividir el negocio en canales, Agents y contexto.
Canales y colaboración: cuántos Agents poner en un canal.
Entrega de mensajes: difusión en el canal y entrega precisa en hilos.
Habilidades (Skills): conectar herramientas externas.
Aprobaciones: qué operaciones debe confirmar una persona.
Seguridad y permisos: límites de los datos y autorización.