Agentes y Roles
Separación funcional entre el coordinador, el asistente de código y el agente de investigación.
El ecosistema se apoya en una separación clara de responsabilidades. Cada agente tiene un papel distinto y una relación diferente con el código, la memoria y las herramientas.
Agente Coordinador
El coordinador es el agente principal. Actúa como coordinador, arquitecto operativo y punto de continuidad.
Responsabilidades:
- interpretar las peticiones del usuario;
- decidir qué herramienta o agente usar;
- mantener la memoria y las reglas de trabajo;
- revisar los resultados importantes;
- coordinar los cambios de código;
- documentar las decisiones;
- proteger los límites de seguridad.
El coordinador representa la capa de dirección: no solo ejecuta tareas, también mantiene el mapa del sistema.
Asistente de Código
El asistente de código es el rol constructor y revisor. Su trabajo es operar sobre los repositorios, leer código, implementar cambios, ejecutar comprobaciones y explicar los resultados.
Responsabilidades:
- modificar código;
- crear o mejorar la documentación técnica;
- ejecutar tests y linters;
- analizar errores;
- revisar diffs;
- producir implementaciones a partir de especificaciones acotadas.
En este proyecto, el asistente de código rinde mejor cuando recibe contexto estructurado: AGENTS.md, TOOL.md, archivos README, skills instaladas y tareas pequeñas.
Agente de Investigación
El agente de investigación es un agente especializado, separado del proceso principal. Cubre dos dominios:
- investigación estructurada;
- flujos de entretenimiento y medios.
Responsabilidades:
- procesar misiones de investigación;
- ejecutar pipelines por fases;
- usar las herramientas de medios cuando corresponde;
- generar informes;
- trabajar de forma aislada para no bloquear al agente principal.
Relación entre Agentes
Regla de Aprendizaje
La arquitectura no busca que un agente sea más listo solo a base de prompts. Busca que cada agente sea más fiable porque opera dentro de un rol, con herramientas y contratos claros.