Documentación

Funciones de los agentes

Qué agente gestiona cada fase de una tarea y qué acciones se permiten o no realizar en cada uno.

Coroid no utiliza un único agente de uso general. Cada fase del proceso desde la descripción hasta pull request es gestionada por un agente con una función específica y un conjunto de herramientas deliberadamente limitado.

Estas restricciones son esenciales. Un agente que no puede escribir código no podrá escribir código por error.

Las funciones

FunciónFasePuede modificar tu código
ArquitectoEspecificación y planNo
DesarrolladorCompilar
Control de calidad (QA)VerificarNo
RevisorRevisiónNo
Probador webVerificar flujos del navegadorNo
ExploradorInvestigar, cualquier faseNo
Analizador de dependenciasAnálisisNo

Los cuatro primeros forman la canalización que ves en cada tarea, en este orden:

ArquitectoDesarrolladorControl de calidad (QA)Revisor

Solo un rol — el desarrollador — puede modificar archivos en tu repositorio. Todos los demás agentes solo leen, ejecutan, generan informes o crean tareas de seguimiento.

Arquitecto

Convierte tu descripción en una especificación y la especificación en un plan. Lee el código fuente para adaptar el plan a la realidad del proyecto, pero no escribe código.

Su resultado es lo que tú apruebas antes de iniciar la compilación.

Desarrollador

Realiza el trabajo: lee el código relevante, realiza los cambios, escribe o actualiza las pruebas y las ejecuta localmente en el entorno de trabajo hasta que pasen.

Cuando el Revisor envía Hallazgos de vuelta, el Desarrollador es el rol que actúa en consecuencia.

Control de calidad (QA)

Ejecuta la verificación de forma independiente al agente que escribió el código: tu suite de pruebas, los filtros de calidad configurados para el proyecto y los criterios de aceptación de la especificación.

El control de calidad (QA) emite un veredicto. No corrige lo que encuentra; los errores se devuelven al Desarrollador como trabajo adicional.

Revisor

Lee el diff final y genera Hallazgos, aplicando las reglas de revisión que tu organización haya configurado. Los Hallazgos se envían de vuelta al desarrollador como trabajo adicional o se adjuntan a la pull request para tu revisión.

Probador web

Utiliza un navegador real para probar una vista previa en ejecución de tu aplicación y verificar los flujos de usuario de extremo a extremo. Se emplea cuando no se pueden hacer afirmaciones sobre el comportamiento únicamente a partir del código.

Explorador

Es un rol de investigación de solo lectura. Otros agentes lo usan para responder preguntas sobre el código fuente sin necesidad de cargar toda la información en su propio contexto: "¿dónde se gestiona la autenticación?", "¿qué llama a esta función?".

Analizador de dependencias

Examina las dependencias y cómo los cambios se propagan por el código fuente, incluso en proyectos con dependencias cruzadas configuradas.

Por qué es importante esta separación

Esta división del trabajo conlleva tres ventajas clave:

  1. La verificación es independiente. El agente que revisa el trabajo no es el mismo que lo escribió, por lo que no tiene interés personal en el resultado.
  2. El alcance del impacto está delimitado. Solo el rol de desarrollador dispone de herramientas para escribir código; por lo tanto, un fallo en la revisión o el análisis no puede dañar tu repositorio.
  3. Cada función utiliza un modelo adaptado a sus necesidades. La planificación requiere un amplio conocimiento del mundo; escribir código que compile requiere otras capacidades. Un AI profile incorpora un modelo distinto para cada función por este motivo exacto.

Siguiente

Volver a Cómo una tarea se convierte en pull request para ver a qué etapas se corresponden estos roles o ¿Qué es Coroid? para obtener una visión general más breve.